agent-device 0.21.11 → 0.21.13

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

@@ -1,225 +0,0 @@
-import AgentDeviceMacOSDeviceHub
-import AppKit
-import ApplicationServices
-import Darwin
-import Foundation
-
-/// How long sidebar selection and pose-control discovery may each wait before refusing a press.
-private let deviceHubSettleDeadline: TimeInterval = 8
-private let deviceHubPoll: TimeInterval = 0.25
-
-struct DeviceHubPoseResponse: Encodable {
-  let pose: String
-  let control: String
-  let windowTitle: String
-  /** Whether Device Hub had to be asked to reopen a window before the device could be selected. */
-  let reopened: Bool
-  /** Whether the window was switched to the device through its sidebar row. */
-  let selected: Bool
-}
-
-func handleDeviceHub(arguments: [String]) throws -> any Encodable {
-  guard arguments.first == "pose" else {
-    throw HelperError.invalidArgs("device-hub requires pose")
-  }
-  let rest = Array(arguments.dropFirst())
-  guard let udid = helperOptionValue(arguments: rest, name: "--udid")?
-    .trimmingCharacters(in: .whitespacesAndNewlines),
-    !udid.isEmpty
-  else {
-    throw HelperError.invalidArgs("device-hub pose requires --udid <udid>")
-  }
-  guard let deviceName = helperOptionValue(arguments: rest, name: "--device-name")?
-    .trimmingCharacters(in: .whitespacesAndNewlines),
-    !deviceName.isEmpty
-  else {
-    throw HelperError.invalidArgs("device-hub pose requires --device-name <name>")
-  }
-  guard let pose = helperOptionValue(arguments: rest, name: "--pose").flatMap(DeviceHubPose.init(argument:))
-  else {
-    throw HelperError.invalidArgs("device-hub pose requires --pose <closed|book|open>")
-  }
-  let control = pose.controlDescription
-  guard AXIsProcessTrusted() else {
-    throw HelperError.commandFailed(
-      "fold needs Accessibility permission to press the Device Hub pose control",
-      details: ["reason": "accessibility-permission", "permission": "accessibility"]
-    )
-  }
-  let discovery = try discoverDeviceHubWindow(udid: udid, deviceName: deviceName)
-  let window = discovery.window
-  defer {
-    if discovery.revealedSidebar {
-      _ = setDeviceHubSidebar(visible: false, window: window,
-        deadline: ProcessInfo.processInfo.systemUptime + 0.5)
-    }
-  }
-  let selected = try selectDevice(row: discovery.row, deviceName: deviceName, in: window)
-  let windowTitle = stringAttribute(window, attribute: kAXTitleAttribute as String) ?? ""
-  guard let button = awaitPoseButton(in: window, description: control) else {
-    throw HelperError.commandFailed(
-      "Device Hub shows no \(control) pose control for \(deviceName)",
-      details: [
-        "reason": "device-hub-pose-control-missing",
-        "windowTitle": windowTitle,
-        "control": control,
-      ]
-    )
-  }
-  let status = AXUIElementPerformAction(button, kAXPressAction as CFString)
-  guard status == .success else {
-    throw HelperError.commandFailed(
-      "Device Hub refused the \(control) pose press",
-      details: ["reason": "device-hub-press-failed", "status": "\(status.rawValue)"]
-    )
-  }
-  return SuccessEnvelope(
-    data: DeviceHubPoseResponse(
-      pose: pose.rawValue,
-      control: control,
-      windowTitle: windowTitle,
-      reopened: discovery.reopened,
-      selected: selected
-    )
-  )
-}
-
-private func windowShows(deviceName: String, _ window: AXUIElement) -> Bool {
-  return deviceHubWindowShows(
-    deviceName: deviceName,
-    title: stringAttribute(window, attribute: kAXTitleAttribute as String)
-  )
-}
-
-/// `kAEReopenApplication` is what the Dock sends when an app with no open windows is clicked, and
-/// it is the one event Device Hub answers by restoring the device window. Sent to the process
-/// directly, because LaunchServices cannot address a trampolined app by bundle identifier.
-func sendDeviceHubReopenEvent(to pid: pid_t, timeout: TimeInterval) throws {
-  let target = NSAppleEventDescriptor(processIdentifier: pid)
-  let event = NSAppleEventDescriptor(
-    eventClass: AEEventClass(kCoreEventClass),
-    eventID: AEEventID(kAEReopenApplication),
-    targetDescriptor: target,
-    returnID: AEReturnID(kAutoGenerateReturnID),
-    transactionID: AETransactionID(kAnyTransactionID)
-  )
-  do {
-    _ = try event.sendEvent(options: [.noReply], timeout: min(5, max(0.001, timeout)))
-  } catch {
-    let code = (error as NSError).code
-    throw HelperError.commandFailed(
-      "fold could not ask Device Hub to reopen its device window",
-      details: [
-        "reason": code == -1743 ? "automation-permission" : "device-hub-reopen-failed",
-        "error": String(describing: error),
-      ]
-    )
-  }
-}
-
-/// Switches the window to the device through its sidebar row, whose accessibility identifier is
-/// `TableRow.Device.<udid>` — the one place Device Hub exposes a device identity that two
-/// simulators sharing a name cannot confuse. A window already titled with the device still gets
-/// the selection, because the title alone cannot tell such twins apart.
-private func selectDevice(
-  row: AXUIElement,
-  deviceName: String,
-  in window: AXUIElement
-) throws -> Bool {
-  let deadline = ProcessInfo.processInfo.systemUptime + deviceHubSettleDeadline
-  AXUIElementSetMessagingTimeout(row, 0.25)
-  AXUIElementSetMessagingTimeout(window, 0.25)
-  let status = AXUIElementSetAttributeValue(row, kAXSelectedAttribute as CFString, kCFBooleanTrue)
-  guard status == .success || status == .cannotComplete else {
-    throw HelperError.commandFailed(
-      "Device Hub refused to select \(deviceName) in its sidebar",
-      details: ["reason": "device-hub-select-failed", "status": "\(status.rawValue)"]
-    )
-  }
-  while ProcessInfo.processInfo.systemUptime < deadline {
-    var selected: CFTypeRef?
-    if AXUIElementCopyAttributeValue(row, kAXSelectedAttribute as CFString, &selected) == .success,
-      (selected as? Bool) == true, windowShows(deviceName: deviceName, window) { return true }
-    Thread.sleep(forTimeInterval: deviceHubPoll)
-  }
-  throw HelperError.commandFailed(
-    "Device Hub did not confirm selection of \(deviceName)",
-    details: ["reason": "device-hub-select-unconfirmed", "status": "\(status.rawValue)"]
-  )
-}
-
-func deviceHubDeviceRow(udid: String, in window: AXUIElement, deadline: TimeInterval) -> AXUIElement? {
-  guard let label = findDeviceHubElement(root: window, depth: 0, deadline: deadline, where: {
-    stringAttribute($0, attribute: "AXIdentifier") == deviceHubDeviceRowIdentifier(udid: udid)
-  }) else {
-    return nil
-  }
-  var current: AXUIElement? = label
-  while let element = current, ProcessInfo.processInfo.systemUptime < deadline {
-    AXUIElementSetMessagingTimeout(element, Float(max(0.001, min(0.25, deadline - ProcessInfo.processInfo.systemUptime))))
-    if stringAttribute(element, attribute: kAXRoleAttribute as String) == "AXRow" {
-      return element
-    }
-    current = elementAttribute(element, attribute: kAXParentAttribute as String)
-  }
-  return nil
-}
-
-/// The action bar is rebuilt for the device the window shows, so right after a sidebar selection
-/// the window already carries the new title while the pose controls are still being laid out.
-/// The controls are therefore awaited, not looked up once.
-private func awaitPoseButton(in window: AXUIElement, description: String) -> AXUIElement? {
-  let deadline = ProcessInfo.processInfo.systemUptime + deviceHubSettleDeadline
-  while true {
-    if let button = poseButton(in: window, description: description, deadline: deadline) {
-      return button
-    }
-    guard ProcessInfo.processInfo.systemUptime < deadline else { return nil }
-    Thread.sleep(forTimeInterval: deviceHubPoll)
-  }
-}
-
-/// The pose controls sit in the window's action bar as `AXButton`s described by their preset
-/// name; the simulated screen inside the same window is an iOS content group whose own buttons
-/// carry app labels, never these three.
-private func poseButton(in window: AXUIElement, description: String, deadline: TimeInterval) -> AXUIElement? {
-  return findDeviceHubElement(root: window, depth: 0, deadline: deadline) {
-    stringAttribute($0, attribute: kAXRoleAttribute as String) == "AXButton"
-      && stringAttribute($0, attribute: kAXDescriptionAttribute as String) == description
-  }
-}
-
-func findDeviceHubElement(
-  root: AXUIElement,
-  depth: Int,
-  deadline: TimeInterval,
-  where matches: (AXUIElement) -> Bool
-) -> AXUIElement? {
-  let remaining = deadline - ProcessInfo.processInfo.systemUptime
-  if depth > 14 || remaining <= 0 {
-    return nil
-  }
-  AXUIElementSetMessagingTimeout(root, Float(min(0.25, remaining)))
-  for child in children(of: root) {
-    let remaining = deadline - ProcessInfo.processInfo.systemUptime
-    guard remaining > 0 else { return nil }
-    AXUIElementSetMessagingTimeout(child, Float(min(0.25, remaining)))
-    if matches(child) {
-      return child
-    }
-    if stringAttribute(child, attribute: kAXSubroleAttribute as String) == "iOSContentGroup" {
-      continue
-    }
-    if let nested = findDeviceHubElement(root: child, depth: depth + 1, deadline: deadline, where: matches) {
-      return nested
-    }
-  }
-  return nil
-}
-
-func helperOptionValue(arguments: [String], name: String) -> String? {
-  guard let index = arguments.firstIndex(of: name), arguments.indices.contains(index + 1) else {
-    return nil
-  }
-  return arguments[index + 1]
-}

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

