agent-device 0.20.3 → 0.20.4

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

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

package/android/ime-helper/dist/{agent-device-android-ime-helper-0.20.3.manifest.json → agent-device-android-ime-helper-0.20.4.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-ime-helper",
-  "version": "0.20.3",
-  "assetName": "agent-device-android-ime-helper-0.20.3.apk",
-  "sha256": "02777b8c7e55044210eafa255ac92e627977679d75ba4a97f563f3e23dea3267",
+  "version": "0.20.4",
+  "assetName": "agent-device-android-ime-helper-0.20.4.apk",
+  "sha256": "019ebbda52976df5cff05f9e5a764c8d6e280be3640e8dea0a2d7cca6c25021f",
   "packageName": "com.callstack.agentdevice.imehelper",
-  "versionCode": 20003,
+  "versionCode": 20004,
   "serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
   "broadcastProtocol": "android-ime-helper-v1"
 }

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

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

package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.20.3.manifest.json → agent-device-android-snapshot-helper-0.20.4.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.20.3",
-  "releaseTag": "v0.20.3",
-  "assetName": "agent-device-android-snapshot-helper-0.20.3.apk",
+  "version": "0.20.4",
+  "releaseTag": "v0.20.4",
+  "assetName": "agent-device-android-snapshot-helper-0.20.4.apk",
   "apkUrl": null,
-  "sha256": "de7ecffc80d54dd1c173d3bf445ff8c9a02de2d124bcf39abeafeb5a6a08c95e",
-  "checksumName": "agent-device-android-snapshot-helper-0.20.3.apk.sha256",
+  "sha256": "e3799afe5549776e047744efe46939a9146a4742a5328bb2e22f0b9d6abd2b52",
+  "checksumName": "agent-device-android-snapshot-helper-0.20.4.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 20003,
+  "versionCode": 20004,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift

@@ -922,6 +922,49 @@ extension RunnerTests {
             x: touchPoint.x,
             y: touchPoint.y
           )
