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,6 +1,6 @@
1
- import { A as IosTargetActivation, C as DeviceTarget, E as PublicPlatform, G as SnapshotViewportSize, H as SnapshotQualityNote, I as SnapshotCommandOptionFields, K as SnapshotVisibility, L as SnapshotKeyboardBandFact, M as PresentedSurface, O as AppleApplicationState, R as SnapshotNode, S as DeviceKind, T as PlatformSelector, U as SnapshotQualityVerdict, W as SnapshotUnchanged, Z as DaemonError, _ as SessionIsolationMode, a as DaemonRequest, b as BootPickPolicy, c as DaemonServerMode, et as NormalizedError, f as LeaseBackend, g as ResponseLevel, i as DaemonLockPolicy, j as Point, k as IosSnapshotObservation, l as DaemonTransportPreference, m as NetworkIncludeMode, o as DaemonResponse, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, v as SessionRuntimeHints, y as AppleOS } from "./sdk-contracts.js";
1
+ import { A as IosSnapshotObservation, C as DeviceKind, D as PublicPlatform, E as PlatformSelector, G as SnapshotUnchanged, K as SnapshotViewportSize, L as SnapshotCommandOptionFields, M as Point, N as PresentedSurface, Q as DaemonError, R as SnapshotKeyboardBandFact, U as SnapshotQualityNote, W as SnapshotQualityVerdict, _ as ScriptDeliveryFailure, a as DaemonRequest, b as AppleOS, c as DaemonServerMode, f as LeaseBackend, g as ResponseLevel, i as DaemonLockPolicy, j as IosTargetActivation, k as AppleApplicationState, l as DaemonTransportPreference, m as NetworkIncludeMode, o as DaemonResponse, q as SnapshotVisibility, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, tt as NormalizedError, v as SessionIsolationMode, w as DeviceTarget, x as BootPickPolicy, y as SessionRuntimeHints, z as SnapshotNode } from "./sdk-contracts.js";
2
2
  import { t as BatchRunResult } from "./sdk-batch-runner.js";
3
- import { _ as PressCommandResponseData, f as ClickCommandResponseData, g as LongPressCommandResponseData, h as HoverCommandResponseData, m as FindCommandResponseData, p as FillCommandResponseData, v as SettleObservation, y as ClickButton } from "./sdk-selectors.js";
3
+ import { _ as PressCommandResponseData, b as PostGestureOutcome, f as ClickCommandResponseData, g as LongPressCommandResponseData, h as HoverCommandResponseData, m as FindCommandResponseData, p as FillCommandResponseData, v as SettleObservation, y as ClickButton } from "./sdk-selectors.js";
4
4
  import { A as ScrollDirection, C as HardwareButtonName, D as ScreenshotCaptureBackend, E as SnapshotDiagnosticsSummary, F as BackMode, I as SessionSurface, M as SwipePattern, N as SwipePreset, P as TransformGestureParams, S as FoldScreenCoordinateSpace, T as SetFoldPoseInput, _ as TvRemoteButton, a as AndroidSnapshotBackendMetadata, b as DeviceRotation, c as ScreenshotResultData, d as PermissionAction, f as PermissionMode, h as SettingName, i as CloudProviderSessionResult, j as ScrollInputDirection, k as ScreenshotScreenMask, l as MACOS_PERMISSION_TARGETS, m as SETTINGS, o as FindLocator, t as AgentArtifactsResult, u as MOBILE_PERMISSION_TARGETS, v as ScrollCommandResult, w as OrientationRequest, x as FoldPose } from "./cloud-artifacts.js";
5
5
  import { a as RecordingExportQuality, i as RecordingScope, r as ReplaySuiteResult, t as ReplayCommandResult } from "./replay.js";
6
6
  import { c as MetroPrepareOptions, d as MetroReloadResult, l as MetroPrepareResult, o as RemoteConnectionProfileFields, r as CloudProviderProfileFields, u as MetroReloadOptions } from "./sdk-remote-config.js";
@@ -312,6 +312,12 @@ type AgentDeviceSessionDevice = {
312
312
  * Apple devices; `platform` still carries the leaf (`ios`/`macos`).
313
313
  */
314
314
  appleOs?: AppleOS;
315
+ /** Simulator/emulator/physical split. Absent only from a daemon older than the field. */
316
+ kind?: DeviceKind;
317
+ /** Hardware model, for example `iPhone 17 Pro` or `Pixel 9`, when the host or provider reports it. */
318
+ model?: string;
319
+ /** OS version, for example `26.1` or `16`, when the host or provider reports it. Never inferred. */
320
+ osVersion?: string;
315
321
  identifiers: AgentDeviceIdentifiers;
316
322
  ios?: {
317
323
  udid: string;
@@ -491,156 +497,58 @@ type HumanControlHoldOptions = {
491
497
  ttlMs?: number;
492
498
  };
493
499
  //#endregion
494
- //#region packages/contracts/src/client-app.d.ts
495
- type DeviceSelectionReason = 'explicit-selector' | 'existing-session' | 'single-booted-local' | 'single-bootable-local' | 'single-app-installed-local' |
496
- /** `boot --pick newest` chose among several equally preferred, shut-down local devices. */
497
- 'newest-bootable-local' | 'preferred-local' | 'single-provider-device';
498
- type DeviceSelectionSource = 'session' | 'local' | 'provider';
499
- /** Deterministic device-selection evidence shared by daemon responses and the published client. */
500
- type DeviceSelectionMetadata = {
501
- reason: DeviceSelectionReason;
502
- source: DeviceSelectionSource;
503
- candidateCount: number;
504
- /** Whether this request booted a previously stopped local virtual target during open. */
505
- bootOccurred: boolean;
506
- };
507
- type AppInstallOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
508
- app?: string;
509
- appPath: string;
510
- };
511
- type AppDeployOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
512
- app: string;
513
- appPath: string;
514
- };
515
- type AppDeployResult = {
516
- app: string;
517
- appPath: string;
518
- platform: PublicPlatform;
519
- appId?: string;
520
- bundleId?: string;
521
- package?: string;
522
- identifiers: AgentDeviceIdentifiers;
523
- };
524
- type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
525
- app?: string;
526
- url?: string;
527
- surface?: SessionSurface;
528
- activity?: string;
529
- launchConsole?: string;
530
- launchArgs?: string[];
531
- relaunch?: boolean;
532
- /** Startup budget in milliseconds: bounds the Simulator boot wait on a cold device. */
533
- timeoutMs?: number;
534
- /**
535
- * Wait up to n milliseconds (100-120000) while another session holds the device, then fail
536
- * with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this
537
- * command's timeout.
538
- */
539
- waitMs?: number;
540
- /**
541
- * Include an initial interactive snapshot in a fresh open response. With no
542
- * app argument, discover the sole running app on the sole booted iOS
543
- * simulator; ambiguous environments fail closed.
544
- */
545
- foreground?: boolean;
546
- saveScript?: boolean | string;
547
- /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
548
- force?: boolean;
549
- testIme?: boolean;
550
- noRecord?: boolean;
551
- runtime?: SessionRuntimeHints;
552
- };
553
- type AppOpenResult = AppOpenResultBase & (LaunchConfirmationClientOutcome | LaunchConfirmationAbsent);
554
- type AppOpenResultBase = {
555
- session: string;
556
- warnings?: string[];
557
- sessionStateDir?: string;
558
- runnerLogPath?: string;
559
- requestLogPath?: string;
560
- eventLogPath?: string;
561
- appName?: string;
562
- appBundleId?: string;
563
- appId?: string;
564
- startup?: StartupPerfSample;
565
- runtime?: SessionRuntimeHints;
566
- selection?: DeviceSelectionMetadata;
567
- device?: AgentDeviceSessionDevice;
568
- /**
569
- * Initial interactive snapshot captured immediately after an open that
570
- * requested `foreground`, composed from the same snapshot-runtime dispatch
571
- * `agent-device snapshot -i` uses. It stays loosely typed rather than reusing
572
- * `CaptureSnapshotResult` because the daemon-side composition does not attach
573
- * client-only fields like `identifiers`.
574
- */
575
- snapshot?: Record<string, unknown>;
576
- /**
577
- * open --foreground: present when the session opened successfully but the
578
- * composed initial snapshot capture failed. Carries the FULL daemon error
579
- * shape (code, message, hint, details, diagnosticId, logPath) so recovery
580
- * guidance survives to the caller; the session itself is open and usable —
581
- * a `warnings` entry says so and points at `snapshot -i`.
582
- */
583
- initialSnapshotError?: DaemonError;
584
- identifiers: AgentDeviceIdentifiers;
585
- };
586
- type AppCloseOptions = AgentDeviceRequestOverrides & {
587
- app?: string;
588
- shutdown?: boolean;
589
- saveScript?: boolean | string;
590
- /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
591
- force?: boolean;
592
- };
593
- type AppCloseResult = {
594
- session: string;
595
- closedApp?: string;
596
- shutdown?: TargetShutdownResult;
597
- /**
598
- * #1258: absolute path of the committed session/healed script when this close
599
- * published one (`close --save-script`, or a repair-armed session's finalize)
600
- * — so a client that requested publication learns where the file landed.
601
- */
602
- savedScript?: string;
603
- identifiers: AgentDeviceIdentifiers;
604
- };
605
- type AppInstallFromSourceOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
606
- source: DaemonInstallSource;
607
- retainPaths?: boolean;
608
- retentionMs?: number;
500
+ //#region packages/contracts/src/gesture-input.d.ts
501
+ type DragGesturePayload = {
502
+ kind: 'drag';
503
+ source: string;
504
+ destination: string;
505
+ sourceHoldMs?: number;
506
+ moveMs?: number;
507
+ destinationHoldMs?: number;
609
508
  };