@@ -1,57 +0,0 @@
-import AgentDeviceMacOSDeviceHub
-import ApplicationServices
-import Foundation
-
-func identifyDeviceHubRow(
-  udid: String,
-  candidate: DeviceHubWindowCandidate,
-  deadline: TimeInterval
-) -> DeviceHubRowLookup {
-  let now = ProcessInfo.processInfo.systemUptime
-  let visibleRowDeadline = now + max(0, deadline - now) / 3
-  if let row = deviceHubDeviceRow(udid: udid, in: candidate.window, deadline: visibleRowDeadline) {
-    return .identified(row, restoreSidebar: false)
-  }
-  let searchDeadline = deadline - 0.25
-  guard let button = deviceHubSidebarButton(visible: true, window: candidate.window, deadline: searchDeadline) else {
-    return ProcessInfo.processInfo.systemUptime >= searchDeadline ? .timedOut : .sidebarUnavailable
-  }
-  var transferCleanup = false
-  defer {
-    if !transferCleanup {
-      _ = setDeviceHubSidebar(visible: false, window: candidate.window, deadline: deadline)
-    }
-  }
-  let status = pressDeviceHubSidebarButton(button, deadline: searchDeadline)
-  guard status == .success || status == .cannotComplete else { return .unconfirmed }
-  repeat {
-    if let row = deviceHubDeviceRow(udid: udid, in: candidate.window, deadline: searchDeadline) {
-      transferCleanup = true
-      return .identified(row, restoreSidebar: true)
-    }
-    let remaining = searchDeadline - ProcessInfo.processInfo.systemUptime
-    if remaining <= 0 { return .timedOut }
-    Thread.sleep(forTimeInterval: min(0.05, remaining))
-  } while ProcessInfo.processInfo.systemUptime < searchDeadline
-  return .timedOut
-}
-
-func setDeviceHubSidebar(visible: Bool, window: AXUIElement, deadline: TimeInterval) -> Bool {
-  guard let button = deviceHubSidebarButton(visible: visible, window: window, deadline: deadline) else { return false }
-  return pressDeviceHubSidebarButton(button, deadline: deadline) == .success
-}
-
-private func deviceHubSidebarButton(visible: Bool, window: AXUIElement, deadline: TimeInterval) -> AXUIElement? {
-  let description = visible ? "Show Sidebar" : "Hide Sidebar"
-  return findDeviceHubElement(root: window, depth: 0, deadline: deadline) {
-    stringAttribute($0, attribute: kAXRoleAttribute as String) == "AXButton"
-      && stringAttribute($0, attribute: kAXDescriptionAttribute as String) == description
-  }
-}
-
-private func pressDeviceHubSidebarButton(_ button: AXUIElement, deadline: TimeInterval) -> AXError {
-  let remaining = deadline - ProcessInfo.processInfo.systemUptime
-  guard remaining > 0 else { return .cannotComplete }
-  AXUIElementSetMessagingTimeout(button, Float(min(0.1, remaining)))
-  return AXUIElementPerformAction(button, kAXPressAction as CFString)
-}

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

