agent-device 0.11.1 → 0.11.2

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

@@ -1,11 +1,15 @@
 import AppKit
 import ApplicationServices
+import CoreGraphics
 import Foundation
 
 private enum SnapshotTraversalLimits {
   static let maxDesktopApps = 24
   static let maxNodes = 1500
   static let maxDepth = 12
+  static let maxMenuBarBandY = 64.0
+  static let maxMenuBarBandHeight = 64.0
+  static let maxMenuBarExtraWidth = 256.0
 }
 
 struct RectResponse: Encodable {
@@ -62,7 +66,17 @@ private struct SnapshotTraversalState {
   var truncated = false
 }
 
-func captureSnapshotResponse(surface: String) throws -> SnapshotResponse {
+private struct MenuBarWindowFallbackCandidate {
+  let windowNumber: Int
+  let rect: RectResponse
+  let layer: Int
+
+  var area: Double {
+    rect.width * rect.height
+  }
+}
+
+func captureSnapshotResponse(surface: String, bundleId: String? = nil) throws -> SnapshotResponse {
   let result: SnapshotBuildResult
   switch surface {
   case "frontmost-app":
@@ -70,7 +84,7 @@ func captureSnapshotResponse(surface: String) throws -> SnapshotResponse {
   case "desktop":
     result = snapshotDesktop()
   case "menubar":
-    result = snapshotMenuBar()
+    result = try snapshotMenuBar(bundleId: bundleId)
   default:
     throw HelperError.invalidArgs("snapshot requires --surface <frontmost-app|desktop|menubar>")
   }
@@ -200,8 +214,9 @@ private func appendApplicationSnapshot(
   return true
 }
 
-private func snapshotMenuBar() -> SnapshotBuildResult {
+private func snapshotMenuBar(bundleId: String?) throws -> SnapshotBuildResult {
   var state = SnapshotTraversalState()
+  let screenRect = mainScreenRectResponse()
   guard
     let rootIndex = appendSyntheticSnapshotNode(
       into: &state,
@@ -209,29 +224,54 @@ private func snapshotMenuBar() -> SnapshotBuildResult {
       label: "Menu Bar",
       depth: 0,
       parentIndex: nil,
-      surface: "menubar"
+      surface: "menubar",
+      rect: screenRect
     )
   else {
     return SnapshotBuildResult(nodes: state.nodes, truncated: true)
   }
 
-  if let frontmost = NSWorkspace.shared.frontmostApplication {
-    let frontmostElement = AXUIElementCreateApplication(frontmost.processIdentifier)
-    if let menuBar = elementAttribute(frontmostElement, attribute: kAXMenuBarAttribute as String) {
-      _ = appendElementSnapshot(
-        menuBar,
+  if let bundleId {
+    let targetApp = try resolveTargetApplication(bundleId: bundleId, surface: nil)
+    let appendedExtras = appendMenuBarSnapshot(
+      targetApp,
+      attribute: kAXExtrasMenuBarAttribute as String,
+      depth: 1,
+      parentIndex: rootIndex,
+      surface: "menubar",
+      state: &state
+    )
+    if !appendedExtras {
+      let appendedMenuBar = appendMenuBarSnapshot(
+        targetApp,
+        attribute: kAXMenuBarAttribute as String,
         depth: 1,
         parentIndex: rootIndex,
-        context: SnapshotContext(
-          surface: "menubar",
-          pid: Int32(frontmost.processIdentifier),
-          bundleId: frontmost.bundleIdentifier,
-          appName: frontmost.localizedName,
-          windowTitle: frontmost.localizedName
-        ),
+        surface: "menubar",
         state: &state
       )
+      if !appendedMenuBar {
+        _ = appendMenuBarWindowFallback(
+          targetApp,
+          depth: 1,
+          parentIndex: rootIndex,
+          surface: "menubar",
+          state: &state
+        )
+      }
     }
+    return SnapshotBuildResult(nodes: state.nodes, truncated: state.truncated)
+  }
+
+  if let frontmost = NSWorkspace.shared.frontmostApplication {
+    _ = appendMenuBarSnapshot(
+      frontmost,
+      attribute: kAXMenuBarAttribute as String,
+      depth: 1,
+      parentIndex: rootIndex,
+      surface: "menubar",
+      state: &state
+    )
   }
 
   if !state.truncated,
@@ -239,20 +279,24 @@ private func snapshotMenuBar() -> SnapshotBuildResult {
        withBundleIdentifier: "com.apple.systemuiserver"
      ).first
   {
-    let systemUiElement = AXUIElementCreateApplication(systemUiServer.processIdentifier)
-    if let menuExtras = elementAttribute(systemUiElement, attribute: kAXMenuBarAttribute as String) {
-      _ = appendElementSnapshot(
-        menuExtras,
+    let appendedExtras = appendMenuBarSnapshot(
+      systemUiServer,
+      attribute: kAXExtrasMenuBarAttribute as String,
+      depth: 1,
+      parentIndex: rootIndex,
+      surface: "menubar",
+      state: &state,
+      windowTitle: "System Menu Extras"
+    )
+    if !appendedExtras {
+      _ = appendMenuBarSnapshot(
+        systemUiServer,
+        attribute: kAXMenuBarAttribute as String,
         depth: 1,
         parentIndex: rootIndex,
-        context: SnapshotContext(
-          surface: "menubar",
-          pid: Int32(systemUiServer.processIdentifier),
-          bundleId: systemUiServer.bundleIdentifier,
-          appName: systemUiServer.localizedName,
-          windowTitle: "System Menu Extras"
-        ),
-        state: &state
+        surface: "menubar",
+        state: &state,
+        windowTitle: "System Menu Extras"
       )
     }
   }
@@ -260,6 +304,67 @@ private func snapshotMenuBar() -> SnapshotBuildResult {
   return SnapshotBuildResult(nodes: state.nodes, truncated: state.truncated)
 }
 
+@discardableResult
+private func appendMenuBarSnapshot(
+  _ app: NSRunningApplication,
+  attribute: String,
+  depth: Int,
+  parentIndex: Int,
+  surface: String,
+  state: inout SnapshotTraversalState,
+  windowTitle: String? = nil
+) -> Bool {
+  let appElement = AXUIElementCreateApplication(app.processIdentifier)
+  guard let menuBar = elementAttribute(appElement, attribute: attribute) else {
+    return false
+  }
+
+  let nodeCountBefore = state.nodes.count
+  _ = appendElementSnapshot(
+    menuBar,
+    depth: depth,
+    parentIndex: parentIndex,
+    context: SnapshotContext(
+      surface: surface,
+      pid: Int32(app.processIdentifier),
+      bundleId: app.bundleIdentifier,
+      appName: app.localizedName,
+      windowTitle: windowTitle ?? app.localizedName
+    ),
+    state: &state
+  )
+  return state.nodes.count > nodeCountBefore
+}
+
+@discardableResult
+private func appendMenuBarWindowFallback(
+  _ app: NSRunningApplication,
+  depth: Int,
+  parentIndex: Int,
+  surface: String,
+  state: inout SnapshotTraversalState
+) -> Bool {
+  guard let candidate = menuBarWindowFallbackCandidate(for: app) else {
+    return false
+  }
+
+  return appendSyntheticSnapshotNode(
+    into: &state,
+    type: "MenuBarItem",
+    label: app.localizedName ?? app.bundleIdentifier ?? "Menu Bar Item",
+    depth: depth,
+    parentIndex: parentIndex,
+    surface: surface,
+    identifier: "cgwindow:\(candidate.windowNumber)",
+    pid: Int32(app.processIdentifier),
+    bundleId: app.bundleIdentifier,
+    appName: app.localizedName,
+    windowTitle: app.localizedName,
+    rect: candidate.rect,
+    hittable: true
+  ) != nil
+}
+
 @discardableResult
 private func appendSyntheticSnapshotNode(
   into state: inout SnapshotTraversalState,
@@ -272,7 +377,9 @@ private func appendSyntheticSnapshotNode(
   pid: Int32? = nil,
   bundleId: String? = nil,
   appName: String? = nil,
-  windowTitle: String? = nil
+  windowTitle: String? = nil,
+  rect: RectResponse? = nil,
+  hittable: Bool = false
 ) -> Int? {
   guard reserveSnapshotNodeCapacity(&state) else {
     return nil
@@ -288,10 +395,10 @@ private func appendSyntheticSnapshotNode(
       label: label,
       value: nil,
       identifier: identifier ?? "surface:\(surface):\(type.lowercased())",
-      rect: nil,
+      rect: rect,
       enabled: true,
       selected: nil,
-      hittable: false,
+      hittable: hittable && rect != nil,
       depth: depth,
       parentIndex: parentIndex,
       pid: pid,
@@ -304,6 +411,83 @@ private func appendSyntheticSnapshotNode(
   return index
 }
 
+private func mainScreenRectResponse() -> RectResponse? {
+  guard let screenFrame = NSScreen.main?.frame, screenFrame.width > 0, screenFrame.height > 0 else {
+    return nil
+  }
+  return RectResponse(
+    x: Double(screenFrame.origin.x),
+    y: Double(screenFrame.origin.y),
+    width: Double(screenFrame.width),
+    height: Double(screenFrame.height)
+  )
+}
+
+private func menuBarWindowFallbackCandidate(
+  for app: NSRunningApplication
+) -> MenuBarWindowFallbackCandidate? {
+  guard
+    let windowInfoList = CGWindowListCopyWindowInfo([.optionAll], kCGNullWindowID)
+      as? [[String: Any]]
+  else {
+    return nil
+  }
+
+  let pid = Int(app.processIdentifier)
+  let allCandidates = windowInfoList.compactMap { info -> MenuBarWindowFallbackCandidate? in
+    let ownerPid = (info[kCGWindowOwnerPID as String] as? NSNumber)?.intValue
+    guard ownerPid == pid else {
+      return nil
+    }
+    guard let boundsDictionary = info[kCGWindowBounds as String] as? NSDictionary,
+          let bounds = CGRect(dictionaryRepresentation: boundsDictionary)
+    else {
+      return nil
+    }
+    guard bounds.width > 0, bounds.height > 0 else {
+      return nil
+    }
+    let alpha = (info[kCGWindowAlpha as String] as? NSNumber)?.doubleValue ?? 1
+    guard alpha > 0 else {
+      return nil
+    }
+    let rect = RectResponse(
+      x: Double(bounds.origin.x),
+      y: Double(bounds.origin.y),
+      width: Double(bounds.width),
+      height: Double(bounds.height)
+    )
+    let windowNumber = (info[kCGWindowNumber as String] as? NSNumber)?.intValue ?? 0
+    let layer = (info[kCGWindowLayer as String] as? NSNumber)?.intValue ?? 0
+    return MenuBarWindowFallbackCandidate(
+      windowNumber: windowNumber,
+      rect: rect,
+      layer: layer
+    )
+  }
+
+  // CGWindowList can surface multiple app-owned utility windows. Prefer the small
+  // top-band window that matches typical menu bar extra geometry before ranking by area.
+  let menuBarBandCandidates = allCandidates.filter { candidate in
+    candidate.rect.y <= SnapshotTraversalLimits.maxMenuBarBandY
+      && candidate.rect.height <= SnapshotTraversalLimits.maxMenuBarBandHeight
+  }
+  let narrowCandidates = menuBarBandCandidates.filter { candidate in
+    candidate.rect.width <= SnapshotTraversalLimits.maxMenuBarExtraWidth
+  }
+  let rankedCandidates = (narrowCandidates.isEmpty ? menuBarBandCandidates : narrowCandidates)
+    .sorted { left, right in
+      if left.area != right.area {
+        return left.area < right.area
+      }
+      if left.layer != right.layer {
+        return left.layer < right.layer
+      }
+      return left.windowNumber < right.windowNumber
+    }
+  return rankedCandidates.first
+}
+
 @discardableResult
 private func appendElementSnapshot(
   _ element: AXUIElement,
@@ -361,7 +545,7 @@ private func appendElementSnapshot(
     return index
   }
 
-  for child in children(of: element) {
+  for child in snapshotChildren(of: element, role: role) {
     if state.truncated {
       break
     }
@@ -522,9 +706,9 @@ private func accessibilityAxValue(_ value: CFTypeRef?) -> AXValue? {
   return (value as! AXValue)
 }
 
-func children(of element: AXUIElement) -> [AXUIElement] {
+private func elementArrayAttribute(_ element: AXUIElement, attribute: String) -> [AXUIElement] {
   var value: CFTypeRef?
-  guard AXUIElementCopyAttributeValue(element, kAXChildrenAttribute as CFString, &value) == .success,
+  guard AXUIElementCopyAttributeValue(element, attribute as CFString, &value) == .success,
         let children = value as? [AXUIElement]
   else {
     return []
@@ -532,6 +716,23 @@ func children(of element: AXUIElement) -> [AXUIElement] {
   return children
 }
 
+func children(of element: AXUIElement) -> [AXUIElement] {
+  return elementArrayAttribute(element, attribute: kAXChildrenAttribute as String)
+}
+
+private func snapshotChildren(of element: AXUIElement, role: String?) -> [AXUIElement] {
+  let directChildren = children(of: element)
+  if !directChildren.isEmpty {
+    return directChildren
+  }
+  switch role {
+  case "AXMenuBar", "AXMenuBarItem", "AXMenu":
+    return elementArrayAttribute(element, attribute: kAXVisibleChildrenAttribute as String)
+  default:
+    return []
+  }
+}
+
 func windows(of appElement: AXUIElement) -> [AXUIElement] {
   var value: CFTypeRef?
   guard AXUIElementCopyAttributeValue(appElement, "AXWindows" as CFString, &value) == .success,

package/macos-helper/Sources/AgentDeviceMacOSHelper/main.swift

@@ -2,6 +2,9 @@ import AppKit
 import ApplicationServices
 import CoreGraphics
 import Foundation
+import ImageIO
+import ScreenCaptureKit
+import UniformTypeIdentifiers
 
 enum HelperError: Error {
   case invalidArgs(String)
@@ -57,6 +60,19 @@ struct ReadResponse: Encodable {
   let text: String
 }
 
+struct PressResponse: Encodable {
+  let x: Double
+  let y: Double
+  let bundleId: String?
+  let surface: String?
+}
+
+struct ScreenshotResponse: Encodable {
+  let path: String
+  let surface: String?
+  let fullscreen: Bool
+}
+
 struct AgentDeviceMacOSHelper {
   static func main() {
     do {
@@ -100,6 +116,10 @@ struct AgentDeviceMacOSHelper {
       return try handleSnapshot(arguments: Array(arguments.dropFirst()))
     case "read":
       return try handleRead(arguments: Array(arguments.dropFirst()))
+    case "press":
+      return try handlePress(arguments: Array(arguments.dropFirst()))
+    case "screenshot":
+      return try handleScreenshot(arguments: Array(arguments.dropFirst()))
     default:
       throw HelperError.invalidArgs("unknown command: \(command)")
     }
@@ -315,11 +335,13 @@ struct AgentDeviceMacOSHelper {
       throw HelperError.invalidArgs("snapshot requires --surface <frontmost-app|desktop|menubar>")
     }
 
+    let bundleId = try optionValue(arguments: arguments, name: "--bundle-id").map(validatedBundleId)
+
     switch surface {
     case "frontmost-app":
-      return SuccessEnvelope(data: try captureSnapshotResponse(surface: surface))
+      return SuccessEnvelope(data: try captureSnapshotResponse(surface: surface, bundleId: bundleId))
     case "desktop", "menubar":
-      return SuccessEnvelope(data: try captureSnapshotResponse(surface: surface))
+      return SuccessEnvelope(data: try captureSnapshotResponse(surface: surface, bundleId: bundleId))
     default:
       throw HelperError.invalidArgs("snapshot requires --surface <frontmost-app|desktop|menubar>")
     }
@@ -339,6 +361,35 @@ struct AgentDeviceMacOSHelper {
     let text = try readTextAtPosition(bundleId: bundleId, surface: surface, x: x, y: y)
     return SuccessEnvelope(data: ReadResponse(text: text))
   }
+
+  static func handlePress(arguments: [String]) throws -> any Encodable {
+    guard let rawX = optionValue(arguments: arguments, name: "--x"),
+          let rawY = optionValue(arguments: arguments, name: "--y"),
+          let x = Double(rawX),
+          let y = Double(rawY)
+    else {
+      throw HelperError.invalidArgs("press requires --x <number> --y <number>")
+    }
+
+    let bundleId = try optionValue(arguments: arguments, name: "--bundle-id").map(validatedBundleId)
+    let surface = optionValue(arguments: arguments, name: "--surface")
+    try pressAtPosition(bundleId: bundleId, surface: surface, x: x, y: y)
+    return SuccessEnvelope(data: PressResponse(x: x, y: y, bundleId: bundleId, surface: surface))
+  }
+
+  static func handleScreenshot(arguments: [String]) throws -> any Encodable {
+    guard let outPath = optionValue(arguments: arguments, name: "--out")?
+      .trimmingCharacters(in: .whitespacesAndNewlines),
+      !outPath.isEmpty
+    else {
+      throw HelperError.invalidArgs("screenshot requires --out <path>")
+    }
+
+    let surface = optionValue(arguments: arguments, name: "--surface")
+    let fullscreen = arguments.contains("--fullscreen")
+    try captureSurfaceScreenshot(surface: surface, outPath: outPath, fullscreen: fullscreen)
+    return SuccessEnvelope(data: ScreenshotResponse(path: outPath, surface: surface, fullscreen: fullscreen))
+  }
 }
 
 private func optionValue(arguments: [String], name: String) -> String? {
@@ -395,6 +446,74 @@ private func readTextAtPosition(bundleId: String?, surface: String?, x: Double,
   throw HelperError.commandFailed("read did not resolve text")
 }
 
+private func pressAtPosition(bundleId: String?, surface: String?, x: Double, y: Double) throws {
+  _ = bundleId
+  _ = surface
+  let point = CGPoint(x: x, y: y)
+  guard let move = CGEvent(mouseEventSource: nil, mouseType: .mouseMoved, mouseCursorPosition: point, mouseButton: .left),
+        let down = CGEvent(mouseEventSource: nil, mouseType: .leftMouseDown, mouseCursorPosition: point, mouseButton: .left),
+        let up = CGEvent(mouseEventSource: nil, mouseType: .leftMouseUp, mouseCursorPosition: point, mouseButton: .left)
+  else {
+    throw HelperError.commandFailed("press action failed", details: ["reason": "event_creation_failed"])
+  }
+  move.post(tap: .cghidEventTap)
+  down.post(tap: .cghidEventTap)
+  up.post(tap: .cghidEventTap)
+}
+
+private func captureSurfaceScreenshot(surface: String?, outPath: String, fullscreen: Bool) throws {
+  _ = fullscreen
+  guard #available(macOS 15.2, *) else {
+    throw HelperError.commandFailed(
+      "screenshot on macOS desktop and menubar surfaces requires macOS 15.2 or newer"
+    )
+  }
+  guard let screenFrame = NSScreen.main?.frame, screenFrame.width > 0, screenFrame.height > 0 else {
+    throw HelperError.commandFailed("screenshot could not resolve main screen bounds")
+  }
+
+  let rect = CGRect(origin: screenFrame.origin, size: screenFrame.size)
+  let semaphore = DispatchSemaphore(value: 0)
+  var capturedImage: CGImage?
+  var capturedError: Error?
+  SCScreenshotManager.captureImage(in: rect) { image, error in
+    capturedImage = image
+    capturedError = error
+    semaphore.signal()
+  }
+  semaphore.wait()
+
+  if let error = capturedError as NSError? {
+    if error.domain == "com.apple.ScreenCaptureKit.SCStreamErrorDomain", error.code == -3801 {
+      throw HelperError.commandFailed(
+        "screenshot requires Screen Recording permission on macOS desktop and menubar surfaces",
+        details: ["surface": surface ?? "", "permission": "screen-recording"]
+      )
+    }
+    throw HelperError.commandFailed("screenshot failed", details: ["error": error.localizedDescription])
+  }
+  guard let capturedImage else {
+    throw HelperError.commandFailed("screenshot failed")
+  }
+
+  let outputURL = URL(fileURLWithPath: outPath)
+  if let parent = outputURL.deletingLastPathComponent().path.removingPercentEncoding, !parent.isEmpty {
+    try FileManager.default.createDirectory(atPath: parent, withIntermediateDirectories: true)
+  }
+  guard let destination = CGImageDestinationCreateWithURL(
+    outputURL as CFURL,
+    UTType.png.identifier as CFString,
+    1,
+    nil
+  ) else {
+    throw HelperError.commandFailed("screenshot could not create PNG destination")
+  }
+  CGImageDestinationAddImage(destination, capturedImage, nil)
+  guard CGImageDestinationFinalize(destination) else {
+    throw HelperError.commandFailed("screenshot could not write PNG file")
+  }
+}
+
 private func readableText(for element: AXUIElement) -> String? {
   return
     stringAttribute(element, attribute: kAXValueAttribute as String)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Unified control plane for physical and virtual devices via an agent-driven CLI.",
   "license": "MIT",
   "author": "Callstack",
@@ -30,7 +30,12 @@
     "build:macos-helper": "swift build -c release --package-path macos-helper",
     "build:all": "pnpm build:node && pnpm build:xcuitest",
     "ad": "node bin/agent-device.mjs",
-    "format": "prettier --write src test skills",
+    "lint": "oxlint . --deny-warnings",
+    "format": "oxfmt --write src test skills package.json tsconfig.json .oxlintrc.json .oxfmtrc.json",
+    "check:quick": "pnpm lint && pnpm typecheck",
+    "check:tooling": "pnpm lint && pnpm typecheck && pnpm build",
+    "check:unit": "pnpm test:unit && pnpm test:smoke",
+    "check": "pnpm check:tooling && pnpm check:unit",
     "prepack": "pnpm build:all",
     "typecheck": "tsc -p tsconfig.json",
     "test": "vitest run",
@@ -66,22 +71,17 @@
     "ios",
     "android"
   ],
-  "prettier": {
-    "singleQuote": true,
-    "semi": true,
-    "trailingComma": "all",
-    "printWidth": 100
-  },
   "dependencies": {
     "pngjs": "^7.0.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.10",
-    "@rslib/core": "0.19.4",
+    "@rslib/core": "0.20.1",
     "@types/node": "^22.0.0",
     "@types/pngjs": "^6.0.5",
-    "prettier": "^3.3.3",
-    "typescript": "^5.9.3",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0",
+    "typescript": "^6.0.2",
     "vitest": "^4.1.2"
   }
 }

package/skills/agent-device/references/macos-desktop.md

@@ -30,7 +30,8 @@ agent-device close
 - `app`: default surface and the normal choice for `click`, `fill`, `press`, `scroll`, `screenshot`, and `record`.
 - `frontmost-app`: inspect the currently focused app without naming it first.
 - `desktop`: inspect visible desktop windows across apps.
-- `menubar`: inspect the active app menu bar and system menu extras.
+- `menubar`: inspect the active app menu bar and system menu extras. Use `open <app> --platform macos --surface menubar` when you need one menu bar app's extras, such as a status-item app.
+- Menu bar apps can expose a sparse or empty default `app` tree. Prefer the `menubar` surface first when the app lives entirely in the top bar.
 
 Use inspect-first surfaces to understand desktop-global UI, then switch back to `app` when you need to act in one app.
 
@@ -81,6 +82,6 @@ Troubleshooting:
 
 - If visible content is missing from `snapshot -i`, re-snapshot after the UI settles.
 - If `desktop` is too broad, retry with `frontmost-app`.
-- If `menubar` is missing the expected menu, make the app frontmost first and retry.
+- If `menubar` is missing the expected menu, retry with `open <app> --platform macos --surface menubar` for menu bar apps, or make the app frontmost first and retry the generic menubar surface.
 - If the wrong menu opened, retry secondary-clicking the row or cell wrapper rather than the nested text node.
 - If the app has multiple windows, make the correct window frontmost before relying on refs.

package/dist/src/306.js

@@ -1,3 +0,0 @@
-import{AsyncLocalStorage as e}from"node:async_hooks";import t,{createHash as r}from"node:crypto";import n,{existsSync as i,promises as o}from"node:fs";import a from"node:os";import s from"node:path";import{PNG as l}from"pngjs";import{URL as d,fileURLToPath as u,pathToFileURL as c}from"node:url";import{spawn as p,spawnSync as f}from"node:child_process";let m=new e,h=/(token|secret|password|authorization|cookie|api[_-]?key|access[_-]?key|private[_-]?key)/i,g=/(bearer\s+[a-z0-9._-]+|(?:api[_-]?key|token|secret|password)\s*[=:]\s*\S+)/i;function w(){return t.randomBytes(8).toString("hex")}async function I(e,r){let n={...e,diagnosticId:`${Date.now().toString(36)}-${t.randomBytes(4).toString("hex")}`,events:[]};return await m.run(n,r)}function S(){let e=m.getStore();return e?{diagnosticId:e.diagnosticId,requestId:e.requestId,session:e.session,command:e.command,debug:e.debug}:{}}function v(e){let t=m.getStore();if(!t)return;let r={ts:new Date().toISOString(),level:e.level??"info",phase:e.phase,session:t.session,requestId:t.requestId,command:t.command,durationMs:e.durationMs,data:e.data?b(e.data):void 0};if(t.events.push(r),!t.debug)return;let i=`[agent-device][diag] ${JSON.stringify(r)}
-`;try{t.logPath&&n.appendFile(t.logPath,i,()=>{}),t.traceLogPath&&n.appendFile(t.traceLogPath,i,()=>{}),t.logPath||t.traceLogPath||process.stderr.write(i)}catch{}}async function y(e,t,r){let n=Date.now();try{let i=await t();return v({level:"info",phase:e,durationMs:Date.now()-n,data:r}),i}catch(t){throw v({level:"error",phase:e,durationMs:Date.now()-n,data:{...r??{},error:t instanceof Error?t.message:String(t)}}),t}}function A(e={}){let t=m.getStore();if(!t||!e.force&&!t.debug||0===t.events.length)return null;try{let e=(t.session??"default").replace(/[^a-zA-Z0-9._-]/g,"_"),r=new Date().toISOString().slice(0,10),i=s.join(a.homedir(),".agent-device","logs",e,r);n.mkdirSync(i,{recursive:!0});let o=new Date().toISOString().replace(/[:.]/g,"-"),l=s.join(i,`${o}-${t.diagnosticId}.ndjson`),d=t.events.map(e=>JSON.stringify(b(e)));return n.writeFileSync(l,`${d.join("\n")}
-`),t.events=[],l}catch{return null}}function b(e){return function e(t,r,n){if(null==t)return t;if("string"==typeof t){var i=t,o=n;let e=i.trim();if(!e)return i;if(o&&h.test(o)||g.test(e))return"[REDACTED]";let r=function(e){try{let t=new URL(e);return t.search&&(t.search="?REDACTED"),(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED"),t.toString()}catch{return null}}(e);return r||(e.length>400?`${e.slice(0,200)}...<truncated>`:e)}if("object"!=typeof t)return t;if(r.has(t))return"[Circular]";if(r.add(t),Array.isArray(t))return t.map(t=>e(t,r));let a={};for(let[n,i]of Object.entries(t)){if(h.test(n)){a[n]="[REDACTED]";continue}a[n]=e(i,r,n)}return a}(e,new WeakSet)}class E extends Error{code;details;cause;constructor(e,t,r,n){super(t),this.code=e,this.details=r,this.cause=n}}function $(e){return e instanceof E?e:e instanceof Error?new E("UNKNOWN",e.message,void 0,e):new E("UNKNOWN","Unknown error",{err:e})}function N(e,t={}){let r=$(e),n=r.details?b(r.details):void 0,i=n&&"string"==typeof n.hint?n.hint:void 0,o=(n&&"string"==typeof n.diagnosticId?n.diagnosticId:void 0)??t.diagnosticId,a=(n&&"string"==typeof n.logPath?n.logPath:void 0)??t.logPath,s=i??function(e){switch(e){case"INVALID_ARGS":return"Check command arguments and run --help for usage examples.";case"SESSION_NOT_FOUND":return"Run open first or pass an explicit device selector.";case"TOOL_MISSING":return"Install required platform tooling and ensure it is available in PATH.";case"DEVICE_NOT_FOUND":return"Verify the target device is booted/connected and selectors match.";case"UNSUPPORTED_OPERATION":return"This command is not available for the selected platform/device.";case"COMMAND_FAILED":default:return"Retry with --debug and inspect diagnostics log for details.";case"UNAUTHORIZED":return"Refresh daemon metadata and retry the command."}}(r.code),l=function(e){if(!e)return;let t={...e};return delete t.hint,delete t.diagnosticId,delete t.logPath,Object.keys(t).length>0?t:void 0}(n),d=function(e,t,r){if("COMMAND_FAILED"!==e||r?.processExitError!==!0)return t;let n=function(e){let t=[/^an error was encountered processing the command/i,/^underlying error\b/i,/^simulator device failed to complete the requested operation/i];for(let r of e.split("\n")){let e=r.trim();if(e&&!t.some(t=>t.test(e)))return e.length>200?`${e.slice(0,200)}...`:e}return null}("string"==typeof r?.stderr?r.stderr:"");return n||t}(r.code,r.message,n);return{code:r.code,message:d,hint:s,diagnosticId:o,logPath:a,details:l}}let D="<wifi|airplane|location> <on|off>",x="appearance <light|dark|toggle>",_="faceid <match|nonmatch|enroll|unenroll>",T="touchid <match|nonmatch|enroll|unenroll>",L="fingerprint <match|nonmatch>",O="permission <grant|deny|reset> <camera|microphone|photos|contacts|contacts-limited|notifications|calendar|location|location-always|media-library|motion|reminders|siri> [full|limited]",M="permission <grant|reset> <accessibility|screen-recording|input-monitoring>",C=`settings ${D} | settings ${x} | settings ${_} | settings ${T} | settings ${L} | settings ${O} | settings ${M}`,k=`settings requires ${D}, ${x}, ${_}, ${T}, ${L}, ${O}, or ${M}`,P=["app","frontmost-app","desktop","menubar"];function R(e){let t=e?.trim().toLowerCase();if("app"===t||"frontmost-app"===t||"desktop"===t||"menubar"===t)return t;throw new E("INVALID_ARGS",`Invalid surface: ${e}. Use ${P.join("|")}.`)}function F(e){var t;let r,n=B(e.label),i=B(e.value),o=B(e.identifier),a=(t=o)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?o:"";return(r=j(e.type??"")).includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||r.includes("textview")||r.includes("textarea")?i||n||a:n||i||a}function B(e){return"string"==typeof e?e.trim():""}function j(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),r=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}function G(e,t={}){let r=[],n=[];for(let i of e){let e=i.depth??0;for(;r.length>0&&e<=r[r.length-1];)r.pop();let o=i.label?.trim()||i.value?.trim()||i.identifier?.trim()||"",a=V(i.type??"Element"),s="group"===a&&!o;s&&r.push(e);let l=s?e:Math.max(0,e-r.length);n.push({node:i,depth:l,type:a,text:z(i,l,s,a,t)})}return n}function z(e,t,r,n,i={}){var o,a,s,l,d;let u,c,p=n??V(e.type??"Element"),f=(u=F(e),{text:u,isLargeSurface:c=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let r=j(e.type??""),n=`${e.role??""} ${e.subrole??""}`.toLowerCase();return r.includes("textview")||r.includes("textarea")||r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||n.includes("text area")||n.includes("text field")}(e,p),shouldSummarize:c&&!!(o=u)&&(o.length>80||/[\r\n]/.test(o))}),m=(a=e,s=p,l=i,d=f,l.summarizeTextSurfaces&&d.shouldSummarize&&function(e,t,r){let n=B(e.label);if(n&&n!==r)return n;let i=B(e.identifier);if(i&&!q(i)&&i!==r)return i;switch(t){case"text":case"text-view":return"Text view";case"text-field":return"Text field";case"search":return"Search field";default:return""}}(a,s,d.text)||U(a,s)),h="  ".repeat(t),g=e.ref?`@${e.ref}`:"",w=(function(e,t,r,n){let i,o=[];if(!1===e.enabled&&o.push("disabled"),!r.summarizeTextSurfaces||(!0===e.selected&&o.push("selected"),H(t)&&o.push("editable"),function(e,t){if("scroll-area"===t)return!0;let r=(e.type??"").toLowerCase(),n=`${e.role??""} ${e.subrole??""}`.toLowerCase();return r.includes("scroll")||n.includes("scroll")}(e,t)&&o.push("scrollable"),!n.shouldSummarize))return o;return o.push(`preview:"${((i=n.text.replace(/\s+/g," ").trim()).length<=48?i:`${i.slice(0,45)}...`).replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`),o.push("truncated"),[...new Set(o)]})(e,p,i,f).map(e=>` [${e}]`).join(""),I=m?` "${m}"`:"";return r?`${h}${g} [${p}]${w}`.trimEnd():`${h}${g} [${p}]${I}${w}`.trimEnd()}function U(e,t){let r=e.label?.trim(),n=e.value?.trim();if(H(t)){if(n)return n;if(r)return r}else if(r)return r;if(n)return n;let i=e.identifier?.trim();return!i||q(i)&&("group"===t||"image"===t||"list"===t||"collection"===t)?"":i}function V(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),r=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return r?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}function H(e){return"text-field"===e||"text-view"===e||"search"===e}function q(e){return/^[\w.]+:id\/[\w.-]+$/i.test(e)}function J(){try{let e=W();return JSON.parse(n.readFileSync(s.join(e,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function W(){let e=s.dirname(u(import.meta.url)),t=e;for(let e=0;e<6;e+=1){let e=s.join(t,"package.json");if(n.existsSync(e))return t;t=s.dirname(t)}return e}function K(e){return e?{message:e}:{}}function X(e,t){return t?{...e,message:t}:e}function Z(e){return"string"==typeof e?.message&&e.message.length>0?e.message:null}async function Q(e,t,r={}){return new Promise((n,i)=>{let o=p(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached}),a="",s=r.binaryStdout?Buffer.alloc(0):void 0,l="",d=!1,u=ei(r.timeoutMs),c=u?setTimeout(()=>{d=!0,o.kill("SIGKILL")},u):null;r.binaryStdout||o.stdout.setEncoding("utf8"),o.stderr.setEncoding("utf8"),void 0!==r.stdin&&o.stdin.write(r.stdin),o.stdin.end(),o.stdout.on("data",e=>{r.binaryStdout?s=Buffer.concat([s??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]):a+=e}),o.stderr.on("data",e=>{l+=e}),o.on("error",r=>{(c&&clearTimeout(c),"ENOENT"===r.code)?i(new E("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):i(new E("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),o.on("close",o=>{c&&clearTimeout(c);let p=o??1;d&&u?i(new E("COMMAND_FAILED",`${e} timed out after ${u}ms`,{cmd:e,args:t,stdout:a,stderr:l,exitCode:p,timeoutMs:u})):0===p||r.allowFailure?n({stdout:a,stderr:l,exitCode:p,stdoutBuffer:s}):i(new E("COMMAND_FAILED",`${e} exited with code ${p}`,{cmd:e,args:t,stdout:a,stderr:l,exitCode:p,processExitError:!0}))})})}async function Y(e){try{var t;let{shell:r,args:n}=(t=e,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",t]}:{shell:"bash",args:["-lc",`command -v ${t}`]}),i=await Q(r,n,{allowFailure:!0});return 0===i.exitCode&&i.stdout.trim().length>0}catch{return!1}}function ee(e,t,r={}){let n=f(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],encoding:r.binaryStdout?void 0:"utf8",input:r.stdin,timeout:ei(r.timeoutMs)});if(n.error){let i=n.error.code;if("ETIMEDOUT"===i)throw new E("COMMAND_FAILED",`${e} timed out after ${ei(r.timeoutMs)}ms`,{cmd:e,args:t,timeoutMs:ei(r.timeoutMs)},n.error);if("ENOENT"===i)throw new E("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n.error);throw new E("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n.error)}let i=r.binaryStdout?Buffer.isBuffer(n.stdout)?n.stdout:Buffer.from(n.stdout??""):void 0,o=r.binaryStdout?"":"string"==typeof n.stdout?n.stdout:(n.stdout??"").toString(),a="string"==typeof n.stderr?n.stderr:(n.stderr??"").toString(),s=n.status??1;if(0!==s&&!r.allowFailure)throw new E("COMMAND_FAILED",`${e} exited with code ${s}`,{cmd:e,args:t,stdout:o,stderr:a,exitCode:s,processExitError:!0});return{stdout:o,stderr:a,exitCode:s,stdoutBuffer:i}}function et(e,t,r={}){p(e,t,{cwd:r.cwd,env:r.env,stdio:"ignore",detached:!0}).unref()}async function er(e,t,r={}){return new Promise((n,i)=>{let o=p(e,t,{cwd:r.cwd,env:r.env,stdio:["pipe","pipe","pipe"],detached:r.detached});r.onSpawn?.(o);let a="",s="",l=r.binaryStdout?Buffer.alloc(0):void 0;r.binaryStdout||o.stdout.setEncoding("utf8"),o.stderr.setEncoding("utf8"),void 0!==r.stdin&&o.stdin.write(r.stdin),o.stdin.end(),o.stdout.on("data",e=>{if(r.binaryStdout){l=Buffer.concat([l??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]);return}let t=String(e);a+=t,r.onStdoutChunk?.(t)}),o.stderr.on("data",e=>{let t=String(e);s+=t,r.onStderrChunk?.(t)}),o.on("error",r=>{"ENOENT"===r.code?i(new E("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):i(new E("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),o.on("close",o=>{let d=o??1;0===d||r.allowFailure?n({stdout:a,stderr:s,exitCode:d,stdoutBuffer:l}):i(new E("COMMAND_FAILED",`${e} exited with code ${d}`,{cmd:e,args:t,stdout:a,stderr:s,exitCode:d,processExitError:!0}))})})}function en(e,t,r={}){let n=p(e,t,{cwd:r.cwd,env:r.env,stdio:["ignore","pipe","pipe"],detached:r.detached}),i="",o="";n.stdout.setEncoding("utf8"),n.stderr.setEncoding("utf8"),n.stdout.on("data",e=>{i+=e}),n.stderr.on("data",e=>{o+=e});let a=new Promise((a,s)=>{n.on("error",r=>{"ENOENT"===r.code?s(new E("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},r)):s(new E("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},r))}),n.on("close",n=>{let l=n??1;0===l||r.allowFailure?a({stdout:i,stderr:o,exitCode:l}):s(new E("COMMAND_FAILED",`${e} exited with code ${l}`,{cmd:e,args:t,stdout:i,stderr:o,exitCode:l,processExitError:!0}))})});return{child:n,wait:a}}function ei(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}let eo=[/(^|[\/\s"'=])dist\/src\/daemon\.js($|[\s"'])/,/(^|[\/\s"'=])src\/daemon\.ts($|[\s"'])/];function ea(e){if(!Number.isInteger(e)||e<=0)return!1;try{return process.kill(e,0),!0}catch(e){return"EPERM"===e.code}}function es(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=ee("ps",["-p",String(e),"-o","lstart="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}function el(e){if(!Number.isInteger(e)||e<=0)return null;try{let t=ee("ps",["-p",String(e),"-o","command="],{allowFailure:!0,timeoutMs:1e3});if(0!==t.exitCode)return null;let r=t.stdout.trim();return r.length>0?r:null}catch{return null}}function ed(e,t){let r;if(!ea(e))return!1;if(t){let r=es(e);if(!r||r!==t)return!1}let n=el(e);return!!n&&!!(r=n.toLowerCase().replaceAll("\\","/")).includes("agent-device")&&eo.some(e=>e.test(r))}function eu(e,t){try{return process.kill(e,t),!0}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return!1;throw t}}async function ec(e,t){if(!ea(e))return!0;let r=Date.now();for(;Date.now()-r<t;)if(await new Promise(e=>setTimeout(e,50)),!ea(e))return!0;return!ea(e)}async function ep(e,t){!ed(e,t.expectedStartTime)||!eu(e,"SIGTERM")||await ec(e,t.termTimeoutMs)||eu(e,"SIGKILL")&&await ec(e,t.killTimeoutMs)}function ef(e){return e?.HOME?.trim()||a.homedir()}function em(e,t={}){return"~"===e?ef(t.env):e.startsWith("~/")?s.join(ef(t.env),e.slice(2)):e}function eh(e,t={}){let r=em(e,t);return s.isAbsolute(r)?r:s.resolve(t.cwd??process.cwd(),r)}function eg(e){let t,r=(t=(e??"").trim())?eh(t):s.join(em("~"),".agent-device");return{baseDir:r,infoPath:s.join(r,"daemon.json"),lockPath:s.join(r,"daemon.lock"),logPath:s.join(r,"daemon.log"),sessionsDir:s.join(r,"sessions")}}function ew(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function eI(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function eS(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function ev(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let ey=100,eA=new Set(["batch","replay"]),eb=new Set(["command","positionals","flags","runtime"]);function eE(e){let t;try{t=JSON.parse(e)}catch{throw new E("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(t)||0===t.length)throw new E("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return t}function e$(e,t){if(!Array.isArray(e)||0===e.length)throw new E("INVALID_ARGS","batch requires a non-empty batchSteps array.");if(e.length>t)throw new E("INVALID_ARGS",`batch has ${e.length} steps; max allowed is ${t}.`);let r=[];for(let t=0;t<e.length;t+=1){let n=e[t];if(!n||"object"!=typeof n)throw new E("INVALID_ARGS",`Invalid batch step at index ${t}.`);let i=Object.keys(n).filter(e=>!eb.has(e));if(i.length>0){let e=i.map(e=>`"${e}"`).join(", ");throw new E("INVALID_ARGS",`Batch step ${t+1} has unknown field(s): ${e}. Allowed fields: command, positionals, flags, runtime.`)}let o="string"==typeof n.command?n.command.trim().toLowerCase():"";if(!o)throw new E("INVALID_ARGS",`Batch step ${t+1} requires command.`);if(eA.has(o))throw new E("INVALID_ARGS",`Batch step ${t+1} cannot run ${o}.`);if(void 0!==n.positionals&&!Array.isArray(n.positionals))throw new E("INVALID_ARGS",`Batch step ${t+1} positionals must be an array.`);let a=n.positionals??[];if(a.some(e=>"string"!=typeof e))throw new E("INVALID_ARGS",`Batch step ${t+1} positionals must contain only strings.`);if(void 0!==n.flags&&("object"!=typeof n.flags||Array.isArray(n.flags)||!n.flags))throw new E("INVALID_ARGS",`Batch step ${t+1} flags must be an object.`);if(void 0!==n.runtime&&("object"!=typeof n.runtime||Array.isArray(n.runtime)||!n.runtime))throw new E("INVALID_ARGS",`Batch step ${t+1} runtime must be an object.`);r.push({command:o,positionals:a,flags:n.flags??{},runtime:n.runtime})}return r}function eN(e){let t=e.appId??e.bundleId??e.packageName;return{session:e.session,appId:t,appBundleId:e.bundleId,package:e.packageName}}function eD(e,t,r){return{deviceId:t,deviceName:r,..."android"===e?{serial:t}:"ios"===e?{udid:t}:{}}}function ex(e,t={}){let r=t.includeAndroidSerial??!0;return{platform:e.platform,target:e.target,device:e.name,id:e.id,..."ios"===e.platform?{device_udid:e.ios?.udid??e.id,ios_simulator_device_set:e.ios?.simulatorSetPath??null}:{},..."android"===e.platform&&r?{serial:e.android?.serial??e.id}:{}}}function e_(e){return{name:e.name,...ex(e.device,{includeAndroidSerial:!1}),createdAt:e.createdAt}}function eT(e){return{platform:e.platform,id:e.id,name:e.name,kind:e.kind,target:e.target,..."boolean"==typeof e.booted?{booted:e.booted}:{}}}function eL(e){let t=e.created?"Created":"Reused",r=e.booted?" (booted)":"";return X({udid:e.udid,device:e.device,runtime:e.runtime,ios_simulator_device_set:e.iosSimulatorDeviceSet??null,created:e.created,booted:e.booted},`${t}: ${e.device} ${e.udid}${r}`)}function eO(e){return e.bundleId??e.package??e.app}function eM(e){return X({app:e.app,appPath:e.appPath,platform:e.platform,...e.appId?{appId:e.appId}:{},...e.bundleId?{bundleId:e.bundleId}:{},...e.package?{package:e.package}:{}},`Installed: ${eO(e)}`)}function eC(e){return e.appName??e.bundleId??e.packageName??e.launchTarget}function ek(e){return X({launchTarget:e.launchTarget,...e.appName?{appName:e.appName}:{},...e.appId?{appId:e.appId}:{},...e.bundleId?{bundleId:e.bundleId}:{},...e.packageName?{package:e.packageName}:{},...e.installablePath?{installablePath:e.installablePath}:{},...e.archivePath?{archivePath:e.archivePath}:{},...e.materializationId?{materializationId:e.materializationId}:{},...e.materializationExpiresAt?{materializationExpiresAt:e.materializationExpiresAt}:{}},`Installed: ${eC(e)}`)}function eP(e){let t=e.appName??e.appBundleId??e.session;return X({session:e.session,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{},...e.startup?{startup:e.startup}:{},...e.runtime?{runtime:e.runtime}:{},...e.device?ex(e.device):{}},t?`Opened: ${t}`:"Opened")}function eR(e){return{session:e.session,...e.shutdown?{shutdown:e.shutdown}:{},...K(e.session?`Closed: ${e.session}`:"Closed")}}function eF(e){return{nodes:e.nodes,truncated:e.truncated,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{}}}function eB(e,t){try{return l.sync.read(e)}catch(e){throw new E("COMMAND_FAILED",`Failed to decode ${t} as PNG`,{label:t,reason:e instanceof Error?e.message:String(e)})}}export{TextDecoder,styleText}from"node:util";export{default as node_net}from"node:net";export{default as node_http}from"node:http";export{default as node_https}from"node:https";export{E as AppError,ey as DEFAULT_BATCH_MAX_STEPS,l as PNG,P as SESSION_SURFACES,k as SETTINGS_INVALID_ARGS_MESSAGE,C as SETTINGS_USAGE_OVERRIDE,$ as asAppError,eN as buildAppIdentifiers,eD as buildDeviceIdentifiers,G as buildSnapshotDisplayLines,r as createHash,w as createRequestId,eB as decodePng,U as displayLabel,v as emitDiagnostic,i as existsSync,em as expandUserHomePath,d as external_node_url_URL,F as extractReadableText,u as fileURLToPath,W as findProjectRoot,A as flushDiagnosticsToSessionFile,V as formatRole,z as formatSnapshotLine,S as getDiagnosticsMeta,ed as isAgentDeviceDaemonProcess,ea as isProcessAlive,t as node_crypto,n as node_fs,a as node_os,s as node_path,N as normalizeError,ev as normalizeTenantId,eE as parseBatchStepsJson,R as parseSessionSurface,c as pathToFileURL,o as promises,Z as readCommandMessage,el as readProcessCommand,es as readProcessStartTime,J as readVersion,eg as resolveDaemonPaths,ew as resolveDaemonServerMode,eI as resolveDaemonTransportPreference,eO as resolveDeployResultTarget,eC as resolveInstallFromSourceResultTarget,eS as resolveSessionIsolationMode,eh as resolveUserPath,Q as runCmd,en as runCmdBackground,et as runCmdDetached,er as runCmdStreaming,ee as runCmdSync,eR as serializeCloseResult,eM as serializeDeployResult,eT as serializeDevice,eL as serializeEnsureSimulatorResult,ek as serializeInstallFromSourceResult,eP as serializeOpenResult,e_ as serializeSessionListEntry,eF as serializeSnapshotResult,p as spawn,ep as stopProcessForTakeover,K as successText,e$ as validateAndNormalizeBatchSteps,Y as whichCmd,y as withDiagnosticTimer,I as withDiagnosticsScope,X as withSuccessText};