+          var fallback: GestureFallback?
+          if command.synthesized == true {
+            let policyKind = SynthesizedGesturePolicyKind.coordinateTap
+            let context = synthesizedCoordinateContext(
+              app: activeApp,
+              policy: synthesizedGesturePolicy(policyKind)
+            )
+            let (timing, outcome) = performGesture(activeApp, idleTimeout: false) {
+              synthesizedTapAt(
+                app: activeApp,
+                x: touchPoint.x,
+                y: touchPoint.y,
+                context: context
+              )
+            }
+            if case .performed = outcome {
+              logSynthesizedGesturePolicyDecision(
+                kind: policyKind,
+                context: context,
+                fallbackAttempted: false
+              )
+              if isTextEntry {
+                waitForTextEntryReadinessAfterTap(app: activeApp, element: element)
+              }
+              return gestureResponse(
+                message: match.usedNonHittableFallback
+                  ? "tapped via non-hittable coordinate fallback"
+                  : "tapped",
+                timing: timing,
+                frame: .touch(touchFrame),
+                maestroNonHittableCoordinateFallbackUsed:
+                  command.allowNonHittableCoordinateFallback == true
+                  ? match.usedNonHittableFallback
+                  : nil
+              )
+            }
+            logSynthesizedGesturePolicyDecision(
+              kind: policyKind,
+              context: context,
+              fallbackAttempted: true
+            )
+            fallback = gestureFallback(strategy: "xctest-coordinate-tap", from: outcome)
+          }
           let (timing, outcome) = performGesture(activeApp) {
             if expectedPoint != nil || match.usedNonHittableFallback {
               // Maestro compatibility: RN E2E backdoor controls can be 1x1 and
@@ -942,6 +985,7 @@ extension RunnerTests {
             message: match.usedNonHittableFallback ? "tapped via non-hittable coordinate fallback" : "tapped",
             timing: timing,
             frame: .touch(touchFrame),
+            fallback: fallback,
             maestroNonHittableCoordinateFallbackUsed:
               command.allowNonHittableCoordinateFallback == true
               ? match.usedNonHittableFallback
@@ -954,7 +998,10 @@ extension RunnerTests {
         var fallback: GestureFallback?
         if command.synthesized == true {
           let policyKind = SynthesizedGesturePolicyKind.coordinateTap
-          let context = synthesizedCoordinateContext(policy: synthesizedGesturePolicy(policyKind))
+          let context = synthesizedCoordinateContext(
+            app: activeApp,
+            policy: synthesizedGesturePolicy(policyKind)
+          )
           let (timing, outcome) = performGesture(activeApp, idleTimeout: false) {
             synthesizedTapAt(app: activeApp, x: x, y: y, context: context)
           }
@@ -1045,7 +1092,10 @@ extension RunnerTests {
         )
       }
       let scrollPolicyKind = SynthesizedGesturePolicyKind.scroll
-      guard let scrollContext = synthesizedCoordinateContext(policy: synthesizedGesturePolicy(scrollPolicyKind)) else {
+      guard let scrollContext = synthesizedCoordinateContext(
+        app: activeApp,
+        policy: synthesizedGesturePolicy(scrollPolicyKind)
+      ) else {
         return Response(
           ok: false,
           error: ErrorPayload(message: "scroll could not resolve a usable interaction frame")
@@ -1439,7 +1489,10 @@ extension RunnerTests {
     var fallback: GestureFallback?
     if synthesized {
       let durationMs = min(max(durationMs ?? 250, 16), 10000)
-      let context = synthesizedCoordinateContext(policy: synthesizedGesturePolicy(synthesizedPolicyKind))
+      let context = synthesizedCoordinateContext(
+        app: activeApp,
+        policy: synthesizedGesturePolicy(synthesizedPolicyKind)
+      )
       let (timing, outcome) = performGesture(activeApp, idleTimeout: false) {
         synthesizedDragAt(
           app: activeApp,
@@ -1495,7 +1548,7 @@ extension RunnerTests {
   ) -> Response? {
 #if os(iOS)
     let policy = synthesizedGesturePolicy(policyKind)
-    let context = context ?? synthesizedCoordinateContext(policy: policy)
+    let context = context ?? synthesizedCoordinateContext(app: activeApp, policy: policy)
     guard let plan = axFreeSynthesizedDragPlan(
       app: activeApp,
       x: x,

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift

@@ -617,7 +617,10 @@ extension RunnerTests {
       )
     }
     let orientation = Int(RunnerSynthesizedGesture.interfaceOrientation(forApplication: app))
-    guard let context = context ?? synthesizedCoordinateContext(policy: synthesizedGesturePolicy(.synthesizedDrag)) else {
+    guard let context = context ?? synthesizedCoordinateContext(
+      app: app,
+      policy: synthesizedGesturePolicy(.synthesizedDrag)
+    ) else {
       return .unsupported(
         message: "synthesized coordinate drag could not resolve a finite screen frame",
         hint: "Retry after the app is foregrounded, or use a plain screenshot to choose coordinates."
@@ -680,7 +683,10 @@ extension RunnerTests {
       )
     }
     let orientation = Int(RunnerSynthesizedGesture.interfaceOrientation(forApplication: app))
-    guard let context = context ?? synthesizedCoordinateContext(policy: synthesizedGesturePolicy(.coordinateTap)) else {
+    guard let context = context ?? synthesizedCoordinateContext(
+      app: app,
+      policy: synthesizedGesturePolicy(.coordinateTap)
+    ) else {
       return .unsupported(
         message: "synthesized coordinate tap could not resolve a finite screen frame",
         hint: "Retry after the app is foregrounded, or use a plain screenshot to choose coordinates."
@@ -852,7 +858,10 @@ extension RunnerTests {
     context: SynthesizedCoordinateContext? = nil
   ) -> SynthesizedDragPlan? {
 #if os(iOS)
-    let context = context ?? synthesizedCoordinateContext(policy: synthesizedGesturePolicy(.synthesizedDrag))
+    let context = context ?? synthesizedCoordinateContext(
+      app: app,
+      policy: synthesizedGesturePolicy(.synthesizedDrag)
+    )
     guard x.isFinite, y.isFinite, x2.isFinite, y2.isFinite,
       let context
     else {
@@ -892,11 +901,18 @@ extension RunnerTests {
     )
   }
 
-  func synthesizedCoordinateContext(policy: SynthesizedGesturePolicy) -> SynthesizedCoordinateContext? {
+  func synthesizedCoordinateContext(
+    app: XCUIApplication,
+    policy: SynthesizedGesturePolicy
+  ) -> SynthesizedCoordinateContext? {
 #if os(iOS)
     let health = runnerAccessibilityHealth
-    guard let referenceFrame = synthesizedScreenshotReferenceFrame(
-      screenshotSize: { XCUIScreen.main.screenshot().image.size }
+    let orientation = Int(
+      RunnerSynthesizedGesture.interfaceOrientation(forApplication: app)
+    )
+    guard let referenceFrame = orientedSynthesizedScreenshotReferenceFrame(
+      screenshotSize: XCUIScreen.main.screenshot().image.size,
+      interfaceOrientation: orientation
     ) else {
       return nil
     }
@@ -911,15 +927,35 @@ extension RunnerTests {
 #endif
   }
 
-  func synthesizedScreenshotReferenceFrame(screenshotSize: () -> CGSize) -> CGRect? {
-    let screenshotSize = screenshotSize()
+  func orientedSynthesizedScreenshotReferenceFrame(
+    screenshotSize: CGSize,
+    interfaceOrientation: Int
+  ) -> CGRect? {
+    // Physical iOS screenshots can retain portrait dimensions after the interface rotates,
+    // while accessibility frames remain in the logical landscape coordinate space.
     guard screenshotSize.width.isFinite, screenshotSize.height.isFinite,
       screenshotSize.width > 0,
       screenshotSize.height > 0
     else {
       return nil
     }
-    return CGRect(x: 0, y: 0, width: screenshotSize.width, height: screenshotSize.height)
+    let isLandscape = interfaceOrientation == RunnerInterfaceOrientation.landscapeLeft
+      || interfaceOrientation == RunnerInterfaceOrientation.landscapeRight
+    let isPortrait = interfaceOrientation == RunnerInterfaceOrientation.portrait
+      || interfaceOrientation == RunnerInterfaceOrientation.portraitUpsideDown
+    let width: CGFloat
+    let height: CGFloat
+    if isLandscape {
+      width = max(screenshotSize.width, screenshotSize.height)
+      height = min(screenshotSize.width, screenshotSize.height)
+    } else if isPortrait {
+      width = min(screenshotSize.width, screenshotSize.height)
+      height = max(screenshotSize.width, screenshotSize.height)
+    } else {
+      width = screenshotSize.width
+      height = screenshotSize.height
+    }
+    return CGRect(x: 0, y: 0, width: width, height: height)
   }
 
   func synthesizedFrameAvoidingKeyboardWhenAllowed(

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Keyboard.swift

@@ -2,6 +2,23 @@ import XCTest
 
 private enum KeyboardDismissObservationTiming {
   static let timeout: TimeInterval = 2
+  // #1542: dismissing the keyboard can trigger the host app's own content-offset
+  // adjustment (e.g. a ScrollView correcting the inset it grew to keep a focused
+  // field above the keyboard). That adjustment is a separate, unsynchronized
+  // animation the keyboard's own `waitForNonExistence` above knows nothing about:
+  // the keyboard AX element can vanish well before the app settles. The very next
+  // command is frequently a synthesized, AX-free drag (scroll/gesture — kept
+  // AX-free so it still works under #1105-family AX degradation), which has no
+  // XCTest quiescence wait of its own, so it can land mid-animation and net to
+  // zero. These bounds cap the settle wait this trades in.
+  // A spring-driven content-offset correction can pass through a near-zero-
+  // velocity inflection (the top of an overshoot) that two adjacent samples
+  // alone cannot distinguish from true rest. Requiring 3 consecutive matching
+  // samples demands ~2 full sample intervals of actual stillness before
+  // stopping early, so a momentary pause mid-animation cannot look settled.
+  static let settleTimeout: TimeInterval = 2.0
+  static let settleSampleInterval: TimeInterval = 0.15
+  static let settleRequiredConsecutiveMatches: Int = 3
 }
 
 extension RunnerTests {
@@ -24,6 +41,11 @@ extension RunnerTests {
 #else
     if tapKeyboardDismissControl(app: app) {
       _ = keyboard.waitForNonExistence(timeout: KeyboardDismissObservationTiming.timeout)
+      waitForScreenshotStability(
+        timeout: KeyboardDismissObservationTiming.settleTimeout,
+        sampleInterval: KeyboardDismissObservationTiming.settleSampleInterval,
+        requiredConsecutiveMatches: KeyboardDismissObservationTiming.settleRequiredConsecutiveMatches
+      )
       let visible = isKeyboardVisible(app: app)
       return (wasVisible: true, dismissed: !visible, visible: visible)
     }
@@ -32,6 +54,35 @@ extension RunnerTests {
 #endif
   }
 
+  // AX-free on purpose (screenshot bytes, not the accessibility tree) so it holds
+  // under the same AX degradation the synthesized gesture lane is built to survive.
+  // Bounded and self-terminating: returns as soon as `requiredConsecutiveMatches`
+  // consecutive samples match, so an already-settled screen (the common case)
+  // pays close to nothing. The stopping decision itself
+  // (`runnerScreenshotStabilitySettled`) is a pure function of the samples taken
+  // so far, so it is unit-testable without a real screenshot pipeline; this loop
+  // is the thin, untestable I/O shell around it.
+  private func waitForScreenshotStability(
+    timeout: TimeInterval,
+    sampleInterval: TimeInterval,
+    requiredConsecutiveMatches: Int
+  ) {
+    let deadline = Date().addingTimeInterval(timeout)
+    var samples: [Data?] = [screenshotFingerprintForStabilityCheck()]
+    while Date() < deadline {
+      sleepFor(sampleInterval)
+      samples.append(screenshotFingerprintForStabilityCheck())
+      if runnerScreenshotStabilitySettled(samples, requiredConsecutiveMatches: requiredConsecutiveMatches) {
+        return
+      }
+    }
+  }
+
+  private func screenshotFingerprintForStabilityCheck() -> Data? {
+    guard let image = captureRunnerFrame() else { return nil }
+    return runnerPngData(for: image)
+  }
+
   func pressKeyboardReturn(app: XCUIApplication) -> (wasVisible: Bool, pressed: Bool, visible: Bool) {
 #if os(tvOS)
     return (wasVisible: false, pressed: pressTvRemote(.select), visible: false)
@@ -182,3 +233,25 @@ extension RunnerTests {
     return frame.intersects(keyboardFrame) || abs(frame.maxY - keyboardFrame.minY) <= 80
   }
 }
+
+/// True once the `requiredConsecutiveMatches` most recent samples are all present
+/// and byte-identical — i.e. the screen held still across that whole run of
+/// polls, not just the last two. A spring-driven content-offset correction can
+/// pass through a near-zero-velocity inflection that two adjacent samples alone
+/// cannot distinguish from true rest; requiring a longer run of matches demands
+/// real elapsed stillness before stopping early. `nil` entries (a screenshot
+/// capture that failed) never count toward a match, so a flaky capture cannot
+/// look like stability; the caller's bounded loop still terminates on its
+/// deadline regardless.
+func runnerScreenshotStabilitySettled(
+  _ samples: [Data?],
+  requiredConsecutiveMatches: Int
+) -> Bool {
+  guard requiredConsecutiveMatches >= 2, samples.count >= requiredConsecutiveMatches else {
+    return false
+  }
+  let window = samples.suffix(requiredConsecutiveMatches)
+  guard let first = window.first, let firstData = first else { return false }
+  return window.allSatisfy { $0 == firstData }
+}
+

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift

@@ -118,6 +118,7 @@ extension RunnerTests {
     }
     let before = captureNavigationFallbackVisualState()
     let context = synthesizedCoordinateContext(
+      app: app,
       policy: synthesizedGesturePolicy(.coordinateTap)
     )?.withReferenceFrame(frame)
     let synthesized = performGesture(app, idleTimeout: false) {

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+ScrollGesture.swift

@@ -1,10 +1,11 @@
 import XCTest
 
-// Swift port of buildScrollGesturePlan from src/contracts/scroll-gesture.ts.
+// Swift port of buildScrollGesturePlan from packages/contracts/src/scroll-gesture.ts.
 //
 // This is a deliberate two-place invariant: the daemon keeps the TS implementation (for Android,
 // recording, and reported-pixels), and the runner places the gesture with this Swift copy. The
-// parity test vectors at the bottom of this file mirror src/contracts/scroll-gesture.test.ts —
+// parity test vectors at the bottom of this file mirror
+// packages/contracts/src/scroll-gesture.test.ts —
 // if you change the math in either language, update the other and both vector sets.
 //
 // All inputs here are positive (reference dims, travel, center), so Swift's `.rounded()`

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift

@@ -40,7 +40,7 @@ extension RunnerTests {
       ? resolvedTouchVisualizationFrame(app: activeApp, x: firstStep.x!, y: firstStep.y!)
       : nil
 
-    let synthesizedContext = synthesizedSequenceCoordinateContext(steps: steps)
+    let synthesizedContext = synthesizedSequenceCoordinateContext(steps: steps, app: activeApp)
 
     let execution = assembleSequenceExecution(steps: steps) { _, step in
       performSequenceStep(step, activeApp: activeApp, synthesizedContext: synthesizedContext)

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift

@@ -108,9 +108,15 @@ func sequenceHasSynthesizedCoordinateStep(_ steps: [SequenceStep]) -> Bool {
 }
 
 extension RunnerTests {
-  func synthesizedSequenceCoordinateContext(steps: [SequenceStep]) -> SynthesizedCoordinateContext? {
+  func synthesizedSequenceCoordinateContext(
+    steps: [SequenceStep],
+    app: XCUIApplication
+  ) -> SynthesizedCoordinateContext? {
     guard sequenceHasSynthesizedCoordinateStep(steps) else { return nil }
-    return synthesizedCoordinateContext(policy: synthesizedGesturePolicy(.synthesizedDrag))
+    return synthesizedCoordinateContext(
+      app: app,
+      policy: synthesizedGesturePolicy(.synthesizedDrag)
+    )
   }
 
   func logSynthesizedGesturePolicyDecision(

package/dist/src/agent-browser-tool.js

@@ -1 +1 @@
-import{t as e}from"./rolldown-runtime.js";import{_ as t,v as n}from"./sdk-contracts.js";import{T as r,j as i,v as a}from"./sdk-android-adb.js";import{c as o,i as s,o as c,t as l}from"./host-process.js";import{t as u}from"./process-lock.js";import d from"node:crypto";import f from"node:fs";import p from"node:os";import m from"node:path";const h=new Map;function g(e){let t=d.createHash(`sha256`);return t.update(m.resolve(e.stateDir)),t.update(`\0`),t.update(m.resolve(e.installDir)),`--agent-device-managed-web=${t.digest(`hex`).slice(0,16)}`}function _(e,t){let n=g(t),r=e?.trim();return r?T(r).includes(n)?r:`${r},${n}`:n}function v(e){return E(e.AGENT_BROWSER_IDLE_TIMEOUT_MS)??E(e.AGENT_DEVICE_WEB_IDLE_TIMEOUT_MS)??3e5}function y(e,t){if(e.pid!==process.pid&&D(e.command)){if(e.command.includes(g(t)))return{process:e,reason:`launch-marker`};if(O(t).some(t=>j(e,t)))return{process:e,reason:`managed-browser-home`}}}function b(e,t){let n=e.flatMap(e=>{let n=y(e,t);return n?[n]:[]});return{count:n.length,pids:n.map(e=>e.process.pid),processes:n}}async function x(e){return b(await w(),e)}async function S(e,t,n={}){let r=k([...n.openWebSessionNames??[]]);if(r.length>0)return A(`open-web-session`,{openWebSessionNames:r});let a=v(process.env),s=N(e);if(s!==void 0&&Date.now()-s<a)return A(`recent-browser-activity`,{idleTimeoutMs:a,latestActivityMs:s});let c=await w(),u=b(c,e),d=l(u.processes.map(e=>e.process.pid),c).map(e=>e.pid),f={...u,signalPids:d};return u.count===0?f:(i({level:`warn`,phase:`web_agent_browser_orphan_cleanup`,data:{reason:t,count:u.count,pids:u.pids,signalPids:d,stateDir:e.stateDir,installDir:e.installDir,matchReasons:u.processes.map(e=>e.reason)}}),await o({pids:d,termTimeoutMs:1500,killTimeoutMs:1e3}),f)}async function C(e,t={}){let n=Date.now(),r=m.resolve(e.stateDir),i=h.get(r);if(!(i!==void 0&&n-i<3e4))return h.set(r,n),await S(e,`provider-startup`,t)}async function w(){return await r(async()=>await s({timeoutMs:1500}))}function T(e){return e.split(/[,\n]/).map(e=>e.trim()).filter(Boolean)}function E(e){if(e===void 0||e.trim()===``)return;let t=Number.parseInt(e,10);return Number.isInteger(t)&&t>0?t:void 0}function D(e){return/\b(?:Google Chrome for Testing|Chrome for Testing|Chromium|chrome|chrome\.exe|chromium|chromium-browser|headless_shell)\b/i.test(e)}function O(e){return k([m.join(e.homeDir,`.agent-browser`,`browsers`),m.join(e.runtimeHomeDir,`.agent-browser`,`browsers`)])}function k(e){return[...new Set(e.filter(e=>e.length>0))]}function A(e,t){return{count:0,pids:[],processes:[],signalPids:[],skipped:{reason:e,...t}}}function j(e,t){let n=M(e.command),r=`${M(m.resolve(t)).replace(/\/+$/,``)}/`;return n.includes(r)}function M(e){return e.replace(/\\/g,`/`)}function N(e){let t=ee(e.socketDir).map(e=>P(e)).filter(e=>e!==void 0);return t.length>0?Math.max(...t):void 0}function ee(e){try{return f.readdirSync(e).map(t=>m.join(e,t))}catch{return[]}}function P(e){try{return f.statSync(e).mtimeMs}catch{return}}var F=e({doctorManagedAgentBrowser:()=>H,getManagedAgentBrowserStatus:()=>U,mapManagedAgentBrowserError:()=>$,resolveAgentBrowserTool:()=>B,setupManagedAgentBrowser:()=>V});const I=`0.27.1`,L=`agent-browser`,R=5*6e4,z=6e4;async function B(e){let t=U(e);if(t.installed)return W(t);throw Q(t)}async function V(e){let t=U(e);te(t.nodeMajor);let n=await u({lockDirPath:m.join(t.installDir,`..`,`.agent-browser-install.lock`),owner:{pid:process.pid,startTime:c(process.pid),acquiredAtMs:Date.now()},timeoutMs:R,description:`managed agent-browser setup`});try{let t=U(e);return t.installed?t:(f.mkdirSync(t.installDir,{recursive:!0}),await G(t),await K(t,[`install`],{timeoutMs:R}),await K(t,[`doctor`,`--offline`,`--quick`],{timeoutMs:z}),Y(t),U(e))}finally{await n()}}async function H(e){let t=U(e);if(!t.installed)throw Q(t);return{status:t,...await K(t,[`doctor`,`--offline`,`--quick`],{timeoutMs:z,allowFailure:!0})}}function U(e){let t=e.stateDir??process.env.AGENT_DEVICE_STATE_DIR??oe(),n=m.join(t,`tools`,`agent-browser`,I),r=Z(n),i=m.join(n,`home`),a=ne(n),o=re(n),s=ae(r)&&X(n),c=Number.parseInt(process.versions.node.split(`.`)[0]??`0`,10);return{version:I,stateDir:t,installDir:n,binaryPath:r,homeDir:i,runtimeHomeDir:a,socketDir:o,installed:s,nodeMajor:c,nodeSupported:c>=24}}function W(e){if(!e.installed)throw Q(e);return{command:e.binaryPath,env:q(e,process.env)}}async function G(e){let t=m.join(e.installDir,`package`);f.mkdirSync(t,{recursive:!0}),await a(`npm`,[`install`,`--prefix`,t,`--no-audit`,`--no-fund`,`--no-save`,`${L}@${I}`],{env:process.env,timeoutMs:R})}async function K(e,t,n){return await a(e.binaryPath,t,{allowFailure:n.allowFailure,env:q(e,process.env),timeoutMs:n.timeoutMs})}function q(e,t){return f.mkdirSync(e.homeDir,{recursive:!0}),J(e),f.mkdirSync(e.socketDir,{recursive:!0}),{...t,HOME:e.runtimeHomeDir,AGENT_BROWSER_SOCKET_DIR:e.socketDir,AGENT_BROWSER_IDLE_TIMEOUT_MS:String(v(t)),AGENT_BROWSER_ARGS:_(t.AGENT_BROWSER_ARGS,e)}}function J(e){if(e.runtimeHomeDir!==e.homeDir){f.mkdirSync(m.dirname(e.runtimeHomeDir),{recursive:!0});try{let t=f.lstatSync(e.runtimeHomeDir);if(t.isSymbolicLink()&&f.readlinkSync(e.runtimeHomeDir)===e.homeDir||t.isDirectory())return;t.isSymbolicLink()&&f.unlinkSync(e.runtimeHomeDir)}catch(e){if(!ie(e))throw e}try{f.symlinkSync(e.homeDir,e.runtimeHomeDir,`dir`)}catch{f.mkdirSync(e.runtimeHomeDir,{recursive:!0})}}}function Y(e){f.writeFileSync(m.join(e.installDir,`manifest.json`),JSON.stringify({package:L,version:I,node:process.version,installedAt:new Date().toISOString()},null,2),`utf8`)}function X(e){return f.existsSync(m.join(e,`manifest.json`))}function Z(e){let t=m.join(e,`package`);return m.join(t,`node_modules`,`.bin`,process.platform===`win32`?`agent-browser.cmd`:`agent-browser`)}function Q(e){return new t(`TOOL_MISSING`,`Managed web browser backend is not installed.`,{version:I,installDir:e.installDir,hint:e.nodeSupported===!1?`Web automation requires Node 24+; current Node is ${process.version}.`:"Run `agent-device web setup` to install the managed web backend."})}function te(e){if(!(e>=24))throw new t(`UNSUPPORTED_OPERATION`,`Web automation requires Node 24 or newer.`,{currentNode:process.version,requiredNodeMajor:24,hint:`Run agent-device with Node 24+ for web setup and web automation.`})}function ne(e){if(process.platform===`win32`)return m.join(e,`home`);let t=d.createHash(`sha1`).update(e).digest(`hex`).slice(0,12);return m.join(p.tmpdir(),`agent-device-web`,t)}function re(e){let t=d.createHash(`sha1`).update(e).digest(`hex`).slice(0,12);return m.join(p.tmpdir(),`adw`,t)}function ie(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}function ae(e){try{return f.accessSync(e,f.constants.X_OK),!0}catch{return!1}}function oe(){return m.join(process.env.HOME??process.cwd(),`.agent-device`)}function $(e){let r=n(e);return r.code===`TOOL_MISSING`?new t(r.code,r.message,{...r.details??{},hint:typeof r.details?.hint==`string`?r.details.hint:"Run `agent-device web setup` to install the managed web backend."}):r}export{S as a,B as i,U as n,C as o,$ as r,x as s,F as t};
+import{o as e}from"./png-worker-contract.js";import{_ as t,v as n}from"./sdk-contracts.js";import{T as r,j as i,v as a}from"./sdk-android-adb.js";import{c as o,i as s,o as c,t as l}from"./host-process.js";import{t as u}from"./process-lock.js";import d from"node:path";import f from"node:crypto";import p from"node:fs";import m from"node:os";const h=new Map;function g(e){let t=f.createHash(`sha256`);return t.update(d.resolve(e.stateDir)),t.update(`\0`),t.update(d.resolve(e.installDir)),`--agent-device-managed-web=${t.digest(`hex`).slice(0,16)}`}function _(e,t){let n=g(t),r=e?.trim();return r?T(r).includes(n)?r:`${r},${n}`:n}function v(e){return E(e.AGENT_BROWSER_IDLE_TIMEOUT_MS)??E(e.AGENT_DEVICE_WEB_IDLE_TIMEOUT_MS)??3e5}function y(e,t){if(e.pid!==process.pid&&D(e.command)){if(e.command.includes(g(t)))return{process:e,reason:`launch-marker`};if(O(t).some(t=>j(e,t)))return{process:e,reason:`managed-browser-home`}}}function b(e,t){let n=e.flatMap(e=>{let n=y(e,t);return n?[n]:[]});return{count:n.length,pids:n.map(e=>e.process.pid),processes:n}}async function x(e){return b(await w(),e)}async function S(e,t,n={}){let r=k([...n.openWebSessionNames??[]]);if(r.length>0)return A(`open-web-session`,{openWebSessionNames:r});let a=v(process.env),s=N(e);if(s!==void 0&&Date.now()-s<a)return A(`recent-browser-activity`,{idleTimeoutMs:a,latestActivityMs:s});let c=await w(),u=b(c,e),d=l(u.processes.map(e=>e.process.pid),c).map(e=>e.pid),f={...u,signalPids:d};return u.count===0?f:(i({level:`warn`,phase:`web_agent_browser_orphan_cleanup`,data:{reason:t,count:u.count,pids:u.pids,signalPids:d,stateDir:e.stateDir,installDir:e.installDir,matchReasons:u.processes.map(e=>e.reason)}}),await o({pids:d,termTimeoutMs:1500,killTimeoutMs:1e3}),f)}async function C(e,t={}){let n=Date.now(),r=d.resolve(e.stateDir),i=h.get(r);if(!(i!==void 0&&n-i<3e4))return h.set(r,n),await S(e,`provider-startup`,t)}async function w(){return await r(async()=>await s({timeoutMs:1500}))}function T(e){return e.split(/[,\n]/).map(e=>e.trim()).filter(Boolean)}function E(e){if(e===void 0||e.trim()===``)return;let t=Number.parseInt(e,10);return Number.isInteger(t)&&t>0?t:void 0}function D(e){return/\b(?:Google Chrome for Testing|Chrome for Testing|Chromium|chrome|chrome\.exe|chromium|chromium-browser|headless_shell)\b/i.test(e)}function O(e){return k([d.join(e.homeDir,`.agent-browser`,`browsers`),d.join(e.runtimeHomeDir,`.agent-browser`,`browsers`)])}function k(e){return[...new Set(e.filter(e=>e.length>0))]}function A(e,t){return{count:0,pids:[],processes:[],signalPids:[],skipped:{reason:e,...t}}}function j(e,t){let n=M(e.command),r=`${M(d.resolve(t)).replace(/\/+$/,``)}/`;return n.includes(r)}function M(e){return e.replace(/\\/g,`/`)}function N(e){let t=ee(e.socketDir).map(e=>P(e)).filter(e=>e!==void 0);return t.length>0?Math.max(...t):void 0}function ee(e){try{return p.readdirSync(e).map(t=>d.join(e,t))}catch{return[]}}function P(e){try{return p.statSync(e).mtimeMs}catch{return}}var F=e({doctorManagedAgentBrowser:()=>H,getManagedAgentBrowserStatus:()=>U,mapManagedAgentBrowserError:()=>$,resolveAgentBrowserTool:()=>B,setupManagedAgentBrowser:()=>V});const I=`0.27.1`,L=`agent-browser`,R=5*6e4,z=6e4;async function B(e){let t=U(e);if(t.installed)return W(t);throw Q(t)}async function V(e){let t=U(e);te(t.nodeMajor);let n=await u({lockDirPath:d.join(t.installDir,`..`,`.agent-browser-install.lock`),owner:{pid:process.pid,startTime:c(process.pid),acquiredAtMs:Date.now()},timeoutMs:R,description:`managed agent-browser setup`});try{let t=U(e);return t.installed?t:(p.mkdirSync(t.installDir,{recursive:!0}),await G(t),await K(t,[`install`],{timeoutMs:R}),await K(t,[`doctor`,`--offline`,`--quick`],{timeoutMs:z}),Y(t),U(e))}finally{await n()}}async function H(e){let t=U(e);if(!t.installed)throw Q(t);return{status:t,...await K(t,[`doctor`,`--offline`,`--quick`],{timeoutMs:z,allowFailure:!0})}}function U(e){let t=e.stateDir??process.env.AGENT_DEVICE_STATE_DIR??oe(),n=d.join(t,`tools`,`agent-browser`,I),r=Z(n),i=d.join(n,`home`),a=ne(n),o=re(n),s=ae(r)&&X(n),c=Number.parseInt(process.versions.node.split(`.`)[0]??`0`,10);return{version:I,stateDir:t,installDir:n,binaryPath:r,homeDir:i,runtimeHomeDir:a,socketDir:o,installed:s,nodeMajor:c,nodeSupported:c>=24}}function W(e){if(!e.installed)throw Q(e);return{command:e.binaryPath,env:q(e,process.env)}}async function G(e){let t=d.join(e.installDir,`package`);p.mkdirSync(t,{recursive:!0}),await a(`npm`,[`install`,`--prefix`,t,`--no-audit`,`--no-fund`,`--no-save`,`${L}@${I}`],{env:process.env,timeoutMs:R})}async function K(e,t,n){return await a(e.binaryPath,t,{allowFailure:n.allowFailure,env:q(e,process.env),timeoutMs:n.timeoutMs})}function q(e,t){return p.mkdirSync(e.homeDir,{recursive:!0}),J(e),p.mkdirSync(e.socketDir,{recursive:!0}),{...t,HOME:e.runtimeHomeDir,AGENT_BROWSER_SOCKET_DIR:e.socketDir,AGENT_BROWSER_IDLE_TIMEOUT_MS:String(v(t)),AGENT_BROWSER_ARGS:_(t.AGENT_BROWSER_ARGS,e)}}function J(e){if(e.runtimeHomeDir!==e.homeDir){p.mkdirSync(d.dirname(e.runtimeHomeDir),{recursive:!0});try{let t=p.lstatSync(e.runtimeHomeDir);if(t.isSymbolicLink()&&p.readlinkSync(e.runtimeHomeDir)===e.homeDir||t.isDirectory())return;t.isSymbolicLink()&&p.unlinkSync(e.runtimeHomeDir)}catch(e){if(!ie(e))throw e}try{p.symlinkSync(e.homeDir,e.runtimeHomeDir,`dir`)}catch{p.mkdirSync(e.runtimeHomeDir,{recursive:!0})}}}function Y(e){p.writeFileSync(d.join(e.installDir,`manifest.json`),JSON.stringify({package:L,version:I,node:process.version,installedAt:new Date().toISOString()},null,2),`utf8`)}function X(e){return p.existsSync(d.join(e,`manifest.json`))}function Z(e){let t=d.join(e,`package`);return d.join(t,`node_modules`,`.bin`,process.platform===`win32`?`agent-browser.cmd`:`agent-browser`)}function Q(e){return new t(`TOOL_MISSING`,`Managed web browser backend is not installed.`,{version:I,installDir:e.installDir,hint:e.nodeSupported===!1?`Web automation requires Node 24+; current Node is ${process.version}.`:"Run `agent-device web setup` to install the managed web backend."})}function te(e){if(!(e>=24))throw new t(`UNSUPPORTED_OPERATION`,`Web automation requires Node 24 or newer.`,{currentNode:process.version,requiredNodeMajor:24,hint:`Run agent-device with Node 24+ for web setup and web automation.`})}function ne(e){if(process.platform===`win32`)return d.join(e,`home`);let t=f.createHash(`sha1`).update(e).digest(`hex`).slice(0,12);return d.join(m.tmpdir(),`agent-device-web`,t)}function re(e){let t=f.createHash(`sha1`).update(e).digest(`hex`).slice(0,12);return d.join(m.tmpdir(),`adw`,t)}function ie(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}function ae(e){try{return p.accessSync(e,p.constants.X_OK),!0}catch{return!1}}function oe(){return d.join(process.env.HOME??process.cwd(),`.agent-device`)}function $(e){let r=n(e);return r.code===`TOOL_MISSING`?new t(r.code,r.message,{...r.details??{},hint:typeof r.details?.hint==`string`?r.details.hint:"Run `agent-device web setup` to install the managed web backend."}):r}export{S as a,B as i,U as n,C as o,$ as r,x as s,F as t};