@@ -1,108 +0,0 @@
-import AgentDeviceMacOSDeviceHub
-import AppKit
-import ApplicationServices
-import Darwin
-
-struct DiscoveredDeviceHubWindow {
-  let window: AXUIElement
-  let reopened: Bool
-  let row: AXUIElement
-  let revealedSidebar: Bool
-}
-
-func discoverDeviceHubWindow(udid: String, deviceName: String) throws -> DiscoveredDeviceHubWindow {
-  let deadline = ProcessInfo.processInfo.systemUptime + 8
-  var reopened = Set<pid_t>()
-  var reopenFailures: [pid_t: String] = [:]
-  var inventory = DeviceHubWindowInventory()
-  var processIDs: [pid_t] = []
-  repeat {
-    processIDs = deviceHubProcessIdentifiers()
-    if processIDs.isEmpty {
-      throw HelperError.commandFailed(
-        "Xcode Device Hub is not running",
-        details: ["reason": "device-hub-not-running", "bundleId": "com.apple.dt.Devices"]
-      )
-    }
-    inventory = DeviceHubWindowInventory()
-    for pid in processIDs {
-      let remaining = deadline - ProcessInfo.processInfo.systemUptime
-      guard remaining > 0 else { inventory.expireBudget(); break }
-      let app = AXUIElementCreateApplication(pid)
-      AXUIElementSetMessagingTimeout(app, Float(min(0.5, remaining)))
-      var value: CFTypeRef?
-      let status = AXUIElementCopyAttributeValue(app, kAXWindowsAttribute as CFString, &value)
-      if status == .success, let windows = value as? [AXUIElement] {
-        for window in windows { AXUIElementSetMessagingTimeout(window, 0.5) }
-        inventory.record(processID: pid, read: .available(windows))
-      } else {
-        inventory.record(processID: pid, read: .failed(
-          status == .success ? AXError.illegalArgument.rawValue : status.rawValue
-        ))
-      }
-    }
-    for (index, candidate) in inventory.candidates.enumerated() {
-      let now = ProcessInfo.processInfo.systemUptime
-      guard now < deadline else { inventory.expireBudget(); break }
-      let candidateDeadline = now + (deadline - now) / Double(inventory.candidates.count - index) / 2
-      let outcome = identifyDeviceHubRow(udid: udid, candidate: candidate, deadline: candidateDeadline)
-      inventory.record(candidate: index, outcome: outcome)
-      if case .identified(let row, let restoreSidebar) = outcome {
-        return DiscoveredDeviceHubWindow(window: candidate.window,
-          reopened: reopened.contains(candidate.processID), row: row, revealedSidebar: restoreSidebar)
-      }
-    }
-    let attempted = reopened.union(reopenFailures.keys)
-    for pid in inventory.processesToReopen(attempted: attempted) {
-      guard ProcessInfo.processInfo.systemUptime < deadline else { inventory.expireBudget(); break }
-      do {
-        try sendDeviceHubReopenEvent(to: pid, timeout: deadline - ProcessInfo.processInfo.systemUptime)
-        reopened.insert(pid)
-      } catch let error as HelperError {
-        guard case .commandFailed(_, let details) = error else { throw error }
-        reopenFailures[pid] = details["reason"] ?? "device-hub-reopen-failed"
-      }
-    }
-    let remaining = deadline - ProcessInfo.processInfo.systemUptime
-    if remaining <= 0 { inventory.expireBudget(); break }
-    Thread.sleep(forTimeInterval: min(0.25, remaining))
-  } while ProcessInfo.processInfo.systemUptime < deadline
-
-  let statuses = inventory.failures.sorted { $0.key < $1.key }
-    .map { "\($0.key):\($0.value)" }.joined(separator: ",")
-  throw HelperError.commandFailed(
-    "Could not confirm a Device Hub window for the requested device",
-    details: [
-      "reason": inventory.failureReason(reopenFailures: reopenFailures),
-      "reopenFailures": reopenFailures.sorted { $0.key < $1.key }.map { "\($0.key):\($0.value)" }.joined(separator: ","),
-      "candidateOutcomes": inventory.candidateOutcomes.joined(separator: ","),
-      "udid": udid,
-      "deviceName": deviceName,
-      "processIDs": processIDs.map(String.init).joined(separator: ","),
-      "axWindowReadStatuses": statuses,
-      "hostDisplayIDs": deviceHubHostDisplays().map { String($0) }.joined(separator: ","),
-    ]
-  )
-}
-
-private func deviceHubProcessIdentifiers() -> [pid_t] {
-  let byteCount = proc_listpids(UInt32(PROC_ALL_PIDS), 0, nil, 0)
-  guard byteCount > 0 else { return [] }
-  var pids = [pid_t](repeating: 0, count: Int(byteCount) / MemoryLayout<pid_t>.size + 64)
-  let filled = proc_listpids(UInt32(PROC_ALL_PIDS), 0, &pids, Int32(pids.count * MemoryLayout<pid_t>.size))
-  guard filled > 0 else { return [] }
-  return pids.prefix(Int(filled) / MemoryLayout<pid_t>.size).filter { pid in
-    guard pid > 0 else { return false }
-    var path = [CChar](repeating: 0, count: 4096)
-    guard proc_pidpath(pid, &path, UInt32(path.count)) > 0 else { return false }
-    return String(cString: path).hasSuffix(deviceHubExecutableSuffix)
-  }.sorted()
-}
-
-private func deviceHubHostDisplays() -> [CGDirectDisplayID] {
-  var count: UInt32 = 0
-  guard CGGetActiveDisplayList(0, nil, &count) == .success else { return [] }
-  var displays = [CGDirectDisplayID](repeating: 0, count: Int(count))
-  guard CGGetActiveDisplayList(count, &displays, &count) == .success else { return [] }
-  return Array(displays.prefix(Int(count)))
-}

