agent-device 0.21.30 → 0.21.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (304) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.apk → agent-device-android-ime-helper-0.21.31.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.31.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.manifest.json → agent-device-android-ime-helper-0.21.31.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.30.manifest.json → agent-device-android-snapshot-helper-0.21.31.manifest.json} +7 -7
  7. package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/BackgroundInteraction.swift +20 -6
  8. package/apple/snapshot-bridge/README.md +16 -3
  9. package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +33 -1
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner/AgentDeviceRunnerApp.m +110 -8
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAppScreenCapture.swift +20 -0
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +4 -4
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +1 -1
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +30 -4
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +14 -4
  16. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +81 -41
  17. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift +40 -6
  18. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotAcquisition.swift +5 -0
  19. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift +74 -10
  20. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotTiming.swift +33 -4
  21. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedCommitDeadline.swift +2 -2
  22. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +23 -2
  23. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +158 -6
  24. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift +165 -70
  25. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryConfirmation.swift +2 -3
  26. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryFocus.swift +49 -27
  27. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryReadiness.swift +17 -9
  28. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextInputProbe.swift +30 -28
  29. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextTyping.swift +87 -87
  30. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +4 -3
  31. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +13 -0
  32. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +45 -0
  33. package/dist/src/absence-observation-errors.js +1 -1
  34. package/dist/src/adapter.js +1 -1
  35. package/dist/src/adb-executor.js +1 -1
  36. package/dist/src/adb-failure.js +2 -2
  37. package/dist/src/agent-browser-lifecycle.js +1 -1
  38. package/dist/src/agent-browser-process-record.js +1 -1
  39. package/dist/src/agent-browser-provider.js +1 -1
  40. package/dist/src/agent-browser-tool.js +1 -1
  41. package/dist/src/agent-device-client.js +1 -1
  42. package/dist/src/alert-tree-driver.js +1 -1
  43. package/dist/src/alert.js +1 -1
  44. package/dist/src/alert2.js +1 -1
  45. package/dist/src/android.js +1 -1
  46. package/dist/src/app-backend.js +1 -1
  47. package/dist/src/app-launch.js +1 -1
  48. package/dist/src/app-lifecycle.js +4 -4
  49. package/dist/src/app-log-runtime2.js +3 -3
  50. package/dist/src/app-log-session-resource.js +1 -1
  51. package/dist/src/app-resolution-facade.js +1 -1
  52. package/dist/src/app-resolution.js +2 -2
  53. package/dist/src/apple-runner-platform.js +1 -1
  54. package/dist/src/application-lifecycle-interaction.js +1 -1
  55. package/dist/src/artifact-tracking.js +1 -1
  56. package/dist/src/automation-helper-artifact.js +1 -1
  57. package/dist/src/automation-helper.js +1 -1
  58. package/dist/src/back-mode.js +1 -1
  59. package/dist/src/boot-diagnostics.js +1 -1
  60. package/dist/src/browser-launch.js +1 -1
  61. package/dist/src/cli-config.js +1 -1
  62. package/dist/src/cli-help.js +35 -29
  63. package/dist/src/cli-runner.js +1 -1
  64. package/dist/src/cli.js +3 -3
  65. package/dist/src/client-metro-companion.js +1 -1
  66. package/dist/src/client-metro.js +1 -1
  67. package/dist/src/client-types.d.ts +3 -3
  68. package/dist/src/cloud-artifacts.d.ts +5 -4
  69. package/dist/src/code-signature-cache.js +1 -1
  70. package/dist/src/command-metadata.js +10 -10
  71. package/dist/src/command-tools.js +2 -2
  72. package/dist/src/command.js +1 -1
  73. package/dist/src/composed-inventory-gateways.js +1 -1
  74. package/dist/src/connection-runtime.js +1 -1
  75. package/dist/src/connection.js +5 -5
  76. package/dist/src/contracts.js +1 -1
  77. package/dist/src/daemon-client-ensure.js +1 -1
  78. package/dist/src/daemon-client-lease-beat.js +1 -1
  79. package/dist/src/daemon-client-lifecycle.js +1 -1
  80. package/dist/src/daemon-client-liveness-probe.js +1 -1
  81. package/dist/src/daemon-client.js +1 -1
  82. package/dist/src/daemon-command-registry.js +1 -1
  83. package/dist/src/daemon-composition.js +1 -1
  84. package/dist/src/daemon-policy-file.js +1 -1
  85. package/dist/src/daemon-registration-owner.js +3 -3
  86. package/dist/src/daemon-resolution.js +1 -1
  87. package/dist/src/daemon-startup-diagnostics.js +1 -1
  88. package/dist/src/debug-symbols-facade.js +3 -3
  89. package/dist/src/device-claim-recovery.js +1 -1
  90. package/dist/src/device-claims.js +1 -1
  91. package/dist/src/device-inventory-context.js +1 -1
  92. package/dist/src/device-readiness-runtime.js +1 -1
  93. package/dist/src/device-selection-resolver.js +1 -1
  94. package/dist/src/device.js +1 -1
  95. package/dist/src/devicectl.js +1 -1
  96. package/dist/src/diagnostics.js +1 -1
  97. package/dist/src/display-inventory.js +1 -1
  98. package/dist/src/doctor-facade.js +1 -1
  99. package/dist/src/durable-capture-resource.js +1 -1
  100. package/dist/src/durable-resource.js +1 -1
  101. package/dist/src/engine-eval-script.js +1 -1
  102. package/dist/src/error.js +1 -1
  103. package/dist/src/explicit-session-resolution.js +1 -1
  104. package/dist/src/expo-dev-client-launch.js +1 -1
  105. package/dist/src/file.js +1 -1
  106. package/dist/src/find.js +1 -1
  107. package/dist/src/finders.js +1 -1
  108. package/dist/src/gesture-admission.js +1 -1
  109. package/dist/src/gesture-plan.js +1 -1
  110. package/dist/src/gesture-runtime.js +1 -1
  111. package/dist/src/hdc.js +1 -1
  112. package/dist/src/helper.js +2 -2
  113. package/dist/src/host.js +1 -1
  114. package/dist/src/host2.js +1 -1
  115. package/dist/src/host3.js +1 -1
  116. package/dist/src/host4.js +1 -1
  117. package/dist/src/host5.js +1 -0
  118. package/dist/src/human-control.js +1 -1
  119. package/dist/src/ime-rebind.js +1 -1
  120. package/dist/src/ime-state.js +1 -1
  121. package/dist/src/index.js +1 -1
  122. package/dist/src/input-actions.js +1 -1
  123. package/dist/src/input-actions2.js +1 -1
  124. package/dist/src/install-source-network-transport.js +1 -1
  125. package/dist/src/install-source2.js +1 -1
  126. package/dist/src/interaction-positionals.js +1 -1
  127. package/dist/src/interaction.js +1 -1
  128. package/dist/src/interaction2.js +1 -1
  129. package/dist/src/interactor-operation-catalog.js +1 -1
  130. package/dist/src/interactor.js +5 -5
  131. package/dist/src/interactor2.js +1 -1
  132. package/dist/src/interactor3.js +1 -1
  133. package/dist/src/interactor4.js +1 -1
  134. package/dist/src/interactor5.js +1 -1
  135. package/dist/src/interactors.js +1 -1
  136. package/dist/src/internal/bin.js +1 -1
  137. package/dist/src/internal/daemon.js +1 -1
  138. package/dist/src/internal/png-worker.js +1 -1
  139. package/dist/src/inventory.js +1 -1
  140. package/dist/src/inventory2.js +1 -1
  141. package/dist/src/inventory6.js +1 -1
  142. package/dist/src/ios-node-interpretation.js +1 -1
  143. package/dist/src/ios-settings.js +1 -1
  144. package/dist/src/ios-snapshot-acquisition.js +1 -1
  145. package/dist/src/ios-snapshot-engine.js +1 -1
  146. package/dist/src/ios-snapshot-runtime.js +1 -1
  147. package/dist/src/keyboard-occlusion.js +1 -1
  148. package/dist/src/keyed-lock.js +1 -1
  149. package/dist/src/launch-confirmation.js +1 -1
  150. package/dist/src/launch-services-registration.js +4 -4
  151. package/dist/src/lease.js +1 -1
  152. package/dist/src/legacy.js +1 -1
  153. package/dist/src/limrun-runtime-dependencies.js +1 -1
  154. package/dist/src/local-interactor-operation-set.js +1 -1
  155. package/dist/src/mechanics.js +12 -12
  156. package/dist/src/mobile-snapshot-semantics.js +1 -1
  157. package/dist/src/observability.js +1 -1
  158. package/dist/src/output-path.js +1 -1
  159. package/dist/src/parameterized-recorded-fill.js +1 -1
  160. package/dist/src/perf-facade.js +1 -1
  161. package/dist/src/perf-runtime-operation-builder.js +1 -1
  162. package/dist/src/perf-target.js +1 -1
  163. package/dist/src/physical-device-control.js +1 -1
  164. package/dist/src/platform-runtime-android-adb-host.js +1 -1
  165. package/dist/src/platform-runtime-claim-recovery.js +1 -1
  166. package/dist/src/platform-runtime-daemon-services.js +1 -1
  167. package/dist/src/platform-runtime-host.js +1 -1
  168. package/dist/src/platform-runtime-open-target.js +1 -1
  169. package/dist/src/platform-runtime-operation-host.js +5 -5
  170. package/dist/src/platform-runtime-runtime-hints.js +2 -2
  171. package/dist/src/platform-runtime-screen-recording-apple-simulator-host.js +1 -1
  172. package/dist/src/platform-runtime-screen-recording-finalizer-host.js +1 -1
  173. package/dist/src/platform-runtime-unavailable.js +1 -1
  174. package/dist/src/platform-runtime.js +1 -1
  175. package/dist/src/platform-runtime2.js +1 -1
  176. package/dist/src/png-resize.js +1 -1
  177. package/dist/src/png-worker-client.js +1 -1
  178. package/dist/src/process-exit.js +1 -1
  179. package/dist/src/provider-device-runtime.d.ts +28 -0
  180. package/dist/src/provider-plugin-catalog.js +2 -0
  181. package/dist/src/provider-plugin.d.ts +1 -1
  182. package/dist/src/provider-webdriver.js +1 -1
  183. package/dist/src/proxy.js +1 -1
  184. package/dist/src/react-native-overlay2.js +1 -1
  185. package/dist/src/react-native.js +1 -1
  186. package/dist/src/react-profile-command.js +1 -1
  187. package/dist/src/record-runtime.js +1 -1
  188. package/dist/src/record-trace.js +1 -1
  189. package/dist/src/recording-scope.js +1 -1
  190. package/dist/src/recording.js +1 -1
  191. package/dist/src/registry.js +1 -1
  192. package/dist/src/remote-config-core.js +1 -1
  193. package/dist/src/replay-backend-host.js +1 -1
  194. package/dist/src/replay-divergence.js +1 -1
  195. package/dist/src/replay-maestro-backend.js +3 -3
  196. package/dist/src/replay-script-selection.js +1 -1
  197. package/dist/src/replay2.js +1 -1
  198. package/dist/src/request-runtime-binding.js +1 -1
  199. package/dist/src/request.js +1 -1
  200. package/dist/src/result-serialization.js +1 -1
  201. package/dist/src/retry.js +1 -1
  202. package/dist/src/runner-cache-retention.js +1 -1
  203. package/dist/src/runner-client.js +1 -1
  204. package/dist/src/runner-dev-tools-security.js +1 -1
  205. package/dist/src/runner-device-readiness.js +1 -1
  206. package/dist/src/runner-device-set.js +1 -1
  207. package/dist/src/runner-error-classification.js +2 -2
  208. package/dist/src/runner-exchange.js +1 -1
  209. package/dist/src/runner-lease.js +1 -1
  210. package/dist/src/runner-operations-facade.js +1 -1
  211. package/dist/src/runner-retention.js +1 -1
  212. package/dist/src/runner-selector-query.js +1 -1
  213. package/dist/src/runner-start-budget.js +1 -1
  214. package/dist/src/runner-startup-transport.js +1 -1
  215. package/dist/src/runner-toolchain-probe.js +1 -1
  216. package/dist/src/runner.js +2 -2
  217. package/dist/src/runtime-admission.js +1 -1
  218. package/dist/src/runtime-deployment.js +1 -1
  219. package/dist/src/runtime-factory.js +1 -1
  220. package/dist/src/runtime-session.js +1 -1
  221. package/dist/src/runtime.js +4 -4
  222. package/dist/src/runtime10.js +2 -2
  223. package/dist/src/runtime2.js +1 -1
  224. package/dist/src/runtime3.js +5 -5
  225. package/dist/src/runtime4.js +1 -1
  226. package/dist/src/runtime5.js +1 -1
  227. package/dist/src/runtime6.js +1 -1
  228. package/dist/src/runtime7.js +1 -1
  229. package/dist/src/runtime8.js +1 -1
  230. package/dist/src/runtime9.js +2 -2
  231. package/dist/src/screen-recording-transport.js +1 -1
  232. package/dist/src/screenshot-density.js +1 -1
  233. package/dist/src/screenshot-runtime.js +1 -1
  234. package/dist/src/screenshot3.js +1 -1
  235. package/dist/src/sdk-batch-runner.js +2 -2
  236. package/dist/src/sdk-batch.js +2 -2
  237. package/dist/src/sdk-contracts.d.ts +9 -0
  238. package/dist/src/sdk-contracts.js +2 -2
  239. package/dist/src/sdk-device.js +1 -1
  240. package/dist/src/sdk-finders.js +1 -1
  241. package/dist/src/sdk-io.js +5 -5
  242. package/dist/src/sdk-remote-config.js +1 -1
  243. package/dist/src/sdk-selectors.js +1 -1
  244. package/dist/src/selection.js +0 -0
  245. package/dist/src/selector-pipeline-policy.js +1 -1
  246. package/dist/src/selector-runtime.js +1 -1
  247. package/dist/src/selectors.js +1 -1
  248. package/dist/src/server-startup.js +1 -1
  249. package/dist/src/session-paths.js +1 -1
  250. package/dist/src/session-replay-vars.js +1 -1
  251. package/dist/src/session-runtime.js +1 -1
  252. package/dist/src/session-store.js +3 -3
  253. package/dist/src/session.js +1 -1
  254. package/dist/src/session2.js +5 -5
  255. package/dist/src/settings-bluetooth.js +1 -1
  256. package/dist/src/settings.js +1 -1
  257. package/dist/src/settings2.js +1 -1
  258. package/dist/src/settle-observation-capture.js +1 -1
  259. package/dist/src/simctl-settings.js +1 -1
  260. package/dist/src/simctl.js +1 -1
  261. package/dist/src/simulator-boot.js +1 -1
  262. package/dist/src/simulator-state.js +1 -1
  263. package/dist/src/simulator.js +1 -1
  264. package/dist/src/snapshot-chrome.js +1 -1
  265. package/dist/src/snapshot-desktop-projection.js +1 -1
  266. package/dist/src/snapshot-helper-install.js +6 -6
  267. package/dist/src/snapshot-node-lookup.js +1 -1
  268. package/dist/src/snapshot-occlusion.js +1 -1
  269. package/dist/src/snapshot-runtime-binding.js +1 -1
  270. package/dist/src/snapshot-runtime-capture-input.js +1 -1
  271. package/dist/src/snapshot-runtime.js +1 -1
  272. package/dist/src/snapshot-state.js +1 -1
  273. package/dist/src/snapshot.js +1 -1
  274. package/dist/src/snapshot3.js +1 -1
  275. package/dist/src/src.js +1 -1
  276. package/dist/src/src3.js +1 -1
  277. package/dist/src/src4.js +1 -1
  278. package/dist/src/store.js +1 -1
  279. package/dist/src/tap-keyboard-occlusion.js +1 -1
  280. package/dist/src/target-evidence-tree.js +1 -1
  281. package/dist/src/target-evidence.js +1 -1
  282. package/dist/src/telephony-runtime.js +1 -1
  283. package/dist/src/text-entry-focus.js +1 -1
  284. package/dist/src/tool-provider.js +3 -3
  285. package/dist/src/tool-provider2.js +1 -1
  286. package/dist/src/tool-provider3.js +1 -1
  287. package/dist/src/toolchain-probe.js +1 -1
  288. package/dist/src/touch-reference-frame.js +1 -1
  289. package/dist/src/touch-runtime.js +1 -1
  290. package/dist/src/touch-runtime2.js +1 -1
  291. package/dist/src/tree.js +1 -1
  292. package/dist/src/tv-remote-runtime.js +1 -1
  293. package/dist/src/tv-remote.js +2 -2
  294. package/dist/src/type-text-runtime.js +1 -1
  295. package/dist/src/update-check.js +1 -1
  296. package/dist/src/vega-executable.js +1 -1
  297. package/dist/src/video.js +1 -1
  298. package/dist/src/webdriver-source.js +1 -1
  299. package/package.json +7 -6
  300. package/server.json +2 -2
  301. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.30.apk.sha256 +0 -1
  302. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk +0 -0
  303. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk.sha256 +0 -1
  304. package/dist/src/physical-device-apps.js +0 -1
