agent-device 0.21.37 → 0.21.38

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 (485) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.37.apk → agent-device-android-ime-helper-0.21.38.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.38.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.37.manifest.json → agent-device-android-ime-helper-0.21.38.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.37.apk → agent-device-android-snapshot-helper-0.21.38.apk} +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.38.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.37.manifest.json → agent-device-android-snapshot-helper-0.21.38.manifest.json} +7 -7
  7. package/apple/fold-helper/Fold.m +8 -4
  8. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerKeyboardReturnKey.swift +53 -0
  9. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +42 -4
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +26 -18
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +42 -11
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Keyboard.swift +123 -22
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Models.swift +7 -0
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +570 -53
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +41 -0
  16. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +7 -0
  17. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +17 -1
  18. package/dist/src/THIRD_PARTY_NOTICES.txt +2 -2
  19. package/dist/src/absence-observation-errors.js +1 -1
  20. package/dist/src/absence-observation.js +1 -1
  21. package/dist/src/adapter.js +1 -1
  22. package/dist/src/adb-executor.js +1 -1
  23. package/dist/src/adb-failure.js +2 -2
  24. package/dist/src/adb-transport.js +1 -1
  25. package/dist/src/agent-browser-lifecycle.js +1 -1
  26. package/dist/src/agent-browser-process-record.js +1 -1
  27. package/dist/src/agent-browser-provider.js +1 -1
  28. package/dist/src/agent-browser-tool.js +1 -1
  29. package/dist/src/ai-sdk.d.ts +1 -1
  30. package/dist/src/ai-sdk.js +1 -1
  31. package/dist/src/alert-contract.js +1 -1
  32. package/dist/src/alert-tree-driver.js +1 -1
  33. package/dist/src/alert.js +1 -1
  34. package/dist/src/android-adb.d.ts +1 -1
  35. package/dist/src/android.js +1 -1
  36. package/dist/src/android2.js +1 -1
  37. package/dist/src/app-backend.js +1 -1
  38. package/dist/src/app-catalog.js +1 -1
  39. package/dist/src/app-deployment-resolution.js +1 -1
  40. package/dist/src/app-inventory.js +1 -1
  41. package/dist/src/app-launch.js +1 -1
  42. package/dist/src/app-lifecycle.js +4 -4
  43. package/dist/src/app-lifecycle2.js +2 -2
  44. package/dist/src/app-log-files.js +1 -1
  45. package/dist/src/app-log-runtime2.js +2 -2
  46. package/dist/src/app-log-session-resource.js +1 -1
  47. package/dist/src/app-resolution.js +1 -1
  48. package/dist/src/app-state-read.js +1 -1
  49. package/dist/src/app-state-runtime.d.ts +1 -1
  50. package/dist/src/application-lifecycle-interaction.js +1 -1
  51. package/dist/src/archive.js +1 -1
  52. package/dist/src/args.js +1 -1
  53. package/dist/src/artifact-download.js +1 -1
  54. package/dist/src/artifact-tracking.js +1 -1
  55. package/dist/src/auth-session.js +1 -1
  56. package/dist/src/auth.js +1 -1
  57. package/dist/src/automation-helper-artifact.js +1 -1
  58. package/dist/src/automation-helper.js +1 -1
  59. package/dist/src/await-with-signal.js +1 -1
  60. package/dist/src/backend-snapshot-options.js +1 -1
  61. package/dist/src/boot-diagnostics.js +1 -1
  62. package/dist/src/bridge-source.js +1 -1
  63. package/dist/src/browser-launch.js +1 -1
  64. package/dist/src/browserstack-device-features.js +1 -1
  65. package/dist/src/browserstack.js +1 -1
  66. package/dist/src/cache.js +1 -1
  67. package/dist/src/capture-disclosure.js +1 -1
  68. package/dist/src/capture-lifecycle.js +1 -1
  69. package/dist/src/cli-config.js +1 -1
  70. package/dist/src/cli-help.js +19 -16
  71. package/dist/src/cli-output.js +11 -11
  72. package/dist/src/cli-runner.js +1 -1
  73. package/dist/src/cli.js +2 -2
  74. package/dist/src/click-button.js +1 -1
  75. package/dist/src/client-metro-companion.js +1 -1
  76. package/dist/src/client-metro.js +1 -1
  77. package/dist/src/client-options.js +1 -1
  78. package/dist/src/client-port.d.ts +246 -208
  79. package/dist/src/clipboard-shell-response.js +1 -1
  80. package/dist/src/cloud-artifacts.d.ts +7 -2
  81. package/dist/src/code-signature-cache.js +1 -1
  82. package/dist/src/command-schema.js +6 -4
  83. package/dist/src/command-tools.js +3 -3
  84. package/dist/src/command.js +1 -1
  85. package/dist/src/composed-inventory-gateways.js +1 -1
  86. package/dist/src/composite-resource-admission.js +1 -1
  87. package/dist/src/config.js +1 -1
  88. package/dist/src/connection-lease-transaction.js +1 -1
  89. package/dist/src/connection-metro-runtime.js +1 -1
  90. package/dist/src/connection-runtime.js +1 -1
  91. package/dist/src/connection-verification.js +1 -1
  92. package/dist/src/connection.js +3 -3
  93. package/dist/src/context.js +1 -1
  94. package/dist/src/contract.d.ts +2 -1
  95. package/dist/src/contracts.d.ts +1 -1
  96. package/dist/src/contracts.js +1 -1
  97. package/dist/src/daemon-client-attach.js +1 -1
  98. package/dist/src/daemon-client-dispatch-disclosure.js +1 -1
  99. package/dist/src/daemon-client-ensure.js +1 -1
  100. package/dist/src/daemon-client-ensuring.js +1 -1
  101. package/dist/src/daemon-client-lease-beat.js +1 -1
  102. package/dist/src/daemon-client-lifecycle.js +1 -1
  103. package/dist/src/daemon-client-liveness-probe.js +1 -1
  104. package/dist/src/daemon-client-remote-health-cache.js +1 -0
  105. package/dist/src/daemon-client-remote-health-recovery.js +1 -0
  106. package/dist/src/daemon-client-transport.js +1 -1
  107. package/dist/src/daemon-command-registry.js +1 -1
  108. package/dist/src/daemon-composition.js +1 -1
  109. package/dist/src/daemon-diagnostics-scope.js +1 -1
  110. package/dist/src/daemon-http.js +1 -1
  111. package/dist/src/daemon-launch-spec.js +1 -1
  112. package/dist/src/daemon-lifecycle-errors.js +1 -1
  113. package/dist/src/daemon-policy-file.js +1 -1
  114. package/dist/src/daemon-registration-owner.js +3 -3
  115. package/dist/src/daemon-registration.js +1 -1
  116. package/dist/src/daemon-resolution.js +1 -1
  117. package/dist/src/daemon-startup-diagnostics.js +1 -1
  118. package/dist/src/daemon-stop.js +1 -1
  119. package/dist/src/daemon.js +1 -1
  120. package/dist/src/debug-symbols-facade.js +3 -3
  121. package/dist/src/device-claim-admission.js +1 -0
  122. package/dist/src/device-claim-reconciliation.js +1 -0
  123. package/dist/src/device-claim-recovery.js +1 -1
  124. package/dist/src/device-claim-rule.js +1 -1
  125. package/dist/src/device-claims.js +1 -1
  126. package/dist/src/device-input-state.d.ts +1 -1
  127. package/dist/src/device-inventory-context.js +1 -1
  128. package/dist/src/device-selection-resolver.js +1 -1
  129. package/dist/src/device-session.js +1 -1
  130. package/dist/src/device-shell.js +1 -1
  131. package/dist/src/device.js +1 -1
  132. package/dist/src/device3.js +3 -3
  133. package/dist/src/devicectl.js +1 -1
  134. package/dist/src/diagnostics.js +1 -1
  135. package/dist/src/discovery.js +1 -1
  136. package/dist/src/dispatch-resolve.js +1 -1
  137. package/dist/src/display-inventory.js +1 -1
  138. package/dist/src/doctor-facade.js +1 -1
  139. package/dist/src/doctor2.js +1 -1
  140. package/dist/src/durable-capture-resource.js +1 -1
  141. package/dist/src/durable-capture.js +1 -1
  142. package/dist/src/durable-resource.js +1 -1
  143. package/dist/src/ended-lease.js +1 -1
  144. package/dist/src/engine-eval-script.js +1 -1
  145. package/dist/src/error.js +2 -2
  146. package/dist/src/errors.js +1 -1
  147. package/dist/src/explicit-session-resolution.js +1 -1
  148. package/dist/src/expo-dev-client-launch.js +1 -1
  149. package/dist/src/failure-output.js +1 -1
  150. package/dist/src/file.js +1 -1
  151. package/dist/src/find.js +1 -1
  152. package/dist/src/finders.js +1 -1
  153. package/dist/src/flag-registry.js +1 -1
  154. package/dist/src/focus-runtime.js +1 -1
  155. package/dist/src/fold-helper.js +1 -1
  156. package/dist/src/generic-settle.js +1 -1
  157. package/dist/src/generic.js +1 -1
  158. package/dist/src/gesture-admission.js +1 -1
  159. package/dist/src/gesture-plan-types.d.ts +1 -1
  160. package/dist/src/gesture-plan.js +1 -1
  161. package/dist/src/gesture-runtime.js +1 -1
  162. package/dist/src/hdc.js +1 -1
  163. package/dist/src/helper-artifacts.js +1 -1
  164. package/dist/src/helper.js +2 -2
  165. package/dist/src/host-file.js +1 -1
  166. package/dist/src/host.js +1 -1
  167. package/dist/src/host2.js +1 -1
  168. package/dist/src/host3.js +1 -1
  169. package/dist/src/host4.js +1 -1
  170. package/dist/src/host5.js +1 -1
  171. package/dist/src/host6.js +1 -1
  172. package/dist/src/human-control-contract.js +1 -1
  173. package/dist/src/human-control.js +1 -1
  174. package/dist/src/ime-rebind.js +1 -1
  175. package/dist/src/ime-settings-record.js +1 -1
  176. package/dist/src/ime-state.js +1 -1
  177. package/dist/src/index.d.ts +3 -3
  178. package/dist/src/index.js +1 -1
  179. package/dist/src/input-actions.js +1 -1
  180. package/dist/src/input-actions2.js +1 -1
  181. package/dist/src/install-artifact-facade.js +1 -1
  182. package/dist/src/install-source-network-transport.js +1 -1
  183. package/dist/src/install-source2.js +1 -1
  184. package/dist/src/interaction-error.js +1 -1
  185. package/dist/src/interaction-positionals.js +1 -1
  186. package/dist/src/interaction-ref-policy.js +1 -1
  187. package/dist/src/interaction2.js +1 -1
  188. package/dist/src/interactor-operation-binding.js +1 -1
  189. package/dist/src/interactor.js +5 -5
  190. package/dist/src/interactor2.js +1 -1
  191. package/dist/src/interactor3.js +1 -1
  192. package/dist/src/interactor4.js +1 -1
  193. package/dist/src/interactor5.js +1 -1
  194. package/dist/src/interactors.js +1 -1
  195. package/dist/src/internal/bin.js +1 -1
  196. package/dist/src/internal/companion-tunnel.js +1 -1
  197. package/dist/src/internal/daemon.js +1 -1
  198. package/dist/src/internal/png-worker.js +1 -1
  199. package/dist/src/internal/run-script-child.js +1 -1
  200. package/dist/src/inventory.js +1 -1
  201. package/dist/src/inventory2.js +1 -1
  202. package/dist/src/inventory3.js +1 -1
  203. package/dist/src/inventory5.js +1 -1
  204. package/dist/src/ios-node-interpretation.js +1 -1
  205. package/dist/src/ios-simulator-accessibility.js +1 -1
  206. package/dist/src/ios-snapshot-acquisition.js +1 -1
  207. package/dist/src/ios-snapshot-engine.js +1 -1
  208. package/dist/src/ios-snapshot-runtime.js +1 -1
  209. package/dist/src/launch-confirmation.js +1 -1
  210. package/dist/src/launch-services-registration.js +1 -1
  211. package/dist/src/lease-context.js +1 -1
  212. package/dist/src/lease-registry-scope.js +1 -1
  213. package/dist/src/lease-release2.js +1 -1
  214. package/dist/src/lease-scope.js +1 -1
  215. package/dist/src/lease.js +1 -1
  216. package/dist/src/leased-recording-retention.js +1 -1
  217. package/dist/src/legacy.js +1 -1
  218. package/dist/src/limrun-download-file.js +1 -1
  219. package/dist/src/limrun-ios-files.js +1 -1
  220. package/dist/src/limrun-ios-runner.js +2 -2
  221. package/dist/src/limrun-runtime-dependencies.js +1 -1
  222. package/dist/src/limrun.d.ts +1 -1
  223. package/dist/src/local-interactor-operation-set.js +1 -1
  224. package/dist/src/local-simulator-apps.js +1 -1
  225. package/dist/src/local-simulator-files.js +1 -1
  226. package/dist/src/location-coordinates.js +1 -1
  227. package/dist/src/manifest.js +1 -1
  228. package/dist/src/mechanics.js +12 -12
  229. package/dist/src/merge-flags.js +1 -1
  230. package/dist/src/metro-reload-endpoints.js +1 -1
  231. package/dist/src/metro-session-hints.js +1 -1
  232. package/dist/src/metro.d.ts +1 -1
  233. package/dist/src/mobile-snapshot-semantics.js +1 -1
  234. package/dist/src/network-traffic.js +1 -1
  235. package/dist/src/node-http.js +1 -1
  236. package/dist/src/node-touch-point.js +1 -1
  237. package/dist/src/observation.js +1 -1
  238. package/dist/src/open-script.js +1 -1
  239. package/dist/src/open-target-device-resolution.js +1 -1
  240. package/dist/src/orientation.js +1 -1
  241. package/dist/src/parameterized-recorded-fill.js +1 -1
  242. package/dist/src/perf-facade.js +1 -1
  243. package/dist/src/perf-runtime-operation-builder.js +1 -1
  244. package/dist/src/perf-runtime-plan.js +1 -1
  245. package/dist/src/perf-target.js +2 -2
  246. package/dist/src/perf.js +1 -1
  247. package/dist/src/physical-device-control.js +1 -1
  248. package/dist/src/platform-runtime-android-adb-host.js +1 -1
  249. package/dist/src/platform-runtime-app-log-process.js +1 -1
  250. package/dist/src/platform-runtime-apple-application-tools.js +1 -1
  251. package/dist/src/platform-runtime-claim-recovery.js +1 -1
  252. package/dist/src/platform-runtime-host.js +1 -1
  253. package/dist/src/platform-runtime-open-target.js +1 -1
  254. package/dist/src/platform-runtime-operation-host.js +3 -3
  255. package/dist/src/platform-runtime-runtime-hints.js +1 -1
  256. package/dist/src/platform-runtime-screen-recording-apple-runner-transport.js +1 -1
  257. package/dist/src/platform-runtime-screen-recording-apple-simulator-host.js +1 -1
  258. package/dist/src/platform-runtime-screen-recording-finalizer-host.js +1 -1
  259. package/dist/src/platform-runtime-screen-recording-process-host.js +1 -1
  260. package/dist/src/platform-runtime-shutdown-error.js +1 -1
  261. package/dist/src/platform-runtime-unavailable.js +1 -1
  262. package/dist/src/platform-runtime.js +1 -1
  263. package/dist/src/platform-runtime2.js +1 -1
  264. package/dist/src/plist.js +1 -1
  265. package/dist/src/plugins2.js +1 -1
  266. package/dist/src/png-crop-bytes.js +1 -1
  267. package/dist/src/png-resize.js +1 -1
  268. package/dist/src/png-size.js +1 -1
  269. package/dist/src/png-worker-client.js +1 -1
  270. package/dist/src/png.js +1 -1
  271. package/dist/src/post-gesture-stability.js +1 -1
  272. package/dist/src/process-executable-path.js +1 -0
  273. package/dist/src/process-exit.js +1 -1
  274. package/dist/src/provider-device-runtime.d.ts +2 -2
  275. package/dist/src/provider-limrun-credentials.js +1 -1
  276. package/dist/src/provider-plugin.d.ts +1 -1
  277. package/dist/src/provider-profile-fields.js +1 -1
  278. package/dist/src/provider-webdriver.js +1 -1
  279. package/dist/src/provider.js +1 -1
  280. package/dist/src/proxy.js +2 -2
  281. package/dist/src/react-devtools-connection.js +1 -1
  282. package/dist/src/react-devtools-inspect-command.js +1 -1
  283. package/dist/src/react-native-overlay2.js +2 -2
  284. package/dist/src/react-native.js +1 -1
  285. package/dist/src/react-profile-command.js +1 -1
  286. package/dist/src/record-runtime.js +1 -1
  287. package/dist/src/record-trace.js +1 -1
  288. package/dist/src/recording-gestures.js +1 -1
  289. package/dist/src/recording.js +1 -1
  290. package/dist/src/rect-center.js +1 -1
  291. package/dist/src/register-builtins.js +1 -1
  292. package/dist/src/registry.js +1 -1
  293. package/dist/src/remote-config-core.js +1 -1
  294. package/dist/src/remote-config-flags.js +1 -1
  295. package/dist/src/remote-connection-state.js +1 -1
  296. package/dist/src/replay-backend-host.js +1 -1
  297. package/dist/src/replay-divergence.js +1 -1
  298. package/dist/src/replay-maestro-backend.js +2 -2
  299. package/dist/src/replay.d.ts +1 -1
  300. package/dist/src/replay2.js +1 -1
  301. package/dist/src/reporting.js +1 -1
  302. package/dist/src/request-dispatch-disclosure.js +1 -1
  303. package/dist/src/request-ended-leases.js +1 -1
  304. package/dist/src/request-providers.js +1 -1
  305. package/dist/src/request-runtime-binding.js +1 -1
  306. package/dist/src/request.js +1 -1
  307. package/dist/src/result-serialization.js +2 -2
  308. package/dist/src/retry.js +1 -1
  309. package/dist/src/run-script-execution.js +6 -8
  310. package/dist/src/run-script-http.js +1 -1
  311. package/dist/src/runner-cache-metadata.js +1 -1
  312. package/dist/src/runner-cache-retention.js +1 -1
  313. package/dist/src/runner-client.js +1 -1
  314. package/dist/src/runner-contract.js +1 -1
  315. package/dist/src/runner-dev-tools-security.js +1 -1
  316. package/dist/src/runner-device-readiness.js +1 -1
  317. package/dist/src/runner-device-set.js +1 -1
  318. package/dist/src/runner-disposal.js +1 -1
  319. package/dist/src/runner-error-classification.js +2 -2
  320. package/dist/src/runner-exchange.js +1 -1
  321. package/dist/src/runner-io.js +1 -1
  322. package/dist/src/runner-launched-session.js +1 -1
  323. package/dist/src/runner-lease.js +1 -1
  324. package/dist/src/runner-lifecycle.js +1 -1
  325. package/dist/src/runner-operations-facade.js +1 -1
  326. package/dist/src/runner-panel.js +1 -1
  327. package/dist/src/runner-retention.js +1 -1
  328. package/dist/src/runner-runtime.js +1 -1
  329. package/dist/src/runner-selector-query.js +1 -1
  330. package/dist/src/runner-sequence.js +1 -1
  331. package/dist/src/runner-start-budget.js +1 -1
  332. package/dist/src/runner-startup-transport.js +1 -1
  333. package/dist/src/runner-toolchain-identity.js +1 -1
  334. package/dist/src/runtime-admission.js +1 -1
  335. package/dist/src/runtime-deployment.js +1 -1
  336. package/dist/src/runtime-factory.js +1 -1
  337. package/dist/src/runtime-session.js +1 -1
  338. package/dist/src/runtime-transport-hints.js +1 -1
  339. package/dist/src/runtime.js +2 -2
  340. package/dist/src/runtime10.js +1 -1
  341. package/dist/src/runtime11.js +1 -1
  342. package/dist/src/runtime12.js +1 -1
  343. package/dist/src/runtime13.js +2 -2
  344. package/dist/src/runtime2.js +2 -2
  345. package/dist/src/runtime4.js +3 -3
  346. package/dist/src/runtime5.js +1 -1
  347. package/dist/src/runtime6.js +1 -1
  348. package/dist/src/runtime7.js +2 -2
  349. package/dist/src/runtime8.js +1 -1
  350. package/dist/src/runtime9.js +1 -1
  351. package/dist/src/screen-recording-admission-ledger.js +1 -0
  352. package/dist/src/screen-recording-completion.js +1 -1
  353. package/dist/src/screen-recording-options.js +1 -1
  354. package/dist/src/screen-recording-resource-recovery.js +1 -1
  355. package/dist/src/screen-recording-stop-recovery.js +1 -1
  356. package/dist/src/screen-recording-transport.js +1 -1
  357. package/dist/src/screenshot-density.js +1 -1
  358. package/dist/src/screenshot-image-size.js +1 -1
  359. package/dist/src/screenshot-image.js +1 -1
  360. package/dist/src/screenshot-runtime.js +1 -1
  361. package/dist/src/screenshot-runtime2.js +1 -1
  362. package/dist/src/screenshot.js +1 -1
  363. package/dist/src/screenshot2.js +1 -1
  364. package/dist/src/screenshot4.js +1 -1
  365. package/dist/src/script-source.js +1 -1
  366. package/dist/src/script.js +1 -1
  367. package/dist/src/scroll-command.js +1 -1
  368. package/dist/src/scroll-gesture.js +1 -1
  369. package/dist/src/sdk-batch-runner.d.ts +1 -1
  370. package/dist/src/sdk-batch-runner.js +2 -2
  371. package/dist/src/sdk-batch.js +2 -2
  372. package/dist/src/sdk-contracts.d.ts +26 -2
  373. package/dist/src/sdk-contracts.js +2 -2
  374. package/dist/src/sdk-device.js +1 -1
  375. package/dist/src/sdk-finders.d.ts +1 -1
  376. package/dist/src/sdk-finders.js +1 -1
  377. package/dist/src/sdk-io.js +5 -5
  378. package/dist/src/sdk-remote-config.d.ts +1 -1
  379. package/dist/src/sdk-remote-config.js +1 -1
  380. package/dist/src/sdk-selectors.d.ts +9 -6
  381. package/dist/src/sdk-selectors.js +1 -1
  382. package/dist/src/selection.js +0 -0
  383. package/dist/src/selector-pipeline-policy.js +1 -1
  384. package/dist/src/selector-runtime.js +1 -1
  385. package/dist/src/selectors.js +1 -1
  386. package/dist/src/server-shutdown.js +1 -1
  387. package/dist/src/server-startup.js +2 -2
  388. package/dist/src/server.js +4 -4
  389. package/dist/src/session-allocation.js +1 -1
  390. package/dist/src/session-artifact-paths.js +1 -1
  391. package/dist/src/session-capture-binding.js +1 -1
  392. package/dist/src/session-device-resolution.js +1 -1
  393. package/dist/src/session-event-action.js +1 -1
  394. package/dist/src/session-open.js +1 -1
  395. package/dist/src/session-repair-tombstone.js +1 -1
  396. package/dist/src/session-replay-vars.js +1 -1
  397. package/dist/src/session-routing.js +1 -1
  398. package/dist/src/session-runtime-admission.js +1 -1
  399. package/dist/src/session-runtime.js +1 -1
  400. package/dist/src/session-script-destination.js +1 -0
  401. package/dist/src/session-selector.js +1 -1
  402. package/dist/src/session-store.js +3 -3
  403. package/dist/src/session-teardown.js +1 -1
  404. package/dist/src/session-tenant-scope.js +1 -1
  405. package/dist/src/session2.js +5 -5
  406. package/dist/src/settings-bluetooth.js +1 -1
  407. package/dist/src/settings-global-toggle.js +1 -1
  408. package/dist/src/settings.js +1 -1
  409. package/dist/src/settings2.js +1 -1
  410. package/dist/src/settle-observation-capture.js +1 -1
  411. package/dist/src/simctl-execution.js +1 -1
  412. package/dist/src/simctl-facade.js +1 -1
  413. package/dist/src/simctl.js +1 -1
  414. package/dist/src/simulator-app-budget.js +1 -1
  415. package/dist/src/simulator-boot.js +1 -1
  416. package/dist/src/simulator-facade.js +1 -1
  417. package/dist/src/simulator-state.js +1 -1
  418. package/dist/src/simulator.js +1 -1
  419. package/dist/src/snapshot-baseline.js +1 -1
  420. package/dist/src/snapshot-chrome.js +1 -1
  421. package/dist/src/snapshot-desktop-projection.js +1 -1
  422. package/dist/src/snapshot-diagnostics.js +1 -1
  423. package/dist/src/snapshot-helper-install.js +3 -3
  424. package/dist/src/snapshot-helper-session.js +1 -1
  425. package/dist/src/snapshot-lines.js +1 -1
  426. package/dist/src/snapshot-node-lookup.js +1 -1
  427. package/dist/src/snapshot-occlusion.js +1 -1
  428. package/dist/src/snapshot-private-evidence.js +1 -1
  429. package/dist/src/snapshot-runtime-binding.js +1 -1
  430. package/dist/src/snapshot-runtime-capture-input.js +1 -1
  431. package/dist/src/snapshot-runtime.js +1 -1
  432. package/dist/src/snapshot-state.js +1 -1
  433. package/dist/src/snapshot.js +1 -1
  434. package/dist/src/snapshot2.js +1 -1
  435. package/dist/src/snapshot3.js +2 -2
  436. package/dist/src/snapshot4.js +1 -1
  437. package/dist/src/source-channel.js +1 -1
  438. package/dist/src/src.js +1 -1
  439. package/dist/src/src10.js +1 -1
  440. package/dist/src/src11.js +1 -1
  441. package/dist/src/src2.js +1 -1
  442. package/dist/src/src3.js +5 -5
  443. package/dist/src/src4.js +2 -2
  444. package/dist/src/src5.js +1 -1
  445. package/dist/src/src6.js +1 -1
  446. package/dist/src/src8.js +1 -1
  447. package/dist/src/store-legacy.js +1 -1
  448. package/dist/src/store.js +1 -1
  449. package/dist/src/string-enum.js +1 -1
  450. package/dist/src/surface-snapshot.js +1 -1
  451. package/dist/src/surface-snapshot2.js +1 -1
  452. package/dist/src/sync-cache.js +1 -1
  453. package/dist/src/system-surface-foreground.js +2 -2
  454. package/dist/src/takeover.js +1 -1
  455. package/dist/src/tap-keyboard-occlusion.js +1 -1
  456. package/dist/src/target-evidence-tree.js +1 -1
  457. package/dist/src/target-evidence.js +1 -1
  458. package/dist/src/telephony-runtime.js +1 -1
  459. package/dist/src/tool-provider-facade.js +1 -1
  460. package/dist/src/tool-provider.js +3 -3
  461. package/dist/src/tool-provider2.js +1 -1
  462. package/dist/src/tool-provider3.js +1 -1
  463. package/dist/src/toolchain-probe.js +1 -1
  464. package/dist/src/touch-runtime.js +1 -1
  465. package/dist/src/touch-runtime2.js +1 -1
  466. package/dist/src/transport.js +2 -2
  467. package/dist/src/tree.js +1 -1
  468. package/dist/src/tv-remote-runtime.js +1 -1
  469. package/dist/src/tv-remote.js +1 -1
  470. package/dist/src/type-text-runtime.js +1 -1
  471. package/dist/src/unsupported-interactor.js +1 -1
  472. package/dist/src/update-check.js +1 -1
  473. package/dist/src/validation.js +1 -1
  474. package/dist/src/vars.js +1 -1
  475. package/dist/src/vega-executable.js +1 -1
  476. package/dist/src/verified-file.js +1 -1
  477. package/dist/src/video.js +2 -2
  478. package/dist/src/viewport.js +1 -1
  479. package/dist/src/web.js +1 -1
  480. package/dist/src/webdriver-source.js +1 -1
  481. package/package.json +2 -2
  482. package/server.json +2 -2
  483. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.37.apk.sha256 +0 -1
  484. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.37.apk.sha256 +0 -1
  485. package/dist/src/capture-output-ownership.js +0 -1
