agent-device 0.21.30 → 0.21.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (304) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.apk → agent-device-android-ime-helper-0.21.31.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.31.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.manifest.json → agent-device-android-ime-helper-0.21.31.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.30.manifest.json → agent-device-android-snapshot-helper-0.21.31.manifest.json} +7 -7
  7. package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/BackgroundInteraction.swift +20 -6
  8. package/apple/snapshot-bridge/README.md +16 -3
  9. package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +33 -1
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner/AgentDeviceRunnerApp.m +110 -8
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAppScreenCapture.swift +20 -0
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +4 -4
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +1 -1
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +30 -4
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +14 -4
  16. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +81 -41
  17. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift +40 -6
  18. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotAcquisition.swift +5 -0
  19. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift +74 -10
  20. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotTiming.swift +33 -4
  21. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedCommitDeadline.swift +2 -2
  22. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +23 -2
  23. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +158 -6
  24. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift +165 -70
  25. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryConfirmation.swift +2 -3
  26. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryFocus.swift +49 -27
  27. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryReadiness.swift +17 -9
  28. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextInputProbe.swift +30 -28
  29. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextTyping.swift +87 -87
  30. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +4 -3
  31. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +13 -0
  32. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +45 -0
  33. package/dist/src/absence-observation-errors.js +1 -1
  34. package/dist/src/adapter.js +1 -1
  35. package/dist/src/adb-executor.js +1 -1
  36. package/dist/src/adb-failure.js +2 -2
  37. package/dist/src/agent-browser-lifecycle.js +1 -1
  38. package/dist/src/agent-browser-process-record.js +1 -1
  39. package/dist/src/agent-browser-provider.js +1 -1
  40. package/dist/src/agent-browser-tool.js +1 -1
  41. package/dist/src/agent-device-client.js +1 -1
  42. package/dist/src/alert-tree-driver.js +1 -1
  43. package/dist/src/alert.js +1 -1
  44. package/dist/src/alert2.js +1 -1
  45. package/dist/src/android.js +1 -1
  46. package/dist/src/app-backend.js +1 -1
  47. package/dist/src/app-launch.js +1 -1
  48. package/dist/src/app-lifecycle.js +4 -4
  49. package/dist/src/app-log-runtime2.js +3 -3
  50. package/dist/src/app-log-session-resource.js +1 -1
  51. package/dist/src/app-resolution-facade.js +1 -1
  52. package/dist/src/app-resolution.js +2 -2
  53. package/dist/src/apple-runner-platform.js +1 -1
  54. package/dist/src/application-lifecycle-interaction.js +1 -1
  55. package/dist/src/artifact-tracking.js +1 -1
  56. package/dist/src/automation-helper-artifact.js +1 -1
  57. package/dist/src/automation-helper.js +1 -1
  58. package/dist/src/back-mode.js +1 -1
  59. package/dist/src/boot-diagnostics.js +1 -1
  60. package/dist/src/browser-launch.js +1 -1
  61. package/dist/src/cli-config.js +1 -1
  62. package/dist/src/cli-help.js +35 -29
  63. package/dist/src/cli-runner.js +1 -1
  64. package/dist/src/cli.js +3 -3
  65. package/dist/src/client-metro-companion.js +1 -1
  66. package/dist/src/client-metro.js +1 -1
  67. package/dist/src/client-types.d.ts +3 -3
  68. package/dist/src/cloud-artifacts.d.ts +5 -4
  69. package/dist/src/code-signature-cache.js +1 -1
  70. package/dist/src/command-metadata.js +10 -10
  71. package/dist/src/command-tools.js +2 -2
  72. package/dist/src/command.js +1 -1
  73. package/dist/src/composed-inventory-gateways.js +1 -1
  74. package/dist/src/connection-runtime.js +1 -1
  75. package/dist/src/connection.js +5 -5
  76. package/dist/src/contracts.js +1 -1
  77. package/dist/src/daemon-client-ensure.js +1 -1
  78. package/dist/src/daemon-client-lease-beat.js +1 -1
  79. package/dist/src/daemon-client-lifecycle.js +1 -1
  80. package/dist/src/daemon-client-liveness-probe.js +1 -1
  81. package/dist/src/daemon-client.js +1 -1
  82. package/dist/src/daemon-command-registry.js +1 -1
  83. package/dist/src/daemon-composition.js +1 -1
  84. package/dist/src/daemon-policy-file.js +1 -1
  85. package/dist/src/daemon-registration-owner.js +3 -3
  86. package/dist/src/daemon-resolution.js +1 -1
  87. package/dist/src/daemon-startup-diagnostics.js +1 -1
  88. package/dist/src/debug-symbols-facade.js +3 -3
  89. package/dist/src/device-claim-recovery.js +1 -1
  90. package/dist/src/device-claims.js +1 -1
  91. package/dist/src/device-inventory-context.js +1 -1
  92. package/dist/src/device-readiness-runtime.js +1 -1
  93. package/dist/src/device-selection-resolver.js +1 -1
  94. package/dist/src/device.js +1 -1
  95. package/dist/src/devicectl.js +1 -1
  96. package/dist/src/diagnostics.js +1 -1
  97. package/dist/src/display-inventory.js +1 -1
  98. package/dist/src/doctor-facade.js +1 -1
  99. package/dist/src/durable-capture-resource.js +1 -1
  100. package/dist/src/durable-resource.js +1 -1
  101. package/dist/src/engine-eval-script.js +1 -1
  102. package/dist/src/error.js +1 -1
  103. package/dist/src/explicit-session-resolution.js +1 -1
  104. package/dist/src/expo-dev-client-launch.js +1 -1
  105. package/dist/src/file.js +1 -1
  106. package/dist/src/find.js +1 -1
  107. package/dist/src/finders.js +1 -1
  108. package/dist/src/gesture-admission.js +1 -1
  109. package/dist/src/gesture-plan.js +1 -1
  110. package/dist/src/gesture-runtime.js +1 -1
  111. package/dist/src/hdc.js +1 -1
  112. package/dist/src/helper.js +2 -2
  113. package/dist/src/host.js +1 -1
  114. package/dist/src/host2.js +1 -1
  115. package/dist/src/host3.js +1 -1
  116. package/dist/src/host4.js +1 -1
  117. package/dist/src/host5.js +1 -0
  118. package/dist/src/human-control.js +1 -1
  119. package/dist/src/ime-rebind.js +1 -1
  120. package/dist/src/ime-state.js +1 -1
  121. package/dist/src/index.js +1 -1
  122. package/dist/src/input-actions.js +1 -1
  123. package/dist/src/input-actions2.js +1 -1
  124. package/dist/src/install-source-network-transport.js +1 -1
  125. package/dist/src/install-source2.js +1 -1
  126. package/dist/src/interaction-positionals.js +1 -1
  127. package/dist/src/interaction.js +1 -1
  128. package/dist/src/interaction2.js +1 -1
  129. package/dist/src/interactor-operation-catalog.js +1 -1
  130. package/dist/src/interactor.js +5 -5
  131. package/dist/src/interactor2.js +1 -1
  132. package/dist/src/interactor3.js +1 -1
  133. package/dist/src/interactor4.js +1 -1
  134. package/dist/src/interactor5.js +1 -1
  135. package/dist/src/interactors.js +1 -1
  136. package/dist/src/internal/bin.js +1 -1
  137. package/dist/src/internal/daemon.js +1 -1
  138. package/dist/src/internal/png-worker.js +1 -1
  139. package/dist/src/inventory.js +1 -1
  140. package/dist/src/inventory2.js +1 -1
  141. package/dist/src/inventory6.js +1 -1
  142. package/dist/src/ios-node-interpretation.js +1 -1
  143. package/dist/src/ios-settings.js +1 -1
  144. package/dist/src/ios-snapshot-acquisition.js +1 -1
  145. package/dist/src/ios-snapshot-engine.js +1 -1
  146. package/dist/src/ios-snapshot-runtime.js +1 -1
  147. package/dist/src/keyboard-occlusion.js +1 -1
  148. package/dist/src/keyed-lock.js +1 -1
  149. package/dist/src/launch-confirmation.js +1 -1
  150. package/dist/src/launch-services-registration.js +4 -4
  151. package/dist/src/lease.js +1 -1
  152. package/dist/src/legacy.js +1 -1
  153. package/dist/src/limrun-runtime-dependencies.js +1 -1
  154. package/dist/src/local-interactor-operation-set.js +1 -1
  155. package/dist/src/mechanics.js +12 -12
  156. package/dist/src/mobile-snapshot-semantics.js +1 -1
  157. package/dist/src/observability.js +1 -1
  158. package/dist/src/output-path.js +1 -1
  159. package/dist/src/parameterized-recorded-fill.js +1 -1
  160. package/dist/src/perf-facade.js +1 -1
  161. package/dist/src/perf-runtime-operation-builder.js +1 -1
  162. package/dist/src/perf-target.js +1 -1
  163. package/dist/src/physical-device-control.js +1 -1
  164. package/dist/src/platform-runtime-android-adb-host.js +1 -1
  165. package/dist/src/platform-runtime-claim-recovery.js +1 -1
  166. package/dist/src/platform-runtime-daemon-services.js +1 -1
  167. package/dist/src/platform-runtime-host.js +1 -1
  168. package/dist/src/platform-runtime-open-target.js +1 -1
  169. package/dist/src/platform-runtime-operation-host.js +5 -5
  170. package/dist/src/platform-runtime-runtime-hints.js +2 -2
  171. package/dist/src/platform-runtime-screen-recording-apple-simulator-host.js +1 -1
  172. package/dist/src/platform-runtime-screen-recording-finalizer-host.js +1 -1
  173. package/dist/src/platform-runtime-unavailable.js +1 -1
  174. package/dist/src/platform-runtime.js +1 -1
  175. package/dist/src/platform-runtime2.js +1 -1
  176. package/dist/src/png-resize.js +1 -1
  177. package/dist/src/png-worker-client.js +1 -1
  178. package/dist/src/process-exit.js +1 -1
  179. package/dist/src/provider-device-runtime.d.ts +28 -0
  180. package/dist/src/provider-plugin-catalog.js +2 -0
  181. package/dist/src/provider-plugin.d.ts +1 -1
  182. package/dist/src/provider-webdriver.js +1 -1
  183. package/dist/src/proxy.js +1 -1
  184. package/dist/src/react-native-overlay2.js +1 -1
  185. package/dist/src/react-native.js +1 -1
  186. package/dist/src/react-profile-command.js +1 -1
  187. package/dist/src/record-runtime.js +1 -1
  188. package/dist/src/record-trace.js +1 -1
  189. package/dist/src/recording-scope.js +1 -1
  190. package/dist/src/recording.js +1 -1
  191. package/dist/src/registry.js +1 -1
  192. package/dist/src/remote-config-core.js +1 -1
  193. package/dist/src/replay-backend-host.js +1 -1
  194. package/dist/src/replay-divergence.js +1 -1
  195. package/dist/src/replay-maestro-backend.js +3 -3
  196. package/dist/src/replay-script-selection.js +1 -1
  197. package/dist/src/replay2.js +1 -1
  198. package/dist/src/request-runtime-binding.js +1 -1
  199. package/dist/src/request.js +1 -1
  200. package/dist/src/result-serialization.js +1 -1
  201. package/dist/src/retry.js +1 -1
  202. package/dist/src/runner-cache-retention.js +1 -1
  203. package/dist/src/runner-client.js +1 -1
  204. package/dist/src/runner-dev-tools-security.js +1 -1
  205. package/dist/src/runner-device-readiness.js +1 -1
  206. package/dist/src/runner-device-set.js +1 -1
  207. package/dist/src/runner-error-classification.js +2 -2
  208. package/dist/src/runner-exchange.js +1 -1
  209. package/dist/src/runner-lease.js +1 -1
  210. package/dist/src/runner-operations-facade.js +1 -1
  211. package/dist/src/runner-retention.js +1 -1
  212. package/dist/src/runner-selector-query.js +1 -1
  213. package/dist/src/runner-start-budget.js +1 -1
  214. package/dist/src/runner-startup-transport.js +1 -1
  215. package/dist/src/runner-toolchain-probe.js +1 -1
  216. package/dist/src/runner.js +2 -2
  217. package/dist/src/runtime-admission.js +1 -1
  218. package/dist/src/runtime-deployment.js +1 -1
  219. package/dist/src/runtime-factory.js +1 -1
  220. package/dist/src/runtime-session.js +1 -1
  221. package/dist/src/runtime.js +4 -4
  222. package/dist/src/runtime10.js +2 -2
  223. package/dist/src/runtime2.js +1 -1
  224. package/dist/src/runtime3.js +5 -5
  225. package/dist/src/runtime4.js +1 -1
  226. package/dist/src/runtime5.js +1 -1
  227. package/dist/src/runtime6.js +1 -1
  228. package/dist/src/runtime7.js +1 -1
  229. package/dist/src/runtime8.js +1 -1
  230. package/dist/src/runtime9.js +2 -2
  231. package/dist/src/screen-recording-transport.js +1 -1
  232. package/dist/src/screenshot-density.js +1 -1
  233. package/dist/src/screenshot-runtime.js +1 -1
  234. package/dist/src/screenshot3.js +1 -1
  235. package/dist/src/sdk-batch-runner.js +2 -2
  236. package/dist/src/sdk-batch.js +2 -2
  237. package/dist/src/sdk-contracts.d.ts +9 -0
  238. package/dist/src/sdk-contracts.js +2 -2
  239. package/dist/src/sdk-device.js +1 -1
  240. package/dist/src/sdk-finders.js +1 -1
  241. package/dist/src/sdk-io.js +5 -5
  242. package/dist/src/sdk-remote-config.js +1 -1
  243. package/dist/src/sdk-selectors.js +1 -1
  244. package/dist/src/selection.js +0 -0
  245. package/dist/src/selector-pipeline-policy.js +1 -1
  246. package/dist/src/selector-runtime.js +1 -1
  247. package/dist/src/selectors.js +1 -1
  248. package/dist/src/server-startup.js +1 -1
  249. package/dist/src/session-paths.js +1 -1
  250. package/dist/src/session-replay-vars.js +1 -1
  251. package/dist/src/session-runtime.js +1 -1
  252. package/dist/src/session-store.js +3 -3
  253. package/dist/src/session.js +1 -1
  254. package/dist/src/session2.js +5 -5
  255. package/dist/src/settings-bluetooth.js +1 -1
  256. package/dist/src/settings.js +1 -1
  257. package/dist/src/settings2.js +1 -1
  258. package/dist/src/settle-observation-capture.js +1 -1
  259. package/dist/src/simctl-settings.js +1 -1
  260. package/dist/src/simctl.js +1 -1
  261. package/dist/src/simulator-boot.js +1 -1
  262. package/dist/src/simulator-state.js +1 -1
  263. package/dist/src/simulator.js +1 -1
  264. package/dist/src/snapshot-chrome.js +1 -1
  265. package/dist/src/snapshot-desktop-projection.js +1 -1
  266. package/dist/src/snapshot-helper-install.js +6 -6
  267. package/dist/src/snapshot-node-lookup.js +1 -1
  268. package/dist/src/snapshot-occlusion.js +1 -1
  269. package/dist/src/snapshot-runtime-binding.js +1 -1
  270. package/dist/src/snapshot-runtime-capture-input.js +1 -1
  271. package/dist/src/snapshot-runtime.js +1 -1
  272. package/dist/src/snapshot-state.js +1 -1
  273. package/dist/src/snapshot.js +1 -1
  274. package/dist/src/snapshot3.js +1 -1
  275. package/dist/src/src.js +1 -1
  276. package/dist/src/src3.js +1 -1
  277. package/dist/src/src4.js +1 -1
  278. package/dist/src/store.js +1 -1
  279. package/dist/src/tap-keyboard-occlusion.js +1 -1
  280. package/dist/src/target-evidence-tree.js +1 -1
  281. package/dist/src/target-evidence.js +1 -1
  282. package/dist/src/telephony-runtime.js +1 -1
  283. package/dist/src/text-entry-focus.js +1 -1
  284. package/dist/src/tool-provider.js +3 -3
  285. package/dist/src/tool-provider2.js +1 -1
  286. package/dist/src/tool-provider3.js +1 -1
  287. package/dist/src/toolchain-probe.js +1 -1
  288. package/dist/src/touch-reference-frame.js +1 -1
  289. package/dist/src/touch-runtime.js +1 -1
  290. package/dist/src/touch-runtime2.js +1 -1
  291. package/dist/src/tree.js +1 -1
  292. package/dist/src/tv-remote-runtime.js +1 -1
  293. package/dist/src/tv-remote.js +2 -2
  294. package/dist/src/type-text-runtime.js +1 -1
  295. package/dist/src/update-check.js +1 -1
  296. package/dist/src/vega-executable.js +1 -1
  297. package/dist/src/video.js +1 -1
  298. package/dist/src/webdriver-source.js +1 -1
  299. package/package.json +7 -6
  300. package/server.json +2 -2
  301. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.30.apk.sha256 +0 -1
  302. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk +0 -0
  303. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk.sha256 +0 -1
  304. package/dist/src/physical-device-apps.js +0 -1