610
- type AppInstallFromSourceResult = {
611
- appName?: string;
612
- appId?: string;
613
- bundleId?: string;
614
- packageName?: string;
615
- launchTarget: string;
616
- installablePath?: string;
617
- archivePath?: string;
618
- materializationId?: string;
619
- materializationExpiresAt?: string;
620
- identifiers: AgentDeviceIdentifiers;
509
+ type PanGesturePayload = {
510
+ kind: 'pan';
511
+ origin: Point;
512
+ delta: Point;
513
+ pointerCount?: GesturePointerCount;
514
+ durationMs?: number;
621
515
  };
622
- type AppListOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
623
- appsFilter?: AppsFilter;
516
+ type FlingGesturePayload = {
517
+ kind: 'fling';
518
+ direction: ScrollDirection;
519
+ origin: Point;
520
+ distance?: number;
624
521
  };
625
- type AppPushOptions = DeviceCommandBaseOptions & {
626
- app: string;
627
- payload: string | JsonObject;
522
+ type SwipeGesturePayload = {
523
+ kind: 'swipe';
524
+ preset: SwipePreset;
628
525
  };
629
- type AppUninstallOptions = DeviceCommandBaseOptions & LeaseDeviceSpec & {
630
- app: string;
526
+ type PinchGesturePayload = {
527
+ kind: 'pinch';
528
+ scale: number;
529
+ origin?: Point;
631
530
  };
632
- type AppTriggerEventOptions = DeviceCommandBaseOptions & {
633
- event: string;
634
- payload?: JsonObject;
531
+ type RotateGesturePayload = {
532
+ kind: 'rotate';
533
+ degrees: number;
534
+ origin?: Point;
635
535
  };
636
- type MaterializationReleaseOptions = AgentDeviceRequestOverrides & {
637
- materializationId: string;
536
+ type TransformGesturePayload = {
537
+ kind: 'transform';
538
+ origin: Point;
539
+ delta: Point;
540
+ scale: number;
541
+ degrees: number;
542
+ durationMs?: number;
638
543
  };
639
- type MaterializationReleaseResult = {
640
- released: boolean;
641
- materializationId: string;
642
- identifiers: AgentDeviceIdentifiers;
544
+ type TapGesturePayload = {
545
+ kind: 'tap';
546
+ points: Point[];
547
+ holdMs?: number;
548
+ count?: number;
549
+ pauseMs?: number;
643
550
  };
551
+ type GesturePayload = PanGesturePayload | FlingGesturePayload | SwipeGesturePayload | PinchGesturePayload | RotateGesturePayload | TransformGesturePayload | TapGesturePayload | DragGesturePayload;
644
552
  //#endregion
645
553
  //#region packages/contracts/src/snapshot-capture-annotations.d.ts
646
554
  type SnapshotCaptureAnalysis = {
@@ -672,13 +580,9 @@ type PublicSnapshotCaptureAnnotations = Pick<SnapshotCaptureAnnotations, 'androi
672
580
  //#region packages/contracts/src/client-capture.d.ts
673
581
  type CaptureSnapshotOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & Omit<SnapshotCommandOptionFields, 'customActions'> & {
674
582
  /**
675
- * Name the affordances an element merged away (iOS UIAccessibilityCustomAction,
676
- * React Native accessibilityActions) — a card whose reply/options controls are not
677
- * separate elements still lists them here. The names are for PLANNING, not
678
- * invocation: there is no API to trigger them, so reach the affordance through the
679
- * element detail screen, through the same control exposed as a labeled element
680
- * elsewhere, or by coordinates from its rect. iOS simulator only; costs one
681
- * accessibility round trip per merged element.
583
+ * List the custom actions an element merged away, such as a card's reply control.
584
+ * Not invocable: reach the control via its detail screen, a labeled element elsewhere,
585
+ * or its rect. iOS simulator only; costs one accessibility round trip per merged element.
682
586
  */
683
587
  customActions?: SnapshotCommandOptionFields['customActions'];
684
588
  timeoutMs?: number;
@@ -726,6 +630,12 @@ type CaptureSnapshotResult = {
726
630
  * of the field means a non-iOS producer or an older runner published nothing.
727
631
  */
728
632
  presentedSurface?: PresentedSurface;
633
+ /**
634
+ * Present when the tree may not show the surface at rest: `unsettled` (still changing after a
635
+ * gesture), `no-effect` (a gesture changed nothing), or `loading` (the app launched by `open`
636
+ * still showed no first screen when its wait ran out).
637
+ */
638
+ postGestureOutcome?: PostGestureOutcome;
729
639
  /**
730
640
  * Screenshot captured automatically when the semantic snapshot was sparse.
731
641
  * Remote clients receive a materialized local path through the daemon artifact channel.
@@ -747,6 +657,11 @@ type CaptureSnapshotResult = {
747
657
  ref: string;
748
658
  label?: string;
749
659
  }>;
660
+ /**
661
+ * ADR 0016 (#4564): a remote recording's script version this capture recorded was not delivered.
662
+ * The capture kept its success, so the caller file may hold an older version.
663
+ */
664
+ scriptDeliveryFailure?: ScriptDeliveryFailure;
750
665
  } & PublicSnapshotCaptureAnnotations;
751
666
  type CaptureScreenshotOptions = AgentDeviceRequestOverrides & {
752
667
  path?: string;
@@ -765,6 +680,11 @@ type CaptureScreenshotOptions = AgentDeviceRequestOverrides & {
765
680
  };
766
681
  type CaptureScreenshotResult = ScreenshotResultData & {
767
682
  path: string;
683
+ /**
684
+ * ADR 0016 (#4564): a remote recording's script version this capture recorded was not delivered.
685
+ * The capture kept its success, so the caller file may hold an older version.
686
+ */
687
+ scriptDeliveryFailure?: ScriptDeliveryFailure;
768
688
  identifiers: AgentDeviceIdentifiers;
769
689
  };
770
690
  type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions, 'interactiveOnly' | 'depth' | 'scope' | 'raw'> & {
@@ -774,59 +694,6 @@ type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions
774
694
  type SelectorSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'scope' | 'raw'>;
775
695
  type FindSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'raw'>;
776
696
  //#endregion
777
- //#region packages/contracts/src/gesture-input.d.ts
778
- type DragGesturePayload = {
779
- kind: 'drag';
780
- source: string;
781
- destination: string;
782
- sourceHoldMs?: number;
783
- moveMs?: number;
784
- destinationHoldMs?: number;
785
- };
786
- type PanGesturePayload = {
787
- kind: 'pan';
788
- origin: Point;
789
- delta: Point;
790
- pointerCount?: GesturePointerCount;
791
- durationMs?: number;
792
- };
793
- type FlingGesturePayload = {
794
- kind: 'fling';
795
- direction: ScrollDirection;
796
- origin: Point;
797
- distance?: number;
798
- };
799
- type SwipeGesturePayload = {
800
- kind: 'swipe';
801
- preset: SwipePreset;
802
- };
803
- type PinchGesturePayload = {
804
- kind: 'pinch';
805
- scale: number;
806
- origin?: Point;
807
- };
808
- type RotateGesturePayload = {
809
- kind: 'rotate';
810
- degrees: number;
811
- origin?: Point;
812
- };
813
- type TransformGesturePayload = {
814
- kind: 'transform';
815
- origin: Point;
816
- delta: Point;
817
- scale: number;
818
- degrees: number;
819
- durationMs?: number;
820
- };
821
- type TapGesturePayload = {
822
- kind: 'tap';
823
- points: Point[];
824
- holdMs?: number;
825
- count?: number;
826
- pauseMs?: number;
827
- };
828
- type GesturePayload = PanGesturePayload | FlingGesturePayload | SwipeGesturePayload | PinchGesturePayload | RotateGesturePayload | TransformGesturePayload | TapGesturePayload | DragGesturePayload;
829
- //#endregion
830
697
  //#region packages/contracts/src/client-target.d.ts
831
698
  type PointTarget = {
832
699
  x: number;
@@ -874,12 +741,13 @@ type SettleCommandOptions = {
874
741
  settleQuietMs?: number;
875
742
  timeoutMs?: number;
876
743
  };
877
- /** For a caller that verifies the screen by polling it: opts out of the checks after a gesture. */
744
+ /** For a caller that verifies the screen by polling it: opts out of the checks after a gesture or an app launch. */
878
745
  type PostGestureStabilizationOptions = {
879
746
  /**
880
747
  * Set false to skip the movement check on a directional scroll and the stabilization wait
881
- * before the next read. Set it only when your own polling verifies the screen: the next read can
882
- * return a tree that the gesture is still moving.
748
+ * before the next read, or, on a local iOS simulator, the first-screen wait after an app launch.
749
+ * Set it only when your own polling verifies the screen: the next read can return a tree that the
750
+ * gesture is still moving or the launch screen.
883
751
  */
884
752
  postGestureStabilization?: boolean;
885
753
  };
@@ -970,6 +838,169 @@ type ScrollOptions = DeviceCommandBaseOptions & SettleCommandOptions & PostGestu
970
838
  maxPasses?: number;
971
839
  };
972
840
  //#endregion
841
+ //#region packages/contracts/src/client-app.d.ts
842
+ type DeviceSelectionReason = 'explicit-selector' | 'existing-session' | 'single-booted-local' | 'single-bootable-local' | 'single-app-installed-local' |
843
+ /** `boot --pick newest` chose among several equally preferred, shut-down local devices. */
844
+ 'newest-bootable-local' | 'preferred-local' | 'single-provider-device';
845
+ type DeviceSelectionSource = 'session' | 'local' | 'provider';
846
+ /** Deterministic device-selection evidence shared by daemon responses and the published client. */
847
+ type DeviceSelectionMetadata = {
848
+ reason: DeviceSelectionReason;
849
+ source: DeviceSelectionSource;
850
+ candidateCount: number;
851
+ /** Whether this request booted a previously stopped local virtual target during open. */
852
+ bootOccurred: boolean;
853
+ };
854
+ type AppInstallOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
855
+ app?: string;
856
+ appPath: string;
857
+ };
858
+ type AppDeployOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
859
+ app: string;
860
+ appPath: string;
861
+ };
862
+ type AppDeployResult = {
863
+ app: string;
864
+ appPath: string;
865
+ platform: PublicPlatform;
866
+ appId?: string;
867
+ bundleId?: string;
868
+ package?: string;
869
+ identifiers: AgentDeviceIdentifiers;
870
+ };
871
+ type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & PostGestureStabilizationOptions & {
872
+ app?: string;
873
+ url?: string;
874
+ surface?: SessionSurface;
875
+ activity?: string;
876
+ launchConsole?: string;
877
+ launchArgs?: string[];
878
+ relaunch?: boolean;
879
+ /** Startup budget in milliseconds: bounds the Simulator boot wait on a cold device. */
880
+ timeoutMs?: number;
881
+ /**
882
+ * Wait up to n milliseconds (100-120000) while another session holds the device, then fail
883
+ * with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this
884
+ * command's timeout.
885
+ */
886
+ waitMs?: number;
887
+ /**
888
+ * Include an initial interactive snapshot in a fresh open response. With no
889
+ * app argument, discover the sole running app on the sole booted iOS
890
+ * simulator; ambiguous environments fail closed.
891
+ */
892
+ foreground?: boolean;
893
+ saveScript?: boolean | string;
894
+ /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
895
+ force?: boolean;
896
+ testIme?: boolean;
897
+ noRecord?: boolean;
898
+ runtime?: SessionRuntimeHints;
899
+ };
900
+ type AppOpenResult = AppOpenResultBase & (LaunchConfirmationClientOutcome | LaunchConfirmationAbsent);
901
+ type AppOpenResultBase = {
902
+ session: string;
903
+ warnings?: string[];
904
+ /**
905
+ * ADR 0016 (#4564): a remote recording's first script version was not delivered. The open kept
906
+ * its success, so the caller file may hold no script at all, or an older one.
907
+ */
908
+ scriptDeliveryFailure?: ScriptDeliveryFailure;
909
+ sessionStateDir?: string;
910
+ runnerLogPath?: string;
911
+ requestLogPath?: string;
912
+ eventLogPath?: string;
913
+ appName?: string;
914
+ appBundleId?: string;
915
+ appId?: string;
916
+ startup?: StartupPerfSample;
917
+ runtime?: SessionRuntimeHints;
918
+ selection?: DeviceSelectionMetadata;
919
+ device?: AgentDeviceSessionDevice;
920
+ /**
921
+ * Initial interactive snapshot captured immediately after an open that
922
+ * requested `foreground`, composed from the same snapshot-runtime dispatch
923
+ * `agent-device snapshot -i` uses. It stays loosely typed rather than reusing
924
+ * `CaptureSnapshotResult` because the daemon-side composition does not attach
925
+ * client-only fields like `identifiers`.
926
+ */
927
+ snapshot?: Record<string, unknown>;
928
+ /**
929
+ * open --foreground: present when the session opened successfully but the
930
+ * composed initial snapshot capture failed. Carries the FULL daemon error
931
+ * shape (code, message, hint, details, diagnosticId, logPath) so recovery
932
+ * guidance survives to the caller; the session itself is open and usable —
933
+ * a `warnings` entry says so and points at `snapshot -i`.
934
+ */
935
+ initialSnapshotError?: DaemonError;
936
+ identifiers: AgentDeviceIdentifiers;
937
+ };
938
+ type AppCloseOptions = AgentDeviceRequestOverrides & {
939
+ app?: string;
940
+ shutdown?: boolean;
941
+ saveScript?: boolean | string;
942
+ /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
943
+ force?: boolean;
944
+ };
945
+ type AppCloseResult = {
946
+ session: string;
947
+ closedApp?: string;
948
+ shutdown?: TargetShutdownResult;
949
+ /**
950
+ * #1258: absolute path of the committed session/healed script when this close
951
+ * published one (`close --save-script`, or a repair-armed session's finalize)
952
+ * — so a client that requested publication learns where the file landed.
953
+ */
954
+ savedScript?: string;
955
+ /** ADR 0016 (#4564): the close's response warnings, kept so a lost final script is read, not skipped. */
956
+ warnings?: string[];
957
+ /**
958
+ * ADR 0016 (#4564): the final script of a remote recording was not delivered. The close kept its
959
+ * success, so this is the only channel that says the caller file still holds an older version.
960
+ */
961
+ scriptDeliveryFailure?: ScriptDeliveryFailure;
962
+ identifiers: AgentDeviceIdentifiers;
963
+ };
964
+ type AppInstallFromSourceOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
965
+ source: DaemonInstallSource;
966
+ retainPaths?: boolean;
967
+ retentionMs?: number;
968
+ };
969
+ type AppInstallFromSourceResult = {
970
+ appName?: string;
971
+ appId?: string;
972
+ bundleId?: string;
973
+ packageName?: string;
974
+ launchTarget: string;
975
+ installablePath?: string;
976
+ archivePath?: string;
977
+ materializationId?: string;
978
+ materializationExpiresAt?: string;
979
+ identifiers: AgentDeviceIdentifiers;
980
+ };
981
+ type AppListOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
982
+ appsFilter?: AppsFilter;
983
+ };
984
+ type AppPushOptions = DeviceCommandBaseOptions & {
985
+ app: string;
986
+ payload: string | JsonObject;
987
+ };
988
+ type AppUninstallOptions = DeviceCommandBaseOptions & LeaseDeviceSpec & {
989
+ app: string;
990
+ };
991
+ type AppTriggerEventOptions = DeviceCommandBaseOptions & {
992
+ event: string;
993
+ payload?: JsonObject;
994
+ };
995
+ type MaterializationReleaseOptions = AgentDeviceRequestOverrides & {
996
+ materializationId: string;
997
+ };
998
+ type MaterializationReleaseResult = {
999
+ released: boolean;
1000
+ materializationId: string;
1001
+ identifiers: AgentDeviceIdentifiers;
1002
+ };
1003
+ //#endregion
973
1004
  //#region packages/contracts/src/logs.d.ts
974
1005
  declare const LOG_ACTION_VALUES: readonly ['path', 'start', 'stop', 'doctor', 'mark', 'clear'];
975
1006
  type LogAction = (typeof LOG_ACTION_VALUES)[number];
@@ -1166,6 +1197,13 @@ type SessionCloseResult = {
1166
1197
  * — so a client that requested publication learns where the file landed.
1167
1198
  */
1168
1199
  savedScript?: string;
1200
+ /** ADR 0016 (#4564): the close's response warnings, kept so a lost final script is read, not skipped. */
1201
+ warnings?: string[];
1202
+ /**
1203
+ * ADR 0016 (#4564): the final script of a remote recording was not delivered. The close kept its
1204
+ * success, so this is the only channel that says the caller file still holds an older version.
1205
+ */
1206
+ scriptDeliveryFailure?: ScriptDeliveryFailure;
1169
1207
  identifiers: AgentDeviceIdentifiers;
1170
1208
  };
1171
1209
  type SessionSaveScriptOptions = AgentDeviceRequestOverrides & {
@@ -2076,4 +2114,4 @@ type AgentDeviceClient = {
2076
2114
  };
2077
2115
  };
2078
2116
  //#endregion
2079
- export { RecordOptions as $, EndedLease as $t, AlertAction as A, DaemonConnection as An, CaptureSnapshotOptions as At, IsStatePredicateOptions as B, AppInstallOptions as Bt, PrepareCommandOptions as C, AgentDeviceClientConfig as Cn, InteractionTarget as Ct, ViewportCommandOptions as D, AgentDeviceRequestOverrides as Dn, CaptureDiffOptions as Dt, TvRemoteCommandOptions as E, AgentDeviceIdentifiers as En, SelectorTarget as Et, SessionSaveScriptResult as F, AppCloseResult as Ft, BatchStep as G, AppTriggerEventOptions as Gt, RecordControlOptions as H, AppOpenOptions as Ht, FindBaseOptions as I, AppDeployOptions as It, AudioOptions as J, DeviceSelectionReason as Jt, ReplayRunOptions as K, AppUninstallOptions as Kt, FindOptions as L, AppDeployResult as Lt, SettingsUpdateOptions as M, DaemonLifecycle as Mn, FindSnapshotCommandOptions as Mt, SessionCloseResult as N, DeviceCommandBaseOptions as Nn, SelectorSnapshotCommandOptions as Nt, WaitCommandOptions as O, AgentDeviceSelectionOptions as On, CaptureScreenshotOptions as Ot, SessionSaveScriptOptions as P, EnsureDaemonOptions as Pn, AppCloseOptions as Pt, PerfOptions as Q, CloudArtifactsOptions as Qt, GetOptions as R, AppInstallFromSourceOptions as Rt, OrientationCommandOptions as S, isRecord as Sn, ElementTarget as St, TelephonyCommandOptions as T, AgentDeviceDaemonTransportContext as Tn, RefTarget as Tt, CommandRequestResult as U, AppOpenResult as Ut, IsTextPredicateOptions as V, AppListOptions as Vt, BatchRunOptions as W, AppPushOptions as Wt, LogsOptions as X, MaterializationReleaseOptions as Xt, EventsOptions as Y, DeviceSelectionSource as Yt, NetworkOptions as Z, MaterializationReleaseResult as Zt, DoctorCommandOptions as _, PushCommandResult as _n, SwipeGestureOptions as _t, WaitCommandResult as a, LeaseDevice as an, FocusOptions as at, HomeCommandOptions as b, JsonPrimitive as bn, TransformGestureOptions as bt, DoctorCommandResult as c, LeaseScopedOptions as cn, LongPressOptions as ct, ActionButtonCommandOptions as d, AgentDeviceSession as dn, PostGestureStabilizationOptions as dt, HumanControlHold as en, TraceOptions as et, AlertCommandOptions as f, AgentDeviceSessionDevice as fn, PressOptions as ft, ClipboardCommandOptions as g, TargetShutdownResult as gn, SettleCommandOptions as gt, BackCommandOptions as h, StartupPerfSample as hn, ScrollOptions as ht, TraceCommandResult as i, LeaseAllocateOptions as in, FlingOptions as it, PermissionTarget as j, DaemonIdentity as jn, CaptureSnapshotResult as jt, WaitCommandTarget as k, DaemonBinding as kn, CaptureScreenshotResult as kt, DebugSymbolsOptions as l, AgentDeviceCapabilitiesResult as ln, PanOptions as lt, AppSwitcherCommandOptions as m, DeviceShutdownOptions as mn, RotateGestureOptions as mt, AgentDeviceCommandClient as n, HumanControlHoldScope as nn, DragOptions as nt, TriggerAppEventCommandResult as o, LeaseDeviceSpec as on, GestureOptions as ot, AppStateCommandOptions as p, DeviceBootOptions as pn, RepeatedPressOptions as pt, ReplayTestOptions as q, DeviceSelectionMetadata as qt, RecordingCommandResult as r, Lease as rn, FillOptions as rt, DiffSnapshotCommandResult as s, LeaseOptions as sn, HoverOptions as st, AgentDeviceClient as t, HumanControlHoldOptions as tn, ClickOptions as tt, DebugSymbolsResult as u, AgentDeviceDevice as un, PinchOptions as ut, FoldCommandOptions as v, PrepareCommandResult as vn, SwipeOptions as vt, ReactNativeCommandOptions as w, AgentDeviceDaemonTransport as wn, PointTarget as wt, KeyboardCommandOptions as x, JsonValue as xn, TypeTextOptions as xt, HardwareButtonCommandOptions as y, JsonObject as yn, TapGestureOptions as yt, IsOptions as z, AppInstallFromSourceResult as zt };
2117
+ export { RecordOptions as $, EndedLease as $t, AlertAction as A, DaemonConnection as An, PressOptions as At, IsStatePredicateOptions as B, ElementTarget as Bt, PrepareCommandOptions as C, AgentDeviceClientConfig as Cn, FocusOptions as Ct, ViewportCommandOptions as D, AgentDeviceRequestOverrides as Dn, PanOptions as Dt, TvRemoteCommandOptions as E, AgentDeviceIdentifiers as En, LongPressOptions as Et, SessionSaveScriptResult as F, SwipeGestureOptions as Ft, BatchStep as G, CaptureDiffOptions as Gt, RecordControlOptions as H, PointTarget as Ht, FindBaseOptions as I, SwipeOptions as It, AudioOptions as J, CaptureSnapshotOptions as Jt, ReplayRunOptions as K, CaptureScreenshotOptions as Kt, FindOptions as L, TapGestureOptions as Lt, SettingsUpdateOptions as M, DaemonLifecycle as Mn, RotateGestureOptions as Mt, SessionCloseResult as N, DeviceCommandBaseOptions as Nn, ScrollOptions as Nt, WaitCommandOptions as O, AgentDeviceSelectionOptions as On, PinchOptions as Ot, SessionSaveScriptOptions as P, EnsureDaemonOptions as Pn, SettleCommandOptions as Pt, PerfOptions as Q, CloudArtifactsOptions as Qt, GetOptions as R, TransformGestureOptions as Rt, OrientationCommandOptions as S, isRecord as Sn, FlingOptions as St, TelephonyCommandOptions as T, AgentDeviceDaemonTransportContext as Tn, HoverOptions as Tt, CommandRequestResult as U, RefTarget as Ut, IsTextPredicateOptions as V, InteractionTarget as Vt, BatchRunOptions as W, SelectorTarget as Wt, LogsOptions as X, FindSnapshotCommandOptions as Xt, EventsOptions as Y, CaptureSnapshotResult as Yt, NetworkOptions as Z, SelectorSnapshotCommandOptions as Zt, DoctorCommandOptions as _, PushCommandResult as _n, MaterializationReleaseOptions as _t, WaitCommandResult as a, LeaseDevice as an, AppInstallFromSourceOptions as at, HomeCommandOptions as b, JsonPrimitive as bn, DragOptions as bt, DoctorCommandResult as c, LeaseScopedOptions as cn, AppListOptions as ct, ActionButtonCommandOptions as d, AgentDeviceSession as dn, AppPushOptions as dt, HumanControlHold as en, TraceOptions as et, AlertCommandOptions as f, AgentDeviceSessionDevice as fn, AppTriggerEventOptions as ft, ClipboardCommandOptions as g, TargetShutdownResult as gn, DeviceSelectionSource as gt, BackCommandOptions as h, StartupPerfSample as hn, DeviceSelectionReason as ht, TraceCommandResult as i, LeaseAllocateOptions as in, AppDeployResult as it, PermissionTarget as j, DaemonIdentity as jn, RepeatedPressOptions as jt, WaitCommandTarget as k, DaemonBinding as kn, PostGestureStabilizationOptions as kt, DebugSymbolsOptions as l, AgentDeviceCapabilitiesResult as ln, AppOpenOptions as lt, AppSwitcherCommandOptions as m, DeviceShutdownOptions as mn, DeviceSelectionMetadata as mt, AgentDeviceCommandClient as n, HumanControlHoldScope as nn, AppCloseResult as nt, TriggerAppEventCommandResult as o, LeaseDeviceSpec as on, AppInstallFromSourceResult as ot, AppStateCommandOptions as p, DeviceBootOptions as pn, AppUninstallOptions as pt, ReplayTestOptions as q, CaptureScreenshotResult as qt, RecordingCommandResult as r, Lease as rn, AppDeployOptions as rt, DiffSnapshotCommandResult as s, LeaseOptions as sn, AppInstallOptions as st, AgentDeviceClient as t, HumanControlHoldOptions as tn, AppCloseOptions as tt, DebugSymbolsResult as u, AgentDeviceDevice as un, AppOpenResult as ut, FoldCommandOptions as v, PrepareCommandResult as vn, MaterializationReleaseResult as vt, ReactNativeCommandOptions as w, AgentDeviceDaemonTransport as wn, GestureOptions as wt, KeyboardCommandOptions as x, JsonValue as xn, FillOptions as xt, HardwareButtonCommandOptions as y, JsonObject as yn, ClickOptions as yt, IsOptions as z, TypeTextOptions as zt };
@@ -1 +1 @@
1
- import{P as e}from"./sdk-contracts.js";import{n as t,r as n}from"./adb.js";const r=`This Android build ships no shell implementation for the clipboard service, so adb cannot read or write the clipboard on it. Verify a copy flow by pasting into a focused field and reading that field back.`;function i(e){return n(e.stderr)?`no-shell-command`:e.exitCode===0?`executed`:t(e.stdout,e.stderr)?`no-shell-command`:`call-failed`}function a(e){return e===`executed`?`supported`:e===`no-shell-command`?`unsupported`:`probe-failed`}function o(e){return a(i(e))}function s(t){return new e(`UNSUPPORTED_OPERATION`,`Android shell clipboard ${t} is not supported on this device.`,{reason:`android_clipboard_shell_command_unavailable`,hint:r})}export{r as ANDROID_CLIPBOARD_SHELL_COMMAND_UNAVAILABLE_HINT,s as androidClipboardShellCommandUnavailableError,o as androidClipboardShellSupportForResult,i as classifyAndroidClipboardShellResponse};
1
+ import{_ as e}from"./sdk-contracts.js";import{n as t,r as n}from"./adb.js";const r=`This Android build ships no shell implementation for the clipboard service, so adb cannot read or write the clipboard on it. Verify a copy flow by pasting into a focused field and reading that field back.`;function i(e){return n(e.stderr)?`no-shell-command`:e.exitCode===0?`executed`:t(e.stdout,e.stderr)?`no-shell-command`:`call-failed`}function a(e){return e===`executed`?`supported`:e===`no-shell-command`?`unsupported`:`probe-failed`}function o(e){return a(i(e))}function s(t){return new e(`UNSUPPORTED_OPERATION`,`Android shell clipboard ${t} is not supported on this device.`,{reason:`android_clipboard_shell_command_unavailable`,hint:r})}export{r as ANDROID_CLIPBOARD_SHELL_COMMAND_UNAVAILABLE_HINT,s as androidClipboardShellCommandUnavailableError,o as androidClipboardShellSupportForResult,i as classifyAndroidClipboardShellResponse};
@@ -1,5 +1,5 @@
1
- import { E as PublicPlatform, F as ScreenshotOverlayRef, G as SnapshotViewportSize, H as SnapshotQualityNote, P as Rect, R as SnapshotNode, U as SnapshotQualityVerdict, k as IosSnapshotObservation, n as DaemonArtifactType } from "./sdk-contracts.js";
2
- import { b as SnapshotState, v as SettleObservation } from "./sdk-selectors.js";
1
+ import { A as IosSnapshotObservation, D as PublicPlatform, F as Rect, I as ScreenshotOverlayRef, K as SnapshotViewportSize, U as SnapshotQualityNote, W as SnapshotQualityVerdict, n as DaemonArtifactType, z as SnapshotNode } from "./sdk-contracts.js";
2
+ import { v as SettleObservation, x as SnapshotState } from "./sdk-selectors.js";
3
3
  //#region packages/contracts/src/session-surface.d.ts
4
4
  declare const SESSION_SURFACES: readonly ['app', 'frontmost-app', 'desktop', 'menubar'];
5
5
  type SessionSurface = (typeof SESSION_SURFACES)[number];
@@ -549,6 +549,11 @@ type AndroidSnapshotBackendMetadata = {
549
549
  cacheInvalidated?: boolean;
550
550
  captureMode?: string;
551
551
  systemSurfaceOnly?: boolean;
552
+ /**
553
+ * Package of the foreground application window the snapshot helper captured: active or focused,
554
+ * at the highest layer, and not owned by the system. Absent when the helper saw none.
555
+ */
556
+ foregroundWindowPackage?: string;
552
557
  windowCount?: number;
553
558
  /**
554
559
  * `AccessibilityWindowInfo` types of the listed windows the helper could not serialize because
@@ -1 +1 @@
1
- import{pt as e}from"./sdk-io.js";import"./file.js";import{a as t,r as n,s as r,t as i}from"./code-signature.js";import a from"node:crypto";import o from"node:fs";import s from"node:os";import c from"node:path";function l(e,a){let o=t(a),s=t(e),c=v(s,o),l=i(o,s),d=u(c,o,l);if(d)return n(d.files);let p;try{p=r(s,o)}catch{return`unknown`}return f(p.files,l)&&_(c,p),n(p.files)}function u(e,t,n){let r=p(e);if(!(!r||!f(r.files,n))){for(let[e,n,i]of r.files){let r=d(c.resolve(t,e));if(!r?.isFile()||r.size!==n||Math.trunc(r.mtimeMs)!==i)return}for(let e of r.absentPaths)if(d(c.resolve(t,e))?.isFile())return;return r}}function d(e){try{return o.statSync(e)}catch{return}}function f(e,t){return e.some(([e])=>e===t)}function p(e){let t=m(e);if(!t)return;let n=[];for(let e of t.files){let t=g(e);if(!t)return;n.push(t)}if(t.absent.every(e=>typeof e==`string`))return{files:n,absentPaths:t.absent}}function m(e){let t=h(e);if(t===void 0)return;let n;try{n=JSON.parse(t)}catch{return}if(!n||typeof n!=`object`)return;let r=n;if(r.version===2&&!(!Array.isArray(r.files)||!Array.isArray(r.absent)))return{files:r.files,absent:r.absent}}function h(e){let t;try{t=o.openSync(e,`r`)}catch{return}try{let e=process.getuid?.();return e!==void 0&&o.fstatSync(t).uid!==e?void 0:o.readFileSync(t,`utf8`)}catch{return}finally{o.closeSync(t)}}function g(e){if(!Array.isArray(e)||e.length!==3)return;let[t,n,r]=e;if(typeof t==`string`&&typeof n==`number`&&typeof r==`number`)return[t,n,r]}function _(t,n){let r={version:2,files:[...n.files],absent:[...n.absentPaths]};try{o.mkdirSync(c.dirname(t),{recursive:!0,mode:448}),e({destination:t,contents:JSON.stringify(r),mode:384})}catch{}}function v(e,t){let n=a.createHash(`sha1`).update(`${t} ${e}`).digest(`hex`),r=`agent-device-code-signature-${process.getuid?.()??`user`}`;return c.join(s.tmpdir(),r,`${n}.json`)}export{l as resolveCachedDaemonCodeSignature};
1
+ import{gt as e}from"./sdk-io.js";import"./file.js";import{a as t,r as n,s as r,t as i}from"./code-signature.js";import a from"node:crypto";import o from"node:fs";import s from"node:os";import c from"node:path";function l(e,a){let o=t(a),s=t(e),c=v(s,o),l=i(o,s),d=u(c,o,l);if(d)return n(d.files);let p;try{p=r(s,o)}catch{return`unknown`}return f(p.files,l)&&_(c,p),n(p.files)}function u(e,t,n){let r=p(e);if(!(!r||!f(r.files,n))){for(let[e,n,i]of r.files){let r=d(c.resolve(t,e));if(!r?.isFile()||r.size!==n||Math.trunc(r.mtimeMs)!==i)return}for(let e of r.absentPaths)if(d(c.resolve(t,e))?.isFile())return;return r}}function d(e){try{return o.statSync(e)}catch{return}}function f(e,t){return e.some(([e])=>e===t)}function p(e){let t=m(e);if(!t)return;let n=[];for(let e of t.files){let t=g(e);if(!t)return;n.push(t)}if(t.absent.every(e=>typeof e==`string`))return{files:n,absentPaths:t.absent}}function m(e){let t=h(e);if(t===void 0)return;let n;try{n=JSON.parse(t)}catch{return}if(!n||typeof n!=`object`)return;let r=n;if(r.version===2&&!(!Array.isArray(r.files)||!Array.isArray(r.absent)))return{files:r.files,absent:r.absent}}function h(e){let t;try{t=o.openSync(e,`r`)}catch{return}try{let e=process.getuid?.();return e!==void 0&&o.fstatSync(t).uid!==e?void 0:o.readFileSync(t,`utf8`)}catch{return}finally{o.closeSync(t)}}function g(e){if(!Array.isArray(e)||e.length!==3)return;let[t,n,r]=e;if(typeof t==`string`&&typeof n==`number`&&typeof r==`number`)return[t,n,r]}function _(t,n){let r={version:2,files:[...n.files],absent:[...n.absentPaths]};try{o.mkdirSync(c.dirname(t),{recursive:!0,mode:448}),e({destination:t,contents:JSON.stringify(r),mode:384})}catch{}}function v(e,t){let n=a.createHash(`sha1`).update(`${t} ${e}`).digest(`hex`),r=`agent-device-code-signature-${process.getuid?.()??`user`}`;return c.join(s.tmpdir(),r,`${n}.json`)}export{l as resolveCachedDaemonCodeSignature};
@@ -1,17 +1,19 @@
1
- import{P as e}from"./sdk-contracts.js";import{D as t,O as n,l as r,o as i,w as a}from"./src3.js";const o={plugins:{text:{summary:`Manage installed provider plugins`,description:`Install, list, update, or remove npm provider plugins in AGENT_DEVICE_HOME (default ~/.agent-device). Changes take effect after restarting the local daemon. list works offline and, when a daemon is running for --state-dir, also reports the providers it registered. Use --json for structured results.`},usageOverride:`plugins list [--state-dir <path>]|add <package[@version]>|update <package>|remove <package>`,listUsageOverride:`plugins`,positionalArgs:[`list|add|update|remove`,`package?`],flagsByAction:{list:[`stateDir`],add:[],update:[],remove:[]},supportedFlags:[`stateDir`]},cdp:{text:{summary:`Inspect CDP targets, JS heap, and leaks`,description:`Run CDP commands for React Native diagnostics, JS heap usage, heap snapshots, and leak analysis`},usageOverride:`cdp [...args]`,listUsageOverride:`cdp`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},auth:{text:{summary:`Manage cloud login state`,description:`Manage cloud login state used by remote daemon and cloud device workflows.`},usageOverride:`auth status|login|logout`,listUsageOverride:`auth`,positionalArgs:[`status|login|logout`],supportedFlags:[`remoteConfig`,`stateDir`]},daemon:{text:{summary:`Stop a local daemon or show the providers it registered`,description:`stop stops a local daemon after verifying its PID/start-time identity. Use --clean to remove retained Apple runner processes and leases owned by that daemon. status reads the daemon record without contacting the daemon and lists every provider plugin it registered, built in or installed, with the reason any plugin failed to register. Use --json for structured results.`},usageOverride:`daemon stop [--clean] [--state-dir <path>] | daemon status [--state-dir <path>]`,usageFlags:[],listUsageOverride:`daemon stop|status`,positionalArgs:[`stop|status`],allowedFlags:[`clean`],flagsByAction:{stop:[`clean`],status:[]},supportedFlags:[`stateDir`]},device:{text:{summary:`Inspect and recover enforced local device ownership without a daemon`,description:`Inspect enforced host-local device ownership claims without starting or contacting a daemon; status --stale only inspects proven-stale claims. release --stale settles a provably dead owner through exact-owner resource reconciliation and clears its claim last — live and uncertain owners always fail closed. Automatic reclamation still occurs during open and daemon startup.`},usageOverride:`device status|release [--platform <platform>] [--udid <udid>] [--serial <serial>]`,listUsageOverride:`device status`,positionalArgs:[`status|release`],allowedFlags:[`stale`],supportedFlags:[`platform`,`device`,`udid`,`serial`],explicitOnlyFlags:[`platform`,`device`,`udid`,`serial`]},connect:{text:{summary:`Configure remote or provider state`,description:`Configure remote access without allocating a device. Direct providers validate credentials/resources before saving state and print the exact device/app preparation needed before open. AGENT_DEVICE_CLOUD_BASE_URL is the bridge/control-plane API origin; use AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_... for CI/service-token automation.`},usageOverride:`connect [provider] [--remote-config <path>] [--daemon-base-url <url>] [--tenant <id>] [--run-id <id>] [--lease-id <id>] [--lease-backend <backend>] [--force] [--no-login]`,usageFlags:[],listUsageOverride:`connect`,positionalArgs:[`provider?`],allowedFlags:[`remoteConfig`,`daemonBaseUrl`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`providerApp`,`providerOsVersion`,`providerDeviceType`,`providerProject`,`providerBuild`,`providerSessionName`,`providerDeviceOrientation`,`providerGeoLocation`,`providerTimezone`,`providerAppiumVersion`,`providerLanguage`,`providerLocale`,`providerNetworkProfile`,`providerCustomNetwork`,`providerNoResignApp`,`providerNetworkLogs`,`providerNetworkHosts`,`awsProjectArn`,`awsDeviceArn`,`awsAppArn`,`awsRegion`,`awsInteractionMode`,...t,`force`,`noLogin`],supportedFlags:[`stateDir`,`daemonAuthToken`,`session`,`platform`,`device`,...n,`launchUrl`]},connection:{text:{summary:`Inspect the saved remote connection`,description:`Inspect active remote connection state`},usageOverride:`connection status`,listUsageOverride:`connection`,positionalArgs:[`status`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},disconnect:{text:{summary:`Clear remote connection state and release leases`,description:`Disconnect remote daemon state, stop owned Metro companion, and release lease`},listUsageOverride:`disconnect`,allowedFlags:[`shutdown`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},mcp:{text:{summary:`Start MCP server`,description:`Start the official stdio MCP server. It exposes command tools backed by the agent-device client. Tool results are compact text by default; mcpOutputFormat: "json", a non-default responseLevel, or includeCost returns JSON text. With --structured, tools also advertise output schemas and return structuredContent, including errors, for clients that read results as data. It accepts no other flags or arguments besides --structured, --help, and --version; configure it with AGENT_DEVICE_* environment variables or AGENT_DEVICE_CONFIG.`},allowedFlags:[`mcpStructured`]},proxy:{text:{summary:`Expose a local daemon through an HTTP tunnel`,description:`Expose the local daemon HTTP contract through a tunnel-friendly reverse proxy.
1
+ import{_ as e}from"./sdk-contracts.js";import{D as t,O as n,l as r,o as i,w as a}from"./src3.js";const o={plugins:{text:{summary:`Manage installed provider plugins`,description:`Install, list, update, or remove npm provider plugins in AGENT_DEVICE_HOME (default ~/.agent-device). Changes take effect after restarting the local daemon. list works offline and, when a daemon is running for --state-dir, also reports the providers it registered. Use --json for structured results.`},usageOverride:`plugins list [--state-dir <path>]|add <package[@version]>|update <package>|remove <package>`,listUsageOverride:`plugins`,positionalArgs:[`list|add|update|remove`,`package?`],flagsByAction:{list:[`stateDir`],add:[],update:[],remove:[]},supportedFlags:[`stateDir`]},cdp:{text:{summary:`Inspect CDP targets, JS heap, and leaks`,description:`Run CDP commands for React Native diagnostics, JS heap usage, heap snapshots, and leak analysis`},usageOverride:`cdp [...args]`,listUsageOverride:`cdp`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},auth:{text:{summary:`Manage cloud login state`,description:`Manage cloud login state used by remote daemon and cloud device workflows.`},usageOverride:`auth status|login|logout`,listUsageOverride:`auth`,positionalArgs:[`status|login|logout`],supportedFlags:[`remoteConfig`,`stateDir`]},daemon:{text:{summary:`Stop a local daemon or show the providers it registered`,description:`stop stops a local daemon after verifying its PID/start-time identity. Use --clean to remove retained Apple runner processes and leases owned by that daemon. status reads the daemon record without contacting the daemon and lists every provider plugin it registered, built in or installed, with the reason any plugin failed to register. Use --json for structured results.`},usageOverride:`daemon stop [--clean] [--state-dir <path>] | daemon status [--state-dir <path>]`,usageFlags:[],listUsageOverride:`daemon stop|status`,positionalArgs:[`stop|status`],allowedFlags:[`clean`],flagsByAction:{stop:[`clean`],status:[]},supportedFlags:[`stateDir`]},device:{text:{summary:`Inspect and recover enforced local device ownership without a daemon`,description:`Inspect enforced host-local device ownership claims without starting or contacting a daemon; status --stale only inspects proven-stale claims. release --stale settles a provably dead owner through exact-owner resource reconciliation and clears its claim last — live and uncertain owners always fail closed. Automatic reclamation still occurs during open and daemon startup.`},usageOverride:`device status|release [--platform <platform>] [--udid <udid>] [--serial <serial>]`,listUsageOverride:`device status`,positionalArgs:[`status|release`],allowedFlags:[`stale`],supportedFlags:[`platform`,`device`,`udid`,`serial`],explicitOnlyFlags:[`platform`,`device`,`udid`,`serial`]},connect:{text:{summary:`Configure remote or provider state`,description:`Configure remote access without allocating a device. Direct providers validate credentials/resources before saving state and print the exact device/app preparation needed before open. AGENT_DEVICE_CLOUD_BASE_URL is the bridge/control-plane API origin; use AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_... for CI/service-token automation.`},usageOverride:`connect [provider] [--remote-config <path>] [--daemon-base-url <url>] [--tenant <id>] [--run-id <id>] [--lease-id <id>] [--lease-backend <backend>] [--force] [--no-login]`,usageFlags:[],listUsageOverride:`connect`,positionalArgs:[`provider?`],allowedFlags:[`remoteConfig`,`daemonBaseUrl`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`providerApp`,`providerOsVersion`,`providerDeviceType`,`providerProject`,`providerBuild`,`providerSessionName`,`providerDeviceOrientation`,`providerGeoLocation`,`providerTimezone`,`providerAppiumVersion`,`providerLanguage`,`providerLocale`,`providerNetworkProfile`,`providerCustomNetwork`,`providerNoResignApp`,`providerNetworkLogs`,`providerNetworkHosts`,`awsProjectArn`,`awsDeviceArn`,`awsAppArn`,`awsRegion`,`awsInteractionMode`,...t,`force`,`noLogin`],supportedFlags:[`stateDir`,`daemonAuthToken`,`session`,`platform`,`device`,...n,`launchUrl`]},connection:{text:{summary:`Inspect the saved remote connection`,description:`Inspect active remote connection state`},usageOverride:`connection status`,listUsageOverride:`connection`,positionalArgs:[`status`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},disconnect:{text:{summary:`Clear remote connection state and release leases`,description:`Disconnect remote daemon state, stop owned Metro companion, and release lease`},listUsageOverride:`disconnect`,allowedFlags:[`shutdown`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},mcp:{text:{summary:`Start MCP server`,description:`Start the official stdio MCP server. It exposes command tools backed by the agent-device client. Tool results are compact text by default; a non-default AGENT_DEVICE_RESPONSE_LEVEL or AGENT_DEVICE_COST returns JSON text. With --structured, tools also advertise output schemas and return structuredContent, including errors, for clients that read results as data. It accepts no other flags or arguments besides --structured, --help, and --version; configure it with AGENT_DEVICE_* environment variables or AGENT_DEVICE_CONFIG.`},allowedFlags:[`mcpStructured`]},proxy:{text:{summary:`Expose a local daemon through an HTTP tunnel`,description:`Expose the local daemon HTTP contract through a tunnel-friendly reverse proxy.
2
2
 
3
3
  Run this on the host that has access to simulators/devices, expose the printed local proxy URL through a tunnel, then point another machine at the tunnel URL with connect proxy.
4
4
 
5
5
  The proxy starts or reuses a local HTTP daemon, accepts /health, /rpc, /upload and resumable /upload/* routes, and /artifacts plus /artifacts/*, and also accepts the same routes under /agent-device/*. Health is unauthenticated for reachability probes. Other routes require the generated bearer token printed at startup, or the explicit --daemon-auth-token value when provided. The proxy rewrites authorized client requests to the upstream daemon token instead of exposing the local daemon token.
6
6
 
7
+ For a TLS-terminated tunnel, set --public-origin to the public HTTP(S) origin, for example --public-origin https://public.example:8443. Forwarded and X-Forwarded-* headers do not select upload ticket origins. For an ephemeral tunnel, obtain its public name first, then configure and restart the proxy. Without a fixed origin, Node uses the actual socket scheme and validated Host.
8
+
7
9
  Use the /agent-device base path when connecting through cloudflared, ngrok, or another shared origin. Treat the bearer token as a secret; anyone with it can control the proxied daemon. This direct proxy flow does not use agent-device auth.
8
10
 
9
- Remote captures write generated artifacts on the daemon. Screenshot, recording, performance, and trace paths select downloads on the client; they never select host files. Direct RPC callers download returned artifact IDs through /artifacts/<id>. Remote requests ignore client cwd and refuse host tooling paths, --launch-console, and script publication.
11
+ Remote captures write generated artifacts on the daemon. Screenshot, recording, performance, and trace paths select downloads on the client; they never select host files. Direct RPC callers download returned artifact IDs through /artifacts/<id>. Remote requests ignore client cwd and refuse host tooling paths and --launch-console. A fresh open --save-script=<path> arms recording; after each recorded action the client refreshes that caller file, and close writes the final script there. Remote session save-script, close/replay --save-script, and --save-script in batch steps remain refused.
10
12
 
11
13
  Examples:
12
- agent-device proxy --port 4310
13
14
  cloudflared tunnel --url http://127.0.0.1:4310
14
- agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>`},listUsageOverride:`proxy`,allowedFlags:[`proxyHost`,`proxyPort`,`daemonAuthToken`,`stateDir`]},takeover:{text:{summary:`Pause agent interactions while a person controls a device`,description:`Temporarily hand control of the active remote lease device to a person. The foreground command pauses state-changing agent commands, renews the hold until Ctrl+C, and then releases it. Read-only diagnostics remain available. Uses the active connection and --session, with normal tenant and lease admission. status lists holds on that device; release removes a hold owned by the admitted lease. The host-only /admin/human-control/holds API uses the separate local daemon token. Holds do not survive daemon restart. Local takeover without a remote device lease is not supported.`},usageOverride:`takeover [status | release <hold-id>] [--session <name>]`,listUsageOverride:`takeover [status|release]`,positionalArgs:[`status|release?`,`hold-id?`],supportedFlags:[`stateDir`,`session`,`remoteConfig`,`daemonBaseUrl`,`daemonAuthToken`,`daemonTransport`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`sessionIsolation`]},"react-devtools":{text:{summary:`React Native components, props/state/hooks, and render profiling`,description:`Inspect React Native components and profile their renders through the Metro dev server`},usageOverride:`react-devtools tree [@ref|Name]|find <Name>|inspect <@ref|Name>|errors|profile start|stop|report [Component]|commit [N]`,listUsageOverride:`react-devtools`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},web:{text:{summary:`Manage web automation backend`,description:`Install and inspect the managed web automation backend used by --platform web.
15
+ agent-device proxy --port 4310 --public-origin https://example.trycloudflare.com
16
+ agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>`},listUsageOverride:`proxy`,allowedFlags:[`proxyHost`,`proxyPort`,`publicOrigin`,`daemonAuthToken`,`stateDir`]},takeover:{text:{summary:`Pause agent interactions while a person controls a device`,description:`Temporarily hand control of the active remote lease device to a person. The foreground command pauses state-changing agent commands, renews the hold until Ctrl+C, and then releases it. Read-only diagnostics remain available. Uses the active connection and --session, with normal tenant and lease admission. status lists holds on that device; release removes a hold owned by the admitted lease. The host-only /admin/human-control/holds API uses the separate local daemon token. Holds do not survive daemon restart. Local takeover without a remote device lease is not supported.`},usageOverride:`takeover [status | release <hold-id>] [--session <name>]`,listUsageOverride:`takeover [status|release]`,positionalArgs:[`status|release?`,`hold-id?`],supportedFlags:[`stateDir`,`session`,`remoteConfig`,`daemonBaseUrl`,`daemonAuthToken`,`daemonTransport`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`sessionIsolation`]},"react-devtools":{text:{summary:`React Native components, props/state/hooks, and render profiling`,description:`Inspect React Native components and profile their renders through the Metro dev server`},usageOverride:`react-devtools tree [@ref|Name]|find <Name>|inspect <@ref|Name>|errors|profile start|stop|report [Component]|commit [N]`,listUsageOverride:`react-devtools`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},web:{text:{summary:`Manage web automation backend`,description:`Install and inspect the managed web automation backend used by --platform web.
15
17
 
16
18
  First-run flow:
17
19
  agent-device web setup