agent-device 0.20.4 → 0.20.6

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agent-device",
-  "version": "0.20.4",
+  "version": "0.20.6",
   "description": "Agent-native CLI for AI app automation across iOS, Android, tvOS, Android TV, macOS, Linux, and web.",
-  "mcpName": "io.github.callstackincubator/agent-device",
+  "mcpName": "io.github.callstack/agent-device",
   "license": "MIT",
   "author": "Callstack",
   "homepage": "https://agent-device.dev/",
@@ -19,52 +19,52 @@
   "types": "dist/src/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
     },
     "./io": {
-      "import": "./dist/src/io.js",
-      "types": "./dist/src/io.d.ts"
+      "types": "./dist/src/io.d.ts",
+      "import": "./dist/src/io.js"
     },
     "./artifacts": {
-      "import": "./dist/src/artifacts.js",
-      "types": "./dist/src/artifacts.d.ts"
+      "types": "./dist/src/artifacts.d.ts",
+      "import": "./dist/src/artifacts.js"
     },
     "./metro": {
-      "import": "./dist/src/metro.js",
-      "types": "./dist/src/metro.d.ts"
+      "types": "./dist/src/metro.d.ts",
+      "import": "./dist/src/metro.js"
     },
     "./batch": {
-      "import": "./dist/src/batch.js",
-      "types": "./dist/src/batch.d.ts"
+      "types": "./dist/src/batch.d.ts",
+      "import": "./dist/src/batch.js"
     },
     "./remote-config": {
-      "import": "./dist/src/remote-config.js",
-      "types": "./dist/src/remote-config.d.ts"
+      "types": "./dist/src/remote-config.d.ts",
+      "import": "./dist/src/remote-config.js"
     },
     "./install-source": {
-      "import": "./dist/src/install-source.js",
-      "types": "./dist/src/install-source.d.ts"
+      "types": "./dist/src/install-source.d.ts",
+      "import": "./dist/src/install-source.js"
     },
     "./android-adb": {
-      "import": "./dist/src/android-adb.js",
-      "types": "./dist/src/android-adb.d.ts"
+      "types": "./dist/src/android-adb.d.ts",
+      "import": "./dist/src/android-adb.js"
     },
     "./limrun": {
-      "import": "./dist/src/limrun.js",
-      "types": "./dist/src/limrun.d.ts"
+      "types": "./dist/src/limrun.d.ts",
+      "import": "./dist/src/limrun.js"
     },
     "./contracts": {
-      "import": "./dist/src/contracts.js",
-      "types": "./dist/src/contracts.d.ts"
+      "types": "./dist/src/contracts.d.ts",
+      "import": "./dist/src/contracts.js"
     },
     "./selectors": {
-      "import": "./dist/src/selectors.js",
-      "types": "./dist/src/selectors.d.ts"
+      "types": "./dist/src/selectors.d.ts",
+      "import": "./dist/src/selectors.js"
     },
     "./finders": {
-      "import": "./dist/src/finders.js",
-      "types": "./dist/src/finders.d.ts"
+      "types": "./dist/src/finders.d.ts",
+      "import": "./dist/src/finders.js"
     }
   },
   "engines": {
@@ -103,14 +103,15 @@
     "package:android-ime-helper:npm": "rm -rf android/ime-helper/dist && AGENT_DEVICE_ANDROID_HELPER=ime sh ./scripts/package-android-helper.sh $(node -p \"require('./package.json').version\") android/ime-helper/dist",
     "build:macos-helper": "swift build -c release --package-path apple/macos-helper",
     "build:macos-helper:clean": "swift package --package-path apple/macos-helper clean && pnpm build:macos-helper",
-    "package:npm": "pnpm build && pnpm build:xcuitest:ios && pnpm build:xcuitest:macos && pnpm build:xcuitest:tvos && pnpm build:xcuitest:visionos && pnpm build:macos-helper:clean && pnpm package:apple-runner:npm && pnpm build:android",
+    "build:package": "pnpm build && pnpm build:xcuitest:ios && pnpm build:xcuitest:macos && pnpm build:xcuitest:tvos && pnpm build:xcuitest:visionos && pnpm build:macos-helper:clean && pnpm package:apple-runner:npm && pnpm build:android",
+    "package:npm": "pnpm build:package && pnpm check:package",
+    "release:prepare": "rm -rf .tmp/release && pnpm check:mcp-metadata && pnpm build:package && pnpm check:package -- --pack-destination .tmp/release",
+    "release:publish": "pnpm release:prepare && npm publish --ignore-scripts .tmp/release/*.tgz",
     "ad": "node bin/agent-device.mjs",
     "bench:help-conformance": "node scripts/help-conformance-bench.mjs",
     "maestro:conformance": "node --experimental-strip-types --test packages/maestro/test/conformance/verify.test.ts packages/maestro/test/conformance/differential/run.test.ts packages/maestro/test/conformance/differential/invariants.test.ts",
     "maestro:conformance:regenerate": "node --experimental-strip-types scripts/maestro-conformance/regenerate.mjs",
     "maestro:conformance:differential": "node --experimental-strip-types packages/maestro/test/conformance/differential/run.ts",
-    "prototype:program-boundary": "node --experimental-strip-types scripts/prototypes/daemon-boundaries/program-boundary.ts",
-    "prototype:session-boundary": "node --experimental-strip-types scripts/prototypes/daemon-boundaries/session-boundary.ts",
     "size": "node scripts/size-report.mjs",
     "perf": "node --experimental-strip-types scripts/perf/run.ts",
     "mutation:run": "node --experimental-strip-types scripts/mutation/run.ts",
@@ -129,23 +130,26 @@
     "check:affected:test": "node --experimental-strip-types --test scripts/check-affected/model.test.ts scripts/check-affected/run.test.ts",
     "check:coverage-changed": "node --experimental-strip-types scripts/coverage-changed/run.ts",
     "check:coverage-changed:test": "node --experimental-strip-types --test scripts/coverage-changed/model.test.ts scripts/coverage-changed/run.test.ts",
-    "check:layering": "node --experimental-strip-types --test scripts/layering/model.test.ts scripts/layering/zone-policy.test.ts scripts/layering/daemon-modularity.test.ts scripts/layering/package-boundaries.test.ts && node --experimental-strip-types scripts/layering/check.ts",
+    "check:layering": "node --experimental-strip-types --test scripts/layering/model.test.ts scripts/layering/zone-policy.test.ts scripts/layering/daemon-modularity.test.ts scripts/layering/package-boundaries.test.ts scripts/layering/facade-exports.test.ts scripts/layering/bin-alias-fast-path.test.ts && node --experimental-strip-types scripts/layering/check.ts",
     "depgraph": "node --experimental-strip-types scripts/depgraph/build.ts",
     "depgraph:test": "node --experimental-strip-types --test scripts/depgraph/model.test.ts scripts/depgraph/affected.test.ts",
     "check:production-exports": "fallow dead-code --config fallow-production-exports.json --production --unused-exports --fail-on-issues",
     "check:bundle-owner-files": "node --experimental-strip-types scripts/check-bundle-owner-files.ts",
+    "check:package": "node --experimental-strip-types scripts/check-package.ts",
     "check:command-docs": "vitest run --project unit-core src/__tests__/command-doc-coverage.test.ts",
     "check:replay-compat": "node --experimental-strip-types scripts/check-replay-compat-provenance.ts",
+    "check:tmpdir-leaks": "node --experimental-strip-types scripts/check-tmpdir-leaks.ts",
+    "check:tmpdir-leaks:test": "node --experimental-strip-types --test scripts/check-tmpdir-leaks-model.test.ts scripts/vitest-tmpdir-global-setup.test.ts",
     "check:freerange": "fr",
     "check:quick": "pnpm lint && pnpm typecheck",
     "sync:mcp-metadata": "node scripts/sync-mcp-metadata.mjs",
     "check:mcp-metadata": "node scripts/sync-mcp-metadata.mjs --check",
     "version": "pnpm sync:mcp-metadata && git add server.json",
-    "check:tooling": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm check:layering && pnpm depgraph:test && pnpm check:production-exports && pnpm check:mcp-metadata && pnpm build && pnpm check:bundle-owner-files",
-    "check:unit": "pnpm check:contention-retry && pnpm test:unit && pnpm test:smoke",
+    "check:tooling": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm check:layering && pnpm depgraph:test && pnpm check:production-exports && pnpm check:tmpdir-leaks:test && pnpm check:mcp-metadata && pnpm build && pnpm check:bundle-owner-files && pnpm check:package",
+    "check:unit": "pnpm check:contention-retry && pnpm test:unit && pnpm check:tmpdir-leaks && pnpm test:smoke",
     "check": "pnpm check:tooling && pnpm check:fallow && pnpm check:unit",
     "prepack": "pnpm check:mcp-metadata && pnpm package:npm",
-    "typecheck": "tsc -b packages/xml packages/kernel packages/contracts packages/ad-script packages/maestro packages/replay-test packages/provider-webdriver packages/provider-limrun && tsc -p tsconfig.json && tsc -p examples/sdk/tsconfig.json",
+    "typecheck": "tsc -b packages/xml packages/kernel packages/contracts packages/ad-script packages/selectors packages/ad-replay packages/maestro packages/replay-test packages/provider-webdriver packages/provider-limrun && tsc -p tsconfig.json && tsc -p examples/sdk/tsconfig.json",
     "test-app:install": "pnpm install --dir examples/test-app",
     "test-app:start": "pnpm --dir examples/test-app start",
     "test-app:ios": "pnpm --dir examples/test-app ios",
@@ -241,18 +245,20 @@
   ],
   "dependencies": {
     "@limrun/api": "^0.24.5",
-    "pngjs": "^7.0.0",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
+    "@agent-device/ad-replay": "workspace:*",
     "@agent-device/ad-script": "workspace:*",
     "@agent-device/contracts": "workspace:*",
     "@agent-device/kernel": "workspace:*",
+    "@agent-device/selectors": "workspace:*",
     "@agent-device/maestro": "workspace:*",
     "@agent-device/provider-limrun": "workspace:*",
     "@agent-device/provider-webdriver": "workspace:*",
     "@agent-device/replay-test": "workspace:*",
     "@agent-device/xml": "workspace:*",
+    "@arethetypeswrong/cli": "^0.18.5",
     "@chenglou/freerange": "^0.0.1",
     "@stryker-mutator/core": "9.6.1",
     "@stryker-mutator/vitest-runner": "9.6.1",
@@ -264,6 +270,8 @@
     "oxc-parser": "^0.138.0",
     "oxfmt": "^0.42.0",
     "oxlint": "^1.69.0",
+    "pngjs": "^7.0.0",
+    "publint": "^0.3.22",
     "tsdown": "^0.22.4",
     "typescript": "^7.0.2",
     "vite": "^8.0.16",

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.callstackincubator/agent-device",
+  "name": "io.github.callstack/agent-device",
   "title": "agent-device",
   "description": "Let AI agents inspect, control, and debug real iOS, Android, desktop, and TV apps",
   "repository": {
     "url": "https://github.com/callstack/agent-device",
     "source": "github"
   },
-  "version": "0.20.4",
+  "version": "0.20.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "agent-device",
-      "version": "0.20.4",
+      "version": "0.20.6",
       "transport": {
         "type": "stdio"
       }

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

@@ -1 +0,0 @@
-019ebbda52976df5cff05f9e5a764c8d6e280be3640e8dea0a2d7cca6c25021f  agent-device-android-ime-helper-0.20.4.apk

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

@@ -1 +0,0 @@
-e3799afe5549776e047744efe46939a9146a4742a5328bb2e22f0b9d6abd2b52  agent-device-android-snapshot-helper-0.20.4.apk

package/dist/apple/runner/AgentDeviceRunner/RecordingScripts/recording-resize.swift

@@ -1,225 +0,0 @@
-import AVFoundation
-import Foundation
-
-enum ResizeError: Error, CustomStringConvertible {
-  case invalidArgs(String)
-  case missingVideoTrack
-  case exportFailed(String)
-
-  var description: String {
-    switch self {
-    case .invalidArgs(let message):
-      return message
-    case .missingVideoTrack:
-      return "Input video does not contain a video track."
-    case .exportFailed(let message):
-      return message
-    }
-  }
-}
-
-do {
-  try run()
-} catch {
-  fputs("recording-resize: \(error)\n", stderr)
-  exit(1)
-}
-
-func run() throws {
-  let arguments = Array(CommandLine.arguments.dropFirst())
-  let parsedArgs = try parseArguments(arguments)
-  let inputURL = URL(fileURLWithPath: parsedArgs.inputPath)
-  let outputURL = URL(fileURLWithPath: parsedArgs.outputPath)
-
-  if FileManager.default.fileExists(atPath: outputURL.path) {
-    try FileManager.default.removeItem(at: outputURL)
-  }
-
-  let asset = AVURLAsset(url: inputURL)
-  guard let sourceVideoTrack = asset.tracks(withMediaType: .video).first else {
-    throw ResizeError.missingVideoTrack
-  }
-
-  let sourceRenderSize = resolvedRenderSize(for: sourceVideoTrack)
-  if max(sourceRenderSize.width, sourceRenderSize.height) <= CGFloat(parsedArgs.maxSize) {
-    try FileManager.default.copyItem(at: inputURL, to: outputURL)
-    return
-  }
-
-  let renderSize = scaledRenderSize(sourceRenderSize, maxSize: parsedArgs.maxSize)
-  let composition = AVMutableComposition()
-  let fullRange = CMTimeRange(start: .zero, duration: asset.duration)
-
-  guard let compositionVideoTrack = composition.addMutableTrack(
-    withMediaType: .video,
-    preferredTrackID: kCMPersistentTrackID_Invalid
-  ) else {
-    throw ResizeError.exportFailed("Failed to create composition video track.")
-  }
-  try compositionVideoTrack.insertTimeRange(fullRange, of: sourceVideoTrack, at: .zero)
-
-  if let sourceAudioTrack = asset.tracks(withMediaType: .audio).first,
-     let compositionAudioTrack = composition.addMutableTrack(
-       withMediaType: .audio,
-       preferredTrackID: kCMPersistentTrackID_Invalid
-     ) {
-    try? compositionAudioTrack.insertTimeRange(fullRange, of: sourceAudioTrack, at: .zero)
-  }
-
-  let scale = renderSize.width / sourceRenderSize.width
-  let videoComposition = AVMutableVideoComposition()
-  videoComposition.renderSize = renderSize
-  videoComposition.frameDuration = resolvedFrameDuration(for: sourceVideoTrack)
-
-  let instruction = AVMutableVideoCompositionInstruction()
-  instruction.timeRange = fullRange
-  let layerInstruction = AVMutableVideoCompositionLayerInstruction(assetTrack: compositionVideoTrack)
-  // Scale the full preferred transform (including translation) to match the smaller render canvas.
-  let scaledTransform = scaledPreferredTransform(sourceVideoTrack.preferredTransform, scale: scale)
-  layerInstruction.setTransform(scaledTransform, at: .zero)
-  instruction.layerInstructions = [layerInstruction]
-  videoComposition.instructions = [instruction]
-
-  let presetName = exportPresetName(for: parsedArgs.exportQuality, compatibleWith: composition)
-  guard let exporter = AVAssetExportSession(asset: composition, presetName: presetName) else {
-    throw ResizeError.exportFailed("Failed to create export session.")
-  }
-
-  exporter.outputURL = outputURL
-  exporter.outputFileType = .mp4
-  exporter.videoComposition = videoComposition
-  exporter.shouldOptimizeForNetworkUse = true
-
-  let semaphore = DispatchSemaphore(value: 0)
-  exporter.exportAsynchronously {
-    semaphore.signal()
-  }
-  if semaphore.wait(timeout: .now() + 120) == .timedOut {
-    exporter.cancelExport()
-    throw ResizeError.exportFailed("Resize export timed out.")
-  }
-
-  if exporter.status != .completed {
-    throw ResizeError.exportFailed(exporter.error?.localizedDescription ?? "Resize export failed.")
-  }
-}
-
-enum ExportQuality: String {
-  case medium
-  case high
-}
-
-func parseArguments(
-  _ arguments: [String]
-) throws -> (inputPath: String, outputPath: String, maxSize: Int, exportQuality: ExportQuality) {
-  var inputPath: String?
-  var outputPath: String?
-  var maxSize: Int?
-  // Export quality defaults to medium so re-encoded recordings stay fast by default.
-  // Pass --quality high to opt into a slower highest-quality export.
-  var exportQuality: ExportQuality = .medium
-  var index = 0
-
-  while index < arguments.count {
-    let argument = arguments[index]
-    let nextIndex = index + 1
-    switch argument {
-    case "--input":
-      guard nextIndex < arguments.count else { throw ResizeError.invalidArgs("--input requires a value") }
-      inputPath = arguments[nextIndex]
-      index += 2
-    case "--output":
-      guard nextIndex < arguments.count else { throw ResizeError.invalidArgs("--output requires a value") }
-      outputPath = arguments[nextIndex]
-      index += 2
-    case "--max-size":
-      guard nextIndex < arguments.count else { throw ResizeError.invalidArgs("--max-size requires a value") }
-      guard let parsed = Int(arguments[nextIndex]), parsed >= 1 else {
-        throw ResizeError.invalidArgs("--max-size must be a positive integer")
-      }
-      maxSize = parsed
-      index += 2
-    case "--quality":
-      guard nextIndex < arguments.count else {
-        throw ResizeError.invalidArgs("--quality requires a value")
-      }
-      guard let parsed = ExportQuality(rawValue: arguments[nextIndex]) else {
-        throw ResizeError.invalidArgs("--quality must be one of: medium, high")
-      }
-      exportQuality = parsed
-      index += 2
-    default:
-      throw ResizeError.invalidArgs("Unknown argument: \(argument)")
-    }
-  }
-
-  guard let inputPath, let outputPath, let maxSize else {
-    throw ResizeError.invalidArgs(
-      "Usage: recording-resize.swift --input <video> --output <video> --max-size <px> [--quality <medium|high>]"
-    )
-  }
-  return (inputPath, outputPath, maxSize, exportQuality)
-}
-
-func exportPresetName(
-  for exportQuality: ExportQuality,
-  compatibleWith asset: AVAsset
-) -> String {
-  switch exportQuality {
-  case .high:
-    return AVAssetExportPresetHighestQuality
-  case .medium:
-    // Mirror the touch-overlay export: prefer the faster medium preset, falling back to
-    // highest quality only when medium is not available for this composition.
-    let compatible = AVAssetExportSession.exportPresets(compatibleWith: asset)
-    return compatible.contains(AVAssetExportPresetMediumQuality)
-      ? AVAssetExportPresetMediumQuality
-      : AVAssetExportPresetHighestQuality
-  }
-}
-
-func resolvedRenderSize(for track: AVAssetTrack) -> CGSize {
-  let transformed = track.naturalSize.applying(track.preferredTransform)
-  return CGSize(width: abs(transformed.width), height: abs(transformed.height))
-}
-
-func scaledRenderSize(_ renderSize: CGSize, maxSize: Int) -> CGSize {
-  let longest = max(renderSize.width, renderSize.height)
-  guard longest > CGFloat(maxSize) else { return renderSize }
-  let scale = CGFloat(maxSize) / longest
-  return CGSize(
-    width: scaledDimension(renderSize.width, scale: scale),
-    height: scaledDimension(renderSize.height, scale: scale)
-  )
-}
-
-func scaledDimension(_ value: CGFloat, scale: CGFloat) -> CGFloat {
-  let evenValue = Int((Double(value * scale) / 2.0).rounded()) * 2
-  return CGFloat(max(2, evenValue))
-}
-
-func resolvedFrameDuration(for track: AVAssetTrack) -> CMTime {
-  let minFrameDuration = track.minFrameDuration
-  if minFrameDuration.isValid && !minFrameDuration.isIndefinite && minFrameDuration.seconds > 0 {
-    return minFrameDuration
-  }
-
-  let nominalFrameRate = track.nominalFrameRate
-  if nominalFrameRate > 0 {
-    let timescale = Int32(max(1, round(nominalFrameRate)))
-    return CMTime(value: 1, timescale: timescale)
-  }
-
-  return CMTime(value: 1, timescale: 60)
-}
-
-func scaledPreferredTransform(_ transform: CGAffineTransform, scale: CGFloat) -> CGAffineTransform {
-  CGAffineTransform(
-    a: transform.a * scale,
-    b: transform.b * scale,
-    c: transform.c * scale,
-    d: transform.d * scale,
-    tx: transform.tx * scale,
-    ty: transform.ty * scale
-  )
-}