@@ -1,5 +1,5 @@
1
- import{r as e}from"./rolldown-runtime.js";import{O as t,x as n}from"./back-mode.js";import{wr as r}from"./sdk-batch.js";import{O as i,V as a,f as o,k as s}from"./command-metadata.js";import{a as c}from"./version.js";import{n as l,r as u}from"./command-schema.js";import{n as d}from"./cli-command-aliases.js";const f=[`Flows: launchApp (with clearState, permissions, and Apple-only launch arguments; permissions apply after state clearing but before launch, and a launchApp without permissions touches nothing — there is no silent all: allow default); setPermissions (mid-flow permission grants, denials, and resets; all resolves in the backend — one simctl call on iOS, the declared permissions on Android — with specific entries overriding after it); runFlow file/inline; runFlow.when and repeat.while conditions (platform, visible, notVisible, and true, all re-evaluated before every repeat iteration); onFlowStart/onFlowComplete; repeat with times, while, or both; and retry.`,`Interactions: tapOn, doubleTapOn, longPressOn, inputText on the focused element, eraseText, openLink, hideKeyboard, basic pressKey, and back; selector targets poll until available and support recursive index, childOf, above, below, leftOf, rightOf, containsChild, containsDescendants, points, and optional; outer command labels are metadata, not target selectors.`,'Assertions and navigation: assertVisible, assertNotVisible, assertTrue (literal values and ${VAR} lookups only; "", "false", "0", "null", and "undefined" are falsy, everything else is truthy), extendedWaitUntil, scroll, scrollUntilVisible, absolute/percentage/target swipe, takeScreenshot, waitForAnimationToEnd, clearState, stopApp, and killApp (system-initiated process death: am kill on ADB-backed Android devices, which refuse a foreground target with android-kill-requires-background-app — background the app first, for example pressKey: Home — and fail a target whose process survives with android-kill-process-survived; iOS, Limrun, and WebDriver-provider backends run it as stopApp).',`Scripts: ordered runScript file/env scripts with http.post, json, and output variables; evalScript inline expressions run flow-scoped JavaScript and write output.* leaves for later steps.`],p=[`Permissions: every entry is one settings permission call, applied in order with all first; the step stops at the first entry the selected platform refuses, earlier entries stay applied, and the error names what landed. Android’s only allow level is while-in-use, so location: inuse and location: never mean allow and deny there, while location: always and photos: limited are Apple-only and fail. On iOS, which service a runtime changes is simctl privacy’s own verdict: current runtimes refuse a targeted notifications change and leave notifications untouched under all.`,`Runtime: iOS and Android only; launchApp.clearState and standalone clearState support Android and iOS simulators, launch arguments are Apple-only, and other standalone device utility/state commands are unsupported.`,"Expressions: evalScript and condition true: fields (runFlow.when and repeat.while share one evaluator) are evaluated as JavaScript (flow env and prior output leaves are string-typed); a true: field that is a boolean, a maestro.platform comparison, or plain literal text after ${VAR} lookups is decided without JavaScript, with the assertTrue falsy table for literal text. Other fields stay literal or ${VAR} lookup-only — assertTrue supports literals and bare lookups, and other expression-shaped payloads fail loud.",`Environment: flow env is the default, AD_VAR_* overrides it, and CLI -e KEY=VALUE wins over both.`,`Failure diagnostics: resolved targets and runFlow paths are rendered, while inputText payloads remain hidden; do not place secrets in diagnostic identifiers.`,`Trust: runScript, evalScript, and JavaScript condition true: fields execute flow scripts in-process via node:vm, which is not a security sandbox; runScript may make http.post network requests and its output keys cannot contain a dot. evalScript and true: fields that need JavaScript are refused outright for a flow accepted over the daemon’s remote HTTP surface, since that context can escape to the host.`,`Errors and tracking: unsupported commands and fields fail with source context when available; open a focused issue only when implementation work is planned.`];function m(){return[`Supported subset:`,...f.map(e=>` - ${e}`),``,`Boundaries:`,...p.map(e=>` - ${e}`)].join(`
2
- `)}const h={summary:`Full multi-touch gesture shapes and platform quirks`,body:`agent-device help gestures
1
+ import{r as e}from"./rolldown-runtime.js";import{O as t,x as n}from"./back-mode.js";import{Pr as r}from"./sdk-batch.js";import{O as i,V as a,f as o,k as s}from"./command-metadata.js";import{a as c}from"./version.js";import{n as l,r as u}from"./command-schema.js";import{n as d}from"./cli-command-aliases.js";import{n as f}from"./provider-plugin-catalog.js";const p=[`Flows: launchApp (with clearState, permissions, and Apple-only launch arguments; permissions apply after state clearing but before launch, and a launchApp without permissions touches nothing — there is no silent all: allow default); setPermissions (mid-flow permission grants, denials, and resets; all resolves in the backend — one simctl call on iOS, the declared permissions on Android — with specific entries overriding after it); runFlow file/inline; runFlow.when and repeat.while conditions (platform, visible, notVisible, and true, all re-evaluated before every repeat iteration); onFlowStart/onFlowComplete; repeat with times, while, or both; and retry.`,`Interactions: tapOn, doubleTapOn, longPressOn, inputText on the focused element, eraseText, openLink, hideKeyboard, basic pressKey, and back; selector targets poll until available and support recursive index, childOf, above, below, leftOf, rightOf, containsChild, containsDescendants, points, and optional; outer command labels are metadata, not target selectors.`,'Assertions and navigation: assertVisible, assertNotVisible, assertTrue (literal values and ${VAR} lookups only; "", "false", "0", "null", and "undefined" are falsy, everything else is truthy), extendedWaitUntil, scroll, scrollUntilVisible, absolute/percentage/target swipe, takeScreenshot, waitForAnimationToEnd, clearState, stopApp, and killApp (system-initiated process death: am kill on ADB-backed Android devices, which refuse a foreground target with android-kill-requires-background-app — background the app first, for example pressKey: Home — and fail a target whose process survives with android-kill-process-survived; iOS, Limrun, and WebDriver-provider backends run it as stopApp).',`Scripts: ordered runScript file/env scripts with http.post, json, and output variables; evalScript inline expressions run flow-scoped JavaScript and write output.* leaves for later steps.`],m=[`Permissions: every entry is one settings permission call, applied in order with all first; the step stops at the first entry the selected platform refuses, earlier entries stay applied, and the error names what landed. Android’s only allow level is while-in-use, so location: inuse and location: never mean allow and deny there, while location: always and photos: limited are Apple-only and fail. On iOS, which service a runtime changes is simctl privacy’s own verdict: current runtimes refuse a targeted notifications change and leave notifications untouched under all.`,`Runtime: iOS and Android only; launchApp.clearState and standalone clearState support Android and iOS simulators, launch arguments are Apple-only, and other standalone device utility/state commands are unsupported.`,"Expressions: evalScript and condition true: fields (runFlow.when and repeat.while share one evaluator) are evaluated as JavaScript (flow env and prior output leaves are string-typed); a true: field that is a boolean, a maestro.platform comparison, or plain literal text after ${VAR} lookups is decided without JavaScript, with the assertTrue falsy table for literal text. Other fields stay literal or ${VAR} lookup-only — assertTrue supports literals and bare lookups, and other expression-shaped payloads fail loud.",`Environment: flow env is the default, AD_VAR_* overrides it, and CLI -e KEY=VALUE wins over both.`,`Failure diagnostics: resolved targets and runFlow paths are rendered, while inputText payloads remain hidden; do not place secrets in diagnostic identifiers.`,`Trust: runScript, evalScript, and JavaScript condition true: fields execute flow scripts in-process via node:vm, which is not a security sandbox; runScript may make http.post network requests and its output keys cannot contain a dot. evalScript and true: fields that need JavaScript are refused outright for a flow accepted over the daemon’s remote HTTP surface, since that context can escape to the host.`,`Errors and tracking: unsupported commands and fields fail with source context when available; open a focused issue only when implementation work is planned.`];function h(){return[`Supported subset:`,...p.map(e=>` - ${e}`),``,`Boundaries:`,...m.map(e=>` - ${e}`)].join(`
2
+ `)}const g={summary:`Full multi-touch gesture shapes and platform quirks`,body:`agent-device help gestures
3
3
 
4
4
  Full command shapes and platform quirks for touch/pointer gestures beyond scroll/swipe. Read this when a task needs multi-touch, a repeated gesture series, or exact per-platform verification.
5
5
 
@@ -33,14 +33,14 @@ macOS:
33
33
  Context menus are secondary clicks, not long presses: agent-device click @e66 --button secondary --platform macos, then snapshot -i.
34
34
  For fast desktop list traversal, prefer fixed pixel wheel steps and batch them when no snapshot is needed between passes:
35
35
  agent-device scroll down --pixels 200 --duration-ms 50 --platform macos
36
- agent-device batch --steps '[{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}},{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}}]' --platform macos`},g={maestro:{id:`maestro`,help:{summary:`Supported Maestro YAML commands, grammar, and runtime boundaries`,body:`agent-device help maestro
36
+ agent-device batch --steps '[{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}},{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}}]' --platform macos`},_={maestro:{id:`maestro`,help:{summary:`Supported Maestro YAML commands, grammar, and runtime boundaries`,body:`agent-device help maestro
37
37
 
38
38
  Run Maestro compatibility flows with replay <flow.yaml> --maestro or test <path> --maestro. Bind an iOS or Android target with --platform or an existing session.
39
39
 
40
- ${m()}
40
+ ${h()}
41
41
 
42
42
  Unsupported syntax fails loudly rather than being skipped. Architecture, performance tradeoffs, and declared conformance divergences: https://github.com/callstack/agent-device/blob/main/docs/adr/0015-direct-maestro-engine.md
43
- Focused compatibility request: https://github.com/callstack/agent-device/issues/new`}}};function _(e){return g[e]}function v(e){let t=e.endsWith(`?`),n=t?e.slice(0,-1):e;return t?`[${n}]`:`<${n}>`}function y(e){return n().filter(t=>t.key===e)}function b(e){if(!e.usageHidden)return e.usageLabel??e.names[0]}function x(e){return(e??[]).flatMap(e=>y(e).map(b).filter(e=>e!==void 0).map(e=>`[${e}]`))}function S(e,t){return[t.usageOverride??[e,...(t.positionalArgs??[]).map(v)].join(` `),...x(t.usageFlags??t.allowedFlags)].join(` `)}const C=`Wait failure contract:
43
+ Focused compatibility request: https://github.com/callstack/agent-device/issues/new`}}};function v(e){return _[e]}function y(e){let t=e.endsWith(`?`),n=t?e.slice(0,-1):e;return t?`[${n}]`:`<${n}>`}function b(e){return n().filter(t=>t.key===e)}function x(e){if(!e.usageHidden)return e.usageLabel??e.names[0]}function S(e){return(e??[]).flatMap(e=>b(e).map(x).filter(e=>e!==void 0).map(e=>`[${e}]`))}function C(e,t){return[t.usageOverride??[e,...(t.positionalArgs??[]).map(y)].join(` `),...S(t.usageFlags??t.allowedFlags)].join(` `)}const w=`Wait failure contract:
44
44
  Read --json error.details.reason.
45
45
  wait_target_absent: readable capture, no match.
46
46
  wait_target_present: absence timeout; details.matches/firstMatch.
@@ -51,7 +51,7 @@ Focused compatibility request: https://github.com/callstack/agent-device/issues/
51
51
  wait_runner_restart_exhausted: restart deadline -- retriable.
52
52
  wait_landmark_identity_mismatch: replay guard: selector matched, recorded identity differed.
53
53
  wait_stable_timeout: no stable UI -- not absence.
54
- `,w={"manual-qa":{summary:`Follow manual test scripts with exact interactions and verification`,body:`agent-device help manual-qa
54
+ `,T={"manual-qa":{summary:`Follow manual test scripts with exact interactions and verification`,body:`agent-device help manual-qa
55
55
 
56
56
  Use this when asked to follow a manual QA script, test case, checklist, acceptance flow, or user-provided instructions.
57
57
 
@@ -94,7 +94,7 @@ Recovery:
94
94
  Sparse or recovered accessibility snapshot: use screenshot as visual truth, leave the bad screen if needed, then retry snapshot -i.
95
95
  Non-hittable success hint: verify with the settled diff or snapshot; retarget by a better ref/selector if the UI did not change.
96
96
 
97
- ${C}`}},T={debugging:{summary:`Targeted failure evidence without dumping stale context`,body:`agent-device help debugging
97
+ ${w}`}},E={debugging:{summary:`Targeted failure evidence without dumping stale context`,body:`agent-device help debugging
98
98
 
99
99
  Use this when behavior fails, hangs, times out, throws alerts, or needs runtime evidence.
100
100
 
@@ -217,7 +217,7 @@ Text-entry quirks:
217
217
  iOS accessibility-driven fill types the replacement once and never clears and retypes a read-back mismatch. Exact settled text confirms the entry. A value containing only characters in order from the post-clear value plus the request fails with TEXT_ENTRY_MISMATCH, including plain dropped characters and unchanged values; legitimate trimming or masks can also hit this limit ("5" into "$0.00" displaying "$0.05"). Other settled values return verification: "unconfirmed" with requested/before/after/target evidence, including grouping ("00 062 91 77" for "000629177"), currency ("$10.00" for "1000"), and OTP summaries. Missing, reordered, duplicated or stale text can also be unconfirmed, so assert the expected value with a value selector, get/is, or the resulting screen before continuing. For single-line fills ending in a submit key, any non-matching value observed on the same target succeeds unverified, including partial or cleared text; this exception skips dropped-character checks because the submit may change the field. Assert the resulting screen. Multiline fields compare newlines as content. Unreadable or removed fields remain unverified. The coordinate-driven fill route still requires an exact match. After TEXT_ENTRY_MISMATCH, inspect the field and retry fill only if it needs correction, using the --delay-ms value from the error hint.
218
218
 
219
219
  React Native internals:
220
- If the question is about React component props, state, hooks, the component tree, performance, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`}},E={dogfood:{summary:`Exploratory QA workflow with reproducible evidence`,body:`agent-device help dogfood
220
+ If the question is about React component props, state, hooks, the component tree, performance, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`}},D={dogfood:{summary:`Exploratory QA workflow with reproducible evidence`,body:`agent-device help dogfood
221
221
 
222
222
  Use this when asked to dogfood, exploratory test, bug hunt, QA, or find issues in an app.
223
223
 
@@ -310,7 +310,7 @@ Evidence:
310
310
 
311
311
  Report:
312
312
  Summarize what changed, exact validation commands, pass/fail observations, artifact paths, and residual risk.
313
- If live validation is blocked, state the blocker, device/session, and exact next command needed.`}};function D(){return`agent-device <command> [args] [--json]
313
+ If live validation is blocked, state the blocker, device/session, and exact next command needed.`}};function O(){return`agent-device <command> [args] [--json]
314
314
 
315
315
  Automates iOS, Android, macOS, TV, and web apps for AI agents.
316
316
  All ${t().length} commands: agent-device help commands
@@ -361,7 +361,7 @@ Guides (agent-device help <topic>):
361
361
  react-native / react-devtools / cdp / tv / web / macos / remote
362
362
  physical-device / ios-system-ui / maestro
363
363
  foldable iPhone Duo panels, the fold command, and why refs die on a pose change
364
- `}var O=e({buildCommandUsageText:()=>W,buildUsageText:()=>L,helpTopicIds:()=>K,resolveHelpTargetUsageText:()=>G});const k=[`Default config files: ~/.agent-device/config.json (or <AGENT_DEVICE_HOME>/config.json), ./agent-device.json (project-safe defaults only).`,`Use --config <path> or AGENT_DEVICE_CONFIG for explicit connection/provider defaults; project config cannot select endpoints or credentials.`],A=[{label:`AGENT_DEVICE_SESSION`,description:`Explicit session name`},{label:`AGENT_DEVICE_PLATFORM`,description:`Default platform binding`},{label:`AGENT_DEVICE_SCREENSHOT_SCALE`,description:`Default screenshot scale factor`},{label:`AGENT_DEVICE_SESSION_LOCK`,description:`Bound-session conflict mode`},{label:`AGENT_DEVICE_DAEMON_BASE_URL`,description:`Connect to remote daemon`},{label:`AGENT_DEVICE_DAEMON_AUTH_TOKEN`,description:`Remote daemon service/API token`},{label:`AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS`,description:`Local daemon startup ceiling (default 120000)`},{label:`AGENT_DEVICE_CLOUD_BASE_URL`,description:`Bridge/control-plane API origin for cloud auth and /api-keys`}],j=[`agent-device open Settings --platform ios`,`agent-device open https://example.com --platform web`,`agent-device snapshot -i`,`agent-device fill @e3 "test@example.com"`,`agent-device replay ./session.ad`,`agent-device wait absent 'label="Loading..."' 3000`,`agent-device test ./suite --platform android`],M={commands:{summary:`Full command catalog, global flags, configuration, and environment`,body:`agent-device help commands`},...w,maestro:_(`maestro`).help,workflow:{summary:`Normal agent-device bootstrap, exploration, and validation loop`,body:`agent-device help workflow
364
+ `}var k=e({buildCommandUsageText:()=>G,buildUsageText:()=>R,helpTopicIds:()=>q,resolveHelpTargetUsageText:()=>K});const A=[`Default config files: ~/.agent-device/config.json (or <AGENT_DEVICE_HOME>/config.json), ./agent-device.json (project-safe defaults only).`,`Use --config <path> or AGENT_DEVICE_CONFIG for explicit connection/provider defaults; project config cannot select endpoints or credentials.`],j=[{label:`AGENT_DEVICE_SESSION`,description:`Explicit session name`},{label:`AGENT_DEVICE_PLATFORM`,description:`Default platform binding`},{label:`AGENT_DEVICE_SCREENSHOT_SCALE`,description:`Default screenshot scale factor`},{label:`AGENT_DEVICE_SESSION_LOCK`,description:`Bound-session conflict mode`},{label:`AGENT_DEVICE_DAEMON_BASE_URL`,description:`Connect to remote daemon`},{label:`AGENT_DEVICE_DAEMON_AUTH_TOKEN`,description:`Remote daemon service/API token`},{label:`AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS`,description:`Local daemon startup ceiling (default 120000)`},{label:`AGENT_DEVICE_CLOUD_BASE_URL`,description:`Bridge/control-plane API origin for cloud auth and /api-keys`}],M=[`agent-device open Settings --platform ios`,`agent-device open https://example.com --platform web`,`agent-device snapshot -i`,`agent-device fill @e3 "test@example.com"`,`agent-device replay ./session.ad`,`agent-device wait absent 'label="Loading..."' 3000`,`agent-device test ./suite --platform android`],N={commands:{summary:`Full command catalog, global flags, configuration, and environment`,body:`agent-device help commands`},...T,maestro:v(`maestro`).help,workflow:{summary:`Normal agent-device bootstrap, exploration, and validation loop`,body:`agent-device help workflow
365
365
 
366
366
  Command shapes, refs, selectors, waits, recovery, and platform limits for open -> snapshot -i -> settle -> verify -> close loop.
367
367
 
@@ -401,7 +401,7 @@ Session ordering:
401
401
  Stateful commands (open/press/fill/type/scroll/back/alert/replay/batch/close) run serially within one session. Parallelize only read-only commands, or separate sessions/devices.
402
402
 
403
403
  Read-only and waits:
404
- ${C}
404
+ ${w}
405
405
  snapshot/get/is/find answer read-only questions; snapshot -i is for refs. --settle confirms local UI quieted; delayed results use wait text "Expected result" or wait <selector> instead of polling; strict disappearance uses wait absent <selector>.
406
406
  wait stable [quietMs] [timeoutMs] (defaults 500/10000) is the fallback for open/relaunch/navigation, or an intentionally-unsettled mutation -- not after a --settle whose diff already shows the change. Ambiguous find: add --first or --last.
407
407
 
@@ -417,7 +417,7 @@ Validation and evidence:
417
417
 
418
418
  React Native: help react-native for Metro/Re.Pack reload, DevTools, RN overlays. JS-only change: metro reload, find "Home"; open --relaunch for native reset.
419
419
 
420
- Lifecycle facts (trust these instead of probing): open without --relaunch is idempotent-foreground; --relaunch restarts it. close keeps a healthy iOS runner warm by default; runners and daemons both self-idle after 5 minutes, and a stale lease reclaims automatically. The device claim taken by open also reclaims another worktree's retained warm runner; "already owned by another agent-device daemon" = owner outside claim arbitration. Env vars: help physical-device.
420
+ Lifecycle facts (trust these instead of probing): open without --relaunch is idempotent-foreground except native macOS app opens (background); --relaunch restarts it. close keeps a healthy iOS runner warm by default; runners/daemons self-idle after 5 minutes; stale leases self-reclaim. open device claims reclaim other worktrees' warm runners; "already owned by another agent-device daemon" = owner outside claim arbitration. Env vars: help physical-device.
421
421
 
422
422
  Escalate:
423
423
  help manual-qa scripted manual QA
@@ -476,7 +476,7 @@ Batch:
476
476
  Recording:
477
477
  record start/stop. Default scope is app (needs an active open session); use --scope device/system for whole-screen capture spanning multiple apps/home/settings. --quality medium|high on Android and Apple targets. stop burns touch overlays into the video by default; --hide-touches skips that for the fastest raw recording, and is recommended for gesture-heavy iOS simulator proof videos since overlay timing depends on a stable runner session. Android adb screenrecord has a 180s limit, so long Android recordings return as multiple MP4 chunks while the daemon stays alive; after a daemon restart, record stop recovers only manifest-owned chunks. record stop is safe to repeat: if its request window ended while the daemon was still exporting, running it again in that session returns the completed recording instead of starting a second one.
478
478
  record contact-sheet <video.mp4> [--out <sheet.png>] reads an exported MP4 back and writes one PNG holding the frames where the screen visibly changed, each labeled with its elapsed time. It is how you read a recording you cannot play, and it needs no session or device; the frames come out of that file, so the sheet cannot describe a screen the video does not contain. The sample grid is bounded and spread over the whole clip, so it reports coverage, not a review: a flash that opens and closes between two sample times is not in it. Needs a macOS host and an MP4 (a WebM recording is refused).
479
- Tracing: trace start ./trace.log, trace stop ./trace.log (path is positional, not --path).`},gestures:h,tv:{summary:`Android TV, tvOS, and Vega VVD focus-first remote navigation`,body:`agent-device help tv
479
+ Tracing: trace start ./trace.log, trace stop ./trace.log (path is positional, not --path).`},gestures:g,tv:{summary:`Android TV, tvOS, and Vega VVD focus-first remote navigation`,body:`agent-device help tv
480
480
 
481
481
  Use this when the target is Android TV, Apple TV/tvOS, or an Amazon Vega OS TV app running in the Vega Virtual Device (VVD). TV surfaces are focus-first: move focus with remote/D-pad buttons, then activate the focused control.
482
482
 
@@ -527,7 +527,7 @@ Focus and visual truth:
527
527
  On Android TV and tvOS, if snapshot -i exposes a focused node, verify it with is focused <selector>.
528
528
  Use wait focused=true only when repeated snapshots preserve focus metadata for the app.
529
529
  If the app exposes only a surface view, or focus metadata is transient, use screenshot --overlay-refs, screenshot, or diff snapshot as visual truth and keep moving focus with tv-remote. On Vega OS, use the VVD display as visual truth until capture support lands.
530
- Do not assume press/click @ref works on Android TV, tvOS, or Vega OS until the desired element is focused.`},...T,"react-devtools":{summary:`React Native components, props/state/hooks, and render profiling`,body:`agent-device help react-devtools
530
+ Do not assume press/click @ref works on Android TV, tvOS, or Vega OS until the desired element is focused.`},...E,"react-devtools":{summary:`React Native components, props/state/hooks, and render profiling`,body:`agent-device help react-devtools
531
531
 
532
532
  Use this for React Native internals the accessibility tree cannot show: the component tree, a component's props, state, hooks, and owners, errors and warnings components logged while rendering, and render performance (slow renders, rerenders and their causes, commits over a 16 ms frame).
533
533
 
@@ -739,7 +739,7 @@ Android physical-device prerequisites:
739
739
  Android does not need the iOS runner signing setup. For React Native/Expo Metro reachability, read help react-native.
740
740
 
741
741
  Runner and daemon lifecycle (applies to simulators too):
742
- open without --relaunch is idempotent-foreground for an already-running app (it brings the process forward; it does not restart it). open --relaunch restarts the app; on iOS simulators this collapses to one simctl launch --terminate-running-process call instead of a separate terminate-then-launch.
742
+ open without --relaunch is idempotent-foreground for an already-running app, except native macOS app opens keep it in the background (help macos); neither restarts the process. open --relaunch restarts the app; on iOS simulators this collapses to one simctl launch --terminate-running-process call instead of a separate terminate-then-launch.
743
743
  No runner read launches a session app that is not running: snapshot, wait, is, get, a reading find, and an interaction's leading reads (a gesture's viewport read, the capture that resolves a selector click/fill) answer the retriable APP_NOT_RUNNING instead of bare-launching over a launch SpringBoard still holds behind its deep-link confirmation. Only open, activate, and a command that mutates without a leading read bring a stopped app up.
744
744
  close keeps a healthy iOS simulator XCTest runner warm by default so the next open on that simulator (same udid in the same simulator set) skips the runner build, unless --shutdown was requested, the session was recording, or the session held a device lease. A retained runner auto-stops after an idle window (default 5 minutes); set AGENT_DEVICE_IOS_RUNNER_IDLE_STOP_MS to override, or 0 to disable idle stop and retain until daemon exit. Only a ready runner with an observed listener is retained; close retires unfinished prewarm recovery. Losing the retained listener stops that generation, and daemon shutdown stops idle retained runners rather than handing them off without supervision.
745
745
  Each AGENT_DEVICE_STATE_DIR runs its own daemon. It self-exits after an idle window (default 5 minutes, matching the runner idle-stop default) once it has no open sessions, no in-flight requests, and no active recording; set AGENT_DEVICE_DAEMON_IDLE_TIMEOUT_MS to override, or 0 to disable idle reap.
@@ -786,9 +786,13 @@ Providers:
786
786
  Direct proxy: agent-device connect proxy --daemon-base-url <proxy-agent-device-url> stores the shared proxy profile and client identity.
787
787
  BrowserStack: agent-device connect browserstack verifies credentials, the exact device, and a bs:// app reference, then stores a local provider profile. It does not create an App Automate session.
788
788
  AWS Device Farm: agent-device connect aws-device-farm verifies credentials and the exact project, device, and optional app upload, then stores a local provider profile. It does not create a remote access session.
789
- TestMu AI: agent-device connect testmu verifies credentials and the exact virtual device (emulator or simulator) or, with --provider-device-type real, real device and OS version, then stores a local provider profile. --provider-app takes an lt:// app reference, an https URL, or a local path: connect looks an lt:// id up among your uploads for that device pool, while URL and local sources are uploaded and validated when open creates the session. It does not create a hub session.
789
+ TestMu AI (plugin, install separately): agent-device connect testmu verifies credentials and the exact virtual device (emulator or simulator) or, with --provider-device-type real, real device and OS version, then stores a local provider profile. --provider-app takes an lt:// app reference, an https URL, or a local path: connect looks an lt:// id up among your uploads for that device pool, while URL and local sources are uploaded and validated when open creates the session. It does not create a hub session.
790
790
  Limrun: agent-device connect limrun verifies access to the selected iOS or Android instance service, then stores a local provider profile. It does not create an instance.
791
791
 
792
+ Plugin installation:
793
+ ${f()}
794
+ Plugin help is available before installation. plugins list --json reports your installed plugins. A missing plugin returns reason plugin-not-installed with its installation command; a selected plugin that cannot supply the provider returns plugin-unavailable instead. After changing plugins, close sessions and stop an existing local daemon with the same --state-dir before the next device command.
795
+
792
796
  After direct-provider connect:
793
797
  Read the printed Device, App, Next, and workflow-note lines. They are also available as verification/device/app/liveSession/nextSteps/notes in --json output.
794
798
  BrowserStack, AWS Device Farm, and TestMu AI create the hosted session on open. open needs the installed package or bundle identifier, not the app artifact name, ARN, or lt:// id.
@@ -941,7 +945,9 @@ Rules:
941
945
  Do not let iOS simulator-set scoping hide macOS desktop targets.
942
946
  Prefer refs/selectors over raw coordinates.
943
947
  macOS snapshot rects are window-space; use current refs or overlay refs instead of guessing coordinates.
944
- On the default XCTest backend a read (snapshot, get, find) of a session app that sits behind other windows is answered from where it sits, without raising the app; interactions and a window-level screenshot of that app still bring it forward.`},web:{summary:`Minimal browser workflow with the managed web backend`,body:`agent-device help web
948
+ On the default XCTest backend a read (snapshot, get, find) of a session app that sits behind other windows is answered from where it sits, without raising the app; interactions and a window-level screenshot of that app still bring it forward.
949
+ With AGENT_DEVICE_MACOS_APP_BACKEND=native, each app opened on the app surface is its own device: sessions on different apps run in parallel; a same-app or whole-Mac (desktop, menubar, frontmost-app) session conflicts.
950
+ An app session opens its app in the background and opens or closes only that app (open <url> goes to it). It refuses clipboard, settings, and audio probe; use a --surface desktop session for those, or a new --session for another app.`},web:{summary:`Minimal browser workflow with the managed web backend`,body:`agent-device help web
945
951
 
946
952
  Use --platform web only for the minimal browser command loop exposed through agent-device.
947
953
 
@@ -988,30 +994,30 @@ Out of scope for agent-device web support:
988
994
  Rules:
989
995
  Do not claim web e2e CI exists unless a project workflow explicitly provides it.
990
996
  Do not use native mobile or desktop setup commands such as boot, apps, install, settings, alert, keyboard, perf, logs, or react-devtools for --platform web.
991
- Keep browser plans session-scoped: open a URL, inspect refs, act on refs/selectors, verify with wait/get/is/snapshot, capture screenshot only when visual evidence is needed, then close.`},...E};function N(e,t,n){let r=n.endsWith(`?`),i=r?n.slice(0,-1):n,a=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i),o=a||t.usageOverride!==void 0&&t.usageOverride.startsWith(`${e} ${i}`);return r?a?`[${i}]`:o?i:`[${i}]`:o?i:`<${i}>`}function P(e,t){return t.listUsageOverride?t.listUsageOverride:[e,...(t.positionalArgs??[]).map(n=>N(e,t,n))].join(` `)}function F(){return D()}function I(){return`agent-device help commands
997
+ Keep browser plans session-scoped: open a URL, inspect refs, act on refs/selectors, verify with wait/get/is/snapshot, capture screenshot only when visual evidence is needed, then close.`},...D};function P(e,t,n){let r=n.endsWith(`?`),i=r?n.slice(0,-1):n,a=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i),o=a||t.usageOverride!==void 0&&t.usageOverride.startsWith(`${e} ${i}`);return r?a?`[${i}]`:o?i:`[${i}]`:o?i:`<${i}>`}function F(e,t){return t.listUsageOverride?t.listUsageOverride:[e,...(t.positionalArgs??[]).map(n=>P(e,t,n))].join(` `)}function I(){return O()}function L(){return`agent-device help commands
992
998
 
993
999
  Full command catalog. Use agent-device help <command> for exact flags and behavior.
994
1000
 
995
- ${U(t().map(e=>{let t=l(e);return{name:e,schema:t,usage:P(e,t)}}))}
1001
+ ${W(t().map(e=>{let t=l(e);return{name:e,schema:t,usage:F(e,t)}}))}
996
1002
 
997
- ${B(`Device Selection (shared by device commands; help <command> lists each command's flags):`,R(i))}
1003
+ ${V(`Device Selection (shared by device commands; help <command> lists each command's flags):`,z(i))}
998
1004
 
999
- ${B(`Global Flags:`,R(s))}
1005
+ ${V(`Global Flags:`,z(s))}
1000
1006
 
1001
- ${H(`Configuration:`,k)}
1007
+ ${U(`Configuration:`,A)}
1002
1008
 