package/apple/macos-helper/Tests/AgentDeviceMacOSDeviceHubTests/DeviceHubPoseTests.swift

@@ -1,30 +0,0 @@
-import XCTest
-
-@testable import AgentDeviceMacOSDeviceHub
-
-final class DeviceHubPoseTests: XCTestCase {
-  func testEveryPoseNamesTheActionBarControlDeviceHubDescribes() {
-    XCTAssertEqual(DeviceHubPose(argument: "closed")?.controlDescription, "Closed")
-    XCTAssertEqual(DeviceHubPose(argument: "book")?.controlDescription, "Book")
-    XCTAssertEqual(DeviceHubPose(argument: "OPEN")?.controlDescription, "Open")
-    XCTAssertNil(DeviceHubPose(argument: "half-open"), "the helper takes Device Hub's names, not the CLI's")
-    XCTAssertEqual(Set(DeviceHubPose.allCases.map(\.controlDescription)), ["Closed", "Book", "Open"])
-  }
-
-  // Device Hub titles the window `<name> – iOS 27.1`; a simulator whose name merely starts
-  // with another's must not claim that window.
-  func testWindowTitleMatchesTheDeviceNameAsAPrefixWord() {
-    XCTAssertTrue(deviceHubWindowShows(deviceName: "iPhone Duo", title: "iPhone Duo – iOS 27.1"))
-    XCTAssertTrue(deviceHubWindowShows(deviceName: "iPhone Duo", title: "iPhone Duo"))
-    XCTAssertFalse(deviceHubWindowShows(deviceName: "iPhone Duo", title: "iPhone Duo Lab – iOS 27.1"))
-    XCTAssertFalse(deviceHubWindowShows(deviceName: "iPhone Duo", title: "bench-golden-v1 – iOS 27.0"))
-    XCTAssertFalse(deviceHubWindowShows(deviceName: "iPhone Duo", title: nil))
-  }
-
-  func testSidebarRowIsKeyedByUdid() {
-    XCTAssertEqual(
-      deviceHubDeviceRowIdentifier(udid: "4F879835-4AB3-4046-B033-5AB769209DD4"),
-      "TableRow.Device.4F879835-4AB3-4046-B033-5AB769209DD4"
-    )
-  }
-}