@@ -1,4 +1,4 @@
1
- import{N as e,R as t,et as n,i as r,nt as i,rt as a}from"./sdk-contracts.js";import{g as o,v as s}from"./sdk-batch-runner.js";import{a as c,n as l,t as u}from"./sdk-device.js";import{S as d,c as f,d as p,p as m,w as h}from"./sdk-batch.js";import{B as g,E as ee,F as _,H as te,I as v,K as y,L as b,M as ne,P as x,R as S,S as re,U as ie,_ as ae,b as oe,d as se,g as ce,h as le,i as ue,n as C,p as de,q as fe,r as pe,t as w,w as me,x as he,y as ge,z as T}from"./command-metadata.js";import{n as _e}from"./success-text.js";import{n as ve,t as ye}from"./cli-output.js";import{r as E,t as D}from"./recording-stop-observation.js";import{r as O}from"./replay-divergence.js";import{n as k}from"./error.js";import{n as A,r as j,t as M}from"./cli-config.js";import{n as N}from"./result-serialization.js";const P=T({field:g(),artifactType:g(),path:g(),localPath:g(),fileName:g()},[`field`]),be={record:{type:`object`,oneOf:[T({recording:_(`started`),outPath:g(),sessionStateDir:g(),recordingBackend:g(),recordingScope:g(),recordOnlySession:x(),activeSessionApp:b(),showTouches:x()},[`recording`,`outPath`,`sessionStateDir`,`showTouches`]),T({recording:_(`stopped`),outPath:g(),telemetryPath:g(),artifacts:{type:`array`,items:P},recordingBackend:g(),recordingScope:g(),recordOnlySession:x(),activeSessionApp:b(),durationMs:S(),capturedDurationMs:S(),recorder:v(D,`What the recorder was observed doing when the recording was stopped: confirmed, or lost when the session holding it died. ADR 0024 reserves unconfirmed for the step that gains the probe.`),nativePathDisposition:v(E,`What became of the artifact path the recorder writes to: retirable while it still owes a removal, retired once that removal was verified. ADR 0024 reserves pending.`),showTouches:x(),warning:g(),overlayWarning:g(),chunks:{type:`array`,items:b()}},[`recording`,`outPath`,`artifacts`,`durationMs`,`showTouches`])]},trace:{type:`object`,oneOf:[T({trace:_(`started`),outPath:g()},[`trace`,`outPath`]),T({trace:_(`stopped`),outPath:g(),artifacts:{type:`array`,items:P}},[`trace`,`outPath`,`artifacts`])]}},xe=T({settled:x(`Whether the UI held the quiet window before the deadline. false is advisory, not failure.`),waitedMs:S(),captures:S(),quietMs:S(),timeoutMs:S(),refsGeneration:S(`Snapshot generation of the stored settled tree; refs on added diff lines were minted from it.`),refs:{type:`array`,items:T({ref:g(`Plain ref body (e12) minted from the stored settled tree.`)},[`ref`])},surfaceChange:re,diff:T({summary:T({additions:S(),removals:S(),unchanged:S()},[`additions`,`removals`,`unchanged`]),lines:{type:`array`,items:T({kind:v([`added`,`removed`]),text:g(),ref:g(`Plain ref body (e12) for added lines.`)},[`kind`,`text`])},truncated:x(`Lines were capped to the response bound.`)},[`summary`,`lines`],`Settled diff vs the pre-action tree (changed lines only).`),tail:{type:`array`,description:`Unchanged interactive refs tail: still-present, actionable elements from the settled tree, attached only when diff carries zero added-line refs (a modal-dismiss/toast-only diff).`,items:T({ref:g(`Plain ref body (e12) minted from the stored settled tree.`),role:g(),label:g()},[`ref`,`role`])},tailTruncated:x(`Present (true) when tail candidates exceeded the response cap.`),hint:g()},[`settled`,`waitedMs`,`captures`,`quietMs`,`timeoutMs`]);function F(e){return e.oneOf?{...e,oneOf:e.oneOf.map(F)}:{...e,properties:{...e.properties??{},settle:xe}}}function Se(e){let t={...e};for(let e of Object.keys(t))m(e)&&(t[e]=F(t[e]));return t}const Ce=Se({scroll:T({direction:v([`up`,`down`,`left`,`right`]),edge:v([`top`,`bottom`]),until:g(`Until scrolls only: the selector the passes stopped on.`),passes:S(`Edge and until scrolls only: how many scroll-and-check passes ran.`),amount:S(),pixels:S(),durationMs:S(),message:g(),keyboardAvoided:x(`Present only when an on-screen keyboard forced the swipe into the band above it; the reported pixels were planned against the shorter referenceHeight.`),keyboardMinY:S(`Where the keyboard began, in the same unit as the gesture coordinates. Clipped scrolls only.`),movement:v([`moved`,`at-edge`,`unchanged`,`unobserved`],"Directional scrolls only: what the owner observed after its gesture. `moved` means the content inside the scroller the swipe ran in differs from the tree the session stored immediately before the gesture; `at-edge` and `unchanged` mean it did not change, with no hidden content left to reveal and with no end-of-content signal to read, respectively; `unobserved` means the pair could not back a claim in either direction — nothing comparable was available (no stored tree, a capture from another lineage, a surface that never came to rest), or every difference sits outside the scroller that was swiped, which a changing status bar does on Android — so the reported distance rests on the gesture plan alone. The field is absent — which is never a claim that nothing moved — on the tiers that verify per pass (`scroll top`/`bottom`, `--until`), on a runtime bound without a capture, on a platform whose scroll dispatches no swipe (the Linux wheel), and where the caller already owns that observation (`--settle`, or a replay with `postGestureStabilization: false`).")},[`direction`]),...ee,...me,...ae,...ge,...oe,...ce,...le,...he,...be,...de,...se}),we={devices:{type:`object`,properties:{devices:{type:`array`,items:{type:`object`,properties:{platform:{type:`string`,enum:c},target:{type:`string`,enum:l},kind:{type:`string`,enum:u},id:{type:`string`},name:{type:`string`}},required:[`platform`,`target`,`kind`,`id`,`name`]}}},required:[`devices`]},apps:{type:`object`,properties:{apps:{type:`array`,items:{type:`string`}}},required:[`apps`]}},I={...Ce,...we},Te={stateDir:{schema:{type:`string`,description:`Agent-device state directory.`},audience:y({operatorConfig:!0})},mcpOutputFormat:{schema:{type:`string`,enum:[`optimized`,`json`],description:`MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.`}},includeCost:{schema:{type:`boolean`,description:`Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.`}},responseLevel:{schema:{type:`string`,enum:[`digest`,`default`,`full`],description:`Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.`}}},L=Object.entries(Te),R=new Set(L.map(([e])=>e)),Ee=Object.fromEntries(L.flatMap(([e,t])=>t.audience?[[e,t.audience]]:[]));function De(){return Object.fromEntries(L.map(([e,t])=>[e,t.schema]))}function z(e){return n(e)}function B(e){let t=[`Error (${e.code}): ${e.message}`];if(e.cause){let n=e.cause.code?`${e.cause.code} `:``;t.push(`Cause: ${n}${e.cause.message}`)}e.hint&&t.push(`Hint: ${e.hint}`);for(let n of _e(e.details))t.push(`Warning: ${ne(n)}`);t.push(...k(a(e.details))),e.supportedOn&&t.push(`Supported on: ${e.supportedOn}`);let n=O(e.details);return n&&t.push(n),t.join(`
2
- `)}function Oe(e,t,n,r){let i=M({command:e,cwd:r.cwd,env:r.env,cliFlags:t}),a={};for(let[t,r]of Object.entries(i))Object.hasOwn(n,t)&&j(t,e)&&(a[t]=r);return A(a,t)}const ke={devices:async e=>({devices:e.map(N)}),apps:async e=>({apps:e})};async function Ae(e,t){let n=ke[e];return n?await n(t):t}function je(){let e=new Map;return{pinInput:(t,n,r)=>Ge(t,n,Ie(e,r,n.session)),mergeCommandResult:(t,n,r,i)=>Le(e,t,n,r,i),mergeErrorDetails:(t,n,r)=>{let i=V(n,r);Me(e,i,t),Ue(e,i,t)}}}function Me(e,t,n){let r=n?.refsGeneration;typeof r==`number`&&H(e,t,i(n),r)}const Ne=new Set([`snapshot`,`find`]),Pe=new Set(p.map(e=>e.name).filter(C).filter(e=>m(e))),Fe=new Set([`press`,`click`,`fill`,`longpress`,`hover`,`get`]);function Ie(e,t,n){return e.get(V(t,n))}function V(e,t){let n=typeof t==`string`&&t.length>0?t:`default`;return`${e??``}\u0000${n}`}function Le(e,t,n,r,i){let a=V(r,i);if(Pe.has(t)){Be(e,a,Ve(n));return}Ne.has(t)&&(t===`find`?ze(e,a,n):Re(e,a,n))}function Re(t,n,r){let i=r.refsGeneration;if(typeof i!=`number`){t.delete(n);return}H(t,n,[...e(r.refs??[]),...e(r.nodes??[])],i)}function ze(e,t,n){let r=n.refsGeneration;if(typeof r!=`number`)return;let i=[];typeof n.ref==`string`&&n.ref.startsWith(`@`)&&i.push(n.ref.slice(1));for(let e of n.matches??[])typeof e.ref==`string`&&e.ref.length>0&&i.push(e.ref.startsWith(`@`)?e.ref.slice(1):e.ref);H(e,t,i,r)}function Be(e,t,n){n?.refsGeneration!==void 0&&H(e,t,[...n.diff?.lines??[],...n.refs??[],...n.tail??[]].map(e=>e.ref).filter(e=>typeof e==`string`),n.refsGeneration)}function Ve(e){let t=e.settle;return typeof t==`object`&&t?t:void 0}function H(e,t,n,r){if(n.length===0)return;let i=e.get(t)??new Map;e.set(t,i),He(i,n,r)}function He(e,t,n){for(let r of t)e.delete(r),e.set(r,n);for(;e.size>1e3;)e.delete(e.keys().next().value)}function Ue(e,t,n){let r=o(n?.divergence),i=o(r?.screen);if(i?.state!==`available`)return;let a=i.refsGeneration;if(typeof a!=`number`)return;let s=[];We(i.refs,s),H(e,t,s,a)}function We(e,t){if(Array.isArray(e))for(let n of e){let e=o(n)?.ref;typeof e==`string`&&e.length>0&&t.push(e)}}function Ge(e,t,n){return n===void 0||n.size===0?t:e===`wait`?Ke(t,n)??t:Fe.has(e)?qe(t,n)??t:t}function Ke(e,t){if(typeof e.ref!=`string`)return;let n=U(e.ref,t);return n===e.ref?void 0:{...e,ref:n}}function qe(e,t){let n=o(e.target);if(n?.kind!==`ref`||typeof n.ref!=`string`)return;let r=U(n.ref,t);return r===n.ref?void 0:{...e,target:{...n,ref:r}}}function U(e,t){if(!e.startsWith(`@`)||e.includes(`~`))return e;let n=t.get(e.slice(1));return n===void 0?e:`${e}~s${n}`}const Je={config:y({operatorPath:`Point the process serving these tools at a config file with the AGENT_DEVICE_CONFIG environment variable.`}),remoteConfig:y({operatorPath:`Configure the remote profile on the process serving these tools, not per tool call.`})},Ye=Object.fromEntries(pe().flatMap(e=>Object.entries(e.inputAudience).filter(([,e])=>e.kind===`operator`)));function W(e){return{...e.inputAudience,...ie,...Ee,...Je,...Ye}}function Xe(){return ue().map(e=>{let t=e.name in I?I[e.name]:void 0,n=J(e.name,e);return{name:e.name,description:at(e.name,te(e)),inputSchema:n,...t?{outputSchema:t}:{}}})}function G(e={}){let n=je();return{execute:async(r,i)=>{if(!C(r))throw new t(`INVALID_ARGS`,`Unknown command tool: ${r}`);let a=w(r),o=Y(r,a,i)??X(a.inputSchema,i,r);if(o)return await K(new t(`INVALID_ARGS`,o),n,void 0,i.session);let{captureHostEnvironment:s}=await import(`./sdk-io.js`).then(e=>e.r),c=s(process),l=Q(r,a.inputSchema).properties,u=Oe(r,i,l,c),d=et(u),f=rt(u),p=n.pinInput(r,f,d.client.stateDir),m=await Qe(e,d.client,c);try{let t=await(e.runCommand??$e)(m,r,p);return n.mergeCommandResult(r,t,d.client.stateDir,f.session),{isError:!1,structuredContent:await Ae(r,t),content:[{type:`text`,text:await ot({name:r,input:f,result:t,env:c.env,outputFormat:d.outputFormat,responseLevel:d.client.responseLevel})}]}}catch(e){return await K(e,n,d.client.stateDir,f.session)}}}}async function K(e,t,n,r){let i=z(e);return t.mergeErrorDetails(i.details,n,r),{isError:!0,structuredContent:i,content:[{type:`text`,text:B(i)}]}}const Ze=G();async function Qe(e,t,n){if(e.createClient)return await e.createClient(t);let{createAgentDeviceClient:r}=await import(`./agent-device-client.js`).then(e=>e.t),{createEnsuredDaemonTransport:i}=await import(`./daemon-client.js`).then(e=>e.r),a=i({host:n});return r(t,{host:n,transport:async(e,t)=>await a(e,t)})}async function $e(e,t,n){return await(await import(`./command-surface.js`).then(e=>e.t)).runCommand(e,t,n)}function et(e){return{client:q(e),outputFormat:nt(e.mcpOutputFormat)}}function q(e){let n=e.stateDir,r=e.includeCost,i=e.responseLevel,a={};if(n!==void 0){if(typeof n!=`string`||n.length===0)throw new t(`INVALID_ARGS`,`Expected stateDir to be a non-empty string.`);a.stateDir=n}if(r!==void 0){if(typeof r!=`boolean`)throw new t(`INVALID_ARGS`,`Expected includeCost to be a boolean.`);r&&(a.cost=!0)}let o=tt(i);return o!==void 0&&(a.responseLevel=o),a}function tt(e){if(e===void 0)return;let n=r.find(t=>t===e);if(n===void 0)throw new t(`INVALID_ARGS`,`Expected responseLevel to be one of 'digest', 'default', or 'full'.`);return n}function nt(e){if(e===void 0)return`optimized`;if(e!==`optimized`&&e!==`json`)throw new t(`INVALID_ARGS`,`Expected mcpOutputFormat to be "optimized" or "json".`);return e}function rt(e){return Object.fromEntries(Object.entries(e).filter(([e])=>!R.has(e)))}function J(e,t){let n=W(t),r=Q(e,t.inputSchema);return{...r,properties:Object.fromEntries(Object.entries(r.properties).filter(([e])=>n[e]?.kind!==`operator`))}}function Y(e,t,n){let r=J(e,t).properties,i=W(t);for(let t of Object.keys(n)){if(Object.hasOwn(r,t))continue;let n=Object.hasOwn(i,t)?i[t]:void 0;if(n?.kind!==`retired`)return n?.kind===`operator`?fe(t,n.source):`${t} is not an accepted argument for the ${e} tool.`}}function X(e,t,n){if(!(!e||t===void 0)){if(Array.isArray(t))return Z(t,(t,r)=>X(e.items,t,`${n}[${r}]`));if(s(t))return Z(e.oneOf??[],e=>X(e,t,n))??Z(Object.entries(e.properties??{}),([e,r])=>Object.hasOwn(t,e)?it(r,t,e,`${n}.${e}`):void 0)}}function it(e,t,n,r){let i=e.commandInputFor;if(i===void 0)return X(e,t[n],r);let a=t[n],o=f(t[i]);if(o===void 0||!s(a))return;let c=Y(o,w(o),a);return c===void 0?void 0:`${r}: ${c}`}function Z(e,t){for(let[n,r]of e.entries()){let e=t(r,n);if(e)return e}}function at(e,t){let n=h(e);if(n.envelopeMs===`unbounded`)return`${t} Streams progress; no fixed client timeout.`;let r=Math.round(n.envelopeMs/1e3);return n.budget.source===`none`?`${t} Times out after ${r}s.`:`${t} Times out after ${r}s; a caller-supplied budget extends it.`}function Q(e,t){let n=d(e);return{...t,properties:{...t.properties,...n&&!t.properties?.noRecord?{noRecord:{type:`boolean`,description:`Do not record this action.`}}:{},...De()}}}async function ot(e){if(e.outputFormat===`json`||e.responseLevel!==void 0&&e.responseLevel!=="default")return $(e.result);let t=await ye({name:e.name,input:e.input,result:e.result,env:e.env});return typeof t?.text==`string`?st(e.name,t):$(t?.data??e.result)}function st(e,t){let n=t.text??``;if(!ve(e))return n;let r=t.stderr?.trimEnd()??``;return r===``?n:`${n}${n.endsWith(`
1
+ import{N as e,R as t,i as n,it as r,rt as i,tt as a}from"./sdk-contracts.js";import{g as o,v as s}from"./sdk-batch-runner.js";import{a as c,n as l,t as u}from"./sdk-device.js";import{S as d,c as f,d as p,p as m,w as h}from"./sdk-batch.js";import{B as g,E as ee,F as _,H as te,I as v,K as y,L as b,M as ne,P as x,R as S,S as re,U as ie,_ as ae,b as oe,d as se,g as ce,h as le,i as ue,n as C,p as de,q as fe,r as pe,t as w,w as me,x as he,y as ge,z as T}from"./command-metadata.js";import{n as _e}from"./success-text.js";import{n as ve,t as ye}from"./cli-output.js";import{r as E,t as D}from"./recording-stop-observation.js";import{r as O}from"./replay-divergence.js";import{n as k}from"./error.js";import{n as A,r as j,t as M}from"./cli-config.js";import{n as N}from"./result-serialization.js";const P=T({field:g(),artifactType:g(),path:g(),localPath:g(),fileName:g()},[`field`]),be={record:{type:`object`,oneOf:[T({recording:_(`started`),outPath:g(),sessionStateDir:g(),recordingBackend:g(),recordingScope:g(),recordOnlySession:x(),activeSessionApp:b(),showTouches:x()},[`recording`,`outPath`,`sessionStateDir`,`showTouches`]),T({recording:_(`stopped`),outPath:g(),telemetryPath:g(),artifacts:{type:`array`,items:P},recordingBackend:g(),recordingScope:g(),recordOnlySession:x(),activeSessionApp:b(),durationMs:S(),capturedDurationMs:S(),recorder:v(D,`What the recorder was observed doing when the recording was stopped: confirmed, or lost when the session holding it died. ADR 0024 reserves unconfirmed for the step that gains the probe.`),nativePathDisposition:v(E,`What became of the artifact path the recorder writes to: retirable while it still owes a removal, retired once that removal was verified. ADR 0024 reserves pending.`),showTouches:x(),warning:g(),overlayWarning:g(),chunks:{type:`array`,items:b()}},[`recording`,`outPath`,`artifacts`,`durationMs`,`showTouches`])]},trace:{type:`object`,oneOf:[T({trace:_(`started`),outPath:g()},[`trace`,`outPath`]),T({trace:_(`stopped`),outPath:g(),artifacts:{type:`array`,items:P}},[`trace`,`outPath`,`artifacts`])]}},xe=T({settled:x(`Whether the UI held the quiet window before the deadline. false is advisory, not failure.`),waitedMs:S(),captures:S(),quietMs:S(),timeoutMs:S(),refsGeneration:S(`Snapshot generation of the stored settled tree; refs on added diff lines were minted from it.`),refs:{type:`array`,items:T({ref:g(`Plain ref body (e12) minted from the stored settled tree.`)},[`ref`])},surfaceChange:re,diff:T({summary:T({additions:S(),removals:S(),unchanged:S()},[`additions`,`removals`,`unchanged`]),lines:{type:`array`,items:T({kind:v([`added`,`removed`]),text:g(),ref:g(`Plain ref body (e12) for added lines.`)},[`kind`,`text`])},truncated:x(`Lines were capped to the response bound.`)},[`summary`,`lines`],`Settled diff vs the pre-action tree (changed lines only).`),tail:{type:`array`,description:`Unchanged interactive refs tail: still-present, actionable elements from the settled tree, attached only when diff carries zero added-line refs (a modal-dismiss/toast-only diff).`,items:T({ref:g(`Plain ref body (e12) minted from the stored settled tree.`),role:g(),label:g()},[`ref`,`role`])},tailTruncated:x(`Present (true) when tail candidates exceeded the response cap.`),hint:g()},[`settled`,`waitedMs`,`captures`,`quietMs`,`timeoutMs`]);function F(e){return e.oneOf?{...e,oneOf:e.oneOf.map(F)}:{...e,properties:{...e.properties??{},settle:xe}}}function Se(e){let t={...e};for(let e of Object.keys(t))m(e)&&(t[e]=F(t[e]));return t}const Ce=Se({scroll:T({direction:v([`up`,`down`,`left`,`right`]),edge:v([`top`,`bottom`]),until:g(`Until scrolls only: the selector the passes stopped on.`),passes:S(`Edge and until scrolls only: how many scroll-and-check passes ran.`),amount:S(),pixels:S(),durationMs:S(),message:g(),keyboardAvoided:x(`Present only when an on-screen keyboard forced the swipe into the band above it; the reported pixels were planned against the shorter referenceHeight.`),keyboardMinY:S(`Where the keyboard began, in the same unit as the gesture coordinates. Clipped scrolls only.`),movement:v([`moved`,`at-edge`,`unchanged`,`unobserved`],"Directional scrolls only: what the owner observed after its gesture. `moved` means the content inside the scroller the swipe ran in differs from the tree the session stored immediately before the gesture; `at-edge` and `unchanged` mean it did not change, with no hidden content left to reveal and with no end-of-content signal to read, respectively; `unobserved` means the pair could not back a claim in either direction — nothing comparable was available (no stored tree, a capture from another lineage, a surface that never came to rest), or every difference sits outside the scroller that was swiped, which a changing status bar does on Android — so the reported distance rests on the gesture plan alone. The field is absent — which is never a claim that nothing moved — on the tiers that verify per pass (`scroll top`/`bottom`, `--until`), on a runtime bound without a capture, on a platform whose scroll dispatches no swipe (the Linux wheel), and where the caller already owns that observation (`--settle`, or a replay with `postGestureStabilization: false`).")},[`direction`]),...ee,...me,...ae,...ge,...oe,...ce,...le,...he,...be,...de,...se}),we={devices:{type:`object`,properties:{devices:{type:`array`,items:{type:`object`,properties:{platform:{type:`string`,enum:c},target:{type:`string`,enum:l},kind:{type:`string`,enum:u},id:{type:`string`},name:{type:`string`}},required:[`platform`,`target`,`kind`,`id`,`name`]}}},required:[`devices`]},apps:{type:`object`,properties:{apps:{type:`array`,items:{type:`string`}}},required:[`apps`]}},I={...Ce,...we},Te={stateDir:{schema:{type:`string`,description:`Agent-device state directory.`},audience:y({operatorConfig:!0})},mcpOutputFormat:{schema:{type:`string`,enum:[`optimized`,`json`],description:`MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.`}},includeCost:{schema:{type:`boolean`,description:`Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.`}},responseLevel:{schema:{type:`string`,enum:[`digest`,`default`,`full`],description:`Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.`}}},L=Object.entries(Te),R=new Set(L.map(([e])=>e)),Ee=Object.fromEntries(L.flatMap(([e,t])=>t.audience?[[e,t.audience]]:[]));function De(){return Object.fromEntries(L.map(([e,t])=>[e,t.schema]))}function z(e){return a(e)}function B(e){let t=[`Error (${e.code}): ${e.message}`];if(e.cause){let n=e.cause.code?`${e.cause.code} `:``;t.push(`Cause: ${n}${e.cause.message}`)}e.hint&&t.push(`Hint: ${e.hint}`);for(let n of _e(e.details))t.push(`Warning: ${ne(n)}`);t.push(...k(r(e.details))),e.supportedOn&&t.push(`Supported on: ${e.supportedOn}`);let n=O(e.details);return n&&t.push(n),t.join(`
2
+ `)}function Oe(e,t,n,r){let i=M({command:e,cwd:r.cwd,env:r.env,cliFlags:t}),a={};for(let[t,r]of Object.entries(i))Object.hasOwn(n,t)&&j(t,e)&&(a[t]=r);return A(a,t)}const ke={devices:async e=>({devices:e.map(N)}),apps:async e=>({apps:e})};async function Ae(e,t){let n=ke[e];return n?await n(t):t}function je(){let e=new Map;return{pinInput:(t,n,r)=>Ge(t,n,Ie(e,r,n.session)),mergeCommandResult:(t,n,r,i)=>Le(e,t,n,r,i),mergeErrorDetails:(t,n,r)=>{let i=V(n,r);Me(e,i,t),Ue(e,i,t)}}}function Me(e,t,n){let r=n?.refsGeneration;typeof r==`number`&&H(e,t,i(n),r)}const Ne=new Set([`snapshot`,`find`]),Pe=new Set(p.map(e=>e.name).filter(C).filter(e=>m(e))),Fe=new Set([`press`,`click`,`fill`,`longpress`,`hover`,`get`]);function Ie(e,t,n){return e.get(V(t,n))}function V(e,t){let n=typeof t==`string`&&t.length>0?t:`default`;return`${e??``}\u0000${n}`}function Le(e,t,n,r,i){let a=V(r,i);if(Pe.has(t)){Be(e,a,Ve(n));return}Ne.has(t)&&(t===`find`?ze(e,a,n):Re(e,a,n))}function Re(t,n,r){let i=r.refsGeneration;if(typeof i!=`number`){t.delete(n);return}H(t,n,[...e(r.refs??[]),...e(r.nodes??[])],i)}function ze(e,t,n){let r=n.refsGeneration;if(typeof r!=`number`)return;let i=[];typeof n.ref==`string`&&n.ref.startsWith(`@`)&&i.push(n.ref.slice(1));for(let e of n.matches??[])typeof e.ref==`string`&&e.ref.length>0&&i.push(e.ref.startsWith(`@`)?e.ref.slice(1):e.ref);H(e,t,i,r)}function Be(e,t,n){n?.refsGeneration!==void 0&&H(e,t,[...n.diff?.lines??[],...n.refs??[],...n.tail??[]].map(e=>e.ref).filter(e=>typeof e==`string`),n.refsGeneration)}function Ve(e){let t=e.settle;return typeof t==`object`&&t?t:void 0}function H(e,t,n,r){if(n.length===0)return;let i=e.get(t)??new Map;e.set(t,i),He(i,n,r)}function He(e,t,n){for(let r of t)e.delete(r),e.set(r,n);for(;e.size>1e3;)e.delete(e.keys().next().value)}function Ue(e,t,n){let r=o(n?.divergence),i=o(r?.screen);if(i?.state!==`available`)return;let a=i.refsGeneration;if(typeof a!=`number`)return;let s=[];We(i.refs,s),H(e,t,s,a)}function We(e,t){if(Array.isArray(e))for(let n of e){let e=o(n)?.ref;typeof e==`string`&&e.length>0&&t.push(e)}}function Ge(e,t,n){return n===void 0||n.size===0?t:e===`wait`?Ke(t,n)??t:Fe.has(e)?qe(t,n)??t:t}function Ke(e,t){if(typeof e.ref!=`string`)return;let n=U(e.ref,t);return n===e.ref?void 0:{...e,ref:n}}function qe(e,t){let n=o(e.target);if(n?.kind!==`ref`||typeof n.ref!=`string`)return;let r=U(n.ref,t);return r===n.ref?void 0:{...e,target:{...n,ref:r}}}function U(e,t){if(!e.startsWith(`@`)||e.includes(`~`))return e;let n=t.get(e.slice(1));return n===void 0?e:`${e}~s${n}`}const Je={config:y({operatorPath:`Point the process serving these tools at a config file with the AGENT_DEVICE_CONFIG environment variable.`}),remoteConfig:y({operatorPath:`Configure the remote profile on the process serving these tools, not per tool call.`})},Ye=Object.fromEntries(pe().flatMap(e=>Object.entries(e.inputAudience).filter(([,e])=>e.kind===`operator`)));function W(e){return{...e.inputAudience,...ie,...Ee,...Je,...Ye}}function Xe(){return ue().map(e=>{let t=e.name in I?I[e.name]:void 0,n=J(e.name,e);return{name:e.name,description:at(e.name,te(e)),inputSchema:n,...t?{outputSchema:t}:{}}})}function G(e={}){let n=je();return{execute:async(r,i)=>{if(!C(r))throw new t(`INVALID_ARGS`,`Unknown command tool: ${r}`);let a=w(r),o=Y(r,a,i)??X(a.inputSchema,i,r);if(o)return await K(new t(`INVALID_ARGS`,o),n,void 0,i.session);let{captureHostEnvironment:s}=await import(`./sdk-io.js`).then(e=>e.r),c=s(process),l=Q(r,a.inputSchema).properties,u=Oe(r,i,l,c),d=et(u),f=rt(u),p=n.pinInput(r,f,d.client.stateDir),m=await Qe(e,d.client,c);try{let t=await(e.runCommand??$e)(m,r,p);return n.mergeCommandResult(r,t,d.client.stateDir,f.session),{isError:!1,structuredContent:await Ae(r,t),content:[{type:`text`,text:await ot({name:r,input:f,result:t,env:c.env,outputFormat:d.outputFormat,responseLevel:d.client.responseLevel})}]}}catch(e){return await K(e,n,d.client.stateDir,f.session)}}}}async function K(e,t,n,r){let i=z(e);return t.mergeErrorDetails(i.details,n,r),{isError:!0,structuredContent:i,content:[{type:`text`,text:B(i)}]}}const Ze=G();async function Qe(e,t,n){if(e.createClient)return await e.createClient(t);let{createAgentDeviceClient:r}=await import(`./agent-device-client.js`).then(e=>e.t),{createEnsuredDaemonTransport:i}=await import(`./daemon-client.js`).then(e=>e.r),a=i({host:n});return r(t,{host:n,transport:async(e,t)=>await a(e,t)})}async function $e(e,t,n){return await(await import(`./command-surface.js`).then(e=>e.t)).runCommand(e,t,n)}function et(e){return{client:q(e),outputFormat:nt(e.mcpOutputFormat)}}function q(e){let n=e.stateDir,r=e.includeCost,i=e.responseLevel,a={};if(n!==void 0){if(typeof n!=`string`||n.length===0)throw new t(`INVALID_ARGS`,`Expected stateDir to be a non-empty string.`);a.stateDir=n}if(r!==void 0){if(typeof r!=`boolean`)throw new t(`INVALID_ARGS`,`Expected includeCost to be a boolean.`);r&&(a.cost=!0)}let o=tt(i);return o!==void 0&&(a.responseLevel=o),a}function tt(e){if(e===void 0)return;let r=n.find(t=>t===e);if(r===void 0)throw new t(`INVALID_ARGS`,`Expected responseLevel to be one of 'digest', 'default', or 'full'.`);return r}function nt(e){if(e===void 0)return`optimized`;if(e!==`optimized`&&e!==`json`)throw new t(`INVALID_ARGS`,`Expected mcpOutputFormat to be "optimized" or "json".`);return e}function rt(e){return Object.fromEntries(Object.entries(e).filter(([e])=>!R.has(e)))}function J(e,t){let n=W(t),r=Q(e,t.inputSchema);return{...r,properties:Object.fromEntries(Object.entries(r.properties).filter(([e])=>n[e]?.kind!==`operator`))}}function Y(e,t,n){let r=J(e,t).properties,i=W(t);for(let t of Object.keys(n)){if(Object.hasOwn(r,t))continue;let n=Object.hasOwn(i,t)?i[t]:void 0;if(n?.kind!==`retired`)return n?.kind===`operator`?fe(t,n.source):`${t} is not an accepted argument for the ${e} tool.`}}function X(e,t,n){if(!(!e||t===void 0)){if(Array.isArray(t))return Z(t,(t,r)=>X(e.items,t,`${n}[${r}]`));if(s(t))return Z(e.oneOf??[],e=>X(e,t,n))??Z(Object.entries(e.properties??{}),([e,r])=>Object.hasOwn(t,e)?it(r,t,e,`${n}.${e}`):void 0)}}function it(e,t,n,r){let i=e.commandInputFor;if(i===void 0)return X(e,t[n],r);let a=t[n],o=f(t[i]);if(o===void 0||!s(a))return;let c=Y(o,w(o),a);return c===void 0?void 0:`${r}: ${c}`}function Z(e,t){for(let[n,r]of e.entries()){let e=t(r,n);if(e)return e}}function at(e,t){let n=h(e);if(n.envelopeMs===`unbounded`)return`${t} Streams progress; no fixed client timeout.`;let r=Math.round(n.envelopeMs/1e3);return n.budget.source===`none`?`${t} Times out after ${r}s.`:`${t} Times out after ${r}s; a caller-supplied budget extends it.`}function Q(e,t){let n=d(e);return{...t,properties:{...t.properties,...n&&!t.properties?.noRecord?{noRecord:{type:`boolean`,description:`Do not record this action.`}}:{},...De()}}}async function ot(e){if(e.outputFormat===`json`||e.responseLevel!==void 0&&e.responseLevel!=="default")return $(e.result);let t=await ye({name:e.name,input:e.input,result:e.result,env:e.env});return typeof t?.text==`string`?st(e.name,t):$(t?.data??e.result)}function st(e,t){let n=t.text??``;if(!ve(e))return n;let r=t.stderr?.trimEnd()??``;return r===``?n:`${n}${n.endsWith(`
3
3
  `)?``:`
4
4
  `}${r}`}function $(e){return typeof e==`string`?e:JSON.stringify(e,null,2)}export{z as a,B as i,G as n,R as o,Xe as r,Ze as t};
@@ -1 +1 @@
1
- import{r as e}from"./rolldown-runtime.js";import{$ as t,G as n,H as r,J as i,K as a,Q as o,U as s,W as c,X as l,Y as u,Z as d,at as f,et as p,it as m,nt as h,ot as g,q as _,st as v,tt as y}from"./sdk-io.js";var b=e({coerceExecResult:()=>r,commandDeveloperDir:()=>s,commandHostEnvironment:()=>c,execFailureDetails:()=>n,isCommandTimeoutError:()=>a,isExecutablePath:()=>_,requireExecSuccess:()=>i,resolveExecutableOverridePath:()=>u,resolveFileOverridePath:()=>l,runCmd:()=>d,runCmdBackground:()=>o,runCmdDetached:()=>t,runCmdDetachedMonitored:()=>p,runCmdStreaming:()=>y,runCmdSync:()=>h,whichCmd:()=>m,withCommandExecutorOverride:()=>f,withCommandHost:()=>g,withoutCommandExecutorOverride:()=>v});export{b as t};
1
+ import{r as e}from"./rolldown-runtime.js";import{$ as t,G as n,J as r,K as i,Q as a,U as o,W as s,X as c,Y as l,Z as u,at as d,ct as f,et as p,lt as m,nt as h,ot as g,q as _,rt as v,st as y,tt as b}from"./sdk-io.js";var x=e({EXEC_COMMAND_PHASE:()=>m,coerceExecResult:()=>o,commandDeveloperDir:()=>s,commandHostEnvironment:()=>n,execFailureDetails:()=>i,isCommandTimeoutError:()=>_,isExecutablePath:()=>r,requireExecSuccess:()=>l,resolveExecutableOverridePath:()=>c,resolveFileOverridePath:()=>u,runCmd:()=>a,runCmdBackground:()=>t,runCmdDetached:()=>p,runCmdDetachedMonitored:()=>b,runCmdStreaming:()=>h,runCmdSync:()=>v,whichCmd:()=>d,withCommandExecutorOverride:()=>g,withCommandHost:()=>y,withoutCommandExecutorOverride:()=>f});export{x as t};
@@ -1 +1 @@
1
- import{R as e}from"./sdk-contracts.js";import{B as t,H as n,L as r}from"./tv-remote.js";import{p as i}from"./sdk-device.js";function a(e){let r=o(e.registry,e.loadHost),i=e.provider,a=i?async(e,a)=>{a.signal.throwIfAborted();let o=await i.discover(n(e),a.signal);return a.signal.throwIfAborted(),h(o),o.kind===`inventory`?{devices:t(o.devices.map(e=>({...e})),e),source:`provider`}:{devices:await r.discover(e,a),source:`local`}}:async(e,t)=>({devices:await r.discover(e,t),source:`local`}),s=Object.freeze({discover:async(e,t)=>(await a(e,t)).devices,discoverWithSource:a});return Object.freeze({providerFirst:s,localOnly:r,findInstalledApp:e.findInstalledApp})}function o(e,t){let n,i=async()=>{n??=t();try{return await n}catch(e){throw n=void 0,e}},a=new Map,o=async t=>{let n=a.get(t);if(n)return await n;let r=s(e.get(t),i);a.set(t,r);try{return await r}catch(e){throw a.get(t)===r&&a.delete(t),e}};return Object.freeze({discover:async(e,t)=>{if(t.signal.throwIfAborted(),e.platform)return await p(o,g(e.platform),e,t);let n=await Promise.all(r.map(async n=>{try{let r=await p(o,g(n),{...e,platform:n},t);return Array.isArray(r)?r:[]}catch{return[]}}));return t.signal.throwIfAborted(),n.flat()}})}async function s(e,t){switch(e.family){case`apple`:return await e.loadInventory(c(await t()));case`android`:return await e.loadInventory(l(await t()));case`harmonyos`:return await e.loadInventory(u(await t()));case`vega`:return await e.loadInventory(d(await t()));case`linux`:return await e.loadInventory(f(await t()));case`web`:return await e.loadInventory()}}function c(e){return Object.freeze({appleTools:e.appleTools,files:e.files,hostName:e.hostName,hostOs:e.hostOs,observations:e.observations})}function l(e){return Object.freeze({commands:e.commands,files:e.files,homeDirectory:e.homeDirectory,toolchains:e.toolchains})}function u(e){return Object.freeze({commands:e.commands,files:e.files,toolchains:e.toolchains})}function d(e){return Object.freeze({commands:e.commands,files:e.files,homeDirectory:e.homeDirectory})}function f(e){return Object.freeze({hostName:e.hostName,hostOs:e.hostOs})}async function p(e,n,r,i){let a=await e(n);i.signal.throwIfAborted();let o=await a.discover(r,i);return i.signal.throwIfAborted(),m(n,o),t(o,r)}function m(t,n){let r=n.find(e=>e.platform!==t);if(r)throw new e(`COMMAND_FAILED`,`Platform inventory source ${t} returned a ${r.platform} device.`,{expectedFamily:t,actualFamily:r.platform,deviceId:r.id})}function h(t){if(typeof t==`object`&&t){let e=t;if(e.kind===`declined`&&!(`devices`in e)||e.kind===`inventory`&&Array.isArray(e.devices))return}throw new e(`COMMAND_FAILED`,`Provider device inventory returned an invalid outcome.`,{reason:`provider_inventory_contract_violation`})}function g(e){return i(e)?`apple`:e}export{a as createComposedDeviceInventoryGateways};
1
+ import{R as e}from"./sdk-contracts.js";import{H as t,W as n,z as r}from"./tv-remote.js";import{b as i}from"./sdk-device.js";function a(e){let r=o(e.registry,e.loadHost),i=e.provider,a=i?async(e,a)=>{a.signal.throwIfAborted();let o=await i.discover(n(e),a.signal);return a.signal.throwIfAborted(),h(o),o.kind===`inventory`?{devices:t(o.devices.map(e=>({...e})),e),source:`provider`}:{devices:await r.discover(e,a),source:`local`}}:async(e,t)=>({devices:await r.discover(e,t),source:`local`}),s=Object.freeze({discover:async(e,t)=>(await a(e,t)).devices,discoverWithSource:a});return Object.freeze({providerFirst:s,localOnly:r,findInstalledApp:e.findInstalledApp,resolveAppDevice:e.resolveAppDevice})}function o(e,t){let n,i=async()=>{n??=t();try{return await n}catch(e){throw n=void 0,e}},a=new Map,o=async t=>{let n=a.get(t);if(n)return await n;let r=s(e.get(t),i);a.set(t,r);try{return await r}catch(e){throw a.get(t)===r&&a.delete(t),e}};return Object.freeze({discover:async(e,t)=>{if(t.signal.throwIfAborted(),e.platform)return await p(o,g(e.platform),e,t);let n=await Promise.all(r.map(async n=>{try{let r=await p(o,g(n),{...e,platform:n},t);return Array.isArray(r)?r:[]}catch{return[]}}));return t.signal.throwIfAborted(),n.flat()}})}async function s(e,t){switch(e.family){case`apple`:return await e.loadInventory(c(await t()));case`android`:return await e.loadInventory(l(await t()));case`harmonyos`:return await e.loadInventory(u(await t()));case`vega`:return await e.loadInventory(d(await t()));case`linux`:return await e.loadInventory(f(await t()));case`web`:return await e.loadInventory()}}function c(e){return Object.freeze({appleTools:e.appleTools,files:e.files,hostName:e.hostName,hostOs:e.hostOs,observations:e.observations})}function l(e){return Object.freeze({commands:e.commands,files:e.files,homeDirectory:e.homeDirectory,toolchains:e.toolchains})}function u(e){return Object.freeze({commands:e.commands,files:e.files,toolchains:e.toolchains})}function d(e){return Object.freeze({commands:e.commands,files:e.files,homeDirectory:e.homeDirectory})}function f(e){return Object.freeze({hostName:e.hostName,hostOs:e.hostOs})}async function p(e,n,r,i){let a=await e(n);i.signal.throwIfAborted();let o=await a.discover(r,i);return i.signal.throwIfAborted(),m(n,o),t(o,r)}function m(t,n){let r=n.find(e=>e.platform!==t);if(r)throw new e(`COMMAND_FAILED`,`Platform inventory source ${t} returned a ${r.platform} device.`,{expectedFamily:t,actualFamily:r.platform,deviceId:r.id})}function h(t){if(typeof t==`object`&&t){let e=t;if(e.kind===`declined`&&!(`devices`in e)||e.kind===`inventory`&&Array.isArray(e.devices))return}throw new e(`COMMAND_FAILED`,`Provider device inventory returned an invalid outcome.`,{reason:`provider_inventory_contract_violation`})}function g(e){return i(e)?`apple`:e}export{a as createComposedDeviceInventoryGateways};
@@ -1 +1 @@
1
- import{R as e,d as t,l as n}from"./sdk-contracts.js";import{E as r,T as i,dt as a}from"./back-mode.js";import{A as o,s,w as c}from"./sdk-device.js";import{m as l}from"./command-metadata.js";import{s as u}from"./file.js";import{m as d}from"./daemon-resolution.js";import{u as f}from"./src2.js";import{r as p,t as m}from"./remote-config-core.js";import"./remote-config2.js";import{i as h,n as g}from"./store.js";import{i as _,n as v,t as y}from"./builtin-provider-ids.js";import{C as b,S as ee,_ as te,b as x,c as S,f as C,h as ne,l as w,m as T,p as E,s as D,x as re}from"./cli.js";import O from"node:crypto";const k=new Map;async function A(e,t=[]){if(k.has(u(e)))return;let{claimProviderIds:n,resolveProviderPlugins:r}=await import(`./registry.js`),i=await r([...n(t),...await h(e)]);k.set(u(e),{connections:i.connections,failures:i.inventory().filter(e=>e.state===`failed`)})}function ie(e,t){return k.get(u(t))?.connections.get(e)}function ae(e){return k.get(u(e))?.failures??[]}function j(e,t){if(e===void 0)return;let n=k.get(u(t));return n?n.connections.get(e)?.capabilities:g(t).find(t=>t.agentDevicePlugin.provider===e)?.agentDevicePlugin.connection}function oe(e){let t=k.get(u(e));return t?[...t.connections.keys()]:g(e).filter(e=>e.agentDevicePlugin.connection).map(e=>e.agentDevicePlugin.provider)}function M(e){return{leaseKind:e,requiresAppAttachment:!1,requiresRemoteDaemon:!0,supportsArtifacts:!1,supportsDeferredAppSelection:!1,supportsDirectPortReverse:!1,usesCloudWebDriverLease:!1}}async function N(e,t=process.env){e===void 0||y.includes(e)||await A(t,v)}function se(e,t=process.env){return e!==void 0&&(y.includes(e)||j(e,t)!==void 0)}function ce(e=process.env){let t=[...y,...oe(e)].join(`, `),n=ae(e).map(({package:e,provider:t,error:n})=>`${e??t??`plugin store`}: ${n.message}`);return n.length===0?t:`${t}. Plugins that failed to load: ${n.join(`; `)}`}function P(e,t=process.env){return e===`proxy`?M(`proxy`):_(e)??(e===`cloud`?void 0:j(e,t))??M(`remote-provider`)}function le(e){return{providerDeviceOrientation:e.providerDeviceOrientation,providerGeoLocation:e.providerGeoLocation,providerTimezone:e.providerTimezone,providerAppiumVersion:e.providerAppiumVersion,providerLanguage:e.providerLanguage,providerLocale:e.providerLocale,providerNetworkProfile:e.providerNetworkProfile,providerCustomNetwork:e.providerCustomNetwork,providerNoResignApp:e.providerNoResignApp}}function ue(e){return{metroProjectRoot:e.metroProjectRoot,metroKind:e.metroKind,metroPublicBaseUrl:e.metroPublicBaseUrl,metroProxyBaseUrl:e.metroProxyBaseUrl,metroPreparePort:e.metroPreparePort,metroListenHost:e.metroListenHost,metroStatusHost:e.metroStatusHost,metroStartupTimeoutMs:e.metroStartupTimeoutMs,metroProbeTimeoutMs:e.metroProbeTimeoutMs,metroRuntimeFile:e.metroRuntimeFile,metroNoReuseExisting:e.metroNoReuseExisting,metroNoInstallDeps:e.metroNoInstallDeps,launchUrl:e.launchUrl}}const de=new Set([r.open,r.install,r.reinstall,r.uninstall,i.installSource]);async function F(t){if(!de.has(t.command)){if(t.state.leaseId&&t.state.deviceKey)return{state:t.state};throw new e(`INVALID_ARGS`,`No active proxy device lease for this session; run open first.`)}return!t.flags.udid&&!t.flags.serial&&t.leaseBackend?{state:t.state,allocateBySpec:!0}:await I(t)}async function I(e){let t=await V(e.client,e.flags),n=x(t);return B(e.flags,n),{state:{...e.state,deviceKey:D(n),leaseBackend:e.state.leaseBackend??e.leaseBackend??n.leaseBackend,platform:n.platform,target:e.state.target??n.target,updatedAt:new Date().toISOString()}}}async function L(e){let{client:t,flags:n,materialized:r}=e,{lease:i,acquired:a}=r,o=ne(i.deviceKey);if(o)return a||await z(t,e.state,n,o),B(n,o),{state:{...e.state,deviceKey:D(o),platform:o.platform,target:e.state.target??o.target},materialized:r};if(!a)throw R(e.state,i);await t.leases.release({tenant:e.state.tenant,runId:e.state.runId,leaseId:i.leaseId,leaseBackend:i.backend,...E(i,e.state),deviceKey:i.deviceKey});let s=await I(e);return{state:s.state,materialized:await e.allocateByDeviceKey(s.state,n)}}function R(t,n){return new e(`UNAUTHORIZED`,`The active proxy lease names no device this client can use.`,{session:t.session,leaseId:n.leaseId,deviceKey:n.deviceKey,reason:`LEASE_SCOPE_MISMATCH`,hint:`Use a lease that names its device, or drop the lease id from the remote config and flags so open allocates one.`})}async function z(t,n,r,i){let a=r.device;if(!(!a&&!r.iosSimulatorDeviceSet&&!r.androidDeviceAllowlist)&&!(await t.devices.list({platform:i.platform,target:i.target,iosSimulatorDeviceSet:r.iosSimulatorDeviceSet,androidDeviceAllowlist:r.androidDeviceAllowlist})).some(e=>e.id===i.id&&(!a||c(e,a))))throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different device. Re-run connect --force to replace it.`,{session:n.session,deviceKey:D(i),requestedDevice:a,reason:`CONNECTION_DEVICE_CONFLICT`})}function B(e,t){e.platform=t.platform,e.target=t.target??e.target,t.identityFlag===`udid`&&(e.udid=t.id),t.identityFlag===`serial`&&(e.serial=t.id)}async function V(e,t){let n=await e.devices.list({platform:t.platform,target:t.target,device:t.device,udid:t.udid,serial:t.serial,iosSimulatorDeviceSet:t.iosSimulatorDeviceSet,androidDeviceAllowlist:t.androidDeviceAllowlist});return await o(n.map(e=>({...s(e.platform),id:e.id,name:e.name,kind:e.kind,target:e.target,booted:e.booted})),{platform:t.platform,target:t.target,deviceName:t.device,udid:t.udid,serial:t.serial})}const H=new Set([`artifacts`,`connect`,`connection`,`close`,`disconnect`,`metro`,`session`]),U=new Set([`open`]);async function fe(t){let{command:n,flags:i,client:a,host:o}=t;if(!i.remoteConfig)return{flags:i,runtime:t.runtime};let s=d(i.stateDir,{cwd:o.cwd,env:o.env}).baseDir,c=p({configPath:i.remoteConfig,cwd:o.cwd,env:o.env}),l={...ee(c.profile),...i,remoteConfig:c.resolvedPath},u=te({stateDir:s,session:l.session??`default`});if(u&&u.remoteConfigPath!==c.resolvedPath)throw new e(`INVALID_ARGS`,`A different remote connection is already active for this session. Run connect --force or disconnect before using a different --remote-config.`,{session:u.session,activeRemoteConfig:u.remoteConfigPath,requestedRemoteConfig:c.resolvedPath});await N(Fe(u,c.profile));let f=u??Ie(l,c.resolvedPath,c.profile),m={...l,session:f.session},h=P(f.leaseProvider).supportsDeferredAppSelection,g=h&&n===r.open?t.positionals?.[0]:void 0;h&&delete m.providerApp;let _=Pe(f.runtime,m.platform)??t.runtime,v=f,y=!u,b,x=be(v);if(x.shouldAllocate(n)){let e=await _e({command:n,client:a,state:f,nextState:v,nextFlags:m,initialApp:g,policy:x});v=e.state,y||=e.changed,b=e.acquiredLeaseForCleanup}let S=T({leaseBackend:v.leaseBackend,recordedPlatform:v.platform,requestedPlatform:m.platform});if(!S.ok)throw $({session:f.session,leaseBackend:v.leaseBackend,boundPlatform:S.boundPlatform,requestedPlatform:S.requestedPlatform,detail:`bound-connection`});v={...v,platform:S.platform},m.platform=S.platform;let C=await pe({command:n,flags:m,client:a,state:f,nextState:v,runtime:_,positionals:t.positionals,batchSteps:t.batchSteps,forceRuntimePrepare:t.forceRuntimePrepare});return v=C.state,_=C.runtime,y||=C.changed,await ge({changed:y,stateDir:s,state:v,client:a,acquiredLeaseForCleanup:b,preparedMetroCleanupOnFailure:C.preparedMetroCleanupOnFailure,metroCleanupToStop:C.metroCleanupToStop}),{flags:{...m,session:v.session,leaseId:v.leaseId,leaseBackend:v.leaseBackend,platform:v.platform??m.platform,target:v.target??m.target},runtime:_,connection:w(v)}}async function pe(t){let{command:n,flags:r,state:i,client:a}=t,o=me(t.nextState,r),s=t.runtime;if(!Me(n,r,t.batchSteps,t.positionals)||!X(r)||!he(t.forceRuntimePrepare,s,r.platform))return{state:o,runtime:s,changed:!1};if(!o.leaseId)throw new e(`INVALID_ARGS`,`${n} requires a resolved remote lease before Metro runtime can be prepared.`);let c=await Ee(r,a,i.remoteConfigPath,i.session,{tenantId:i.tenant,runId:i.runId,leaseId:o.leaseId}),l=!Ne(o.metro,c.cleanup);return o={...o,runtime:c.runtime,metro:c.cleanup,updatedAt:new Date().toISOString()},{state:o,runtime:c.runtime,changed:!0,metroCleanupToStop:l?t.nextState.metro:void 0,preparedMetroCleanupOnFailure:l?c.cleanup:void 0}}function me(e,t){return e.leaseId||!t.leaseId?e:{...e,leaseId:t.leaseId,leaseBackend:t.leaseBackend}}function he(e,t,n){return e===!0||!t||!Z(t,n)}async function ge(e){if(e.changed)try{re({stateDir:e.stateDir,state:e.state})}catch(t){throw await W(e.preparedMetroCleanupOnFailure),await je(e.client,e.state,e.acquiredLeaseForCleanup),t}await W(e.metroCleanupToStop)}async function _e(e){let{command:t,client:n,state:r,nextFlags:i,policy:a}=e,o=r.leaseBackend??J(i),s=e.nextState,c=await a.resolveLeaseState({command:t,client:n,state:s,flags:i,leaseBackend:o});s=c.state;let l=s.leaseBackend??o??Y(i,t);Le(r,l);let u=T({leaseBackend:l,recordedPlatform:s.platform,requestedPlatform:i.platform});if(!u.ok)throw $({session:r.session,leaseBackend:l,boundPlatform:u.boundPlatform,requestedPlatform:u.requestedPlatform,detail:`bound-connection`});Re(r,i),s={...s,platform:u.platform},i.platform=u.platform;let d=await Q(n,s,l,a,i,e.initialApp,c.allocateBySpec);if(c.allocateBySpec){let t=await L({client:n,state:s,flags:i,leaseBackend:l,materialized:d,allocateByDeviceKey:(t,r)=>Q(n,t,l,a,r,e.initialApp)});s=t.state,d=t.materialized}let f=d.lease;return i.leaseId=f.leaseId,i.leaseBackend=l,i.target=s.target??i.target,ve(s,f,l)?{state:s,changed:!1,acquiredLeaseForCleanup:d.acquired?f:void 0}:{state:ye(s,f,l,i),changed:!0,acquiredLeaseForCleanup:d.acquired?f:void 0}}function ve(e,t,n){return e.leaseId===t.leaseId&&e.leaseBackend===n&&e.deviceKey===(t.deviceKey??e.deviceKey)}function ye(e,t,n,r){let i=E(t,e);return{...e,leaseId:t.leaseId,leaseBackend:n,...i,platform:e.platform??r.platform,target:e.target??r.target,updatedAt:new Date().toISOString()}}function be(e){if(e.leaseBackend===`macos-app`)return we;let t=P(e.leaseProvider);return t.leaseKind===`proxy`?Ce:t.supportsDeferredAppSelection?xe:t.usesCloudWebDriverLease?Te:Se}const xe={shouldAllocate:e=>e!==r.apps&&!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async e=>({state:e.state})},Se={shouldAllocate:e=>!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async e=>({state:e.state})},Ce={shouldAllocate:e=>e!==`devices`&&!H.has(e),ttlMs:()=>3e5,newLeaseId:()=>O.randomBytes(16).toString(`hex`),resolveLeaseState:F},we={shouldAllocate:e=>e!==`devices`&&!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async({state:t})=>{if(!t.leaseId||!t.deviceKey)throw new e(`INVALID_ARGS`,`A macos-app connection needs the leaseId and deviceKey the host allocated in its remote config.`);return{state:{...t,platform:`macos`}}}},Te={shouldAllocate:e=>!H.has(e),ttlMs:()=>6e5,resolveLeaseState:async e=>({state:e.state})};async function Ee(t,n,r,i,a){if(!t.metroProjectRoot&&!t.metroPublicBaseUrl&&!t.metroProxyBaseUrl)return{};if(t.platform!==`ios`&&t.platform!==`android`)throw new e(`INVALID_ARGS`,`Deferred Metro preparation requires platform "ios" or "android".`);if(!t.metroPublicBaseUrl&&!t.metroProxyBaseUrl)throw new e(`INVALID_ARGS`,`Deferred Metro preparation requires metroPublicBaseUrl or metroProxyBaseUrl when Metro settings are provided.`);let o=await n.metro.prepare({projectRoot:t.metroProjectRoot,kind:l(t.metroKind),publicBaseUrl:t.metroPublicBaseUrl,proxyBaseUrl:t.metroProxyBaseUrl,bearerToken:t.metroBearerToken,bridgeScope:a,launchUrl:t.launchUrl,companionProfileKey:r,companionConsumerKey:i,port:t.metroPreparePort,listenHost:t.metroListenHost,statusHost:t.metroStatusHost,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return{runtime:t.platform===`ios`?o.iosRuntime:o.androidRuntime,cleanup:t.metroProxyBaseUrl?{projectRoot:o.projectRoot,profileKey:r,consumerKey:i}:void 0}}async function W(e){if(e)try{await f(e)}catch{}}function G(e){return e.leaseBackend===`macos-app`}async function K(e,t,n){return!t.leaseId||G(t)?{released:!1}:await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,daemonBaseUrl:t.daemon?.baseUrl,daemonAuthToken:n,daemonTransport:t.daemon?.transport,daemonServerMode:t.daemon?.serverMode,...w(t)})}function De(e){let t=Oe(e.previous,e.cwd,e.env);return t?{canAuthenticate:!0,daemonAuthToken:t}:e.previous.daemon?.baseUrl===e.nextDaemonBaseUrl?{canAuthenticate:!0,daemonAuthToken:e.ambientDaemonAuthToken}:{canAuthenticate:!1}}function Oe(e,t,n){try{let{profile:r}=m({configPath:e.remoteConfigPath,cwd:t,env:n});return r.daemonAuthToken&&ke(e,r.daemonBaseUrl)?r.daemonAuthToken:void 0}catch{return}}function ke(e,t){let n=S({daemonBaseUrl:t})?.baseUrl;return n!==void 0&&n===e.daemon?.baseUrl}async function Ae(e,t,n){if(!t.leaseId||G(t))return;let r=De({previous:t,nextDaemonBaseUrl:n.nextDaemonBaseUrl,ambientDaemonAuthToken:n.ambientDaemonAuthToken,cwd:n.cwd,env:n.env});if(!r.canAuthenticate)return q(t,`no credential known to belong to that endpoint was available`);try{await K(e,t,r.daemonAuthToken);return}catch{return q(t,`the release request failed`)}}function q(e,t){return{status:`unreleased`,message:`Could not release the previous lease ${e.leaseId} (tenant ${e.tenant}, run ${e.runId}) at ${e.daemon?.baseUrl??`its daemon`}: ${t}. It was left in place — release it manually if it is still active.`}}async function je(e,t,n){if(n)try{let r=E(t,n);await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:n.leaseId,leaseBackend:t.leaseBackend??n.backend,...r})}catch{}}function J(e){return e.leaseBackend??t(e.platform)}function Y(t,n){let r=J(t);if(r)return r;throw new e(`INVALID_ARGS`,`${n} requires --platform ios|android|harmonyos or --lease-backend when the remote connection has not resolved a lease yet.`)}function Me(e,t,n,r=[]){return e===`cdp`?b(r)&&!!t.metroPublicBaseUrl:U.has(e)?!0:e!==`batch`||!n?!1:n.some(e=>{let t=e.command.trim().toLowerCase();return U.has(t)&&e.runtime===void 0})}function X(e){let t=e.metroKind;return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||t)}function Z(e,t){return!e.platform||!t||!n(t)||e.platform===t}function Ne(e,t){return e?.projectRoot===t?.projectRoot&&e?.profileKey===t?.profileKey&&e?.consumerKey===t?.consumerKey}function Pe(e,t){if(e)return Z(e,t)?e:void 0}function Fe(e,t){return e?.leaseProvider??t.leaseProvider}function Ie(t,n,r={}){if(!t.tenant)throw new e(`INVALID_ARGS`,`remote command requires tenant in remote config or via --tenant <id>.`);if(!t.runId)throw new e(`INVALID_ARGS`,`remote command requires runId in remote config or via --run-id <id>.`);if(!t.daemonBaseUrl&&P(r.leaseProvider).requiresRemoteDaemon)throw new e(`INVALID_ARGS`,`remote command requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.`);let i=new Date().toISOString();return{version:1,session:t.session??`default`,remoteConfigPath:n,remoteConfigHash:C(n),daemon:S(t),tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend??J(t),leaseProvider:r.leaseProvider,clientId:r.clientId,deviceKey:r.deviceKey,platform:t.platform,target:t.target,connectedAt:i,updatedAt:i}}async function Q(t,n,r,i,a,o,s){let c=w(n);if(n.leaseId&&n.leaseBackend===r){let e=await ze(t,n.leaseId,{tenant:n.tenant,runId:n.runId,leaseBackend:r,...c,ttlMs:i.ttlMs(n)});if(e)return{lease:e,acquired:!1}}if(r===`macos-app`)throw new e(`UNAUTHORIZED`,`The host-allocated macos-app lease is no longer active.`,{reason:`LEASE_NOT_FOUND`,leaseId:n.leaseId,hint:`Ask the host for a new macos-app lease and update the remote config.`});return{lease:await t.leases.allocate({tenant:n.tenant,runId:n.runId,leaseId:i.newLeaseId?.(),leaseBackend:r,...c,...s?{deviceKey:void 0}:{},ttlMs:i.ttlMs(n),platform:n.platform??a.platform,target:n.target??a.target,device:a.device,udid:a.udid,serial:a.serial,iosSimulatorDeviceSet:a.iosSimulatorDeviceSet,androidDeviceAllowlist:a.androidDeviceAllowlist,providerApp:o??a.providerApp,providerOsVersion:a.providerOsVersion,providerDeviceType:a.providerDeviceType,providerProject:a.providerProject,providerBuild:a.providerBuild,providerSessionName:a.providerSessionName,...le(a),awsProjectArn:a.awsProjectArn,awsDeviceArn:a.awsDeviceArn,awsAppArn:a.awsAppArn,awsRegion:a.awsRegion,awsInteractionMode:a.awsInteractionMode}),acquired:!0}}function $(t){return new e(`INVALID_ARGS`,t.detail===`bound-connection`?`Active remote connection is already bound to a different platform. Re-run connect --force to replace it.`:`The requested platform does not match the device this lease backend rents.`,{session:t.session,leaseBackend:t.leaseBackend,platform:t.boundPlatform,requestedPlatform:t.requestedPlatform,reason:`CONNECTION_PLATFORM_CONFLICT`})}function Le(t,n){if(t.leaseBackend&&t.leaseBackend!==n)throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.`,{session:t.session,leaseBackend:t.leaseBackend})}function Re(t,n){if(t.target&&n.target&&t.target!==n.target)throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different target. Re-run connect --force to replace it.`,{session:t.session,target:t.target})}async function ze(e,t,n){try{return await e.leases.heartbeat({...n,leaseId:t})}catch(e){if(a(e))return;throw e}}export{N as a,$ as connectionPlatformConflict,X as hasDeferredMetroConfig,se as i,G as isHostAllocatedLease,fe as materializeRemoteConnectionForCommand,ce as n,ie as o,P as r,Ae as releasePreviousLease,K as releaseRemoteConnectionLease,J as resolveRequestedLeaseBackend,W as stopMetroCleanup,ue as t};
1
+ import{R as e,d as t,l as n}from"./sdk-contracts.js";import{E as r,T as i,dt as a}from"./back-mode.js";import{M as o,R as s,l as c}from"./sdk-device.js";import{m as l}from"./command-metadata.js";import{l as u}from"./file.js";import{m as d}from"./daemon-resolution.js";import{u as f}from"./src2.js";import{r as p,t as m}from"./remote-config-core.js";import"./remote-config2.js";import{i as h,n as g}from"./store.js";import{i as _,n as v,t as y}from"./builtin-provider-ids.js";import{C as b,S as ee,_ as te,b as x,c as S,f as C,h as ne,l as w,m as T,p as E,s as D,x as re}from"./cli.js";import{t as ie}from"./provider-plugin-catalog.js";import ae from"node:crypto";const O=new Map;async function oe(e,t=[]){if(O.has(u(e)))return;let{claimProviderIds:n,resolveProviderPlugins:r}=await import(`./registry.js`),i=await r([...n(t),...await h(e)]);O.set(u(e),{connections:i.connections,inventory:i.inventory()})}function se(e,t){return O.get(u(t))?.connections.get(e)}function k(e){return A(e).filter(e=>e.state===`failed`)}function A(e){return O.get(u(e))?.inventory??[]}function j(e,t){if(e===void 0)return;let n=O.get(u(t));return n?n.connections.get(e)?.capabilities:g(t).find(t=>t.agentDevicePlugin.provider===e)?.agentDevicePlugin.connection}function ce(e){let t=O.get(u(e));return t?[...t.connections.keys()]:g(e).filter(e=>e.agentDevicePlugin.connection).map(e=>e.agentDevicePlugin.provider)}function M(e){return{leaseKind:e,requiresAppAttachment:!1,requiresRemoteDaemon:!0,supportsArtifacts:!1,supportsDeferredAppSelection:!1,supportsDirectPortReverse:!1,usesCloudWebDriverLease:!1}}async function N(e,t=process.env){e===void 0||y.includes(e)||await oe(t,v)}function le(e,t=process.env){return e!==void 0&&(y.includes(e)||j(e,t)!==void 0)}function ue(e=process.env){let t=[...y,...ce(e)].join(`, `),n=k(e).map(({package:e,provider:t,error:n})=>`${e??t??`plugin store`}: ${n.message}`);return n.length===0?t:`${t}. Plugins that failed to load: ${n.join(`; `)}`}function de(t,n){let r=ie(t);if(!r)return;let i=A(n).find(e=>e.package===r.package||e.provider===t),a=k(n).filter(e=>e===i||e.package===void 0);if(i||a.length>0)return new e(`UNSUPPORTED_OPERATION`,`${r.label} plugin is unavailable.`,{reason:`plugin-unavailable`,provider:t,package:r.package,...a.length>0?{failedPlugins:a}:{},hint:`Run agent-device plugins list --json to inspect the plugin, fix its configuration or run agent-device plugins update ${r.package}, then retry your original command.`});let o=`agent-device plugins add ${r.package}`;return new e(`UNSUPPORTED_OPERATION`,`${r.label} requires the ${r.package} plugin.`,{reason:`plugin-not-installed`,provider:t,package:r.package,installCommand:o,hint:`Install:\n ${o}\nThen retry your original command. If a local daemon is already running, close its sessions and run agent-device daemon stop with the same --state-dir before retrying.`})}function P(e,t=process.env){return e===`proxy`?M(`proxy`):_(e)??(e===`cloud`?void 0:j(e,t))??M(`remote-provider`)}function fe(e){return{providerDeviceOrientation:e.providerDeviceOrientation,providerGeoLocation:e.providerGeoLocation,providerTimezone:e.providerTimezone,providerAppiumVersion:e.providerAppiumVersion,providerLanguage:e.providerLanguage,providerLocale:e.providerLocale,providerNetworkProfile:e.providerNetworkProfile,providerCustomNetwork:e.providerCustomNetwork,providerNoResignApp:e.providerNoResignApp}}function pe(e){return{metroProjectRoot:e.metroProjectRoot,metroKind:e.metroKind,metroPublicBaseUrl:e.metroPublicBaseUrl,metroProxyBaseUrl:e.metroProxyBaseUrl,metroPreparePort:e.metroPreparePort,metroListenHost:e.metroListenHost,metroStatusHost:e.metroStatusHost,metroStartupTimeoutMs:e.metroStartupTimeoutMs,metroProbeTimeoutMs:e.metroProbeTimeoutMs,metroRuntimeFile:e.metroRuntimeFile,metroNoReuseExisting:e.metroNoReuseExisting,metroNoInstallDeps:e.metroNoInstallDeps,launchUrl:e.launchUrl}}const F=new Set([r.open,r.install,r.reinstall,r.uninstall,i.installSource]);async function I(t){if(!F.has(t.command)){if(t.state.leaseId&&t.state.deviceKey)return{state:t.state};throw new e(`INVALID_ARGS`,`No active proxy device lease for this session; run open first.`)}return!t.flags.udid&&!t.flags.serial&&t.leaseBackend?{state:t.state,allocateBySpec:!0}:await L(t)}async function L(e){let t=await me(e.client,e.flags),n=x(t);return V(e.flags,n),{state:{...e.state,deviceKey:D(n),leaseBackend:e.state.leaseBackend??e.leaseBackend??n.leaseBackend,platform:n.platform,target:e.state.target??n.target,updatedAt:new Date().toISOString()}}}async function R(e){let{client:t,flags:n,materialized:r}=e,{lease:i,acquired:a}=r,o=ne(i.deviceKey);if(o)return a||await B(t,e.state,n,o),V(n,o),{state:{...e.state,deviceKey:D(o),platform:o.platform,target:e.state.target??o.target},materialized:r};if(!a)throw z(e.state,i);await t.leases.release({tenant:e.state.tenant,runId:e.state.runId,leaseId:i.leaseId,leaseBackend:i.backend,...E(i,e.state),deviceKey:i.deviceKey});let s=await L(e);return{state:s.state,materialized:await e.allocateByDeviceKey(s.state,n)}}function z(t,n){return new e(`UNAUTHORIZED`,`The active proxy lease names no device this client can use.`,{session:t.session,leaseId:n.leaseId,deviceKey:n.deviceKey,reason:`LEASE_SCOPE_MISMATCH`,hint:`Use a lease that names its device, or drop the lease id from the remote config and flags so open allocates one.`})}async function B(t,n,r,i){let a=r.device;if(!(!a&&!r.iosSimulatorDeviceSet&&!r.androidDeviceAllowlist)&&!(await t.devices.list({platform:i.platform,target:i.target,iosSimulatorDeviceSet:r.iosSimulatorDeviceSet,androidDeviceAllowlist:r.androidDeviceAllowlist})).some(e=>e.id===i.id&&(!a||o(e,a))))throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different device. Re-run connect --force to replace it.`,{session:n.session,deviceKey:D(i),requestedDevice:a,reason:`CONNECTION_DEVICE_CONFLICT`})}function V(e,t){e.platform=t.platform,e.target=t.target??e.target,t.identityFlag===`udid`&&(e.udid=t.id),t.identityFlag===`serial`&&(e.serial=t.id)}async function me(e,t){let n=await e.devices.list({platform:t.platform,target:t.target,device:t.device,udid:t.udid,serial:t.serial,iosSimulatorDeviceSet:t.iosSimulatorDeviceSet,androidDeviceAllowlist:t.androidDeviceAllowlist});return await s(n.map(e=>({...c(e.platform),id:e.id,name:e.name,kind:e.kind,target:e.target,booted:e.booted})),{platform:t.platform,target:t.target,deviceName:t.device,udid:t.udid,serial:t.serial})}const H=new Set([`artifacts`,`connect`,`connection`,`close`,`disconnect`,`metro`,`session`]),U=new Set([`open`]);async function he(t){let{command:n,flags:i,client:a,host:o}=t;if(!i.remoteConfig)return{flags:i,runtime:t.runtime};let s=d(i.stateDir,{cwd:o.cwd,env:o.env}).baseDir,c=p({configPath:i.remoteConfig,cwd:o.cwd,env:o.env}),l={...ee(c.profile),...i,remoteConfig:c.resolvedPath},u=te({stateDir:s,session:l.session??`default`});if(u&&u.remoteConfigPath!==c.resolvedPath)throw new e(`INVALID_ARGS`,`A different remote connection is already active for this session. Run connect --force or disconnect before using a different --remote-config.`,{session:u.session,activeRemoteConfig:u.remoteConfigPath,requestedRemoteConfig:c.resolvedPath});await N(Re(u,c.profile));let f=u??ze(l,c.resolvedPath,c.profile),m={...l,session:f.session},h=P(f.leaseProvider).supportsDeferredAppSelection,g=h&&n===r.open?t.positionals?.[0]:void 0;h&&delete m.providerApp;let _=Le(f.runtime,m.platform)??t.runtime,v=f,y=!u,b,x=Ce(v);if(x.shouldAllocate(n)){let e=await be({command:n,client:a,state:f,nextState:v,nextFlags:m,initialApp:g,policy:x});v=e.state,y||=e.changed,b=e.acquiredLeaseForCleanup}let S=T({leaseBackend:v.leaseBackend,recordedPlatform:v.platform,requestedPlatform:m.platform});if(!S.ok)throw $({session:f.session,leaseBackend:v.leaseBackend,boundPlatform:S.boundPlatform,requestedPlatform:S.requestedPlatform,detail:`bound-connection`});v={...v,platform:S.platform},m.platform=S.platform;let C=await ge({command:n,flags:m,client:a,state:f,nextState:v,runtime:_,positionals:t.positionals,batchSteps:t.batchSteps,forceRuntimePrepare:t.forceRuntimePrepare});return v=C.state,_=C.runtime,y||=C.changed,await ye({changed:y,stateDir:s,state:v,client:a,acquiredLeaseForCleanup:b,preparedMetroCleanupOnFailure:C.preparedMetroCleanupOnFailure,metroCleanupToStop:C.metroCleanupToStop}),{flags:{...m,session:v.session,leaseId:v.leaseId,leaseBackend:v.leaseBackend,platform:v.platform??m.platform,target:v.target??m.target},runtime:_,connection:w(v)}}async function ge(t){let{command:n,flags:r,state:i,client:a}=t,o=_e(t.nextState,r),s=t.runtime;if(!Ie(n,r,t.batchSteps,t.positionals)||!Y(r)||!ve(t.forceRuntimePrepare,s,r.platform))return{state:o,runtime:s,changed:!1};if(!o.leaseId)throw new e(`INVALID_ARGS`,`${n} requires a resolved remote lease before Metro runtime can be prepared.`);let c=await ke(r,a,i.remoteConfigPath,i.session,{tenantId:i.tenant,runId:i.runId,leaseId:o.leaseId}),l=!Z(o.metro,c.cleanup);return o={...o,runtime:c.runtime,metro:c.cleanup,updatedAt:new Date().toISOString()},{state:o,runtime:c.runtime,changed:!0,metroCleanupToStop:l?t.nextState.metro:void 0,preparedMetroCleanupOnFailure:l?c.cleanup:void 0}}function _e(e,t){return e.leaseId||!t.leaseId?e:{...e,leaseId:t.leaseId,leaseBackend:t.leaseBackend}}function ve(e,t,n){return e===!0||!t||!X(t,n)}async function ye(e){if(e.changed)try{re({stateDir:e.stateDir,state:e.state})}catch(t){throw await W(e.preparedMetroCleanupOnFailure),await Pe(e.client,e.state,e.acquiredLeaseForCleanup),t}await W(e.metroCleanupToStop)}async function be(e){let{command:t,client:n,state:r,nextFlags:i,policy:a}=e,o=r.leaseBackend??J(i),s=e.nextState,c=await a.resolveLeaseState({command:t,client:n,state:s,flags:i,leaseBackend:o});s=c.state;let l=s.leaseBackend??o??Fe(i,t);Be(r,l);let u=T({leaseBackend:l,recordedPlatform:s.platform,requestedPlatform:i.platform});if(!u.ok)throw $({session:r.session,leaseBackend:l,boundPlatform:u.boundPlatform,requestedPlatform:u.requestedPlatform,detail:`bound-connection`});Ve(r,i),s={...s,platform:u.platform},i.platform=u.platform;let d=await Q(n,s,l,a,i,e.initialApp,c.allocateBySpec);if(c.allocateBySpec){let t=await R({client:n,state:s,flags:i,leaseBackend:l,materialized:d,allocateByDeviceKey:(t,r)=>Q(n,t,l,a,r,e.initialApp)});s=t.state,d=t.materialized}let f=d.lease;return i.leaseId=f.leaseId,i.leaseBackend=l,i.target=s.target??i.target,xe(s,f,l)?{state:s,changed:!1,acquiredLeaseForCleanup:d.acquired?f:void 0}:{state:Se(s,f,l,i),changed:!0,acquiredLeaseForCleanup:d.acquired?f:void 0}}function xe(e,t,n){return e.leaseId===t.leaseId&&e.leaseBackend===n&&e.deviceKey===(t.deviceKey??e.deviceKey)}function Se(e,t,n,r){let i=E(t,e);return{...e,leaseId:t.leaseId,leaseBackend:n,...i,platform:e.platform??r.platform,target:e.target??r.target,updatedAt:new Date().toISOString()}}function Ce(e){if(e.leaseBackend===`macos-app`)return De;let t=P(e.leaseProvider);return t.leaseKind===`proxy`?Ee:t.supportsDeferredAppSelection?we:t.usesCloudWebDriverLease?Oe:Te}const we={shouldAllocate:e=>e!==r.apps&&!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async e=>({state:e.state})},Te={shouldAllocate:e=>!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async e=>({state:e.state})},Ee={shouldAllocate:e=>e!==`devices`&&!H.has(e),ttlMs:()=>3e5,newLeaseId:()=>ae.randomBytes(16).toString(`hex`),resolveLeaseState:I},De={shouldAllocate:e=>e!==`devices`&&!H.has(e),ttlMs:()=>void 0,resolveLeaseState:async({state:t})=>{if(!t.leaseId||!t.deviceKey)throw new e(`INVALID_ARGS`,`A macos-app connection needs the leaseId and deviceKey the host allocated in its remote config.`);return{state:{...t,platform:`macos`}}}},Oe={shouldAllocate:e=>!H.has(e),ttlMs:()=>6e5,resolveLeaseState:async e=>({state:e.state})};async function ke(t,n,r,i,a){if(!t.metroProjectRoot&&!t.metroPublicBaseUrl&&!t.metroProxyBaseUrl)return{};if(t.platform!==`ios`&&t.platform!==`android`)throw new e(`INVALID_ARGS`,`Deferred Metro preparation requires platform "ios" or "android".`);if(!t.metroPublicBaseUrl&&!t.metroProxyBaseUrl)throw new e(`INVALID_ARGS`,`Deferred Metro preparation requires metroPublicBaseUrl or metroProxyBaseUrl when Metro settings are provided.`);let o=await n.metro.prepare({projectRoot:t.metroProjectRoot,kind:l(t.metroKind),publicBaseUrl:t.metroPublicBaseUrl,proxyBaseUrl:t.metroProxyBaseUrl,bearerToken:t.metroBearerToken,bridgeScope:a,launchUrl:t.launchUrl,companionProfileKey:r,companionConsumerKey:i,port:t.metroPreparePort,listenHost:t.metroListenHost,statusHost:t.metroStatusHost,startupTimeoutMs:t.metroStartupTimeoutMs,probeTimeoutMs:t.metroProbeTimeoutMs,reuseExisting:!t.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!t.metroNoInstallDeps&&void 0,runtimeFilePath:t.metroRuntimeFile});return{runtime:t.platform===`ios`?o.iosRuntime:o.androidRuntime,cleanup:t.metroProxyBaseUrl?{projectRoot:o.projectRoot,profileKey:r,consumerKey:i}:void 0}}async function W(e){if(e)try{await f(e)}catch{}}function G(e){return e.leaseBackend===`macos-app`}async function K(e,t,n){return!t.leaseId||G(t)?{released:!1}:await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,daemonBaseUrl:t.daemon?.baseUrl,daemonAuthToken:n,daemonTransport:t.daemon?.transport,daemonServerMode:t.daemon?.serverMode,...w(t)})}function Ae(e){let t=je(e.previous,e.cwd,e.env);return t?{canAuthenticate:!0,daemonAuthToken:t}:e.previous.daemon?.baseUrl===e.nextDaemonBaseUrl?{canAuthenticate:!0,daemonAuthToken:e.ambientDaemonAuthToken}:{canAuthenticate:!1}}function je(e,t,n){try{let{profile:r}=m({configPath:e.remoteConfigPath,cwd:t,env:n});return r.daemonAuthToken&&Me(e,r.daemonBaseUrl)?r.daemonAuthToken:void 0}catch{return}}function Me(e,t){let n=S({daemonBaseUrl:t})?.baseUrl;return n!==void 0&&n===e.daemon?.baseUrl}async function Ne(e,t,n){if(!t.leaseId||G(t))return;let r=Ae({previous:t,nextDaemonBaseUrl:n.nextDaemonBaseUrl,ambientDaemonAuthToken:n.ambientDaemonAuthToken,cwd:n.cwd,env:n.env});if(!r.canAuthenticate)return q(t,`no credential known to belong to that endpoint was available`);try{await K(e,t,r.daemonAuthToken);return}catch{return q(t,`the release request failed`)}}function q(e,t){return{status:`unreleased`,message:`Could not release the previous lease ${e.leaseId} (tenant ${e.tenant}, run ${e.runId}) at ${e.daemon?.baseUrl??`its daemon`}: ${t}. It was left in place — release it manually if it is still active.`}}async function Pe(e,t,n){if(n)try{let r=E(t,n);await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:n.leaseId,leaseBackend:t.leaseBackend??n.backend,...r})}catch{}}function J(e){return e.leaseBackend??t(e.platform)}function Fe(t,n){let r=J(t);if(r)return r;throw new e(`INVALID_ARGS`,`${n} requires --platform ios|android|harmonyos or --lease-backend when the remote connection has not resolved a lease yet.`)}function Ie(e,t,n,r=[]){return e===`cdp`?b(r)&&!!t.metroPublicBaseUrl:U.has(e)?!0:e!==`batch`||!n?!1:n.some(e=>{let t=e.command.trim().toLowerCase();return U.has(t)&&e.runtime===void 0})}function Y(e){let t=e.metroKind;return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||t)}function X(e,t){return!e.platform||!t||!n(t)||e.platform===t}function Z(e,t){return e?.projectRoot===t?.projectRoot&&e?.profileKey===t?.profileKey&&e?.consumerKey===t?.consumerKey}function Le(e,t){if(e)return X(e,t)?e:void 0}function Re(e,t){return e?.leaseProvider??t.leaseProvider}function ze(t,n,r={}){if(!t.tenant)throw new e(`INVALID_ARGS`,`remote command requires tenant in remote config or via --tenant <id>.`);if(!t.runId)throw new e(`INVALID_ARGS`,`remote command requires runId in remote config or via --run-id <id>.`);if(!t.daemonBaseUrl&&P(r.leaseProvider).requiresRemoteDaemon)throw new e(`INVALID_ARGS`,`remote command requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.`);let i=new Date().toISOString();return{version:1,session:t.session??`default`,remoteConfigPath:n,remoteConfigHash:C(n),daemon:S(t),tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend??J(t),leaseProvider:r.leaseProvider,clientId:r.clientId,deviceKey:r.deviceKey,platform:t.platform,target:t.target,connectedAt:i,updatedAt:i}}async function Q(t,n,r,i,a,o,s){let c=w(n);if(n.leaseId&&n.leaseBackend===r){let e=await He(t,n.leaseId,{tenant:n.tenant,runId:n.runId,leaseBackend:r,...c,ttlMs:i.ttlMs(n)});if(e)return{lease:e,acquired:!1}}if(r===`macos-app`)throw new e(`UNAUTHORIZED`,`The host-allocated macos-app lease is no longer active.`,{reason:`LEASE_NOT_FOUND`,leaseId:n.leaseId,hint:`Ask the host for a new macos-app lease and update the remote config.`});return{lease:await t.leases.allocate({tenant:n.tenant,runId:n.runId,leaseId:i.newLeaseId?.(),leaseBackend:r,...c,...s?{deviceKey:void 0}:{},ttlMs:i.ttlMs(n),platform:n.platform??a.platform,target:n.target??a.target,device:a.device,udid:a.udid,serial:a.serial,iosSimulatorDeviceSet:a.iosSimulatorDeviceSet,androidDeviceAllowlist:a.androidDeviceAllowlist,providerApp:o??a.providerApp,providerOsVersion:a.providerOsVersion,providerDeviceType:a.providerDeviceType,providerProject:a.providerProject,providerBuild:a.providerBuild,providerSessionName:a.providerSessionName,...fe(a),awsProjectArn:a.awsProjectArn,awsDeviceArn:a.awsDeviceArn,awsAppArn:a.awsAppArn,awsRegion:a.awsRegion,awsInteractionMode:a.awsInteractionMode}),acquired:!0}}function $(t){return new e(`INVALID_ARGS`,t.detail===`bound-connection`?`Active remote connection is already bound to a different platform. Re-run connect --force to replace it.`:`The requested platform does not match the device this lease backend rents.`,{session:t.session,leaseBackend:t.leaseBackend,platform:t.boundPlatform,requestedPlatform:t.requestedPlatform,reason:`CONNECTION_PLATFORM_CONFLICT`})}function Be(t,n){if(t.leaseBackend&&t.leaseBackend!==n)throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.`,{session:t.session,leaseBackend:t.leaseBackend})}function Ve(t,n){if(t.target&&n.target&&t.target!==n.target)throw new e(`INVALID_ARGS`,`Active remote connection is already bound to a different target. Re-run connect --force to replace it.`,{session:t.session,target:t.target})}async function He(e,t,n){try{return await e.leases.heartbeat({...n,leaseId:t})}catch(e){if(a(e))return;throw e}}export{N as a,$ as connectionPlatformConflict,Y as hasDeferredMetroConfig,le as i,G as isHostAllocatedLease,he as materializeRemoteConnectionForCommand,ue as n,de as o,P as r,Ne as releasePreviousLease,K as releaseRemoteConnectionLease,J as resolveRequestedLeaseBackend,se as s,W as stopMetroCleanup,pe as t};
@@ -1,5 +1,5 @@
1
- import{B as e,R as t,d as n}from"./sdk-contracts.js";import"./back-mode.js";import{a as r}from"./version.js";import{m as i}from"./daemon-resolution.js";import{r as a}from"./remote-config-core.js";import"./remote-config2.js";import{c as o}from"./device-shell.js";import{f as s,n as c}from"./src3.js";import{n as l,r as u}from"./provider-profile-fields.js";import{n as d}from"./builtin-provider-ids.js";import{S as f,_ as p,c as m,d as h,f as g,g as ee,i as _,l as te,m as ne,o as re,p as ie,u as ae,v as oe,x as se,y as ce}from"./cli.js";import{n as v}from"./shared.js";import{a as y,connectionPlatformConflict as b,hasDeferredMetroConfig as le,i as x,n as ue,o as de,r as S,releasePreviousLease as fe,releaseRemoteConnectionLease as pe,resolveRequestedLeaseBackend as C,stopMetroCleanup as w,t as T}from"./connection-runtime.js";import{i as E,n as me,r as he}from"./provider-limrun-credentials.js";import{t as ge}from"./provider-webdriver.js";import D from"node:crypto";import O from"node:fs";import k from"node:path";const A=new Set([`daemonAuthToken`,`metroBearerToken`]);function j(e){let t=I(P(e.profile)),n=k.join(e.stateDir,`remote-connections`,`generated`);O.mkdirSync(n,{recursive:!0,mode:448});let r=k.join(n,`${L(e.provider)}-${F(t)}.json`);O.writeFileSync(r,`${JSON.stringify(t,null,2)}\n`,{mode:384});try{O.chmodSync(r,384)}catch{}return r}function M(n){try{return a(n)}catch(r){let i=e(r);throw new t(`COMMAND_FAILED`,`${n.provider} connection profile returned invalid remote config.`,{generatedConfigPath:n.configPath,cause:i.message},i)}}function N(e){let t=M({configPath:j({stateDir:e.stateDir,provider:e.provider,profile:e.profile}),cwd:e.cwd,env:e.env,provider:_e(e.provider)});return{flags:{...f(t.profile),...e.flags,...e.extraFlags??{},remoteConfig:t.resolvedPath},remoteConfigPath:t.resolvedPath}}function P(e){return Object.fromEntries(Object.entries(e).filter(([e])=>!A.has(e)))}function F(e){return D.createHash(`sha256`).update(JSON.stringify(e)).digest(`hex`).slice(0,16)}function I(e){return Array.isArray(e)?e.map(I):e&&typeof e==`object`?Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>[e,I(t)])):e}function L(e){return e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`)||`generated`}function _e(e){let[t=``,...n]=e;return`${t.toUpperCase()}${n.join(``)}`}function R(...e){return D.createHash(`sha256`).update(e.map(e=>e??``).join(`\0`)).digest(`hex`).slice(0,16)}async function ve(e){let t=await _({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{fetch:e.fetchImpl}}),n=await ye({cloudBaseUrl:t.cloudBaseUrl,accessToken:t.accessToken,fetchImpl:e.fetchImpl}),r=R(e.stateDir,t.cloudBaseUrl,typeof n.daemonBaseUrl==`string`?n.daemonBaseUrl:``,e.flags.session);return N({stateDir:e.stateDir,provider:`cloud`,profile:{...n,leaseProvider:n.leaseProvider??`cloud`,clientId:n.clientId??r,runId:n.runId??`cloud-${r}`},cwd:e.cwd,env:e.env,flags:e.flags,extraFlags:{daemonAuthToken:t.accessToken}})}async function ye(e){let t=await(e.fetchImpl??fetch)(new URL(`/api/control-plane/connection-profile`,e.cloudBaseUrl),{method:`GET`,headers:{authorization:`Bearer ${e.accessToken}`},signal:AbortSignal.timeout(15e3)});return be(await re(t,{invalidJsonMessage:`Cloud connection profile endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud connection profile endpoint rejected the request.`}))}function be(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`COMMAND_FAILED`,`Cloud connection profile response is invalid.`);let n=e.connection;if(!n||typeof n!=`object`)throw new t(`COMMAND_FAILED`,`Cloud connection profile response is missing profile.`);if(n.remoteConfigProfile!==void 0)return xe(n.remoteConfigProfile);throw new t(`COMMAND_FAILED`,`Cloud connection profile did not include remoteConfigProfile.`)}function xe(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`COMMAND_FAILED`,`Cloud connection profile remoteConfigProfile is invalid.`);if(Object.keys(e).length===0)throw new t(`COMMAND_FAILED`,`Cloud connection profile remoteConfigProfile is empty.`);return e}function Se(e){let{env:n}=e,r=Ce({flags:e.flags,cwd:e.cwd,env:n}),i=E(n),a=he(r.leaseBackend)??`android`;if(!i?.apiKey&&!i?.instances?.[a])throw new t(`INVALID_ARGS`,`connect limrun requires LIMRUN_API_KEY, or ${me(a).join(`, `)} for an existing instance.`,{hint:`Set the credentials in the environment before running agent-device connect limrun.`});return N({stateDir:e.stateDir,provider:`limrun`,profile:r,cwd:e.cwd,env:n,flags:e.flags})}function Ce(e){let t=e.flags,n=we(t);return{stateDir:i(t.stateDir,{cwd:e.cwd,env:e.env}).baseDir,daemonTransport:`auto`,tenant:t.tenant??`limrun`,runId:t.runId??`cli-${Date.now().toString(36)}`,sessionIsolation:`tenant`,leaseBackend:n,leaseProvider:`limrun`,platform:t.platform,target:`mobile`,session:t.session,...T(t)}}function we(e){if(l(e,s),e.platform!==`android`&&e.platform!==`ios`)throw new t(`INVALID_ARGS`,`connect limrun requires --platform ios or android.`);if(e.device!==void 0)throw new t(`INVALID_ARGS`,`connect limrun does not accept --device; Limrun selects a remote simulator or emulator.`);let n=C(e),r=e.platform===`ios`?`ios-instance`:`android-instance`;if(n!==r)throw new t(`INVALID_ARGS`,`connect limrun --platform ${e.platform} requires --lease-backend ${r}.`);return r}function Te(e){let n=e.flags.daemonBaseUrl??e.env.AGENT_DEVICE_DAEMON_BASE_URL;if(!n)throw new t(`INVALID_ARGS`,`connect proxy requires --daemon-base-url <url> or AGENT_DEVICE_DAEMON_BASE_URL.`);let r=R(e.stateDir,n,e.flags.session),i={daemonBaseUrl:n,daemonTransport:e.flags.daemonTransport??`http`,daemonServerMode:e.flags.daemonServerMode,tenant:e.flags.tenant??`proxy`,sessionIsolation:e.flags.sessionIsolation??`tenant`,runId:e.flags.runId??`proxy-${r}`,leaseProvider:`proxy`,clientId:r,leaseBackend:e.flags.leaseBackend??C(e.flags),platform:e.flags.platform,target:e.flags.target,device:e.flags.device,udid:e.flags.udid,serial:e.flags.serial,iosSimulatorDeviceSet:e.flags.iosSimulatorDeviceSet,androidDeviceAllowlist:e.flags.androidDeviceAllowlist,session:e.flags.session,...T(e.flags)};return N({stateDir:e.stateDir,provider:`proxy`,profile:i,cwd:e.cwd,env:e.env,flags:e.flags,extraFlags:{daemonBaseUrl:n,daemonTransport:e.flags.daemonTransport??`http`}})}async function Ee(e,n,r,i){let a=de(e,r);if(a)return await i(a);let[{claimProviderIds:o,resolveProviderPlugins:s},{storePluginCandidates:c}]=await Promise.all([import(`./registry.js`),import(`./store.js`).then(e=>e.a)]),l=await s([...o(n),...await c(r)]),u=l.connections.get(e);if(!u){let n=l.inventory().find(t=>t.provider===e);throw new t(`INVALID_ARGS`,n?.error?`Plugin ${e} failed to load: ${n.error.message}`:`Plugin does not register connect: ${e}`,n?.error?.reason?{reason:n.error.reason,provider:e}:{provider:e})}return await i(u)}const z={cloud:{resolve:ve,verify:async()=>({service:`the configured cloud service`,status:`verified`,verificationMessage:`Credentials and connection profile verified.`})},proxy:{resolve:Te,verify:async()=>({service:`Agent Device Proxy`,status:`configured`,verificationMessage:`Proxy configuration saved. Access is checked by the first remote command.`})},limrun:{resolve:Se,verify:Ae}};function B(e){return Object.hasOwn(z,e)?z[e]:void 0}async function V(e,t,n){let r=ge(e,t);return r?await n(r):await Ee(e,d,t,n)}async function De(e){let{cwd:t,env:n}=e;if(e.flags.remoteConfig){let r=a({configPath:e.flags.remoteConfig,cwd:t,env:n}),i=r.profile.leaseProvider;return await y(i,n),{flags:{...f(r.profile),...e.flags,remoteConfig:r.resolvedPath},remoteConfigPath:r.resolvedPath,...x(i,n)?{provider:i}:{}}}let r=e.provider??(je(e.flags)?`proxy`:`cloud`),i={flags:e.flags,stateDir:e.stateDir,cwd:t,env:n},o=B(r);return{...o?await o.resolve(i):await V(r,n,async e=>await Oe(r,e,i)),provider:r}}async function Oe(e,r,i){let a=await r.resolve(i);if(a.profile.leaseProvider!==e)throw new t(`INVALID_ARGS`,`Provider connection profile must select its declared provider: ${e}`);let o=R(e,i.stateDir,i.flags.session,a.profile.device);return N({...i,...a,provider:e,profile:{tenant:i.flags.tenant??e,sessionIsolation:i.flags.sessionIsolation??`tenant`,runId:i.flags.runId??`${e}-${o}`,clientId:o,target:i.flags.target??`mobile`,session:i.flags.session,stateDir:i.stateDir,leaseBackend:i.flags.leaseBackend??n(a.profile.platform),...T(i.flags),...a.profile}})}async function ke(e,t){if(!e.provider)return{service:`remote provider`,status:`configured`,verificationMessage:`Remote connection profile loaded. Access is checked by the first remote command.`};let n={flags:e.flags,env:t},r=B(e.provider);return r?await r.verify(n):await V(e.provider,n.env,async e=>await e.verify(n))}async function Ae(e){return await c({...E(e.env),clientVersion:r(),platform:u(e.flags.platform,`Limrun`)})}function je(e){if(!e.daemonBaseUrl||e.tenant||e.runId||e.leaseId||e.leaseBackend)return!1;try{return new URL(e.daemonBaseUrl).pathname.replace(/\/+$/,``).endsWith(`/agent-device`)}catch{return!1}}function Me(e){let{stateDir:t,flags:n,remoteConfigPath:r}=e,i=n.session??Ne();return{session:i,previous:n.session?p({stateDir:t,session:i}):null,remoteConfigHash:g(r),daemon:m(n)}}function Ne(){return`adc-${D.randomBytes(16).toString(`hex`)}`}function H(e,t){if(e.leaseId)return;let n=S(e.leaseProvider),r=n.leaseKind;if(r===`proxy`)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. Run devices to inspect inventory without allocating, then open when ready.`};if(n.supportsDeferredAppSelection)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. Run apps to inspect uploaded assets without allocating; open <uploaded-asset-name> creates the instance.`};if(r===`direct-device-provider`)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. The first device command shown below will allocate one.`};let i=e.platform===void 0&&e.leaseBackend===void 0?` Add --platform ios|android if the profile does not set a platform.`:``;return{status:`deferred`,nextSteps:K(e,[`agent-device install-from-source <artifact-url> --platform ios|android`,`agent-device open <app-id> --relaunch`,`agent-device snapshot -i`,`agent-device devices`]),message:`No live device session has been created. Run a device command when ready to allocate or refresh the lease.`+i}}function Pe(e,t){return{...t,preparationMessage:H(e,t)?.message??`No live device session has been created.`,...W(e,t)}}function Fe(e){let{state:t,readiness:n,runtimePreparation:r,previousLeaseNotice:i}=e;if(!n){let e=H(t);return[`Configured remote session "${t.session}" tenant "${t.tenant}" run "${t.runId}"${t.leaseId?` lease ${t.leaseId}`:``}.`,e?.message,r?.message,i?.message].filter(e=>!!e).join(`
2
- `)}let a=G(n),o=[`${a===`verified`?`Connected`:`Configured`} successfully with ${n.service}.`,`${a===`verified`?`Verified`:`Status`}: ${n.verificationMessage}`];return n.project&&o.push(`Project: ${n.project.name??n.project.reference} — verified`),n.device&&o.push(ze(n.device)),n.app&&o.push(Be(t,n.app)),o.push(n.preparationMessage),o.push(`Next:`),o.push(...n.nextSteps.map(e=>` ${e}`)),o.push(...n.notes??[]),r&&o.push(r.message),i&&o.push(i.message),o.join(`
3
- `)}function U(e){let{state:t,runtimePreparation:n,readiness:r,previousLeaseNotice:i}=e,a=H(t,r);return{connected:!0,session:t.session,tenant:t.tenant,runId:t.runId,leaseAllocated:!!t.leaseId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:t.leaseProvider,platform:t.platform,target:t.target,remoteConfig:t.remoteConfigPath,remoteConfigHash:t.remoteConfigHash,daemonBaseUrlFingerprint:h(t.daemon?.baseUrl),liveSession:Ie(t),...Le(r,a),metro:t.metro?{prepared:!0,projectRoot:t.metro.projectRoot}:{prepared:!1},...Re({leasePreparation:a,runtimePreparation:n,previousLeaseNotice:i}),connectedAt:t.connectedAt,updatedAt:t.updatedAt}}function Ie(e){return{status:e.leaseId?`created`:`not-created`,...e.leaseId?{leaseId:e.leaseId}:{}}}function Le(e,t){return e?{verification:{status:G(e),service:e.service,message:e.verificationMessage,...e.project?{project:e.project}:{}},...e.device?{device:e.device}:{},...e.app?{app:e.app}:{},nextSteps:e.nextSteps??t?.nextSteps??[],...e.notes?{notes:e.notes}:{}}:{}}function Re(e){let{leasePreparation:t,runtimePreparation:n,previousLeaseNotice:r}=e;return{...t?{leasePreparation:t}:{},...n?{runtimePreparation:n}:{},...r?{previousLeaseNotice:r}:{}}}function ze(e){let t=`osVersion`in e?e.osVersion:void 0,n=[e.platform,t].filter(Boolean).join(` `),r=n?` (${n})`:``;return e.status===`deferred`?`Device: ${e.name??`Provider-selected device`} — allocated on first device command`:`Device: ${e.name??e.reference??`Configured device`}${r} — verified`}function Be(e,t){return t.status===`missing`?`App: ${Ye(e)} — ${t.message??`Install or attach an app before open.`}`:`App: ${t.name??t.reference??`configured app`} — ${t.status===`verified`?`verified`:t.message??`configured`}`}function W(e,t){let n=Ve(e,t);return{...n,nextSteps:K(e,n.nextSteps)}}function Ve(e,t){let n=S(e.leaseProvider).leaseKind;if(n===`proxy`)return{nextSteps:[`agent-device devices`,`agent-device open ${J(e.platform)} --relaunch`]};if(!t&&n===`direct-device-provider`)return{nextSteps:Je()};if(S(t?.provider).supportsDeferredAppSelection)return{nextSteps:[`agent-device apps`,`agent-device open <uploaded-asset-name>`]};let r=t?.app?.status===`missing`;return{nextSteps:He(t)?qe(e):[...We(t),...Ke(e).nextSteps],...Ue(t)?{notes:Ge(e,!r)}:{}}}function He(e){return e?.app?.status===`missing`&&e.device?.status===`deferred`}function Ue(e){return S(e?.provider).supportsArtifacts}function We(e){return e?.app?.status!==`missing`||!e.project?.reference||!e.device?.reference?[]:[`agent-device connect aws-device-farm --platform ${e.device.platform} --aws-project-arn ${e.project.reference} --aws-device-arn ${e.device.reference} --aws-app-arn <arn> --force`]}function Ge(e,t){return[...t?[`Use the installed package or bundle identifier in open, not the app artifact name.`]:[],`After close, run ${q(e,`agent-device artifacts --json`)} for provider video and logs.`]}function Ke(e){return{nextSteps:[`agent-device open ${J(e.platform)} --relaunch`]}}function qe(e){let t=J(e.platform);return[`agent-device install ${t} <app-path-or-url>`,`agent-device open ${t} --relaunch`]}function G(e){return`status`in e?e.status:`verified`}function Je(){return[`agent-device open <package-or-bundle-id> --relaunch`,`agent-device snapshot -i`,`agent-device close`,`agent-device artifacts --json`]}function K(e,t){return t.map(t=>q(e,t))}function q(e,t){return`${t} --session ${o(e.session)}`}function J(e){return e===`ios`?`<bundle-id>`:`<package-id>`}function Ye(e){let t=S(e.leaseProvider);return t.requiresAppAttachment?`not attached`:t.supportsDeferredAppSelection?`not installed yet`:`not available`}const Xe=async({positionals:e,flags:t,client:n,host:r})=>{let a=i(t.stateDir,{cwd:r.cwd,env:r.env}).baseDir;await y(e[0]);let o=pt(e);Ze(o,t);let s=await De({provider:o,flags:t,stateDir:a,cwd:r.cwd,env:r.env}),c=s.flags,l=ot(s.remoteConfigPath,r),u=Qe(c,l),d=Me({stateDir:a,flags:c,remoteConfigPath:s.remoteConfigPath});$e(d.previous,{flags:c,session:d.session,remoteConfigPath:s.remoteConfigPath,remoteConfigHash:d.remoteConfigHash,desiredLeaseBackend:C(c),connection:l,daemon:d.daemon});let f=await ke(s,r.env),p=et({flags:c,scope:u,connectionMetadata:l,context:d,remoteConfigPath:s.remoteConfigPath});se({stateDir:a,state:p});let m=await at(n,c,d.previous,p,r),h=vt(c,p,r),g=Pe(p,f);return await v(c,U({state:p,runtimePreparation:h,readiness:g,previousLeaseNotice:m}),()=>Fe({state:p,runtimePreparation:h,readiness:g,previousLeaseNotice:m})),!0};function Ze(e,n){if(!(!e||!n.remoteConfig))throw new t(`INVALID_ARGS`,`connect provider positional and --remote-config are mutually exclusive.`)}function Qe(e,n){if(!e.tenant)throw new t(`INVALID_ARGS`,`connect requires tenant in remote config or via --tenant <id>.`);if(!e.runId)throw new t(`INVALID_ARGS`,`connect requires runId in remote config or via --run-id <id>.`);if(!e.daemonBaseUrl&&S(n?.leaseProvider).requiresRemoteDaemon)throw new t(`INVALID_ARGS`,`connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.`);return{tenant:e.tenant,runId:e.runId}}function $e(e,n){if(!(!e||mt(e,n))&&!n.flags.force)throw new t(`INVALID_ARGS`,`A different remote connection is already active for this session. Re-run connect with --force to replace it.`,{session:n.session,remoteConfig:e.remoteConfigPath})}function et(e){let{flags:t,scope:n,connectionMetadata:r,context:i,remoteConfigPath:a}=e,o=it(t,i.previous)?i.previous:null,s=new Date().toISOString(),c=tt(t,o,r),l=rt(t,o,s,c,i.session);return{version:1,session:i.session,remoteConfigPath:a,remoteConfigHash:i.remoteConfigHash,daemon:i.daemon,tenant:n.tenant,runId:n.runId,...c,...l,updatedAt:s}}function tt(e,t,n){let r=ie(n??{},t??{}),i=t?.leaseBackend??C(e);return i===`macos-app`?nt(e,t,r):{leaseId:t?.leaseId,leaseBackend:i,...r,deviceKey:t?.deviceKey??r.deviceKey}}function nt(e,t,n){return{leaseId:e.leaseId??t?.leaseId,leaseBackend:`macos-app`,...n}}function rt(e,t,n,r,i){let a=ne({leaseBackend:r.leaseBackend,recordedPlatform:t?.platform,requestedPlatform:e.platform});if(!a.ok)throw b({session:i,leaseBackend:r.leaseBackend,boundPlatform:a.boundPlatform,requestedPlatform:a.requestedPlatform,detail:t?`bound-connection`:`requested-backend`});return{platform:a.platform,target:e.target??t?.target,runtime:t?.runtime,metro:t?.metro,connectedAt:t?.connectedAt??n}}function it(e,t){return!!(t&&!e.force)}async function at(e,t,n,r,i){if(!(!n||!t.force)&&(await w(n.metro),!(n.leaseId&&n.leaseId===r.leaseId)))return await fe(e,n,{nextDaemonBaseUrl:r.daemon?.baseUrl,ambientDaemonAuthToken:t.daemonAuthToken,cwd:i.cwd,env:i.env})}function ot(e,t){let n=a({configPath:e,cwd:t.cwd,env:t.env}).profile;return te(n)}const st=async({flags:e,client:t,host:n})=>{let{session:r,stateDir:i,state:a}=Y(e,n);if(!a)return await X(e,r),!0;let o=a.session,s;if(a.leaseId||a.runtime||a.metro)try{s=(await t.sessions.close({session:o,shutdown:e.shutdown})).provider}catch{}await w(a.metro);let c=!1;if(a.leaseId)try{let n=await pe(t,a,e.daemonAuthToken);c=n.released,s??=n.provider}catch{}return ce({stateDir:i,session:o}),await v(e,{connected:!1,session:o,released:c,...s?{provider:s}:{}},()=>lt(o,s)),!0},ct=async({positionals:e,flags:n,host:r})=>{if(e[0]!==`status`)throw new t(`INVALID_ARGS`,`connection accepts only: status`);let{session:i,state:a}=Y(n,r);if(!a)return await X(n,i),!0;await y(a.leaseProvider);let o=H(a),s=yt(a,r);return await v(n,U({state:a,runtimePreparation:s}),()=>[`Configured remote session "${a.session}".`,`tenant=${a.tenant} runId=${a.runId} leaseId=${a.leaseId??`pending`} backend=${a.leaseBackend??`pending`}`,`remoteConfig=${a.remoteConfigPath}`,a.runtime?`metro=prepared`:`metro=not-prepared`,o?.message,s?.message].filter(e=>!!e).join(`
4
- `)),!0};function lt(e,t){return[`Disconnected remote session "${e}".`,...ut(t),...ft(t?.cloudArtifacts?.cloudArtifacts)].join(`
5
- `)}function ut(e){return(Array.isArray(e?.warnings)?e.warnings:[]).flatMap(e=>{let t=dt(e);return t?[t]:[]})}function dt(e){if(!e||typeof e!=`object`)return;let t=e;if(typeof t.message==`string`&&t.message.length!==0)return`Provider release warning${typeof t.code==`string`&&t.code.length>0?` (${t.code})`:``}: ${t.message}`}function ft(e){return(e??[]).filter(e=>(e.availability??`ready`)===`ready`&&e.url).slice(0,3).map(e=>`${e.name}: ${e.url}`)}function pt(e){let n=e[0];if(n!==void 0){if(e.length>1)throw new t(`INVALID_ARGS`,`connect accepts at most one provider positional.`);if(x(n))return n;throw new t(`INVALID_ARGS`,`Unknown connect provider: ${n}. Supported providers: ${ue()}.`)}}function Y(e,t){let n=e.session??`default`,r=i(e.stateDir,{cwd:t.cwd,env:t.env}).baseDir;return{session:n,stateDir:r,state:p({stateDir:r,session:n})??(e.session?null:ee({stateDir:r}))}}async function X(e,t){await v(e,{connected:!1,session:t},()=>`No remote connection for "${t}".`)}function mt(e,t){return Z(e,t)&&ht(e,t)&&_t(e.daemon,t.daemon)}function Z(e,t){return[[e.remoteConfigPath,t.remoteConfigPath],[e.remoteConfigHash,t.remoteConfigHash],[e.session,t.session],[e.tenant,t.flags.tenant],[e.runId,t.flags.runId]].every(([e,t])=>e===t)}function ht(e,t){return ae(e,t.flags.platform)?[[e.leaseBackend,t.desiredLeaseBackend],[e.target,t.flags.target]].every(([e,t])=>t===void 0||e===t)&&gt(e,t.flags.leaseId)&&oe(e,t.connection):!1}function gt(e,t){return e.leaseBackend!==`macos-app`||t===void 0||t===e.leaseId}function _t(e,t){return[`baseUrl`,`transport`,`serverMode`].every(n=>(e?.[n]??void 0)===(t?.[n]??void 0))}function vt(e,t,n){if(!t.runtime&&!(!le(e)&&!$(t.remoteConfigPath,n)))return Q(t)}function yt(e,t){if(!(e.runtime||!$(e.remoteConfigPath,t)))return Q(e)}function Q(e){let t=q(e,`agent-device metro prepare --remote-config ${o(e.remoteConfigPath)}`);return{status:`deferred`,nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function $(e,t){try{let n=a({configPath:e,cwd:t.cwd,env:t.env}).profile;return!!(n.metroPublicBaseUrl||n.metroProxyBaseUrl||n.metroProjectRoot||n.metroKind)}catch{return!1}}export{Xe as connectCommand,ct as connectionCommand,st as disconnectCommand};
1
+ import{R as e,V as t,d as n}from"./sdk-contracts.js";import"./back-mode.js";import{a as r}from"./version.js";import{m as i}from"./daemon-resolution.js";import{r as a}from"./remote-config-core.js";import"./remote-config2.js";import{c as o}from"./device-shell.js";import{f as s,n as c}from"./src3.js";import{n as l,r as u}from"./provider-profile-fields.js";import{n as d}from"./builtin-provider-ids.js";import{S as f,_ as p,c as m,d as h,f as g,g as _,i as v,l as ee,m as te,o as ne,p as re,u as ie,v as ae,x as oe,y as se}from"./cli.js";import{n as y}from"./shared.js";import{a as b,connectionPlatformConflict as x,hasDeferredMetroConfig as ce,i as S,n as le,o as ue,r as C,releasePreviousLease as de,releaseRemoteConnectionLease as fe,resolveRequestedLeaseBackend as w,s as pe,stopMetroCleanup as T,t as E}from"./connection-runtime.js";import{i as D,n as me,r as he}from"./provider-limrun-credentials.js";import{t as ge}from"./provider-webdriver.js";import O from"node:crypto";import k from"node:fs";import A from"node:path";const j=new Set([`daemonAuthToken`,`metroBearerToken`]);function M(e){let t=L(F(e.profile)),n=A.join(e.stateDir,`remote-connections`,`generated`);k.mkdirSync(n,{recursive:!0,mode:448});let r=A.join(n,`${_e(e.provider)}-${I(t)}.json`);k.writeFileSync(r,`${JSON.stringify(t,null,2)}\n`,{mode:384});try{k.chmodSync(r,384)}catch{}return r}function N(n){try{return a(n)}catch(r){let i=t(r);throw new e(`COMMAND_FAILED`,`${n.provider} connection profile returned invalid remote config.`,{generatedConfigPath:n.configPath,cause:i.message},i)}}function P(e){let t=N({configPath:M({stateDir:e.stateDir,provider:e.provider,profile:e.profile}),cwd:e.cwd,env:e.env,provider:ve(e.provider)});return{flags:{...f(t.profile),...e.flags,...e.extraFlags??{},remoteConfig:t.resolvedPath},remoteConfigPath:t.resolvedPath}}function F(e){return Object.fromEntries(Object.entries(e).filter(([e])=>!j.has(e)))}function I(e){return O.createHash(`sha256`).update(JSON.stringify(e)).digest(`hex`).slice(0,16)}function L(e){return Array.isArray(e)?e.map(L):e&&typeof e==`object`?Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>[e,L(t)])):e}function _e(e){return e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`)||`generated`}function ve(e){let[t=``,...n]=e;return`${t.toUpperCase()}${n.join(``)}`}function R(...e){return O.createHash(`sha256`).update(e.map(e=>e??``).join(`\0`)).digest(`hex`).slice(0,16)}async function ye(e){let t=await v({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{fetch:e.fetchImpl}}),n=await be({cloudBaseUrl:t.cloudBaseUrl,accessToken:t.accessToken,fetchImpl:e.fetchImpl}),r=R(e.stateDir,t.cloudBaseUrl,typeof n.daemonBaseUrl==`string`?n.daemonBaseUrl:``,e.flags.session);return P({stateDir:e.stateDir,provider:`cloud`,profile:{...n,leaseProvider:n.leaseProvider??`cloud`,clientId:n.clientId??r,runId:n.runId??`cloud-${r}`},cwd:e.cwd,env:e.env,flags:e.flags,extraFlags:{daemonAuthToken:t.accessToken}})}async function be(e){let t=await(e.fetchImpl??fetch)(new URL(`/api/control-plane/connection-profile`,e.cloudBaseUrl),{method:`GET`,headers:{authorization:`Bearer ${e.accessToken}`},signal:AbortSignal.timeout(15e3)});return xe(await ne(t,{invalidJsonMessage:`Cloud connection profile endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud connection profile endpoint rejected the request.`}))}function xe(t){if(!t||typeof t!=`object`||Array.isArray(t))throw new e(`COMMAND_FAILED`,`Cloud connection profile response is invalid.`);let n=t.connection;if(!n||typeof n!=`object`)throw new e(`COMMAND_FAILED`,`Cloud connection profile response is missing profile.`);if(n.remoteConfigProfile!==void 0)return Se(n.remoteConfigProfile);throw new e(`COMMAND_FAILED`,`Cloud connection profile did not include remoteConfigProfile.`)}function Se(t){if(!t||typeof t!=`object`||Array.isArray(t))throw new e(`COMMAND_FAILED`,`Cloud connection profile remoteConfigProfile is invalid.`);if(Object.keys(t).length===0)throw new e(`COMMAND_FAILED`,`Cloud connection profile remoteConfigProfile is empty.`);return t}function Ce(t){let{env:n}=t,r=we({flags:t.flags,cwd:t.cwd,env:n}),i=D(n),a=he(r.leaseBackend)??`android`;if(!i?.apiKey&&!i?.instances?.[a])throw new e(`INVALID_ARGS`,`connect limrun requires LIMRUN_API_KEY, or ${me(a).join(`, `)} for an existing instance.`,{hint:`Set the credentials in the environment before running agent-device connect limrun.`});return P({stateDir:t.stateDir,provider:`limrun`,profile:r,cwd:t.cwd,env:n,flags:t.flags})}function we(e){let t=e.flags,n=Te(t);return{stateDir:i(t.stateDir,{cwd:e.cwd,env:e.env}).baseDir,daemonTransport:`auto`,tenant:t.tenant??`limrun`,runId:t.runId??`cli-${Date.now().toString(36)}`,sessionIsolation:`tenant`,leaseBackend:n,leaseProvider:`limrun`,platform:t.platform,target:`mobile`,session:t.session,...E(t)}}function Te(t){if(l(t,s),t.platform!==`android`&&t.platform!==`ios`)throw new e(`INVALID_ARGS`,`connect limrun requires --platform ios or android.`);if(t.device!==void 0)throw new e(`INVALID_ARGS`,`connect limrun does not accept --device; Limrun selects a remote simulator or emulator.`);let n=w(t),r=t.platform===`ios`?`ios-instance`:`android-instance`;if(n!==r)throw new e(`INVALID_ARGS`,`connect limrun --platform ${t.platform} requires --lease-backend ${r}.`);return r}function Ee(t){let n=t.flags.daemonBaseUrl??t.env.AGENT_DEVICE_DAEMON_BASE_URL;if(!n)throw new e(`INVALID_ARGS`,`connect proxy requires --daemon-base-url <url> or AGENT_DEVICE_DAEMON_BASE_URL.`);let r=R(t.stateDir,n,t.flags.session),i={daemonBaseUrl:n,daemonTransport:t.flags.daemonTransport??`http`,daemonServerMode:t.flags.daemonServerMode,tenant:t.flags.tenant??`proxy`,sessionIsolation:t.flags.sessionIsolation??`tenant`,runId:t.flags.runId??`proxy-${r}`,leaseProvider:`proxy`,clientId:r,leaseBackend:t.flags.leaseBackend??w(t.flags),platform:t.flags.platform,target:t.flags.target,device:t.flags.device,udid:t.flags.udid,serial:t.flags.serial,iosSimulatorDeviceSet:t.flags.iosSimulatorDeviceSet,androidDeviceAllowlist:t.flags.androidDeviceAllowlist,session:t.flags.session,...E(t.flags)};return P({stateDir:t.stateDir,provider:`proxy`,profile:i,cwd:t.cwd,env:t.env,flags:t.flags,extraFlags:{daemonBaseUrl:n,daemonTransport:t.flags.daemonTransport??`http`}})}async function De(t,n,r,i){let a=pe(t,r);if(a)return await i(a);let[{claimProviderIds:o,resolveProviderPlugins:s},{storePluginCandidates:c}]=await Promise.all([import(`./registry.js`),import(`./store.js`).then(e=>e.a)]),l=await s([...o(n),...await c(r)]),u=l.connections.get(t);if(!u){let n=l.inventory().find(e=>e.provider===t);throw new e(`INVALID_ARGS`,n?.error?`Plugin ${t} failed to load: ${n.error.message}`:`Plugin does not register connect: ${t}`,n?.error?.reason?{reason:n.error.reason,provider:t}:{provider:t})}return await i(u)}const z={cloud:{resolve:ye,verify:async()=>({service:`the configured cloud service`,status:`verified`,verificationMessage:`Credentials and connection profile verified.`})},proxy:{resolve:Ee,verify:async()=>({service:`Agent Device Proxy`,status:`configured`,verificationMessage:`Proxy configuration saved. Access is checked by the first remote command.`})},limrun:{resolve:Ce,verify:je}};function B(e){return Object.hasOwn(z,e)?z[e]:void 0}async function V(e,t,n){let r=ge(e,t);return r?await n(r):await De(e,d,t,n)}async function Oe(e){let{cwd:t,env:n}=e;if(e.flags.remoteConfig){let r=a({configPath:e.flags.remoteConfig,cwd:t,env:n}),i=r.profile.leaseProvider;return await b(i,n),{flags:{...f(r.profile),...e.flags,remoteConfig:r.resolvedPath},remoteConfigPath:r.resolvedPath,...S(i,n)?{provider:i}:{}}}let r=e.provider??(Me(e.flags)?`proxy`:`cloud`),i={flags:e.flags,stateDir:e.stateDir,cwd:t,env:n},o=B(r);return{...o?await o.resolve(i):await V(r,n,async e=>await ke(r,e,i)),provider:r}}async function ke(t,r,i){let a=await r.resolve(i);if(a.profile.leaseProvider!==t)throw new e(`INVALID_ARGS`,`Provider connection profile must select its declared provider: ${t}`);let o=R(t,i.stateDir,i.flags.session,a.profile.device);return P({...i,...a,provider:t,profile:{tenant:i.flags.tenant??t,sessionIsolation:i.flags.sessionIsolation??`tenant`,runId:i.flags.runId??`${t}-${o}`,clientId:o,target:i.flags.target??`mobile`,session:i.flags.session,stateDir:i.stateDir,leaseBackend:i.flags.leaseBackend??n(a.profile.platform),...E(i.flags),...a.profile}})}async function Ae(e,t){if(!e.provider)return{service:`remote provider`,status:`configured`,verificationMessage:`Remote connection profile loaded. Access is checked by the first remote command.`};let n={flags:e.flags,env:t},r=B(e.provider);return r?await r.verify(n):await V(e.provider,n.env,async e=>await e.verify(n))}async function je(e){return await c({...D(e.env),clientVersion:r(),platform:u(e.flags.platform,`Limrun`)})}function Me(e){if(!e.daemonBaseUrl||e.tenant||e.runId||e.leaseId||e.leaseBackend)return!1;try{return new URL(e.daemonBaseUrl).pathname.replace(/\/+$/,``).endsWith(`/agent-device`)}catch{return!1}}function Ne(e){let{stateDir:t,flags:n,remoteConfigPath:r}=e,i=n.session??Pe();return{session:i,previous:n.session?p({stateDir:t,session:i}):null,remoteConfigHash:g(r),daemon:m(n)}}function Pe(){return`adc-${O.randomBytes(16).toString(`hex`)}`}function H(e,t){if(e.leaseId)return;let n=C(e.leaseProvider),r=n.leaseKind;if(r===`proxy`)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. Run devices to inspect inventory without allocating, then open when ready.`};if(n.supportsDeferredAppSelection)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. Run apps to inspect uploaded assets without allocating; open <uploaded-asset-name> creates the instance.`};if(r===`direct-device-provider`)return{status:`deferred`,nextSteps:W(e,t).nextSteps,message:`No live device session has been created. The first device command shown below will allocate one.`};let i=e.platform===void 0&&e.leaseBackend===void 0?` Add --platform ios|android if the profile does not set a platform.`:``;return{status:`deferred`,nextSteps:K(e,[`agent-device install-from-source <artifact-url> --platform ios|android`,`agent-device open <app-id> --relaunch`,`agent-device snapshot -i`,`agent-device devices`]),message:`No live device session has been created. Run a device command when ready to allocate or refresh the lease.`+i}}function Fe(e,t){return{...t,preparationMessage:H(e,t)?.message??`No live device session has been created.`,...W(e,t)}}function Ie(e){let{state:t,readiness:n,runtimePreparation:r,previousLeaseNotice:i}=e;if(!n){let e=H(t);return[`Configured remote session "${t.session}" tenant "${t.tenant}" run "${t.runId}"${t.leaseId?` lease ${t.leaseId}`:``}.`,e?.message,r?.message,i?.message].filter(e=>!!e).join(`
2
+ `)}let a=G(n),o=[`${a===`verified`?`Connected`:`Configured`} successfully with ${n.service}.`,`${a===`verified`?`Verified`:`Status`}: ${n.verificationMessage}`];return n.project&&o.push(`Project: ${n.project.name??n.project.reference} — verified`),n.device&&o.push(Be(n.device)),n.app&&o.push(Ve(t,n.app)),o.push(n.preparationMessage),o.push(`Next:`),o.push(...n.nextSteps.map(e=>` ${e}`)),o.push(...n.notes??[]),r&&o.push(r.message),i&&o.push(i.message),o.join(`
3
+ `)}function U(e){let{state:t,runtimePreparation:n,readiness:r,previousLeaseNotice:i}=e,a=H(t,r);return{connected:!0,session:t.session,tenant:t.tenant,runId:t.runId,leaseAllocated:!!t.leaseId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:t.leaseProvider,platform:t.platform,target:t.target,remoteConfig:t.remoteConfigPath,remoteConfigHash:t.remoteConfigHash,daemonBaseUrlFingerprint:h(t.daemon?.baseUrl),liveSession:Le(t),...Re(r,a),metro:t.metro?{prepared:!0,projectRoot:t.metro.projectRoot}:{prepared:!1},...ze({leasePreparation:a,runtimePreparation:n,previousLeaseNotice:i}),connectedAt:t.connectedAt,updatedAt:t.updatedAt}}function Le(e){return{status:e.leaseId?`created`:`not-created`,...e.leaseId?{leaseId:e.leaseId}:{}}}function Re(e,t){return e?{verification:{status:G(e),service:e.service,message:e.verificationMessage,...e.project?{project:e.project}:{}},...e.device?{device:e.device}:{},...e.app?{app:e.app}:{},nextSteps:e.nextSteps??t?.nextSteps??[],...e.notes?{notes:e.notes}:{}}:{}}function ze(e){let{leasePreparation:t,runtimePreparation:n,previousLeaseNotice:r}=e;return{...t?{leasePreparation:t}:{},...n?{runtimePreparation:n}:{},...r?{previousLeaseNotice:r}:{}}}function Be(e){let t=`osVersion`in e?e.osVersion:void 0,n=[e.platform,t].filter(Boolean).join(` `),r=n?` (${n})`:``;return e.status===`deferred`?`Device: ${e.name??`Provider-selected device`} — allocated on first device command`:`Device: ${e.name??e.reference??`Configured device`}${r} — verified`}function Ve(e,t){return t.status===`missing`?`App: ${Xe(e)} — ${t.message??`Install or attach an app before open.`}`:`App: ${t.name??t.reference??`configured app`} — ${t.status===`verified`?`verified`:t.message??`configured`}`}function W(e,t){let n=He(e,t);return{...n,nextSteps:K(e,n.nextSteps)}}function He(e,t){let n=C(e.leaseProvider).leaseKind;if(n===`proxy`)return{nextSteps:[`agent-device devices`,`agent-device open ${J(e.platform)} --relaunch`]};if(!t&&n===`direct-device-provider`)return{nextSteps:Ye()};if(C(t?.provider).supportsDeferredAppSelection)return{nextSteps:[`agent-device apps`,`agent-device open <uploaded-asset-name>`]};let r=t?.app?.status===`missing`;return{nextSteps:Ue(t)?Je(e):[...Ge(t),...qe(e).nextSteps],...We(t)?{notes:Ke(e,!r)}:{}}}function Ue(e){return e?.app?.status===`missing`&&e.device?.status===`deferred`}function We(e){return C(e?.provider).supportsArtifacts}function Ge(e){return e?.app?.status!==`missing`||!e.project?.reference||!e.device?.reference?[]:[`agent-device connect aws-device-farm --platform ${e.device.platform} --aws-project-arn ${e.project.reference} --aws-device-arn ${e.device.reference} --aws-app-arn <arn> --force`]}function Ke(e,t){return[...t?[`Use the installed package or bundle identifier in open, not the app artifact name.`]:[],`After close, run ${q(e,`agent-device artifacts --json`)} for provider video and logs.`]}function qe(e){return{nextSteps:[`agent-device open ${J(e.platform)} --relaunch`]}}function Je(e){let t=J(e.platform);return[`agent-device install ${t} <app-path-or-url>`,`agent-device open ${t} --relaunch`]}function G(e){return`status`in e?e.status:`verified`}function Ye(){return[`agent-device open <package-or-bundle-id> --relaunch`,`agent-device snapshot -i`,`agent-device close`,`agent-device artifacts --json`]}function K(e,t){return t.map(t=>q(e,t))}function q(e,t){return`${t} --session ${o(e.session)}`}function J(e){return e===`ios`?`<bundle-id>`:`<package-id>`}function Xe(e){let t=C(e.leaseProvider);return t.requiresAppAttachment?`not attached`:t.supportsDeferredAppSelection?`not installed yet`:`not available`}const Ze=async({positionals:e,flags:t,client:n,host:r})=>{let a=i(t.stateDir,{cwd:r.cwd,env:r.env}).baseDir;await b(e[0],r.env);let o=mt(e,r.env);Qe(o,t);let s=await Oe({provider:o,flags:t,stateDir:a,cwd:r.cwd,env:r.env}),c=s.flags,l=st(s.remoteConfigPath,r),u=$e(c,l),d=Ne({stateDir:a,flags:c,remoteConfigPath:s.remoteConfigPath});et(d.previous,{flags:c,session:d.session,remoteConfigPath:s.remoteConfigPath,remoteConfigHash:d.remoteConfigHash,desiredLeaseBackend:w(c),connection:l,daemon:d.daemon});let f=await Ae(s,r.env),p=tt({flags:c,scope:u,connectionMetadata:l,context:d,remoteConfigPath:s.remoteConfigPath});oe({stateDir:a,state:p});let m=await ot(n,c,d.previous,p,r),h=yt(c,p,r),g=Fe(p,f);return await y(c,U({state:p,runtimePreparation:h,readiness:g,previousLeaseNotice:m}),()=>Ie({state:p,runtimePreparation:h,readiness:g,previousLeaseNotice:m})),!0};function Qe(t,n){if(!(!t||!n.remoteConfig))throw new e(`INVALID_ARGS`,`connect provider positional and --remote-config are mutually exclusive.`)}function $e(t,n){if(!t.tenant)throw new e(`INVALID_ARGS`,`connect requires tenant in remote config or via --tenant <id>.`);if(!t.runId)throw new e(`INVALID_ARGS`,`connect requires runId in remote config or via --run-id <id>.`);if(!t.daemonBaseUrl&&C(n?.leaseProvider).requiresRemoteDaemon)throw new e(`INVALID_ARGS`,`connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.`);return{tenant:t.tenant,runId:t.runId}}function et(t,n){if(!(!t||Z(t,n))&&!n.flags.force)throw new e(`INVALID_ARGS`,`A different remote connection is already active for this session. Re-run connect with --force to replace it.`,{session:n.session,remoteConfig:t.remoteConfigPath})}function tt(e){let{flags:t,scope:n,connectionMetadata:r,context:i,remoteConfigPath:a}=e,o=at(t,i.previous)?i.previous:null,s=new Date().toISOString(),c=nt(t,o,r),l=it(t,o,s,c,i.session);return{version:1,session:i.session,remoteConfigPath:a,remoteConfigHash:i.remoteConfigHash,daemon:i.daemon,tenant:n.tenant,runId:n.runId,...c,...l,updatedAt:s}}function nt(e,t,n){let r=re(n??{},t??{}),i=t?.leaseBackend??w(e);return i===`macos-app`?rt(e,t,r):{leaseId:t?.leaseId,leaseBackend:i,...r,deviceKey:t?.deviceKey??r.deviceKey}}function rt(e,t,n){return{leaseId:e.leaseId??t?.leaseId,leaseBackend:`macos-app`,...n}}function it(e,t,n,r,i){let a=te({leaseBackend:r.leaseBackend,recordedPlatform:t?.platform,requestedPlatform:e.platform});if(!a.ok)throw x({session:i,leaseBackend:r.leaseBackend,boundPlatform:a.boundPlatform,requestedPlatform:a.requestedPlatform,detail:t?`bound-connection`:`requested-backend`});return{platform:a.platform,target:e.target??t?.target,runtime:t?.runtime,metro:t?.metro,connectedAt:t?.connectedAt??n}}function at(e,t){return!!(t&&!e.force)}async function ot(e,t,n,r,i){if(!(!n||!t.force)&&(await T(n.metro),!(n.leaseId&&n.leaseId===r.leaseId)))return await de(e,n,{nextDaemonBaseUrl:r.daemon?.baseUrl,ambientDaemonAuthToken:t.daemonAuthToken,cwd:i.cwd,env:i.env})}function st(e,t){let n=a({configPath:e,cwd:t.cwd,env:t.env}).profile;return ee(n)}const ct=async({flags:e,client:t,host:n})=>{let{session:r,stateDir:i,state:a}=Y(e,n);if(!a)return await X(e,r),!0;let o=a.session,s;if(a.leaseId||a.runtime||a.metro)try{s=(await t.sessions.close({session:o,shutdown:e.shutdown})).provider}catch{}await T(a.metro);let c=!1;if(a.leaseId)try{let n=await fe(t,a,e.daemonAuthToken);c=n.released,s??=n.provider}catch{}return se({stateDir:i,session:o}),await y(e,{connected:!1,session:o,released:c,...s?{provider:s}:{}},()=>ut(o,s)),!0},lt=async({positionals:t,flags:n,host:r})=>{if(t[0]!==`status`)throw new e(`INVALID_ARGS`,`connection accepts only: status`);let{session:i,state:a}=Y(n,r);if(!a)return await X(n,i),!0;await b(a.leaseProvider);let o=H(a),s=bt(a,r);return await y(n,U({state:a,runtimePreparation:s}),()=>[`Configured remote session "${a.session}".`,`tenant=${a.tenant} runId=${a.runId} leaseId=${a.leaseId??`pending`} backend=${a.leaseBackend??`pending`}`,`remoteConfig=${a.remoteConfigPath}`,a.runtime?`metro=prepared`:`metro=not-prepared`,o?.message,s?.message].filter(e=>!!e).join(`
4
+ `)),!0};function ut(e,t){return[`Disconnected remote session "${e}".`,...dt(t),...pt(t?.cloudArtifacts?.cloudArtifacts)].join(`
5
+ `)}function dt(e){return(Array.isArray(e?.warnings)?e.warnings:[]).flatMap(e=>{let t=ft(e);return t?[t]:[]})}function ft(e){if(!e||typeof e!=`object`)return;let t=e;if(typeof t.message==`string`&&t.message.length!==0)return`Provider release warning${typeof t.code==`string`&&t.code.length>0?` (${t.code})`:``}: ${t.message}`}function pt(e){return(e??[]).filter(e=>(e.availability??`ready`)===`ready`&&e.url).slice(0,3).map(e=>`${e.name}: ${e.url}`)}function mt(t,n){let r=t[0];if(r!==void 0){if(t.length>1)throw new e(`INVALID_ARGS`,`connect accepts at most one provider positional.`);if(S(r,n))return r;throw ue(r,n)||new e(`INVALID_ARGS`,`Unknown connect provider: ${r}. Supported providers: ${le(n)}.`)}}function Y(e,t){let n=e.session??`default`,r=i(e.stateDir,{cwd:t.cwd,env:t.env}).baseDir;return{session:n,stateDir:r,state:p({stateDir:r,session:n})??(e.session?null:_({stateDir:r}))}}async function X(e,t){await y(e,{connected:!1,session:t},()=>`No remote connection for "${t}".`)}function Z(e,t){return ht(e,t)&&gt(e,t)&&vt(e.daemon,t.daemon)}function ht(e,t){return[[e.remoteConfigPath,t.remoteConfigPath],[e.remoteConfigHash,t.remoteConfigHash],[e.session,t.session],[e.tenant,t.flags.tenant],[e.runId,t.flags.runId]].every(([e,t])=>e===t)}function gt(e,t){return ie(e,t.flags.platform)?[[e.leaseBackend,t.desiredLeaseBackend],[e.target,t.flags.target]].every(([e,t])=>t===void 0||e===t)&&_t(e,t.flags.leaseId)&&ae(e,t.connection):!1}function _t(e,t){return e.leaseBackend!==`macos-app`||t===void 0||t===e.leaseId}function vt(e,t){return[`baseUrl`,`transport`,`serverMode`].every(n=>(e?.[n]??void 0)===(t?.[n]??void 0))}function yt(e,t,n){if(!t.runtime&&!(!ce(e)&&!$(t.remoteConfigPath,n)))return Q(t)}function bt(e,t){if(!(e.runtime||!$(e.remoteConfigPath,t)))return Q(e)}function Q(e){let t=q(e,`agent-device metro prepare --remote-config ${o(e.remoteConfigPath)}`);return{status:`deferred`,nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function $(e,t){try{let n=a({configPath:e,cwd:t.cwd,env:t.env}).profile;return!!(n.metroPublicBaseUrl||n.metroProxyBaseUrl||n.metroProjectRoot||n.metroKind)}catch{return!1}}export{Ze as connectCommand,lt as connectionCommand,ct as disconnectCommand};
@@ -1 +1 @@
1
- import{H as e,et as t,x as n}from"./sdk-contracts.js";export{n as centerOfRect,e as defaultHintForCode,t as normalizeError};
1
+ import{U as e,tt as t,x as n}from"./sdk-contracts.js";export{n as centerOfRect,e as defaultHintForCode,t as normalizeError};
@@ -1 +1 @@
1
- import{R as e,ct as t}from"./sdk-contracts.js";import{V as n,f as r,mt as i}from"./sdk-io.js";import"./diagnostics.js";import{c as a,f as o,l as s}from"./daemon-client.js";import{l as c,n as l,o as u}from"./daemon-resolution.js";import"./retry.js";import{a as d,f}from"./daemon-registration-owner.js";import{a as p,i as m,l as h,n as g,o as _,s as v}from"./daemon-lifecycle-errors.js";import{a as y,i as b,n as x,r as S,resolveLocalDaemonSettings as C,t as w}from"./daemon-client-lifecycle.js";import{probeDaemonResponsive as T}from"./daemon-client-liveness-probe.js";function E(t){return t instanceof e&&t.details?.reason===`daemon_transport_failure`}async function D(e,n){let r=i(),o=u({token:e.token,fence:{pid:e.pid,processStartTime:e.processStartTime??null},requestId:r}),c;try{c=await s(e,o,`auto`,n.paths,1e4,{host:n.host,timeoutRecovery:`none`})}catch(t){if(a(t)||E(t))return{outcome:`gone`};let r=O(t),i=r&&k(r,e,n);if(i)return i;throw t}if(c.ok)return{outcome:`draining`};let l=c.error.details,d=k({reason:l?.reason,details:l},e,n);if(d)return d;t(c.error)}function O(t){if(!(t instanceof e))return;let n=t.details?.reason;return n===l.ownerEmbedded?{reason:n,details:t.details}:void 0}function k(e,t,n){let r=n.paths.baseDir;if(e.reason===l.busy)throw g(t,r,c(e.details));if(e.reason===l.ownerEmbedded)throw v({info:t,stateDir:r});if(e.reason===l.instanceMismatch||e.reason===`daemon_shutting_down`)return{outcome:`gone`}}async function A(t={},i=r(process)){let a=C(t,i);for(let e=1;e<=40;e+=1){let e=await j(a,t.onStart);if(e.kind===`judge-again`){await n(250);continue}return await w(e.daemon.info,a.paths.baseDir,i),{stateDir:a.paths.baseDir,daemon:p(e.daemon.info),started:e.started}}throw new e(`COMMAND_FAILED`,`The daemon kept changing while it was being ensured.`,{reason:`daemon-lifecycle-contended`,stateDir:a.paths.baseDir,hint:`Another process is starting or replacing the daemon on this state directory. Retry.`})}async function j(e,t){let n=await x(e,{refineUnreachable:!0});if(!n)return await L(e,t,`missing`);let{info:r,decision:i}=n;switch(i.kind){case`reuse`:return{kind:`connected`,daemon:{info:r,startedByClient:!1},started:!1};case`refuseNewer`:throw await _({info:r,mismatch:`newer`,stateDir:e.paths.baseDir});case`replace`:return i.cause===`unreachable`?await M(e,r,t):await N(e,r,t)}}async function M(e,t,n){return await S(t,e.paths),await L(e,n,`missing`,p(t))}async function N(e,t,n){let r=t.processStartTime;if(!t.capabilities?.includes(`quiesce`)||!r?.trim())throw await _({info:t,mismatch:`no-quiesce`,stateDir:e.paths.baseDir});let i=await F(t,e);return i===`gone`?{kind:`judge-again`}:await L(e,n,(i===`draining`?await P(t,r,e):i)===`retired`?`missing`:`incompatible`,p(t))}async function P(e,t,n){let{exited:r}=await f({pid:e.pid,startTime:t},{timeoutMs:6e4,pollMs:250});if(r)return await d({paths:n.paths,observed:o(e)}),`left`;if(await I(e))throw await m(e,n);let i=await y(e,n.paths,`force`);if(i.status!==`retained`)return`retired`;let a=i.termination?.status===`retained`?i.termination.reason:void 0;throw a===`identity-unverified`||a===`owner-unproven`?await m(e,n):h(i,n.paths)}async function F(t,n){try{return(await D(t,n)).outcome}catch(r){if(!(r instanceof e)||r.details?.reason!==`daemon_transport_timeout`||await I(t))throw r;return await S(t,n.paths,`force`),`retired`}}async function I(e){for(let t=1;t<=3;t+=1){if(await T(e))return!0;t<3&&await n(200)}return!1}async function L(t,n,r,i){let a;try{a=await b(t)}catch(t){if(t instanceof e&&t.details?.reason===`daemon-contended`)return{kind:`judge-again`};throw t}return a.startedByClient&&n?.(r,i),{kind:`connected`,daemon:a,started:a.startedByClient}}export{A as ensureDaemon};
1
+ import{R as e,lt as t}from"./sdk-contracts.js";import{H as n,f as r,gt as i}from"./sdk-io.js";import"./diagnostics.js";import{c as a,f as o,l as s}from"./daemon-client.js";import{l as c,n as l,o as u}from"./daemon-resolution.js";import"./retry.js";import{a as d,f}from"./daemon-registration-owner.js";import{a as p,i as m,l as h,n as g,o as _,s as v}from"./daemon-lifecycle-errors.js";import{a as y,i as b,n as x,r as S,resolveLocalDaemonSettings as C,t as w}from"./daemon-client-lifecycle.js";import{probeDaemonResponsive as T}from"./daemon-client-liveness-probe.js";function E(t){return t instanceof e&&t.details?.reason===`daemon_transport_failure`}async function D(e,n){let r=i(),o=u({token:e.token,fence:{pid:e.pid,processStartTime:e.processStartTime??null},requestId:r}),c;try{c=await s(e,o,`auto`,n.paths,1e4,{host:n.host,timeoutRecovery:`none`})}catch(t){if(a(t)||E(t))return{outcome:`gone`};let r=O(t),i=r&&k(r,e,n);if(i)return i;throw t}if(c.ok)return{outcome:`draining`};let l=c.error.details,d=k({reason:l?.reason,details:l},e,n);if(d)return d;t(c.error)}function O(t){if(!(t instanceof e))return;let n=t.details?.reason;return n===l.ownerEmbedded?{reason:n,details:t.details}:void 0}function k(e,t,n){let r=n.paths.baseDir;if(e.reason===l.busy)throw g(t,r,c(e.details));if(e.reason===l.ownerEmbedded)throw v({info:t,stateDir:r});if(e.reason===l.instanceMismatch||e.reason===`daemon_shutting_down`)return{outcome:`gone`}}async function A(t={},i=r(process)){let a=C(t,i);for(let e=1;e<=40;e+=1){let e=await j(a,t.onStart);if(e.kind===`judge-again`){await n(250);continue}return await w(e.daemon.info,a.paths.baseDir,i),{stateDir:a.paths.baseDir,daemon:p(e.daemon.info),started:e.started}}throw new e(`COMMAND_FAILED`,`The daemon kept changing while it was being ensured.`,{reason:`daemon-lifecycle-contended`,stateDir:a.paths.baseDir,hint:`Another process is starting or replacing the daemon on this state directory. Retry.`})}async function j(e,t){let n=await x(e,{refineUnreachable:!0});if(!n)return await L(e,t,`missing`);let{info:r,decision:i}=n;switch(i.kind){case`reuse`:return{kind:`connected`,daemon:{info:r,startedByClient:!1},started:!1};case`refuseNewer`:throw await _({info:r,mismatch:`newer`,stateDir:e.paths.baseDir});case`replace`:return i.cause===`unreachable`?await M(e,r,t):await N(e,r,t)}}async function M(e,t,n){return await S(t,e.paths),await L(e,n,`missing`,p(t))}async function N(e,t,n){let r=t.processStartTime;if(!t.capabilities?.includes(`quiesce`)||!r?.trim())throw await _({info:t,mismatch:`no-quiesce`,stateDir:e.paths.baseDir});let i=await F(t,e);return i===`gone`?{kind:`judge-again`}:await L(e,n,(i===`draining`?await P(t,r,e):i)===`retired`?`missing`:`incompatible`,p(t))}async function P(e,t,n){let{exited:r}=await f({pid:e.pid,startTime:t},{timeoutMs:6e4,pollMs:250});if(r)return await d({paths:n.paths,observed:o(e)}),`left`;if(await I(e))throw await m(e,n);let i=await y(e,n.paths,`force`);if(i.status!==`retained`)return`retired`;let a=i.termination?.status===`retained`?i.termination.reason:void 0;throw a===`identity-unverified`||a===`owner-unproven`?await m(e,n):h(i,n.paths)}async function F(t,n){try{return(await D(t,n)).outcome}catch(r){if(!(r instanceof e)||r.details?.reason!==`daemon_transport_timeout`||await I(t))throw r;return await S(t,n.paths,`force`),`retired`}}async function I(e){for(let t=1;t<=3;t+=1){if(await T(e))return!0;t<3&&await n(200)}return!1}async function L(t,n,r,i){let a;try{a=await b(t)}catch(t){if(t instanceof e&&t.details?.reason===`daemon-contended`)return{kind:`judge-again`};throw t}return a.startedByClient&&n?.(r,i),{kind:`connected`,daemon:a,started:a.startedByClient}}export{A as ensureDaemon};
@@ -1 +1 @@
1
- import{R as e}from"./sdk-contracts.js";import{Ct as t,T as n,dt as r,gt as i,lt as a}from"./back-mode.js";import{ht as o,mt as s}from"./sdk-io.js";import"./diagnostics.js";import{dn as c,w as l}from"./sdk-batch.js";import{d as u,l as d}from"./daemon-client.js";const f=new Set([`LEASE_SCOPE_REQUIRED`,`LEASE_SCOPE_MISMATCH`]);function p(t){return r(t)||t instanceof e&&(f.has(t.details?.reason)||t.code===`INVALID_ARGS`)}async function m(e){let{heartbeat:t,callerSignal:n}=e;if(!t)return await e.task(new AbortController().signal);let r=new AbortController,i=new AbortController,s=a,c=h(s),l,u=!1,d=()=>{u=!0,l&&clearTimeout(l),i.abort()},f,m,v=new Promise((e,t)=>{m=t});n&&n.addEventListener(`abort`,d,{once:!0});let y=()=>{let e=e=>{u||(l&&clearTimeout(l),l=setTimeout(y,e))},n=e=>{if(f=e,u){o({level:`warn`,phase:`lease_lost_after_phase`,data:{message:e instanceof Error?e.message:String(e)}});return}r.abort(),m?.(e)},a=e=>{u||o({level:`warn`,phase:`lease_heartbeat_failed`,data:{message:e instanceof Error?e.message:String(e)}})};e(c),(async()=>{let r=s;try{let n=g(await t(r,i.signal));if(n===void 0||n===s)return;let a=h(n);s=n,c=a,e(a)}catch(e){if(p(e)){n(e);return}a(e)}})().catch(()=>void 0)};l=setTimeout(y,0),v.catch(()=>void 0);let b=await _((async()=>await Promise.race([e.task(r.signal),v]))());if(d(),n&&n.removeEventListener(`abort`,d),f!==void 0)throw f;if(!b.ok)throw b.error;return b.value}function h(e){return Math.max(1e3,Math.floor(e/3))}function g(e){let t=e?.data?.lease,n=t?.expiresAt,r=t?.heartbeatAt;if(typeof n==`number`&&typeof r==`number`)return n>r?n-r:void 0}async function _(e){try{return{ok:!0,value:await e}}catch(e){return{ok:!1,error:e}}}function v(e,r){return{command:n.leaseHeartbeat,positionals:[],session:r.session,token:r.token,meta:{...t(e),sessionIsolation:r.sessionIsolation,requestId:r.requestId}}}function y(e,t,r){if(!u(e))return;let a=i(r);if(!a.leaseId)return;let o=c(l(n.leaseHeartbeat),{positionals:[]});return async(n,i)=>await d(e,v(a,{session:r.session,sessionIsolation:r.meta?.sessionIsolation,requestId:s(),token:e.token}),t.transportPreference,t.paths,o===void 0?n:Math.min(o,n),{host:t.host,signal:i})}export{y as buildUploadLeaseHeartbeat,m as runProtectedLeaseWork};
1
+ import{R as e}from"./sdk-contracts.js";import{Ct as t,T as n,dt as r,gt as i,lt as a}from"./back-mode.js";import{_t as o,gt as s}from"./sdk-io.js";import"./diagnostics.js";import{rt as c,w as l}from"./sdk-batch.js";import{d as u,l as d}from"./daemon-client.js";const f=new Set([`LEASE_SCOPE_REQUIRED`,`LEASE_SCOPE_MISMATCH`]);function p(t){return r(t)||t instanceof e&&(f.has(t.details?.reason)||t.code===`INVALID_ARGS`)}async function m(e){let{heartbeat:t,callerSignal:n}=e;if(!t)return await e.task(new AbortController().signal);let r=new AbortController,i=new AbortController,s=a,c=h(s),l,u=!1,d=()=>{u=!0,l&&clearTimeout(l),i.abort()},f,m,v=new Promise((e,t)=>{m=t});n&&n.addEventListener(`abort`,d,{once:!0});let y=()=>{let e=e=>{u||(l&&clearTimeout(l),l=setTimeout(y,e))},n=e=>{if(f=e,u){o({level:`warn`,phase:`lease_lost_after_phase`,data:{message:e instanceof Error?e.message:String(e)}});return}r.abort(),m?.(e)},a=e=>{u||o({level:`warn`,phase:`lease_heartbeat_failed`,data:{message:e instanceof Error?e.message:String(e)}})};e(c),(async()=>{let r=s;try{let n=g(await t(r,i.signal));if(n===void 0||n===s)return;let a=h(n);s=n,c=a,e(a)}catch(e){if(p(e)){n(e);return}a(e)}})().catch(()=>void 0)};l=setTimeout(y,0),v.catch(()=>void 0);let b=await _((async()=>await Promise.race([e.task(r.signal),v]))());if(d(),n&&n.removeEventListener(`abort`,d),f!==void 0)throw f;if(!b.ok)throw b.error;return b.value}function h(e){return Math.max(1e3,Math.floor(e/3))}function g(e){let t=e?.data?.lease,n=t?.expiresAt,r=t?.heartbeatAt;if(typeof n==`number`&&typeof r==`number`)return n>r?n-r:void 0}async function _(e){try{return{ok:!0,value:await e}}catch(e){return{ok:!1,error:e}}}function v(e,r){return{command:n.leaseHeartbeat,positionals:[],session:r.session,token:r.token,meta:{...t(e),sessionIsolation:r.sessionIsolation,requestId:r.requestId}}}function y(e,t,r){if(!u(e))return;let a=i(r);if(!a.leaseId)return;let o=c(l(n.leaseHeartbeat),{positionals:[]});return async(n,i)=>await d(e,v(a,{session:r.session,sessionIsolation:r.meta?.sessionIsolation,requestId:s(),token:e.token}),t.transportPreference,t.paths,o===void 0?n:Math.min(o,n),{host:t.host,signal:i})}export{y as buildUploadLeaseHeartbeat,m as runProtectedLeaseWork};
@@ -1 +1 @@
1
- import{R as e,et as t}from"./sdk-contracts.js";import{E as n}from"./back-mode.js";import{V as r,b as i,ht as a,o}from"./sdk-io.js";import"./diagnostics.js";import{r as s}from"./file.js";import"./command.js";import{a as c,c as l,d as u,f as d,m as f,o as p,p as m,u as h}from"./daemon-client.js";import{g,h as _,m as v}from"./daemon-resolution.js";import{c as y}from"./device-shell.js";import"./retry.js";import{i as ee}from"./replay-divergence.js";import{a as te,c as ne,d as b,i as re,n as ie,o as x,t as S,u as C}from"./daemon-registration-owner.js";import{i as ae}from"./daemon-registration.js";import{n as oe,r as se}from"./daemon-launch-spec.js";import{d as ce,r as le,u as w}from"./daemon-lifecycle-errors.js";import T from"node:fs";import E from"node:net";function ue(e,t,n){let r=e.data??{},i=typeof r.session==`string`?r.session:void 0,a=[...n?[`--daemon-base-url ${y(de(n))}`]:[],...t?[`--state-dir ${y(t)}`]:[],...i?[`--session ${y(i)}`]:[]];if(a.length===0)return e;let o=`This session's daemon was kept alive because its script left the session active; pass ${a.join(` `)} on your next command to reach it.`+(n?` If authentication is required, provide or configure --daemon-auth-token.`:``),s=typeof r.message==`string`?r.message:void 0;return{...e,data:{...r,hint:o,message:s?`${s} ${o}`:o}}}function de(e){let t=new URL(e);return t.username=``,t.password=``,t.search=``,t.hash=``,t.toString().replace(/\/+$/,``)}const D=6e4,O=`AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS`;function fe(t){let n=t[O]?.trim();if(n===void 0||n===``)return 12e4;let r=Number(n);if(!Number.isSafeInteger(r)||r<=0)throw new e(`INVALID_ARGS`,`${O} must be a positive integer number of milliseconds`,{value:n});return r}async function k(e,t={}){let{deadline:n}=t,r=s(e.paths.lockPath);if(r.state===`unproven`)throw j(e,r);let i=m(e.paths.infoPath);return!i||!he(r,i)||t.waitForLiveStartup&&await me(i,n)?null:{info:i,decision:await pe(i,await se(i,{onClientTransport:()=>P(i,e.transportPreference,n),onAnyAdvertisedTransport:()=>P(i,`auto`,n)}),t)}}async function pe(e,t,n){return!n.refineUnreachable||t.kind!==`replace`?t:i(e.pid)?t.cause===`unreachable`&&await P(e,`auto`,n.deadline)?{...t,cause:`transport`}:t:{...t,cause:`unreachable`}}async function A(e,t={}){let{deadline:n}=t,r=await k(e,t);if(!r)return null;let{info:i,decision:a}=r;if(a.kind===`reuse`)return i;if(a.kind===`refuseNewer`)throw ge(i,a,e.paths.baseDir);if(!e.retireIncompatibleContender)throw le();return H(n)<5e3?null:(L(i,a.reason,e.paths.baseDir),await N(i,e.paths),null)}async function me(e,t){return i(e.pid)&&!await p(e,`auto`,H(t))}function he(e,t){return e.state===`absent`||ae(e,{pid:t.pid,startTime:t.processStartTime??null})}function j(t,n){return new e(`COMMAND_FAILED`,`Daemon registration ownership could not be verified.`,{reason:`daemon_registration_unproven`,inspection:n,stateDir:t.paths.baseDir,hint:f(h(t.paths),t.paths)})}async function M(e,t,n=`graceful`){return await x({paths:t,observed:d(e),mode:n})}async function N(e,t,n=`graceful`){let r=await M(e,t,n);if(r.status===`retained`)throw ce(r,e,t)}async function P(e,t,n){if(await I(e,t,n))return!0;for(let o=1;o<=3;o+=1){if(!i(e.pid)||n!==void 0&&Date.now()>=n)return!1;if(await r(Math.min(200,H(n))),await I(e,t,n))return a({level:`warn`,phase:`daemon_probe_recovered`,data:{pid:e.pid,retry:o}}),!0}return!1}async function F(t,n,r){let{env:i}=r;if(!i.AGENT_DEVICE_DAEMON_POLICY?.trim())return;let{loadDaemonPolicy:a}=await import(`./daemon-policy-file.js`).then(e=>e.t),o=a(i,r.cwd)?.digest;if(o!==t.policyDigest)throw new e(`COMMAND_FAILED`,`The running daemon does not enforce the daemon policy named by AGENT_DEVICE_DAEMON_POLICY.`,{reason:`DAEMON_POLICY_MISMATCH`,expectedPolicyDigest:o,daemonPolicyDigest:t.policyDigest??null,hint:`Stop the running daemon (${w(n)}), then retry so a daemon starts with this policy.`})}async function I(e,t,n){try{return await p(e,t,H(n))}catch(e){if(l(e))return!1;throw e}}function ge(t,n,r){let{daemonVersion:i,clientVersion:a}=n;return new e(`COMMAND_FAILED`,`Daemon (pid ${t.pid}, v${i}) is newer than this client (v${a}); refusing to replace it.`,{daemonPid:t.pid,daemonVersion:i,clientVersion:a,hint:`Use the agent-device v${i} CLI that started it, or stop it deliberately: ${w(r)}`})}function L(e,t,n){try{let r=e.version?`pid ${e.pid}, v${e.version}`:`pid ${e.pid}`;process.stderr.write(`Replacing daemon (${r}) in ${n}: ${t}\n`)}catch{}}async function R(t){let n=fe(t.host.env),i=Date.now()+n,a=[],o,s=0;for(;s<2&&Date.now()<i;){s+=1;let e=await _e(t,i);if(`daemon`in e)return e.daemon;if(o=e,e.cleanup&&a.push(e.cleanup),!e.retry)break;await r(Math.min(150,Math.max(0,i-Date.now())))}let{startError:c,startupError:l,daemonProcess:u,reason:d,phases:p}=o??{},m=d??`startup-exited`,g=h(t.paths),_=Ne(t.paths.logPath);throw new e(`COMMAND_FAILED`,`Failed to start daemon`,{kind:`daemon_startup_failed`,reason:m,stateDir:t.paths.baseDir,infoPath:t.paths.infoPath,lockPath:t.paths.lockPath,logPath:t.paths.logPath,startupTimeoutMs:n,startupAttempts:s,cleanupResults:a,startError:c,startupError:l,daemonProcess:u,...p?{phases:Ee(p)}:{},..._?{daemonLogTail:_}:{},metadataState:g,hint:d===`startup-stalled`||d===`startup-ceiling`?De(d,n):f(g,t.paths)})}async function _e(e,n){let r,i=Date.now();try{r=je(e)}catch(t){return await ve(e,t)}let a={spawnedAtMs:i,markers:{}},o=await ye(n,e,r,a);if(o.kind===`ready`)return o.daemon.startedByClient||await V(e,r),{daemon:o.daemon};if(W(e,r.pid,a),o.kind===`retry`)return await V(e,r),{retry:!0,phases:a};if(o.kind===`unproven`){await V(e,r);let n=t(o.error);return{retry:!1,startError:n.message,startupError:n,daemonProcess:{pid:r.pid},phases:a}}let{cleanup:c,joined:l}=await z(e,r,n),u=o.kind===`stalled`?`startup-stalled`:o.kind===`ceiling`?`startup-ceiling`:`startup-exited`,d=U(s(e.paths.lockPath));return{cleanup:c,retry:l&&o.kind===`early_exit`&&d,reason:u,startError:o.kind===`early_exit`?Me(o.exit):void 0,daemonProcess:o.kind===`early_exit`?o.exit:{pid:r.pid},phases:a}}async function ve(e,n){let r=e.ownedStateDir?await x({paths:e.paths,observed:null,mode:`graceful`,ownedStateDir:e.ownedStateDir,lockTimeoutMs:0}):await te({paths:e.paths,observed:null,lockTimeoutMs:0});return{cleanup:r,startError:t(n).message,retry:!e.ownedStateDir&&r.status!==`retained`}}async function z(e,t,n){let r=await x({paths:e.paths,observed:{...t.readIdentity(),ownership:`detached`},mode:`graceful`,ownedStateDir:e.ownedStateDir,termTimeoutMs:Math.min(3e3,H(n)),killTimeoutMs:1e3,lockTimeoutMs:0}),i=await B(t);return i&&C(b(e.paths.baseDir,t.pid)),{cleanup:r,joined:i}}async function B(e){let t;try{return await Promise.race([e.exited.then(()=>!0),new Promise(e=>{t=setTimeout(()=>e(!1),1e3)})])}finally{clearTimeout(t)}}async function V(e,t){await B(t)&&C(b(e.paths.baseDir,t.pid))}function H(e){return e===void 0?1/0:Math.max(0,e-Date.now())}function U(e){return e.state===`absent`||e.state===`held`&&(e.liveness===`owner-process-dead`||e.liveness===`owner-process-reused`)}async function ye(e,t,n,i){let a;for(n.exited.then(e=>{a=e});Date.now()<e;){if(a){let n=await Ce(t,a,e);if(n)return n}else{let r=await we(t,n,e,i);if(r&&!(r.kind===`ready`&&a))return r}await r(Math.min(100,H(e)))}return be(t,n,a)}function be(e,t,n){return Se(s(e.paths.lockPath))?{kind:`ceiling`}:n?{kind:`early_exit`,exit:n}:xe(t)?{kind:`ceiling`}:{kind:`exit_unobserved`}}function xe(e){if(!i(e.pid))return!1;let t=e.readIdentity();return!t.startTime||o({owner:t})!==`owner-process-reused`}function Se(e){return e.state===`held`&&e.liveness!==`owner-process-dead`&&e.liveness!==`owner-process-reused`}async function Ce(e,t,n){let r=Oe(t);return r===`unproven`?{kind:`unproven`,error:j(e)}:r===`failed`?{kind:`early_exit`,exit:t}:await ke(e,n)}async function we(e,t,n,r){let a=await Ae(e,t,n);return a?{kind:`ready`,daemon:{info:a,startedByClient:!0}}:(W(e,t.pid,r),i(t.pid)&&Date.now()-Te(r)>=D?{kind:`stalled`}:null)}function W(e,t,n){let r=K(b(e.paths.baseDir,t),16e3);if(r)for(let[e,t]of Object.entries(ne(r)))n.markers[e]=t}function Te(e){return Object.values(e.markers).reduce((e,t)=>Math.max(e,t),e.spawnedAtMs)}function Ee(e){let t={spawned:0};for(let[n,r]of Object.entries(e.markers))t[n]=Math.max(0,r-e.spawnedAtMs);return t}function De(e,t){return e===`startup-stalled`?`The daemon is alive but made no startup progress for ${D/1e3} s. The host can be overloaded. Retry once the host load drops; ${O} raises only the registration ceiling and does not change this stall window.`:`The daemon is alive but did not register within ${Math.round(t/1e3)} s. The host can be overloaded. Retry, or raise ${O}.`}function Oe(e){if(e.error||e.signal)return`failed`;switch(e.exitCode){case S.busy:return`busy`;case S.unproven:return`unproven`;default:return`failed`}}async function ke(t,n){let r;try{r=await A(t,{deadline:n,waitForLiveStartup:!0})}catch(t){if(t instanceof e&&t.details?.reason===`daemon_registration_unproven`)return{kind:`unproven`,error:t};throw t}if(Date.now()>=n)return null;if(r)return{kind:`ready`,daemon:{info:r,startedByClient:!1}};let i=s(t.paths.lockPath);return i.state===`unproven`?{kind:`unproven`,error:j(t,i)}:U(i)?{kind:`retry`}:null}async function Ae(n,r,i){let o=m(n.paths.infoPath);if(!o||!G(o,r))return null;try{return await p(o,n.transportPreference,H(i))&&Date.now()<i?o:null}catch(o){let{cleanup:s,joined:c}=await z(n,r,i);throw a({level:`warn`,phase:`daemon_startup_observation_failed`,data:{stateDir:n.paths.baseDir,cleanup:s,joined:c,error:t(o)}}),o instanceof e&&(o.details={...o.details,stateDir:n.paths.baseDir,cleanupResults:[s],startupJoined:c}),o}}function G(e,t){let n=t.readIdentity();return e.pid===n.pid&&n.startTime!==null&&e.processStartTime===n.startTime}function je(e){let t=oe();return re({paths:e.paths,serverMode:e.serverMode,env:e.host.env,cwd:e.host.cwd,ownedStateDir:e.ownedStateDir,args:t.useSrc?[`--experimental-strip-types`,t.srcPath]:[t.distPath]})}function Me(e){return e.error?`daemon process ${e.pid} failed to start: ${e.error}`:e.signal?`daemon process ${e.pid} exited before readiness with signal ${e.signal}`:`daemon process ${e.pid} exited before readiness with code ${e.exitCode??0}`}function Ne(e){return K(e,64e3)}function K(e,t){try{if(!T.existsSync(e))return;let n=T.statSync(e);if(n.size<=0)return;let r=Math.min(n.size,t),i=T.openSync(e,`r`);try{let e=Buffer.alloc(r);T.readSync(i,e,0,r,n.size-r);let t=e.toString(`utf8`).trim();return t.length>0?t:void 0}finally{T.closeSync(i)}}catch{return}}const q=new E.BlockList;q.addSubnet(`127.0.0.0`,8,`ipv4`),q.addAddress(`::1`,`ipv6`),q.addSubnet(`::ffff:127.0.0.0`,104,`ipv6`);function Pe(e){return e.daemonLifecycle===`attach`?`none`:`retire-unresponsive`}function Fe(t,n,r,i=`managed`,a=void 0){let o=J(t,r.env),s=Re(t,n,r.env);if(a&&s.remoteBaseUrl)throw new e(`INVALID_ARGS`,`daemonBinding names a local daemon instance and cannot be combined with a daemon base URL.`,{reason:`daemon_binding_with_remote_base_url`,daemonBaseUrl:s.remoteBaseUrl,hint:`Drop the base URL to reach the pinned daemon on its own state dir, or drop the pin to reach a remote daemon.`});a&&(i=`attach`);let c=Y(t.flags,s.remoteBaseUrl,r.env),l=i!==`attach`&&X(t,o,s.rawBaseUrl)?ie():void 0;return{host:r,paths:l?.paths??v(o,{env:r.env,cwd:r.cwd}),daemonLifecycle:i,retireIncompatibleContender:!0,transportPreference:c.preference,serverMode:c.serverMode,ownedStateDir:l,remoteBaseUrl:s.remoteBaseUrl,remoteAuthToken:s.authToken,...a?{daemonBinding:a}:{}}}function Ie(e,t){let n=J(e,t.env),r=e.flags?.daemonBaseUrl??t.env.AGENT_DEVICE_DAEMON_BASE_URL;if(!(r||X(e,n,r)))return{...n===void 0?{}:{stateDir:n},...e.flags?.daemonTransport===void 0?{}:{daemonTransport:e.flags.daemonTransport},...e.flags?.daemonServerMode===void 0?{}:{daemonServerMode:e.flags.daemonServerMode}}}function Le(e,t){let n=Y(e,void 0,t.env);return{host:t,paths:v(e.stateDir??t.env.AGENT_DEVICE_STATE_DIR,{env:t.env,cwd:t.cwd}),daemonLifecycle:`managed`,retireIncompatibleContender:!1,transportPreference:n.preference,serverMode:n.serverMode}}function J(e,t){return e.flags?.stateDir??t.AGENT_DEVICE_STATE_DIR}function Re(e,t,n){let r=e.flags?.daemonBaseUrl??n.AGENT_DEVICE_DAEMON_BASE_URL,i=Ge(r),a=t??n.AGENT_DEVICE_DAEMON_AUTH_TOKEN;return Ke(i,a),{rawBaseUrl:r,remoteBaseUrl:i,authToken:a}}function Y(t,n,r){let i=t?.daemonTransport??r.AGENT_DEVICE_DAEMON_TRANSPORT,a=g(i);if(n&&a===`socket`)throw new e(`INVALID_ARGS`,`Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.`,{daemonBaseUrl:n});let o=t?.daemonServerMode??r.AGENT_DEVICE_DAEMON_SERVER_MODE??(i===`dual`?`dual`:void 0);return{preference:a,serverMode:_(o)}}function X(e,t,n){return Q(e.command)&&!t&&!n}async function ze(e){if(e.remoteBaseUrl)return await Ve(e);let t=await Be(e);return await F(t.info,e.paths.baseDir,e.host),t}async function Be(e){let t=await A(e);return t?{info:t,startedByClient:!1}:await R(e)}async function Ve(t){let n={transport:`http`,token:t.remoteAuthToken??``,pid:0,baseUrl:t.remoteBaseUrl},r=await c(n);if(r.reachable)return n.remoteInstanceId=r.instanceId,n.remoteUpstreamInstanceId=r.upstream?.instanceId,{info:n,startedByClient:!1};throw new e(`COMMAND_FAILED`,`Remote daemon is unavailable`,{daemonBaseUrl:t.remoteBaseUrl,hint:`Verify AGENT_DEVICE_DAEMON_BASE_URL points to a reachable daemon with GET /health and POST /rpc. If this CLI was connected with connect proxy, run agent-device disconnect to return to the local daemon.`})}async function He(n,r,i,o){if(!Q(n.command)||!r.startedByClient&&!i.ownedStateDir||u(r.info)||Z(o)||$(n,o))return o;let s=await x({paths:i.paths,observed:d(r.info),mode:`graceful`,ownedStateDir:i.ownedStateDir});return a({level:s.status===`retained`?`warn`:`info`,phase:`daemon_replay_cleanup`,data:{pid:r.info.pid,...s}}),s.status!==`absent`&&s.repairCommitFailure?Ue(o,s.repairCommitFailure,s.status===`retained`?s.error:void 0):s.status===`retained`&&o?.ok?{ok:!1,error:t(new e(`COMMAND_FAILED`,`Replay completed, but daemon cleanup could not be confirmed.`,{reason:`daemon_retirement_unconfirmed`,retirement:s,stateDir:i.paths.baseDir,hint:s.error?.hint??`State and diagnostics were retained at ${i.paths.baseDir}. Resolve the reported cleanup failure before retrying.`}))}:o}function Ue(n,r,i){if(n&&!n.ok)return n;let{sessionName:a,tombstone:o}=r,s=o.sourcePath?`re-run: replay ${o.sourcePath} --save-script`:`re-run your replay <script> --save-script from the start`,c=`The repair transaction for session "${a}" completed, but committing its healed script failed at teardown: ${o.commitFailure.message}. ${s}.`;return{ok:!1,error:t(new e(`REPAIR_COMMIT_FAILED`,c,i?{cleanupFailure:i}:void 0))}}function Z(e){return!e||e.ok||e.error.code!==`REPLAY_DIVERGENCE`?!1:ee(e.error.details?.divergence)?.repairSessionHeld===!0}function We(e,t){let n=`This repair session's daemon was kept alive to continue the repair; pass --state-dir ${t} on your next command (press, replay --from, or close --save-script) to reach it.`,r=e.error.hint;return{...e,error:{...e.error,hint:r?`${r} ${n}`:n}}}function Q(e){return e===n.replay||e===n.test}function $(e,t){return e.command!==n.replay||!t||!t.ok?!1:t.data?.sessionActive===!0}function Ge(t){if(!t)return;let n;try{n=new URL(t)}catch(n){throw new e(`INVALID_ARGS`,`Invalid daemon base URL`,{daemonBaseUrl:t},n instanceof Error?n:void 0)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new e(`INVALID_ARGS`,`Daemon base URL must use http or https`,{daemonBaseUrl:t});return n.toString().replace(/\/+$/,``)}function Ke(t,n){if(!t)return;let r=new URL(t).hostname;if(!qe(r)&&!(typeof n==`string`&&n.trim().length>0))throw new e(`INVALID_ARGS`,`Remote daemon base URL for non-loopback hosts requires daemon authentication`,{daemonBaseUrl:t,hint:`Provide --daemon-auth-token or AGENT_DEVICE_DAEMON_AUTH_TOKEN when using a non-loopback remote daemon URL.`})}function qe(e){let t=e.trim().toLowerCase().replace(/^\[(.*)\]$/,`$1`);return t===`localhost`?!0:E.isIPv4(t)?q.check(t,`ipv4`):E.isIPv6(t)?q.check(t,`ipv6`):!1}function Je(e,t,n){return e.ok?$(t,e)?ue(e,n.ownedStateDir?n.paths.baseDir:void 0,n.remoteBaseUrl):e:n.ownedStateDir&&Z(e)?We(e,n.paths.baseDir):e}export{M as a,Je as attachSessionAddressHints,He as cleanupDaemonAfterRequest,ze as ensureManagedDaemon,R as i,k as n,N as r,Fe as resolveClientSettings,Ie as resolveEnsurableDaemon,Le as resolveLocalDaemonSettings,Pe as resolveTimeoutRecovery,F as t};
1
+ import{R as e,tt as t}from"./sdk-contracts.js";import{E as n}from"./back-mode.js";import{H as r,_t as i,b as a,o}from"./sdk-io.js";import"./diagnostics.js";import{i as s}from"./file.js";import"./command.js";import{a as c,c as l,d as u,f as d,m as f,o as p,p as m,u as h}from"./daemon-client.js";import{g,h as _,m as v}from"./daemon-resolution.js";import{c as y}from"./device-shell.js";import"./retry.js";import{i as ee}from"./replay-divergence.js";import{a as te,c as ne,d as b,i as re,n as ie,o as x,t as S,u as C}from"./daemon-registration-owner.js";import{i as ae}from"./daemon-registration.js";import{n as oe,r as se}from"./daemon-launch-spec.js";import{d as ce,r as le,u as w}from"./daemon-lifecycle-errors.js";import T from"node:fs";import E from"node:net";function ue(e,t,n){let r=e.data??{},i=typeof r.session==`string`?r.session:void 0,a=[...n?[`--daemon-base-url ${y(de(n))}`]:[],...t?[`--state-dir ${y(t)}`]:[],...i?[`--session ${y(i)}`]:[]];if(a.length===0)return e;let o=`This session's daemon was kept alive because its script left the session active; pass ${a.join(` `)} on your next command to reach it.`+(n?` If authentication is required, provide or configure --daemon-auth-token.`:``),s=typeof r.message==`string`?r.message:void 0;return{...e,data:{...r,hint:o,message:s?`${s} ${o}`:o}}}function de(e){let t=new URL(e);return t.username=``,t.password=``,t.search=``,t.hash=``,t.toString().replace(/\/+$/,``)}const D=6e4,O=`AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS`;function fe(t){let n=t[O]?.trim();if(n===void 0||n===``)return 12e4;let r=Number(n);if(!Number.isSafeInteger(r)||r<=0)throw new e(`INVALID_ARGS`,`${O} must be a positive integer number of milliseconds`,{value:n});return r}async function k(e,t={}){let{deadline:n}=t,r=s(e.paths.lockPath);if(r.state===`unproven`)throw j(e,r);let i=m(e.paths.infoPath);return!i||!he(r,i)||t.waitForLiveStartup&&await me(i,n)?null:{info:i,decision:await pe(i,await se(i,{onClientTransport:()=>P(i,e.transportPreference,n),onAnyAdvertisedTransport:()=>P(i,`auto`,n)}),t)}}async function pe(e,t,n){return!n.refineUnreachable||t.kind!==`replace`?t:a(e.pid)?t.cause===`unreachable`&&await P(e,`auto`,n.deadline)?{...t,cause:`transport`}:t:{...t,cause:`unreachable`}}async function A(e,t={}){let{deadline:n}=t,r=await k(e,t);if(!r)return null;let{info:i,decision:a}=r;if(a.kind===`reuse`)return i;if(a.kind===`refuseNewer`)throw ge(i,a,e.paths.baseDir);if(!e.retireIncompatibleContender)throw le();return H(n)<5e3?null:(L(i,a.reason,e.paths.baseDir),await N(i,e.paths),null)}async function me(e,t){return a(e.pid)&&!await p(e,`auto`,H(t))}function he(e,t){return e.state===`absent`||ae(e,{pid:t.pid,startTime:t.processStartTime??null})}function j(t,n){return new e(`COMMAND_FAILED`,`Daemon registration ownership could not be verified.`,{reason:`daemon_registration_unproven`,inspection:n,stateDir:t.paths.baseDir,hint:f(h(t.paths),t.paths)})}async function M(e,t,n=`graceful`){return await x({paths:t,observed:d(e),mode:n})}async function N(e,t,n=`graceful`){let r=await M(e,t,n);if(r.status===`retained`)throw ce(r,e,t)}async function P(e,t,n){if(await I(e,t,n))return!0;for(let o=1;o<=3;o+=1){if(!a(e.pid)||n!==void 0&&Date.now()>=n)return!1;if(await r(Math.min(200,H(n))),await I(e,t,n))return i({level:`warn`,phase:`daemon_probe_recovered`,data:{pid:e.pid,retry:o}}),!0}return!1}async function F(t,n,r){let{env:i}=r;if(!i.AGENT_DEVICE_DAEMON_POLICY?.trim())return;let{loadDaemonPolicy:a}=await import(`./daemon-policy-file.js`).then(e=>e.t),o=a(i,r.cwd)?.digest;if(o!==t.policyDigest)throw new e(`COMMAND_FAILED`,`The running daemon does not enforce the daemon policy named by AGENT_DEVICE_DAEMON_POLICY.`,{reason:`DAEMON_POLICY_MISMATCH`,expectedPolicyDigest:o,daemonPolicyDigest:t.policyDigest??null,hint:`Stop the running daemon (${w(n)}), then retry so a daemon starts with this policy.`})}async function I(e,t,n){try{return await p(e,t,H(n))}catch(e){if(l(e))return!1;throw e}}function ge(t,n,r){let{daemonVersion:i,clientVersion:a}=n;return new e(`COMMAND_FAILED`,`Daemon (pid ${t.pid}, v${i}) is newer than this client (v${a}); refusing to replace it.`,{daemonPid:t.pid,daemonVersion:i,clientVersion:a,hint:`Use the agent-device v${i} CLI that started it, or stop it deliberately: ${w(r)}`})}function L(e,t,n){try{let r=e.version?`pid ${e.pid}, v${e.version}`:`pid ${e.pid}`;process.stderr.write(`Replacing daemon (${r}) in ${n}: ${t}\n`)}catch{}}async function R(t){let n=fe(t.host.env),i=Date.now()+n,a=[],o,s=0;for(;s<2&&Date.now()<i;){s+=1;let e=await _e(t,i);if(`daemon`in e)return e.daemon;if(o=e,e.cleanup&&a.push(e.cleanup),!e.retry)break;await r(Math.min(150,Math.max(0,i-Date.now())))}let{startError:c,startupError:l,daemonProcess:u,reason:d,phases:p}=o??{},m=d??`startup-exited`,g=h(t.paths),_=Ne(t.paths.logPath);throw new e(`COMMAND_FAILED`,`Failed to start daemon`,{kind:`daemon_startup_failed`,reason:m,stateDir:t.paths.baseDir,infoPath:t.paths.infoPath,lockPath:t.paths.lockPath,logPath:t.paths.logPath,startupTimeoutMs:n,startupAttempts:s,cleanupResults:a,startError:c,startupError:l,daemonProcess:u,...p?{phases:Ee(p)}:{},..._?{daemonLogTail:_}:{},metadataState:g,hint:d===`startup-stalled`||d===`startup-ceiling`?De(d,n):f(g,t.paths)})}async function _e(e,n){let r,i=Date.now();try{r=je(e)}catch(t){return await ve(e,t)}let a={spawnedAtMs:i,markers:{}},o=await ye(n,e,r,a);if(o.kind===`ready`)return o.daemon.startedByClient||await V(e,r),{daemon:o.daemon};if(W(e,r.pid,a),o.kind===`retry`)return await V(e,r),{retry:!0,phases:a};if(o.kind===`unproven`){await V(e,r);let n=t(o.error);return{retry:!1,startError:n.message,startupError:n,daemonProcess:{pid:r.pid},phases:a}}let{cleanup:c,joined:l}=await z(e,r,n),u=o.kind===`stalled`?`startup-stalled`:o.kind===`ceiling`?`startup-ceiling`:`startup-exited`,d=U(s(e.paths.lockPath));return{cleanup:c,retry:l&&o.kind===`early_exit`&&d,reason:u,startError:o.kind===`early_exit`?Me(o.exit):void 0,daemonProcess:o.kind===`early_exit`?o.exit:{pid:r.pid},phases:a}}async function ve(e,n){let r=e.ownedStateDir?await x({paths:e.paths,observed:null,mode:`graceful`,ownedStateDir:e.ownedStateDir,lockTimeoutMs:0}):await te({paths:e.paths,observed:null,lockTimeoutMs:0});return{cleanup:r,startError:t(n).message,retry:!e.ownedStateDir&&r.status!==`retained`}}async function z(e,t,n){let r=await x({paths:e.paths,observed:{...t.readIdentity(),ownership:`detached`},mode:`graceful`,ownedStateDir:e.ownedStateDir,termTimeoutMs:Math.min(3e3,H(n)),killTimeoutMs:1e3,lockTimeoutMs:0}),i=await B(t);return i&&C(b(e.paths.baseDir,t.pid)),{cleanup:r,joined:i}}async function B(e){let t;try{return await Promise.race([e.exited.then(()=>!0),new Promise(e=>{t=setTimeout(()=>e(!1),1e3)})])}finally{clearTimeout(t)}}async function V(e,t){await B(t)&&C(b(e.paths.baseDir,t.pid))}function H(e){return e===void 0?1/0:Math.max(0,e-Date.now())}function U(e){return e.state===`absent`||e.state===`held`&&(e.liveness===`owner-process-dead`||e.liveness===`owner-process-reused`)}async function ye(e,t,n,i){let a;for(n.exited.then(e=>{a=e});Date.now()<e;){if(a){let n=await Ce(t,a,e);if(n)return n}else{let r=await we(t,n,e,i);if(r&&!(r.kind===`ready`&&a))return r}await r(Math.min(100,H(e)))}return be(t,n,a)}function be(e,t,n){return Se(s(e.paths.lockPath))?{kind:`ceiling`}:n?{kind:`early_exit`,exit:n}:xe(t)?{kind:`ceiling`}:{kind:`exit_unobserved`}}function xe(e){if(!a(e.pid))return!1;let t=e.readIdentity();return!t.startTime||o({owner:t})!==`owner-process-reused`}function Se(e){return e.state===`held`&&e.liveness!==`owner-process-dead`&&e.liveness!==`owner-process-reused`}async function Ce(e,t,n){let r=Oe(t);return r===`unproven`?{kind:`unproven`,error:j(e)}:r===`failed`?{kind:`early_exit`,exit:t}:await ke(e,n)}async function we(e,t,n,r){let i=await Ae(e,t,n);return i?{kind:`ready`,daemon:{info:i,startedByClient:!0}}:(W(e,t.pid,r),a(t.pid)&&Date.now()-Te(r)>=D?{kind:`stalled`}:null)}function W(e,t,n){let r=K(b(e.paths.baseDir,t),16e3);if(r)for(let[e,t]of Object.entries(ne(r)))n.markers[e]=t}function Te(e){return Object.values(e.markers).reduce((e,t)=>Math.max(e,t),e.spawnedAtMs)}function Ee(e){let t={spawned:0};for(let[n,r]of Object.entries(e.markers))t[n]=Math.max(0,r-e.spawnedAtMs);return t}function De(e,t){return e===`startup-stalled`?`The daemon is alive but made no startup progress for ${D/1e3} s. The host can be overloaded. Retry once the host load drops; ${O} raises only the registration ceiling and does not change this stall window.`:`The daemon is alive but did not register within ${Math.round(t/1e3)} s. The host can be overloaded. Retry, or raise ${O}.`}function Oe(e){if(e.error||e.signal)return`failed`;switch(e.exitCode){case S.busy:return`busy`;case S.unproven:return`unproven`;default:return`failed`}}async function ke(t,n){let r;try{r=await A(t,{deadline:n,waitForLiveStartup:!0})}catch(t){if(t instanceof e&&t.details?.reason===`daemon_registration_unproven`)return{kind:`unproven`,error:t};throw t}if(Date.now()>=n)return null;if(r)return{kind:`ready`,daemon:{info:r,startedByClient:!1}};let i=s(t.paths.lockPath);return i.state===`unproven`?{kind:`unproven`,error:j(t,i)}:U(i)?{kind:`retry`}:null}async function Ae(n,r,a){let o=m(n.paths.infoPath);if(!o||!G(o,r))return null;try{return await p(o,n.transportPreference,H(a))&&Date.now()<a?o:null}catch(o){let{cleanup:s,joined:c}=await z(n,r,a);throw i({level:`warn`,phase:`daemon_startup_observation_failed`,data:{stateDir:n.paths.baseDir,cleanup:s,joined:c,error:t(o)}}),o instanceof e&&(o.details={...o.details,stateDir:n.paths.baseDir,cleanupResults:[s],startupJoined:c}),o}}function G(e,t){let n=t.readIdentity();return e.pid===n.pid&&n.startTime!==null&&e.processStartTime===n.startTime}function je(e){let t=oe();return re({paths:e.paths,serverMode:e.serverMode,env:e.host.env,cwd:e.host.cwd,ownedStateDir:e.ownedStateDir,args:t.useSrc?[`--experimental-strip-types`,t.srcPath]:[t.distPath]})}function Me(e){return e.error?`daemon process ${e.pid} failed to start: ${e.error}`:e.signal?`daemon process ${e.pid} exited before readiness with signal ${e.signal}`:`daemon process ${e.pid} exited before readiness with code ${e.exitCode??0}`}function Ne(e){return K(e,64e3)}function K(e,t){try{if(!T.existsSync(e))return;let n=T.statSync(e);if(n.size<=0)return;let r=Math.min(n.size,t),i=T.openSync(e,`r`);try{let e=Buffer.alloc(r);T.readSync(i,e,0,r,n.size-r);let t=e.toString(`utf8`).trim();return t.length>0?t:void 0}finally{T.closeSync(i)}}catch{return}}const q=new E.BlockList;q.addSubnet(`127.0.0.0`,8,`ipv4`),q.addAddress(`::1`,`ipv6`),q.addSubnet(`::ffff:127.0.0.0`,104,`ipv6`);function Pe(e){return e.daemonLifecycle===`attach`?`none`:`retire-unresponsive`}function Fe(t,n,r,i=`managed`,a=void 0){let o=J(t,r.env),s=Re(t,n,r.env);if(a&&s.remoteBaseUrl)throw new e(`INVALID_ARGS`,`daemonBinding names a local daemon instance and cannot be combined with a daemon base URL.`,{reason:`daemon_binding_with_remote_base_url`,daemonBaseUrl:s.remoteBaseUrl,hint:`Drop the base URL to reach the pinned daemon on its own state dir, or drop the pin to reach a remote daemon.`});a&&(i=`attach`);let c=Y(t.flags,s.remoteBaseUrl,r.env),l=i!==`attach`&&X(t,o,s.rawBaseUrl)?ie():void 0;return{host:r,paths:l?.paths??v(o,{env:r.env,cwd:r.cwd}),daemonLifecycle:i,retireIncompatibleContender:!0,transportPreference:c.preference,serverMode:c.serverMode,ownedStateDir:l,remoteBaseUrl:s.remoteBaseUrl,remoteAuthToken:s.authToken,...a?{daemonBinding:a}:{}}}function Ie(e,t){let n=J(e,t.env),r=e.flags?.daemonBaseUrl??t.env.AGENT_DEVICE_DAEMON_BASE_URL;if(!(r||X(e,n,r)))return{...n===void 0?{}:{stateDir:n},...e.flags?.daemonTransport===void 0?{}:{daemonTransport:e.flags.daemonTransport},...e.flags?.daemonServerMode===void 0?{}:{daemonServerMode:e.flags.daemonServerMode}}}function Le(e,t){let n=Y(e,void 0,t.env);return{host:t,paths:v(e.stateDir??t.env.AGENT_DEVICE_STATE_DIR,{env:t.env,cwd:t.cwd}),daemonLifecycle:`managed`,retireIncompatibleContender:!1,transportPreference:n.preference,serverMode:n.serverMode}}function J(e,t){return e.flags?.stateDir??t.AGENT_DEVICE_STATE_DIR}function Re(e,t,n){let r=e.flags?.daemonBaseUrl??n.AGENT_DEVICE_DAEMON_BASE_URL,i=Ge(r),a=t??n.AGENT_DEVICE_DAEMON_AUTH_TOKEN;return Ke(i,a),{rawBaseUrl:r,remoteBaseUrl:i,authToken:a}}function Y(t,n,r){let i=t?.daemonTransport??r.AGENT_DEVICE_DAEMON_TRANSPORT,a=g(i);if(n&&a===`socket`)throw new e(`INVALID_ARGS`,`Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.`,{daemonBaseUrl:n});let o=t?.daemonServerMode??r.AGENT_DEVICE_DAEMON_SERVER_MODE??(i===`dual`?`dual`:void 0);return{preference:a,serverMode:_(o)}}function X(e,t,n){return Q(e.command)&&!t&&!n}async function ze(e){if(e.remoteBaseUrl)return await Ve(e);let t=await Be(e);return await F(t.info,e.paths.baseDir,e.host),t}async function Be(e){let t=await A(e);return t?{info:t,startedByClient:!1}:await R(e)}async function Ve(t){let n={transport:`http`,token:t.remoteAuthToken??``,pid:0,baseUrl:t.remoteBaseUrl},r=await c(n);if(r.reachable)return n.remoteInstanceId=r.instanceId,n.remoteUpstreamInstanceId=r.upstream?.instanceId,{info:n,startedByClient:!1};throw new e(`COMMAND_FAILED`,`Remote daemon is unavailable`,{daemonBaseUrl:t.remoteBaseUrl,hint:`Verify AGENT_DEVICE_DAEMON_BASE_URL points to a reachable daemon with GET /health and POST /rpc. If this CLI was connected with connect proxy, run agent-device disconnect to return to the local daemon.`})}async function He(n,r,a,o){if(!Q(n.command)||!r.startedByClient&&!a.ownedStateDir||u(r.info)||Z(o)||$(n,o))return o;let s=await x({paths:a.paths,observed:d(r.info),mode:`graceful`,ownedStateDir:a.ownedStateDir});return i({level:s.status===`retained`?`warn`:`info`,phase:`daemon_replay_cleanup`,data:{pid:r.info.pid,...s}}),s.status!==`absent`&&s.repairCommitFailure?Ue(o,s.repairCommitFailure,s.status===`retained`?s.error:void 0):s.status===`retained`&&o?.ok?{ok:!1,error:t(new e(`COMMAND_FAILED`,`Replay completed, but daemon cleanup could not be confirmed.`,{reason:`daemon_retirement_unconfirmed`,retirement:s,stateDir:a.paths.baseDir,hint:s.error?.hint??`State and diagnostics were retained at ${a.paths.baseDir}. Resolve the reported cleanup failure before retrying.`}))}:o}function Ue(n,r,i){if(n&&!n.ok)return n;let{sessionName:a,tombstone:o}=r,s=o.sourcePath?`re-run: replay ${o.sourcePath} --save-script`:`re-run your replay <script> --save-script from the start`,c=`The repair transaction for session "${a}" completed, but committing its healed script failed at teardown: ${o.commitFailure.message}. ${s}.`;return{ok:!1,error:t(new e(`REPAIR_COMMIT_FAILED`,c,i?{cleanupFailure:i}:void 0))}}function Z(e){return!e||e.ok||e.error.code!==`REPLAY_DIVERGENCE`?!1:ee(e.error.details?.divergence)?.repairSessionHeld===!0}function We(e,t){let n=`This repair session's daemon was kept alive to continue the repair; pass --state-dir ${t} on your next command (press, replay --from, or close --save-script) to reach it.`,r=e.error.hint;return{...e,error:{...e.error,hint:r?`${r} ${n}`:n}}}function Q(e){return e===n.replay||e===n.test}function $(e,t){return e.command!==n.replay||!t||!t.ok?!1:t.data?.sessionActive===!0}function Ge(t){if(!t)return;let n;try{n=new URL(t)}catch(n){throw new e(`INVALID_ARGS`,`Invalid daemon base URL`,{daemonBaseUrl:t},n instanceof Error?n:void 0)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new e(`INVALID_ARGS`,`Daemon base URL must use http or https`,{daemonBaseUrl:t});return n.toString().replace(/\/+$/,``)}function Ke(t,n){if(!t)return;let r=new URL(t).hostname;if(!qe(r)&&!(typeof n==`string`&&n.trim().length>0))throw new e(`INVALID_ARGS`,`Remote daemon base URL for non-loopback hosts requires daemon authentication`,{daemonBaseUrl:t,hint:`Provide --daemon-auth-token or AGENT_DEVICE_DAEMON_AUTH_TOKEN when using a non-loopback remote daemon URL.`})}function qe(e){let t=e.trim().toLowerCase().replace(/^\[(.*)\]$/,`$1`);return t===`localhost`?!0:E.isIPv4(t)?q.check(t,`ipv4`):E.isIPv6(t)?q.check(t,`ipv6`):!1}function Je(e,t,n){return e.ok?$(t,e)?ue(e,n.ownedStateDir?n.paths.baseDir:void 0,n.remoteBaseUrl):e:n.ownedStateDir&&Z(e)?We(e,n.paths.baseDir):e}export{M as a,Je as attachSessionAddressHints,He as cleanupDaemonAfterRequest,ze as ensureManagedDaemon,R as i,k as n,N as r,Fe as resolveClientSettings,Ie as resolveEnsurableDaemon,Le as resolveLocalDaemonSettings,Pe as resolveTimeoutRecovery,F as t};
@@ -1 +1 @@
1
- import{T as e}from"./back-mode.js";import{mt as t}from"./sdk-io.js";import"./diagnostics.js";import{n,t as r}from"./transport.js";import i from"node:net";async function a(e,t={}){let n=Date.now()+1e3,r=[];return e.httpPort&&r.push(s(e.httpPort,n)),e.port&&r.push(c(e.port,e.token,t.session,n)),r.length!==0&&await new Promise(e=>{let t=r.length,n=n=>{if(n){for(let e of r)e.cancel();e(!0);return}--t===0&&e(!1)};for(let e of r)e.answer.then(n,()=>n(!1))})}function o(e){let t=!1,n,r=()=>{},i=new Promise(e=>{r=e}),a=setTimeout(()=>o(!1),Math.max(1,e-Date.now()));a.unref?.();function o(e){t||(t=!0,clearTimeout(a),n?.(),r(e))}return{leg:{answer:i,cancel:()=>o(!1)},settle:o,attach:e=>{n=e,t&&e()}}}function s(e,t){let r=o(t);return(async()=>{try{let t=(await n(`http:`)).request({host:`127.0.0.1`,port:String(e),path:`/health`,method:`GET`,agent:!1},e=>{e.resume(),r.settle(!0)});t.on(`error`,()=>r.settle(!1)),r.attach(()=>t.destroy()),t.end()}catch{r.settle(!1)}})(),r.leg}function c(e,t,n,a){let s=o(a),c;try{c=i.createConnection({host:`127.0.0.1`,port:e})}catch{return s.settle(!1),s.leg}s.attach(()=>c.destroy());let u=l(t,n),d=``;return c.setEncoding(`utf8`),c.on(`connect`,()=>{c.write(`${JSON.stringify(u)}\n`)}),c.on(`data`,e=>{let t=r(d,e);d=t.buffer,t.lines.length>0&&s.settle(!0)}),c.on(`error`,()=>s.settle(!1)),c.on(`close`,()=>s.settle(!1)),s.leg}function l(n,r){return{token:n,session:r||`default`,command:e.sessionList,positionals:[],flags:{},meta:{requestId:t()}}}export{a as probeDaemonResponsive};
1
+ import{T as e}from"./back-mode.js";import{gt as t}from"./sdk-io.js";import"./diagnostics.js";import{n,t as r}from"./transport.js";import i from"node:net";async function a(e,t={}){let n=Date.now()+1e3,r=[];return e.httpPort&&r.push(s(e.httpPort,n)),e.port&&r.push(c(e.port,e.token,t.session,n)),r.length!==0&&await new Promise(e=>{let t=r.length,n=n=>{if(n){for(let e of r)e.cancel();e(!0);return}--t===0&&e(!1)};for(let e of r)e.answer.then(n,()=>n(!1))})}function o(e){let t=!1,n,r=()=>{},i=new Promise(e=>{r=e}),a=setTimeout(()=>o(!1),Math.max(1,e-Date.now()));a.unref?.();function o(e){t||(t=!0,clearTimeout(a),n?.(),r(e))}return{leg:{answer:i,cancel:()=>o(!1)},settle:o,attach:e=>{n=e,t&&e()}}}function s(e,t){let r=o(t);return(async()=>{try{let t=(await n(`http:`)).request({host:`127.0.0.1`,port:String(e),path:`/health`,method:`GET`,agent:!1},e=>{e.resume(),r.settle(!0)});t.on(`error`,()=>r.settle(!1)),r.attach(()=>t.destroy()),t.end()}catch{r.settle(!1)}})(),r.leg}function c(e,t,n,a){let s=o(a),c;try{c=i.createConnection({host:`127.0.0.1`,port:e})}catch{return s.settle(!1),s.leg}s.attach(()=>c.destroy());let u=l(t,n),d=``;return c.setEncoding(`utf8`),c.on(`connect`,()=>{c.write(`${JSON.stringify(u)}\n`)}),c.on(`data`,e=>{let t=r(d,e);d=t.buffer,t.lines.length>0&&s.settle(!0)}),c.on(`error`,()=>s.settle(!1)),c.on(`close`,()=>s.settle(!1)),s.leg}function l(n,r){return{token:n,session:r||`default`,command:e.sessionList,positionals:[],flags:{},meta:{requestId:t()}}}export{a as probeDaemonResponsive};