1003
- ${V(`Environment:`,A)}
1009
+ ${H(`Environment:`,j)}
1004
1010
 
1005
- ${H(`Examples:`,j)}
1006
- `}function L(){return F()}function R(e){return n().filter(t=>e.has(t.key)&&t.usageLabel!==void 0&&t.usageDescription!==void 0)}function z(e,t){return t?e.map(e=>{let n=t[e.key];return n===void 0?e:{...e,usageDescription:n}}):e}function B(e,t){return V(e,t.map(e=>({label:e.usageLabel??``,description:e.usageDescription??``})))}function V(e,t){if(t.length===0)return`${e}\n (none)`;let n=Math.max(...t.map(e=>Math.min(e.label.length,26)))+2,r=[e];for(let e of t){let t=e.label.length<=26?e.label.padEnd(n):`${e.label} `;r.push(` ${t}${e.description}`)}return r.join(`
1007
- `)}function H(e,t){return t.length===0?`${e}\n (none)`:[e,...t.map(e=>` ${e}`)].join(`
1008
- `)}function U(e){return V(`Commands:`,e.map(e=>({label:e.usage,description:e.schema.text.summary})))}function W(e){let t=q(e);if(t)return t;let n=u(e);if(!n)return null;let r=S(e,n),i=z(R(new Set(n.allowedFlags??[])),n.flagDescriptionOverrides),o=[];i.length>0&&o.push(B(`Command flags:`,i));let s=o.length>0?`\n\n${o.join(`
1011
+ ${U(`Examples:`,M)}
1012
+ `}function R(){return I()}function z(e){return n().filter(t=>e.has(t.key)&&t.usageLabel!==void 0&&t.usageDescription!==void 0)}function B(e,t){return t?e.map(e=>{let n=t[e.key];return n===void 0?e:{...e,usageDescription:n}}):e}function V(e,t){return H(e,t.map(e=>({label:e.usageLabel??``,description:e.usageDescription??``})))}function H(e,t){if(t.length===0)return`${e}\n (none)`;let n=Math.max(...t.map(e=>Math.min(e.label.length,26)))+2,r=[e];for(let e of t){let t=e.label.length<=26?e.label.padEnd(n):`${e.label} `;r.push(` ${t}${e.description}`)}return r.join(`
1013
+ `)}function U(e,t){return t.length===0?`${e}\n (none)`:[e,...t.map(e=>` ${e}`)].join(`
1014
+ `)}function W(e){return H(`Commands:`,e.map(e=>({label:e.usage,description:e.schema.text.summary})))}function G(e){let t=J(e);if(t)return t;let n=u(e);if(!n)return null;let r=C(e,n),i=B(z(new Set(n.allowedFlags??[])),n.flagDescriptionOverrides),o=[];e===`connect`&&o.push(`Optional provider plugins:\n${f()}`),i.length>0&&o.push(V(`Command flags:`,i));let s=o.length>0?`\n\n${o.join(`
1009
1015
 
1010
1016
  `)}`:``;return`Usage:
1011
1017
  agent-device ${r}
1012
1018
 
1013
1019
  ${a(n.text)}${s}
1014
- `}function G(e){return W(d(e))}function K(){return Object.keys(M)}function q(e){let t=M[e];if(!t)return null;let n=e===`commands`?I():t.body,r=J.filter(t=>t.topic!==e).map(e=>` ${e.line}\n`).join(``);return`${Y(e,n)}
1020
+ `}function K(e){return G(d(e))}function q(){return Object.keys(N)}function J(e){let t=N[e];if(!t)return null;let n=e===`commands`?L():t.body,r=Y.filter(t=>t.topic!==e).map(e=>` ${e.line}\n`).join(``);return`${X(e,n)}
1015
1021
 
1016
1022
  Related:
1017
- ${r}`}const J=[{topic:null,line:`agent-device help <command> command-specific flags`},{topic:`manual-qa`,line:`agent-device help manual-qa routine QA loop`},{topic:`workflow`,line:`agent-device help workflow full automation reference`}];function Y(e,t){let n=`agent-device help ${e}`;return t.startsWith(n)?`agent-device ${c()} — ${e}${t.slice(n.length)}`:t}export{G as i,O as n,K as r,L as t};
1023
+ ${r}`}const Y=[{topic:null,line:`agent-device help <command> command-specific flags`},{topic:`manual-qa`,line:`agent-device help manual-qa routine QA loop`},{topic:`workflow`,line:`agent-device help workflow full automation reference`}];function X(e,t){let n=`agent-device help ${e}`;return t.startsWith(n)?`agent-device ${c()} — ${e}${t.slice(n.length)}`:t}export{K as i,k as n,q as r,R as t};
@@ -1,3 +1,3 @@
1
- import{R as e}from"./sdk-contracts.js";import{vt as t}from"./sdk-io.js";import"./diagnostics.js";import{C as n,o as r}from"./command-metadata.js";import{t as i}from"./cli-output.js";import{n as a}from"./command-surface.js";const o=65536;async function s(t){if(t.isTTY)throw new e(`INVALID_ARGS`,`fill --text-stdin reads piped input, but stdin is a terminal.`,{reason:`fill_text_stdin_tty`,hint:`Pipe the text in, for example: printf %s "$PASSWORD" | agent-device fill @e3 --text-stdin`});let n=[],r=0,i=``;for await(let a of t){let t=u(i,a);if(i=t.held,r+=d(t.piece),r>65536)throw new e(`INVALID_ARGS`,`fill --text-stdin accepts at most ${o} bytes of input.`,{reason:`fill_text_stdin_too_large`,maxBytes:o});n.push(f(t.piece))}if(i)throw m();let a=h(p(Buffer.concat(n)));if(a===``)throw new e(`INVALID_ARGS`,`fill --text-stdin received no text.`,{reason:`fill_text_stdin_empty`,hint:`Check that the piped value is set. To clear a field, pass an empty text argument instead: fill @e3 ""`});return a}const c=/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/,l=/[\uD800-\uDBFF]$/;function u(e,t){if(typeof t!=`string`){if(e)throw m();return{piece:t,held:``}}let n=e+t;return l.test(n)?{piece:n.slice(0,-1),held:n.slice(-1)}:{piece:n,held:``}}function d(e){return typeof e==`string`?Buffer.byteLength(e,`utf8`):e.byteLength}function f(e){if(typeof e!=`string`)return e;if(c.test(e))throw m();return Buffer.from(e,`utf8`)}function p(e){try{return new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(e)}catch{throw m()}}function m(){return new e(`INVALID_ARGS`,`fill --text-stdin input is not valid UTF-8.`,{reason:`fill_text_stdin_invalid_utf8`})}function h(e){return e.endsWith(`\r
1
+ import{R as e}from"./sdk-contracts.js";import{bt as t}from"./sdk-io.js";import"./diagnostics.js";import{C as n,o as r}from"./command-metadata.js";import{t as i}from"./cli-output.js";import{n as a}from"./command-surface.js";const o=65536;async function s(t){if(t.isTTY)throw new e(`INVALID_ARGS`,`fill --text-stdin reads piped input, but stdin is a terminal.`,{reason:`fill_text_stdin_tty`,hint:`Pipe the text in, for example: printf %s "$PASSWORD" | agent-device fill @e3 --text-stdin`});let n=[],r=0,i=``;for await(let a of t){let t=u(i,a);if(i=t.held,r+=d(t.piece),r>65536)throw new e(`INVALID_ARGS`,`fill --text-stdin accepts at most ${o} bytes of input.`,{reason:`fill_text_stdin_too_large`,maxBytes:o});n.push(f(t.piece))}if(i)throw m();let a=h(p(Buffer.concat(n)));if(a===``)throw new e(`INVALID_ARGS`,`fill --text-stdin received no text.`,{reason:`fill_text_stdin_empty`,hint:`Check that the piped value is set. To clear a field, pass an empty text argument instead: fill @e3 ""`});return a}const c=/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/,l=/[\uD800-\uDBFF]$/;function u(e,t){if(typeof t!=`string`){if(e)throw m();return{piece:t,held:``}}let n=e+t;return l.test(n)?{piece:n.slice(0,-1),held:n.slice(-1)}:{piece:n,held:``}}function d(e){return typeof e==`string`?Buffer.byteLength(e,`utf8`):e.byteLength}function f(e){if(typeof e!=`string`)return e;if(c.test(e))throw m();return Buffer.from(e,`utf8`)}function p(e){try{return new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(e)}catch{throw m()}}function m(){return new e(`INVALID_ARGS`,`fill --text-stdin input is not valid UTF-8.`,{reason:`fill_text_stdin_invalid_utf8`})}function h(e){return e.endsWith(`\r
2
2
  `)?e.slice(0,-2):e.endsWith(`
3
3
  `)?e.slice(0,-1):e}const g=r();function _(e,t,r){let i=g[e];if(!i)throw Error(`Missing CLI reader for command: ${e}`);return{...i(t,r),...n(e,r)}}async function v(e){return(await y(e)).result}async function y(e){let n=_(e.command,e.positionals,e.flags);if(e.flags.textStdin){let e=await s(process.stdin);t(e),n.text=e}let r=await a(e.client,e.command,n);return{result:r,cliOutput:await i({name:e.command,input:n,result:r,progress:e.commandProgress,env:e.env})}}export{y as n,v as t};
package/dist/src/cli.js CHANGED
@@ -1,4 +1,4 @@
1
- import{r as e}from"./rolldown-runtime.js";import{B as t,R as n,d as r,et as i,m as a}from"./sdk-contracts.js";import{gt as o}from"./tv-remote.js";import{d as s,f as c,s as l,u}from"./sdk-batch-runner.js";import{D as d,O as f,b as p,ht as m,pt as h,vt as g,wt as ee,x as _,yt as te}from"./back-mode.js";import{_t as v,f as ne,gt as y,ht as b,lt as re,mt as ie,ot as ae,tt as oe,vt as se,xt as ce}from"./sdk-io.js";import"./diagnostics.js";import{D as le,O as ue,c as de,m as fe,x as pe}from"./sdk-device.js";import{n as me}from"./agent-device-client.js";import{s as he,t as ge,u as _e}from"./sdk-batch.js";import{t as ve}from"./sdk-remote-config.js";import{G as ye,n as be}from"./command-metadata.js";import"./file.js";import"./command.js";import{i as xe,n as Se}from"./daemon-client.js";import{n as Ce}from"./session-artifact-paths.js";import{a as we}from"./version.js";import{m as Te}from"./daemon-resolution.js";import{n as Ee,r as De}from"./remote-config-core.js";import{r as x,t as Oe}from"./command-schema.js";import{n as S,r as C,t as ke}from"./cli-config.js";import{t as Ae}from"./update-check.js";import{n as je,r as Me,t as Ne}from"./cli-command-aliases.js";import{exitAfterFlush as w}from"./process-exit.js";import T from"node:crypto";import E from"node:fs";import D from"node:path";import{pathToFileURL as Pe}from"node:url";const O=`open <app> --relaunch`,Fe={start:{command:`open`,example:O},restart:{command:`open`,example:O},touch:{command:`press`,example:`press`},input:{command:`fill`,example:`fill`},settext:{command:`fill`,example:`fill`},entertext:{command:`fill`,example:`fill`},screencap:{command:`screenshot`,example:`screenshot`},capture:{command:`screenshot`,example:`screenshot`},dismiss:{command:`keyboard`,example:`keyboard dismiss`},"get-text":{command:`get`,example:`get text`},gettext:{command:`get`,example:`get text`},get_text:{command:`get`,example:`get text`},"open-url":{command:`open`,example:`open <url>`},"close-session":{command:`close`,example:`close`}};function Ie(e){if(e.length<=2)return[];let t=f(),n=t.filter(t=>t.startsWith(e));return n.length>0?n.sort(Le).slice(0,3):Re(e,t)}function Le(e,t){return e.length-t.length||e.localeCompare(t)}function Re(e,t){let n=t.map(t=>({name:t,distance:Be(e,t)})).filter(t=>t.distance<=ze(e));if(n.length===0)return[];let r=Math.min(...n.map(e=>e.distance));return n.filter(e=>e.distance===r).sort((e,t)=>e.name.localeCompare(t.name)).slice(0,3).map(e=>e.name)}function ze(e){return e.length<4?1:e.length<=6?2:3}function Be(e,t){return e===t?0:e.startsWith(t)||t.startsWith(e)?Math.abs(e.length-t.length):Ve(e,t)}function Ve(e,t){let n=e.length+1,r=t.length+1,i=Array.from({length:n},()=>Array(r).fill(0));for(let e=0;e<n;e+=1)i[e][0]=e;for(let e=0;e<r;e+=1)i[0][e]=e;for(let a=1;a<n;a+=1)for(let n=1;n<r;n+=1){let r=e[a-1]===t[n-1]?0:1;i[a][n]=Math.min(i[a-1][n]+1,i[a][n-1]+1,i[a-1][n-1]+r)}return i[n-1][r-1]}function He(e){let t=e.toLowerCase(),n=Fe[t]?.example;if(n)return n;let r=Ie(t);if(r.length!==0)return r.length===1?r[0]:`one of: ${r.join(`, `)}`}const Ue=new Set([`--bundle-id`,`--bundleid`,`--bundle`,`--package`,`--package-name`,`--packagename`,`--app-id`,`--appid`,`--pkg`]),We=new Set([`--session-locked`,`--session-lock-conflicts`]),Ge={"--output":`--out`,"--path":`--out`};function Ke(e,t){let n=e.toLowerCase(),r=Ge[n];if(r&&qe(r,t))return r;let i=Je(n,t);if(i.length!==0)return i.length===1?i[0]:`one of: ${i.join(`, `)}`}function qe(e,t){let n=_().find(t=>t.names.includes(e));return n?C(n.key,t):!1}function Je(e,t){let n=k(e);if(n.length<=2)return[];let r=Ye(t),i=r.filter(e=>k(e).startsWith(n));return i.length>0?i.sort(Le).slice(0,3):Re(n,r.map(e=>k(e))).map(e=>`--${e}`)}function Ye(e){let t=new Set;for(let n of _()){if(!C(n.key,e))continue;let r=n.names[0];r&&t.add(r)}return[...t]}function k(e){return e.replace(/^--?/,``)}function Xe(e,t){let n=e.toLowerCase();if(Ue.has(n))return`Unknown flag: ${e}. The app or bundle id is a positional argument, e.g. ${O}.`;if(We.has(n))return`Unknown flag: ${e}. Use --session-lock reject|strip instead.`;if(n===o.cliToken)return`Unknown flag: ${e}. ${o.migration.screenshot}. ${o.migration.record}.`;let r=Ke(e,t);return r?`Unknown flag: ${e}. Did you mean ${r}?`:`Unknown flag: ${e}`}function A(e){let t={json:!1,help:!1,version:!1},r=null,i=null,a=[],o=[],s=[],c=!0;for(let o=0;o<e.length;o+=1){let l=e[o];if(c&&l===`--`){c=!1;continue}if(!c){r?a.push(l):(i=l,r=N(l));continue}if(et(r)){a.push(l);continue}let u=l.startsWith(`--`),d=l.startsWith(`-`)&&l.length>1;if(!u&&!d){r?a.push(l):(i=l,r=N(l));continue}let[f,p]=u?j(l):[l,void 0];if(Qe(r,f))continue;let m=tt(f,r);if($e(r,m)){a.push(l);continue}if(!m){if(ct(r,a,l)){r?a.push(l):r=l;continue}throw new n(`INVALID_ARGS`,Xe(f,r))}let h=it(m,f,p,e[o+1]);h.consumeNext&&(o+=1);let g=t[m.key];if(m.multiple){let e=Array.isArray(g)?[...g,h.value]:g===void 0?[h.value]:[g,h.value];t[m.key]=e}else t[m.key]=h.value;s.push({key:m.key,token:f})}return Ze(i,t),{command:r,positionals:a,flags:t,warnings:o,providedFlags:s}}function Ze(e,t){if(e)for(let n of Ne(e)?.impliedFlags??[])t[n]=!0}function Qe(e,t){return t===`-c`&&(e===`snapshot`||e===`diff`)}function $e(e,t){return e===`react-devtools`?!t||!C(t.key,e):!1}function et(e){return e===`cdp`}function tt(e,t){let n=_().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??p(e);if(t){let e=n.find(e=>C(e.key,t));if(e)return e}return p(e)}function nt(e,t){let r=t?.strictFlags??!0,i=[...e.warnings],a=S({json:!1,help:!1,version:!1},t?.defaultFlags??{});if(S(a,e.flags),e.command&&!d(e.command)&&!a.help){let t=He(e.command),r=t?`Unknown command: ${e.command}. Did you mean ${t}?`:`Unknown command: ${e.command}`;throw new n(`INVALID_ARGS`,r)}let o=e.providedFlags.filter(t=>!C(t.key,e.command));if(o.length>0){let t=o.map(e=>e.token),s=mt(e.command,t);if(r)throw new n(`INVALID_ARGS`,s);i.push(s);for(let e of o)delete a[e.key]}let s=ft(e);if(s.length>0){let t=pt(e.command,e.positionals[0],s);if(r)throw new n(`INVALID_ARGS`,t);i.push(t);for(let e of s)delete a[e.key]}for(let t of Object.keys(a))a[t]!==void 0&&(C(t,e.command)||delete a[t]);dt(e,a),rt(e),_e(e.command,a);let c=ut({command:e.command,positionals:e.positionals,flags:a,warnings:i});if(Oe(c.command,c.positionals),c.command===`batch`&&+!!a.steps+ +!!a.stepsFile!=1)throw new n(`INVALID_ARGS`,`batch requires exactly one step source: --steps or --steps-file.`);return c}function rt(e){if(e.command!==`back`)return;let t=e.providedFlags.filter(e=>e.key===`backMode`);if(!(new Set(t.map(e=>e.token)).size<=1))throw new n(`INVALID_ARGS`,`back accepts only one explicit mode flag: use either --in-app or --system.`)}function j(e){let t=e.indexOf(`=`);return t===-1?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function it(e,t,r,i){if(e.setValue!==void 0){if(r!==void 0)throw new n(`INVALID_ARGS`,`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if(e.type===`boolean`){if(r!==void 0)throw new n(`INVALID_ARGS`,`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if(e.type===`booleanOrString`){if(r!==void 0){if(r.trim().length===0)throw new n(`INVALID_ARGS`,`Flag ${t} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return i===void 0||ot(i)?{value:!0,consumeNext:!1}:st(i)?{value:i,consumeNext:!0}:{value:!0,consumeNext:!1}}let a=r??i;if(a===void 0||r===void 0&&ot(a))throw new n(`INVALID_ARGS`,`Flag ${t} requires a value.`);if(e.type===`string`)return{value:a,consumeNext:r===void 0};if(e.type===`enum`){if(!e.enumValues?.includes(a))throw new n(`INVALID_ARGS`,`Invalid ${at(t)}: ${a}`);return{value:a,consumeNext:r===void 0}}if(a.trim().length===0)throw new n(`INVALID_ARGS`,`Flag ${t} requires a value.`);let o=Number(a);if(!Number.isFinite(o)||typeof e.min==`number`&&o<e.min||typeof e.max==`number`&&o>e.max)throw new n(`INVALID_ARGS`,`Invalid ${at(t)}: ${a}`);return{value:e.type===`int`?Math.floor(o):o,consumeNext:r===void 0}}function at(e){return e.replace(/^-+/,``)}function ot(e){if(!e.startsWith(`-`)||e===`-`)return!1;let[t]=e.startsWith(`--`)?j(e):[e,void 0];return p(t)!==void 0}function st(e){let t=e.trim();return!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t)?!1:!!(t.startsWith(`./`)||t.startsWith(`../`)||t.startsWith(`~/`)||t.startsWith(`/`)||t.includes(`/`)||t.includes(`\\`))}function ct(e,t,n){if(!lt(n)||!e)return!1;let r=x(e);if(!r||r.allowsExtraPositionals)return!0;let i=r.positionalArgs??[];return i.length===0?!1:t.length<i.length||i.some(e=>e.includes(`?`))}function lt(e){return/^-\d+(\.\d+)?$/.test(e)}function ut(e){if(e.flags.help)return e;if(e.command===`snapshot`&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:`diff`,positionals:[`snapshot`,...e.positionals],flags:n,warnings:e.warnings}}return e}function dt(e,t){let n=x(e.command)?.explicitOnlyFlags;if(n===void 0)return;let r=new Set(e.providedFlags.map(e=>e.key));for(let e of n)r.has(e)||delete t[e]}function ft(e){let t=x(e.command)?.flagsByAction,n=e.positionals[0];if(t===void 0||n===void 0||!Object.hasOwn(t,n))return[];let r=t[n];if(r===void 0)return[];let i=new Set(Object.values(t).flat());return e.providedFlags.filter(e=>i.has(e.key)&&!r.includes(e.key))}function pt(e,t,n){return`${e} ${t} does not read ${n.map(e=>e.token).join(`, `)}. Run \`${e} ${t} --help\` for the options it reads.`}function mt(e,t){return e?t.length===1?`Flag ${t[0]} is not supported for command ${e}.`:`Flags ${t.join(`, `)} are not supported for command ${e}.`:t.length===1?`Flag ${t[0]} requires a command that supports it.`:`Flags ${t.join(`, `)} require a command that supports them.`}async function M(){let{buildUsageText:e}=await import(`./cli-help.js`).then(e=>e.n);return e()}async function ht(e){let{buildCommandUsageText:t}=await import(`./cli-help.js`).then(e=>e.n);return t(N(e))}function N(e){let t=Me(e);if(t)throw new n(`INVALID_ARGS`,t);return je(e)}function gt(){return{renderedToStderr:!1}}function _t(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function vt(e){return be(e)}const yt={connect:async()=>(await import(`./connection.js`)).connectCommand,disconnect:async()=>(await import(`./connection.js`)).disconnectCommand,connection:async()=>(await import(`./connection.js`)).connectionCommand,auth:async()=>(await import(`./auth.js`)).authCommand,plugins:async()=>(await import(`./plugins2.js`)).pluginsCommand,daemon:async()=>(await import(`./daemon.js`)).daemonCommand,device:async()=>(await import(`./device.js`)).deviceCommand,proxy:async()=>(await import(`./proxy.js`)).proxyCommand,takeover:async()=>(await import(`./takeover.js`)).takeoverCommand,replay:async()=>(await import(`./replay2.js`)).replayCommand,screenshot:async()=>(await import(`./screenshot3.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot3.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function bt(e){let t={...e.flags},n=yt[e.command];return n&&await(await n())({...e,flags:t})?!0:vt(e.command)?await xt({...e,command:e.command,flags:t}):!1}async function xt(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function St(e){return e===`android-instance`||e===`ios-instance`}function Ct(e){return[`exec`,`--yes`,`--package`,`agent-cdp@1.6.1`,`--`,`agent-cdp`,...e]}function wt(e){return e.some(e=>e===`--url`||e.startsWith(`--url=`))}function Tt(e){return e[0]===`target`&&(e[1]===`list`||e[1]===`select`)&&!wt(e)}function Et(e){let t=new URL(e);t.search=``,t.hash=``;let n=t.pathname.replace(/\/+$/,``);return t.pathname=n.endsWith(`/index.bundle`)?n.slice(0,-13)||`/`:n||`/`,t.toString().replace(/\/+$/,``)}function Dt(e){let t=e?.metroPublicBaseUrl?.trim();return t?Et(t):null}function Ot(e,t={}){if(!Tt(e)||!t.flags?.metroProxyBaseUrl||!St(t.flags.leaseBackend))return e;let r=Dt(t.flags);if(!r)throw new n(`INVALID_ARGS`,`cdp remote bridge target discovery requires a React Native dev-server public base URL.`,{hint:`Include metroPublicBaseUrl in the remote config so cdp can reach the local or tunneled Metro/Re.Pack CDP endpoint without bridge proxy authentication.`});return[...e,`--url`,r]}async function kt(e,t){let n=Ot(e,t);return(await oe(`npm`,Ct(n),{cwd:t.cwd,env:t.env,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode}const P=`${l} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,At=`${ge} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function jt(e){let t;try{t=JSON.parse(e)}catch{throw new n(`INVALID_ARGS`,`Batch steps must be valid JSON.`)}if(!Array.isArray(t)||t.length===0)throw new n(`INVALID_ARGS`,`Batch steps must be a non-empty JSON array.`);return t.map((e,t)=>Mt(e,t+1))}function Mt(e,t){let r=c(e,t,P),i=[`positionals`,`flags`].filter(e=>e in r);if(i.length>0){let e=i.map(e=>`"${e}"`).join(`, `);throw new n(`INVALID_ARGS`,`Batch step ${t} uses removed field(s): ${e}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:P})}ye(r,[`command`,`input`,`runtime`],`Batch step ${t}`,P);let a=u(r.runtime,t);return{command:he(r.command,t,At),input:s(r,t,P),...a===void 0?{}:{runtime:a}}}function Nt(e,t){let n=Pt(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function Pt(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??It(t.AGENT_DEVICE_PLATFORM),r=Rt(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:Ft(e.policyOverrides,t,r)}}function Ft(e,t,n){let r=e?.sessionLock??Lt(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function It(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t){if(t===`ios`||t===`android`||t===`apple`)return t;throw new n(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}function Lt(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t){if(t===`reject`||t===`strip`)return t;throw new n(`INVALID_ARGS`,`Invalid session lock mode: ${e}. Use reject or strip.`)}}function Rt(e){return typeof e==`string`&&e.trim().length>0}const zt=ve.map(e=>e.key);function F(e){let t={};for(let n of zt){let r=e[n];r!==void 0&&(t[n]=r)}return t}function Bt(e){return e.remoteConfig?{...F(De({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function Vt(e,t){let n=A(e),{env:r,cwd:i}=t,a=Ht(n.command)?Bt({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{},o=S(ke({command:n.command,cwd:i,cliFlags:n.flags,env:r}),a);return{...nt(n,{strictFlags:t?.strictFlags,defaultFlags:o}),providedFlags:n.providedFlags}}function Ht(e){return e!==null}function Ut(e){return I(ue(e),e.target,e.id)}function I(e,t,n){let i=r(e);return{platform:e,target:t,leaseBackend:i,identityFlag:i?de(e):void 0,id:n}}function Wt(e){return h(e)}function Gt(e){let t=ee(e);if(!(!t||!pe(t.platform)||!fe(t.target)))return I(t.platform,t.target,t.id)}function L(e){let t=[e.leaseBackend?a(e.leaseBackend):void 0,e.recordedPlatform].filter(e=>e!==void 0);if(t.some(e=>t.some(t=>le(e,t)))||le(e.requestedPlatform,t[0]??e.recordedPlatform))return{ok:!1,boundPlatform:t[0],requestedPlatform:e.requestedPlatform};let n=[...t,e.requestedPlatform].filter(e=>e!==void 0);return{ok:!0,platform:n.find(e=>e!==`apple`)??n[0]}}function Kt(e,t){return t!==void 0&&e.platform===void 0?!1:L({leaseBackend:e.leaseBackend,recordedPlatform:e.platform,requestedPlatform:t}).ok}function R(e){let t=V(e);if(!E.existsSync(t))return null;let n;try{n=JSON.parse(E.readFileSync(t,`utf8`))}catch(t){return an(e,t),null}return sn(n)?n:(an(e),null)}function qt(e){let t=V({stateDir:e.stateDir,session:e.state.session});E.mkdirSync(D.dirname(t),{recursive:!0}),nn(t,e.state),nn(H(e.stateDir),{session:e.state.session})}function Jt(e){return{baseUrl:rn(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function z(e){E.rmSync(V(e),{force:!0});let t=H(e.stateDir);$t(e.stateDir)===e.session&&E.rmSync(t,{force:!0})}function Yt(e){let t=e.validateRemoteConfigHash??!0,r=e.remoteConfig?Ee({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,i=R(e)??(e.allowActiveFallback?U({stateDir:e.stateDir}):null);if(!i||r&&i.remoteConfigPath!==r)return null;if(t&&B(i.remoteConfigPath)!==i.remoteConfigHash)throw new n(`INVALID_ARGS`,`Active remote connection config changed. Run agent-device connect --force to refresh it.`,{remoteConfig:i.remoteConfigPath});let a=tn(i,e),o=m(i);return{runtime:i.runtime,connection:te(o),flags:{...a,remoteConfig:i.remoteConfigPath,daemonBaseUrl:i.daemon?.baseUrl??a.daemonBaseUrl,daemonAuthToken:a.daemonAuthToken,daemonTransport:i.daemon?.transport??a.daemonTransport,daemonServerMode:i.daemon?.serverMode??a.daemonServerMode,...g(o),sessionIsolation:`tenant`,session:i.session,platform:i.platform??a.platform,target:i.target??a.target}}}function Xt(e){return te(m(e))}function Zt(e,t){return{leaseProvider:e.leaseProvider??t.leaseProvider,clientId:e.clientId??t.clientId,deviceKey:e.deviceKey??t.deviceKey}}function Qt(e,t){return!t||(t.leaseProvider===void 0||e.leaseProvider===t.leaseProvider)&&(t.clientId===void 0||e.clientId===t.clientId)}function B(e){try{return T.createHash(`sha256`).update(E.readFileSync(e)).digest(`hex`)}catch(t){throw new n(`INVALID_ARGS`,`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function V(e){return D.join(e.stateDir,`remote-connections`,`${on(e.session)}.json`)}function H(e){return D.join(e,`remote-connections`,`.active-session.json`)}function U(e){let t=$t(e.stateDir);return t?R({stateDir:e.stateDir,session:t}):null}function $t(e){let t=H(e);if(E.existsSync(t))try{let e=JSON.parse(E.readFileSync(t,`utf8`));return typeof e.session==`string`?e.session:void 0}catch{return}}function en(e){if(e)return T.createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function tn(e,t){try{return De({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(t.validateRemoteConfigHash===!1)return{};throw e}}function nn(e,t){re({destination:e,contents:`${JSON.stringify(t,null,2)}\n`,mode:384})}function rn(e){if(!e)return;let t=new URL(e);t.username=``,t.password=``;for(let e of Array.from(t.searchParams.keys()))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,``)}function an(e,t){b({level:`warn`,phase:`remote_connection_state_invalid`,data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),z(e)}function on(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`);return t?t===e?t:`${t}-${T.createHash(`sha256`).update(e).digest(`hex`).slice(0,8)}`:`default`}function sn(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return t.version===1&&cn(t,[`session`,`remoteConfigPath`,`remoteConfigHash`,`tenant`,`runId`,`connectedAt`,`updatedAt`])&&ln(t,[`leaseId`,`leaseBackend`,`leaseProvider`,`deviceKey`,`clientId`])&&un(t.daemon)}function cn(e,t){return t.every(t=>typeof e[t]==`string`)}function ln(e,t){return t.every(t=>e[t]===void 0||typeof e[t]==`string`)}function un(e){return e===void 0?!0:!e||typeof e!=`object`||Array.isArray(e)?!1:dn(e)}function dn(e){let t=e;return(t.baseUrl===void 0||typeof t.baseUrl==`string`)&&(t.authToken===void 0||typeof t.authToken==`string`)&&(t.transport===void 0||typeof t.transport==`string`)&&(t.serverMode===void 0||typeof t.serverMode==`string`)}async function fn(e,t){let r=await e.text(),i={};if(r.trim().length>0)try{i=JSON.parse(r)}catch(r){throw new n(`COMMAND_FAILED`,t.invalidJsonMessage,{status:e.status},r instanceof Error?r:void 0)}if(!e.ok)throw new n(`UNAUTHORIZED`,t.rejectedMessage,{status:e.status,response:i});return i}const pn=1e3;async function mn(e){return await hn({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:e.command===`connect`&&!e.flags.noLogin,env:e.env})}async function hn(e){let{env:t}=e;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:`none`};if(X(e.flags.daemonAuthToken))return{flags:e.flags,source:`flag`};if(X(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{flags:e.flags,source:`env`};if(!kn(e.flags.daemonBaseUrl,t))return{flags:e.flags,source:`none`};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(r)return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:`cli-session`};if(!e.allowInteractiveLogin)throw e.flags.noLogin?new n(`UNAUTHORIZED`,`Remote daemon authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`}):On(e.command,t);let i=await W({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:i.accessToken},source:`login`}}async function gn(e){let{env:t}=e;if(X(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:J(t)};if(X(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:t.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:J(t)};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(r)return{accessToken:r.accessToken,cloudBaseUrl:r.cloudBaseUrl};if(e.flags.noLogin)throw new n(`UNAUTHORIZED`,`Cloud connection profile authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`});let i=await W({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io,commandLabel:`agent-device connect`});return{accessToken:i.accessToken,cloudBaseUrl:i.session.cloudBaseUrl}}async function W(e){let{env:t}=e,r=Tn(t,e.io);if(r===`non-interactive`)throw On(e.commandLabel??`agent-device connect`,t);let i=J(t),a=await K({baseUrl:i,pathName:`/api/control-plane/device-auth/start`,body:{client:`agent-device`,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});await wn(a);let o=X(a.verificationUriComplete)?a.verificationUriComplete:a.verificationUri;if(r===`local-browser`)Y(e.io,`Opening ${a.verificationUri}...\n`),await jn(o,e.io);else{let t=An(a.verificationUri,a.userCode);Y(e.io,`Open this URL on your machine:\n${t}\n\nWaiting for approval for 10 minutes...\n`)}let s=await Cn({cloudBaseUrl:i,deviceCode:a.deviceCode,expiresIn:a.expiresIn,interval:a.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),c=s.cliSession?.refreshCredential??s.cliSession?.refreshToken;if(!X(s.accessToken)||!X(c))throw new n(`UNAUTHORIZED`,`Device authorization did not return CLI credentials.`);let l=new Date(e.io?.now?.()??Date.now()).toISOString(),u={version:1,id:s.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:i,workspaceId:s.cliSession?.workspaceId,accountId:s.cliSession?.accountId,name:s.cliSession?.name,refreshCredential:c,createdAt:l,expiresAt:s.cliSession?.expiresAt};return vn({stateDir:e.stateDir,session:u}),{accessToken:s.accessToken,expiresAt:s.expiresAt,session:u}}function _n(e){let t=G(e.stateDir);if(!E.existsSync(t))return null;try{let e=JSON.parse(E.readFileSync(t,`utf8`));return e.version!==1||!X(e.id)||!X(e.cloudBaseUrl)||!X(e.refreshCredential)||!X(e.createdAt)?null:e}catch{return null}}function vn(e){let t=G(e.stateDir);E.mkdirSync(D.dirname(t),{recursive:!0,mode:448}),E.writeFileSync(t,`${JSON.stringify(e.session,null,2)}\n`,{mode:384});try{E.chmodSync(t,384)}catch{}}function yn(e){let t=G(e.stateDir);return E.existsSync(t)?(E.rmSync(t,{force:!0}),!0):!1}function G(e){return D.join(e,`auth`,`cli-session.json`)}function bn(e){let t=_n({stateDir:e.stateDir});return t?{authenticated:!0,source:`cli-session`,sessionId:t.id,cloudBaseUrl:t.cloudBaseUrl,workspaceId:t.workspaceId,accountId:t.accountId,name:t.name,createdAt:t.createdAt,expiresAt:t.expiresAt,expired:Mn(t.expiresAt,e.now)}:{authenticated:!1,source:`none`}}async function xn(e){let t=_n({stateDir:e.stateDir});return!t||Mn(t.expiresAt,e.io?.now)?null:{accessToken:(await Sn({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:J(e.env,t.cloudBaseUrl)}}async function Sn(e){let t=await K({baseUrl:J(e.env,e.session.cloudBaseUrl),pathName:`/api/control-plane/cli-session/refresh`,body:{refreshCredential:e.session.refreshCredential,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});if(X(t.accessToken))return{accessToken:t.accessToken,expiresAt:t.expiresAt};throw t.status===`revoked`||t.error===`revoked`?new n(`UNAUTHORIZED`,`Stored cloud CLI session was revoked.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:t.status,error:t.error}):new n(`UNAUTHORIZED`,`Failed to refresh CLI session.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:t.status,error:t.error})}async function Cn(e){let t=e.now??Date.now,r=Math.min((e.expiresIn??600)*1e3,6e5),i=t()+r,a=Math.max(pn,(e.interval??5)*1e3);for(;t()<i;){let t=await K({baseUrl:e.cloudBaseUrl,pathName:`/api/control-plane/device-auth/poll`,body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if(t.status===`approved`||X(t.accessToken))return t;if(t.status===`slow_down`||t.error===`slow_down`)a+=pn;else if(t.status!==`authorization_pending`&&t.error!==`authorization_pending`)throw new n(`UNAUTHORIZED`,`Device authorization was not approved.`,{status:t.status,error:t.error});await Nn(a)}throw new n(`TIMEOUT`,`Device authorization expired before approval.`)}async function K(e){let t=await(e.fetchImpl??fetch)(new URL(e.pathName,e.baseUrl),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(e.body),signal:AbortSignal.timeout(15e3)});return await fn(t,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud auth endpoint rejected the request.`})}async function wn(e){if(!X(e.deviceCode))throw q(`deviceCode`);if(!X(e.userCode))throw q(`userCode`);if(!X(e.verificationUri))throw q(`verificationUri`);let{isSafeBrowserUrl:t}=await import(`./browser-launch.js`);if(!t(e.verificationUri))throw q(`verificationUri`);if(X(e.verificationUriComplete)&&!t(e.verificationUriComplete))throw q(`verificationUriComplete`)}function q(e){return new n(`COMMAND_FAILED`,`Cloud auth start returned an unusable response.`,{field:e})}function Tn(e,t){let n=t?.stdinIsTTY??process.stdin.isTTY,r=t?.stdoutIsTTY??process.stdout.isTTY;return En(e)||!n||!r?`non-interactive`:Dn(e)?`device-code`:`local-browser`}function En(e){return e.CI===`true`||e.GITHUB_ACTIONS===`true`||e.BUILDKITE===`true`}function Dn(e){return!!(e.SSH_TTY||e.SSH_CONNECTION||e.CODESPACES===`true`||e.GITPOD_WORKSPACE_ID||e.REMOTE_CONTAINERS===`true`)}function On(e,t){let r=J(t);return new n(`UNAUTHORIZED`,`${e} cannot perform interactive login in CI or a non-interactive shell.`,{hint:`Create a service/API token: ${new URL(`/api-keys`,r).toString()} Then set AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...`})}function J(e,t){let r=e.AGENT_DEVICE_CLOUD_BASE_URL??t??`https://cloud.agent-device.dev`;try{return new URL(r).toString().replace(/\/+$/,``)}catch(e){throw new n(`INVALID_ARGS`,`Invalid AGENT_DEVICE_CLOUD_BASE_URL.`,{cloudBaseUrl:r},e instanceof Error?e:void 0)}}function kn(e,t){if(t.AGENT_DEVICE_CLOUD_AUTH===`1`||t.AGENT_DEVICE_CLOUD_AUTH===`true`||X(t.AGENT_DEVICE_CLOUD_BASE_URL))return!0;try{let t=new URL(e).hostname.toLowerCase();return t===`agent-device.dev`||t.endsWith(`.agent-device.dev`)}catch{return!1}}function An(e,t){let n=new URL(e);return n.searchParams.set(`user_code`,t),n.toString()}async function jn(e,t){if(t?.openBrowser){await t.openBrowser(e);return}let{openUrlInBrowser:n}=await import(`./browser-launch.js`);await n(e)||Y(t,`Open this URL on your machine:\n${e}\n`)}function Y(e,t){(e?.stderr??process.stderr).write(t)}function Mn(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function X(e){return typeof e==`string`&&e.trim().length>0}async function Nn(e){await new Promise(t=>setTimeout(t,e))}var Pn=e({runCli:()=>$});const Z=(e,t={})=>import(`./error.js`).then(e=>e.t).then(({printHumanError:n})=>n(e,t)),Q=e=>import(`./json.js`).then(({printJson:t})=>t(e)),Fn={sendToDaemon:Se({onReplaced:In}),transportForHost:e=>Se({host:e,onReplaced:In})};function In(e){let{stateDir:t,previous:n,reason:r}=e,i=n.version?`pid ${n.pid}, v${n.version}`:`pid ${n.pid}`;process.stderr.write(r===`unreachable`?`Replaced unreachable daemon (${i}) in ${t}.\n`:`Replaced idle daemon (${i}) in ${t}: it did not match this client.\n`)}const Ln=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),Rn=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function $(e,t=Fn,n=ne(process)){await ae({host:n,requestEnv:void 0},async()=>await zn(e,t,n))}async function zn(e,t,n){let r=xe(t,n),i=ie(),a=we(),o=$n(e),s=e.includes(`--json`),c=gr(e)??n.env.AGENT_DEVICE_SESSION??`default`;await ce({session:c,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:c,positionals:l}=await Vn(e,{host:n,version:a,jsonRequested:s,debugEnabled:o}),u=nr(c,t.providedFlags),d=await Hn(t,{host:n,command:c,positionals:l,requestId:i,debugOutputEnabled:u});Bn(d.effectiveFlags);let f=null;try{if(c===`react-devtools`){await w(await Un(d));return}if(c===`web`){let{runWebCommand:e}=await import(`./web.js`);await w(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(Ae({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await Wn(d,r),Bn(d.effectiveFlags),c===`cdp`){await w(await kt(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=Kn(d);let e=await qn(d),t=gt();await Jn(d,me(Gn(d),{host:d.host,transport:fr({host:n,command:c,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await Yn(e,d,f)}finally{f&&f()}})}function Bn(e){e.daemonAuthToken&&se(e.daemonAuthToken)}async function Vn(e,t){let r;try{r=Vt(e,{cwd:t.host.cwd,env:t.host.env})}catch(e){b({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let n=i(e,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});return t.jsonRequested?await Q({success:!1,error:n}):await Z(n,{showDetails:t.debugEnabled}),w(1)}for(let e of r.warnings)process.stderr.write(`Warning: ${e}\n`);if(r.flags.version)return process.stdout.write(`${t.version}\n`),w(0);let a=r.command===`help`,o=r.flags.help;if(a||o){if(a&&r.positionals.length>1)return await Z(new n(`INVALID_ARGS`,`help accepts at most one command.`)),w(1);let e=a?r.positionals[0]:r.command;if(!e)return process.stdout.write(`${await M()}\n`),w(0);let t=await ht(e);return t?(process.stdout.write(t),w(0)):(await Z(new n(`INVALID_ARGS`,er(e))),process.stdout.write(`${await M()}\n`),w(1))}return r.command?{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await M()}\n`),w(1))}async function Hn(e,n){let r=new Set(e.providedFlags.map(e=>e.key));try{let t=Pt({env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=t.lockPolicy?{...e.flags}:Nt(e.flags,{env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),a=Te(i.stateDir,{env:n.host.env,cwd:n.host.cwd}),o=i.session??`default`,s=ar({host:n.host,command:n.command,explicitFlagKeys:r,stateDir:a.baseDir,session:o,remoteConfig:i.remoteConfig,hasResolvedSession:i.session!==void 0}),c=s?ur(i,s.flags,r):i;return{...n,binding:t,flags:i,daemonPaths:a,sessionName:o,connectionDefaults:s,explicitFlagKeys:r,effectiveFlags:c,resolvedRuntime:s?.runtime,connectionMetadata:s?.connection,parsedBatchSteps:void 0}}catch(r){let a=t(r),o=i(a,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});return e.flags.json?await Q({success:!1,error:o}):await Z(o,{showDetails:n.debugOutputEnabled}),w(1)}}async function Un(e){let{runReactDevtoolsCommand:t}=await import(`./react-devtools.js`);return await t(e.positionals,{flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,session:e.effectiveFlags.session??e.sessionName})}async function Wn(e,t){if(e.command===`batch`){if(e.positionals.length>0)throw new n(`INVALID_ARGS`,`batch does not accept positional arguments.`);e.parsedBatchSteps=rr(e.flags)}if(sr(e.command)&&(e.effectiveFlags=(await mn({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&or(e.command)){let n=me(Gn(e),{host:e.host,transport:mr(t)}),{materializeRemoteConnectionForCommand:r}=await import(`./connection-runtime.js`),i=await r({host:e.host,command:e.command,flags:e.effectiveFlags,client:n,runtime:e.resolvedRuntime,positionals:e.positionals,batchSteps:e.parsedBatchSteps,forceRuntimePrepare:dr(e.explicitFlagKeys)});e.effectiveFlags=i.flags,e.resolvedRuntime=i.runtime,e.connectionMetadata=i.connection}cr({command:e.command,flags:e.effectiveFlags,runtime:e.resolvedRuntime,explicitFlagKeys:e.explicitFlagKeys,hadConnectionDefaults:!!e.connectionDefaults})&&process.stderr.write(`Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.
2
- `)}function Gn(e){let t=e.effectiveFlags,n=e.connectionMetadata;return{session:t.session,requestId:e.requestId,stateDir:t.stateDir,daemonBaseUrl:t.daemonBaseUrl,daemonAuthToken:t.daemonAuthToken,daemonTransport:t.daemonTransport,daemonServerMode:t.daemonServerMode,tenant:t.tenant,sessionIsolation:t.sessionIsolation,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:n?.leaseProvider,clientId:n?.clientId,deviceKey:n?.deviceKey,providerApp:t.providerApp,providerOsVersion:t.providerOsVersion,providerDeviceType:t.providerDeviceType,providerProject:t.providerProject,providerBuild:t.providerBuild,providerSessionName:t.providerSessionName,providerDeviceOrientation:t.providerDeviceOrientation,providerGeoLocation:t.providerGeoLocation,providerTimezone:t.providerTimezone,providerAppiumVersion:t.providerAppiumVersion,providerLanguage:t.providerLanguage,providerLocale:t.providerLocale,providerNetworkProfile:t.providerNetworkProfile,providerCustomNetwork:t.providerCustomNetwork,providerNoResignApp:t.providerNoResignApp,awsProjectArn:t.awsProjectArn,awsDeviceArn:t.awsDeviceArn,awsAppArn:t.awsAppArn,awsRegion:t.awsRegion,awsInteractionMode:t.awsInteractionMode,runtime:e.resolvedRuntime,lockPolicy:e.binding.lockPolicy,lockPlatform:e.binding.defaultPlatform,cwd:e.host.cwd,debug:e.debugOutputEnabled,cost:t.cost,responseLevel:t.responseLevel}}function Kn(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?_r(e.daemonPaths.logPath):null}async function qn(e){if(e.command!==`test`)return;let{createReplayTestReporterRuntime:t}=await import(`./reporting.js`);return t({debug:e.debugOutputEnabled,verbose:e.effectiveFlags.verbose,json:e.effectiveFlags.json,reporter:e.effectiveFlags.reporter,reportJunit:e.effectiveFlags.reportJunit})}async function Jn(e,t,r,i){let{command:a,positionals:o,effectiveFlags:s}=e;if(a===`batch`){if(!e.parsedBatchSteps)throw new n(`INVALID_ARGS`,`batch requires --steps or --steps-file.`);let c=e.parsedBatchSteps.map((t,n)=>({...t,input:e.binding.lockPolicy&&e.flags.platform===void 0?{...t.input}:Nt(t.input,{env:e.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await bt({host:e.host,command:a,positionals:o,flags:{...s,batchSteps:c},client:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new n(`INVALID_ARGS`,`runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.`);else if(await bt({host:e.host,command:a,positionals:o,flags:s,client:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return;throw new n(`INVALID_ARGS`,tr(a))}async function Yn(e,n,r){let a=t(e),o=i(a,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});if(n.command===`close`&&ir(a)){n.effectiveFlags.json&&await Q({success:!0,data:{closed:`session`,source:`no-daemon`}});return}n.effectiveFlags.json?await Q({success:!1,error:o}):(await Z(o,{showDetails:n.debugOutputEnabled}),n.debugOutputEnabled&&Zn(n,o)),r&&r(),await w(1)}const Xn=64e3;function Zn(e,t){if(!e.effectiveFlags.daemonBaseUrl){Qn(`daemon log`,e.daemonPaths.logPath);return}let n=t.diagnosticsRecord;n&&Qn(`remote diagnostics`,Ce(e.daemonPaths.baseDir,n))}function Qn(e,t){try{if(E.existsSync(t)){let n=E.readFileSync(t,`utf8`).split(`
1
+ import{r as e}from"./rolldown-runtime.js";import{R as t,V as n,d as r,m as i,tt as a}from"./sdk-contracts.js";import{vt as o}from"./tv-remote.js";import{d as s,f as c,s as l,u}from"./sdk-batch-runner.js";import{D as d,O as f,b as p,ht as m,pt as h,vt as g,wt as ee,x as _,yt as te}from"./back-mode.js";import{Ct as ne,_t as v,bt as re,dt as ie,f as ae,gt as oe,nt as se,st as ce,vt as y,yt as b}from"./sdk-io.js";import"./diagnostics.js";import{F as le,I as ue,k as de,u as fe,x as pe}from"./sdk-device.js";import{n as me}from"./agent-device-client.js";import{s as he,t as ge,u as _e}from"./sdk-batch.js";import{t as ve}from"./sdk-remote-config.js";import{G as ye,n as be}from"./command-metadata.js";import"./file.js";import"./command.js";import{i as xe,n as Se}from"./daemon-client.js";import{n as Ce}from"./session-artifact-paths.js";import{a as we}from"./version.js";import{m as Te}from"./daemon-resolution.js";import{n as Ee,r as De}from"./remote-config-core.js";import{r as x,t as Oe}from"./command-schema.js";import{n as S,r as C,t as ke}from"./cli-config.js";import{t as Ae}from"./update-check.js";import{n as je,r as Me,t as Ne}from"./cli-command-aliases.js";import{exitAfterFlush as w}from"./process-exit.js";import T from"node:crypto";import E from"node:fs";import D from"node:path";import{pathToFileURL as Pe}from"node:url";const O=`open <app> --relaunch`,Fe={start:{command:`open`,example:O},restart:{command:`open`,example:O},touch:{command:`press`,example:`press`},input:{command:`fill`,example:`fill`},settext:{command:`fill`,example:`fill`},entertext:{command:`fill`,example:`fill`},screencap:{command:`screenshot`,example:`screenshot`},capture:{command:`screenshot`,example:`screenshot`},dismiss:{command:`keyboard`,example:`keyboard dismiss`},"get-text":{command:`get`,example:`get text`},gettext:{command:`get`,example:`get text`},get_text:{command:`get`,example:`get text`},"open-url":{command:`open`,example:`open <url>`},"close-session":{command:`close`,example:`close`}};function Ie(e){if(e.length<=2)return[];let t=f(),n=t.filter(t=>t.startsWith(e));return n.length>0?n.sort(Le).slice(0,3):Re(e,t)}function Le(e,t){return e.length-t.length||e.localeCompare(t)}function Re(e,t){let n=t.map(t=>({name:t,distance:Be(e,t)})).filter(t=>t.distance<=ze(e));if(n.length===0)return[];let r=Math.min(...n.map(e=>e.distance));return n.filter(e=>e.distance===r).sort((e,t)=>e.name.localeCompare(t.name)).slice(0,3).map(e=>e.name)}function ze(e){return e.length<4?1:e.length<=6?2:3}function Be(e,t){return e===t?0:e.startsWith(t)||t.startsWith(e)?Math.abs(e.length-t.length):Ve(e,t)}function Ve(e,t){let n=e.length+1,r=t.length+1,i=Array.from({length:n},()=>Array(r).fill(0));for(let e=0;e<n;e+=1)i[e][0]=e;for(let e=0;e<r;e+=1)i[0][e]=e;for(let a=1;a<n;a+=1)for(let n=1;n<r;n+=1){let r=e[a-1]===t[n-1]?0:1;i[a][n]=Math.min(i[a-1][n]+1,i[a][n-1]+1,i[a-1][n-1]+r)}return i[n-1][r-1]}function He(e){let t=e.toLowerCase(),n=Fe[t]?.example;if(n)return n;let r=Ie(t);if(r.length!==0)return r.length===1?r[0]:`one of: ${r.join(`, `)}`}const Ue=new Set([`--bundle-id`,`--bundleid`,`--bundle`,`--package`,`--package-name`,`--packagename`,`--app-id`,`--appid`,`--pkg`]),We=new Set([`--session-locked`,`--session-lock-conflicts`]),Ge={"--output":`--out`,"--path":`--out`};function Ke(e,t){let n=e.toLowerCase(),r=Ge[n];if(r&&qe(r,t))return r;let i=Je(n,t);if(i.length!==0)return i.length===1?i[0]:`one of: ${i.join(`, `)}`}function qe(e,t){let n=_().find(t=>t.names.includes(e));return n?C(n.key,t):!1}function Je(e,t){let n=k(e);if(n.length<=2)return[];let r=Ye(t),i=r.filter(e=>k(e).startsWith(n));return i.length>0?i.sort(Le).slice(0,3):Re(n,r.map(e=>k(e))).map(e=>`--${e}`)}function Ye(e){let t=new Set;for(let n of _()){if(!C(n.key,e))continue;let r=n.names[0];r&&t.add(r)}return[...t]}function k(e){return e.replace(/^--?/,``)}function Xe(e,t){let n=e.toLowerCase();if(Ue.has(n))return`Unknown flag: ${e}. The app or bundle id is a positional argument, e.g. ${O}.`;if(We.has(n))return`Unknown flag: ${e}. Use --session-lock reject|strip instead.`;if(n===o.cliToken)return`Unknown flag: ${e}. ${o.migration.screenshot}. ${o.migration.record}.`;let r=Ke(e,t);return r?`Unknown flag: ${e}. Did you mean ${r}?`:`Unknown flag: ${e}`}function A(e){let n={json:!1,help:!1,version:!1},r=null,i=null,a=[],o=[],s=[],c=!0;for(let o=0;o<e.length;o+=1){let l=e[o];if(c&&l===`--`){c=!1;continue}if(!c){r?a.push(l):(i=l,r=N(l));continue}if(et(r)){a.push(l);continue}let u=l.startsWith(`--`),d=l.startsWith(`-`)&&l.length>1;if(!u&&!d){r?a.push(l):(i=l,r=N(l));continue}let[f,p]=u?j(l):[l,void 0];if(Qe(r,f))continue;let m=tt(f,r);if($e(r,m)){a.push(l);continue}if(!m){if(ct(r,a,l)){r?a.push(l):r=l;continue}throw new t(`INVALID_ARGS`,Xe(f,r))}let h=it(m,f,p,e[o+1]);h.consumeNext&&(o+=1);let g=n[m.key];if(m.multiple){let e=Array.isArray(g)?[...g,h.value]:g===void 0?[h.value]:[g,h.value];n[m.key]=e}else n[m.key]=h.value;s.push({key:m.key,token:f})}return Ze(i,n),{command:r,positionals:a,flags:n,warnings:o,providedFlags:s}}function Ze(e,t){if(e)for(let n of Ne(e)?.impliedFlags??[])t[n]=!0}function Qe(e,t){return t===`-c`&&(e===`snapshot`||e===`diff`)}function $e(e,t){return e===`react-devtools`?!t||!C(t.key,e):!1}function et(e){return e===`cdp`}function tt(e,t){let n=_().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??p(e);if(t){let e=n.find(e=>C(e.key,t));if(e)return e}return p(e)}function nt(e,n){let r=n?.strictFlags??!0,i=[...e.warnings],a=S({json:!1,help:!1,version:!1},n?.defaultFlags??{});if(S(a,e.flags),e.command&&!d(e.command)&&!a.help){let n=He(e.command),r=n?`Unknown command: ${e.command}. Did you mean ${n}?`:`Unknown command: ${e.command}`;throw new t(`INVALID_ARGS`,r)}let o=e.providedFlags.filter(t=>!C(t.key,e.command));if(o.length>0){let n=o.map(e=>e.token),s=mt(e.command,n);if(r)throw new t(`INVALID_ARGS`,s);i.push(s);for(let e of o)delete a[e.key]}let s=ft(e);if(s.length>0){let n=pt(e.command,e.positionals[0],s);if(r)throw new t(`INVALID_ARGS`,n);i.push(n);for(let e of s)delete a[e.key]}for(let t of Object.keys(a))a[t]!==void 0&&(C(t,e.command)||delete a[t]);dt(e,a),rt(e),_e(e.command,a);let c=ut({command:e.command,positionals:e.positionals,flags:a,warnings:i});if(Oe(c.command,c.positionals),c.command===`batch`&&+!!a.steps+ +!!a.stepsFile!=1)throw new t(`INVALID_ARGS`,`batch requires exactly one step source: --steps or --steps-file.`);return c}function rt(e){if(e.command!==`back`)return;let n=e.providedFlags.filter(e=>e.key===`backMode`);if(!(new Set(n.map(e=>e.token)).size<=1))throw new t(`INVALID_ARGS`,`back accepts only one explicit mode flag: use either --in-app or --system.`)}function j(e){let t=e.indexOf(`=`);return t===-1?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function it(e,n,r,i){if(e.setValue!==void 0){if(r!==void 0)throw new t(`INVALID_ARGS`,`Flag ${n} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if(e.type===`boolean`){if(r!==void 0)throw new t(`INVALID_ARGS`,`Flag ${n} does not take a value.`);return{value:!0,consumeNext:!1}}if(e.type===`booleanOrString`){if(r!==void 0){if(r.trim().length===0)throw new t(`INVALID_ARGS`,`Flag ${n} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return i===void 0||ot(i)?{value:!0,consumeNext:!1}:st(i)?{value:i,consumeNext:!0}:{value:!0,consumeNext:!1}}let a=r??i;if(a===void 0||r===void 0&&ot(a))throw new t(`INVALID_ARGS`,`Flag ${n} requires a value.`);if(e.type===`string`)return{value:a,consumeNext:r===void 0};if(e.type===`enum`){if(!e.enumValues?.includes(a))throw new t(`INVALID_ARGS`,`Invalid ${at(n)}: ${a}`);return{value:a,consumeNext:r===void 0}}if(a.trim().length===0)throw new t(`INVALID_ARGS`,`Flag ${n} requires a value.`);let o=Number(a);if(!Number.isFinite(o)||typeof e.min==`number`&&o<e.min||typeof e.max==`number`&&o>e.max)throw new t(`INVALID_ARGS`,`Invalid ${at(n)}: ${a}`);return{value:e.type===`int`?Math.floor(o):o,consumeNext:r===void 0}}function at(e){return e.replace(/^-+/,``)}function ot(e){if(!e.startsWith(`-`)||e===`-`)return!1;let[t]=e.startsWith(`--`)?j(e):[e,void 0];return p(t)!==void 0}function st(e){let t=e.trim();return!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t)?!1:!!(t.startsWith(`./`)||t.startsWith(`../`)||t.startsWith(`~/`)||t.startsWith(`/`)||t.includes(`/`)||t.includes(`\\`))}function ct(e,t,n){if(!lt(n)||!e)return!1;let r=x(e);if(!r||r.allowsExtraPositionals)return!0;let i=r.positionalArgs??[];return i.length===0?!1:t.length<i.length||i.some(e=>e.includes(`?`))}function lt(e){return/^-\d+(\.\d+)?$/.test(e)}function ut(e){if(e.flags.help)return e;if(e.command===`snapshot`&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:`diff`,positionals:[`snapshot`,...e.positionals],flags:n,warnings:e.warnings}}return e}function dt(e,t){let n=x(e.command)?.explicitOnlyFlags;if(n===void 0)return;let r=new Set(e.providedFlags.map(e=>e.key));for(let e of n)r.has(e)||delete t[e]}function ft(e){let t=x(e.command)?.flagsByAction,n=e.positionals[0];if(t===void 0||n===void 0||!Object.hasOwn(t,n))return[];let r=t[n];if(r===void 0)return[];let i=new Set(Object.values(t).flat());return e.providedFlags.filter(e=>i.has(e.key)&&!r.includes(e.key))}function pt(e,t,n){return`${e} ${t} does not read ${n.map(e=>e.token).join(`, `)}. Run \`${e} ${t} --help\` for the options it reads.`}function mt(e,t){return e?t.length===1?`Flag ${t[0]} is not supported for command ${e}.`:`Flags ${t.join(`, `)} are not supported for command ${e}.`:t.length===1?`Flag ${t[0]} requires a command that supports it.`:`Flags ${t.join(`, `)} require a command that supports them.`}async function M(){let{buildUsageText:e}=await import(`./cli-help.js`).then(e=>e.n);return e()}async function ht(e){let{buildCommandUsageText:t}=await import(`./cli-help.js`).then(e=>e.n);return t(N(e))}function N(e){let n=Me(e);if(n)throw new t(`INVALID_ARGS`,n);return je(e)}function gt(){return{renderedToStderr:!1}}function _t(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function vt(e){return be(e)}const yt={connect:async()=>(await import(`./connection.js`)).connectCommand,disconnect:async()=>(await import(`./connection.js`)).disconnectCommand,connection:async()=>(await import(`./connection.js`)).connectionCommand,auth:async()=>(await import(`./auth.js`)).authCommand,plugins:async()=>(await import(`./plugins2.js`)).pluginsCommand,daemon:async()=>(await import(`./daemon.js`)).daemonCommand,device:async()=>(await import(`./device.js`)).deviceCommand,proxy:async()=>(await import(`./proxy.js`)).proxyCommand,takeover:async()=>(await import(`./takeover.js`)).takeoverCommand,replay:async()=>(await import(`./replay2.js`)).replayCommand,screenshot:async()=>(await import(`./screenshot3.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot3.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function bt(e){let t={...e.flags},n=yt[e.command];return n&&await(await n())({...e,flags:t})?!0:vt(e.command)?await xt({...e,command:e.command,flags:t}):!1}async function xt(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function St(e){return e===`android-instance`||e===`ios-instance`}function Ct(e){return[`exec`,`--yes`,`--package`,`agent-cdp@1.6.1`,`--`,`agent-cdp`,...e]}function wt(e){return e.some(e=>e===`--url`||e.startsWith(`--url=`))}function Tt(e){return e[0]===`target`&&(e[1]===`list`||e[1]===`select`)&&!wt(e)}function Et(e){let t=new URL(e);t.search=``,t.hash=``;let n=t.pathname.replace(/\/+$/,``);return t.pathname=n.endsWith(`/index.bundle`)?n.slice(0,-13)||`/`:n||`/`,t.toString().replace(/\/+$/,``)}function Dt(e){let t=e?.metroPublicBaseUrl?.trim();return t?Et(t):null}function Ot(e,n={}){if(!Tt(e)||!n.flags?.metroProxyBaseUrl||!St(n.flags.leaseBackend))return e;let r=Dt(n.flags);if(!r)throw new t(`INVALID_ARGS`,`cdp remote bridge target discovery requires a React Native dev-server public base URL.`,{hint:`Include metroPublicBaseUrl in the remote config so cdp can reach the local or tunneled Metro/Re.Pack CDP endpoint without bridge proxy authentication.`});return[...e,`--url`,r]}async function kt(e,t){let n=Ot(e,t);return(await se(`npm`,Ct(n),{cwd:t.cwd,env:t.env,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode}const P=`${l} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,At=`${ge} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function jt(e){let n;try{n=JSON.parse(e)}catch{throw new t(`INVALID_ARGS`,`Batch steps must be valid JSON.`)}if(!Array.isArray(n)||n.length===0)throw new t(`INVALID_ARGS`,`Batch steps must be a non-empty JSON array.`);return n.map((e,t)=>Mt(e,t+1))}function Mt(e,n){let r=c(e,n,P),i=[`positionals`,`flags`].filter(e=>e in r);if(i.length>0){let e=i.map(e=>`"${e}"`).join(`, `);throw new t(`INVALID_ARGS`,`Batch step ${n} uses removed field(s): ${e}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:P})}ye(r,[`command`,`input`,`runtime`],`Batch step ${n}`,P);let a=u(r.runtime,n);return{command:he(r.command,n,At),input:s(r,n,P),...a===void 0?{}:{runtime:a}}}function Nt(e,t){let n=Pt(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function Pt(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??It(t.AGENT_DEVICE_PLATFORM),r=Rt(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:Ft(e.policyOverrides,t,r)}}function Ft(e,t,n){let r=e?.sessionLock??Lt(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function It(e){if(e===void 0)return;let n=e.trim().toLowerCase();if(n){if(n===`ios`||n===`android`||n===`apple`)return n;throw new t(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}function Lt(e){if(e===void 0)return;let n=e.trim().toLowerCase();if(n){if(n===`reject`||n===`strip`)return n;throw new t(`INVALID_ARGS`,`Invalid session lock mode: ${e}. Use reject or strip.`)}}function Rt(e){return typeof e==`string`&&e.trim().length>0}const zt=ve.map(e=>e.key);function F(e){let t={};for(let n of zt){let r=e[n];r!==void 0&&(t[n]=r)}return t}function Bt(e){return e.remoteConfig?{...F(De({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function Vt(e,t){let n=A(e),{env:r,cwd:i}=t,a=Ht(n.command)?Bt({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{},o=S(ke({command:n.command,cwd:i,cliFlags:n.flags,env:r}),a);return{...nt(n,{strictFlags:t?.strictFlags,defaultFlags:o}),providedFlags:n.providedFlags}}function Ht(e){return e!==null}function Ut(e){return I(ue(e),e.target,e.id)}function I(e,t,n){let i=r(e);return{platform:e,target:t,leaseBackend:i,identityFlag:i?fe(e):void 0,id:n}}function Wt(e){return h(e)}function Gt(e){let t=ee(e);if(!(!t||!de(t.platform)||!pe(t.target)))return I(t.platform,t.target,t.id)}function L(e){let t=[e.leaseBackend?i(e.leaseBackend):void 0,e.recordedPlatform].filter(e=>e!==void 0);if(t.some(e=>t.some(t=>le(e,t)))||le(e.requestedPlatform,t[0]??e.recordedPlatform))return{ok:!1,boundPlatform:t[0],requestedPlatform:e.requestedPlatform};let n=[...t,e.requestedPlatform].filter(e=>e!==void 0);return{ok:!0,platform:n.find(e=>e!==`apple`)??n[0]}}function Kt(e,t){return t!==void 0&&e.platform===void 0?!1:L({leaseBackend:e.leaseBackend,recordedPlatform:e.platform,requestedPlatform:t}).ok}function R(e){let t=V(e);if(!E.existsSync(t))return null;let n;try{n=JSON.parse(E.readFileSync(t,`utf8`))}catch(t){return an(e,t),null}return sn(n)?n:(an(e),null)}function qt(e){let t=V({stateDir:e.stateDir,session:e.state.session});E.mkdirSync(D.dirname(t),{recursive:!0}),nn(t,e.state),nn(H(e.stateDir),{session:e.state.session})}function Jt(e){return{baseUrl:rn(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function z(e){E.rmSync(V(e),{force:!0});let t=H(e.stateDir);$t(e.stateDir)===e.session&&E.rmSync(t,{force:!0})}function Yt(e){let n=e.validateRemoteConfigHash??!0,r=e.remoteConfig?Ee({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,i=R(e)??(e.allowActiveFallback?U({stateDir:e.stateDir}):null);if(!i||r&&i.remoteConfigPath!==r)return null;if(n&&B(i.remoteConfigPath)!==i.remoteConfigHash)throw new t(`INVALID_ARGS`,`Active remote connection config changed. Run agent-device connect --force to refresh it.`,{remoteConfig:i.remoteConfigPath});let a=tn(i,e),o=m(i);return{runtime:i.runtime,connection:te(o),flags:{...a,remoteConfig:i.remoteConfigPath,daemonBaseUrl:i.daemon?.baseUrl??a.daemonBaseUrl,daemonAuthToken:a.daemonAuthToken,daemonTransport:i.daemon?.transport??a.daemonTransport,daemonServerMode:i.daemon?.serverMode??a.daemonServerMode,...g(o),sessionIsolation:`tenant`,session:i.session,platform:i.platform??a.platform,target:i.target??a.target}}}function Xt(e){return te(m(e))}function Zt(e,t){return{leaseProvider:e.leaseProvider??t.leaseProvider,clientId:e.clientId??t.clientId,deviceKey:e.deviceKey??t.deviceKey}}function Qt(e,t){return!t||(t.leaseProvider===void 0||e.leaseProvider===t.leaseProvider)&&(t.clientId===void 0||e.clientId===t.clientId)}function B(e){try{return T.createHash(`sha256`).update(E.readFileSync(e)).digest(`hex`)}catch(n){throw new t(`INVALID_ARGS`,`Remote config file not found: ${e}`,{cause:n instanceof Error?n.message:String(n)})}}function V(e){return D.join(e.stateDir,`remote-connections`,`${on(e.session)}.json`)}function H(e){return D.join(e,`remote-connections`,`.active-session.json`)}function U(e){let t=$t(e.stateDir);return t?R({stateDir:e.stateDir,session:t}):null}function $t(e){let t=H(e);if(E.existsSync(t))try{let e=JSON.parse(E.readFileSync(t,`utf8`));return typeof e.session==`string`?e.session:void 0}catch{return}}function en(e){if(e)return T.createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function tn(e,t){try{return De({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(t.validateRemoteConfigHash===!1)return{};throw e}}function nn(e,t){ie({destination:e,contents:`${JSON.stringify(t,null,2)}\n`,mode:384})}function rn(e){if(!e)return;let t=new URL(e);t.username=``,t.password=``;for(let e of Array.from(t.searchParams.keys()))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,``)}function an(e,t){v({level:`warn`,phase:`remote_connection_state_invalid`,data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),z(e)}function on(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`);return t?t===e?t:`${t}-${T.createHash(`sha256`).update(e).digest(`hex`).slice(0,8)}`:`default`}function sn(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return t.version===1&&cn(t,[`session`,`remoteConfigPath`,`remoteConfigHash`,`tenant`,`runId`,`connectedAt`,`updatedAt`])&&ln(t,[`leaseId`,`leaseBackend`,`leaseProvider`,`deviceKey`,`clientId`])&&un(t.daemon)}function cn(e,t){return t.every(t=>typeof e[t]==`string`)}function ln(e,t){return t.every(t=>e[t]===void 0||typeof e[t]==`string`)}function un(e){return e===void 0?!0:!e||typeof e!=`object`||Array.isArray(e)?!1:dn(e)}function dn(e){let t=e;return(t.baseUrl===void 0||typeof t.baseUrl==`string`)&&(t.authToken===void 0||typeof t.authToken==`string`)&&(t.transport===void 0||typeof t.transport==`string`)&&(t.serverMode===void 0||typeof t.serverMode==`string`)}async function fn(e,n){let r=await e.text(),i={};if(r.trim().length>0)try{i=JSON.parse(r)}catch(r){throw new t(`COMMAND_FAILED`,n.invalidJsonMessage,{status:e.status},r instanceof Error?r:void 0)}if(!e.ok)throw new t(`UNAUTHORIZED`,n.rejectedMessage,{status:e.status,response:i});return i}const pn=1e3;async function mn(e){return await hn({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:e.command===`connect`&&!e.flags.noLogin,env:e.env})}async function hn(e){let{env:n}=e;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:`none`};if(X(e.flags.daemonAuthToken))return{flags:e.flags,source:`flag`};if(X(n.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{flags:e.flags,source:`env`};if(!kn(e.flags.daemonBaseUrl,n))return{flags:e.flags,source:`none`};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});if(r)return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:`cli-session`};if(!e.allowInteractiveLogin)throw e.flags.noLogin?new t(`UNAUTHORIZED`,`Remote daemon authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`}):On(e.command,n);let i=await W({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});return{flags:{...e.flags,daemonAuthToken:i.accessToken},source:`login`}}async function gn(e){let{env:n}=e;if(X(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:J(n)};if(X(n.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:n.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:J(n)};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});if(r)return{accessToken:r.accessToken,cloudBaseUrl:r.cloudBaseUrl};if(e.flags.noLogin)throw new t(`UNAUTHORIZED`,`Cloud connection profile authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`});let i=await W({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io,commandLabel:`agent-device connect`});return{accessToken:i.accessToken,cloudBaseUrl:i.session.cloudBaseUrl}}async function W(e){let{env:n}=e,r=Tn(n,e.io);if(r===`non-interactive`)throw On(e.commandLabel??`agent-device connect`,n);let i=J(n),a=await K({baseUrl:i,pathName:`/api/control-plane/device-auth/start`,body:{client:`agent-device`,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});await wn(a);let o=X(a.verificationUriComplete)?a.verificationUriComplete:a.verificationUri;if(r===`local-browser`)Y(e.io,`Opening ${a.verificationUri}...\n`),await jn(o,e.io);else{let t=An(a.verificationUri,a.userCode);Y(e.io,`Open this URL on your machine:\n${t}\n\nWaiting for approval for 10 minutes...\n`)}let s=await Cn({cloudBaseUrl:i,deviceCode:a.deviceCode,expiresIn:a.expiresIn,interval:a.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),c=s.cliSession?.refreshCredential??s.cliSession?.refreshToken;if(!X(s.accessToken)||!X(c))throw new t(`UNAUTHORIZED`,`Device authorization did not return CLI credentials.`);let l=new Date(e.io?.now?.()??Date.now()).toISOString(),u={version:1,id:s.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:i,workspaceId:s.cliSession?.workspaceId,accountId:s.cliSession?.accountId,name:s.cliSession?.name,refreshCredential:c,createdAt:l,expiresAt:s.cliSession?.expiresAt};return vn({stateDir:e.stateDir,session:u}),{accessToken:s.accessToken,expiresAt:s.expiresAt,session:u}}function _n(e){let t=G(e.stateDir);if(!E.existsSync(t))return null;try{let e=JSON.parse(E.readFileSync(t,`utf8`));return e.version!==1||!X(e.id)||!X(e.cloudBaseUrl)||!X(e.refreshCredential)||!X(e.createdAt)?null:e}catch{return null}}function vn(e){let t=G(e.stateDir);E.mkdirSync(D.dirname(t),{recursive:!0,mode:448}),E.writeFileSync(t,`${JSON.stringify(e.session,null,2)}\n`,{mode:384});try{E.chmodSync(t,384)}catch{}}function yn(e){let t=G(e.stateDir);return E.existsSync(t)?(E.rmSync(t,{force:!0}),!0):!1}function G(e){return D.join(e,`auth`,`cli-session.json`)}function bn(e){let t=_n({stateDir:e.stateDir});return t?{authenticated:!0,source:`cli-session`,sessionId:t.id,cloudBaseUrl:t.cloudBaseUrl,workspaceId:t.workspaceId,accountId:t.accountId,name:t.name,createdAt:t.createdAt,expiresAt:t.expiresAt,expired:Mn(t.expiresAt,e.now)}:{authenticated:!1,source:`none`}}async function xn(e){let t=_n({stateDir:e.stateDir});return!t||Mn(t.expiresAt,e.io?.now)?null:{accessToken:(await Sn({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:J(e.env,t.cloudBaseUrl)}}async function Sn(e){let n=await K({baseUrl:J(e.env,e.session.cloudBaseUrl),pathName:`/api/control-plane/cli-session/refresh`,body:{refreshCredential:e.session.refreshCredential,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});if(X(n.accessToken))return{accessToken:n.accessToken,expiresAt:n.expiresAt};throw n.status===`revoked`||n.error===`revoked`?new t(`UNAUTHORIZED`,`Stored cloud CLI session was revoked.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:n.status,error:n.error}):new t(`UNAUTHORIZED`,`Failed to refresh CLI session.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:n.status,error:n.error})}async function Cn(e){let n=e.now??Date.now,r=Math.min((e.expiresIn??600)*1e3,6e5),i=n()+r,a=Math.max(pn,(e.interval??5)*1e3);for(;n()<i;){let n=await K({baseUrl:e.cloudBaseUrl,pathName:`/api/control-plane/device-auth/poll`,body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if(n.status===`approved`||X(n.accessToken))return n;if(n.status===`slow_down`||n.error===`slow_down`)a+=pn;else if(n.status!==`authorization_pending`&&n.error!==`authorization_pending`)throw new t(`UNAUTHORIZED`,`Device authorization was not approved.`,{status:n.status,error:n.error});await Nn(a)}throw new t(`TIMEOUT`,`Device authorization expired before approval.`)}async function K(e){let t=await(e.fetchImpl??fetch)(new URL(e.pathName,e.baseUrl),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(e.body),signal:AbortSignal.timeout(15e3)});return await fn(t,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud auth endpoint rejected the request.`})}async function wn(e){if(!X(e.deviceCode))throw q(`deviceCode`);if(!X(e.userCode))throw q(`userCode`);if(!X(e.verificationUri))throw q(`verificationUri`);let{isSafeBrowserUrl:t}=await import(`./browser-launch.js`);if(!t(e.verificationUri))throw q(`verificationUri`);if(X(e.verificationUriComplete)&&!t(e.verificationUriComplete))throw q(`verificationUriComplete`)}function q(e){return new t(`COMMAND_FAILED`,`Cloud auth start returned an unusable response.`,{field:e})}function Tn(e,t){let n=t?.stdinIsTTY??process.stdin.isTTY,r=t?.stdoutIsTTY??process.stdout.isTTY;return En(e)||!n||!r?`non-interactive`:Dn(e)?`device-code`:`local-browser`}function En(e){return e.CI===`true`||e.GITHUB_ACTIONS===`true`||e.BUILDKITE===`true`}function Dn(e){return!!(e.SSH_TTY||e.SSH_CONNECTION||e.CODESPACES===`true`||e.GITPOD_WORKSPACE_ID||e.REMOTE_CONTAINERS===`true`)}function On(e,n){let r=J(n);return new t(`UNAUTHORIZED`,`${e} cannot perform interactive login in CI or a non-interactive shell.`,{hint:`Create a service/API token: ${new URL(`/api-keys`,r).toString()} Then set AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...`})}function J(e,n){let r=e.AGENT_DEVICE_CLOUD_BASE_URL??n??`https://cloud.agent-device.dev`;try{return new URL(r).toString().replace(/\/+$/,``)}catch(e){throw new t(`INVALID_ARGS`,`Invalid AGENT_DEVICE_CLOUD_BASE_URL.`,{cloudBaseUrl:r},e instanceof Error?e:void 0)}}function kn(e,t){if(t.AGENT_DEVICE_CLOUD_AUTH===`1`||t.AGENT_DEVICE_CLOUD_AUTH===`true`||X(t.AGENT_DEVICE_CLOUD_BASE_URL))return!0;try{let t=new URL(e).hostname.toLowerCase();return t===`agent-device.dev`||t.endsWith(`.agent-device.dev`)}catch{return!1}}function An(e,t){let n=new URL(e);return n.searchParams.set(`user_code`,t),n.toString()}async function jn(e,t){if(t?.openBrowser){await t.openBrowser(e);return}let{openUrlInBrowser:n}=await import(`./browser-launch.js`);await n(e)||Y(t,`Open this URL on your machine:\n${e}\n`)}function Y(e,t){(e?.stderr??process.stderr).write(t)}function Mn(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function X(e){return typeof e==`string`&&e.trim().length>0}async function Nn(e){await new Promise(t=>setTimeout(t,e))}var Pn=e({runCli:()=>$});const Z=(e,t={})=>import(`./error.js`).then(e=>e.t).then(({printHumanError:n})=>n(e,t)),Q=e=>import(`./json.js`).then(({printJson:t})=>t(e)),Fn={sendToDaemon:Se({onReplaced:In}),transportForHost:e=>Se({host:e,onReplaced:In})};function In(e){let{stateDir:t,previous:n,reason:r}=e,i=n.version?`pid ${n.pid}, v${n.version}`:`pid ${n.pid}`;process.stderr.write(r===`unreachable`?`Replaced unreachable daemon (${i}) in ${t}.\n`:`Replaced idle daemon (${i}) in ${t}: it did not match this client.\n`)}const Ln=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),Rn=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function $(e,t=Fn,n=ae(process)){await ce({host:n,requestEnv:void 0},async()=>await zn(e,t,n))}async function zn(e,t,n){let r=xe(t,n),i=oe(),a=we(),o=$n(e),s=e.includes(`--json`),c=gr(e)??n.env.AGENT_DEVICE_SESSION??`default`;await ne({session:c,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:c,positionals:l}=await Vn(e,{host:n,version:a,jsonRequested:s,debugEnabled:o}),u=nr(c,t.providedFlags),d=await Hn(t,{host:n,command:c,positionals:l,requestId:i,debugOutputEnabled:u});Bn(d.effectiveFlags);let f=null;try{if(c===`react-devtools`){await w(await Un(d));return}if(c===`web`){let{runWebCommand:e}=await import(`./web.js`);await w(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(Ae({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await Wn(d,r),Bn(d.effectiveFlags),c===`cdp`){await w(await kt(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=Kn(d);let e=await qn(d),t=gt();await Jn(d,me(Gn(d),{host:d.host,transport:fr({host:n,command:c,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await Yn(e,d,f)}finally{f&&f()}})}function Bn(e){e.daemonAuthToken&&re(e.daemonAuthToken)}async function Vn(e,n){let r;try{r=Vt(e,{cwd:n.host.cwd,env:n.host.env})}catch(e){v({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let t=a(e,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});return n.jsonRequested?await Q({success:!1,error:t}):await Z(t,{showDetails:n.debugEnabled}),w(1)}for(let e of r.warnings)process.stderr.write(`Warning: ${e}\n`);if(r.flags.version)return process.stdout.write(`${n.version}\n`),w(0);let i=r.command===`help`,o=r.flags.help;if(i||o){if(i&&r.positionals.length>1)return await Z(new t(`INVALID_ARGS`,`help accepts at most one command.`)),w(1);let e=i?r.positionals[0]:r.command;if(!e)return process.stdout.write(`${await M()}\n`),w(0);let n=await ht(e);return n?(process.stdout.write(n),w(0)):(await Z(new t(`INVALID_ARGS`,er(e))),process.stdout.write(`${await M()}\n`),w(1))}return r.command?{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await M()}\n`),w(1))}async function Hn(e,t){let r=new Set(e.providedFlags.map(e=>e.key));try{let n=Pt({env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=n.lockPolicy?{...e.flags}:Nt(e.flags,{env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),a=Te(i.stateDir,{env:t.host.env,cwd:t.host.cwd}),o=i.session??`default`,s=ar({host:t.host,command:t.command,explicitFlagKeys:r,stateDir:a.baseDir,session:o,remoteConfig:i.remoteConfig,hasResolvedSession:i.session!==void 0}),c=s?ur(i,s.flags,r):i;return{...t,binding:n,flags:i,daemonPaths:a,sessionName:o,connectionDefaults:s,explicitFlagKeys:r,effectiveFlags:c,resolvedRuntime:s?.runtime,connectionMetadata:s?.connection,parsedBatchSteps:void 0}}catch(r){let i=n(r),o=a(i,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});return e.flags.json?await Q({success:!1,error:o}):await Z(o,{showDetails:t.debugOutputEnabled}),w(1)}}async function Un(e){let{runReactDevtoolsCommand:t}=await import(`./react-devtools.js`);return await t(e.positionals,{flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,session:e.effectiveFlags.session??e.sessionName})}async function Wn(e,n){if(e.command===`batch`){if(e.positionals.length>0)throw new t(`INVALID_ARGS`,`batch does not accept positional arguments.`);e.parsedBatchSteps=rr(e.flags)}if(sr(e.command)&&(e.effectiveFlags=(await mn({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&or(e.command)){let t=me(Gn(e),{host:e.host,transport:mr(n)}),{materializeRemoteConnectionForCommand:r}=await import(`./connection-runtime.js`),i=await r({host:e.host,command:e.command,flags:e.effectiveFlags,client:t,runtime:e.resolvedRuntime,positionals:e.positionals,batchSteps:e.parsedBatchSteps,forceRuntimePrepare:dr(e.explicitFlagKeys)});e.effectiveFlags=i.flags,e.resolvedRuntime=i.runtime,e.connectionMetadata=i.connection}cr({command:e.command,flags:e.effectiveFlags,runtime:e.resolvedRuntime,explicitFlagKeys:e.explicitFlagKeys,hadConnectionDefaults:!!e.connectionDefaults})&&process.stderr.write(`Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.
2
+ `)}function Gn(e){let t=e.effectiveFlags,n=e.connectionMetadata;return{session:t.session,requestId:e.requestId,stateDir:t.stateDir,daemonBaseUrl:t.daemonBaseUrl,daemonAuthToken:t.daemonAuthToken,daemonTransport:t.daemonTransport,daemonServerMode:t.daemonServerMode,tenant:t.tenant,sessionIsolation:t.sessionIsolation,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:n?.leaseProvider,clientId:n?.clientId,deviceKey:n?.deviceKey,providerApp:t.providerApp,providerOsVersion:t.providerOsVersion,providerDeviceType:t.providerDeviceType,providerProject:t.providerProject,providerBuild:t.providerBuild,providerSessionName:t.providerSessionName,providerDeviceOrientation:t.providerDeviceOrientation,providerGeoLocation:t.providerGeoLocation,providerTimezone:t.providerTimezone,providerAppiumVersion:t.providerAppiumVersion,providerLanguage:t.providerLanguage,providerLocale:t.providerLocale,providerNetworkProfile:t.providerNetworkProfile,providerCustomNetwork:t.providerCustomNetwork,providerNoResignApp:t.providerNoResignApp,awsProjectArn:t.awsProjectArn,awsDeviceArn:t.awsDeviceArn,awsAppArn:t.awsAppArn,awsRegion:t.awsRegion,awsInteractionMode:t.awsInteractionMode,runtime:e.resolvedRuntime,lockPolicy:e.binding.lockPolicy,lockPlatform:e.binding.defaultPlatform,cwd:e.host.cwd,debug:e.debugOutputEnabled,cost:t.cost,responseLevel:t.responseLevel}}function Kn(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?_r(e.daemonPaths.logPath):null}async function qn(e){if(e.command!==`test`)return;let{createReplayTestReporterRuntime:t}=await import(`./reporting.js`);return t({debug:e.debugOutputEnabled,verbose:e.effectiveFlags.verbose,json:e.effectiveFlags.json,reporter:e.effectiveFlags.reporter,reportJunit:e.effectiveFlags.reportJunit})}async function Jn(e,n,r,i){let{command:a,positionals:o,effectiveFlags:s}=e;if(a===`batch`){if(!e.parsedBatchSteps)throw new t(`INVALID_ARGS`,`batch requires --steps or --steps-file.`);let c=e.parsedBatchSteps.map((t,n)=>({...t,input:e.binding.lockPolicy&&e.flags.platform===void 0?{...t.input}:Nt(t.input,{env:e.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await bt({host:e.host,command:a,positionals:o,flags:{...s,batchSteps:c},client:n,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new t(`INVALID_ARGS`,`runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.`);else if(await bt({host:e.host,command:a,positionals:o,flags:s,client:n,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return;throw new t(`INVALID_ARGS`,tr(a))}async function Yn(e,t,r){let i=n(e),o=a(i,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});if(t.command===`close`&&ir(i)){t.effectiveFlags.json&&await Q({success:!0,data:{closed:`session`,source:`no-daemon`}});return}t.effectiveFlags.json?await Q({success:!1,error:o}):(await Z(o,{showDetails:t.debugOutputEnabled}),t.debugOutputEnabled&&Zn(t,o)),r&&r(),await w(1)}const Xn=64e3;function Zn(e,t){if(!e.effectiveFlags.daemonBaseUrl){Qn(`daemon log`,e.daemonPaths.logPath);return}let n=t.diagnosticsRecord;n&&Qn(`remote diagnostics`,Ce(e.daemonPaths.baseDir,n))}function Qn(e,t){try{if(E.existsSync(t)){let n=E.readFileSync(t,`utf8`).split(`
3
3
  `),r=n.slice(Math.max(0,n.length-200)).join(`
4
- `);r.length>Xn&&(r=r.slice(r.length-Xn)),r.trim().length>0&&process.stderr.write(`\n[${e}]\n${r}\n`)}}catch{}}function $n(e){try{let t=A(e);return nr(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function er(e){let t=He(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function tr(e){return d(e)?(b({level:`error`,phase:`cli_known_command_unhandled`,data:{command:e}}),`Command is registered but no CLI handler accepted it: ${e}`):`Unknown command: ${e}`}function nr(e,t){return t.some(t=>t.key===`verbose`&&(t.token===`--debug`||t.token===`-v`||e!==`test`))}function rr(e){let t=``;if(e.steps)t=e.steps;else if(e.stepsFile)try{t=E.readFileSync(e.stepsFile,`utf8`)}catch(t){let r=t instanceof Error?t.message:String(t);throw new n(`INVALID_ARGS`,`Failed to read --steps-file ${e.stepsFile}: ${r}`)}return jt(t)}function ir(e){return e.code===`COMMAND_FAILED`?e.details?.kind===`daemon_startup_failed`?!0:e.message.toLowerCase().includes(`failed to start daemon`)?typeof e.details?.infoPath==`string`||typeof e.details?.lockPath==`string`:!1:!1}function ar(e){return e.command===`connect`||e.command===`connection`||e.command===`daemon`||e.command===`plugins`||e.command===`proxy`?null:Yt({stateDir:e.stateDir,session:e.session,remoteConfig:e.remoteConfig,cwd:e.host.cwd,env:e.host.env,allowActiveFallback:!e.explicitFlagKeys.has(`session`)&&(!e.remoteConfig||e.command===`disconnect`||!e.hasResolvedSession),validateRemoteConfigHash:e.command!==`disconnect`})}function or(e){return!Rn.has(e)}function sr(e){return e!==`auth`&&e!==`connection`&&e!==`daemon`&&e!==`plugins`&&e!==`device`&&e!==`proxy`}function cr(e){return e.command!==`open`||e.runtime||e.flags.bundleUrl||e.flags.metroHost||e.flags.metroPort||e.flags.remoteConfig||e.hadConnectionDefaults?!1:lr(e.explicitFlagKeys)}function lr(e){return e.has(`daemonBaseUrl`)||e.has(`daemonTransport`)||e.has(`tenant`)||e.has(`sessionIsolation`)||e.has(`runId`)||e.has(`leaseId`)||e.has(`leaseBackend`)}function ur(e,t,n){let r={...e};for(let[e,i]of Object.entries(t))i!==void 0&&(n.has(e)||(r[e]=i));return r}function dr(e){for(let t of Ln)if(e.has(t))return!0;return!1}function fr(e){let t=pr(e);return e.flags.remoteConfig?async(n,r)=>{let i=await t(n,r),{forgetEndedProxyLease:a}=await import(`./ended-lease.js`);return a(e.flags,i,e.host),i}:t}function pr(e){let{command:t,flags:n,replayTestReporterRuntime:r,transport:i}=e;if(n.json)return mr(i);let a=t===`test`&&r?r.onProgress:_t(e.commandProgress);return async(e,n)=>{let r={...n,onProgress:a};return await hr(i,{...e,meta:{...e.meta,requestProgress:t===`test`?`replay-test`:`command`}},r)}}function mr(e){return async(t,n)=>await hr(e,t,n)}async function hr(e,t,n){return await e(t,n)}function gr(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n.startsWith(`--session=`)){let e=n.slice(10).trim();return e.length>0?e:null}if(n===`--session`){let n=e[t+1]?.trim();return n&&!n.startsWith(`-`)?n:null}}return null}Pe(process.argv[1]??``).href===import.meta.url&&$(process.argv.slice(2)).catch(async e=>{let n=t(e);await Z(i(n),{showDetails:!0}),await w(1)});function _r(e){try{let t=E.existsSync(e)?E.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&E.existsSync(e))try{let n=E.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=E.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);E.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{E.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{Tt as C,F as S,R as _,bn as a,Ut as b,Jt as c,en as d,B as f,U as g,Gt as h,gn as i,Xt as l,L as m,W as n,fn as o,Zt as p,yn as r,$ as runCli,Wt as s,Pn as t,Kt as u,Qt as v,qt as x,z as y};
4
+ `);r.length>Xn&&(r=r.slice(r.length-Xn)),r.trim().length>0&&process.stderr.write(`\n[${e}]\n${r}\n`)}}catch{}}function $n(e){try{let t=A(e);return nr(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function er(e){let t=He(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function tr(e){return d(e)?(v({level:`error`,phase:`cli_known_command_unhandled`,data:{command:e}}),`Command is registered but no CLI handler accepted it: ${e}`):`Unknown command: ${e}`}function nr(e,t){return t.some(t=>t.key===`verbose`&&(t.token===`--debug`||t.token===`-v`||e!==`test`))}function rr(e){let n=``;if(e.steps)n=e.steps;else if(e.stepsFile)try{n=E.readFileSync(e.stepsFile,`utf8`)}catch(n){let r=n instanceof Error?n.message:String(n);throw new t(`INVALID_ARGS`,`Failed to read --steps-file ${e.stepsFile}: ${r}`)}return jt(n)}function ir(e){return e.code===`COMMAND_FAILED`?e.details?.kind===`daemon_startup_failed`?!0:e.message.toLowerCase().includes(`failed to start daemon`)?typeof e.details?.infoPath==`string`||typeof e.details?.lockPath==`string`:!1:!1}function ar(e){return e.command===`connect`||e.command===`connection`||e.command===`daemon`||e.command===`plugins`||e.command===`proxy`?null:Yt({stateDir:e.stateDir,session:e.session,remoteConfig:e.remoteConfig,cwd:e.host.cwd,env:e.host.env,allowActiveFallback:!e.explicitFlagKeys.has(`session`)&&(!e.remoteConfig||e.command===`disconnect`||!e.hasResolvedSession),validateRemoteConfigHash:e.command!==`disconnect`})}function or(e){return!Rn.has(e)}function sr(e){return e!==`auth`&&e!==`connection`&&e!==`daemon`&&e!==`plugins`&&e!==`device`&&e!==`proxy`}function cr(e){return e.command!==`open`||e.runtime||e.flags.bundleUrl||e.flags.metroHost||e.flags.metroPort||e.flags.remoteConfig||e.hadConnectionDefaults?!1:lr(e.explicitFlagKeys)}function lr(e){return e.has(`daemonBaseUrl`)||e.has(`daemonTransport`)||e.has(`tenant`)||e.has(`sessionIsolation`)||e.has(`runId`)||e.has(`leaseId`)||e.has(`leaseBackend`)}function ur(e,t,n){let r={...e};for(let[e,i]of Object.entries(t))i!==void 0&&(n.has(e)||(r[e]=i));return r}function dr(e){for(let t of Ln)if(e.has(t))return!0;return!1}function fr(e){let t=pr(e);return e.flags.remoteConfig?async(n,r)=>{let i=await t(n,r),{forgetEndedProxyLease:a}=await import(`./ended-lease.js`);return a(e.flags,i,e.host),i}:t}function pr(e){let{command:t,flags:n,replayTestReporterRuntime:r,transport:i}=e;if(n.json)return mr(i);let a=t===`test`&&r?r.onProgress:_t(e.commandProgress);return async(e,n)=>{let r={...n,onProgress:a};return await hr(i,{...e,meta:{...e.meta,requestProgress:t===`test`?`replay-test`:`command`}},r)}}function mr(e){return async(t,n)=>await hr(e,t,n)}async function hr(e,t,n){return await e(t,n)}function gr(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n.startsWith(`--session=`)){let e=n.slice(10).trim();return e.length>0?e:null}if(n===`--session`){let n=e[t+1]?.trim();return n&&!n.startsWith(`-`)?n:null}}return null}Pe(process.argv[1]??``).href===import.meta.url&&$(process.argv.slice(2)).catch(async e=>{let t=n(e);await Z(a(t),{showDetails:!0}),await w(1)});function _r(e){try{let t=E.existsSync(e)?E.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&E.existsSync(e))try{let n=E.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=E.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);E.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{E.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{Tt as C,F as S,R as _,bn as a,Ut as b,Jt as c,en as d,B as f,U as g,Gt as h,gn as i,Xt as l,L as m,W as n,fn as o,Zt as p,yn as r,$ as runCli,Wt as s,Pn as t,Kt as u,Qt as v,qt as x,z as y};
@@ -1 +1 @@
1
- import{R as e}from"./sdk-contracts.js";import{$ as t,P as n,b as r,j as i,k as a,m as o,p as s}from"./sdk-io.js";import"./command.js";import{t as c}from"./base-url.js";import{a as l,c as u,d,f,i as p,l as m,n as h,o as g,r as _,s as v,u as y}from"./client-companion-tunnel-contract.js";import{createHash as b}from"node:crypto";import x from"node:fs";import S from"node:path";import{fileURLToPath as C}from"node:url";const w=`companion-tunnel`;function T(e){return b(`sha256`).update(e).digest(`hex`)}function E(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function D(e){if(!e||typeof e!=`object`||Array.isArray(e))return;let t=e;if(typeof t.tenantId==`string`&&typeof t.runId==`string`&&typeof t.leaseId==`string`)return{tenantId:t.tenantId,runId:t.runId,leaseId:t.leaseId}}function O(e,t){return e.tenantId===t.tenantId&&e.runId===t.runId&&e.leaseId===t.leaseId}function k(e,t,n,r){let i=r??S.join(e,`.agent-device`);if(!n)return{statePath:S.join(i,`${t.slug}.json`),logPath:S.join(i,`${t.slug}.log`)};let a=T(n).slice(0,12),o=S.join(i,t.slug);return{statePath:S.join(o,`${t.slug}-${a}.json`),logPath:S.join(o,`${t.slug}-${a}.log`)}}function A(e){try{let t=JSON.parse(x.readFileSync(e,`utf8`));if(!Number.isInteger(t.pid)||Number(t.pid)<=0||typeof t.serverBaseUrl!=`string`||typeof t.localBaseUrl!=`string`||typeof t.tokenHash!=`string`||t.tokenHash.length===0)return null;let n=Array.isArray(t.consumers)?t.consumers.filter(e=>typeof e==`string`&&e.length>0):[];return{pid:Number(t.pid),startTime:typeof t.startTime==`string`?t.startTime:void 0,command:typeof t.command==`string`?t.command:void 0,serverBaseUrl:t.serverBaseUrl,localBaseUrl:t.localBaseUrl,launchUrl:E(t.launchUrl),registerPath:E(t.registerPath),unregisterPath:E(t.unregisterPath),bridgeScope:D(t.bridgeScope),tokenHash:t.tokenHash,consumers:n}}catch{return null}}function j(e,t){x.mkdirSync(S.dirname(e),{recursive:!0}),x.writeFileSync(e,`${JSON.stringify(t,null,2)}\n`,`utf8`)}function M(e){x.mkdirSync(S.dirname(e),{recursive:!0}),x.closeSync(x.openSync(e,`a`))}function N(e){try{x.unlinkSync(e)}catch{}}function P(e){try{x.readdirSync(e).length===0&&x.rmdirSync(e)}catch{}}function F(e,t){let n=S.dirname(e.statePath),r=S.dirname(e.logPath);N(e.statePath),N(e.logPath),P(n),r!==n&&P(r),S.basename(n)===t.slug&&P(S.dirname(n))}function I(e,t){return e.includes(t.runArg)}function L(e,t){if(!r(e.pid))return!1;if(e.startTime){let t=i(e.pid);if(!t||t!==e.startTime)return!1}let n=a(e.pid);return!n||!I(n,t.definition)||!e.bridgeScope?!1:e.serverBaseUrl===c(t.serverBaseUrl)&&e.localBaseUrl===c(t.localBaseUrl)&&e.launchUrl===E(t.launchUrl)&&e.registerPath===E(t.registerPath)&&e.unregisterPath===E(t.unregisterPath)&&O(e.bridgeScope,t.bridgeScope)&&e.tokenHash===T(t.bearerToken)}function R(e){return E(e.consumerKey)??E(e.profileKey)??null}function z(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}function B(e,t){return t?{...e,consumers:e.consumers.filter(e=>e!==t)}:{...e,consumers:[]}}async function V(e,t,r){let i=await n({pid:e.pid,identity:{startTime:e.startTime,matches:e=>I(e,t)}},{termTimeoutMs:1e3,killTimeoutMs:1e3});if(i.status===`retained`)throw H({...i,pid:e.pid},t,r)}function H(t,n,r){let i=t.reason===`identity-unverified`?`${n.displayName} ${o(t.pid,`the ${n.displayName} this profile started`)}. Stop it yourself, as its owner if needed.`:`${n.displayName} pid ${t.pid} is still running${t.reason===`exit-timeout`?`: it survived ${t.signal}.`:t.errno===`EPERM`?`: it refused ${t.signal} (${t.errno}), so it belongs to another user or was started with elevated privileges. Stop it as that user, e.g. \`sudo kill ${t.pid}\`.`:`: it refused ${t.signal} (${t.errno}).`}`;return new e(`COMMAND_FAILED`,i,{...s(t,t.pid),statePath:r.statePath,logPath:r.logPath,hint:`${r.statePath} still tracks this pid, so a retry acts on that same companion instead of starting a second one.`})}function U(e,t){try{j(e,t)}catch{}}function W(e,t,n){n===void 0?delete e[t]:e[t]=n}function G(e,t){let n={...t};return n[m]=c(e.serverBaseUrl),n[h]=e.bearerToken,n[p]=c(e.localBaseUrl),n[y]=k(e.projectRoot,e.definition,e.profileKey,e.stateDir).statePath,n[u]=e.bridgeScope.tenantId,n[v]=e.bridgeScope.runId,n[g]=e.bridgeScope.leaseId,W(n,_,E(e.launchUrl)),W(n,l,E(e.registerPath)),W(n,d,E(e.unregisterPath)),n}function K(e){let t=C(import.meta.url),n=S.extname(t)||`.js`,r=[S.join(S.dirname(t),`${w}${n}`),S.join(S.dirname(t),`internal`,`${w}${n}`)].find(e=>x.existsSync(e));if(!r)throw Error(`${e.displayName} entrypoint not found. Rebuild the package to include the companion worker entry.`);return r}function q(e,n){let r=K(e.definition),o=r.endsWith(`.ts`)?[`--experimental-strip-types`]:[];x.mkdirSync(S.dirname(n),{recursive:!0});let s=x.openSync(n,`a`),l=0;try{l=t(process.execPath,[...o,r,e.definition.runArg],{cwd:e.cwd,env:G(e,e.env),stdio:[`ignore`,s,s]})}finally{x.closeSync(s)}if(!Number.isInteger(l)||l<=0)throw Error(`Failed to start ${e.definition.displayName} process.`);return{pid:l,startTime:i(l)??void 0,command:a(l)??void 0,serverBaseUrl:c(e.serverBaseUrl),localBaseUrl:c(e.localBaseUrl),launchUrl:E(e.launchUrl),registerPath:E(e.registerPath),unregisterPath:E(e.unregisterPath),bridgeScope:e.bridgeScope,tokenHash:T(e.bearerToken),consumers:[]}}async function J(t){let n=R(t),r=k(t.projectRoot,t.definition,t.profileKey,t.stateDir),i=A(r.statePath);if(i&&L(i,t)){let e=z(i,n);return e!==i&&j(r.statePath,e),{pid:i.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}i&&(await V(i,t.definition,r),F(r,t.definition)),M(r.statePath);let a;try{a=q(t,r.logPath),j(r.statePath,z(a,n))}catch(n){if(a)try{await V(a,t.definition,r)}catch(t){throw U(r.statePath,a),t instanceof e&&(t.cause=n),t}throw F(r,t.definition),n}return{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function Y(e){let t=R(e),n=k(e.projectRoot,e.definition,e.profileKey,e.stateDir),r=A(n.statePath);if(!r)return F(n,e.definition),{stopped:!1,statePath:n.statePath};let i=B(r,t);return i.consumers.length>0?(j(n.statePath,i),{stopped:!1,statePath:n.statePath}):(await V(r,e.definition,n),F(n,e.definition),{stopped:!0,statePath:n.statePath})}const X={slug:`metro-companion`,runArg:f,displayName:`Metro companion`};async function Z(e){return await J({...e,definition:X,registerPath:e.registerPath??`/api/metro/companion/register`})}async function Q(e){return await Y({...e,definition:X})}export{Z as ensureMetroCompanion,Q as stopMetroCompanion};
1
+ import{R as e}from"./sdk-contracts.js";import{P as t,b as n,et as r,j as i,k as a,m as o,p as s}from"./sdk-io.js";import"./command.js";import{t as c}from"./base-url.js";import{a as l,c as u,d,f,i as p,l as m,n as h,o as g,r as _,s as v,u as y}from"./client-companion-tunnel-contract.js";import{createHash as b}from"node:crypto";import x from"node:fs";import S from"node:path";import{fileURLToPath as C}from"node:url";const w=`companion-tunnel`;function T(e){return b(`sha256`).update(e).digest(`hex`)}function E(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function D(e){if(!e||typeof e!=`object`||Array.isArray(e))return;let t=e;if(typeof t.tenantId==`string`&&typeof t.runId==`string`&&typeof t.leaseId==`string`)return{tenantId:t.tenantId,runId:t.runId,leaseId:t.leaseId}}function O(e,t){return e.tenantId===t.tenantId&&e.runId===t.runId&&e.leaseId===t.leaseId}function k(e,t,n,r){let i=r??S.join(e,`.agent-device`);if(!n)return{statePath:S.join(i,`${t.slug}.json`),logPath:S.join(i,`${t.slug}.log`)};let a=T(n).slice(0,12),o=S.join(i,t.slug);return{statePath:S.join(o,`${t.slug}-${a}.json`),logPath:S.join(o,`${t.slug}-${a}.log`)}}function A(e){try{let t=JSON.parse(x.readFileSync(e,`utf8`));if(!Number.isInteger(t.pid)||Number(t.pid)<=0||typeof t.serverBaseUrl!=`string`||typeof t.localBaseUrl!=`string`||typeof t.tokenHash!=`string`||t.tokenHash.length===0)return null;let n=Array.isArray(t.consumers)?t.consumers.filter(e=>typeof e==`string`&&e.length>0):[];return{pid:Number(t.pid),startTime:typeof t.startTime==`string`?t.startTime:void 0,command:typeof t.command==`string`?t.command:void 0,serverBaseUrl:t.serverBaseUrl,localBaseUrl:t.localBaseUrl,launchUrl:E(t.launchUrl),registerPath:E(t.registerPath),unregisterPath:E(t.unregisterPath),bridgeScope:D(t.bridgeScope),tokenHash:t.tokenHash,consumers:n}}catch{return null}}function j(e,t){x.mkdirSync(S.dirname(e),{recursive:!0}),x.writeFileSync(e,`${JSON.stringify(t,null,2)}\n`,`utf8`)}function M(e){x.mkdirSync(S.dirname(e),{recursive:!0}),x.closeSync(x.openSync(e,`a`))}function N(e){try{x.unlinkSync(e)}catch{}}function P(e){try{x.readdirSync(e).length===0&&x.rmdirSync(e)}catch{}}function F(e,t){let n=S.dirname(e.statePath),r=S.dirname(e.logPath);N(e.statePath),N(e.logPath),P(n),r!==n&&P(r),S.basename(n)===t.slug&&P(S.dirname(n))}function I(e,t){return e.includes(t.runArg)}function L(e,t){if(!n(e.pid))return!1;if(e.startTime){let t=i(e.pid);if(!t||t!==e.startTime)return!1}let r=a(e.pid);return!r||!I(r,t.definition)||!e.bridgeScope?!1:e.serverBaseUrl===c(t.serverBaseUrl)&&e.localBaseUrl===c(t.localBaseUrl)&&e.launchUrl===E(t.launchUrl)&&e.registerPath===E(t.registerPath)&&e.unregisterPath===E(t.unregisterPath)&&O(e.bridgeScope,t.bridgeScope)&&e.tokenHash===T(t.bearerToken)}function R(e){return E(e.consumerKey)??E(e.profileKey)??null}function z(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}function B(e,t){return t?{...e,consumers:e.consumers.filter(e=>e!==t)}:{...e,consumers:[]}}async function V(e,n,r){let i=await t({pid:e.pid,identity:{startTime:e.startTime,matches:e=>I(e,n)}},{termTimeoutMs:1e3,killTimeoutMs:1e3});if(i.status===`retained`)throw H({...i,pid:e.pid},n,r)}function H(t,n,r){let i=t.reason===`identity-unverified`?`${n.displayName} ${o(t.pid,`the ${n.displayName} this profile started`)}. Stop it yourself, as its owner if needed.`:`${n.displayName} pid ${t.pid} is still running${t.reason===`exit-timeout`?`: it survived ${t.signal}.`:t.errno===`EPERM`?`: it refused ${t.signal} (${t.errno}), so it belongs to another user or was started with elevated privileges. Stop it as that user, e.g. \`sudo kill ${t.pid}\`.`:`: it refused ${t.signal} (${t.errno}).`}`;return new e(`COMMAND_FAILED`,i,{...s(t,t.pid),statePath:r.statePath,logPath:r.logPath,hint:`${r.statePath} still tracks this pid, so a retry acts on that same companion instead of starting a second one.`})}function U(e,t){try{j(e,t)}catch{}}function W(e,t,n){n===void 0?delete e[t]:e[t]=n}function G(e,t){let n={...t};return n[m]=c(e.serverBaseUrl),n[h]=e.bearerToken,n[p]=c(e.localBaseUrl),n[y]=k(e.projectRoot,e.definition,e.profileKey,e.stateDir).statePath,n[u]=e.bridgeScope.tenantId,n[v]=e.bridgeScope.runId,n[g]=e.bridgeScope.leaseId,W(n,_,E(e.launchUrl)),W(n,l,E(e.registerPath)),W(n,d,E(e.unregisterPath)),n}function K(e){let t=C(import.meta.url),n=S.extname(t)||`.js`,r=[S.join(S.dirname(t),`${w}${n}`),S.join(S.dirname(t),`internal`,`${w}${n}`)].find(e=>x.existsSync(e));if(!r)throw Error(`${e.displayName} entrypoint not found. Rebuild the package to include the companion worker entry.`);return r}function q(e,t){let n=K(e.definition),o=n.endsWith(`.ts`)?[`--experimental-strip-types`]:[];x.mkdirSync(S.dirname(t),{recursive:!0});let s=x.openSync(t,`a`),l=0;try{l=r(process.execPath,[...o,n,e.definition.runArg],{cwd:e.cwd,env:G(e,e.env),stdio:[`ignore`,s,s]})}finally{x.closeSync(s)}if(!Number.isInteger(l)||l<=0)throw Error(`Failed to start ${e.definition.displayName} process.`);return{pid:l,startTime:i(l)??void 0,command:a(l)??void 0,serverBaseUrl:c(e.serverBaseUrl),localBaseUrl:c(e.localBaseUrl),launchUrl:E(e.launchUrl),registerPath:E(e.registerPath),unregisterPath:E(e.unregisterPath),bridgeScope:e.bridgeScope,tokenHash:T(e.bearerToken),consumers:[]}}async function J(t){let n=R(t),r=k(t.projectRoot,t.definition,t.profileKey,t.stateDir),i=A(r.statePath);if(i&&L(i,t)){let e=z(i,n);return e!==i&&j(r.statePath,e),{pid:i.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}i&&(await V(i,t.definition,r),F(r,t.definition)),M(r.statePath);let a;try{a=q(t,r.logPath),j(r.statePath,z(a,n))}catch(n){if(a)try{await V(a,t.definition,r)}catch(t){throw U(r.statePath,a),t instanceof e&&(t.cause=n),t}throw F(r,t.definition),n}return{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function Y(e){let t=R(e),n=k(e.projectRoot,e.definition,e.profileKey,e.stateDir),r=A(n.statePath);if(!r)return F(n,e.definition),{stopped:!1,statePath:n.statePath};let i=B(r,t);return i.consumers.length>0?(j(n.statePath,i),{stopped:!1,statePath:n.statePath}):(await V(r,e.definition,n),F(n,e.definition),{stopped:!0,statePath:n.statePath})}const X={slug:`metro-companion`,runArg:f,displayName:`Metro companion`};async function Z(e){return await J({...e,definition:X,registerPath:e.registerPath??`/api/metro/companion/register`})}async function Q(e){return await Y({...e,definition:X})}export{Z as ensureMetroCompanion,Q as stopMetroCompanion};
@@ -1 +1 @@
1
- import{B as e,R as t}from"./sdk-contracts.js";import{$ as n,P as r,V as i,j as a,m as o,nt as s,p as c,w as l}from"./sdk-io.js";import{c as u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{d as f}from"./src2.js";import"./retry.js";import{n as p,r as m}from"./project-runtime.js";import{ensureMetroCompanion as h}from"./client-metro-companion.js";import{n as g,r as _,t as v}from"./metro-reload-endpoints.js";import y from"node:fs";import b from"node:path";function x(e){return typeof e==`string`&&e.trim()?d(e.trim()):``}function S(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function C(e,t,n){return u(e,{env:t,cwd:n})}function w(e){try{return y.accessSync(e,y.constants.F_OK),!0}catch{return!1}}function T(e){try{return y.statSync(e).isDirectory()}catch{return!1}}function E(e){let n=b.join(e,`package.json`),r=m(e);if(!r)throw new t(`INVALID_ARGS`,`package.json not found at ${n}`);return r}const D=[{file:`pnpm-lock.yaml`,command:`pnpm`},{file:`yarn.lock`,command:`yarn`},{file:`bun.lock`,command:`bun`},{file:`bun.lockb`,command:`bun`},{file:`package-lock.json`,command:`npm`}];function O(e){let t=e;for(;;){for(let{file:e,command:n}of D)if(w(b.join(t,e)))return{command:n,installArgs:[`install`]};if(w(b.join(t,`.git`)))return null;let e=b.dirname(t);if(e===t)return null;t=e}}function k(e){return O(e)??{command:`npm`,installArgs:[`install`]}}function A(e,t){if(t!==`auto`)return t;let n=p(e);return n===`expo`||n===`repack`?n:`react-native`}function j(e,t){return typeof{...e.dependencies??{},...e.devDependencies??{}}[t]==`string`}function M(e,t){return[`js`,`mjs`,`cjs`,`ts`,`mts`,`cts`].some(n=>w(b.join(e,`${t}.config.${n}`)))}function N(e,t){return M(e,`rspack`)?`rspack`:M(e,`webpack`)?`webpack`:j(t,`@rspack/core`)?`rspack`:j(t,`webpack`)?`webpack`:`rspack`}function P(e,t,n){if(e==null||e===``)return t;let r=Number.parseInt(String(e),10);return Number.isInteger(r)?Math.max(r,n):t}function F(e){return e===`expo`?v:`index.bundle`}function I(e,t,n){return{platform:t,bundleUrl:f(e,t,F(n))}}function L(e,t){return{platform:t,metroHost:S(e?.metro_host),metroPort:e?.metro_port,bundleUrl:S(e?.metro_bundle_url),launchUrl:S(e?.launch_url)}}function R(e,t){if(T(b.join(e,`node_modules`)))return{installed:!1};let n=k(e);try{s(n.command,n.installArgs,{cwd:e,env:t})}catch(e){throw z(e,n)}return{installed:!0,packageManager:n.command}}function z(n,r){let i=e(n),a=`Dependency install failed using detected package manager "${r.command}". If dependencies are already installed (for example via a monorepo root install), pass --no-install-deps to skip this step, or install manually with "${r.command} ${r.installArgs.join(` `)}" from the project root.`;return new t(i.code,i.message,{...i.details??{},hint:a,packageManager:r.command},i)}async function B(e){await i(e)}async function V(e,n,r={}){try{let t=await fetch(e,{headers:r,signal:AbortSignal.timeout(n)});return{ok:t.ok,status:t.status,body:await t.text()}}catch(r){throw r instanceof Error&&r.name===`TimeoutError`?new t(`COMMAND_FAILED`,`Timed out fetching ${e} after ${n}ms`):r}}async function H(e,t){try{let n=await V(e,t);return n.ok&&n.body.includes(`packager-status:running`)}catch{return!1}}function U(e,t,n,r){return e===`expo`?{command:`npx`,installArgs:[`expo`,`start`,`--host`,`lan`,`--port`,String(n)]}:e===`repack`?{command:`npx`,installArgs:[`react-native`,t===`webpack`?`webpack-start`:`rspack-start`,`--host`,r,`--port`,String(n)]}:{command:`npx`,installArgs:[`react-native`,`start`,`--host`,r,`--port`,String(n)]}}function W(e,r,i,o,s,c,l){let u=U(r,i,o,s);y.mkdirSync(b.dirname(c),{recursive:!0});let d=y.openSync(c,`a`),f=0;try{f=n(u.command,u.installArgs,{cwd:e,env:l,stdio:[`ignore`,d,d]})}finally{y.closeSync(d)}if(!Number.isInteger(f)||f<=0)throw new t(`COMMAND_FAILED`,`Failed to start React Native dev server. Expected a detached child PID.`);return{pid:f,startTime:a(f)??void 0}}function G(e,n,r,i){let a=`React Native dev server did not become ready at ${e} within ${n.startupTimeoutMs}ms. Check ${n.logPath}.`;if(`throws`in i)return new t(`COMMAND_FAILED`,a,{logPath:n.logPath},i.throws);if(i.status===`stopped`)return new t(`COMMAND_FAILED`,a,{logPath:n.logPath});let s=i.reason===`identity-unverified`?o(r,`the process this run started`):`pid ${r} is still running${i.reason===`signal-failed`?` and refused ${i.signal} (${i.errno})`:``}`;return new t(`COMMAND_FAILED`,`${a} Dev server ${s}; stop it before retrying.`,{logPath:n.logPath,...c(i,r)})}function K(e,t){return{Authorization:`Bearer ${t}`,"Content-Type":`application/json`,...e.includes(`ngrok`)?{"ngrok-skip-browser-warning":`1`}:{}}}function q(e,n){let r=new t(`COMMAND_FAILED`,e);return r.retryable=n,r}function J(e,t){return!!(e>=500||e===408||e===425||e===429||JSON.stringify(t).includes(`Metro companion is not connected`))}function Y(e){return!!(e&&typeof e==`object`&&`retryable`in e&&e.retryable===!0)}async function X(e){let t;try{t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:`POST`,headers:K(e.baseUrl,e.bearerToken),body:JSON.stringify({...e.scope,...e.runtime?{ios_runtime:e.runtime}:{},timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){throw t instanceof Error&&t.name===`TimeoutError`?q(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0):q(t instanceof Error?t.message:String(t),!0)}let n=ee(await t.text(),t.status,e.baseUrl);if(!t.ok)throw q(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(n)}`,J(t.status,n));return Q(n)}function ee(e,t,n){if(!e)return{};try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))throw Error(`Expected a JSON object`);return t}catch(r){let i=e.slice(0,200);throw q(`/api/metro/bridge returned invalid JSON (${t}) from ${n}: ${r instanceof Error?r.message:String(r)}. body=${JSON.stringify(i)}`,J(t,e))}}function Z(e){return{enabled:e.enabled,baseUrl:e.base_url,statusUrl:e.status_url??``,bundleUrl:e.bundle_url??``,iosRuntime:L(e.ios_runtime,`ios`),androidRuntime:L(e.android_runtime,`android`),upstream:{bundleUrl:e.upstream.bundle_url??``,host:e.upstream.host??``,port:e.upstream.port??0,statusUrl:e.upstream.status_url??``},probe:{reachable:e.probe.reachable,statusCode:e.probe.status_code,latencyMs:e.probe.latency_ms,detail:e.probe.detail}}}function Q(e){let t=e.data??e;if(!t||typeof t!=`object`||Array.isArray(t))throw q(`/api/metro/bridge returned malformed descriptor: Expected a JSON object.`,!1);try{return Z(t)}catch(e){throw q(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function $(e,t,n,r,i){let a=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&a.push(`bridgeError=${t}`),n?.probe.reachable===!1&&a.push(`bridgeProbe=${n.probe.detail||`unreachable (status ${n.probe.statusCode||0})`}`),r&&r!==t&&a.push(`initialBridgeError=${r}`),i&&a.push(`metroCompanionLog=${i}`),a.join(` `)}function te(e,n){if(!n?.iosRuntime.bundleUrl)throw new t(`COMMAND_FAILED`,$(e,`bridge descriptor is missing ios_runtime.metro_bundle_url`,n))}function ne(e,n,r){let i=n||S(r.AGENT_DEVICE_METRO_BEARER_TOKEN)||``,a=i||e&&S(r.AGENT_DEVICE_DAEMON_AUTH_TOKEN)||``;if(e&&!a)throw new t(`INVALID_ARGS`,`metro prepare requires proxy auth when --proxy-base-url is provided. Pass --bearer-token or set AGENT_DEVICE_METRO_BEARER_TOKEN or AGENT_DEVICE_DAEMON_AUTH_TOKEN.`);if(!e&&i)throw new t(`INVALID_ARGS`,`metro prepare requires --proxy-base-url when proxy auth is provided.`);return{proxyEnabled:!!(e&&a),proxyBaseUrl:e,proxyBearerToken:a}}function re(e){if(!e?.tenantId||!e.runId||!e.leaseId)throw new t(`INVALID_ARGS`,`metro prepare with proxy requires tenantId, runId, and leaseId bridge scope.`);return e}function ie(e,n){if(!(e||n))throw new t(`INVALID_ARGS`,`metro prepare requires --public-base-url <url> or --proxy-base-url <url>.`)}function ae(e,t,n){return e.runtimeFilePath?C(e.runtimeFilePath,t,n):null}function oe(e,t,n,r){return C(e.logPath??b.join(r,`.agent-device`,`metro.log`),t,n)}function se(e,t){let n=e.env??t.env,r=t.cwd,i=C(e.projectRoot??r,n,r),a=e.kind??`auto`,o=null,s;a===`auto`?(o=E(i),s=A(o,a)):s=a;let c=null;s===`repack`&&(o??=E(i),c=N(i,o));let l=x(e.publicBaseUrl),u=x(e.proxyBaseUrl);ie(l,u);let{proxyEnabled:d,proxyBaseUrl:f,proxyBearerToken:p}=ne(u,S(e.proxyBearerToken)??``,n);return{env:n,cwd:r,projectRoot:i,kind:s,repackBundler:c,metroPort:g(e.metroPort??8081,8081),listenHost:S(e.listenHost)??`0.0.0.0`,statusHost:S(e.statusHost)??`127.0.0.1`,publicBaseUrl:l,proxyBaseUrl:f,proxyBearerToken:p,bridgeScope:d?re(e.bridgeScope):null,startupTimeoutMs:P(e.startupTimeoutMs,18e4,3e4),probeTimeoutMs:P(e.probeTimeoutMs,1e4,1e3),reuseExisting:e.reuseExisting??!0,installProjectDeps:e.installDependenciesIfNeeded??!0,runtimeFilePath:ae(e,n,r),logPath:oe(e,n,r,i)}}async function ce(e,t,n){let r=Date.now()+t;for(;Date.now()<r;){let t=r-Date.now();if(await H(e,Math.min(n,Math.max(t,1))))return!0;let i=Math.min(500,Math.max(r-Date.now(),0));i>0&&await B(i)}return!1}async function le(e){let n=Date.now()+e.startupTimeoutMs,r=null,i=null;for(;Date.now()<n;){try{let t=await X({baseUrl:e.baseUrl,bearerToken:e.bearerToken,scope:e.scope,runtime:e.runtime,timeoutMs:e.probeTimeoutMs});if(t.probe.reachable!==!1)return t;r=t,i=null}catch(n){if(i=n instanceof Error?n.message:String(n),!Y(n))throw new t(`COMMAND_FAILED`,$(e.baseUrl,i,r,e.initialBridgeError,e.companionLogPath),void 0,n)}let a=Math.min(1e3,Math.max(n-Date.now(),0));a>0&&await B(a)}throw new t(`COMMAND_FAILED`,$(e.baseUrl,i,r,e.initialBridgeError,e.companionLogPath))}async function ue(e){let t=`http://${e.statusHost}:${e.metroPort}/status`;if(e.reuseExisting&&await H(t,e.probeTimeoutMs))return{started:!1,reused:!0,pid:0,statusUrl:t};let n=W(e.projectRoot,e.kind,e.repackBundler,e.metroPort,e.listenHost,e.logPath,e.env);if(await ce(t,e.startupTimeoutMs,e.probeTimeoutMs))return{started:!0,reused:!1,pid:n.pid,statusUrl:t};let i=await r({pid:n.pid,identity:{startTime:n.startTime}},{termTimeoutMs:1e3,killTimeoutMs:1e3}).catch(e=>({throws:e}));throw G(t,e,n.pid,i)}async function de(e,t){let n=t.bridgeScope;if(!n)return null;let r=null,i=null;try{r=await X({baseUrl:t.proxyBaseUrl,bearerToken:t.proxyBearerToken,scope:n,timeoutMs:t.probeTimeoutMs})}catch(e){if(!Y(e))throw e;i=e instanceof Error?e.message:String(e)}return(!r||r.probe.reachable===!1)&&(r=await fe(e,t,n,r,i)),te(t.proxyBaseUrl,r),r}async function fe(e,n,r,i,a){let o;try{o=(await h({projectRoot:n.projectRoot,serverBaseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,bridgeScope:r,localBaseUrl:`http://${n.statusHost}:${n.metroPort}`,launchUrl:S(e.launchUrl),profileKey:S(e.companionProfileKey),consumerKey:S(e.companionConsumerKey),env:n.env,cwd:n.cwd})).logPath}catch(e){throw new t(`COMMAND_FAILED`,$(n.proxyBaseUrl,e instanceof Error?e.message:String(e),i,a),e instanceof t?l(e.details):void 0,e)}try{return await le({baseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,scope:r,probeTimeoutMs:n.probeTimeoutMs,startupTimeoutMs:n.startupTimeoutMs,initialBridgeError:a,companionLogPath:o})}catch(e){throw e instanceof Error?e:Error(String(e))}}function pe(e,t){return{baseIosRuntime:e?I(e,`ios`,t):{platform:`ios`},baseAndroidRuntime:e?I(e,`android`,t):{platform:`android`}}}function me(e,t){e&&(y.mkdirSync(b.dirname(e),{recursive:!0}),y.writeFileSync(e,JSON.stringify(t,null,2)))}async function he(e,t){let n=se(e,t),r=n.installProjectDeps?R(n.projectRoot,n.env):{installed:!1},i=await ue(n),{baseIosRuntime:a,baseAndroidRuntime:o}=pe(n.publicBaseUrl,n.kind),s=await de(e,n),c=s?.iosRuntime??a,l=s?.androidRuntime??o,u={projectRoot:n.projectRoot,kind:n.kind,dependenciesInstalled:r.installed,packageManager:r.packageManager??null,started:i.started,reused:i.reused,pid:i.pid,logPath:n.logPath,statusUrl:i.statusUrl,runtimeFilePath:n.runtimeFilePath,iosRuntime:c,androidRuntime:l,bridge:s};return me(n.runtimeFilePath,u),u}function ge(e){let t=e.trimStart().slice(0,15).toLowerCase();return t.startsWith(`<!doctype`)||t.startsWith(`<html`)}async function _e(e,n){await new Promise((r,i)=>{let a=new WebSocket(e),o=e=>{clearTimeout(s);try{a.close()}catch{}i(new t(`COMMAND_FAILED`,e))},s=setTimeout(()=>{o(`Timed out broadcasting reload to ${e} after ${n}ms`)},n);a.addEventListener(`open`,()=>{a.send(JSON.stringify({version:2,method:`reload`}));let e=()=>{if(a.bufferedAmount===0){clearTimeout(s),a.close(),r();return}setTimeout(e,20)};e()}),a.addEventListener(`error`,()=>{o(`Failed to reach the dev server message socket at ${e}`)})})}async function ve(e={}){let n=P(e.timeoutMs,1e4,1e3),{reloadUrl:r,messageSocketUrl:i}=_(e),a=await V(r,n);if(a.ok&&!ge(a.body))return{reloaded:!0,reloadUrl:r,status:a.status,body:a.body,transport:`http`};try{await _e(i,n)}catch(e){throw new t(`COMMAND_FAILED`,`React Native dev server reload failed (${a.status}).`,{reloadUrl:r,status:a.status,body:a.body.slice(0,500),messageSocketUrl:i,hint:`Verify Metro or Re.Pack is running and the target React Native app is connected to this dev server instance.`},e instanceof Error?e:void 0)}return{reloaded:!0,reloadUrl:i,status:a.status,body:``,transport:`message-socket`}}export{he as prepareMetroRuntime,ve as reloadMetro};
1
+ import{R as e,V as t}from"./sdk-contracts.js";import{H as n,P as r,et as i,j as a,m as o,p as s,rt as c,w as l}from"./sdk-io.js";import{u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{d as f}from"./src2.js";import"./retry.js";import{n as p,r as m}from"./project-runtime.js";import{ensureMetroCompanion as h}from"./client-metro-companion.js";import{n as g,r as _,t as v}from"./metro-reload-endpoints.js";import y from"node:fs";import b from"node:path";function x(e){return typeof e==`string`&&e.trim()?d(e.trim()):``}function S(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function C(e,t,n){return u(e,{env:t,cwd:n})}function w(e){try{return y.accessSync(e,y.constants.F_OK),!0}catch{return!1}}function T(e){try{return y.statSync(e).isDirectory()}catch{return!1}}function E(t){let n=b.join(t,`package.json`),r=m(t);if(!r)throw new e(`INVALID_ARGS`,`package.json not found at ${n}`);return r}const D=[{file:`pnpm-lock.yaml`,command:`pnpm`},{file:`yarn.lock`,command:`yarn`},{file:`bun.lock`,command:`bun`},{file:`bun.lockb`,command:`bun`},{file:`package-lock.json`,command:`npm`}];function O(e){let t=e;for(;;){for(let{file:e,command:n}of D)if(w(b.join(t,e)))return{command:n,installArgs:[`install`]};if(w(b.join(t,`.git`)))return null;let e=b.dirname(t);if(e===t)return null;t=e}}function k(e){return O(e)??{command:`npm`,installArgs:[`install`]}}function A(e,t){if(t!==`auto`)return t;let n=p(e);return n===`expo`||n===`repack`?n:`react-native`}function j(e,t){return typeof{...e.dependencies??{},...e.devDependencies??{}}[t]==`string`}function M(e,t){return[`js`,`mjs`,`cjs`,`ts`,`mts`,`cts`].some(n=>w(b.join(e,`${t}.config.${n}`)))}function N(e,t){return M(e,`rspack`)?`rspack`:M(e,`webpack`)?`webpack`:j(t,`@rspack/core`)?`rspack`:j(t,`webpack`)?`webpack`:`rspack`}function P(e,t,n){if(e==null||e===``)return t;let r=Number.parseInt(String(e),10);return Number.isInteger(r)?Math.max(r,n):t}function F(e){return e===`expo`?v:`index.bundle`}function I(e,t,n){return{platform:t,bundleUrl:f(e,t,F(n))}}function L(e,t){return{platform:t,metroHost:S(e?.metro_host),metroPort:e?.metro_port,bundleUrl:S(e?.metro_bundle_url),launchUrl:S(e?.launch_url)}}function R(e,t){if(T(b.join(e,`node_modules`)))return{installed:!1};let n=k(e);try{c(n.command,n.installArgs,{cwd:e,env:t})}catch(e){throw z(e,n)}return{installed:!0,packageManager:n.command}}function z(n,r){let i=t(n),a=`Dependency install failed using detected package manager "${r.command}". If dependencies are already installed (for example via a monorepo root install), pass --no-install-deps to skip this step, or install manually with "${r.command} ${r.installArgs.join(` `)}" from the project root.`;return new e(i.code,i.message,{...i.details??{},hint:a,packageManager:r.command},i)}async function B(e){await n(e)}async function V(t,n,r={}){try{let e=await fetch(t,{headers:r,signal:AbortSignal.timeout(n)});return{ok:e.ok,status:e.status,body:await e.text()}}catch(r){throw r instanceof Error&&r.name===`TimeoutError`?new e(`COMMAND_FAILED`,`Timed out fetching ${t} after ${n}ms`):r}}async function H(e,t){try{let n=await V(e,t);return n.ok&&n.body.includes(`packager-status:running`)}catch{return!1}}function U(e,t,n,r){return e===`expo`?{command:`npx`,installArgs:[`expo`,`start`,`--host`,`lan`,`--port`,String(n)]}:e===`repack`?{command:`npx`,installArgs:[`react-native`,t===`webpack`?`webpack-start`:`rspack-start`,`--host`,r,`--port`,String(n)]}:{command:`npx`,installArgs:[`react-native`,`start`,`--host`,r,`--port`,String(n)]}}function W(t,n,r,o,s,c,l){let u=U(n,r,o,s);y.mkdirSync(b.dirname(c),{recursive:!0});let d=y.openSync(c,`a`),f=0;try{f=i(u.command,u.installArgs,{cwd:t,env:l,stdio:[`ignore`,d,d]})}finally{y.closeSync(d)}if(!Number.isInteger(f)||f<=0)throw new e(`COMMAND_FAILED`,`Failed to start React Native dev server. Expected a detached child PID.`);return{pid:f,startTime:a(f)??void 0}}function G(t,n,r,i){let a=`React Native dev server did not become ready at ${t} within ${n.startupTimeoutMs}ms. Check ${n.logPath}.`;if(`throws`in i)return new e(`COMMAND_FAILED`,a,{logPath:n.logPath},i.throws);if(i.status===`stopped`)return new e(`COMMAND_FAILED`,a,{logPath:n.logPath});let c=i.reason===`identity-unverified`?o(r,`the process this run started`):`pid ${r} is still running${i.reason===`signal-failed`?` and refused ${i.signal} (${i.errno})`:``}`;return new e(`COMMAND_FAILED`,`${a} Dev server ${c}; stop it before retrying.`,{logPath:n.logPath,...s(i,r)})}function K(e,t){return{Authorization:`Bearer ${t}`,"Content-Type":`application/json`,...e.includes(`ngrok`)?{"ngrok-skip-browser-warning":`1`}:{}}}function q(t,n){let r=new e(`COMMAND_FAILED`,t);return r.retryable=n,r}function J(e,t){return!!(e>=500||e===408||e===425||e===429||JSON.stringify(t).includes(`Metro companion is not connected`))}function Y(e){return!!(e&&typeof e==`object`&&`retryable`in e&&e.retryable===!0)}async function X(e){let t;try{t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:`POST`,headers:K(e.baseUrl,e.bearerToken),body:JSON.stringify({...e.scope,...e.runtime?{ios_runtime:e.runtime}:{},timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){throw t instanceof Error&&t.name===`TimeoutError`?q(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0):q(t instanceof Error?t.message:String(t),!0)}let n=ee(await t.text(),t.status,e.baseUrl);if(!t.ok)throw q(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(n)}`,J(t.status,n));return Q(n)}function ee(e,t,n){if(!e)return{};try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))throw Error(`Expected a JSON object`);return t}catch(r){let i=e.slice(0,200);throw q(`/api/metro/bridge returned invalid JSON (${t}) from ${n}: ${r instanceof Error?r.message:String(r)}. body=${JSON.stringify(i)}`,J(t,e))}}function Z(e){return{enabled:e.enabled,baseUrl:e.base_url,statusUrl:e.status_url??``,bundleUrl:e.bundle_url??``,iosRuntime:L(e.ios_runtime,`ios`),androidRuntime:L(e.android_runtime,`android`),upstream:{bundleUrl:e.upstream.bundle_url??``,host:e.upstream.host??``,port:e.upstream.port??0,statusUrl:e.upstream.status_url??``},probe:{reachable:e.probe.reachable,statusCode:e.probe.status_code,latencyMs:e.probe.latency_ms,detail:e.probe.detail}}}function Q(e){let t=e.data??e;if(!t||typeof t!=`object`||Array.isArray(t))throw q(`/api/metro/bridge returned malformed descriptor: Expected a JSON object.`,!1);try{return Z(t)}catch(e){throw q(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function $(e,t,n,r,i){let a=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&a.push(`bridgeError=${t}`),n?.probe.reachable===!1&&a.push(`bridgeProbe=${n.probe.detail||`unreachable (status ${n.probe.statusCode||0})`}`),r&&r!==t&&a.push(`initialBridgeError=${r}`),i&&a.push(`metroCompanionLog=${i}`),a.join(` `)}function te(t,n){if(!n?.iosRuntime.bundleUrl)throw new e(`COMMAND_FAILED`,$(t,`bridge descriptor is missing ios_runtime.metro_bundle_url`,n))}function ne(t,n,r){let i=n||S(r.AGENT_DEVICE_METRO_BEARER_TOKEN)||``,a=i||t&&S(r.AGENT_DEVICE_DAEMON_AUTH_TOKEN)||``;if(t&&!a)throw new e(`INVALID_ARGS`,`metro prepare requires proxy auth when --proxy-base-url is provided. Pass --bearer-token or set AGENT_DEVICE_METRO_BEARER_TOKEN or AGENT_DEVICE_DAEMON_AUTH_TOKEN.`);if(!t&&i)throw new e(`INVALID_ARGS`,`metro prepare requires --proxy-base-url when proxy auth is provided.`);return{proxyEnabled:!!(t&&a),proxyBaseUrl:t,proxyBearerToken:a}}function re(t){if(!t?.tenantId||!t.runId||!t.leaseId)throw new e(`INVALID_ARGS`,`metro prepare with proxy requires tenantId, runId, and leaseId bridge scope.`);return t}function ie(t,n){if(!(t||n))throw new e(`INVALID_ARGS`,`metro prepare requires --public-base-url <url> or --proxy-base-url <url>.`)}function ae(e,t,n){return e.runtimeFilePath?C(e.runtimeFilePath,t,n):null}function oe(e,t,n,r){return C(e.logPath??b.join(r,`.agent-device`,`metro.log`),t,n)}function se(e,t){let n=e.env??t.env,r=t.cwd,i=C(e.projectRoot??r,n,r),a=e.kind??`auto`,o=null,s;a===`auto`?(o=E(i),s=A(o,a)):s=a;let c=null;s===`repack`&&(o??=E(i),c=N(i,o));let l=x(e.publicBaseUrl),u=x(e.proxyBaseUrl);ie(l,u);let{proxyEnabled:d,proxyBaseUrl:f,proxyBearerToken:p}=ne(u,S(e.proxyBearerToken)??``,n);return{env:n,cwd:r,projectRoot:i,kind:s,repackBundler:c,metroPort:g(e.metroPort??8081,8081),listenHost:S(e.listenHost)??`0.0.0.0`,statusHost:S(e.statusHost)??`127.0.0.1`,publicBaseUrl:l,proxyBaseUrl:f,proxyBearerToken:p,bridgeScope:d?re(e.bridgeScope):null,startupTimeoutMs:P(e.startupTimeoutMs,18e4,3e4),probeTimeoutMs:P(e.probeTimeoutMs,1e4,1e3),reuseExisting:e.reuseExisting??!0,installProjectDeps:e.installDependenciesIfNeeded??!0,runtimeFilePath:ae(e,n,r),logPath:oe(e,n,r,i)}}async function ce(e,t,n){let r=Date.now()+t;for(;Date.now()<r;){let t=r-Date.now();if(await H(e,Math.min(n,Math.max(t,1))))return!0;let i=Math.min(500,Math.max(r-Date.now(),0));i>0&&await B(i)}return!1}async function le(t){let n=Date.now()+t.startupTimeoutMs,r=null,i=null;for(;Date.now()<n;){try{let e=await X({baseUrl:t.baseUrl,bearerToken:t.bearerToken,scope:t.scope,runtime:t.runtime,timeoutMs:t.probeTimeoutMs});if(e.probe.reachable!==!1)return e;r=e,i=null}catch(n){if(i=n instanceof Error?n.message:String(n),!Y(n))throw new e(`COMMAND_FAILED`,$(t.baseUrl,i,r,t.initialBridgeError,t.companionLogPath),void 0,n)}let a=Math.min(1e3,Math.max(n-Date.now(),0));a>0&&await B(a)}throw new e(`COMMAND_FAILED`,$(t.baseUrl,i,r,t.initialBridgeError,t.companionLogPath))}async function ue(e){let t=`http://${e.statusHost}:${e.metroPort}/status`;if(e.reuseExisting&&await H(t,e.probeTimeoutMs))return{started:!1,reused:!0,pid:0,statusUrl:t};let n=W(e.projectRoot,e.kind,e.repackBundler,e.metroPort,e.listenHost,e.logPath,e.env);if(await ce(t,e.startupTimeoutMs,e.probeTimeoutMs))return{started:!0,reused:!1,pid:n.pid,statusUrl:t};let i=await r({pid:n.pid,identity:{startTime:n.startTime}},{termTimeoutMs:1e3,killTimeoutMs:1e3}).catch(e=>({throws:e}));throw G(t,e,n.pid,i)}async function de(e,t){let n=t.bridgeScope;if(!n)return null;let r=null,i=null;try{r=await X({baseUrl:t.proxyBaseUrl,bearerToken:t.proxyBearerToken,scope:n,timeoutMs:t.probeTimeoutMs})}catch(e){if(!Y(e))throw e;i=e instanceof Error?e.message:String(e)}return(!r||r.probe.reachable===!1)&&(r=await fe(e,t,n,r,i)),te(t.proxyBaseUrl,r),r}async function fe(t,n,r,i,a){let o;try{o=(await h({projectRoot:n.projectRoot,serverBaseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,bridgeScope:r,localBaseUrl:`http://${n.statusHost}:${n.metroPort}`,launchUrl:S(t.launchUrl),profileKey:S(t.companionProfileKey),consumerKey:S(t.companionConsumerKey),env:n.env,cwd:n.cwd})).logPath}catch(t){throw new e(`COMMAND_FAILED`,$(n.proxyBaseUrl,t instanceof Error?t.message:String(t),i,a),t instanceof e?l(t.details):void 0,t)}try{return await le({baseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,scope:r,probeTimeoutMs:n.probeTimeoutMs,startupTimeoutMs:n.startupTimeoutMs,initialBridgeError:a,companionLogPath:o})}catch(e){throw e instanceof Error?e:Error(String(e))}}function pe(e,t){return{baseIosRuntime:e?I(e,`ios`,t):{platform:`ios`},baseAndroidRuntime:e?I(e,`android`,t):{platform:`android`}}}function me(e,t){e&&(y.mkdirSync(b.dirname(e),{recursive:!0}),y.writeFileSync(e,JSON.stringify(t,null,2)))}async function he(e,t){let n=se(e,t),r=n.installProjectDeps?R(n.projectRoot,n.env):{installed:!1},i=await ue(n),{baseIosRuntime:a,baseAndroidRuntime:o}=pe(n.publicBaseUrl,n.kind),s=await de(e,n),c=s?.iosRuntime??a,l=s?.androidRuntime??o,u={projectRoot:n.projectRoot,kind:n.kind,dependenciesInstalled:r.installed,packageManager:r.packageManager??null,started:i.started,reused:i.reused,pid:i.pid,logPath:n.logPath,statusUrl:i.statusUrl,runtimeFilePath:n.runtimeFilePath,iosRuntime:c,androidRuntime:l,bridge:s};return me(n.runtimeFilePath,u),u}function ge(e){let t=e.trimStart().slice(0,15).toLowerCase();return t.startsWith(`<!doctype`)||t.startsWith(`<html`)}async function _e(t,n){await new Promise((r,i)=>{let a=new WebSocket(t),o=t=>{clearTimeout(s);try{a.close()}catch{}i(new e(`COMMAND_FAILED`,t))},s=setTimeout(()=>{o(`Timed out broadcasting reload to ${t} after ${n}ms`)},n);a.addEventListener(`open`,()=>{a.send(JSON.stringify({version:2,method:`reload`}));let e=()=>{if(a.bufferedAmount===0){clearTimeout(s),a.close(),r();return}setTimeout(e,20)};e()}),a.addEventListener(`error`,()=>{o(`Failed to reach the dev server message socket at ${t}`)})})}async function ve(t={}){let n=P(t.timeoutMs,1e4,1e3),{reloadUrl:r,messageSocketUrl:i}=_(t),a=await V(r,n);if(a.ok&&!ge(a.body))return{reloaded:!0,reloadUrl:r,status:a.status,body:a.body,transport:`http`};try{await _e(i,n)}catch(t){throw new e(`COMMAND_FAILED`,`React Native dev server reload failed (${a.status}).`,{reloadUrl:r,status:a.status,body:a.body.slice(0,500),messageSocketUrl:i,hint:`Verify Metro or Re.Pack is running and the target React Native app is connected to this dev server instance.`},t instanceof Error?t:void 0)}return{reloaded:!0,reloadUrl:i,status:a.status,body:``,transport:`message-socket`}}export{he as prepareMetroRuntime,ve as reloadMetro};
@@ -1624,9 +1624,9 @@ type TvRemoteCommandResult = {
1624
1624
  /**
1625
1625
  * `hardware-button` — `{ action: 'hardware-button', button, message: 'Pressed hardware button <button>' }`.
1626
1626
  *
1627
- * The button is the public name (`volume-up`, `volume-down`, `power`). The result reports that the
1628
- * press was dispatched; it carries no volume level or screen state, because the command observes
1629
- * neither (#3848).
1627
+ * The button is the public name (`volume-up`, `volume-down`, `power`, `mute`, `sleep`, `wake`, or
1628
+ * one of the five media names). The result reports that the press was dispatched; it carries no
1629
+ * volume level, mute state, or screen state, because the command observes none of them (#3848).
1630
1630
  */
1631
1631
  type HardwareButtonCommandResult = {
1632
1632
  action: 'hardware-button';
@@ -14,11 +14,12 @@ type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
14
14
  declare const ORIENTATION_REQUESTS: readonly ["portrait", "portrait-upside-down", "landscape-left", "landscape-right", "auto"];
15
15
  type OrientationRequest = (typeof ORIENTATION_REQUESTS)[number];
16
16
  /**
17
- * The public positional names of the hardware keys: `volume-up`, `volume-down`, `power`.
18
- * The literals are the same ones SYSTEM_BUTTON_LABELS carries for these buttons; the label
19
- * owner's type-level check and the contracts tests refuse drift between the two lists.
17
+ * The public positional names of the hardware keys: the volume/power/mute keys, the explicit
18
+ * sleep and wake events, and the five media keys. The literals are the same ones
19
+ * SYSTEM_BUTTON_LABELS carries for these buttons; the label owner's type-level check and the
20
+ * contracts tests refuse drift between the two lists.
20
21
  */
21
- type HardwareButtonName = 'volume-up' | 'volume-down' | 'power';
22
+ type HardwareButtonName = 'volume-up' | 'volume-down' | 'power' | 'mute' | 'sleep' | 'wake' | 'media-play-pause' | 'media-next' | 'media-previous' | 'media-rewind' | 'media-fast-forward';
22
23
  /**
23
24
  * The three hinge poses a foldable Apple device can be put in, named after what an agent sees
24
25
  * rather than after Apple's `UIHinge.Status` cases: `closed` lights the outer panel only,