package/apple/macos-helper/Tests/AgentDeviceMacOSDeviceHubTests/DeviceHubWindowInventoryTests.swift

@@ -1,65 +0,0 @@
-import ApplicationServices
-import XCTest
-@testable import AgentDeviceMacOSDeviceHub
-
-final class DeviceHubWindowInventoryTests: XCTestCase {
-  func testLaterWindowKeepsItsProcessAndDoesNotPreventEmptyProcessReopen() {
-    var inventory = DeviceHubWindowInventory()
-    let window = AXUIElementCreateApplication(20)
-    inventory.record(processID: 10, read: .available([]))
-    inventory.record(processID: 20, read: .available([window]))
-    XCTAssertEqual(inventory.candidates.map(\.processID), [20])
-    XCTAssertTrue(CFEqual(inventory.candidates[0].window, window))
-    inventory.record(candidate: 0, outcome: .sidebarUnavailable)
-    XCTAssertEqual(inventory.processesToReopen(attempted: []), [10])
-    XCTAssertEqual(inventory.failureReason(), "device-hub-identity-unconfirmed")
-    XCTAssertEqual(inventory.candidateOutcomes, ["20:0:sidebar-unavailable"])
-  }
-
-  func testFailedReadsAreNotReopenedOrMisreportedAsMissingWindows() {
-    var inventory = DeviceHubWindowInventory()
-    inventory.record(processID: 10, read: .failed(-25204))
-    inventory.record(processID: 20, read: .available([]))
-    XCTAssertEqual(inventory.processesToReopen(attempted: []), [20])
-    XCTAssertEqual(inventory.failures, [10: -25204])
-    XCTAssertEqual(inventory.failureReason(), "device-hub-window-read-failed")
-  }
-
-  func testSuccessfulEmptyReadIsMissingAndReopenIsAttemptedOnlyOnce() {
-    var inventory = DeviceHubWindowInventory()
-    inventory.record(processID: 10, read: .available([]))
-    XCTAssertEqual(inventory.failureReason(), "device-hub-window-missing")
-    XCTAssertEqual(inventory.processesToReopen(attempted: []), [10])
-    XCTAssertEqual(inventory.processesToReopen(attempted: [10]), [])
-  }
-
-  func testSharedBudgetExhaustionStopsReopenWithoutClaimingMissingDevice() {
-    var inventory = DeviceHubWindowInventory()
-    inventory.record(processID: 10, read: .available([]))
-    inventory.expireBudget()
-    XCTAssertEqual(inventory.processesToReopen(attempted: []), [])
-    XCTAssertEqual(inventory.failureReason(), "device-hub-discovery-timeout")
-  }
-
-  func testCandidateOutcomesRetainUncertaintyAndOwningProcess() {
-    var inventory = DeviceHubWindowInventory()
-    inventory.record(processID: 10, read: .available([AXUIElementCreateApplication(10)]))
-    inventory.record(processID: 20, read: .available([AXUIElementCreateApplication(20)]))
-    inventory.record(candidate: 0, outcome: .timedOut)
-    inventory.record(candidate: 1, outcome: .unconfirmed)
-    XCTAssertEqual(inventory.candidateOutcomes, ["10:0:timed-out", "20:1:row-unconfirmed"])
-    XCTAssertEqual(inventory.failureReason(), "device-hub-identity-unconfirmed")
-  }
-  func testUnrelatedReopenFailureDoesNotMaskCandidateUncertainty() {
-    var inventory = DeviceHubWindowInventory()
-    inventory.record(processID: 10, read: .available([]))
-    let failures: [Int32: String] = [10: "automation-permission"]
-    XCTAssertEqual(inventory.failureReason(reopenFailures: failures), "automation-permission")
-    inventory.record(processID: 20, read: .available([AXUIElementCreateApplication(20)]))
-    inventory.record(candidate: 0, outcome: .timedOut)
-    XCTAssertEqual(inventory.failureReason(reopenFailures: failures), "device-hub-identity-unconfirmed")
-    inventory.expireBudget()
-    XCTAssertEqual(inventory.failureReason(reopenFailures: failures), "device-hub-discovery-timeout")
-  }
-
-}