@@ -1 +1 @@
1
- import{q as e}from"./sdk-contracts.js";import{t}from"./lifecycle-budget.js";const n=2e4;var r=class{settled=new Map;host;constructor(e){this.host=e}async start(r,a){let s=r.capture;if(s?.phase===`starting`){await t(s.opening,n);return}let c=this.host.harDir;if(!c){r.capture={phase:`unavailable`,reason:`capture-dir-unset`};return}let l=this.host.liveSessionOf(r);if(!l)return;let u,d=new Promise(e=>{u=e});r.capture={phase:`starting`,opening:d};let f=o(a),p=e=>{let t=r.capture;t!==void 0&&t.phase===`starting`&&t.opening===d&&(r.capture=e),u(e)};i(l.client,c,r.lease.leaseId,f).then(p,t=>p({phase:`unavailable`,reason:`tunnel-start-failed`,message:e(t)})),await d}async end(e){let r=e.lease.leaseId,i=e.capture;if(i===void 0)return this.settled.get(r);if(e.capture=void 0,i.phase!==`starting`)return await a(r,i,this.record);let o=await t(i.opening,n);return o.ok?await a(r,o.value,this.record):(i.opening.then(async e=>{await a(r,e,this.record)}).catch(()=>void 0),this.settled.get(r))}async list(e,t){if(t===void 0)return this.settled.get(e);if(t.phase!==`starting`){let{writeCaptureRecord:e}=await import(`./network-har.js`);return await e(t)}return this.settled.get(e)}record=(e,t)=>(this.settled.delete(e),this.settled.set(e,t),this.forgetRecordsOverLimit(),t);forgetRecordsOverLimit(){let e=this.heldCaptures();for(;this.settled.size+e.size>32;){let t=[...this.settled.keys()].find(t=>!e.has(t));if(t===void 0)return;this.settled.delete(t)}}heldCaptures(){let e=new Set;for(let t of this.host.heldOwners())t.capture!==void 0&&e.add(t.lease.leaseId);return e}};async function i(e,t,n,r){let{limrunHarPath:i,startLimrunHarCapture:a}=await import(`./network-har.js`),o=await a(e,r.length>0?r:void 0);return o.ok?{phase:`capturing`,harPath:i(t,n),capture:o.capture}:{phase:`unavailable`,reason:o.reason,message:o.message}}async function a(t,n,r){let{writeCaptureRecord:i}=await import(`./network-har.js`),a=await i(n).then(e=>({ok:!0,value:e}),e=>({ok:!1,error:e})),o;if(n.phase===`capturing`)try{n.capture.close()}catch(t){o=e(t)}if(!a.ok)throw o===void 0?a.error:Error(`${e(a.error)}; Capture close failed: ${o}`,{cause:a.error});let s=a.value;return r(t,o===void 0?s:{...s,closeFailure:o})}function o(e){return typeof e==`string`?e.split(`,`).map(e=>e.trim()).filter(Boolean):[]}export{n as CAPTURE_OPEN_BUDGET_MS,r as LimrunCaptureLifecycle};
1
+ import{A as e}from"./sdk-contracts.js";import{t}from"./lifecycle-budget.js";const n=2e4;var r=class{settled=new Map;host;constructor(e){this.host=e}async start(r,a){let s=r.capture;if(s?.phase===`starting`){await t(s.opening,n);return}let c=this.host.harDir;if(!c){r.capture={phase:`unavailable`,reason:`capture-dir-unset`};return}let l=this.host.liveSessionOf(r);if(!l)return;let u,d=new Promise(e=>{u=e});r.capture={phase:`starting`,opening:d};let f=o(a),p=e=>{let t=r.capture;t!==void 0&&t.phase===`starting`&&t.opening===d&&(r.capture=e),u(e)};i(l.client,c,r.lease.leaseId,f).then(p,t=>p({phase:`unavailable`,reason:`tunnel-start-failed`,message:e(t)})),await d}async end(e){let r=e.lease.leaseId,i=e.capture;if(i===void 0)return this.settled.get(r);if(e.capture=void 0,i.phase!==`starting`)return await a(r,i,this.record);let o=await t(i.opening,n);return o.ok?await a(r,o.value,this.record):(i.opening.then(async e=>{await a(r,e,this.record)}).catch(()=>void 0),this.settled.get(r))}async list(e,t){if(t===void 0)return this.settled.get(e);if(t.phase!==`starting`){let{writeCaptureRecord:e}=await import(`./network-har.js`);return await e(t)}return this.settled.get(e)}record=(e,t)=>(this.settled.delete(e),this.settled.set(e,t),this.forgetRecordsOverLimit(),t);forgetRecordsOverLimit(){let e=this.heldCaptures();for(;this.settled.size+e.size>32;){let t=[...this.settled.keys()].find(t=>!e.has(t));if(t===void 0)return;this.settled.delete(t)}}heldCaptures(){let e=new Set;for(let t of this.host.heldOwners())t.capture!==void 0&&e.add(t.lease.leaseId);return e}};async function i(e,t,n,r){let{limrunHarPath:i,startLimrunHarCapture:a}=await import(`./network-har.js`),o=await a(e,r.length>0?r:void 0);return o.ok?{phase:`capturing`,harPath:i(t,n),capture:o.capture}:{phase:`unavailable`,reason:o.reason,message:o.message}}async function a(t,n,r){let{writeCaptureRecord:i}=await import(`./network-har.js`),a=await i(n).then(e=>({ok:!0,value:e}),e=>({ok:!1,error:e})),o;if(n.phase===`capturing`)try{n.capture.close()}catch(t){o=e(t)}if(!a.ok)throw o===void 0?a.error:Error(`${e(a.error)}; Capture close failed: ${o}`,{cause:a.error});let s=a.value;return r(t,o===void 0?s:{...s,closeFailure:o})}function o(e){return typeof e==`string`?e.split(`,`).map(e=>e.trim()).filter(Boolean):[]}export{n as CAPTURE_OPEN_BUDGET_MS,r as LimrunCaptureLifecycle};
@@ -1 +1 @@
1
- import{P as e}from"./sdk-contracts.js";import{t}from"./screenshot.js";import{y as n}from"./sdk-batch-runner.js";import"./capture.js";import{a as r}from"./sdk-device.js";import{g as i}from"./src3.js";import{i as a}from"./flag-registry.js";import{N as o}from"./device.js";import{l as s,u as c}from"./file.js";import{a as l,n as u,r as d,t as f}from"./merge-flags.js";import p from"node:fs";import m from"node:path";function h(e){let t={flags:{}};for(let n of _(e.cwd,e.cliFlags.config,e.env)){let e=y(n);f(t.flags,e.flags),e.devicePin&&(t.devicePin=e.devicePin)}return f(t.flags,w(e.env,e.command)),t.devicePin&&f(t.flags,t.devicePin.selector),t}const g=a();function _(e,t,n){let r=t??n.AGENT_DEVICE_CONFIG;return r?[{path:v(r,e,n),required:!0,source:`explicit`}]:[{path:s(n),required:!1,source:`user`},{path:m.resolve(e,`agent-device.json`),required:!1,source:`project`}]}function v(e,t,n){return c(e,{cwd:t,env:n})}function y(t){let{path:r,required:i}=t;if(!p.existsSync(r)){if(i)throw new e(`INVALID_ARGS`,`Config file not found: ${r}`);return{flags:{}}}let a;try{a=p.readFileSync(r,`utf8`)}catch(t){throw new e(`INVALID_ARGS`,`Failed to read config file: ${r}`,{cause:t instanceof Error?t.message:String(t)})}let s;try{s=JSON.parse(a)}catch(t){throw new e(`INVALID_ARGS`,`Invalid JSON in config file: ${r}`,{cause:t instanceof Error?t.message:String(t)})}if(!n(s))throw new e(`INVALID_ARGS`,`Config file must contain a JSON object: ${r}`);let{devicePin:c,...l}=s,u={flags:S(l,{source:t.source,label:b(t)})};return c!==void 0&&(u.devicePin={selector:o(c,b(t)),source:{kind:t.source,path:t.path}}),u}function b(e){return`${e.source===`project`?`project `:``}config file ${e.path}`}const x={flagKey:`record`,envVar:`AGENT_DEVICE_RECORD`,migration:`--record is per-invocation only: pass --record on the command, or record: true in the SDK/MCP call, to keep a corrective read in a healed script`};function S(n,r){let a={},o=Object.entries(n).filter(([e])=>e!==`plugins`||r.source!==`user`);for(let[n,s]of o){if(n===x.flagKey)throw new e(`INVALID_ARGS`,`Config key "${n}" in ${r.label} was removed; ${x.migration}.`);let o=n,c=d(o);if(!c)throw n===t.flagKey?new e(`INVALID_ARGS`,`Config key "${n}" in ${r.label} was removed; use "screenshotScale" (0.01-1) to downscale screenshots. Recordings capture at native resolution.`):new e(`INVALID_ARGS`,`Unknown config key "${n}" in ${r.label}.`);if(!c.configurable)throw new e(`INVALID_ARGS`,`Config key "${n}" is not allowed in ${r.label}. This key is not supported in config files.`);if(r.source===`project`&&!g.has(o))throw new e(`INVALID_ARGS`,`Config key "${n}" is not allowed in ${r.label}. Move it to ~/.agent-device/config.json, pass it with --config or AGENT_DEVICE_CONFIG, or provide it through CLI flags/environment variables.`);if(o===`installSource`){a.installSource=i(s,r.label);continue}a[o]=l(c,s,r.label,n)}return a}const C=new Set([`screenshot`,`record`]);function w(n,r){if(r!==null&&d(x.flagKey)?.supportsCommand(r)===!0&&typeof n[x.envVar]==`string`&&n[x.envVar].trim().length>0)throw new e(`INVALID_ARGS`,`${x.envVar} was removed; ${x.migration}.`);let i=n[t.envVar];if(r!==null&&C.has(r)&&typeof i==`string`&&i.trim().length>0)throw new e(`INVALID_ARGS`,`${t.envVar} was removed. ${t.migration[r===`record`?`record`:`screenshot`]}`);let a={};for(let e of u(r)){if(e.key===`installSource`)continue;let t=e.env.names.map(e=>({name:e,value:n[e]})).find(e=>typeof e.value==`string`&&e.value.trim().length>0);t&&(a[e.key]=l(e,t.value,`environment variable ${t.name}`,t.name))}return a}function T(e,t){let n=E(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function E(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??O(t.AGENT_DEVICE_PLATFORM),r=j(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:D(e.policyOverrides,t,r)}}function D(e,t,n){let r=e?.sessionLock??A(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function O(t){if(t===void 0)return;let n=t.trim().toLowerCase();if(n){if(k(n))return n;throw new e(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${t}. Use one of: ${r.join(`, `)}.`)}}function k(e){return r.includes(e)}function A(t){if(t===void 0)return;let n=t.trim().toLowerCase();if(n){if(n===`reject`||n===`strip`)return n;throw new e(`INVALID_ARGS`,`Invalid session lock mode: ${t}. Use reject or strip.`)}}function j(e){return typeof e==`string`&&e.trim().length>0}export{E as n,h as r,T as t};
1
+ import{_ as e}from"./sdk-contracts.js";import{t}from"./screenshot.js";import{y as n}from"./sdk-batch-runner.js";import"./capture.js";import{a as r}from"./sdk-device.js";import{g as i}from"./src3.js";import{i as a}from"./flag-registry.js";import{N as o}from"./device.js";import{l as s,u as c}from"./file.js";import{a as l,n as u,r as d,t as f}from"./merge-flags.js";import p from"node:fs";import m from"node:path";function h(e){let t={flags:{}};for(let n of _(e.cwd,e.cliFlags.config,e.env)){let e=y(n);f(t.flags,e.flags),e.devicePin&&(t.devicePin=e.devicePin)}return f(t.flags,w(e.env,e.command)),t.devicePin&&f(t.flags,t.devicePin.selector),t}const g=a();function _(e,t,n){let r=t??n.AGENT_DEVICE_CONFIG;return r?[{path:v(r,e,n),required:!0,source:`explicit`}]:[{path:s(n),required:!1,source:`user`},{path:m.resolve(e,`agent-device.json`),required:!1,source:`project`}]}function v(e,t,n){return c(e,{cwd:t,env:n})}function y(t){let{path:r,required:i}=t;if(!p.existsSync(r)){if(i)throw new e(`INVALID_ARGS`,`Config file not found: ${r}`);return{flags:{}}}let a;try{a=p.readFileSync(r,`utf8`)}catch(t){throw new e(`INVALID_ARGS`,`Failed to read config file: ${r}`,{cause:t instanceof Error?t.message:String(t)})}let s;try{s=JSON.parse(a)}catch(t){throw new e(`INVALID_ARGS`,`Invalid JSON in config file: ${r}`,{cause:t instanceof Error?t.message:String(t)})}if(!n(s))throw new e(`INVALID_ARGS`,`Config file must contain a JSON object: ${r}`);let{devicePin:c,...l}=s,u={flags:S(l,{source:t.source,label:b(t)})};return c!==void 0&&(u.devicePin={selector:o(c,b(t)),source:{kind:t.source,path:t.path}}),u}function b(e){return`${e.source===`project`?`project `:``}config file ${e.path}`}const x={flagKey:`record`,envVar:`AGENT_DEVICE_RECORD`,migration:`--record is per-invocation only: pass --record on the command, or record: true in the SDK/MCP call, to keep a corrective read in a healed script`};function S(n,r){let a={},o=Object.entries(n).filter(([e])=>e!==`plugins`||r.source!==`user`);for(let[n,s]of o){if(n===x.flagKey)throw new e(`INVALID_ARGS`,`Config key "${n}" in ${r.label} was removed; ${x.migration}.`);let o=n,c=d(o);if(!c)throw n===t.flagKey?new e(`INVALID_ARGS`,`Config key "${n}" in ${r.label} was removed; use "screenshotScale" (0.01-1) to downscale screenshots. Recordings capture at native resolution.`):new e(`INVALID_ARGS`,`Unknown config key "${n}" in ${r.label}.`);if(!c.configurable)throw new e(`INVALID_ARGS`,`Config key "${n}" is not allowed in ${r.label}. This key is not supported in config files.`);if(r.source===`project`&&!g.has(o))throw new e(`INVALID_ARGS`,`Config key "${n}" is not allowed in ${r.label}. Move it to ~/.agent-device/config.json, pass it with --config or AGENT_DEVICE_CONFIG, or provide it through CLI flags/environment variables.`);if(o===`installSource`){a.installSource=i(s,r.label);continue}a[o]=l(c,s,r.label,n)}return a}const C=new Set([`screenshot`,`record`]);function w(n,r){if(r!==null&&d(x.flagKey)?.supportsCommand(r)===!0&&typeof n[x.envVar]==`string`&&n[x.envVar].trim().length>0)throw new e(`INVALID_ARGS`,`${x.envVar} was removed; ${x.migration}.`);let i=n[t.envVar];if(r!==null&&C.has(r)&&typeof i==`string`&&i.trim().length>0)throw new e(`INVALID_ARGS`,`${t.envVar} was removed. ${t.migration[r===`record`?`record`:`screenshot`]}`);let a={};for(let e of u(r)){if(e.key===`installSource`)continue;let t=e.env.names.map(e=>({name:e,value:n[e]})).find(e=>typeof e.value==`string`&&e.value.trim().length>0);t&&(a[e.key]=l(e,t.value,`environment variable ${t.name}`,t.name))}return a}function T(e,t){let n=E(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function E(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??O(t.AGENT_DEVICE_PLATFORM),r=j(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:D(e.policyOverrides,t,r)}}function D(e,t,n){let r=e?.sessionLock??A(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function O(t){if(t===void 0)return;let n=t.trim().toLowerCase();if(n){if(k(n))return n;throw new e(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${t}. Use one of: ${r.join(`, `)}.`)}}function k(e){return r.includes(e)}function A(t){if(t===void 0)return;let n=t.trim().toLowerCase();if(n){if(n===`reject`||n===`strip`)return n;throw new e(`INVALID_ARGS`,`Invalid session lock mode: ${t}. Use reject or strip.`)}}function j(e){return typeof e==`string`&&e.trim().length>0}export{E as n,h as r,T as t};
@@ -1,4 +1,4 @@
1
- import{r as e}from"./rolldown-runtime.js";import{Br as t}from"./sdk-batch.js";import{i as n}from"./catalog.js";import{E as r,L as i,T as a}from"./src3.js";import{n as o}from"./flag-registry.js";import{n as s,r as c}from"./command-schema.js";import{a as l}from"./version.js";import{n as u}from"./cli-command-aliases.js";import{n as d}from"./provider-plugin-catalog.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 (up to 10000 characters), 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 (a map-form argument key gains a leading - unless its value is a boolean, as in Maestro), 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; override keys follow the flow variable grammar (mixed case and dots allowed), and AD_* stays reserved.`,`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 via node:vm, which is not a security sandbox. runScript runs in a daemon child process with a 30 s script budget. It may make http.post network requests (30 s each, response bodies up to 8 MiB), and its output keys cannot contain a dot. Remote flows refuse runScript before reading its file, including files supplied in the replay bundle, and refuse evalScript and true: fields that need JavaScript. Run these scripts only in trusted local flows. Local runScript paths refer to the daemon filesystem: relative paths resolve from the containing flow, and absolute paths and symlinks are allowed.`,`Remote screenshots: takeScreenshot uses a daemon-generated path and reports that path in artifactPaths. The flow cannot choose a file destination on the daemon host. Animation waits and tap retry comparisons use temporary screenshots that are removed after comparison.`,`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(`
1
+ import{r as e}from"./rolldown-runtime.js";import{Ur as t}from"./sdk-batch.js";import{i as n}from"./catalog.js";import{E as r,L as i,T as a}from"./src3.js";import{n as o}from"./flag-registry.js";import{n as s,r as c}from"./command-schema.js";import{a as l}from"./version.js";import{n as u}from"./cli-command-aliases.js";import{n as d}from"./provider-plugin-catalog.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 (up to 10000 characters), 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 (a map-form argument key gains a leading - unless its value is a boolean, as in Maestro), 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; override keys follow the flow variable grammar (mixed case and dots allowed), and AD_* stays reserved.`,`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 via node:vm, which is not a security sandbox. runScript runs in a daemon child process with a 30 s script budget. It may make http.post network requests (30 s each, response bodies up to 8 MiB), and its output keys cannot contain a dot. Remote flows refuse runScript before reading its file, including files supplied in the replay bundle, and refuse evalScript and true: fields that need JavaScript. Run these scripts only in trusted local flows. Local runScript paths refer to the daemon filesystem: relative paths resolve from the containing flow, and absolute paths and symlinks are allowed.`,`Remote screenshots: takeScreenshot uses a daemon-generated path and reports that path in artifactPaths. The flow cannot choose a file destination on the daemon host. Animation waits and tap retry comparisons use temporary screenshots that are removed after comparison.`,`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
2
  `)}const h={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.
@@ -17,7 +17,7 @@ Shapes:
17
17
  agent-device gesture tap 80 300 200 450 310 600 --count 20 --pause-ms 100
18
18
  scroll <dir> --until <selector> repeats scroll-and-check passes until that element is on screen, then stops: one request instead of a scroll-then-snapshot loop, and it stops on the target rather than overshooting it. It reports the passes it spent; vertical searches compare repeated captures of descendants in the selected scroll container and fail when those captures show no progress. If no container is found, they compare the visible tree. It is refused on top/bottom, which already stop themselves. The default limit is 12 gestures. For a longer list, add --max-passes <n> (1–200); it requires --until. Large pass budgets can hit the 90-second request timeout; inspect the current screen and continue with another search if that happens.
19
19
  longpress accepts coordinates, @refs, or selectors; prefer @ref/selector, coordinates only as a fallback. Duration and gesture scale/center are positional. gesture pan is one finger by default; add --pointer-count 2 for a parallel two-finger pan. Keep count/pause/pattern on one swipe: --count (cap 200), --pause-ms (cap 10000ms), --pattern ping-pong; the combined swipe/pause schedule is capped at 60000ms.
20
- For repeated iOS smoke checks: press <x> <y> --count <n> --jitter-px <n> for tap series, swipe <x1> <y1> <x2> <y2> --count <n> for drag series. gesture tap touches 2 to 5 distinct points and holds them for --hold-ms (default 50, min 16); --count repeats the same contacts (cap 200) with --pause-ms between, the series must fit 60000ms counting about 500ms per repetition, and a repetition costs about 450ms on a physical iPhone. Use press for one finger.
20
+ For repeated iOS smoke checks: press <x> <y> --count <n> --jitter-px <n> for tap series, swipe <x1> <y1> <x2> <y2> --count <n> for drag series. gesture tap touches 2 to 5 distinct points and holds them for --hold-ms (default 50, min 16); --count repeats the same contacts (cap 200) with --pause-ms between, the series must fit 60000ms counting about 500ms per repetition, and a repetition costs about 450ms on a physical iPhone. Use press for one finger. For repeated keys (PIN pad), enter the plan in one command: press @e13,@e14,@e15,@e16 (2 to 16 refs, one press per key, a repeated ref presses the same key twice, click takes the same form); the whole plan resolves and admits against the current frame before the first press, key 1 expires the frame, later keys tap where the snapshot showed them, so re-snapshot and rebuild the plan when the screen can move between keys; a later key that refuses carries details.dispatchedSteps counting the keys already sent, --interval-ms sets the key delay, and --count/--hold-ms/--jitter-px/--double-tap apply to every key.
21
21
 
22
22
  Platform quirks:
23
23
  If rotation stops repeated iOS presses, inspect the screen before continuing with the remaining presses.
@@ -67,7 +67,7 @@ Loop:
67
67
  3. Run press/fill/click/longpress <ref-or-selector> --settle for each mutating step.
68
68
  4. Treat a settled:true diff as the next observation. Do not add wait stable or another snapshot when the diff already shows the next target or expected result.
69
69
  5. If --settle prints not settled, follow its hint before the next ref-based action.
70
- 6. Verify named expectations with wait text/selector/absent, get, is, find, or the settled diff. A bare screenshot/snapshot is not verification for a named expectation.
70
+ 6. Verify named expectations with wait text/selector/absent, get, is, find text "..." exists, or the settled diff. Bare find clicks. A bare screenshot/snapshot is not verification for a named expectation.
71
71
  7. Close the session when the script ends. If your session booted a local simulator or emulator, use close --shutdown, unless the user asks to keep it running.
72
72
 
73
73
  Command shapes:
@@ -304,7 +304,7 @@ Loop:
304
304
  1. Build or prepare the changed surface with the repo command that owns it.
305
305
  2. Open the target app/device state explicitly.
306
306
  3. Use snapshot -i and press/fill/click/longpress --settle for UI-driving steps.
307
- 4. Use the settled diff as evidence when it shows the changed behavior; otherwise verify with wait/get/is/find, screenshot, logs, network, perf, or trace based on the claim.
307
+ 4. Use the settled diff as evidence when it shows the changed behavior; otherwise verify with wait/get/is, find text "..." exists, screenshot, logs, network, perf, or trace based on the claim.
308
308
  5. Record timings, token/output size, screenshots/videos, logs, or perf artifacts only when they answer the validation question.
309
309
  6. Close sessions and release leases before finishing. If your session booted a local simulator or emulator, use close --shutdown, unless the user asks to keep it running.
310
310
 
@@ -339,7 +339,8 @@ Loop:
339
339
  acts, waits for quiet, and prints the UI diff. Continue from that diff.
340
340
  Run snapshot -i only when the diff lacks the next target or did not settle.
341
341
  Verify a named expectation with the diff, wait text "...", wait <selector>, wait absent <selector>,
342
- is, get, or find. A bare screenshot is not verification.
342
+ is, or get. A bare screenshot is not verification.
343
+ find acts: it clicks by default. To check only, use find text "..." exists.
343
344
  End with: agent-device close
344
345
 
345
346
  Targets:
@@ -385,7 +386,7 @@ Changing the pose:
385
386
  Expect a fold to take 2-4 seconds: half-open waits for two agreeing hinge reads one second apart, and the first fold after a boot can take longer while the hinge settles. Re-snapshot after every fold; refs and coordinates from before it are stale, and the command's message says so.
386
387
  Timed motion: fold --keyframes '[{"atMs":0,"angle":0},{"atMs":5000,"angle":180}]'. Use 2–64 frames starting at 0ms, increasing integer timestamps up to 60000ms, and angles from 0 to 180. The last timestamp sets motion duration, excluding setup and verification. Equal angles hold; cancellation stops motion. See the fold examples in the command and Node API documentation for trajectories.
387
388
 
388
- Requirements: an iOS simulator session on a foldable device and an Xcode toolchain with the iOS simulator SDK and foldable HID support (verified on Xcode 27.1). Device Hub and host Accessibility permission are not required. The command runs a small helper through simctl spawn for the session UDID; the helper is built once per Fold.m source hash and Xcode toolchain, cached under ~/.agent-device/fold-helper, and rebuilt only when the source or the toolchain changes. The same helper reads the hinge and, in a scoped set, the panels. Build or dispatch failures are reported without a UI fallback. The app under test reads the resulting pose as UIHinge.status.
389
+ Requirements: an iOS simulator session on a foldable device and an Xcode toolchain with the iOS simulator SDK and foldable HID support (verified on Xcode 27.1). Device Hub and host Accessibility permission are not required. The command runs a small helper through simctl spawn for the session UDID; the helper is built once per Fold.m source hash and Xcode toolchain, cached under ~/.agent-device/fold-helper, and rebuilt only when the source or the toolchain changes. The same helper reads the hinge and the panels in either simulator set. Build or dispatch failures are reported without a UI fallback. The app under test reads the resulting pose as UIHinge.status.
389
390
  Android emulators: fold sets the posture through the emulator console (adb emu posture 1|2|3), then reads adb shell cmd device_state print-state until the guest commits CLOSED, HALF_OPENED, or OPENED, and reports the angle read from the hinge sensor. It can differ from the AVD profile's per-posture angles: 0, 90 and 180 degrees on the Pixel folds, 15, 90 and 165 on the generic 7.6in Foldable. Folding to the cover display can raise Android's "Swipe up to continue" lock screen; fold dismisses it so the app stays reachable. An emulator profile without those device states (a phone) fails with UNSUPPORTED_OPERATION and reason single-panel-device, and a physical device is refused. Keyframes are not supported on Android, and the response carries no panel geometry: re-snapshot after every fold.
390
391
  If a task asserts behavior for more than one pose, fold to each pose and re-snapshot, and report which poses the run covered.`},k={summary:`React Native app automation hazards and routing`,body:`agent-device help react-native
391
392
 
@@ -407,7 +408,7 @@ React Native dev loop:
407
408
  For "start from screen X" flows, prefer open --relaunch before the first snapshot so the app does not reuse a prior in-progress navigation state.
408
409
  JS-only change with Metro or Re.Pack connected:
409
410
  agent-device metro reload
410
- agent-device find "Home"
411
+ agent-device wait text "Home"
411
412
  Do not use agent-device reload. Use open --relaunch for native startup reset.
412
413
  Android RN/Expo/Re.Pack dev server: direct Android localhost URL opens with a port auto-configure host reachability. For app/package launches, run metro prepare when the app cannot reach the local dev server.
413
414
  Verify Metro/Re.Pack from the same host context that owns the dev server. If a sandboxed shell cannot curl localhost:8081/status but an unrestricted host shell can, the dev server is running and the sandbox probe is not authoritative.
@@ -500,8 +501,8 @@ Selectors:
500
501
  Text entry:
501
502
  fill replaces; type appends to an already-focused field: fill 'id="field-email"' "qa@example.com"; type "Handle with care" --delay-ms 80
502
503
  fill <target> "" clears the field (replace with nothing); the empty argument must be present -- fill <target> alone is a missing argument.
503
- For dropped iOS text, retry with --delay-ms before clipboard paste. This also applies to Limrun iOS, which uses the same Apple runner.
504
- Element presses behind the keyboard are refused with tap_keyboard_occludes_target. keyboard dismiss taps its own dismiss key when one exists, else UNSUPPORTED_OPERATION. Android: try dismiss before back. iOS: when both fail, do not tap a static text/heading hoping it is safe; prefer type "\\n" to submit.
504
+ For dropped iOS text, retry with --delay-ms before clipboard paste (also Limrun iOS).
505
+ Element presses behind the keyboard are refused with tap_keyboard_occludes_target. keyboard dismiss taps its own dismiss key when one exists, else UNSUPPORTED_OPERATION (error.details.reason keyboard_dismiss_unavailable). Android: try dismiss before back. iOS: when both fail, never tap static text/headings; prefer type "\\n" to submit.
505
506
  iOS paste-prompt limits and Android IME/handwriting capture quirks: help debugging.
506
507
 
507
508
  Session ordering:
@@ -509,7 +510,7 @@ Session ordering:
509
510
 
510
511
  Read-only and waits:
511
512
  ${C}
512
- 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>.
513
+ snapshot/get/is 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>.
513
514
  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.
514
515
 
515
516
  Navigation:
@@ -517,12 +518,12 @@ Navigation:
517
518
 
518
519
  Validation and evidence:
519
520
  Nearby mutation diff: diff snapshot -i; with no prior snapshot it initializes the baseline (zero changes) instead of failing.
520
- Named expectations need the exact text/selector via wait/is/get/find -- a bare screenshot/snapshot is not verification. Before declaring a task done, confirm the requested end state is actually visible on the current screen, scrolling it into view if needed; get text alone, or stopping one screen early, is not enough.
521
+ Named expectations need the exact text/selector via wait/is/get -- a bare screenshot/snapshot is not verification. Before declaring a task done, confirm the requested end state is actually visible on the current screen, scrolling it into view if needed; get text alone, or stopping one screen early, is not enough.
521
522
  When an action only reveals or reaches a target, verify the exact target named, not just the action. Prefer testIDs/ids/selectors over visible text. Icon/tappable proof: screenshot --overlay-refs; if snapshot is sparse/AX-unavailable, use plain screenshot and coordinates, then retry snapshot -i on another screen.
522
523
  iOS merged: child ref => press it; else press parent @ref --settle. Names are not selectors.
523
524
  Perf/memory/log/network/trace/crash: help debugging. Recording, save-script, batch, replay repair: help scripting.
524
525
 
525
- 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.
526
+ React Native: help react-native for Metro/Re.Pack reload, DevTools, RN overlays. JS-only change: metro reload, wait text "Home"; open --relaunch for native reset.
526
527
 
527
528
  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.
528
529
 
@@ -544,7 +545,7 @@ Escalate:
544
545
  Use this for reusable .ad script authoring (save-script), scripted destination guards, secret-safe fills, batch multi-step JSON, replay divergence/repair, and evidence recording.
545
546
 
546
547
  Script paths are the caller's:
547
- replay <path> and test <path-or-glob> resolve and read on the machine running the command, then send the script content (Maestro runFlow includes too) with the request. The same flows therefore run against a local daemon and against a remote one (AGENT_DEVICE_DAEMON_BASE_URL) with no copy step, and a missing script fails immediately, naming the path you typed. --save-script writes on the DAEMON host and is rejected against a remote daemon.
548
+ replay <path> and test <path-or-glob> resolve and read on the machine running the command, then send the script content (Maestro runFlow includes too) with the request. The same flows therefore run against a local daemon and against a remote one (AGENT_DEVICE_DAEMON_BASE_URL) with no copy step, and a missing script fails immediately, naming the path you typed. Against a remote daemon, outside a macOS app lease, open --save-script=<path> names a caller file: after each recorded action the client refreshes it with the recording so far, and close writes the final script there, as a local close does. An existing file is refused unless you pass --force. A session that another process closes keeps the version from the last recorded action. Remote session save-script, replay/close --save-script, and --save-script in batch steps are refused. A daemon without the script-artifacts capability is refused before the open.
548
549
  test --json marks a failed test with infrastructure: true only when the owning runtime classified a device, runner, boot, or transport failure. It remains a failed test; consumers may use the tag to distinguish "the oracle did not run" from a behavioral replay divergence without weakening either gate.
549
550
 
550
551
  Script line grammar:
@@ -691,7 +692,7 @@ Example:
691
692
 
692
693
  Device busy and ownership:
693
694
  DEVICE_IN_USE has two flavors. "already in use by session X" is this daemon's session table: reuse it with --session X, or run close --session X first. "owned by session X in workspace Y" is the host-global device claim another session — from this daemon or another worktree's daemon — or an in-flight command holds; there may be no session to close, and it is never retriable, so run the error's exact recovery command instead of retrying.
694
- Inspect ownership without any daemon: agent-device device status (add --stale for proven-dead owners; settle and release those with agent-device device release --stale). devices marks rows that are claimed, so pick an unclaimed device instead of contending.
695
+ Inspect ownership without any daemon: agent-device device status (add --stale to list the claims it hides: dead, PID-reused, missing-state-directory, and daemon-replaced owners, some of which may still run; agent-device device release --stale settles and releases only owners proven unable to release). Its devices list inspects whether a new session can take each claimed device: acquirable true means no claim blocks it, false names the reason in blockedBy (live-owner, owner-pid-reused, owner-process-still-running, owner-liveness-unknown, claim-record-inconsistent, or a resource such as screen-recording-cleanup-pending that still waits for disposal). owner names the claim's owner when its record decodes: the holder that blocks the device, or, when acquirable, the reclaimable dead owner open would settle. It is an inspection, not a promise: status cannot see a reboot and runs no recovery, so open may decide differently, and a daemon's own abandoned claim, which status reports as blocked by that live owner, open through that same daemon may still take. A dead or replaced owner that retains nothing does not block by itself. hiddenStaleClaims counts the claim records this view hides and is not an availability signal, so read acquirable: a hidden owner whose PID was reused or whose state directory is gone, and pending resource cleanup, each still block the device. devices marks rows that are claimed, so pick an unclaimed device instead of contending.
695
696
  A live foreign owner is released by closing its session from its own workspace or stopping its daemon: agent-device daemon stop --state-dir <owner state dir> (the error names the state dir). The device itself can settle a claim: when it rebooted after that claim was taken, its app, runner, and accessibility session were destroyed, so open reconciles the owner's resources, takes the claim, and reports the release in warnings. Never recover by hunting PIDs with ps/kill. boot/install/shutdown take the same claims as open and refuse foreign-claimed devices identically; they do not ask the device about its boot.
696
697
 
697
698
  Use snapshot, screenshot, logs, network, perf frames, and perf memory for device/app runtime evidence. Use react-devtools when component internals or React rendering performance matter.`},cdp:{summary:`React Native CDP targets, JS heap snapshots, and leak triage`,body:`agent-device help cdp
@@ -849,8 +850,10 @@ Device cloud interfaces:
849
850
 
850
851
  Direct proxy flow for a remote Mac/simulator:
851
852
  On the Mac with simulator/device access:
852
- agent-device proxy --port 4310
853
853
  cloudflared tunnel --url http://127.0.0.1:4310
854
+ # In a second terminal, after the tunnel reports its public name:
855
+ agent-device proxy --port 4310 --public-origin https://example.trycloudflare.com
856
+ Forwarding headers do not set upload ticket origins. For an ephemeral tunnel, obtain its public name, then configure and restart the proxy.
854
857
  On the remote client:
855
858
  export AGENT_DEVICE_SESSION=checkout-agent
856
859
  agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>
@@ -962,7 +965,7 @@ Rules:
962
965
  connect and disconnect are top-level commands. Do not write agent-device remote connect or agent-device remote disconnect.
963
966
  Use connect without --remote-config when the cloud control plane owns the connection profile.
964
967
  Prefer connect --remote-config over --daemon-base-url, --tenant, --run-id, and --lease-id when using a local profile.
965
- Use agent-device proxy for direct tunnel access to a Mac you control. Expose the printed proxy URL through cloudflared/ngrok, then run agent-device connect proxy with the tunnel URL and printed token before normal commands.
968
+ Use agent-device proxy for direct tunnel access to a Mac you control. Expose the proxy through cloudflared/ngrok, configure --public-origin with the public tunnel origin, then run agent-device connect proxy with the tunnel URL and printed token before normal commands.
966
969
  Use Limrun, BrowserStack, AWS Device Farm, TestMu AI, and Revyl through local provider profiles; they do not accept a remote agent-device daemon URL.
967
970
  Device cloud credentials must be available before the command starts. Limrun uses LIMRUN_API_KEY, or the LIM_*_INSTANCE_* variables for an existing instance. BrowserStack uses BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY. TestMu AI uses LT_USERNAME and LT_ACCESS_KEY. Revyl uses REVYL_API_KEY, with REVYL_API_URL to point at another Revyl backend. AWS Device Farm uses the AWS CLI credential chain, including CI-provided AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY/AWS_SESSION_TOKEN, AWS profiles, or web identity role variables.
968
971
  A local daemon keeps the Limrun, BrowserStack, TestMu AI, and Revyl credentials it started with. When the shell holds different ones, the first command that allocates a lease refuses with reason provider-credentials-changed; run agent-device daemon stop with the same --state-dir, then rerun the command. A shell that sets none of them uses the daemon's. A daemon with an HTTP auth hook serves remote callers and does not compare.
@@ -1,29 +1,29 @@
1
- import{T as e}from"./sdk-contracts.js";import{y as t}from"./sdk-batch-runner.js";import{ci as n,p as r}from"./sdk-batch.js";import{i}from"./src3.js";import{t as a}from"./success-text.js";import{a as o,i as s,n as c,o as l,r as u,s as ee}from"./output-common.js";import{n as te}from"./snapshot-lines.js";import{t as ne}from"./snapshot.js";function re(e){let t=[`Batch completed: ${e.executed}/${e.total} steps in ${e.totalDurationMs}ms`];for(let n of e.results)t.push(f(n));return{data:e,text:t.join(`
2
- `)}}const d={batch:l(re)};function f(e){let t=a(e.data)??e.command;return`${e.step}. OK ${t} (${e.durationMs}ms)`}function ie(e){if(!Array.isArray(e)||e.length===0)return e;let t=n(e);return e.map(e=>{let n=p(e,t,e=>e.label),r=p(e,t,e=>e.identifier),i=typeof e.label==`string`&&e.label.length>=24&&e.label===n,a=typeof e.identifier==`string`&&e.identifier.length>=24&&e.identifier===r;if(!i&&!a)return e;let o={...e};return i&&(delete o.label,o.inheritsLabel=!0),a&&(delete o.identifier,o.inheritsIdentifier=!0),o})}function p(e,t,n){let r=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;r;){let e=n(r);if(typeof e==`string`&&e.length>0)return e;r=typeof r.parentIndex==`number`?t.get(r.parentIndex):void 0}}async function m(e){let{serializeSnapshotResult:t}=await import(`./result-serialization.js`).then(e=>e.n),n=t(e.raw||!Array.isArray(e.result.nodes)?e.result:{...e.result,nodes:ie(e.result.nodes)});return{data:n,jsonData:oe(n),stderr:e.result.snapshotDiagnostics?.warning?`${e.result.snapshotDiagnostics.warning}\n`:void 0,text:ne(n,{raw:e.raw,flatten:e.interactiveOnly,scoped:typeof e.scope==`string`&&e.scope.trim().length>0,depthLimited:typeof e.depth==`number`})}}const ae={snapshot:async({input:e,result:t})=>await m({result:t,raw:e.raw,interactiveOnly:e.interactiveOnly,scope:e.scope,depth:e.depth}),wait:u,alert:u,settings:u};function oe(e){let{unchanged:t,...n}=e;return n}function se(e){let t=[e.outPath,e.message];t.push(...le(e));for(let n of e.matchedImages)t.push(`Matched: ${n.name} ${n.uuid}${n.arch?` ${n.arch}`:``}`);for(let n of e.warnings??[])t.push(`Warning: ${n}`);return{data:e,text:t.join(`
3
- `)}}const ce={debug:l(se)};function le(e){let t=e.crash,n=[`Crash: ${t.appName??`unknown app`}${t.crashedThread===void 0?``:` thread ${t.crashedThread}`}`];t.bundleId&&n.push(`Bundle: ${t.bundleId}`),t.exceptionType&&n.push(`Exception: ${t.exceptionType}`),t.terminationReason&&n.push(`Termination: ${t.terminationReason}`);for(let e of t.topFrames)n.push(`Frame ${e.index}: ${e.image} ${e.symbol??e.address}`);for(let e of t.findings)n.push(`Finding: ${e}`);return n}function ue(e){return t=>{let n=e(t);return n instanceof Promise?n.then(h):h(n)}}function h(e){return{data:e.data,text:de(e.text,e.data)}}function g(e){let t={...e};for(let[n,i]of Object.entries(e))r(n)&&(t[n]=ue(i));return t}function de(e,t){return`${e??``}${fe(t.settle)}`}function fe(e){if(!e||typeof e!=`object`)return``;let t=e,n=[ge(t),...pe(t),...he(t)];return t.hint&&n.push(`hint: ${t.hint}`),`\n${n.join(`
4
- `)}`}function pe(e){let t=e.diff,n=(t?.lines??[]).map(t=>`${t.kind===`removed`?`-`:`+`} ${me(t,e.refsGeneration)}`);return t?.truncated&&n.push(`… changed lines truncated`),n}function me(e,t){let n=e.text??``,r=s(e.ref,t);if(!r||!e.ref)return n;let i=`@${e.ref}`;return n.startsWith(`${i} `)?`${r}${n.slice(i.length)}`:`${r} ${n}`}function he(e){let t=e.tail??[];if(t.length===0)return[];let n=[`unchanged interactive (${t.length}):`];for(let r of t){let t=r.label?` "${r.label}"`:``,i=s(r.ref,e.refsGeneration)??`@${r.ref??``}`;n.push(`= ${i} [${r.role??``}]${t}`)}return e.tailTruncated&&n.push(`… more interactive elements not shown, use snapshot -i`),n}function ge(e){let t=e.settled===!0?`settled`:`not settled`,n=e.diff?.summary;return n?`${t} after ${e.waitedMs??0}ms: +${n.additions??0} -${n.removals??0} (~${n.unchanged??0} unchanged)`:`${t} after ${e.waitedMs??0}ms`}function _e(e){let t=e.result;return e.format===`attrs`?{data:t,text:JSON.stringify(t.node??{},null,2)}:{data:t,text:typeof t.text==`string`?t.text:``}}function ve(e){let t=e,n=a(t);if(n)return{data:t,text:n};if(typeof t.text==`string`)return{data:t,text:t.text};if(Array.isArray(t.matches))return{data:t,text:ye(t.matches,t.refsGeneration)};let r=s(t.ref,t.refsGeneration);return r?{data:t,text:`Found: ${r}`}:typeof t.found==`boolean`?{data:t,text:`Found: ${t.found}`}:t.node?{data:t,text:JSON.stringify(t.node,null,2)}:c(t)}function ye(e,t){return[`${e.length} match${e.length===1?``:`es`}:`,...e.map(e=>_(e,t))].join(`
5
- `)}function _(t,n){let r=t.ref===void 0?`(no ref)`:s(t.ref,n)??t.ref,i=e(t.node?.type??`Element`),a=t.node?te(t.node,i):``;return`= ${r} [${i}]${a?` "${a}"`:``}`}function v(e){let t=e;return{data:t,text:`Passed: is ${t.predicate??`assertion`}`}}function y(e){let t=e,n=t.ref??``,r=t.x,i=t.y;return!n||typeof r!=`number`||typeof i!=`number`?c(t):{data:t,text:`Tapped @${n} (${r}, ${i})`}}const b=g({click:l(y),press:l(y),fill:u,longpress:u,hover:u,scroll:u,get:({input:e,result:t})=>_e({result:t,format:e.format===`attrs`?`attrs`:`text`}),is:l(v),find:l(ve)});async function x(e){let{serializeDevice:t}=await import(`./result-serialization.js`).then(e=>e.n);return{data:{devices:e.map(t)},text:e.map(F).join(`
1
+ import{Ci as e,p as t}from"./sdk-batch.js";import{st as n}from"./sdk-contracts.js";import{y as r}from"./sdk-batch-runner.js";import{t as i}from"./success-text.js";import{i as a}from"./src3.js";import{a as o,i as s,n as c,o as l,r as u,s as ee}from"./output-common.js";import{n as te}from"./snapshot-lines.js";import{t as ne}from"./snapshot.js";function re(e){let t=[`Batch completed: ${e.executed}/${e.total} steps in ${e.totalDurationMs}ms`];for(let n of e.results)t.push(f(n));return{data:e,text:t.join(`
2
+ `)}}const d={batch:l(re)};function f(e){let t=i(e.data)??e.command;return`${e.step}. OK ${t} (${e.durationMs}ms)`}function ie(t){if(!Array.isArray(t)||t.length===0)return t;let n=e(t);return t.map(e=>{let t=p(e,n,e=>e.label),r=p(e,n,e=>e.identifier),i=typeof e.label==`string`&&e.label.length>=24&&e.label===t,a=typeof e.identifier==`string`&&e.identifier.length>=24&&e.identifier===r;if(!i&&!a)return e;let o={...e};return i&&(delete o.label,o.inheritsLabel=!0),a&&(delete o.identifier,o.inheritsIdentifier=!0),o})}function p(e,t,n){let r=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0;for(;r;){let e=n(r);if(typeof e==`string`&&e.length>0)return e;r=typeof r.parentIndex==`number`?t.get(r.parentIndex):void 0}}async function m(e){let{serializeSnapshotResult:t}=await import(`./result-serialization.js`).then(e=>e.n),n=t(e.raw||!Array.isArray(e.result.nodes)?e.result:{...e.result,nodes:ie(e.result.nodes)});return{data:n,jsonData:oe(n),stderr:e.result.snapshotDiagnostics?.warning?`${e.result.snapshotDiagnostics.warning}\n`:void 0,text:ne(n,{raw:e.raw,flatten:e.interactiveOnly,scoped:typeof e.scope==`string`&&e.scope.trim().length>0,depthLimited:typeof e.depth==`number`})}}const ae={snapshot:async({input:e,result:t})=>await m({result:t,raw:e.raw,interactiveOnly:e.interactiveOnly,scope:e.scope,depth:e.depth}),wait:u,alert:u,settings:u};function oe(e){let{unchanged:t,...n}=e;return n}function se(e){let t=[e.outPath,e.message];t.push(...le(e));for(let n of e.matchedImages)t.push(`Matched: ${n.name} ${n.uuid}${n.arch?` ${n.arch}`:``}`);for(let n of e.warnings??[])t.push(`Warning: ${n}`);return{data:e,text:t.join(`
3
+ `)}}const ce={debug:l(se)};function le(e){let t=e.crash,n=[`Crash: ${t.appName??`unknown app`}${t.crashedThread===void 0?``:` thread ${t.crashedThread}`}`];t.bundleId&&n.push(`Bundle: ${t.bundleId}`),t.exceptionType&&n.push(`Exception: ${t.exceptionType}`),t.terminationReason&&n.push(`Termination: ${t.terminationReason}`);for(let e of t.topFrames)n.push(`Frame ${e.index}: ${e.image} ${e.symbol??e.address}`);for(let e of t.findings)n.push(`Finding: ${e}`);return n}function ue(e){return t=>{let n=e(t);return n instanceof Promise?n.then(h):h(n)}}function h(e){return{data:e.data,text:de(e.text,e.data)}}function g(e){let n={...e};for(let[r,i]of Object.entries(e))t(r)&&(n[r]=ue(i));return n}function de(e,t){return`${e??``}${fe(t.settle)}`}function fe(e){if(!e||typeof e!=`object`)return``;let t=e,n=[ge(t),...pe(t),...he(t)];return t.hint&&n.push(`hint: ${t.hint}`),`\n${n.join(`
4
+ `)}`}function pe(e){let t=e.diff,n=(t?.lines??[]).map(t=>`${t.kind===`removed`?`-`:`+`} ${me(t,e.refsGeneration)}`);return t?.truncated&&n.push(`… changed lines truncated`),n}function me(e,t){let n=e.text??``,r=s(e.ref,t);if(!r||!e.ref)return n;let i=`@${e.ref}`;return n.startsWith(`${i} `)?`${r}${n.slice(i.length)}`:`${r} ${n}`}function he(e){let t=e.tail??[];if(t.length===0)return[];let n=[`unchanged interactive (${t.length}):`];for(let r of t){let t=r.label?` "${r.label}"`:``,i=s(r.ref,e.refsGeneration)??`@${r.ref??``}`;n.push(`= ${i} [${r.role??``}]${t}`)}return e.tailTruncated&&n.push(`… more interactive elements not shown, use snapshot -i`),n}function ge(e){let t=e.settled===!0?`settled`:`not settled`,n=e.diff?.summary;return n?`${t} after ${e.waitedMs??0}ms: +${n.additions??0} -${n.removals??0} (~${n.unchanged??0} unchanged)`:`${t} after ${e.waitedMs??0}ms`}function _e(e){let t=e.result;return e.format===`attrs`?{data:t,text:JSON.stringify(t.node??{},null,2)}:{data:t,text:typeof t.text==`string`?t.text:``}}function ve(e){let t=e,n=i(t);if(n)return{data:t,text:n};if(typeof t.text==`string`)return{data:t,text:t.text};if(Array.isArray(t.matches))return{data:t,text:ye(t.matches,t.refsGeneration)};let r=s(t.ref,t.refsGeneration);return r?{data:t,text:`Found: ${r}`}:typeof t.found==`boolean`?{data:t,text:`Found: ${t.found}`}:t.node?{data:t,text:JSON.stringify(t.node,null,2)}:c(t)}function ye(e,t){return[`${e.length} match${e.length===1?``:`es`}:`,...e.map(e=>_(e,t))].join(`
5
+ `)}function _(e,t){let r=e.ref===void 0?`(no ref)`:s(e.ref,t)??e.ref,i=n(e.node?.type??`Element`),a=e.node?te(e.node,i):``;return`= ${r} [${i}]${a?` "${a}"`:``}`}function v(e){let t=e;return{data:t,text:`Passed: is ${t.predicate??`assertion`}`}}function y(e){let t=e,n=t.ref??``,r=t.x,i=t.y;return!n||typeof r!=`number`||typeof i!=`number`?c(t):{data:t,text:`Tapped @${n} (${r}, ${i})`}}const b=g({click:l(y),press:l(y),fill:u,longpress:u,hover:u,scroll:u,get:({input:e,result:t})=>_e({result:t,format:e.format===`attrs`?`attrs`:`text`}),is:l(v),find:l(ve)});async function x(e){let{serializeDevice:t}=await import(`./result-serialization.js`).then(e=>e.n);return{data:{devices:e.map(t)},text:e.map(F).join(`
6
6
  `)}}async function S(e){let{serializeDevice:t}=await import(`./result-serialization.js`).then(e=>e.n);return{data:{device:t(e.device),availableCommands:e.availableCommands},text:[`${F(e.device)} supports ${e.availableCommands.length} commands:`,e.availableCommands.join(` `)].join(`
7
7
  `)}}function C(e){return{data:{apps:e.result},stderr:e.appsFilter===`all`?`Showing all apps, including system apps.
8
8
  `:`Showing user-installed apps or deferred provider app assets. Use --all to include system apps on a live device.
9
9
  `,text:e.result.length>0?e.result.join(`
10
- `):e.appsFilter===`all`?`No apps found.`:`No user apps or provider app assets found.`}}async function w(e){if(`savedScript`in e)return{data:e,text:`Published script: ${e.savedScript}\nSession remains active: ${e.session}\nActions: ${e.actionCount}`};if(`stateDir`in e)return{data:e,text:e.stateDir};let{serializeSessionListEntry:t}=await import(`./result-serialization.js`).then(e=>e.n),n={sessions:e.sessions.map(t)};return{data:n,text:JSON.stringify(n,null,2)}}async function T(e){let{serializeOpenResult:t}=await import(`./result-serialization.js`).then(e=>e.n),n=t(e),r=[a(n)].filter(e=>!!e);typeof n.sessionStateDir==`string`&&r.push(`Session state: ${n.sessionStateDir}`);for(let t of e.warnings??[])r.push(`Warning: ${t}`);let i=await E(e.snapshot);return i&&(n.snapshot=i.jsonData??i.data,i.text&&r.push(i.text)),{data:n,...i?.stderr?{stderr:i.stderr}:{},text:r.join(`
10
+ `):e.appsFilter===`all`?`No apps found.`:`No user apps or provider app assets found.`}}async function w(e){if(`savedScript`in e)return{data:e,text:`Published script: ${e.savedScript}\nSession remains active: ${e.session}\nActions: ${e.actionCount}`};if(`stateDir`in e)return{data:e,text:e.stateDir};let{serializeSessionListEntry:t}=await import(`./result-serialization.js`).then(e=>e.n),n={sessions:e.sessions.map(t)};return{data:n,text:JSON.stringify(n,null,2)}}async function T(e,t=`terminal`){let{serializeOpenResult:n}=await import(`./result-serialization.js`).then(e=>e.n),r=n(e),a=[i(r)].filter(e=>!!e);t===`terminal`&&typeof r.sessionStateDir==`string`&&a.push(`Session state: ${r.sessionStateDir}`);for(let t of e.warnings??[])a.push(`Warning: ${t}`);let o=await E(e.snapshot);return o&&(r.snapshot=o.jsonData??o.data,o.text&&a.push(o.text)),{data:r,...o?.stderr?{stderr:o.stderr}:{},text:a.join(`
11
11
  `)||null}}async function E(e){return!e||!Array.isArray(e.nodes)?null:await m({result:e,interactiveOnly:!0})}async function D(e){let{serializeCloseResult:t}=await import(`./result-serialization.js`).then(e=>e.n);return c(t(e))}function O(e){if(k(e))return{data:e,text:e.artifacts.length>0?e.artifacts.map(Ce).join(`
12
12
  `):e.message??`No daemon artifacts available.`};let t=[e.message??`No cloud artifacts available for ${e.provider}.`],n=we(e);return n&&t.push(`Retry: ${n}`),{data:e,text:e.cloudArtifacts.length>0?[...e.cloudArtifacts.map(Se),...e.message?[e.message]:[]].join(`
13
13
  `):t.join(`
14
14
  `)}}function k(e){return`source`in e&&e.source===`daemon`}async function A(e){let{serializeDeployResult:t}=await import(`./result-serialization.js`).then(e=>e.n);return c(t(e))}async function j(e){let{serializeInstallFromSourceResult:t}=await import(`./result-serialization.js`).then(e=>e.n);return c(t(e))}function M(e){let t=e,n=t.platform??`unknown`;return{data:t,text:`Boot ready: ${t.device??t.id??`unknown`} (${n})${N(t.selection)}`}}function N(e){if(typeof e!=`object`||!e)return``;let{reason:t,candidateCount:n}=e;return t===`newest-bootable-local`?`, picked by --pick newest from ${n} matching devices`:``}function P(e){let t=e,n=t.platform??`unknown`,r=t.device??t.id??`unknown`,i=t.shutdown;return{data:t,text:`${i&&typeof i==`object`&&`success`in i&&i.success===!0?`Shutdown`:`Shutdown failed`}: ${r} (${n})`}}async function be(e,t,n,r){let{formatDoctorCheckDetailLines:i,formatDoctorCheckSummaryLine:a}=await import(`./doctor-lines.js`).then(e=>e.t),{shouldColorStatusMarkers:o}=await import(`./status-markers.js`).then(e=>e.r),s=o(t,r),c=e,l=[`Doctor: ${typeof c.status==`string`?c.status:`unknown`}`],u=Te(c.checks);if(n?.renderedToStderr){let e=typeof c.summary==`string`?c.summary:void 0;e&&l.push(e)}else if(u.length===0){let e=typeof c.summary==`string`?c.summary:`No blockers found.`;l.push(e)}else for(let e of u)l.push(a(e,{useColor:s})),l.push(...i(e));return{data:c,text:l.join(`
15
- `)}}const xe={boot:l(M),shutdown:l(P),devices:l(x),capabilities:l(S),doctor:({result:e,env:t,progress:n,stderrIsTTY:r})=>be(e,t,n,r),apps:({input:e,result:t})=>C({result:t,appsFilter:e.appsFilter}),session:l(w),artifacts:l(O),open:l(T),close:l(D),install:l(A),reinstall:l(A),"install-from-source":l(j),prepare:u,viewport:u};function F(e){let t=e.kind?` ${e.kind}`:``,n=e.target?` target=${e.target}`:``,r=e.model?` model=${JSON.stringify(e.model)}`:``,i=e.osVersion?` os=${e.osVersion}`:``,a=typeof e.booted==`boolean`?` booted=${e.booted}`:``,o=e.claimedBy?` claimed by session "${e.claimedBy.session}" in ${e.claimedBy.workspace}`:``;return`${e.name} (${e.platform}${t}${n}${r}${i})${a}${o}`}function Se(e){let t=e.url?` ${e.url}`:``,n=e.availability?` ${e.availability}`:``;return`${e.kind}: ${e.name}${n}${t}`}function Ce(e){let t=e.artifactType?` (${e.artifactType})`:``;return`${e.filename}${t}: ${e.mimeType} ${e.sizeBytes} bytes id=${e.id}`}function we(e){if(e.providerSessionId)return`agent-device artifacts ${e.providerSessionId} --provider ${e.provider} --json`}function Te(e){return Array.isArray(e)?e.filter(e=>!!e&&typeof e==`object`&&!Array.isArray(e)):[]}function Ee(e){return{data:e.result,text:e.action===`reload`?`Reloaded React Native apps via ${e.result.reloadUrl}`:JSON.stringify(e.result,null,2)}}const De={metro:({input:e,result:t})=>Ee({result:t,action:e.action})},Oe=[`started`,`stopped`,`marked`,`cleared`,`restarted`,`removedRotatedFiles`];function ke(e){return{data:e,text:e.path,stderr:W([H(e,[`active`,`state`,`backend`,`sizeBytes`]),H(e,Oe),e.hint,U(e.notes)])}}function Ae(e){let t=e.events??[];return{data:e,text:t.length>0?Pe(t):`No session events found.`,stderr:W([H(e,[`path`,`cursor`,`nextCursor`,`endCursor`,`limit`])])}}function je(e){let t=[],n=e.entries??[];if(e.path&&t.push(e.path),n.length===0)t.push(`No recent HTTP(s) entries found.`);else for(let e of n)t.push(...Ke(e));return{data:e,text:t.join(`
15
+ `)}}const xe={boot:l(M),shutdown:l(P),devices:l(x),capabilities:l(S),doctor:({result:e,env:t,progress:n,stderrIsTTY:r})=>be(e,t,n,r),apps:({input:e,result:t})=>C({result:t,appsFilter:e.appsFilter}),session:l(w),artifacts:l(O),open:({result:e,reader:t})=>T(e,t),close:l(D),install:l(A),reinstall:l(A),"install-from-source":l(j),prepare:u,viewport:u};function F(e){let t=e.kind?` ${e.kind}`:``,n=e.target?` target=${e.target}`:``,r=e.model?` model=${JSON.stringify(e.model)}`:``,i=e.osVersion?` os=${e.osVersion}`:``,a=typeof e.booted==`boolean`?` booted=${e.booted}`:``,o=e.claimedBy?` claimed by session "${e.claimedBy.session}" in ${e.claimedBy.workspace}`:``;return`${e.name} (${e.platform}${t}${n}${r}${i})${a}${o}`}function Se(e){let t=e.url?` ${e.url}`:``,n=e.availability?` ${e.availability}`:``;return`${e.kind}: ${e.name}${n}${t}`}function Ce(e){let t=e.artifactType?` (${e.artifactType})`:``;return`${e.filename}${t}: ${e.mimeType} ${e.sizeBytes} bytes id=${e.id}`}function we(e){if(e.providerSessionId)return`agent-device artifacts ${e.providerSessionId} --provider ${e.provider} --json`}function Te(e){return Array.isArray(e)?e.filter(e=>!!e&&typeof e==`object`&&!Array.isArray(e)):[]}function Ee(e){return{data:e.result,text:e.action===`reload`?`Reloaded React Native apps via ${e.result.reloadUrl}`:JSON.stringify(e.result,null,2)}}const De={metro:({input:e,result:t})=>Ee({result:t,action:e.action})},Oe=[`started`,`stopped`,`marked`,`cleared`,`restarted`,`removedRotatedFiles`];function ke(e){return{data:e,text:e.path,stderr:W([H(e,[`active`,`state`,`backend`,`sizeBytes`]),H(e,Oe),e.hint,U(e.notes)])}}function Ae(e){let t=e.events??[];return{data:e,text:t.length>0?Pe(t):`No session events found.`,stderr:W([H(e,[`path`,`cursor`,`nextCursor`,`endCursor`,`limit`])])}}function je(e){let t=[],n=e.entries??[];if(e.path&&t.push(e.path),n.length===0)t.push(`No recent HTTP(s) entries found.`);else for(let e of n)t.push(...Ke(e));return{data:e,text:t.join(`
16
16
  `),stderr:W([H(e,[`active`,`state`,`backend`,`include`,`scannedLines`,`matchedLines`]),U(e.notes)])}}function Me(e){return{data:e,text:[`Audio probe: ${String(e.state??`stopped`)} heard=${String(e.heard===!0)}`,I(`rmsDbfs`,e.rmsDbfs),I(`peakDbfs`,e.peakDbfs)].filter(e=>!!e).join(`
17
17
  `),stderr:W([H(e,[`active`,`backend`,`source`,`durationMs`,`elapsedMs`,`bucketMs`,`sampleCount`,`sourceCount`,`mediaElementCount`]),U(e.notes)])}}const Ne={logs:l(ke),events:l(Ae),network:l(je),audio:l(Me)};function Pe(e){let t=e.map(Fe),n=Math.min(Math.max(...t.map(e=>e.label.length),5),32);return t.map(e=>Ie(e,n)).join(`
18
18
  `)}function Fe(e){return{timestamp:Le(e.ts),label:Re(e),summary:ze(e)}}function Ie(e,t){let n=e.label.padEnd(t),r=e.timestamp?`${e.timestamp} ${n}`:n.trimEnd();return e.summary?`${r} ${e.summary}`:r.trimEnd()}function Le(e){return e?e.replace(`T`,` `):``}function Re(e){let t=e.command??`command`;switch(e.kind){case`request.started`:return`start ${t}`;case`request.finished`:return L([e.status===`error`?`error`:`ok`,t,Ge(z(e.details?.durationMs))]);case`action.recorded`:return`action ${t}`;default:return L([e.kind??`event`,e.command])}}function ze(e){let t=Be(e.summary,e);return`${t}${Ve(e,t)}`.trim()}function Be(e,t){let n=e?.trim()??``,r=t.command??``;return t.kind===`request.started`&&n===`Started ${r}`||t.kind===`request.finished`&&n===`Finished ${r}`?``:n}function Ve(e,t){if(e.kind!==`action.recorded`)return``;let n=e.details;if(!n)return``;let r=[He(n,t),We(z(n.textLength))].filter(e=>!!e);return r.length>0?` (${r.join(`, `)})`:``}function He(e,t){let n=R(e.ref)??R(e.selector)??Ue(e);if(!(!n||t.includes(n)))return`target=${n}`}function Ue(e){let t=z(e.x),n=z(e.y);return t===void 0||n===void 0?void 0:`(${t}, ${n})`}function We(e){return e===void 0?void 0:`text=${e} chars`}function Ge(e){return e===void 0?void 0:`${Math.round(e)}ms`}function I(e,t){if(!Array.isArray(t))return;let n=t.filter(e=>typeof e==`number`&&Number.isFinite(e));return n.length>0?`${e}: [${n.join(`, `)}]`:void 0}function L(e){return e.filter(e=>!!e).join(` `)}function R(e){return typeof e==`string`&&e.trim().length>0?e:void 0}function z(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function Ke(e){let t=e.method??`HTTP`,n=e.url??`<unknown-url>`,r=e.status===void 0?``:` status=${e.status}`,i=e.timestamp?`${e.timestamp} `:``,a=e.durationMs===void 0?``:` durationMs=${e.durationMs}`,o=[`${i}${t} ${n}${`pathUnavailable`in e&&e.pathUnavailable?` (request path not logged)`:``}${r}${a}`];return e.headers?V(o,`headers`,e.headers):(B(o,`request headers`,e.requestHeaders),B(o,`response headers`,e.responseHeaders)),V(o,`request`,e.requestBody),V(o,`response`,e.responseBody),o}function B(e,t,n){!n||Object.keys(n).length===0||e.push(` ${t}: ${JSON.stringify(n)}`)}function V(e,t,n){n!==void 0&&e.push(` ${t}: ${n}`)}function H(e,t){return t.map(t=>e[t]!==void 0&&e[t]!==null?`${t}=${e[t]}`:``).filter(Boolean).join(` `)||void 0}function U(e){let t=e?.filter(e=>e.length>0)??[];return t.length>0?t.join(`
19
19
  `):void 0}function W(e){return e.filter(e=>!!e).join(`
20
- `)||void 0}function qe(e){let t=e;return{data:t,text:Ye(t)}}const Je={perf:l(qe)};function Ye(e){return nt(e)??Xe(e)}function Xe(e){let n=t(e.artifact)?e.artifact:void 0;return n?tt(n):Ze(t(e.metrics)?e.metrics:void 0)}function Ze(e){return t(e?.fps)?$e(e):Qe(e)??`Memory: unavailable - missing memory metric`}function Qe(e){let n=t(e?.memory)?e.memory:void 0;if(!n)return;if(n.available===!1)return`Memory: unavailable - ${J(n)}`;let r=gt(n);return r?`Performance: ${r}`:`Memory: unavailable - missing memory metric`}function $e(e){let n=t(e?.fps)?e.fps:void 0;if(!n)return q(`missing frame metric`);if(n.available===!1)return q(J(n));let r=dt(n);return r?et(n,r):q(`missing dropped-frame summary`)}function et(e,t){let n=[`Frame health: ${t}`],r=mt(e);return r.length>0&&n.push(`Worst windows:`,...r),n.join(`
20
+ `)||void 0}function qe(e){let t=e;return{data:t,text:Ye(t)}}const Je={perf:l(qe)};function Ye(e){return nt(e)??Xe(e)}function Xe(e){let t=r(e.artifact)?e.artifact:void 0;return t?tt(t):Ze(r(e.metrics)?e.metrics:void 0)}function Ze(e){return r(e?.fps)?$e(e):Qe(e)??`Memory: unavailable - missing memory metric`}function Qe(e){let t=r(e?.memory)?e.memory:void 0;if(!t)return;if(t.available===!1)return`Memory: unavailable - ${J(t)}`;let n=gt(t);return n?`Performance: ${n}`:`Memory: unavailable - missing memory metric`}function $e(e){let t=r(e?.fps)?e.fps:void 0;if(!t)return q(`missing frame metric`);if(t.available===!1)return q(J(t));let n=dt(t);return n?et(t,n):q(`missing dropped-frame summary`)}function et(e,t){let n=[`Frame health: ${t}`],r=mt(e);return r.length>0&&n.push(`Worst windows:`,...r),n.join(`
21
21
  `)}function tt(e){let t=typeof e.kind==`string`?e.kind:`memory`;if(e.available===!1)return`Memory artifact (${t}): unavailable - ${typeof e.reason==`string`&&e.reason.length>0?e.reason:`not available`}`;let n=typeof e.path==`string`?e.path:void 0,r=Y(e.sizeBytes),i=r===void 0?``:` (${Q(r)})`;return n?`Memory artifact (${t}): ${n}${i}`:`Memory artifact (${t}): captured${i}`}function nt(e){return e.kind===`xctrace`?rt(e):ot(e)}function rt(e){let t=typeof e.perf==`string`?e.perf:void 0,n=it(e);if(!t||!n||e.kind!==`xctrace`)return;let r=at(n,typeof e.mode==`string`?e.mode:`capture`,t,e.template),i=G(e);return i.length>0?`${r}\nTop CPU self time:\n${i.join(`
22
- `)}`:r}function G(e){let n=t(e.summary)?e.summary:void 0;return Array.isArray(n?.topFunctions)?n.topFunctions.slice(0,5).flatMap(e=>{if(!t(e))return[];let n=K(e.symbol),r=Y(e.selfSamplePercent);if(!n||r===void 0)return[];let i=K(e.binary);return[`- ${X(r)} ${n}${i?` (${i})`:``}`]}):[]}function it(e){return typeof e.outPath==`string`?e.outPath:typeof e.reportPath==`string`?e.reportPath:void 0}function at(e,t,n,r){let i=[e,`Perf ${t}: ${n}`];return typeof r==`string`&&i.push(`Template: ${r}`),i.join(`
22
+ `)}`:r}function G(e){let t=r(e.summary)?e.summary:void 0;return Array.isArray(t?.topFunctions)?t.topFunctions.slice(0,5).flatMap(e=>{if(!r(e))return[];let t=K(e.symbol),n=Y(e.selfSamplePercent);if(!t||n===void 0)return[];let i=K(e.binary);return[`- ${X(n)} ${t}${i?` (${i})`:``}`]}):[]}function it(e){return typeof e.outPath==`string`?e.outPath:typeof e.reportPath==`string`?e.reportPath:void 0}function at(e,t,n,r){let i=[e,`Perf ${t}: ${n}`];return typeof r==`string`&&i.push(`Template: ${r}`),i.join(`
23
23
  `)}function ot(e){let t=st(e);if(!t)return;let n=`Perf ${t.action}: ${t.kind} ${t.type}${ct(e)}${lt(e)}${ut(e)}`,r=G(e);return r.length>0?`${n}\nTop CPU self time:\n${r.join(`
24
- `)}`:n}function st(e){let t=K(e.action),n=K(e.kind),r=K(e.type);return t&&n&&r?{action:t,kind:n,type:r}:void 0}function ct(e){let t=K(e.state);return t?` state=${t}`:``}function lt(e){let t=K(e.outPath);if(!t)return``;let n=Y(e.sizeBytes);return`\n${t}${n===void 0?``:` (${Q(n)})`}`}function K(e){return typeof e==`string`?e:void 0}function ut(e){let n=t(e.summary)?e.summary:void 0,r=t(n?.frameHealth)?n.frameHealth:void 0;if(!r||r.available!==!0)return``;let i=Y(r.droppedFramePercent),a=Y(r.droppedFrameCount),o=Y(r.totalFrameCount);return i===void 0||a===void 0||o===void 0?``:`\nTrace frame health: dropped ${X(i)} (${Math.round(a)}/${Math.round(o)} frames)`}function q(e){return`Frame health: unavailable - ${e}`}function J(e){return typeof e.reason==`string`&&e.reason.length>0?e.reason:`not available`}function dt(e){let t=Y(e.droppedFramePercent),n=Y(e.droppedFrameCount);if(t!==void 0&&n!==void 0)return[`dropped ${X(t)}`,ft(n,Y(e.totalFrameCount)),pt(Y(e.sampleWindowMs))].filter(Boolean).join(` `)}function ft(e,t){return t===void 0?`(${Math.round(e)} dropped frames)`:`(${Math.round(e)}/${Math.round(t)} frames)`}function pt(e){return e===void 0?``:`window ${Z(e)}`}function mt(e){return Array.isArray(e.worstWindows)?e.worstWindows.flatMap(e=>{if(!t(e))return[];let n=ht(e);return n?[n]:[]}):[]}function ht(e){let t=Y(e.startOffsetMs),n=Y(e.endOffsetMs),r=Y(e.missedDeadlineFrameCount);if(t===void 0||n===void 0||r===void 0)return;let i=Y(e.worstFrameMs),a=i===void 0?``:`, worst ${Z(i)}`;return`- +${Z(t)}-+${Z(n)}: ${Math.round(r)} missed-deadline frames${a}`}function gt(e){if(e?.available!==!0)return;let t=Y(e.residentMemoryKb)??Y(e.totalPssKb)??Y(e.totalRssKb);return t===void 0?void 0:`memory ${_t(t)}`}function Y(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function X(e){return`${Number.isInteger(e)?e:e.toFixed(1)}%`}function Z(e){let t=Math.max(0,Math.round(e));if(t<1e3)return`${t}ms`;let n=Math.round(t/1e3);if(n<60)return`${n}s`;let r=Math.floor(n/60),i=n%60;return i>0?`${r}m ${i}s`:`${r}m`}function _t(e){let t=e/1024;return`${t>=10?Math.round(t):t.toFixed(1)}MB`}function Q(e){if(e<1024)return`${Math.round(e)}B`;let t=e/1024;if(t<1024)return`${t>=10?Math.round(t):t.toFixed(1)}KB`;let n=t/1024;return`${n>=10?Math.round(n):n.toFixed(1)}MB`}function vt(e){let t=e,n=typeof t.outPath==`string`?t.outPath:``,r=bt(t);if(r.length<=1)return{data:t,text:$(t,n)};let i=[`Recording chunks:`];for(let e of r)i.push(` ${e.index}: ${e.path}`);return typeof t.telemetryPath==`string`&&i.push(`Telemetry: ${t.telemetryPath}`),typeof t.warning==`string`&&i.push(`Warning: ${t.warning}`),typeof t.overlayWarning==`string`&&i.push(`Overlay warning: ${t.overlayWarning}`),{data:t,text:i.join(`
24
+ `)}`:n}function st(e){let t=K(e.action),n=K(e.kind),r=K(e.type);return t&&n&&r?{action:t,kind:n,type:r}:void 0}function ct(e){let t=K(e.state);return t?` state=${t}`:``}function lt(e){let t=K(e.outPath);if(!t)return``;let n=Y(e.sizeBytes);return`\n${t}${n===void 0?``:` (${Q(n)})`}`}function K(e){return typeof e==`string`?e:void 0}function ut(e){let t=r(e.summary)?e.summary:void 0,n=r(t?.frameHealth)?t.frameHealth:void 0;if(!n||n.available!==!0)return``;let i=Y(n.droppedFramePercent),a=Y(n.droppedFrameCount),o=Y(n.totalFrameCount);return i===void 0||a===void 0||o===void 0?``:`\nTrace frame health: dropped ${X(i)} (${Math.round(a)}/${Math.round(o)} frames)`}function q(e){return`Frame health: unavailable - ${e}`}function J(e){return typeof e.reason==`string`&&e.reason.length>0?e.reason:`not available`}function dt(e){let t=Y(e.droppedFramePercent),n=Y(e.droppedFrameCount);if(t!==void 0&&n!==void 0)return[`dropped ${X(t)}`,ft(n,Y(e.totalFrameCount)),pt(Y(e.sampleWindowMs))].filter(Boolean).join(` `)}function ft(e,t){return t===void 0?`(${Math.round(e)} dropped frames)`:`(${Math.round(e)}/${Math.round(t)} frames)`}function pt(e){return e===void 0?``:`window ${Z(e)}`}function mt(e){return Array.isArray(e.worstWindows)?e.worstWindows.flatMap(e=>{if(!r(e))return[];let t=ht(e);return t?[t]:[]}):[]}function ht(e){let t=Y(e.startOffsetMs),n=Y(e.endOffsetMs),r=Y(e.missedDeadlineFrameCount);if(t===void 0||n===void 0||r===void 0)return;let i=Y(e.worstFrameMs),a=i===void 0?``:`, worst ${Z(i)}`;return`- +${Z(t)}-+${Z(n)}: ${Math.round(r)} missed-deadline frames${a}`}function gt(e){if(e?.available!==!0)return;let t=Y(e.residentMemoryKb)??Y(e.totalPssKb)??Y(e.totalRssKb);return t===void 0?void 0:`memory ${_t(t)}`}function Y(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function X(e){return`${Number.isInteger(e)?e:e.toFixed(1)}%`}function Z(e){let t=Math.max(0,Math.round(e));if(t<1e3)return`${t}ms`;let n=Math.round(t/1e3);if(n<60)return`${n}s`;let r=Math.floor(n/60),i=n%60;return i>0?`${r}m ${i}s`:`${r}m`}function _t(e){let t=e/1024;return`${t>=10?Math.round(t):t.toFixed(1)}MB`}function Q(e){if(e<1024)return`${Math.round(e)}B`;let t=e/1024;if(t<1024)return`${t>=10?Math.round(t):t.toFixed(1)}KB`;let n=t/1024;return`${n>=10?Math.round(n):n.toFixed(1)}MB`}function vt(e){let t=e,n=typeof t.outPath==`string`?t.outPath:``,r=bt(t);if(r.length<=1)return{data:t,text:$(t,n)};let i=[`Recording chunks:`];for(let e of r)i.push(` ${e.index}: ${e.path}`);return typeof t.telemetryPath==`string`&&i.push(`Telemetry: ${t.telemetryPath}`),typeof t.warning==`string`&&i.push(`Warning: ${t.warning}`),typeof t.overlayWarning==`string`&&i.push(`Overlay warning: ${t.overlayWarning}`),{data:t,text:i.join(`
25
25
  `)}}const yt={record:l(vt)};function $(e,t){let n=[];return t&&n.push(t),typeof e.sessionStateDir==`string`&&n.push(`Session state: ${e.sessionStateDir}`),typeof e.warning==`string`&&n.push(`Warning: ${e.warning}`),typeof e.overlayWarning==`string`&&n.push(`Overlay warning: ${e.overlayWarning}`),n.join(`
26
26
  `)}function bt(e){let t=e.chunks;return Array.isArray(t)?t.flatMap(e=>{if(!e||typeof e!=`object`)return[];let t=e;return typeof t.index!=`number`||typeof t.path!=`string`?[]:[{index:t.index,path:t.path}]}):[]}const xt={replay:u};function St(e){return{data:e,text:Et(e)}}function Ct(e){if(e.platform===`android`&&e.action===`status`){let t=[`Keyboard visible: ${e.visible===!0?`yes`:`no`}`,`Input type: ${e.type??e.inputType??`unknown`}`,`Input owner: ${e.inputOwner??`unknown`}`];return e.inputMethodPackage&&t.push(`Input method: ${e.inputMethodPackage}`),e.focusedPackage&&t.push(`Focused package: ${e.focusedPackage}`),e.focusedResourceId&&t.push(`Focused resource: ${e.focusedResourceId}`),t.push(`Next action: ${Ot(e.visible,e.inputOwner)}`),{data:e,text:t.join(`
27
27
  `)}}return c(e)}function wt(e){return e.action===`read`?{data:e,text:e.text}:c(e)}const Tt=g({appstate:l(St),back:u,home:u,orientation:u,fold:u,"app-switcher":u,"action-button":u,keyboard:l(Ct),clipboard:l(wt),"tv-remote":u,"hardware-button":u,telephony:u});function Et(e){switch(e.platform){case`ios`:case`macos`:return Dt(e);case`android`:case`harmonyos`:{let t=[`Foreground app: ${e.package??`unknown`}`];return e.activity&&t.push(`Activity: ${e.activity}`),t.join(`
28
28
  `)}}}function Dt(e){let t=[`Session app: ${e.appName??e.appBundleId??`unknown`}`];return e.appBundleId&&t.push(`Bundle: ${e.appBundleId}`),e.state&&t.push(`State: ${e.state}`),e.source&&t.push(`Source: ${e.source}`),t.join(`
29
- `)}function Ot(e,t){return t===`ime`?`Focused input appears to be owned by the keyboard/IME; dismiss or change the IME before retrying text entry.`:e===!0?`Keyboard is visible and focused input appears app-owned; fill/type can proceed.`:`Keyboard is hidden; focus an app field before type, or use fill with a concrete target.`}const kt=At([d,ae,ce,b,xe,De,Ne,Je,yt,xt,Tt]);function At(e){let t={};for(let n of e)for(let[e,r]of Object.entries(n)){if(Object.hasOwn(t,e))throw Error(`Duplicate CLI output formatter: ${e}`);t[e]=r}return t}async function jt(e){let t=await kt[e.name]?.({input:e.input??{},result:e.result,progress:e.progress,env:e.env,stderrIsTTY:e.stderrIsTTY});if(t!==void 0)return ee(t,e.result,o(i(e.name)))}export{jt as dispatchCliOutput};
29
+ `)}function Ot(e,t){return t===`ime`?`Focused input appears to be owned by the keyboard/IME; dismiss or change the IME before retrying text entry.`:e===!0?`Keyboard is visible and focused input appears app-owned; fill/type can proceed.`:`Keyboard is hidden; focus an app field before type, or use fill with a concrete target.`}const kt=At([d,ae,ce,b,xe,De,Ne,Je,yt,xt,Tt]);function At(e){let t={};for(let n of e)for(let[e,r]of Object.entries(n)){if(Object.hasOwn(t,e))throw Error(`Duplicate CLI output formatter: ${e}`);t[e]=r}return t}async function jt(e){let t=await kt[e.name]?.({input:e.input??{},result:e.result,progress:e.progress,env:e.env,stderrIsTTY:e.stderrIsTTY,reader:e.reader});if(t!==void 0)return ee(t,e.result,o(a(e.name)))}export{jt as dispatchCliOutput};
@@ -1,3 +1,3 @@
1
- import{P as e}from"./sdk-contracts.js";import{St as t}from"./sdk-io.js";import"./diagnostics.js";import{c as n,r,x as i}from"./src3.js";import{t as a}from"./src7.js";const o=n();function s(e,t,n){let r=o[e];if(!r)throw Error(`Missing CLI reader for command: ${e}`);return{...r(t,n),...i(e,n)}}const c=65536;async function l(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=f(i,a);if(i=t.held,r+=p(t.piece),r>65536)throw new e(`INVALID_ARGS`,`fill --text-stdin accepts at most ${c} bytes of input.`,{reason:`fill_text_stdin_too_large`,maxBytes:c});n.push(m(t.piece))}if(i)throw g();let a=_(h(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 u=/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/,d=/[\uD800-\uDBFF]$/;function f(e,t){if(typeof t!=`string`){if(e)throw g();return{piece:t,held:``}}let n=e+t;return d.test(n)?{piece:n.slice(0,-1),held:n.slice(-1)}:{piece:n,held:``}}function p(e){return typeof e==`string`?Buffer.byteLength(e,`utf8`):e.byteLength}function m(e){if(typeof e!=`string`)return e;if(u.test(e))throw g();return Buffer.from(e,`utf8`)}function h(e){try{return new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(e)}catch{throw g()}}function g(){return new e(`INVALID_ARGS`,`fill --text-stdin input is not valid UTF-8.`,{reason:`fill_text_stdin_invalid_utf8`})}function _(e){return e.endsWith(`\r
1
+ import{_ as e}from"./sdk-contracts.js";import{Tt as t}from"./sdk-io.js";import"./diagnostics.js";import{c as n,r,x as i}from"./src3.js";import{t as a}from"./src7.js";const o=n();function s(e,t,n){let r=o[e];if(!r)throw Error(`Missing CLI reader for command: ${e}`);return{...r(t,n),...i(e,n)}}const c=65536;async function l(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=f(i,a);if(i=t.held,r+=p(t.piece),r>65536)throw new e(`INVALID_ARGS`,`fill --text-stdin accepts at most ${c} bytes of input.`,{reason:`fill_text_stdin_too_large`,maxBytes:c});n.push(m(t.piece))}if(i)throw g();let a=_(h(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 u=/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/,d=/[\uD800-\uDBFF]$/;function f(e,t){if(typeof t!=`string`){if(e)throw g();return{piece:t,held:``}}let n=e+t;return d.test(n)?{piece:n.slice(0,-1),held:n.slice(-1)}:{piece:n,held:``}}function p(e){return typeof e==`string`?Buffer.byteLength(e,`utf8`):e.byteLength}function m(e){if(typeof e!=`string`)return e;if(u.test(e))throw g();return Buffer.from(e,`utf8`)}function h(e){try{return new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(e)}catch{throw g()}}function g(){return new e(`INVALID_ARGS`,`fill --text-stdin input is not valid UTF-8.`,{reason:`fill_text_stdin_invalid_utf8`})}function _(e){return e.endsWith(`\r
2
2
  `)?e.slice(0,-2):e.endsWith(`
3
3
  `)?e.slice(0,-1):e}async function v(e){return(await y(e)).result}async function y(e){let n=s(e.command,e.positionals,e.flags);if(e.flags.textStdin){let e=await l(process.stdin);t(e),n.text=e}let i=await r(e.client,e.command,n);return{result:i,cliOutput:await a({name:e.command,input:n,result:i,progress:e.commandProgress,env:e.env,stderrIsTTY:!!process.stderr.isTTY})}}export{y as n,v as t};
package/dist/src/cli.js CHANGED
@@ -1,2 +1,2 @@
1
- import{P as e,R as t,nt as n}from"./sdk-contracts.js";import{c as r,d as i,f as a,p as o}from"./sdk-batch-runner.js";import{Et as s,St as c,bt as l,lt as u,m as d,vt as f,xt as p,yt as m}from"./sdk-io.js";import"./diagnostics.js";import{t as h}from"./src.js";import{s as ee,t as te}from"./sdk-batch.js";import{r as ne}from"./catalog.js";import{V as re,a as g}from"./src3.js";import{r as _}from"./command-schema.js";import{t as v}from"./merge-flags.js";import{n as y,r as ie,t as b}from"./cli-config.js";import"./command.js";import{a as ae}from"./version.js";import{m as oe}from"./daemon-resolution.js";import{i as se,n as x}from"./src4.js";import{t as ce}from"./update-check.js";import{a as le,i as S,n as ue,o as de,r as C}from"./args.js";import{exitAfterFlush as w}from"./process-exit.js";import{n as T,r as E}from"./remote-config-flags.js";import{m as D,v as O}from"./remote-connection-state.js";import{i as k}from"./auth-session.js";import A from"node:fs";import{pathToFileURL as j}from"node:url";const M=`${r} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,N=`${te} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function P(t){let n;try{n=JSON.parse(t)}catch{throw new e(`INVALID_ARGS`,`Batch steps must be valid JSON.`)}if(!Array.isArray(n)||n.length===0)throw new e(`INVALID_ARGS`,`Batch steps must be a non-empty JSON array.`);return n.map((e,t)=>F(e,t+1))}function F(t,n){let r=o(t,n,M),s=[`positionals`,`flags`].filter(e=>e in r);if(s.length>0){let t=s.map(e=>`"${e}"`).join(`, `);throw new e(`INVALID_ARGS`,`Batch step ${n} uses removed field(s): ${t}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:M})}re(r,[`command`,`input`,`runtime`],`Batch step ${n}`,M);let c=i(r.runtime,n);return{command:ee(r.command,n,N),input:a(r,n,M),...c===void 0?{}:{runtime:c}}}function I(){return{renderedToStderr:!1}}function L(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function R(e){return g(e)}const z={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(`./device3.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(`./screenshot4.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot4.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function B(e){let t={...e.flags},n=z[e.command];return n&&await(await n())({...e,flags:t})?!0:R(e.command)?await V({...e,command:e.command,flags:t}):!1}async function V(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function H(e,t){let n=C(e),{env:r,cwd:i}=t,a=fe(n.command)?T({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{flags:{}},o=ie({command:n.command,cwd:i,cliFlags:n.flags,env:r}),s=o.devicePin,c=v(o.flags,a.flags);return{...ue(n,{strictFlags:t?.strictFlags,defaultFlags:c}),providedFlags:n.providedFlags,remoteConfigLeaseProvider:a.leaseProvider,devicePin:s}}function fe(e){return e!==null}const U=async(...e)=>(await import(`./failure-output.js`)).printHumanError(...e),W=e=>import(`./json.js`).then(({printJson:t})=>t(e)),pe={sendToDaemon:x({onReplaced:G}),transportForHost:e=>x({host:e,onReplaced:G})};function G(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 me=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),he=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function K(e,t=pe,n=d(process)){await u({host:n,requestEnv:void 0},async()=>await ge(e,t,n))}async function ge(e,t,n){let r=se(t,n),i=f(),a=ae(),o=Te(e),c=e.includes(`--json`),l=Re(e)??n.env.AGENT_DEVICE_SESSION??`default`;await s({session:l,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:s,positionals:l}=await _e(e,{host:n,version:a,jsonRequested:c,debugEnabled:o}),u=X(s,t.providedFlags),d=await ve(t,{host:n,command:s,positionals:l,requestId:i,debugOutputEnabled:u});q(d.effectiveFlags);let f=null;try{if(s===`react-devtools`){await w(await ye(d));return}if(s===`web`){let{runWebCommand:e}=await import(`./web.js`);await w(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(ce({command:s,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await be(d,r),q(d.effectiveFlags),s===`cdp`){await w(await E(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=xe(d);let e=await Se(d),t=I();await Ce(d,h(Y(d),{host:d.host,devicePin:d.devicePin,transport:Ie({host:n,command:s,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await we(e,d,f)}finally{f&&f()}})}function q(e){e.daemonAuthToken&&c(e.daemonAuthToken)}async function _e(t,n){let r;try{r=H(t,{cwd:n.host.cwd,env:n.host.env})}catch(e){return await J(e,t,n)}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`,a=r.flags.help;if(i||a){if(i&&r.positionals.length>1)return await U(new e(`INVALID_ARGS`,`help accepts at most one command.`)),w(1);let t=i?r.positionals[0]:r.command;if(!t)return process.stdout.write(`${await S()}\n`),w(0);let n=await le(t);return n?(process.stdout.write(n),w(0)):(await U(new e(`INVALID_ARGS`,Ee(t))),process.stdout.write(`${await S()}\n`),w(1))}return r.command?r.command===`mcp`?await J(new e(`INVALID_ARGS`,`mcp accepts no flags or arguments other than --structured, --help, and --version.`,{hint:`Run agent-device mcp or agent-device mcp --structured. Configure the server with AGENT_DEVICE_* environment variables or AGENT_DEVICE_CONFIG.`}),t,n):{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await S()}\n`),w(1))}async function J(e,t,r){m({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let i=n(e,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});return r.jsonRequested?await W({success:!1,error:i}):await U(i,{debugTier:r.debugEnabled,argv:t}),await w(1)}async function ve(e,r){let i=new Set(e.providedFlags.map(e=>e.key));try{let t=y({env:r.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),n=_(r.command)?.explicitOnlyFlags?.includes(`platform`)===!0,a=t.lockPolicy||n?{...e.flags}:b(e.flags,{env:r.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),o=r.command===`connect`&&!a.remoteConfig;if(a.session===void 0&&(e.remoteConfigLeaseProvider||o))throw D(e.remoteConfigLeaseProvider);let s=oe(a.stateDir,{env:r.host.env,cwd:r.host.cwd}),c=a.session??`default`,l=Z({host:r.host,command:r.command,stateDir:s.baseDir,session:a.session,remoteConfig:a.remoteConfig}),u=l?Pe(a,l.flags,i):a;return{...r,binding:t,flags:a,daemonPaths:s,sessionName:c,connectionDefaults:l,explicitFlagKeys:i,effectiveFlags:u,resolvedRuntime:l?.runtime,connectionMetadata:l?.connection,parsedBatchSteps:void 0,devicePin:e.devicePin}}catch(i){let a=t(i),o=n(a,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});return e.flags.json?await W({success:!1,error:o}):await U(o,{debugTier:r.debugOutputEnabled,command:e.command}),w(1)}}async function ye(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 be(t,n){if(t.command===`batch`){if(t.positionals.length>0)throw new e(`INVALID_ARGS`,`batch does not accept positional arguments.`);t.parsedBatchSteps=Oe(t.flags)}if(je(t.command)&&(t.effectiveFlags=(await k({command:t.command,flags:t.effectiveFlags,stateDir:t.daemonPaths.baseDir,env:t.host.env})).flags),t.effectiveFlags.remoteConfig&&Ae(t.command)){let e=h(Y(t),{host:t.host,devicePin:t.devicePin,transport:Q(n)}),{materializeRemoteConnectionForCommand:r}=await import(`./connection-runtime.js`),i=await r({host:t.host,command:t.command,flags:t.effectiveFlags,client:e,runtime:t.resolvedRuntime,positionals:t.positionals,batchSteps:t.parsedBatchSteps,forceRuntimePrepare:Fe(t.explicitFlagKeys)});t.effectiveFlags=i.flags,t.resolvedRuntime=i.runtime,t.connectionMetadata=i.connection,t.leaseDevice=i.leaseDevice}Me({command:t.command,flags:t.effectiveFlags,runtime:t.resolvedRuntime,explicitFlagKeys:t.explicitFlagKeys,hadConnectionDefaults:!!t.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 Y(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,providerNetworkLogs:t.providerNetworkLogs,providerNetworkHosts:t.providerNetworkHosts,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 xe(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?ze(e.daemonPaths.logPath):null}async function Se(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 Ce(t,n,r,i){let{command:a,positionals:o,effectiveFlags:s}=t;if(a===`batch`){if(!t.parsedBatchSteps)throw new e(`INVALID_ARGS`,`batch requires --steps or --steps-file.`);let c=t.parsedBatchSteps.map((e,n)=>({...e,input:t.binding.lockPolicy&&t.flags.platform===void 0?{...e.input}:b(e.input,{env:t.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await B({host:t.host,command:a,positionals:o,flags:{...s,batchSteps:c},client:n,debug:t.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new e(`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 B({host:t.host,command:a,positionals:o,flags:s,client:n,debug:t.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i,leaseDevice:t.leaseDevice}))return;throw new e(`INVALID_ARGS`,De(a))}async function we(e,r,i){let a=t(e),o=n(a,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});if(r.command===`close`&&ke(a)){r.effectiveFlags.json&&await W({success:!0,data:{closed:`session`,source:`no-daemon`}});return}i&&i(),r.effectiveFlags.json?await W({success:!1,error:o}):await U(o,{debugTier:r.debugOutputEnabled,command:r.command,logTail:r.debugOutputEnabled?{daemonBaseUrl:r.effectiveFlags.daemonBaseUrl,daemonPaths:r.daemonPaths,record:o.diagnosticsRecord}:void 0}),await w(1)}function Te(e){try{let t=C(e);return X(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function Ee(e){let t=de(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function De(e){return ne(e)?(m({level:`error`,phase:`cli_known_command_unhandled`,data:{command:e}}),`Command is registered but no CLI handler accepted it: ${e}`):`Unknown command: ${e}`}function X(e,t){return t.some(t=>t.key===`verbose`&&(t.token===`--debug`||t.token===`-v`||e!==`test`))}function Oe(t){let n=``;if(t.steps)n=t.steps;else if(t.stepsFile)try{n=A.readFileSync(t.stepsFile,`utf8`)}catch(n){let r=n instanceof Error?n.message:String(n);throw new e(`INVALID_ARGS`,`Failed to read --steps-file ${t.stepsFile}: ${r}`)}return P(n)}function ke(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 Z(e){return e.command===`connect`||e.command===`connection`||e.command===`daemon`||e.command===`plugins`||e.command===`device`||e.command===`proxy`?null:O({stateDir:e.stateDir,session:e.session,remoteConfig:e.remoteConfig,cwd:e.host.cwd,env:e.host.env,validateRemoteConfigHash:e.command!==`disconnect`})}function Ae(e){return!he.has(e)}function je(e){return e!==`auth`&&e!==`connection`&&e!==`daemon`&&e!==`plugins`&&e!==`device`&&e!==`proxy`}function Me(e){return e.command!==`open`||e.runtime||e.flags.bundleUrl||e.flags.metroHost||e.flags.metroPort||e.flags.remoteConfig||e.hadConnectionDefaults?!1:Ne(e.explicitFlagKeys)}function Ne(e){return e.has(`daemonBaseUrl`)||e.has(`daemonTransport`)||e.has(`tenant`)||e.has(`sessionIsolation`)||e.has(`runId`)||e.has(`leaseId`)||e.has(`leaseBackend`)}function Pe(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 Fe(e){for(let t of me)if(e.has(t))return!0;return!1}function Ie(e){let t=Le(e);return e.flags.remoteConfig?async(n,r)=>{let i=await t(n,r),{forgetEndedConnectionLease:a}=await import(`./ended-lease.js`);return a(e.flags,i,e.host),i}:t}function Le(e){let{command:t,flags:n,replayTestReporterRuntime:r,transport:i}=e;if(n.json)return Q(i);let a=t===`test`&&r?r.onProgress:L(e.commandProgress);return async(e,n)=>{let r={...n,onProgress:a};return await $(i,{...e,meta:{...e.meta,requestProgress:t===`test`?`replay-test`:`command`}},r)}}function Q(e){return async(t,n)=>await $(e,t,n)}async function $(e,t,n){return await e(t,n)}function Re(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}j(process.argv[1]??``).href===import.meta.url&&K(process.argv.slice(2)).catch(async e=>{let r=t(e);await U(n(r),{debugTier:!0,argv:process.argv.slice(2)}),await w(1)});function ze(e){try{let t=A.existsSync(e)?A.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&A.existsSync(e))try{let n=A.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=A.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);A.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{A.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{K as runCli};
1
+ import{s as e,t}from"./sdk-batch.js";import{_ as n,x as r,z as i}from"./sdk-contracts.js";import{c as a,d as o,f as s,p as c}from"./sdk-batch-runner.js";import{Ct as l,St as u,Tt as d,ft as f,h as ee,kt as te,wt as p,xt as ne}from"./sdk-io.js";import"./diagnostics.js";import{t as m}from"./src.js";import{r as h}from"./catalog.js";import{V as g,a as _}from"./src3.js";import{r as v}from"./command-schema.js";import{t as y}from"./merge-flags.js";import{n as re,r as ie,t as b}from"./cli-config.js";import"./command.js";import{a as ae}from"./version.js";import{h as oe}from"./daemon-resolution.js";import{i as se,n as x}from"./src4.js";import{t as ce}from"./update-check.js";import{a as le,i as S,n as ue,o as de,r as C}from"./args.js";import{exitAfterFlush as w}from"./process-exit.js";import{n as T,r as E}from"./remote-config-flags.js";import{m as D,v as O}from"./remote-connection-state.js";import{i as k}from"./auth-session.js";import A from"node:fs";import{pathToFileURL as j}from"node:url";const M=`${a} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,N=`${t} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function P(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)=>F(e,t+1))}function F(t,r){let i=c(t,r,M),a=[`positionals`,`flags`].filter(e=>e in i);if(a.length>0){let e=a.map(e=>`"${e}"`).join(`, `);throw new n(`INVALID_ARGS`,`Batch step ${r} uses removed field(s): ${e}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:M})}g(i,[`command`,`input`,`runtime`],`Batch step ${r}`,M);let l=o(i.runtime,r);return{command:e(i.command,r,N),input:s(i,r,M),...l===void 0?{}:{runtime:l}}}function I(){return{renderedToStderr:!1}}function L(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function R(e){return _(e)}const z={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(`./device3.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(`./screenshot4.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot4.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function B(e){let t={...e.flags},n=z[e.command];return n&&await(await n())({...e,flags:t})?!0:R(e.command)?await V({...e,command:e.command,flags:t}):!1}async function V(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function H(e,t){let n=C(e),{env:r,cwd:i}=t,a=fe(n.command)?T({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{flags:{}},o=ie({command:n.command,cwd:i,cliFlags:n.flags,env:r}),s=o.devicePin,c=y(o.flags,a.flags);return{...ue(n,{strictFlags:t?.strictFlags,defaultFlags:c}),providedFlags:n.providedFlags,remoteConfigLeaseProvider:a.leaseProvider,devicePin:s}}function fe(e){return e!==null}const U=async(...e)=>(await import(`./failure-output.js`)).printHumanError(...e),W=e=>import(`./json.js`).then(({printJson:t})=>t(e)),pe={sendToDaemon:x({onReplaced:G}),transportForHost:e=>x({host:e,onReplaced:G})};function G(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 me=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),he=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function K(e,t=pe,n=ee(process)){await f({host:n,requestEnv:void 0},async()=>await ge(e,t,n))}async function ge(e,t,n){let r=se(t,n),i=ne(),a=ae(),o=Te(e),s=e.includes(`--json`),c=Re(e)??n.env.AGENT_DEVICE_SESSION??`default`;await te({session:c,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:c,positionals:l}=await _e(e,{host:n,version:a,jsonRequested:s,debugEnabled:o}),u=X(c,t.providedFlags),d=await ve(t,{host:n,command:c,positionals:l,requestId:i,debugOutputEnabled:u});q(d.effectiveFlags);let f=null;try{if(c===`react-devtools`){await w(await ye(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(ce({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await be(d,r),q(d.effectiveFlags),c===`cdp`){await w(await E(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=xe(d);let e=await Se(d),t=I();await Ce(d,m(Y(d),{host:d.host,devicePin:d.devicePin,transport:Ie({host:n,command:c,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await we(e,d,f)}finally{f&&f()}})}function q(e){e.daemonAuthToken&&d(e.daemonAuthToken)}async function _e(e,t){let r;try{r=H(e,{cwd:t.host.cwd,env:t.host.env})}catch(n){return await J(n,e,t)}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 i=r.command===`help`,a=r.flags.help;if(i||a){if(i&&r.positionals.length>1)return await U(new n(`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 S()}\n`),w(0);let t=await le(e);return t?(process.stdout.write(t),w(0)):(await U(new n(`INVALID_ARGS`,Ee(e))),process.stdout.write(`${await S()}\n`),w(1))}return r.command?r.command===`mcp`?await J(new n(`INVALID_ARGS`,`mcp accepts no flags or arguments other than --structured, --help, and --version.`,{hint:`Run agent-device mcp or agent-device mcp --structured. Configure the server with AGENT_DEVICE_* environment variables or AGENT_DEVICE_CONFIG.`}),e,t):{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await S()}\n`),w(1))}async function J(e,t,n){u({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let r=i(e,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});return n.jsonRequested?await W({success:!1,error:r}):await U(r,{debugTier:n.debugEnabled,argv:t}),await w(1)}async function ve(e,t){let n=new Set(e.providedFlags.map(e=>e.key));try{let r=re({env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=v(t.command)?.explicitOnlyFlags?.includes(`platform`)===!0,a=r.lockPolicy||i?{...e.flags}:b(e.flags,{env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),o=t.command===`connect`&&!a.remoteConfig;if(a.session===void 0&&(e.remoteConfigLeaseProvider||o))throw D(e.remoteConfigLeaseProvider);let s=oe(a.stateDir,{env:t.host.env,cwd:t.host.cwd}),c=a.session??`default`,l=Z({host:t.host,command:t.command,stateDir:s.baseDir,session:a.session,remoteConfig:a.remoteConfig}),u=l?Pe(a,l.flags,n):a;return{...t,binding:r,flags:a,daemonPaths:s,sessionName:c,connectionDefaults:l,explicitFlagKeys:n,effectiveFlags:u,resolvedRuntime:l?.runtime,connectionMetadata:l?.connection,parsedBatchSteps:void 0,devicePin:e.devicePin}}catch(n){let a=r(n),o=i(a,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});return e.flags.json?await W({success:!1,error:o}):await U(o,{debugTier:t.debugOutputEnabled,command:e.command}),w(1)}}async function ye(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 be(e,t){if(e.command===`batch`){if(e.positionals.length>0)throw new n(`INVALID_ARGS`,`batch does not accept positional arguments.`);e.parsedBatchSteps=Oe(e.flags)}if(je(e.command)&&(e.effectiveFlags=(await k({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&Ae(e.command)){let n=m(Y(e),{host:e.host,devicePin:e.devicePin,transport:Q(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:Fe(e.explicitFlagKeys)});e.effectiveFlags=i.flags,e.resolvedRuntime=i.runtime,e.connectionMetadata=i.connection,e.leaseDevice=i.leaseDevice}Me({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 Y(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,providerNetworkLogs:t.providerNetworkLogs,providerNetworkHosts:t.providerNetworkHosts,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 xe(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?ze(e.daemonPaths.logPath):null}async function Se(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 Ce(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}:b(t.input,{env:e.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await B({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 B({host:e.host,command:a,positionals:o,flags:s,client:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i,leaseDevice:e.leaseDevice}))return;throw new n(`INVALID_ARGS`,De(a))}async function we(e,t,n){let a=r(e),o=i(a,{diagnosticId:p().diagnosticId,logPath:l({force:!0})?.path});if(t.command===`close`&&ke(a)){t.effectiveFlags.json&&await W({success:!0,data:{closed:`session`,source:`no-daemon`}});return}n&&n(),t.effectiveFlags.json?await W({success:!1,error:o}):await U(o,{debugTier:t.debugOutputEnabled,command:t.command,logTail:t.debugOutputEnabled?{daemonBaseUrl:t.effectiveFlags.daemonBaseUrl,daemonPaths:t.daemonPaths,record:o.diagnosticsRecord}:void 0}),await w(1)}function Te(e){try{let t=C(e);return X(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function Ee(e){let t=de(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function De(e){return h(e)?(u({level:`error`,phase:`cli_known_command_unhandled`,data:{command:e}}),`Command is registered but no CLI handler accepted it: ${e}`):`Unknown command: ${e}`}function X(e,t){return t.some(t=>t.key===`verbose`&&(t.token===`--debug`||t.token===`-v`||e!==`test`))}function Oe(e){let t=``;if(e.steps)t=e.steps;else if(e.stepsFile)try{t=A.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 P(t)}function ke(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 Z(e){return e.command===`connect`||e.command===`connection`||e.command===`daemon`||e.command===`plugins`||e.command===`device`||e.command===`proxy`?null:O({stateDir:e.stateDir,session:e.session,remoteConfig:e.remoteConfig,cwd:e.host.cwd,env:e.host.env,validateRemoteConfigHash:e.command!==`disconnect`})}function Ae(e){return!he.has(e)}function je(e){return e!==`auth`&&e!==`connection`&&e!==`daemon`&&e!==`plugins`&&e!==`device`&&e!==`proxy`}function Me(e){return e.command!==`open`||e.runtime||e.flags.bundleUrl||e.flags.metroHost||e.flags.metroPort||e.flags.remoteConfig||e.hadConnectionDefaults?!1:Ne(e.explicitFlagKeys)}function Ne(e){return e.has(`daemonBaseUrl`)||e.has(`daemonTransport`)||e.has(`tenant`)||e.has(`sessionIsolation`)||e.has(`runId`)||e.has(`leaseId`)||e.has(`leaseBackend`)}function Pe(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 Fe(e){for(let t of me)if(e.has(t))return!0;return!1}function Ie(e){let t=Le(e);return e.flags.remoteConfig?async(n,r)=>{let i=await t(n,r),{forgetEndedConnectionLease:a}=await import(`./ended-lease.js`);return a(e.flags,i,e.host),i}:t}function Le(e){let{command:t,flags:n,replayTestReporterRuntime:r,transport:i}=e;if(n.json)return Q(i);let a=t===`test`&&r?r.onProgress:L(e.commandProgress);return async(e,n)=>{let r={...n,onProgress:a};return await $(i,{...e,meta:{...e.meta,requestProgress:t===`test`?`replay-test`:`command`}},r)}}function Q(e){return async(t,n)=>await $(e,t,n)}async function $(e,t,n){return await e(t,n)}function Re(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}j(process.argv[1]??``).href===import.meta.url&&K(process.argv.slice(2)).catch(async e=>{let t=r(e);await U(i(t),{debugTier:!0,argv:process.argv.slice(2)}),await w(1)});function ze(e){try{let t=A.existsSync(e)?A.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&A.existsSync(e))try{let n=A.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=A.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);A.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{A.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{K as runCli};
@@ -1 +1 @@
1
- import{P as e}from"./sdk-contracts.js";const t=[`primary`,`secondary`,`middle`];function n(e){return e?.clickButton??`primary`}function r(t){return t.button===`primary`?null:t.commandLabel===`click`?t.platform!==`macos`&&t.platform!==`linux`?new e(`UNSUPPORTED_OPERATION`,`click --button ${t.button} is supported only on macOS and Linux`):t.platform===`macos`&&t.button===`middle`?new e(`UNSUPPORTED_OPERATION`,`click --button middle is not supported by the macOS runner yet`):typeof t.count==`number`||typeof t.intervalMs==`number`||typeof t.holdMs==`number`||typeof t.jitterPx==`number`||t.doubleTap===!0?new e(`INVALID_ARGS`,`click --button ${t.button} does not support repeat or gesture modifier flags`):null:new e(`INVALID_ARGS`,`--button is supported only for click`)}function i(e){return e===`primary`?{}:{button:e}}export{n as i,i as n,r,t};
1
+ import{_ as e}from"./sdk-contracts.js";const t=[`primary`,`secondary`,`middle`];function n(e){return e?.clickButton??`primary`}function r(t){return t.button===`primary`?null:t.commandLabel===`click`?t.platform!==`macos`&&t.platform!==`linux`?new e(`UNSUPPORTED_OPERATION`,`click --button ${t.button} is supported only on macOS and Linux`):t.platform===`macos`&&t.button===`middle`?new e(`UNSUPPORTED_OPERATION`,`click --button middle is not supported by the macOS runner yet`):typeof t.count==`number`||typeof t.intervalMs==`number`||typeof t.holdMs==`number`||typeof t.jitterPx==`number`||t.doubleTap===!0?new e(`INVALID_ARGS`,`click --button ${t.button} does not support repeat or gesture modifier flags`):null:new e(`INVALID_ARGS`,`--button is supported only for click`)}function i(e){return e===`primary`?{}:{button:e}}export{n as i,i as n,r,t};
@@ -1 +1 @@
1
- import{P as e}from"./sdk-contracts.js";import{I as t,P as n,S as r,f as i,g as a,h as o,j as s,nt as ee}from"./sdk-io.js";import{n as c,o as l}from"./file.js";import"./command.js";import{t as u}from"./base-url.js";import{a as d,c as f,d as p,f as m,i as h,l as g,n as _,o as v,r as y,s as b,u as x}from"./client-companion-tunnel-contract.js";import{createHash as S}from"node:crypto";import C from"node:fs";import w from"node:path";import{fileURLToPath as T}from"node:url";const E=`companion-tunnel`;function D(e){return S(`sha256`).update(e).digest(`hex`)}function O(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function k(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 A(e,t){return e.tenantId===t.tenantId&&e.runId===t.runId&&e.leaseId===t.leaseId}function j(e,t,n,r){let i=r??w.join(e,`.agent-device`),a=w.join(i,`${t.slug}.lock`);if(!n)return{statePath:w.join(i,`${t.slug}.json`),logPath:w.join(i,`${t.slug}.log`),lockPath:a};let o=D(n).slice(0,12),s=w.join(i,t.slug);return{statePath:w.join(s,`${t.slug}-${o}.json`),logPath:w.join(s,`${t.slug}-${o}.log`),lockPath:a}}async function M(e,t,n){let r=i();return await l({acquire:()=>c({lockDirPath:e.lockPath,owner:{pid:r.pid,startTime:r.startTime,acquiredAtMs:Date.now()},description:`${t.displayName} state`}),task:n})}function N(e){try{let t=JSON.parse(C.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:O(t.launchUrl),registerPath:O(t.registerPath),unregisterPath:O(t.unregisterPath),bridgeScope:k(t.bridgeScope),tokenHash:t.tokenHash,consumers:n}}catch{return null}}function P(e,t){C.mkdirSync(w.dirname(e),{recursive:!0}),C.writeFileSync(e,`${JSON.stringify(t,null,2)}\n`,`utf8`)}function F(e){C.mkdirSync(w.dirname(e),{recursive:!0}),C.closeSync(C.openSync(e,`a`))}function I(e){try{C.unlinkSync(e)}catch{}}function L(e){try{C.readdirSync(e).length===0&&C.rmdirSync(e)}catch{}}function R(e){let t=w.dirname(e.statePath),n=w.dirname(e.logPath);I(e.statePath),I(e.logPath),t!==w.dirname(e.lockPath)&&L(t),n!==t&&L(n)}function z(e,t){return e.includes(t.runArg)}function B(e,t){if(!r(e.pid))return!1;if(e.startTime){let t=n(e.pid);if(!t||t!==e.startTime)return!1}let i=s(e.pid);return!i||!z(i,t.definition)||!e.bridgeScope?!1:e.serverBaseUrl===u(t.serverBaseUrl)&&e.localBaseUrl===u(t.localBaseUrl)&&e.launchUrl===O(t.launchUrl)&&e.registerPath===O(t.registerPath)&&e.unregisterPath===O(t.unregisterPath)&&A(e.bridgeScope,t.bridgeScope)&&e.tokenHash===D(t.bearerToken)}function V(e){return O(e.consumerKey)??O(e.profileKey)??null}function H(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}function U(e,t){return t?{...e,consumers:e.consumers.filter(e=>e!==t)}:{...e,consumers:[]}}async function W(e,n,r){let i=await t({pid:e.pid,identity:{startTime:e.startTime,matches:e=>z(e,n)}},{termTimeoutMs:1e3,killTimeoutMs:1e3});if(i.status===`retained`)throw G({...i,pid:e.pid},n,r)}function G(t,n,r){let i=t.reason===`identity-unverified`?`${n.displayName} ${a(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,{...o(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 K(e,t){try{P(e,t)}catch{}}function q(e,t,n){n===void 0?delete e[t]:e[t]=n}function J(e,t){let n={...t};return n[g]=u(e.serverBaseUrl),n[_]=e.bearerToken,n[h]=u(e.localBaseUrl),n[x]=j(e.projectRoot,e.definition,e.profileKey,e.stateDir).statePath,n[f]=e.bridgeScope.tenantId,n[b]=e.bridgeScope.runId,n[v]=e.bridgeScope.leaseId,q(n,y,O(e.launchUrl)),q(n,d,O(e.registerPath)),q(n,p,O(e.unregisterPath)),n}function Y(e){let t=T(import.meta.url),n=w.extname(t)||`.js`,r=[w.join(w.dirname(t),`${E}${n}`),w.join(w.dirname(t),`internal`,`${E}${n}`)].find(e=>C.existsSync(e));if(!r)throw Error(`${e.displayName} entrypoint not found. Rebuild the package to include the companion worker entry.`);return r}function X(e,t){let r=Y(e.definition),i=r.endsWith(`.ts`)?[`--experimental-strip-types`]:[];C.mkdirSync(w.dirname(t),{recursive:!0});let a=C.openSync(t,`a`),o=0;try{o=ee(process.execPath,[...i,r,e.definition.runArg],{cwd:e.cwd,env:J(e,e.env),stdio:[`ignore`,a,a]})}finally{C.closeSync(a)}if(!Number.isInteger(o)||o<=0)throw Error(`Failed to start ${e.definition.displayName} process.`);return{pid:o,startTime:n(o)??void 0,command:s(o)??void 0,serverBaseUrl:u(e.serverBaseUrl),localBaseUrl:u(e.localBaseUrl),launchUrl:O(e.launchUrl),registerPath:O(e.registerPath),unregisterPath:O(e.unregisterPath),bridgeScope:e.bridgeScope,tokenHash:D(e.bearerToken),consumers:[]}}async function Z(e){let t=V(e),n=j(e.projectRoot,e.definition,e.profileKey,e.stateDir);return await M(n,e.definition,async()=>await Q(e,t,n))}async function Q(t,n,r){let i=N(r.statePath);if(i&&B(i,t)){let e=H(i,n);return e!==i&&P(r.statePath,e),{pid:i.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}i&&(await W(i,t.definition,r),R(r)),F(r.statePath);let a;try{a=X(t,r.logPath),P(r.statePath,H(a,n))}catch(n){if(a)try{await W(a,t.definition,r)}catch(t){throw K(r.statePath,a),t instanceof e&&(t.cause=n),t}throw R(r),n}return{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function te(e){let t=V(e),n=j(e.projectRoot,e.definition,e.profileKey,e.stateDir);return await M(n,e.definition,async()=>{let r=N(n.statePath);if(!r)return R(n),{stopped:!1,statePath:n.statePath};let i=U(r,t);return i.consumers.length>0?(P(n.statePath,i),{stopped:!1,statePath:n.statePath}):(await W(r,e.definition,n),R(n),{stopped:!0,statePath:n.statePath})})}const $={slug:`metro-companion`,runArg:m,displayName:`Metro companion`};async function ne(e){return await Z({...e,definition:$,registerPath:e.registerPath??`/api/metro/companion/register`})}async function re(e){return await te({...e,definition:$})}export{ne as ensureMetroCompanion,re as stopMetroCompanion};
1
+ import{_ as e}from"./sdk-contracts.js";import{C as t,I as n,N as r,R as i,_ as a,at as o,g as s,p as c}from"./sdk-io.js";import{n as l,o as u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{a as ee,c as f,d as p,f as m,i as h,l as g,n as _,o as v,r as y,s as b,u as x}from"./client-companion-tunnel-contract.js";import{createHash as S}from"node:crypto";import C from"node:fs";import w from"node:path";import{fileURLToPath as T}from"node:url";const E=`companion-tunnel`;function D(e){return S(`sha256`).update(e).digest(`hex`)}function O(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function k(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 A(e,t){return e.tenantId===t.tenantId&&e.runId===t.runId&&e.leaseId===t.leaseId}function j(e,t,n,r){let i=r??w.join(e,`.agent-device`),a=w.join(i,`${t.slug}.lock`);if(!n)return{statePath:w.join(i,`${t.slug}.json`),logPath:w.join(i,`${t.slug}.log`),lockPath:a};let o=D(n).slice(0,12),s=w.join(i,t.slug);return{statePath:w.join(s,`${t.slug}-${o}.json`),logPath:w.join(s,`${t.slug}-${o}.log`),lockPath:a}}async function M(e,t,n){let r=c();return await u({acquire:()=>l({lockDirPath:e.lockPath,owner:{pid:r.pid,startTime:r.startTime,acquiredAtMs:Date.now()},description:`${t.displayName} state`}),task:n})}function N(e){try{let t=JSON.parse(C.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:O(t.launchUrl),registerPath:O(t.registerPath),unregisterPath:O(t.unregisterPath),bridgeScope:k(t.bridgeScope),tokenHash:t.tokenHash,consumers:n}}catch{return null}}function P(e,t){C.mkdirSync(w.dirname(e),{recursive:!0}),C.writeFileSync(e,`${JSON.stringify(t,null,2)}\n`,`utf8`)}function F(e){C.mkdirSync(w.dirname(e),{recursive:!0}),C.closeSync(C.openSync(e,`a`))}function I(e){try{C.unlinkSync(e)}catch{}}function L(e){try{C.readdirSync(e).length===0&&C.rmdirSync(e)}catch{}}function R(e){let t=w.dirname(e.statePath),n=w.dirname(e.logPath);I(e.statePath),I(e.logPath),t!==w.dirname(e.lockPath)&&L(t),n!==t&&L(n)}function z(e,t){return e.includes(t.runArg)}function B(e,i){if(!t(e.pid))return!1;if(e.startTime){let t=n(e.pid);if(!t||t!==e.startTime)return!1}let a=r(e.pid);return!a||!z(a,i.definition)||!e.bridgeScope?!1:e.serverBaseUrl===d(i.serverBaseUrl)&&e.localBaseUrl===d(i.localBaseUrl)&&e.launchUrl===O(i.launchUrl)&&e.registerPath===O(i.registerPath)&&e.unregisterPath===O(i.unregisterPath)&&A(e.bridgeScope,i.bridgeScope)&&e.tokenHash===D(i.bearerToken)}function V(e){return O(e.consumerKey)??O(e.profileKey)??null}function H(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}function U(e,t){return t?{...e,consumers:e.consumers.filter(e=>e!==t)}:{...e,consumers:[]}}async function W(e,t,n){let r=await i({pid:e.pid,identity:{startTime:e.startTime,matches:e=>z(e,t)}},{termTimeoutMs:1e3,killTimeoutMs:1e3});if(r.status===`retained`)throw G({...r,pid:e.pid},t,n)}function G(t,n,r){let i=t.reason===`identity-unverified`?`${n.displayName} ${a(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 K(e,t){try{P(e,t)}catch{}}function q(e,t,n){n===void 0?delete e[t]:e[t]=n}function J(e,t){let n={...t};return n[g]=d(e.serverBaseUrl),n[_]=e.bearerToken,n[h]=d(e.localBaseUrl),n[x]=j(e.projectRoot,e.definition,e.profileKey,e.stateDir).statePath,n[f]=e.bridgeScope.tenantId,n[b]=e.bridgeScope.runId,n[v]=e.bridgeScope.leaseId,q(n,y,O(e.launchUrl)),q(n,ee,O(e.registerPath)),q(n,p,O(e.unregisterPath)),n}function Y(e){let t=T(import.meta.url),n=w.extname(t)||`.js`,r=[w.join(w.dirname(t),`${E}${n}`),w.join(w.dirname(t),`internal`,`${E}${n}`)].find(e=>C.existsSync(e));if(!r)throw Error(`${e.displayName} entrypoint not found. Rebuild the package to include the companion worker entry.`);return r}function X(e,t){let i=Y(e.definition),a=i.endsWith(`.ts`)?[`--experimental-strip-types`]:[];C.mkdirSync(w.dirname(t),{recursive:!0});let s=C.openSync(t,`a`),c=0;try{c=o(process.execPath,[...a,i,e.definition.runArg],{cwd:e.cwd,env:J(e,e.env),stdio:[`ignore`,s,s]})}finally{C.closeSync(s)}if(!Number.isInteger(c)||c<=0)throw Error(`Failed to start ${e.definition.displayName} process.`);return{pid:c,startTime:n(c)??void 0,command:r(c)??void 0,serverBaseUrl:d(e.serverBaseUrl),localBaseUrl:d(e.localBaseUrl),launchUrl:O(e.launchUrl),registerPath:O(e.registerPath),unregisterPath:O(e.unregisterPath),bridgeScope:e.bridgeScope,tokenHash:D(e.bearerToken),consumers:[]}}async function Z(e){let t=V(e),n=j(e.projectRoot,e.definition,e.profileKey,e.stateDir);return await M(n,e.definition,async()=>await Q(e,t,n))}async function Q(t,n,r){let i=N(r.statePath);if(i&&B(i,t)){let e=H(i,n);return e!==i&&P(r.statePath,e),{pid:i.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}i&&(await W(i,t.definition,r),R(r)),F(r.statePath);let a;try{a=X(t,r.logPath),P(r.statePath,H(a,n))}catch(n){if(a)try{await W(a,t.definition,r)}catch(t){throw K(r.statePath,a),t instanceof e&&(t.cause=n),t}throw R(r),n}return{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function te(e){let t=V(e),n=j(e.projectRoot,e.definition,e.profileKey,e.stateDir);return await M(n,e.definition,async()=>{let r=N(n.statePath);if(!r)return R(n),{stopped:!1,statePath:n.statePath};let i=U(r,t);return i.consumers.length>0?(P(n.statePath,i),{stopped:!1,statePath:n.statePath}):(await W(r,e.definition,n),R(n),{stopped:!0,statePath:n.statePath})})}const $={slug:`metro-companion`,runArg:m,displayName:`Metro companion`};async function ne(e){return await Z({...e,definition:$,registerPath:e.registerPath??`/api/metro/companion/register`})}async function re(e){return await te({...e,definition:$})}export{ne as ensureMetroCompanion,re as stopMetroCompanion};
@@ -1 +1 @@
1
- import{P as e,R as t}from"./sdk-contracts.js";import{E as n,I as r,P as i,W as a,at as o,g as s,h as c,nt as l}from"./sdk-io.js";import{u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{t as f}from"./bundle-url.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{o(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 a(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,a,o,s,c){let u=U(n,r,a,o);y.mkdirSync(b.dirname(s),{recursive:!0});let d=y.openSync(s,`a`),f=0;try{f=l(u.command,u.installArgs,{cwd:t,env:c,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:i(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 o=i.reason===`identity-unverified`?s(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 ${o}; 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(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,r,i,a,o){let s;try{s=(await h({projectRoot:r.projectRoot,serverBaseUrl:r.proxyBaseUrl,bearerToken:r.proxyBearerToken,bridgeScope:i,localBaseUrl:`http://${r.statusHost}:${r.metroPort}`,launchUrl:S(t.launchUrl),profileKey:S(t.companionProfileKey),consumerKey:S(t.companionConsumerKey),env:r.env,cwd:r.cwd})).logPath}catch(t){throw new e(`COMMAND_FAILED`,$(r.proxyBaseUrl,t instanceof Error?t.message:String(t),a,o),t instanceof e?n(t.details):void 0,t)}try{return await le({baseUrl:r.proxyBaseUrl,bearerToken:r.proxyBearerToken,scope:i,probeTimeoutMs:r.probeTimeoutMs,startupTimeoutMs:r.startupTimeoutMs,initialBridgeError:o,companionLogPath:s})}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};
1
+ import{_ as e,x as t}from"./sdk-contracts.js";import{I as n,O as r,R as i,_ as a,at as o,ct as s,g as c,q as l}from"./sdk-io.js";import{u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{t as f}from"./bundle-url.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{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=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 l(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,r,i,a,s,c,l){let u=U(r,i,a,s);y.mkdirSync(b.dirname(c),{recursive:!0});let d=y.openSync(c,`a`),f=0;try{f=o(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:n(f)??void 0}}function G(t,n,r,i){let o=`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`,o,{logPath:n.logPath},i.throws);if(i.status===`stopped`)return new e(`COMMAND_FAILED`,o,{logPath:n.logPath});let s=i.reason===`identity-unverified`?a(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`,`${o} 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(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 r=await i({pid:n.pid,identity:{startTime:n.startTime}},{termTimeoutMs:1e3,killTimeoutMs:1e3}).catch(e=>({throws:e}));throw G(t,e,n.pid,r)}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,i,a,o){let s;try{s=(await h({projectRoot:n.projectRoot,serverBaseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,bridgeScope:i,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),a,o),t instanceof e?r(t.details):void 0,t)}try{return await le({baseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,scope:i,probeTimeoutMs:n.probeTimeoutMs,startupTimeoutMs:n.startupTimeoutMs,initialBridgeError:o,companionLogPath:s})}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};
@@ -1 +1 @@
1
- import{P as e,q as t}from"./sdk-contracts.js";const n=`agent-device-cli`;function r(e){return`${n}/${e}`}const i=Object.freeze({maxRetries:0});async function a(e,n,r){try{return n===`ios`?await e.iosInstances.delete(r,i):await e.androidInstances.delete(r,i),{failure:void 0,cause:void 0}}catch(e){return o(e)===404?{failure:void 0,cause:void 0}:{failure:t(e),cause:e}}}function o(e){if(!e||typeof e!=`object`)return;let t=e.status;return typeof t==`number`?t:void 0}function s(t,n,r=`This daemon drives an existing Limrun instance with its own token. Set LIMRUN_API_KEY, or ask the instance owner to do this.`){if(t)return t;throw new e(`UNSUPPORTED_OPERATION`,`${n} requires a Limrun API key.`,{hint:r})}export{s as a,r as i,i as n,a as r,n as t};
1
+ import{A as e,_ as t}from"./sdk-contracts.js";const n=`agent-device-cli`;function r(e){return`${n}/${e}`}const i=Object.freeze({maxRetries:0});async function a(t,n,r){try{return n===`ios`?await t.iosInstances.delete(r,i):await t.androidInstances.delete(r,i),{failure:void 0,cause:void 0}}catch(t){return o(t)===404?{failure:void 0,cause:void 0}:{failure:e(t),cause:t}}}function o(e){if(!e||typeof e!=`object`)return;let t=e.status;return typeof t==`number`?t:void 0}function s(e,n,r=`This daemon drives an existing Limrun instance with its own token. Set LIMRUN_API_KEY, or ask the instance owner to do this.`){if(e)return e;throw new t(`UNSUPPORTED_OPERATION`,`${n} requires a Limrun API key.`,{hint:r})}export{s as a,r as i,i as n,a as r,n as t};