package/dist/src/app-inventory.d.ts

@@ -1,4 +0,0 @@
-//#region packages/contracts/src/app-inventory.d.ts
-type AppsFilter = 'user-installed' | 'all';
-//#endregion
-export { AppsFilter as t };

package/dist/src/apps-simctl.js

@@ -1 +0,0 @@
-import{o as e}from"./tool-provider.js";import{t}from"./simctl.js";function n(e,n){return t(e,n)}function r(t,r,i){return e(n(t,r),i)}function i(e){return e.includes(`not installed`)||e.includes(`not found`)||e.includes(`no such file`)}export{r as n,n as r,i as t};

package/dist/src/cloud-artifacts.d.ts

@@ -1,61 +0,0 @@
-import { n as DaemonArtifactType } from "./sdk-contracts.js";
-//#region packages/contracts/src/cloud-artifacts.d.ts
-declare const CLOUD_ARTIFACT_KINDS: readonly ['video', 'appium-log', 'device-log', 'automation-log', 'provider-session', 'raw'];
-type CloudArtifactKind = (typeof CLOUD_ARTIFACT_KINDS)[number];
-type CloudArtifactAvailability = 'ready' | 'pending' | 'unavailable' | 'expired';
-type CloudArtifact = {
-  provider: string;
-  kind: CloudArtifactKind;
-  name: string;
-  url?: string;
-  providerSessionId?: string;
-  providerArtifactId?: string;
-  contentType?: string;
-  extension?: string;
-  availability?: CloudArtifactAvailability;
-  metadata?: Record<string, unknown>;
-};
-type CloudArtifactsStatus = 'ready' | 'pending' | 'unavailable';
-type CloudArtifactsResult = {
-  provider: string;
-  status: CloudArtifactsStatus;
-  cloudArtifacts: CloudArtifact[];
-  providerSessionId?: string;
-  message?: string;
-};
-type DaemonArtifactInventoryEntry = {
-  id: string;
-  artifactType?: DaemonArtifactType;
-  filename: string;
-  mimeType: string;
-  sizeBytes: number;
-  createdAt: string;
-  expiresAt: string;
-};
-type DaemonArtifactsResult = {
-  source: 'daemon';
-  status: 'ready';
-  artifacts: DaemonArtifactInventoryEntry[];
-  message?: string;
-};
-type AgentArtifactsResult = CloudArtifactsResult | DaemonArtifactsResult;
-type CloudArtifactsQuery = {
-  provider?: string;
-  leaseId?: string;
-  providerSessionId?: string;
-};
-type CloudProviderSessionResult = {
-  provider?: string;
-  providerSessionId?: string;
-  cloudArtifacts?: CloudArtifactsResult;
-} & Record<string, unknown>;
-/**
- * Return undefined only when this provider implementation does not handle the query.
- * Return a CloudArtifactsResult with status "unavailable" when the provider handled the
- * query but artifact retrieval failed, and "pending" when artifacts are not finalized yet.
- */
-type CloudArtifactProvider = {
-  listCloudArtifacts?: (query: CloudArtifactsQuery) => Promise<CloudArtifactsResult | undefined>;
-};
-//#endregion
-export { CloudArtifactProvider as n, CloudProviderSessionResult as r, AgentArtifactsResult as t };

package/dist/src/runner-contract.js

@@ -1,3 +0,0 @@
-import{D as e,P as t,U as n,k as r}from"./sdk-contracts.js";import{i}from"./alert-contract.js";import{f as a,i as o,m as s,o as c,y as l}from"./host.js";import u from"node:crypto";const d=`RUNNER_BUSY`,f=`MAIN_THREAD_TIMEOUT`,p="If runner build products look stale or corrupted, run `pnpm clean:xcuitest` in a local checkout, or remove ~/.agent-device/apple-runner/derived, then retry.";function m(e){let t=a(e.requestId);return e.signal?!t||t===e.signal?e.signal:AbortSignal.any([t,e.signal]):t}const h=e=>e.retriable===!0,g=e=>typeof e.devToolsSecurityStatus==`string`,_=e=>e.usbmuxDeviceAttached===!1,v=e=>e.runnerReadinessPreflightFailed===!0&&!t(e),y=`build_failed_unclassified`,b={reason:`signing_provisioning_profile_missing`,hint:`Install/select a valid iOS provisioning profile, or set AGENT_DEVICE_IOS_PROVISIONING_PROFILE.`},x=[{reason:`usbmux_device_unattached`,match:{code:`DEVICE_NOT_FOUND`,details:_},verdicts:{connectRetry:!1}},{reason:`flagged_retriable`,match:{code:`COMMAND_FAILED`,details:h},verdicts:{retryable:!0,connectRetry:!0}},{reason:`xcodebuild_exited_early`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`xcodebuild exited early`]},verdicts:{retryable:!1,connectRetry:!1,artifactSuspect:!1}},{reason:`device_busy_connecting`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`device is busy`,`connecting`]},verdicts:{retryable:!1,connectRetry:!1}},{reason:`runner_readiness_preflight_failed`,match:{code:`COMMAND_FAILED`,details:v},verdicts:{restartAfterReadinessPreflight:!0}},{reason:`runner_connect_refused`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`runner did not accept connection`]},verdicts:{retryable:!0,connectRetry:!0,restartBeforeSend:!0,artifactSuspect:!0}},{reason:`runner_endpoint_probe_exhausted`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`runner endpoint probe failed`]},verdicts:{artifactSuspect:!0}},{reason:`fetch_failed`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`fetch failed`]},verdicts:{retryable:!0,connectRetry:!0}},{reason:`econnrefused`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`econnrefused`]},verdicts:{retryable:!0,connectRetry:!0}},{reason:`socket_hang_up`,match:{code:`COMMAND_FAILED`,messageIncludesAll:[`socket hang up`]},verdicts:{retryable:!0,connectRetry:!0}},{reason:`ax_snapshot_failure`,match:{code:`IOS_AX_SNAPSHOT_FAILED`},verdicts:{sessionFatalReason:`ax_snapshot_failure`}},{reason:`xctest_recorded_failure`,match:{code:`XCTEST_RECORDED_FAILURE`},verdicts:{sessionFatalReason:`xctest_recorded_failure`}},{reason:`runner_main_thread_wedged`,match:{code:`RUNNER_WEDGED`},verdicts:{sessionFatalReason:`runner_main_thread_wedged`}},{reason:`bundle_identifier_registration_failed`,match:{toolTextIncludesAll:[`failed registering bundle identifier`]},verdicts:{},buildFailure:{reason:`bundle_identifier_already_registered`,hint:`Set AGENT_DEVICE_IOS_BUNDLE_ID to a unique reverse-DNS value (for example, com.yourname.agentdevice.runner), then retry.`}},{reason:`bundle_identifier_unavailable`,match:{toolTextLineIncludesAll:[`app identifier`,`not available`]},verdicts:{},buildFailure:{reason:`bundle_identifier_already_registered`,hint:`Set AGENT_DEVICE_IOS_BUNDLE_ID to a unique reverse-DNS value (for example, com.yourname.agentdevice.runner), then retry.`}},{reason:`signing_requires_development_team`,match:{toolTextIncludesAll:[`requires a development team`]},verdicts:{},buildFailure:{reason:`signing_no_development_team`,hint:`Configure signing in Xcode or set AGENT_DEVICE_IOS_TEAM_ID for physical-device runs.`}},{reason:`conflicting_provisioning_settings_unproven`,match:{toolTextIncludesAll:[`conflicting provisioning settings`]},verdicts:{},buildFailure:{reason:y,hint:p}},{reason:`signing_no_profiles_for_bundle_id`,match:{toolTextIncludesAll:[`no profiles for`]},verdicts:{},buildFailure:b},{reason:`signing_provisioning_profile_xcode_error`,match:{toolTextLineIncludesAll:[`provisioning profile`,`ideprovisioningerrordomain`]},verdicts:{},buildFailure:b},{reason:`signing_provisioning_profile_does_not_cover`,match:{toolTextLineIncludesAll:[`provisioning profile`,`doesn't include`]},verdicts:{},buildFailure:b},{reason:`signing_provisioning_profile_expired`,match:{toolTextLineIncludesAll:[`provisioning profile`,`has expired`]},verdicts:{},buildFailure:b},{reason:`signing_unspecified`,match:{toolTextIncludesAll:[`code signing`]},verdicts:{},buildFailure:{reason:`signing_unspecified`,hint:`Enable Automatic Signing in Xcode or provide AGENT_DEVICE_IOS_TEAM_ID and optional AGENT_DEVICE_IOS_SIGNING_IDENTITY.`}},{reason:`devtools_security_refused`,match:{code:`COMMAND_FAILED`,details:g},verdicts:{},buildFailure:{reason:`devtools_security_developer_mode_disabled`,hint:"Run `sudo DevToolsSecurity -enable`, then retry the iOS runner. UI test runners start suspended until Xcode/testmanagerd can attach."}}];function S(e,t){return t.code!==void 0&&e.code!==t.code||!C(e,t.details)||!E(e,t.toolTextIncludesAll)||!D(e,t.toolTextLineIncludesAll)?!1:w(e,t.messageIncludesAll)}function C(e,t){return t===void 0||t(e.details??{})}function w(e,t){if(!t)return!0;let n=`${e.message??``}`.toLowerCase();return t.every(e=>n.includes(e))}function T(e){let t=e.details??{};return[e.message,t.stdout,t.stderr].filter(e=>typeof e==`string`).join(`
-`).toLowerCase()}function E(e,t){if(!t)return!0;let n=T(e);return t.every(e=>n.includes(e))}function D(e,t){return!t||T(e).split(`
-`).some(e=>t.every(t=>e.includes(t)))}function O(t,n){if(t instanceof e){for(let e of x)if(e.verdicts[n]!==void 0&&S(t,e.match))return e.verdicts[n]}}function k(t){return!(t instanceof e)||t.code!==`COMMAND_FAILED`?!1:O(t,`retryable`)??!1}function A(t){if(!(t instanceof e))return!1;let n=t.details?.runnerErrorCode;return n===d||n===f}function j(t){return!(t instanceof e)||t.code!==`DEVICE_NOT_FOUND`?!1:_(t.details??{})}function M(e){return O(e,`connectRetry`)??!0}function N(e){return O(e,`restartAfterReadinessPreflight`)??!1}function P(e){return O(e,`artifactSuspect`)??!1}function F(e){return O(e,`sessionFatalReason`)}function I(e){return(O(e,`restartBeforeSend`)??!1)&&M(e)}const L=`SCROLL_KEYBOARD_OCCLUDES_SURFACE`,R=new Set([d,f,i,L,...new Set([`APP_SCREEN_WINDOW_UNRESOLVED`,`APP_SCREEN_UNRESOLVED`,`APP_SCREEN_CAPTURE_UNRENDERABLE`])]);function z(e){let t=e!==void 0&&R.has(e);return Object.freeze({code:t?`COMMAND_FAILED`:n(e),details:Object.freeze({runnerErrorCode:e,...e===d?{retriable:!0}:{}})})}function B(t){let n;try{n=JSON.parse(t)}catch{throw new e(`COMMAND_FAILED`,`Invalid runner response`,{text:t})}return n&&typeof n==`object`?n:{}}function V(e){return e.ok===!0}function H(e){return!e.data||typeof e.data!=`object`||Array.isArray(e.data)?{}:e.data}function U(t,n){let r=W(t.error?.code),i=typeof t.error?.message==`string`?t.error.message:void 0,a=typeof t.error?.hint==`string`?t.error.hint:void 0,o=z(r);return new e(o.code,i??`Runner error`,{runner:t,...o.details,xcodebuild:{exitCode:1,stdout:``,stderr:``},hint:a,logPath:n})}function W(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}function G(e,t,n,r){let i=`${e}\n${t}\n${n}`.toLowerCase();if(i.includes(`device is busy`)&&i.includes(`connecting`))return`Target iOS device is still connecting. Keep it unlocked, wait for device trust/connection to settle, then retry.`;let a=r??`IOS_RUNNER_CONNECT_TIMEOUT`;return a===`IOS_RUNNER_DEVICE_NOT_PROVISIONED`?o(a):`${o(a)} ${p}`}function K(t){let{port:n,endpoints:r,logPath:i,lastError:a,deviceStates:s}=t,l=`Runner did not accept connection`;return Y(new e(`COMMAND_FAILED`,l,{port:n,endpoints:r,logPath:i,lastError:a?String(a):void 0,reason:c({error:a,message:l,context:{platform:`ios`,phase:`connect`}}),hint:o(`IOS_RUNNER_CONNECT_TIMEOUT`)}),s)}async function q(t){let{session:n,port:r,logPath:i}=t,a=await n.testPromise,o=`Runner did not accept connection (xcodebuild exited early)`,s=n.readLogTail?.(65536)??``,l=c({message:o,stdout:s,stderr:s,context:{platform:`ios`,phase:`connect`}});return Y(new e(`COMMAND_FAILED`,o,{port:r,logPath:n.runnerLogPath??i,xcodebuild:{exitCode:a.exitCode,stderr:s},reason:l,hint:G(o,s,s,l)}),n.startupDeviceStates)}function J(t){if(t instanceof e)for(let e of x){let n=e.buildFailure;if(n&&S(t,e.match))return{reason:n.reason,hint:n.hint,matched:!0}}return{reason:y,hint:p,matched:!1}}function Y(t,n){if(!n||!(t instanceof e))return t;let r=X(t)===void 0&&n.developerDiskImage===`unavailable`&&!Q(t)&&!Z(t);return new e(t.code,t.message,{...t.details??{},...r?{reason:`device_developer_disk_image_unavailable`,hint:n.developerDiskImageHint}:{},developerDiskImage:n.developerDiskImage},t.cause)}function X(e){let t=e.details?.reason;if(typeof t==`string`&&t!==`build_failed_unclassified`)return t}function Z(e){let t=e.details?.startupHostDeadlineHit;return typeof t==`boolean`?t:s(e)}function Q(e){let t=e.details?.startupRuleMatched;return typeof t==`boolean`?t:J(e).matched}function $(e){return e.command===`status`||e.commandId?.trim()?e:{...e,commandId:ee()}}function ee(){return`runner-${u.randomUUID()}`}function te(e){if(l(e))throw r()}export{P as _,U as a,M as b,B as c,A as d,V as f,m as g,F as h,q as i,Y as l,H as m,te as n,z as o,j as p,K as r,J as s,L as t,k as u,N as v,$ as x,I as y};