agent-device 0.17.5 → 0.17.7

package/README.md

@@ -9,17 +9,17 @@
 # agent-device
 
 [![npm version](https://img.shields.io/npm/v/agent-device.svg)](https://www.npmjs.com/package/agent-device)
-[![CI](https://github.com/callstackincubator/agent-device/actions/workflows/ci.yml/badge.svg)](https://github.com/callstackincubator/agent-device/actions/workflows/ci.yml)
+[![CI](https://github.com/callstack/agent-device/actions/workflows/ci.yml/badge.svg)](https://github.com/callstack/agent-device/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-black.svg)](LICENSE)
-[![Glama MCP server](https://glama.ai/mcp/servers/callstackincubator/agent-device/badges/score.svg)](https://glama.ai/mcp/servers/callstackincubator/agent-device)
+[![Glama MCP server](https://glama.ai/mcp/servers/callstack/agent-device/badges/score.svg)](https://glama.ai/mcp/servers/callstack/agent-device)
 
 Mobile app verification for AI agents.
 
-A device automation CLI for real apps on iOS, Android, TV, and desktop. Agents get token-efficient snapshots, semantic refs, and evidence captured only when needed.
+A device automation CLI for real apps on iOS, Android, TV, web, and desktop. Agents get token-efficient snapshots, semantic refs, and evidence captured only when needed.
 
 `agent-device` lets coding agents open apps, inspect the current UI, interact with visible elements, and collect debugging evidence through one CLI. Use it when an agent needs to verify what actually happens on a device, not just reason about code.
 
-If you know Vercel's [agent-browser](https://github.com/vercel-labs/agent-browser), `agent-device` is the same idea for mobile, TV, and desktop apps.
+If you know Vercel's [agent-browser](https://github.com/vercel-labs/agent-browser), `agent-device` is the same idea for mobile, TV, and desktop apps. Minimal `--platform web` support reuses `agent-browser` when a browser session needs to fit into the same command/session/replay loop.
 
 It works with native iOS and Android apps, plus apps built with Expo, Flutter, and React Native, as long as the target can run on a supported device, simulator, emulator, or desktop environment.
 
@@ -56,7 +56,7 @@ agent-device help workflow
 
 The installed CLI help is the source of truth for agents. Start with `agent-device help workflow`, then follow the topic-specific help when a task needs dogfooding, debugging, replay, or React Native profiling.
 
-Prerequisites depend on the target platform: Node.js 22+, Xcode for iOS/tvOS/macOS targets, Android SDK + ADB for Android, and macOS Accessibility permission for desktop automation. See [Installation](https://oss.callstack.com/agent-device/docs/installation) for platform setup.
+Prerequisites depend on the target platform: Node.js 22+, Xcode for iOS/tvOS/macOS targets, Android SDK + ADB for Android, and macOS Accessibility permission for desktop automation. Web automation requires Node 24+. See [Installation](https://oss.callstack.com/agent-device/docs/installation) for platform setup.
 
 Try the basic loop:
 

package/android-multitouch-helper/dist/agent-device-android-multitouch-helper-0.17.7.apk.sha256

@@ -0,0 +1 @@
+cc41db9a5e5f7df8bdf302c3d4e6130ed7b35f1012bd37d2db583b70a0104ee8  agent-device-android-multitouch-helper-0.17.7.apk

package/android-multitouch-helper/dist/{agent-device-android-multitouch-helper-0.17.5.manifest.json → agent-device-android-multitouch-helper-0.17.7.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-multitouch-helper",
-  "version": "0.17.5",
-  "assetName": "agent-device-android-multitouch-helper-0.17.5.apk",
-  "sha256": "45a85cddbdca10a23a6245bf8e6786342551bf61f9d02bd8fdbf419e785dc1f9",
+  "version": "0.17.7",
+  "assetName": "agent-device-android-multitouch-helper-0.17.7.apk",
+  "sha256": "cc41db9a5e5f7df8bdf302c3d4e6130ed7b35f1012bd37d2db583b70a0104ee8",
   "packageName": "com.callstack.agentdevice.multitouchhelper",
-  "versionCode": 17005,
+  "versionCode": 17007,
   "instrumentationRunner": "com.callstack.agentdevice.multitouchhelper/.MultiTouchInstrumentation",
   "statusProtocol": "android-multitouch-helper-v1"
 }

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

@@ -0,0 +1 @@
+a8d1788b652e75d6542891763afee0213d38d02825f453a1b5d0edfca6ad8cd4  agent-device-android-snapshot-helper-0.17.7.apk

package/android-snapshot-helper/dist/{agent-device-android-snapshot-helper-0.17.5.manifest.json → agent-device-android-snapshot-helper-0.17.7.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.17.5",
-  "releaseTag": "v0.17.5",
-  "assetName": "agent-device-android-snapshot-helper-0.17.5.apk",
+  "version": "0.17.7",
+  "releaseTag": "v0.17.7",
+  "assetName": "agent-device-android-snapshot-helper-0.17.7.apk",
   "apkUrl": null,
-  "sha256": "94e26dc456437cf7a2112450e8638b5fac62565b4b17e86dc3834f6eedcd3ced",
-  "checksumName": "agent-device-android-snapshot-helper-0.17.5.apk.sha256",
+  "sha256": "a8d1788b652e75d6542891763afee0213d38d02825f453a1b5d0edfca6ad8cd4",
+  "checksumName": "agent-device-android-snapshot-helper-0.17.7.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 17005,
+  "versionCode": 17007,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

package/dist/src/2133.js

@@ -0,0 +1 @@
+import{AppError as e}from"./733.js";let t={alert:"alert",appState:"appstate",appSwitcher:"app-switcher",apps:"apps",back:"back",batch:"batch",boot:"boot",click:"click",close:"close",clipboard:"clipboard",devices:"devices",diff:"diff",fill:"fill",find:"find",focus:"focus",gesture:"gesture",get:"get",home:"home",install:"install",installFromSource:"install-from-source",is:"is",keyboard:"keyboard",logs:"logs",longPress:"longpress",network:"network",open:"open",perf:"perf",prepare:"prepare",press:"press",push:"push",record:"record",reactNative:"react-native",reinstall:"reinstall",replay:"replay",rotate:"rotate",scroll:"scroll",screenshot:"screenshot",settings:"settings",shutdown:"shutdown",snapshot:"snapshot",swipe:"swipe",test:"test",trace:"trace",triggerAppEvent:"trigger-app-event",type:"type",wait:"wait"},s={installSource:"install_source",leaseAllocate:"lease_allocate",leaseHeartbeat:"lease_heartbeat",leaseRelease:"lease_release",releaseMaterializedPaths:"release_materialized_paths",runtime:"runtime",sessionList:"session_list"},a={auth:"auth",connect:"connect",connection:"connection",debug:"debug",disconnect:"disconnect",mcp:"mcp",metro:"metro",reactDevtools:"react-devtools",session:"session",web:"web"},r=["pan","fling","swipe","pinch","rotate","transform"],o=`gesture requires one of: ${r.join(", ")}`,n=c(a.auth,a.connect,a.connection,a.disconnect,a.mcp,a.reactDevtools,a.web,t.prepare);function c(...e){return new Set(e)}function i(){return[...Object.values(t),...Object.values(a)].sort()}function l(e){return Object.values(t).includes(e)||e===a.debug||e===a.metro||e===a.session}function p(){return i().filter(e=>!n.has(e))}c(a.auth,a.connect,a.connection,a.debug,a.disconnect,a.mcp,a.metro,a.reactDevtools,a.session,a.web,t.appState,t.prepare,t.batch,t.devices,t.gesture,t.replay,t.test,t.trace);let u=[t.devices,t.boot,t.shutdown,t.apps,t.open,t.close,t.install,t.reinstall,t.installFromSource,t.push,t.triggerAppEvent,t.snapshot,t.screenshot,t.diff,t.wait,t.alert,t.settings,t.click,t.press,t.longPress,t.swipe,t.focus,t.type,t.fill,t.scroll,t.get,t.gesture,t.is,t.find,t.perf,t.logs,t.network,t.record,t.trace,t.test,t.appState,t.back,t.home,t.rotate,t.appSwitcher,t.keyboard,t.clipboard,t.reactNative],d=new Set(["batch","replay"]),m=["command","positionals","flags","runtime"],h=["platform","target","device","udid","serial","verbose","out"],f=new Set(u);function g(e){return"string"==typeof e?e.trim().toLowerCase():""}function b(t,s){let a=g(t);if(f.has(a))return a;throw new e("INVALID_ARGS",`Batch step ${s} command is not available through command batch: ${String(t)}`)}function _(t,s){if(d.has(t))throw new e("INVALID_ARGS",`Batch step ${s} cannot run ${t}.`)}export{d as BATCH_BLOCKED_COMMANDS,m as BATCH_DAEMON_STEP_KEYS,r as GESTURE_KINDS,o as GESTURE_SUBCOMMAND_ERROR,h as INHERITED_PARENT_FLAG_KEYS,s as INTERNAL_COMMANDS,t as PUBLIC_COMMANDS,u as STRUCTURED_BATCH_COMMAND_NAMES,_ as assertBatchRuntimeCommandAllowed,l as isClientBackedCliCommandName,i as listCliCommandNames,p as listMcpExposedCommandNames,g as normalizeBatchCommandName,b as readStructuredBatchCommandName};

package/dist/src/2748.js

@@ -0,0 +1 @@
+import{AppError as e}from"./733.js";let r="user-installed";function t(e){return e??r}function o(r){if(void 0===r)throw new e("INVALID_ARGS","appsFilter must be resolved before executing the apps command");return r}export{r as DEFAULT_APPS_FILTER,o as assertResolvedAppsFilter,t as resolveAppsFilter};

package/dist/src/{4012.js → 2892.js}

@@ -1,4 +1,4 @@
-import e from"node:crypto";import t from"node:fs";import n from"node:path";import{resolveUserPath as r,expandUserHomePath as o}from"./3267.js";import{findProjectRoot as s}from"./9671.js";function i(a,u={}){var l,c;let p,f=(l=a,c=u,(p=(l??"").trim())?r(p,{env:c.env}):function(r={}){var i;let a,u,l,c=n.join(o("~",{env:r.env}),".agent-device"),p=r.projectRoot??s();return(i=p,t.existsSync(n.join(i,"package.json"))&&t.existsSync(n.join(i,"src","daemon.ts")))?n.join(c,"dev",(a=function(e){try{return t.realpathSync.native(e)}catch{return n.resolve(e)}}(p),u=n.basename(a).replaceAll(/[^a-zA-Z0-9._-]+/g,"-"),l=e.createHash("sha1").update(a).digest("hex").slice(0,12),`${u||"agent-device"}-${l}`)):c}(c));return{baseDir:f,infoPath:n.join(f,"daemon.json"),lockPath:n.join(f,"daemon.lock"),logPath:n.join(f,"daemon.log"),sessionsDir:n.join(f,"sessions")}}function a(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function u(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function l(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function c(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let p=/(?:^|[^\w$.])(?:import|export)\s+(?:type\s+)?(?:[^'"`]*?\s+from\s+)?['"]([^'"]+)['"]/gm,f=/import\(\s*['"]([^'"]+)['"]\s*\)/gm,m=[".ts",".tsx",".js",".jsx",".mjs",".cjs"];function h(){let e=process.argv[1];return e?d(e):"unknown"}function d(r,o=s()){try{let s=n.resolve(o),i=[n.resolve(r)],a=new Set,u=[];for(;i.length>0;){let e=i.pop();if(!e||a.has(e))continue;a.add(e);let r=t.statSync(e);if(!r.isFile())continue;let o=n.relative(s,e)||e;u.push(`${o}:${r.size}:${Math.trunc(r.mtimeMs)}`);let l=t.readFileSync(e,"utf8");for(let t of function(e){let t=new Set;return g(e,p,t),g(e,f,t),[...t]}(l)){let r=function(e,t){let r=n.resolve(n.dirname(e),t),o=M(r);if(o)return o;for(let e of m){let t=M(`${r}${e}`);if(t)return t}for(let e of m){let t=M(n.join(r,`index${e}`));if(t)return t}return null}(e,t);r&&i.push(r)}}let l=u.sort().join("|"),c=e.createHash("sha1").update(l).digest("hex");return`graph:${u.length}:${c}`}catch{return"unknown"}}function g(e,t,n){t.lastIndex=0;let r=null;for(;null!==(r=t.exec(e));){let e=r[1]?.trim();e?.startsWith(".")&&n.add(e)}}function M(e){try{return t.statSync(e).isFile()?e:null}catch{return null}}let v=/^[A-Za-z0-9_@%+=:,./-]+$/;function y(e){return`'${e.replaceAll("'","'\\''")}'`}function S(e){return v.test(e)?e:y(e)}function j(e,t){let n=[],r=e+t.toString(),o=r.indexOf("\n");for(;-1!==o;){let e=r.slice(0,o).trim();r=r.slice(o+1),e&&n.push(e),o=r.indexOf("\n")}return{lines:n,buffer:r}}function x(e){return e.meta?.requestProgress==="replay-test"}function $(e){return!!e&&"object"==typeof e&&"progress"===e.type&&!!e.event}function b(e){return!!e&&"object"==typeof e&&"response"===e.type&&!!e.response}function w(e){return`${JSON.stringify({type:"progress",event:e})}
+import e from"node:crypto";import t from"node:fs";import n from"node:path";import{resolveUserPath as r,expandUserHomePath as o}from"./9612.js";import{findProjectRoot as s}from"./7244.js";function i(a,u={}){var l,c;let p,f=(l=a,c=u,(p=(l??"").trim())?r(p,{env:c.env}):function(r={}){var i;let a,u,l,c=n.join(o("~",{env:r.env}),".agent-device"),p=r.projectRoot??s();return(i=p,t.existsSync(n.join(i,"package.json"))&&t.existsSync(n.join(i,"src","daemon.ts")))?n.join(c,"dev",(a=function(e){try{return t.realpathSync.native(e)}catch{return n.resolve(e)}}(p),u=n.basename(a).replaceAll(/[^a-zA-Z0-9._-]+/g,"-"),l=e.createHash("sha1").update(a).digest("hex").slice(0,12),`${u||"agent-device"}-${l}`)):c}(c));return{baseDir:f,infoPath:n.join(f,"daemon.json"),lockPath:n.join(f,"daemon.lock"),logPath:n.join(f,"daemon.log"),sessionsDir:n.join(f,"sessions")}}function a(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function u(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function l(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function c(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let p=/(?:^|[^\w$.])(?:import|export)\s+(?:type\s+)?(?:[^'"`]*?\s+from\s+)?['"]([^'"]+)['"]/gm,f=/import\(\s*['"]([^'"]+)['"]\s*\)/gm,m=[".ts",".tsx",".js",".jsx",".mjs",".cjs"];function h(){let e=process.argv[1];return e?d(e):"unknown"}function d(r,o=s()){try{let s=n.resolve(o),i=[n.resolve(r)],a=new Set,u=[];for(;i.length>0;){let e=i.pop();if(!e||a.has(e))continue;a.add(e);let r=t.statSync(e);if(!r.isFile())continue;let o=n.relative(s,e)||e;u.push(`${o}:${r.size}:${Math.trunc(r.mtimeMs)}`);let l=t.readFileSync(e,"utf8");for(let t of function(e){let t=new Set;return g(e,p,t),g(e,f,t),[...t]}(l)){let r=function(e,t){let r=n.resolve(n.dirname(e),t),o=M(r);if(o)return o;for(let e of m){let t=M(`${r}${e}`);if(t)return t}for(let e of m){let t=M(n.join(r,`index${e}`));if(t)return t}return null}(e,t);r&&i.push(r)}}let l=u.sort().join("|"),c=e.createHash("sha1").update(l).digest("hex");return`graph:${u.length}:${c}`}catch{return"unknown"}}function g(e,t,n){t.lastIndex=0;let r=null;for(;null!==(r=t.exec(e));){let e=r[1]?.trim();e?.startsWith(".")&&n.add(e)}}function M(e){try{return t.statSync(e).isFile()?e:null}catch{return null}}let v=/^[A-Za-z0-9_@%+=:,./-]+$/;function y(e){return`'${e.replaceAll("'","'\\''")}'`}function S(e){return v.test(e)?e:y(e)}function j(e,t){let n=[],r=e+t.toString(),o=r.indexOf("\n");for(;-1!==o;){let e=r.slice(0,o).trim();r=r.slice(o+1),e&&n.push(e),o=r.indexOf("\n")}return{lines:n,buffer:r}}function x(e){return e.meta?.requestProgress==="replay-test"}function $(e){return!!e&&"object"==typeof e&&"progress"===e.type&&!!e.event}function b(e){return!!e&&"object"==typeof e&&"response"===e.type&&!!e.response}function w(e){return`${JSON.stringify({type:"progress",event:e})}
 `}function D(e){return`${JSON.stringify({type:"response",response:e})}
 `}function k(e){return`${JSON.stringify({type:"response",response:e})}
 `}function _(e,t){e&&(e.snapshotDiagnostics??={samples:[]}).samples.push({...t,durationMs:Math.max(0,Math.round(t.durationMs))})}function A(e){let t=e?.snapshotDiagnostics?.samples;if(t&&0!==t.length)return P(t)}function P(e){if(0===e.length)return;let t=O(e);return{stats:t,...t.p95Ms>=1500?{warning:R(t)}:{}}}function z(e){let t=e.flatMap(e=>(function(e){if(!e||e.count<=0)return[];let t=e.platform;return 1===e.count?[{durationMs:e.maxMs,platform:t}]:2===e.count?[{durationMs:e.p50Ms,platform:t},{durationMs:e.maxMs,platform:t}]:[...Array.from({length:e.count-3},()=>({durationMs:e.p50Ms,platform:t})),{durationMs:e.p50Ms,platform:t},{durationMs:e.p95Ms,platform:t},{durationMs:e.maxMs,platform:t}]})(e?.stats));if(0===t.length)return;let n=O(t);return{stats:n,...n.p95Ms>=1500?{warning:R(n)}:{}}}function C(e){if(!e||"object"!=typeof e||Array.isArray(e))return;let t=function(e){let t=T(e);if(!t)return;let n=function(e){let t={count:e.count,p50Ms:e.p50Ms,p95Ms:e.p95Ms,maxMs:e.maxMs,slowThresholdMs:e.slowThresholdMs};if(!Object.values(t).some(e=>"number"!=typeof e))return t}(t);if(n){var r;let e,o,s,i;return{...n,...(o="string"==typeof(r=t).platform?r.platform:void 0,i=(s=T(r.backends))&&(e=Object.entries(s).filter(e=>"number"==typeof e[1])).length>0?Object.fromEntries(e):void 0,{...o?{platform:o}:{},...i?{backends:i}:{}})}}}(e.stats);if(!t)return;let n="string"==typeof e.warning?e.warning:void 0;return{stats:t,...n?{warning:n}:{}}}function O(e){let t,n=e.map(e=>e.durationMs).sort((e,t)=>e-t);return{count:n.length,p50Ms:E(n,50),p95Ms:E(n,95),maxMs:n[n.length-1]??0,slowThresholdMs:1500,...1===new Set(t=e.map(e=>e.platform).filter(e=>!!e)).size?{platform:t[0]}:{},...function(e){let t={};for(let n of e)n.backend&&(t[n.backend]=(t[n.backend]??0)+1);return Object.keys(t).length>0?{backends:t}:{}}(e)}}function E(e,t){if(0===e.length)return 0;let n=Math.max(0,Math.ceil(t/100*e.length)-1);return e[Math.min(n,e.length-1)]??0}function R(e){let t=e.platform?`${e.platform} `:"";return`Warning: ${t}snapshots are slow in this run: p95 ${e.p95Ms}ms over ${e.count} captures. Possible causes: device load, app or dev server stuck, helper fallback, or stale daemon.`}function T(e){return e&&"object"==typeof e&&!Array.isArray(e)?e:void 0}export{d as computeDaemonCodeSignature,j as consumeTextLines,$ as isDaemonProgressEnvelope,b as isDaemonResponseEnvelope,z as mergeSnapshotDiagnostics,c as normalizeTenantId,C as readSnapshotDiagnosticsSummary,_ as recordSnapshotTiming,h as resolveDaemonCodeSignature,i as resolveDaemonPaths,a as resolveDaemonServerMode,u as resolveDaemonTransportPreference,l as resolveSessionIsolationMode,w as serializeDaemonProgressEnvelope,D as serializeDaemonResponseEnvelope,k as serializeDaemonRpcResponseEnvelope,y as shellQuote,S as shellQuoteIfNeeded,x as shouldStreamRequestProgress,A as summarizeSnapshotDiagnostics,P as summarizeSnapshotTimingSamples};

package/dist/src/2948.js

@@ -0,0 +1 @@
+import{AppError as e}from"./733.js";import{recordingCommandMetadata as t,recordingCommandDefinitions as r,perfCommandDefinitions as o,METRO_PREPARE_FLAGS as a,defineExecutableCommand as i,systemCommandDefinitions as s,replayCommandMetadataList as n,requiredField as d,captureCommandDefinitions as l,observabilityCommandDefinitions as m,perfCommandMetadataList as p,captureCommandMetadata as u,batchCommandMetadata as c,integerField as b,booleanField as f,managementCommandMetadata as h,stringSchema as g,METRO_RELOAD_FLAGS as M,observabilityCommandMetadata as y,replayCommandDefinitions as P,reactNativeCommandDefinition as I,enumField as S,interactionCommandMetadata as U,commonInputFromFlags as v,defineFieldCommandMetadata as w,systemCommandMetadata as R,managementCommandDefinitions as x,jsonSchemaField as H,stringField as T,reactNativeCommandMetadata as _}from"./9873.js";import{listMcpExposedCommandNames as N}from"./2133.js";let A="debug",k=w(A,"Symbolicate crash artifacts with matching debug symbols.",{action:d(S(["symbols"])),artifact:d(T("Apple crash artifact path (.ips, .crash, or .log).")),dsym:T("Path to a matching .dSYM bundle."),searchPath:T("Directory to scan for matching .dSYM bundles."),out:T("Output path for the symbolicated artifact.")}),C=i(k,(e,t)=>e.debug.symbols(t)),D={[A]:{usageOverride:"debug symbols --artifact <crash.ips|crash.log> (--dsym <App.dSYM> | --search-path <dir>) [--out <symbolicated>]",listUsageOverride:"debug",helpDescription:"Symbolicate Apple crash artifacts with matching dSYM UUIDs. This debug namespace is intentionally narrow: use logs for app logs, network for HTTP evidence, perf for performance samples, record/trace for media and traces, and react-devtools for React Native profiles.",summary:"Symbolicate Apple crash artifacts with dSYMs; use logs/network/perf for other diagnostics",positionalArgs:["symbols"],allowedFlags:["artifact","dsym","searchPath","out"]}},B={debug:(t,r)=>({...v(r),action:function(t){if("symbols"===t)return t;throw new e("INVALID_ARGS","debug supports only symbols; use logs, network, perf, record, trace, or react-devtools for other diagnostics")}(t[0]),artifact:r.artifact,dsym:r.dsym,searchPath:r.searchPath,out:r.out})},E="metro",j=w(E,"Prepare Metro runtime or reload React Native apps.",{action:d(S(["prepare","reload"])),projectRoot:T(),kind:H(g()),publicBaseUrl:T(),proxyBaseUrl:T(),bearerToken:T(),bridgeScope:H({type:"object",additionalProperties:!0}),launchUrl:T(),port:b(),listenHost:T(),statusHost:T(),startupTimeoutMs:b(),probeTimeoutMs:b(),reuseExisting:f(),installDependenciesIfNeeded:f(),runtimeFilePath:T(),logPath:T(),metroHost:T(),metroPort:b(),bundleUrl:T(),timeoutMs:b()}),F=i(j,async(e,t)=>{var r,o,a;return"prepare"===t.action?await e.metro.prepare({projectRoot:(r=t).projectRoot,kind:r.kind,publicBaseUrl:r.publicBaseUrl,proxyBaseUrl:r.proxyBaseUrl,bearerToken:r.bearerToken,bridgeScope:r.bridgeScope??((o=r).tenant&&o.runId&&o.leaseId?{tenantId:o.tenant,runId:o.runId,leaseId:o.leaseId}:void 0),port:r.port,listenHost:r.listenHost,statusHost:r.statusHost,startupTimeoutMs:r.startupTimeoutMs,probeTimeoutMs:r.probeTimeoutMs,reuseExisting:r.reuseExisting,installDependenciesIfNeeded:r.installDependenciesIfNeeded,runtimeFilePath:r.runtimeFilePath}):await e.metro.reload({metroHost:(a=t).metroHost,metroPort:a.metroPort,bundleUrl:a.bundleUrl,timeoutMs:a.timeoutMs})}),K={[E]:{usageOverride:"metro prepare (--public-base-url <url> | --proxy-base-url <url>) [--project-root <path>] [--port <port>] [--kind auto|react-native|expo]\n  agent-device metro reload [--metro-host <host>] [--metro-port <port>] [--bundle-url <url>]",listUsageOverride:"metro",helpDescription:"Prepare a local Metro runtime or ask Metro to reload connected React Native apps",summary:"Prepare Metro reachability for React Native/Expo apps or trigger app reloads",positionalArgs:["prepare|reload"],allowedFlags:[...M,...a]}},L={metro:(t,r)=>{let o=(t[0]??"").toLowerCase();if("prepare"!==o&&"reload"!==o)throw new e("INVALID_ARGS","metro requires a subcommand: prepare or reload");if("reload"===o)return{action:o,metroHost:r.metroHost,metroPort:r.metroPort,bundleUrl:r.bundleUrl,timeoutMs:r.metroProbeTimeoutMs};if(!r.metroPublicBaseUrl&&!r.metroProxyBaseUrl)throw new e("INVALID_ARGS","metro prepare requires --public-base-url <url> or --proxy-base-url <url>.");return{action:o,projectRoot:r.metroProjectRoot,kind:function(t){if(void 0!==t){if("auto"===t||"react-native"===t||"expo"===t)return t;throw new e("INVALID_ARGS","metro prepare --kind must be auto, react-native, or expo")}}(r.kind??r.metroKind),port:r.metroPreparePort,listenHost:r.metroListenHost,statusHost:r.metroStatusHost,publicBaseUrl:r.metroPublicBaseUrl,proxyBaseUrl:r.metroProxyBaseUrl,bearerToken:r.metroBearerToken,bridgeScope:r.tenant&&r.runId&&r.leaseId?{tenantId:r.tenant,runId:r.runId,leaseId:r.leaseId}:void 0,startupTimeoutMs:r.metroStartupTimeoutMs,probeTimeoutMs:r.metroProbeTimeoutMs,reuseExisting:!r.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!r.metroNoInstallDeps&&void 0,runtimeFilePath:r.metroRuntimeFile}}},O=[{metadata:h,definitions:x},{metadata:u,definitions:l},{metadata:R,definitions:s},{metadata:[_],definitions:[I]},{metadata:n,definitions:P},{metadata:y,definitions:m},{metadata:p,definitions:o},{metadata:[k],definitions:[C]},{metadata:t,definitions:r},{metadata:[j],definitions:[F]}],Y=O.flatMap(e=>[...e.metadata]),G=O.flatMap(e=>[...e.definitions]),V=[...U,...Y,c],q=new Map(V.map(e=>[e.name,e]));function $(){return[...V]}function z(){return N().map(e=>{var t;if(!J(e))throw Error(`Missing command metadata for MCP-exposed command: ${e}`);return t=e,q.get(t)})}function J(e){return q.has(e)}export{G as clientCommandDefinitions,B as debuggingCliReaders,D as debuggingCliSchemas,J as isCommandName,$ as listCommandMetadata,z as listMcpCommandMetadata,L as metroCliReaders,K as metroCliSchemas};

package/dist/src/2954.js

@@ -0,0 +1,2 @@
+import{AsyncLocalStorage as e}from"node:async_hooks";import{runCmdBackground as r,withoutCommandExecutorOverride as t,runCmd as i,withCommandExecutorOverride as n}from"./8875.js";import{AppError as a}from"./733.js";let o=new e;function l(e){return async(r,n)=>await t(async()=>await i("adb",["-s",e,...r],{...n,detached:"win32"!==process.platform}))}function s(e){var t;let i=l(e.id);return{exec:i,spawn:(t=e.id,(e,i)=>{let n=r("adb",["-s",t,...e],{...i,allowFailure:!0,captureOutput:!1});return n.wait.catch(()=>{}),n.child}),reverse:g(i),pull:async(e,r,t)=>await i(["pull",e,r],t),install:async(e,r)=>{let{installArgs:t,execOptions:n}=h(r);return await i(["install",...t,e],n)}}}function d(e,r){let t=o.getStore();return r?r:t?.serial===e.id?t.provider.exec:l(e.id)}function u(e,r){if(r)return v(r);let t=o.getStore();return t?.serial===e.id?v(t.provider):s(e)}function c(e){let r=o.getStore();return r?.serial===e.id?r.provider.text:void 0}function w(e){let r=o.getStore();return r?.serial===e.id?r.provider.touch:void 0}function f(e){let r=v(e),t=r.reverse??g(r.exec),i=new Map;return{async ensure(e,r){let n=i.get(e.local);if(n&&n.ownerId!==e.ownerId)throw new a("COMMAND_FAILED",`Android port reverse ${e.local} is already owned by ${n.ownerId??"another session"}`,{current:n,requested:e});n?.remote!==e.remote&&(await t.ensure(e,r),i.set(e.local,{...e}))},async remove(e,r){i.has(e)?(await t.remove(e,r),i.delete(e)):await t.remove(e,r)},async removeAllOwned(e,r){let n=[...i.values()].filter(r=>r.ownerId===e).map(e=>e.local);if(0===n.length)return void await t.removeAllOwned(e,r);for(let e of n)await t.remove(e,r),i.delete(e)},list:async e=>t.list?await t.list(e):[...i.values()]}}function v(e){return"function"==typeof e?{exec:e}:e}async function p(e,r,i){let{device:n,provider:o,...l}=i??{},s=A(n,o),d=s?.pull;if(d)return await t(async()=>await d(e,r,l));let u=s?.exec;if(!u)throw new a("COMMAND_FAILED","Android adb pull requires an adb provider");return await t(async()=>await u(["pull",e,r],l))}async function m(e,r){let{device:i,provider:n,...o}=r??{},l=A(i,n),s=l?.install;if(s)return await t(async()=>await s(e,o));let d=l?.exec;if(!d)throw new a("COMMAND_FAILED","Android adb install requires an adb provider");let{installArgs:u,execOptions:c}=h(o);return await t(async()=>await d(["install",...u,e],c))}function A(e,r){if(r)return v(r);if(e)return u(e);let t=o.getStore();if(t)return v(t.provider)}async function y(e,r,i){var a;if(!e)return await i();let l={provider:"function"==typeof e?{exec:e}:e,serial:r.serial},s=(a=l,(e,r,i)=>{if("adb"!==e)return;let n=function(e,r){if("-s"===e[0]&&e[1]&&e[1]===r)return e.slice(2)}(r,a.serial);if(n)return t(async()=>await a.provider.exec(n,i))});return await o.run(l,async()=>await n(s,i))}function g(e){let r=new Map;return{async ensure(t,i){if(await e(["reverse",t.local,t.remote],{allowFailure:!1,signal:i?.signal,timeoutMs:i?.timeoutMs}),t.ownerId){let e=r.get(t.ownerId)??new Set;e.add(t.local),r.set(t.ownerId,e)}},async remove(t,i){var n,a;let o,l=await e(["reverse","--remove",t],{allowFailure:!0,signal:i?.signal,timeoutMs:i?.timeoutMs});if(0!==l.exitCode&&(n=l.stdout,a=l.stderr,!((o=`${n}
+${a}`.toLowerCase()).includes("listener")&&o.includes("not found"))))throw Error(`Failed to remove Android port reverse ${t}: ${l.stderr}`);for(let e of r.values())e.delete(t)},async removeAllOwned(e,t){for(let i of[...r.get(e)??[]])await this.remove(i,t);r.delete(e)},async list(t){let i=await e(["reverse","--list"],{allowFailure:!0,signal:t?.signal,timeoutMs:t?.timeoutMs});return 0!==i.exitCode?[]:function(e,r){let t=new Map;for(let[e,i]of r)for(let r of i)t.set(r,e);return e.split("\n").map(e=>e.trim().split(/\s+/)).filter(e=>e.length>=3).map(([,e,r])=>({local:e,remote:r,ownerId:t.get(e)}))}(i.stdout,r)}}}function h(e){let{replace:r,allowTestPackages:t,allowDowngrade:i,grantPermissions:n,...a}=e??{},o=[];return r&&o.push("-r"),t&&o.push("-t"),i&&o.push("-d"),n&&o.push("-g"),{installArgs:o,execOptions:a}}export{f as createAndroidPortReverseManager,s as createLocalAndroidAdbProvider,m as installAndroidAdbPackage,p as pullAndroidAdbFile,d as resolveAndroidAdbExecutor,u as resolveAndroidAdbProvider,c as resolveAndroidTextInjector,w as resolveAndroidTouchInjector,y as withAndroidAdbProvider};

package/dist/src/{7651.js → 3006.js}

@@ -1 +1 @@
-let t;import e from"node:fs/promises";import r from"node:path";import{TextDecoder as n}from"node:util";import{promises as i}from"node:fs";import a from"node:os";import{isExecutablePath as o,runCmd as l}from"./9818.js";let f=["emulator","platform-tools",r.join("cmdline-tools","latest","bin"),r.join("cmdline-tools","tools","bin")];function u(t){let e=new Set,r=[];for(let n of t){let t=n.trim();!t||e.has(t)||(e.add(t),r.push(t))}return r}function d(t=process.env){let e=t.ANDROID_SDK_ROOT?.trim(),n=t.ANDROID_HOME?.trim(),i=t.HOME?.trim()||a.homedir();return u([e??"",n??"",i?r.join(i,"Android","Sdk"):""])}async function s(t){try{return await i.access(t,i.constants.X_OK),!0}catch{return!1}}async function c(t=process.env){let e,n=[];for(let i of d(t)){let t=[];for(let e of f){let n=r.join(i,e);await s(n)&&t.push(n)}0!==t.length&&(e||(e=i),n.push(...t))}if(e&&(t.ANDROID_SDK_ROOT=t.ANDROID_SDK_ROOT?.trim()||e,t.ANDROID_HOME=t.ANDROID_HOME?.trim()||e),0===n.length)return;let i=(t.PATH??"").split(r.delimiter).map(t=>t.trim()).filter(t=>t.length>0);t.PATH=u([...n,...i]).join(r.delimiter)}let m=new n("utf-16le");async function h(t){for(let r of["AndroidManifest.xml","base/manifest/AndroidManifest.xml"]){var e;let n=await p(t,r);if(!n)continue;let i=(e=n).subarray(0,Math.min(e.length,128)).toString("utf8").trimStart().startsWith("<")?function(t){let e=t.match(/<manifest\b[^>]*\bpackage\s*=\s*["']([^"']+)["']/i);return e?.[1]}(e.toString("utf8")):function(t){let e;if(!(t.length<8)&&3===t.readUInt16LE(0))for(let r=t.readUInt16LE(2);r+8<=t.length;){let n=t.readUInt16LE(r),i=t.readUInt16LE(r+2),a=t.readUInt32LE(r+4);if(a<=0||r+a>t.length)break;if(1===n)e=function(t){if(t.length<28)return[];let e=t.readUInt32LE(8),r=t.readUInt32LE(16),n=t.readUInt32LE(20),i=(256&r)!=0,a=[];for(let r=0;r<e;r+=1){let e=28+4*r;if(e+4>t.length)break;let o=n+t.readUInt32LE(e);a.push(i?function(t,e){let[,r]=I(t,e),[n,i]=I(t,e+r),a=e+r+i;return t.subarray(a,a+n).toString("utf8")}(t,o):function(t,e){let[r,n]=function(t,e){let r=t.readUInt16LE(e);return(32768&r)==0?[r,2]:[(32767&r)<<16|t.readUInt16LE(e+2),4]}(t,e),i=e+n;return m.decode(t.subarray(i,i+2*r))}(t,o))}return a}(t.subarray(r,r+a));else if(258===n&&e){let n=function(t,e,r,n){if(r<36||e+r>t.length||"manifest"!==n[t.readUInt32LE(e+20)])return;let i=t.readUInt16LE(e+24),a=t.readUInt16LE(e+26),o=t.readUInt16LE(e+28),l=e+i;for(let e=0;e<o;e+=1){let r=l+e*a;if(r+20>t.length)break;if("package"!==n[t.readUInt32LE(r+4)])continue;let i=t.readUInt32LE(r+8);if(0xffffffff!==i)return n[i];let o=t.readUInt8(r+15),f=t.readUInt32LE(r+16);if(3===o)return n[f];break}}(t,r,i,e);if(n)return n}r+=a}}(e);if(i)return i}return await E(t)}async function p(t,e){try{let r=await l("unzip",["-p",t,e],{allowFailure:!0,binaryStdout:!0});if(0!==r.exitCode||!r.stdoutBuffer||0===r.stdoutBuffer.length)return;return r.stdoutBuffer}catch{return}}function I(t,e){let r=t.readUInt8(e);return(128&r)==0?[r,1]:[(127&r)<<8|t.readUInt8(e+1),2]}async function E(t){let e=await g();if(!e)return;let r=await l(e,["dump","badging",t],{allowFailure:!0});if(0!==r.exitCode)return;let n=r.stdout.match(/package:\s+name='([^']+)'/);return n?.[1]}async function g(){if(void 0!==t)return t??void 0;try{for(let n of d()){let i=r.join(n,"build-tools");try{for(let n of(await e.readdir(i)).sort((t,e)=>e.localeCompare(t,void 0,{numeric:!0}))){let e=r.join(i,n,"aapt");if(r.isAbsolute(e)&&await o(e))return t=e,e}}catch{}}}catch{}t=null}export{c as ensureAndroidSdkPathConfigured,h as resolveAndroidArchivePackageName};
+let t;import e from"node:fs/promises";import r from"node:path";import{TextDecoder as n}from"node:util";import{promises as i}from"node:fs";import a from"node:os";import{isExecutablePath as o,runCmd as l}from"./8875.js";let f=["emulator","platform-tools",r.join("cmdline-tools","latest","bin"),r.join("cmdline-tools","tools","bin")];function u(t){let e=new Set,r=[];for(let n of t){let t=n.trim();!t||e.has(t)||(e.add(t),r.push(t))}return r}function d(t=process.env){let e=t.ANDROID_SDK_ROOT?.trim(),n=t.ANDROID_HOME?.trim(),i=t.HOME?.trim()||a.homedir();return u([e??"",n??"",i?r.join(i,"Android","Sdk"):""])}async function s(t){try{return await i.access(t,i.constants.X_OK),!0}catch{return!1}}async function c(t=process.env){let e,n=[];for(let i of d(t)){let t=[];for(let e of f){let n=r.join(i,e);await s(n)&&t.push(n)}0!==t.length&&(e||(e=i),n.push(...t))}if(e&&(t.ANDROID_SDK_ROOT=t.ANDROID_SDK_ROOT?.trim()||e,t.ANDROID_HOME=t.ANDROID_HOME?.trim()||e),0===n.length)return;let i=(t.PATH??"").split(r.delimiter).map(t=>t.trim()).filter(t=>t.length>0);t.PATH=u([...n,...i]).join(r.delimiter)}let m=new n("utf-16le");async function h(t){for(let r of["AndroidManifest.xml","base/manifest/AndroidManifest.xml"]){var e;let n=await p(t,r);if(!n)continue;let i=(e=n).subarray(0,Math.min(e.length,128)).toString("utf8").trimStart().startsWith("<")?function(t){let e=t.match(/<manifest\b[^>]*\bpackage\s*=\s*["']([^"']+)["']/i);return e?.[1]}(e.toString("utf8")):function(t){let e;if(!(t.length<8)&&3===t.readUInt16LE(0))for(let r=t.readUInt16LE(2);r+8<=t.length;){let n=t.readUInt16LE(r),i=t.readUInt16LE(r+2),a=t.readUInt32LE(r+4);if(a<=0||r+a>t.length)break;if(1===n)e=function(t){if(t.length<28)return[];let e=t.readUInt32LE(8),r=t.readUInt32LE(16),n=t.readUInt32LE(20),i=(256&r)!=0,a=[];for(let r=0;r<e;r+=1){let e=28+4*r;if(e+4>t.length)break;let o=n+t.readUInt32LE(e);a.push(i?function(t,e){let[,r]=I(t,e),[n,i]=I(t,e+r),a=e+r+i;return t.subarray(a,a+n).toString("utf8")}(t,o):function(t,e){let[r,n]=function(t,e){let r=t.readUInt16LE(e);return(32768&r)==0?[r,2]:[(32767&r)<<16|t.readUInt16LE(e+2),4]}(t,e),i=e+n;return m.decode(t.subarray(i,i+2*r))}(t,o))}return a}(t.subarray(r,r+a));else if(258===n&&e){let n=function(t,e,r,n){if(r<36||e+r>t.length||"manifest"!==n[t.readUInt32LE(e+20)])return;let i=t.readUInt16LE(e+24),a=t.readUInt16LE(e+26),o=t.readUInt16LE(e+28),l=e+i;for(let e=0;e<o;e+=1){let r=l+e*a;if(r+20>t.length)break;if("package"!==n[t.readUInt32LE(r+4)])continue;let i=t.readUInt32LE(r+8);if(0xffffffff!==i)return n[i];let o=t.readUInt8(r+15),f=t.readUInt32LE(r+16);if(3===o)return n[f];break}}(t,r,i,e);if(n)return n}r+=a}}(e);if(i)return i}return await E(t)}async function p(t,e){try{let r=await l("unzip",["-p",t,e],{allowFailure:!0,binaryStdout:!0});if(0!==r.exitCode||!r.stdoutBuffer||0===r.stdoutBuffer.length)return;return r.stdoutBuffer}catch{return}}function I(t,e){let r=t.readUInt8(e);return(128&r)==0?[r,1]:[(127&r)<<8|t.readUInt8(e+1),2]}async function E(t){let e=await g();if(!e)return;let r=await l(e,["dump","badging",t],{allowFailure:!0});if(0!==r.exitCode)return;let n=r.stdout.match(/package:\s+name='([^']+)'/);return n?.[1]}async function g(){if(void 0!==t)return t??void 0;try{for(let n of d()){let i=r.join(n,"build-tools");try{for(let n of(await e.readdir(i)).sort((t,e)=>e.localeCompare(t,void 0,{numeric:!0}))){let e=r.join(i,n,"aapt");if(r.isAbsolute(e)&&await o(e))return t=e,e}}catch{}}}catch{}t=null}export{c as ensureAndroidSdkPathConfigured,h as resolveAndroidArchivePackageName};

package/dist/src/314.js

@@ -0,0 +1 @@
+import{promises as t}from"node:fs";import e from"node:os";import i from"node:path";import{AppError as a}from"./733.js";function r(n={}){let l=n.cwd??process.cwd(),c=n.tempDir??e.tmpdir(),p=n.rootDir?o(n.rootDir,l):void 0;return{resolveInput:async t=>{if("uploadedArtifact"===t.kind)throw new a("UNSUPPORTED_OPERATION","Uploaded artifact inputs require a custom artifact adapter");return{path:o(t.path,l,p)}},reserveOutput:async(e,a)=>{let r,n=a.visibility??"client-visible",d=e?.kind==="path"?o(e.path,l,p):i.join(r=await t.mkdtemp(i.join(c,`agent-device-${a.field}-`)),`${a.field}${a.ext}`);return await t.mkdir(i.dirname(d),{recursive:!0}),{path:d,visibility:n,...r?{cleanup:async()=>{await t.rm(r,{recursive:!0,force:!0})}}:{},publish:async()=>e?.kind==="downloadableArtifact"?{kind:"localPath",field:a.field,path:d,fileName:e.fileName??i.basename(e.clientPath??d)}:void 0}},createTempFile:async e=>{let a=await t.mkdtemp(i.join(c,`${e.prefix}-`));return{path:i.join(a,`file${e.ext}`),visibility:"internal",cleanup:async()=>{await t.rm(a,{recursive:!0,force:!0})}}}}}function o(t,e,r){var o,n;let l,c=i.isAbsolute(t)?t:i.resolve(e,t);if(r&&(o=c,n=r,""!==(l=i.relative(n,o))&&(l.startsWith("..")||i.isAbsolute(l))))throw new a("INVALID_ARGS","Local path is outside the artifact adapter root",{path:c,rootDir:r});return c}export{r as createLocalArtifactAdapter};

package/dist/src/{8806.js → 3340.js}

@@ -1,7 +1,7 @@
-import{promises as t}from"node:fs";import e from"node:os";import a from"node:path";import{asAppError as n,AppError as i}from"./9152.js";import{emitDiagnostic as r}from"./7599.js";import{runCmd as o,resolveFileOverridePath as s,whichCmd as l,runCmdDetached as d}from"./9818.js";import{ensureAndroidSdkPathConfigured as u,resolveAndroidArchivePackageName as c}from"./7651.js";import{sleep as p}from"./4829.js";import{createAndroidPortReverseManager as f,resolveAndroidAdbProvider as m,installAndroidAdbPackage as w,resolveAndroidAdbExecutor as h}from"./9639.js";import{materializeInstallablePath as A,isTrustedInstallSourceUrl as y}from"./989.js";let g=["mCurrentFocus=Window{","mFocusedApp=AppWindowToken{","mResumedActivity:","ResumedActivity:"],v=/\bApplication Not Responding:\s*([A-Za-z0-9_.]+)/i,_=/([^{}]*\bis(?:n't| not)\s+responding[^{}]*)/i,M=/\b([A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z0-9_]+)+)\b/;function b(t){let e=new Set;for(let a of t.split("\n")){let t=a.trim();if(!t)continue;let n=t.split(/\s+/)[0]??"";if(!n.includes("/"))continue;let i=n.split("/")[0]??"";i.includes(".")&&i&&e.add(i)}return Array.from(e)}function I(t){return t.split("\n").map(t=>{let e=t.trim();return e.startsWith("package:")?e.slice(8):e}).filter(Boolean)}function N(t){return O(t,t=>(function(t){for(let e of t.trim().split(/\s+/)){let t=e.indexOf("/");if(t<=0)continue;let a=D(e.slice(0,t),!1),n=D(e.slice(t+1),!0);if(a&&n&&a.length===t)return{package:a,activity:n}}return null})(t))}function O(t,e){let a=t.split("\n");for(let t of g)for(let n of a){let a=n.indexOf(t);if(-1===a)continue;let i=n.trim(),r=e(n.slice(a+t.length),i);if(r)return r}return null}function D(t,e){let a=0;for(;a<t.length&&function(t,e){if(!t)return!1;let a=t.charCodeAt(0);return a>=48&&a<=57||a>=65&&a<=90||a>=97&&a<=122||"_"===t||"."===t||e&&"$"===t}(t[a],e);)a+=1;return t.slice(0,a)}function E(t){let e=t.trim();if(!e||/\s/.test(e))return!1;let a=/^([A-Za-z][A-Za-z0-9+.-]*):(.+)$/.exec(e);if(!a)return!1;let n=a[1]?.toLowerCase(),i=a[2]??"";return"http"!==n&&"https"!==n&&"ws"!==n&&"wss"!==n&&"ftp"!==n&&"ftps"!==n||i.startsWith("//")}function C(t){let e=t.trim().split(":")[0]?.toLowerCase();return"http"===e||"https"===e}function T(t,e){let a=t?.trim();return a||(C(e)?"com.apple.mobilesafari":void 0)}function L(t={}){let e=t.ttlMs??3e4,a=t.nowMs??Date.now,n=new Map,i=t=>{var e;let a=[(e=t).platform,e.deviceId,""].join("\0");for(let t of n.keys())t.startsWith(a)&&n.delete(t)};return{get(t,e){let i=k(t,e),r=n.get(i);if(r)return r.expiresAtMs<=a()?void n.delete(i):r.value},set:(t,i,r)=>(n.set(k(t,i),{value:r,expiresAtMs:a()+e}),r),clear(t){i(t)},async invalidateWhile(t,e){i(t);try{return await e()}finally{i(t)}}}}function k(t,e){return[t.platform,t.deviceId,t.variant??"",e.trim().toLowerCase()].join("\0")}function S(t){return["1","true","yes","on"].includes((t??"").trim().toLowerCase())}class R{startedAtMs;expiresAtMs;constructor(t,e){this.startedAtMs=t,this.expiresAtMs=t+Math.max(0,e)}static fromTimeoutMs(t,e=Date.now()){return new R(e,t)}remainingMs(t=Date.now()){return Math.max(0,this.expiresAtMs-t)}elapsedMs(t=Date.now()){return Math.max(0,t-this.startedAtMs)}isExpired(t=Date.now()){return 0>=this.remainingMs(t)}}async function x(t,e={},a={}){let n,r={maxAttempts:e.maxAttempts??3,baseDelayMs:e.baseDelayMs??200,maxDelayMs:e.maxDelayMs??2e3,jitter:e.jitter??.2,shouldRetry:e.shouldRetry};for(let e=1;e<=r.maxAttempts;e+=1){if(a.signal?.aborted)throw new i("COMMAND_FAILED","request canceled",{reason:"request_canceled"});if(a.deadline?.isExpired()&&e>1)break;try{let n=await t({attempt:e,maxAttempts:r.maxAttempts,deadline:a.deadline});return a.onEvent?.({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),P({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),n}catch(d){n=d;let t=a.classifyReason?.(d),i={phase:a.phase,event:"attempt_failed",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};if(a.onEvent?.(i),P(i),e>=r.maxAttempts||r.shouldRetry&&!r.shouldRetry(d,e))break;let o=function(t,e,a,n){let i=Math.min(e,t*2**(n-1));return Math.max(0,i+i*a*(2*Math.random()-1))}(r.baseDelayMs,r.maxDelayMs,r.jitter,e),s=a.deadline?Math.min(o,a.deadline.remainingMs()):o;if(s<=0)break;let l={phase:a.phase,event:"retry_scheduled",attempt:e,maxAttempts:r.maxAttempts,delayMs:s,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};a.onEvent?.(l),P(l),await function(t,e){return new Promise(a=>{if(e?.aborted)return void a();let n=!1,i=()=>{n||(n=!0,e&&e.removeEventListener("abort",o),a())},r=setTimeout(i,t);function o(){clearTimeout(r),i()}e&&e.addEventListener("abort",o,{once:!0})})}(s,a.signal)}}let o={phase:a.phase,event:"exhausted",attempt:r.maxAttempts,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:a.classifyReason?.(n)};if(a.onEvent?.(o),P(o),n)throw n;throw new i("COMMAND_FAILED","retry failed")}async function U(t,e={}){return x(()=>t(),{maxAttempts:e.attempts,baseDelayMs:e.baseDelayMs,maxDelayMs:e.maxDelayMs,jitter:e.jitter,shouldRetry:e.shouldRetry})}function P(t){r({level:"attempt_failed"===t.event||"exhausted"===t.event?"warn":"debug",phase:"retry",data:{...t}})}function F(t){return t?.trim()||void 0}function B(t){return F(t)}function $(t){return new Set(t.split(/[\s,]+/).map(t=>t.trim()).filter(Boolean))}function V(t,e=process.env){let a=F(t)??F(e.AGENT_DEVICE_ANDROID_DEVICE_ALLOWLIST);if(a)return $(a)}let W=new Set(["IOS_BOOT_TIMEOUT","IOS_RUNNER_CONNECT_TIMEOUT","IOS_TOOL_MISSING","ANDROID_BOOT_TIMEOUT","ADB_TRANSPORT_UNAVAILABLE","CI_RESOURCE_STARVATION_SUSPECTED"]);function G(t){return W.has(t.toUpperCase())}function j(t){let e=t.error?n(t.error):null,a=t.context?.platform,i=t.context?.phase;if(e?.code==="TOOL_MISSING")return"android"===a?"ADB_TRANSPORT_UNAVAILABLE":"IOS_TOOL_MISSING";let r=e?.details??{},o="string"==typeof r.message?r.message:void 0,s="string"==typeof r.stdout?r.stdout:void 0,l="string"==typeof r.stderr?r.stderr:void 0,d=r.boot&&"object"==typeof r.boot?r.boot:null,u=r.bootstatus&&"object"==typeof r.bootstatus?r.bootstatus:null,c=[t.message,e?.message,t.stdout,t.stderr,o,s,l,"string"==typeof d?.stdout?d.stdout:void 0,"string"==typeof d?.stderr?d.stderr:void 0,"string"==typeof u?.stdout?u.stdout:void 0,"string"==typeof u?.stderr?u.stderr:void 0].filter(Boolean).join("\n").toLowerCase();return"ios"===a&&(c.includes("runner did not accept connection")||"connect"===i&&(c.includes("timed out")||c.includes("timeout")||c.includes("econnrefused")||c.includes("connection refused")||c.includes("fetch failed")||c.includes("socket hang up")))?"IOS_RUNNER_CONNECT_TIMEOUT":"ios"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"IOS_BOOT_TIMEOUT":"android"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"ANDROID_BOOT_TIMEOUT":c.includes("resource temporarily unavailable")||c.includes("killed: 9")||c.includes("cannot allocate memory")||c.includes("system is low on memory")?"CI_RESOURCE_STARVATION_SUSPECTED":"android"===a&&(c.includes("device not found")||c.includes("no devices")||c.includes("device offline")||c.includes("offline")||c.includes("unauthorized")||c.includes("not authorized")||c.includes("unable to locate device")||c.includes("invalid device"))?"ADB_TRANSPORT_UNAVAILABLE":e?.code==="COMMAND_FAILED"||c.length>0?"BOOT_COMMAND_FAILED":"UNKNOWN"}function H(t){switch(t){case"IOS_BOOT_TIMEOUT":return"Retry simulator boot and inspect simctl bootstatus logs; in CI reduce parallel jobs or use a larger runner.";case"IOS_RUNNER_CONNECT_TIMEOUT":return"Retry runner startup, inspect xcodebuild logs, and verify simulator responsiveness before command execution.";case"ANDROID_BOOT_TIMEOUT":return"Retry emulator startup and verify sys.boot_completed reaches 1; consider increasing startup budget in CI.";case"ADB_TRANSPORT_UNAVAILABLE":return"Check adb server/device transport (adb devices -l), restart adb, and ensure the target device is online and authorized.";case"CI_RESOURCE_STARVATION_SUSPECTED":return"CI machine may be resource constrained; reduce parallel jobs or use a larger runner.";case"IOS_TOOL_MISSING":return"Xcode command-line tools are missing or not in PATH; run xcode-select --install and verify xcrun works.";case"BOOT_COMMAND_FAILED":return"Inspect command stderr/stdout for the failing boot phase and retry after environment validation.";default:return"Retry once and inspect verbose logs for the failing phase."}}let K=["android.software.leanback","android.software.leanback_only","android.hardware.type.television"];async function z(t,e,a){let n=Array(t.length),i=0,r=Math.min(e,t.length);return await Promise.all(Array.from({length:r},async()=>{for(;i<t.length;){let e=i;i+=1,n[e]=await a(t[e])}})),n}function q(t){return`${t.stdout}
+import{promises as t}from"node:fs";import e from"node:os";import a from"node:path";import{asAppError as n,AppError as i}from"./733.js";import{emitDiagnostic as r}from"./432.js";import{runCmd as o,resolveFileOverridePath as s,whichCmd as l,runCmdDetached as d}from"./8875.js";import{ensureAndroidSdkPathConfigured as u,resolveAndroidArchivePackageName as c}from"./3006.js";import{sleep as p}from"./5560.js";import{createAndroidPortReverseManager as f,resolveAndroidAdbProvider as m,installAndroidAdbPackage as w,resolveAndroidAdbExecutor as h}from"./2954.js";import{materializeInstallablePath as A,isTrustedInstallSourceUrl as y}from"./5484.js";let g=["mCurrentFocus=Window{","mFocusedApp=AppWindowToken{","mResumedActivity:","ResumedActivity:"],v=/\bApplication Not Responding:\s*([A-Za-z0-9_.]+)/i,_=/([^{}]*\bis(?:n't| not)\s+responding[^{}]*)/i,M=/\b([A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z0-9_]+)+)\b/;function b(t){let e=new Set;for(let a of t.split("\n")){let t=a.trim();if(!t)continue;let n=t.split(/\s+/)[0]??"";if(!n.includes("/"))continue;let i=n.split("/")[0]??"";i.includes(".")&&i&&e.add(i)}return Array.from(e)}function I(t){return t.split("\n").map(t=>{let e=t.trim();return e.startsWith("package:")?e.slice(8):e}).filter(Boolean)}function N(t){return O(t,t=>(function(t){for(let e of t.trim().split(/\s+/)){let t=e.indexOf("/");if(t<=0)continue;let a=D(e.slice(0,t),!1),n=D(e.slice(t+1),!0);if(a&&n&&a.length===t)return{package:a,activity:n}}return null})(t))}function O(t,e){let a=t.split("\n");for(let t of g)for(let n of a){let a=n.indexOf(t);if(-1===a)continue;let i=n.trim(),r=e(n.slice(a+t.length),i);if(r)return r}return null}function D(t,e){let a=0;for(;a<t.length&&function(t,e){if(!t)return!1;let a=t.charCodeAt(0);return a>=48&&a<=57||a>=65&&a<=90||a>=97&&a<=122||"_"===t||"."===t||e&&"$"===t}(t[a],e);)a+=1;return t.slice(0,a)}function E(t){let e=t.trim();if(!e||/\s/.test(e))return!1;let a=/^([A-Za-z][A-Za-z0-9+.-]*):(.+)$/.exec(e);if(!a)return!1;let n=a[1]?.toLowerCase(),i=a[2]??"";return"http"!==n&&"https"!==n&&"ws"!==n&&"wss"!==n&&"ftp"!==n&&"ftps"!==n||i.startsWith("//")}function C(t){let e=t.trim().split(":")[0]?.toLowerCase();return"http"===e||"https"===e}function T(t,e){let a=t?.trim();return a||(C(e)?"com.apple.mobilesafari":void 0)}function L(t={}){let e=t.ttlMs??3e4,a=t.nowMs??Date.now,n=new Map,i=t=>{var e;let a=[(e=t).platform,e.deviceId,""].join("\0");for(let t of n.keys())t.startsWith(a)&&n.delete(t)};return{get(t,e){let i=k(t,e),r=n.get(i);if(r)return r.expiresAtMs<=a()?void n.delete(i):r.value},set:(t,i,r)=>(n.set(k(t,i),{value:r,expiresAtMs:a()+e}),r),clear(t){i(t)},async invalidateWhile(t,e){i(t);try{return await e()}finally{i(t)}}}}function k(t,e){return[t.platform,t.deviceId,t.variant??"",e.trim().toLowerCase()].join("\0")}function S(t){return["1","true","yes","on"].includes((t??"").trim().toLowerCase())}class R{startedAtMs;expiresAtMs;constructor(t,e){this.startedAtMs=t,this.expiresAtMs=t+Math.max(0,e)}static fromTimeoutMs(t,e=Date.now()){return new R(e,t)}remainingMs(t=Date.now()){return Math.max(0,this.expiresAtMs-t)}elapsedMs(t=Date.now()){return Math.max(0,t-this.startedAtMs)}isExpired(t=Date.now()){return 0>=this.remainingMs(t)}}async function x(t,e={},a={}){let n,r={maxAttempts:e.maxAttempts??3,baseDelayMs:e.baseDelayMs??200,maxDelayMs:e.maxDelayMs??2e3,jitter:e.jitter??.2,shouldRetry:e.shouldRetry};for(let e=1;e<=r.maxAttempts;e+=1){if(a.signal?.aborted)throw new i("COMMAND_FAILED","request canceled",{reason:"request_canceled"});if(a.deadline?.isExpired()&&e>1)break;try{let n=await t({attempt:e,maxAttempts:r.maxAttempts,deadline:a.deadline});return a.onEvent?.({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),P({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),n}catch(d){n=d;let t=a.classifyReason?.(d),i={phase:a.phase,event:"attempt_failed",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};if(a.onEvent?.(i),P(i),e>=r.maxAttempts||r.shouldRetry&&!r.shouldRetry(d,e))break;let o=function(t,e,a,n){let i=Math.min(e,t*2**(n-1));return Math.max(0,i+i*a*(2*Math.random()-1))}(r.baseDelayMs,r.maxDelayMs,r.jitter,e),s=a.deadline?Math.min(o,a.deadline.remainingMs()):o;if(s<=0)break;let l={phase:a.phase,event:"retry_scheduled",attempt:e,maxAttempts:r.maxAttempts,delayMs:s,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};a.onEvent?.(l),P(l),await function(t,e){return new Promise(a=>{if(e?.aborted)return void a();let n=!1,i=()=>{n||(n=!0,e&&e.removeEventListener("abort",o),a())},r=setTimeout(i,t);function o(){clearTimeout(r),i()}e&&e.addEventListener("abort",o,{once:!0})})}(s,a.signal)}}let o={phase:a.phase,event:"exhausted",attempt:r.maxAttempts,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:a.classifyReason?.(n)};if(a.onEvent?.(o),P(o),n)throw n;throw new i("COMMAND_FAILED","retry failed")}async function U(t,e={}){return x(()=>t(),{maxAttempts:e.attempts,baseDelayMs:e.baseDelayMs,maxDelayMs:e.maxDelayMs,jitter:e.jitter,shouldRetry:e.shouldRetry})}function P(t){r({level:"attempt_failed"===t.event||"exhausted"===t.event?"warn":"debug",phase:"retry",data:{...t}})}function F(t){return t?.trim()||void 0}function B(t){return F(t)}function $(t){return new Set(t.split(/[\s,]+/).map(t=>t.trim()).filter(Boolean))}function V(t,e=process.env){let a=F(t)??F(e.AGENT_DEVICE_ANDROID_DEVICE_ALLOWLIST);if(a)return $(a)}let W=new Set(["IOS_BOOT_TIMEOUT","IOS_RUNNER_CONNECT_TIMEOUT","IOS_TOOL_MISSING","ANDROID_BOOT_TIMEOUT","ADB_TRANSPORT_UNAVAILABLE","CI_RESOURCE_STARVATION_SUSPECTED"]);function G(t){return W.has(t.toUpperCase())}function j(t){let e=t.error?n(t.error):null,a=t.context?.platform,i=t.context?.phase;if(e?.code==="TOOL_MISSING")return"android"===a?"ADB_TRANSPORT_UNAVAILABLE":"IOS_TOOL_MISSING";let r=e?.details??{},o="string"==typeof r.message?r.message:void 0,s="string"==typeof r.stdout?r.stdout:void 0,l="string"==typeof r.stderr?r.stderr:void 0,d=r.boot&&"object"==typeof r.boot?r.boot:null,u=r.bootstatus&&"object"==typeof r.bootstatus?r.bootstatus:null,c=[t.message,e?.message,t.stdout,t.stderr,o,s,l,"string"==typeof d?.stdout?d.stdout:void 0,"string"==typeof d?.stderr?d.stderr:void 0,"string"==typeof u?.stdout?u.stdout:void 0,"string"==typeof u?.stderr?u.stderr:void 0].filter(Boolean).join("\n").toLowerCase();return"ios"===a&&(c.includes("runner did not accept connection")||"connect"===i&&(c.includes("timed out")||c.includes("timeout")||c.includes("econnrefused")||c.includes("connection refused")||c.includes("fetch failed")||c.includes("socket hang up")))?"IOS_RUNNER_CONNECT_TIMEOUT":"ios"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"IOS_BOOT_TIMEOUT":"android"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"ANDROID_BOOT_TIMEOUT":c.includes("resource temporarily unavailable")||c.includes("killed: 9")||c.includes("cannot allocate memory")||c.includes("system is low on memory")?"CI_RESOURCE_STARVATION_SUSPECTED":"android"===a&&(c.includes("device not found")||c.includes("no devices")||c.includes("device offline")||c.includes("offline")||c.includes("unauthorized")||c.includes("not authorized")||c.includes("unable to locate device")||c.includes("invalid device"))?"ADB_TRANSPORT_UNAVAILABLE":e?.code==="COMMAND_FAILED"||c.length>0?"BOOT_COMMAND_FAILED":"UNKNOWN"}function H(t){switch(t){case"IOS_BOOT_TIMEOUT":return"Retry simulator boot and inspect simctl bootstatus logs; in CI reduce parallel jobs or use a larger runner.";case"IOS_RUNNER_CONNECT_TIMEOUT":return"Retry runner startup, inspect xcodebuild logs, and verify simulator responsiveness before command execution.";case"ANDROID_BOOT_TIMEOUT":return"Retry emulator startup and verify sys.boot_completed reaches 1; consider increasing startup budget in CI.";case"ADB_TRANSPORT_UNAVAILABLE":return"Check adb server/device transport (adb devices -l), restart adb, and ensure the target device is online and authorized.";case"CI_RESOURCE_STARVATION_SUSPECTED":return"CI machine may be resource constrained; reduce parallel jobs or use a larger runner.";case"IOS_TOOL_MISSING":return"Xcode command-line tools are missing or not in PATH; run xcode-select --install and verify xcrun works.";case"BOOT_COMMAND_FAILED":return"Inspect command stderr/stdout for the failing boot phase and retry after environment validation.";default:return"Retry once and inspect verbose logs for the failing phase."}}let K=["android.software.leanback","android.software.leanback_only","android.hardware.type.television"];async function z(t,e,a){let n=Array(t.length),i=0,r=Math.min(e,t.length);return await Promise.all(Array.from({length:r},async()=>{for(;i<t.length;){let e=i;i+=1,n[e]=await a(t[e])}})),n}function q(t){return`${t.stdout}
 ${t.stderr}`}function Z(t,e){return["-s",t,...e]}function J(t){return t.startsWith("emulator-")}function X(t){return t.toLowerCase().replace(/_/g," ").replace(/\s+/g," ").trim()}async function Q(t,e=1e4){return o("adb",Z(t,["shell","getprop","sys.boot_completed"]),{allowFailure:!0,timeoutMs:e})}async function Y(t,e){let a=e.replace(/_/g," ").trim();if(!J(t))return a||t;let n=await te(t);return n?n.replace(/_/g," "):a||t}async function tt(t,e,a){try{return await a("adb",Z(t,e),{allowFailure:!0,timeoutMs:1e4})}catch(t){var i;if("COMMAND_FAILED"===(i=n(t)).code&&"number"==typeof i.details?.timeoutMs)return;throw t}}async function te(t,e=o){for(let a of["ro.boot.qemu.avd_name","persist.sys.avd_name"]){let n=await tt(t,["shell","getprop",a],e);if(!n)continue;let i=n.stdout.trim();if(0===n.exitCode&&i.length>0)return i}let a=await tt(t,["emu","avd","name"],e);if(!a)return;let n=function(t){let e=t.split("\n").map(t=>t.trim()).filter(t=>t.length>0);if(0!==e.length)return"OK"===e.at(-1)&&e.pop(),e.join("\n").trim()||void 0}(a.stdout);if(0===a.exitCode&&n)return n}async function ta(t,e){let a=q(await o("adb",Z(t,["shell","cmd","package","has-feature",e]),{allowFailure:!0,timeoutMs:1e4})).toLowerCase();return!!a.includes("true")||!a.includes("false")&&null}async function tn(t){return(await z(K,2,async e=>await ta(t,e))).some(t=>!0===t)}async function ti(t){var e;let a;return"tv"===((a=q(await o("adb",Z(t,["shell","getprop","ro.build.characteristics"]),{allowFailure:!0,timeoutMs:1e4})).toLowerCase()).includes("tv")||a.includes("leanback")?"tv":null)||await tn(t)?"tv":(e=q(await o("adb",Z(t,["shell","pm","list","features"]),{allowFailure:!0,timeoutMs:1e4})),/feature:android\.(software\.leanback(_only)?|hardware\.type\.television)\b/i.test(e))?"tv":"mobile"}async function tr(t={}){if(await u(),!await l("adb"))throw new i("TOOL_MISSING","adb not found in PATH");let e=t.serialAllowlist??V(void 0),a=(await to()).filter(t=>!e||e.has(t.serial));return await z(a,3,async({serial:t,rawModel:e})=>{let[a,n,i]=await Promise.all([Y(t,e),tu(t),ti(t)]);return{platform:"android",id:t,name:a,kind:J(t)?"emulator":"device",target:i,booted:n}})}async function to(){return(await o("adb",["devices","-l"],{timeoutMs:1e4})).stdout.split("\n").map(t=>t.trim()).filter(t=>t.length>0&&!t.startsWith("List of devices")).map(t=>t.split(/\s+/)).flatMap(t=>{let e=t[0];return void 0===e||"device"!==t[1]?[]:[{serial:e,rawModel:(t.find(t=>t.startsWith("model:"))??"").replace("model:","")}]})}async function ts(){let t=await o("emulator",["-list-avds"],{allowFailure:!0,timeoutMs:1e4});if(0!==t.exitCode)throw new i("COMMAND_FAILED","Failed to list Android emulator AVDs",{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode,hint:"Verify Android emulator tooling is installed and available in PATH."});return t.stdout.split("\n").map(t=>t.trim()).filter(t=>t.length>0)}async function tl(t){let e=Date.now();for(;Date.now()-e<t.timeoutMs;){try{let e=await td(t.avdName,t.serial);if(e)return{platform:"android",id:e,name:t.avdName,kind:"emulator",target:"mobile",booted:!1}}catch{}await p(1e3)}throw new i("COMMAND_FAILED","Android emulator did not appear in time",{avdName:t.avdName,serial:t.serial,timeoutMs:t.timeoutMs,hint:"Check emulator logs and verify the AVD can start from command line."})}async function td(t,e){let a=X(t);for(let t of(await to()).filter(t=>(!e||t.serial===e)&&J(t.serial)))if(X(t.rawModel)===a||X(await Y(t.serial,t.rawModel))===a)return t.serial}async function tu(t){try{let e=await Q(t);return"1"===e.stdout.trim()}catch{return!1}}async function tc(t){var e,a;let n;await u();let r=t.avdName.trim();if(!r)throw new i("INVALID_ARGS","Android emulator boot requires a non-empty AVD name.");let o=t.timeoutMs??12e4;if(!await l("adb"))throw new i("TOOL_MISSING","adb not found in PATH");if(!await l("emulator"))throw new i("TOOL_MISSING","emulator not found in PATH");let s=await ts(),c=function(t,e){let a=t.find(t=>t===e);if(a)return a;let n=X(e);return t.find(t=>X(t)===n)}(s,r);if(!c)throw new i("DEVICE_NOT_FOUND",`No Android emulator AVD named ${t.avdName}`,{requestedAvdName:r,availableAvds:s,hint:"Run `emulator -list-avds` and pass an existing AVD name to --device."});let p=Date.now(),f=(e=await tr(),a=t.serial,n=X(c),e.find(t=>"android"===t.platform&&"emulator"===t.kind&&(!a||t.id===a)&&X(t.name)===n));if(!f){let e=["-avd",c];t.headless&&e.push("-no-window","-no-audio"),d("emulator",e)}let m=f??await tl({avdName:c,serial:t.serial,timeoutMs:o}),w=Math.max(1e3,o-(Date.now()-p));await tp(m.id,w);let h=(await tr()).find(t=>t.id===m.id);return h?{...h,name:c,booted:!0}:{...m,name:c,booted:!0}}async function tp(t,e=6e4){let a,r=R.fromTimeoutMs(e),o=Math.max(1,Math.ceil(e/1e3)),s=!1;try{await x(async({deadline:n})=>{if(n?.isExpired())throw s=!0,new i("COMMAND_FAILED","Android boot deadline exceeded",{serial:t,timeoutMs:e,elapsedMs:r.elapsedMs(),message:"timeout"});let o=Math.max(1e3,n?.remainingMs()??e),l=await Q(t,Math.min(o,1e4));if(a=l,"1"!==l.stdout.trim())throw new i("COMMAND_FAILED","Android device is still booting",{serial:t,stdout:l.stdout,stderr:l.stderr,exitCode:l.exitCode})},{maxAttempts:o,baseDelayMs:1e3,maxDelayMs:1e3,jitter:0,shouldRetry:t=>{let e=j({error:t,stdout:a?.stdout,stderr:a?.stderr,context:{platform:"android",phase:"boot"}});return"ADB_TRANSPORT_UNAVAILABLE"!==e&&"ANDROID_BOOT_TIMEOUT"!==e}},{deadline:r,phase:"boot",classifyReason:t=>j({error:t,stdout:a?.stdout,stderr:a?.stderr,context:{platform:"android",phase:"boot"}})})}catch(f){let o=n(f),l=a?.stdout,d=a?.stderr,u=a?.exitCode,c=j({error:f,stdout:l,stderr:d,context:{platform:"android",phase:"boot"}});"BOOT_COMMAND_FAILED"===c&&"Android device is still booting"===o.message&&(c="ANDROID_BOOT_TIMEOUT");let p={serial:t,timeoutMs:e,elapsedMs:r.elapsedMs(),reason:c,hint:H(c),stdout:l,stderr:d,exitCode:u};if(s||"ANDROID_BOOT_TIMEOUT"===c)throw new i("COMMAND_FAILED","Android device did not finish booting in time",p);if("TOOL_MISSING"===o.code)throw new i("TOOL_MISSING",o.message,{...p,...o.details??{}});if("ADB_TRANSPORT_UNAVAILABLE"===c)throw new i("COMMAND_FAILED",o.message,{...p,...o.details??{}});throw new i(o.code,o.message,{...p,...o.details??{}},o.cause)}}async function tf(t,e,a){return await h(t)(e,a)}function tm(t){return{platform:"android",id:t,name:t,kind:t.startsWith("emulator-")?"emulator":"device",booted:!0}}function tw(t,e){let a=`${t}
-${e}`.toLowerCase();return a.includes("no shell command implementation")||a.includes("unknown command")}let th=/\.(?:apk|aab)$/i,tA=/^[A-Za-z_][\w]*(\.[A-Za-z_][\w]*)+$/;function ty(t){var e,a;let n=t.trim();return 0===n.length?"other":th.test(n)?n.includes("/")||n.includes("\\")||n.startsWith(".")||n.startsWith("~")||(e=n,!tA.test(e))?"binary":"package":(a=n,tA.test(a))?"package":"other"}function tg(t){return`Android runtime hints require an installed package name, not "${t}". Install or reinstall the app first, then relaunch by package.`}async function tv(t,e){let n="url"===t.kind&&y(t.url),i=await A({source:t,isInstallablePath:(t,e)=>{var n;let i;return e.isFile()&&(n=t,".apk"===(i=a.extname(n).toLowerCase())||".aab"===i)},installableLabel:"Android installable (.apk or .aab)",allowArchiveExtraction:"url"!==t.kind||n,signal:e?.signal});try{let t=e?.resolveIdentity===!1?{}:await t_(i.installablePath);return{archivePath:i.archivePath,installablePath:i.installablePath,packageName:t.packageName,cleanup:i.cleanup}}catch(t){throw await i.cleanup(),t}}async function t_(t){let e=a.extname(t).toLowerCase();return".apk"!==e&&".aab"!==e?{}:{packageName:await c(t)}}let tM={settings:{type:"intent",value:"android.settings.SETTINGS"}},tb="android.intent.category.LAUNCHER",tI="android.intent.category.LEANBACK_LAUNCHER",tN="android.intent.category.DEFAULT",tO="Run agent-device apps --platform android to discover the installed package name, then retry open with that exact package.",tD=new Set(["localhost","127.0.0.1","::1","[::1]"]),tE=L();function tC(t){return{platform:"android",deviceId:t.id,variant:t.target??""}}async function tT(t,e){let a=e.trim();if("package"===ty(a))return{type:"package",value:a};let n=tM[a.toLowerCase()];if(n)return n;let r=tC(t),o=tE.get(r,a);if(o)return o;let s=(await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean).filter(t=>t.toLowerCase().includes(a.toLowerCase())),l=s[0];if(void 0!==l&&1===s.length)return tE.set(r,a,{type:"package",value:l});if(s.length>1)throw new i("INVALID_ARGS",`Multiple packages matched "${e}"`,{matches:s,hint:"Run agent-device apps --platform android to see the exact installed package names before retrying open."});throw new i("APP_NOT_INSTALLED",`No package found matching "${e}"`,{hint:tO})}async function tL(t,e){let a=await tk(t);return("user-installed"===e?(await tR(t)).filter(t=>a.has(t)):Array.from(a)).sort((t,e)=>t.localeCompare(e)).map(t=>({package:t,name:tx(t)}))}async function tk(t){let e=new Set;for(let a of tS(t,{includeFallbackWhenUnknown:!0})){let n=await tf(t,["shell","cmd","package","query-activities","--brief","-a","android.intent.action.MAIN","-c",a],{allowFailure:!0});if(0===n.exitCode&&0!==n.stdout.trim().length)for(let t of b(n.stdout))e.add(t)}return e}function tS(t,e={}){return"tv"===t.target?[tI]:"mobile"===t.target?[tb]:e.includeFallbackWhenUnknown?[tb,tI]:[tb]}async function tR(t){return I((await tf(t,["shell","pm","list","packages","-3"])).stdout)}function tx(t){let e=new Set(["com","android","google","app","apps","service","services","mobile","client"]),a=t.split(".").flatMap(t=>t.split(/[_-]+/)).map(t=>t.trim().toLowerCase()).filter(t=>t.length>0),n=a[a.length-1]??t;for(let t=a.length-1;t>=0;t-=1){let i=a[t];if(i&&!e.has(i)){n=i;break}}return n.split(/[^a-z0-9]+/i).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}async function tU(t){let e=await tF(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]]);if(e)return e;let a=await tF(t,[["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]);return a||{}}async function tP(t){return await tB(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]])}async function tF(t,e){for(let a of e){let e=N((await tf(t,a,{allowFailure:!0})).stdout??"");if(e)return e}return null}async function tB(t,e){for(let a of e){let e=O((await tf(t,a,{allowFailure:!0})).stdout??"",(t,e)=>(function(t,e){let a=t.split("}")[0]?.trim()??t.trim(),n=v.exec(a);if(n){let t=n[1];return{package:t,focusedWindow:`Application Not Responding: ${t}`,raw:e}}let i=_.exec(a);if(!i)return null;let r=i[1];if(void 0===r)return null;let o=r.trim().replace(/\s+/g," "),s=M.exec(o)?.[1];return{...s?{package:s}:{},focusedWindow:o,raw:e}})(t,e));if(e)return e}return null}async function t$(t,e){let a=function(t){let e;try{e=new URL(t)}catch{return null}let a=e.hostname.toLowerCase();if(!tD.has(a)||!e.port)return null;let n=Number(e.port);return Number.isInteger(n)?`tcp:${n}`:null}(e);if(!a)return;let n=f(m(t));try{await n.ensure({local:a,remote:a})}catch(e){let t={localPort:a.replace("tcp:",""),operation:`adb reverse ${a} ${a}`};throw e instanceof i&&Object.assign(t,{hint:e.details?.hint,diagnosticId:e.details?.diagnosticId,logPath:e.details?.logPath}),new i("COMMAND_FAILED",`Failed to ensure Android port reverse ${a} before opening localhost URL`,t,e)}}function tV(t){return/^[A-Za-z0-9_@%+=:,./-]+$/.test(t)?t:`'${t.replace(/'/g,"'\\''")}'`}function tW(t){return(t.launchArgs??[]).map(tV)}async function tG(t,e,a){var n;t.booted||await tp(t.id);let i="string"==typeof(n=a)?{activity:n}:n??{},r=i.activity,o=e.trim();if(E(o))return void await tj(t,o,i);if(void 0!==i.url)return void await tH(t,e,i);let s=await tT(t,e),l=tS(t)[0]??tb;"intent"===s.type?await tK(t,s.value,i):r?await tz(t,s.value,r,l,i):await tq(t,s.value,l,i)}async function tj(t,e,a){var n;let r;if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening a deep link URL");await t$(t,e),await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",e,...(n=a.appBundleId,(r=n?.trim())?["-p",r]:[]),...tW(a)])}async function tH(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening an app-bound deep link URL");let n=a.url?.trim()??"";if(!E(n))throw new i("INVALID_ARGS","Android app-bound open requires a valid URL target");let r=await tJ(t,e,"app-bound open");await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",n,"-p",r,...tW(a)])}async function tK(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override requires a package name, not an intent");await tf(t,["shell","am","start","-W","-a",e,...tW(a)])}async function tz(t,e,a,n,i){let r=a.includes("/")?a:`${e}/${a.startsWith(".")?a:`.${a}`}`;try{await tf(t,tZ(r,n,i))}catch(a){throw await tY(t,e,a),a}}async function tq(t,e,a,n){let r=await tf(t,["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",a,"-p",e,...tW(n)],{allowFailure:!0});if(0===r.exitCode&&!t9(r.stdout,r.stderr))return;let o=await t1(t,e);if(!o){if(!await tQ(t,e))throw tX(e);throw new i("COMMAND_FAILED",`Failed to launch ${e}`,{stdout:r.stdout,stderr:r.stderr})}await tf(t,tZ(o,a,n))}function tZ(t,e,a){return["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",e,"-n",t,...tW(a)]}async function tJ(t,e,a){let n=await tT(t,e);if("intent"===n.type)throw new i("INVALID_ARGS",`Android ${a} requires a package name, not an intent`);return n.value}function tX(t){return new i("APP_NOT_INSTALLED",`No package found matching "${t}"`,{package:t,hint:tO})}async function tQ(t,e){let a=await tf(t,["shell","pm","path",e],{allowFailure:!0}),n=`${a.stdout}
+${e}`.toLowerCase();return a.includes("no shell command implementation")||a.includes("unknown command")}let th=/\.(?:apk|aab)$/i,tA=/^[A-Za-z_][\w]*(\.[A-Za-z_][\w]*)+$/;function ty(t){var e,a;let n=t.trim();return 0===n.length?"other":th.test(n)?n.includes("/")||n.includes("\\")||n.startsWith(".")||n.startsWith("~")||(e=n,!tA.test(e))?"binary":"package":(a=n,tA.test(a))?"package":"other"}function tg(t){return`Android runtime hints require an installed package name, not "${t}". Install or reinstall the app first, then relaunch by package.`}async function tv(t,e){let n="url"===t.kind&&y(t.url),i=await A({source:t,isInstallablePath:(t,e)=>{var n;let i;return e.isFile()&&(n=t,".apk"===(i=a.extname(n).toLowerCase())||".aab"===i)},installableLabel:"Android installable (.apk or .aab)",allowArchiveExtraction:"url"!==t.kind||n,signal:e?.signal});try{let t=e?.resolveIdentity===!1?{}:await t_(i.installablePath);return{archivePath:i.archivePath,installablePath:i.installablePath,packageName:t.packageName,cleanup:i.cleanup}}catch(t){throw await i.cleanup(),t}}async function t_(t){let e=a.extname(t).toLowerCase();return".apk"!==e&&".aab"!==e?{}:{packageName:await c(t)}}let tM={settings:{type:"intent",value:"android.settings.SETTINGS"}},tb="android.intent.category.LAUNCHER",tI="android.intent.category.LEANBACK_LAUNCHER",tN="android.intent.category.DEFAULT",tO="Run agent-device apps --platform android to discover the installed package name, then retry open with that exact package.",tD=new Set(["localhost","127.0.0.1","::1","[::1]"]),tE=L();function tC(t){return{platform:"android",deviceId:t.id,variant:t.target??""}}async function tT(t,e){let a=e.trim();if("package"===ty(a))return{type:"package",value:a};let n=tM[a.toLowerCase()];if(n)return n;let r=tC(t),o=tE.get(r,a);if(o)return o;let s=(await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean).filter(t=>t.toLowerCase().includes(a.toLowerCase())),l=s[0];if(void 0!==l&&1===s.length)return tE.set(r,a,{type:"package",value:l});if(s.length>1)throw new i("INVALID_ARGS",`Multiple packages matched "${e}"`,{matches:s,hint:"Run agent-device apps --platform android to see the exact installed package names before retrying open."});throw new i("APP_NOT_INSTALLED",`No package found matching "${e}"`,{hint:tO})}async function tL(t,e){let a=await tk(t);return("user-installed"===e?(await tR(t)).filter(t=>a.has(t)):Array.from(a)).sort((t,e)=>t.localeCompare(e)).map(t=>({package:t,name:tx(t)}))}async function tk(t){let e=new Set;for(let a of tS(t,{includeFallbackWhenUnknown:!0})){let n=await tf(t,["shell","cmd","package","query-activities","--brief","-a","android.intent.action.MAIN","-c",a],{allowFailure:!0});if(0===n.exitCode&&0!==n.stdout.trim().length)for(let t of b(n.stdout))e.add(t)}return e}function tS(t,e={}){return"tv"===t.target?[tI]:"mobile"===t.target?[tb]:e.includeFallbackWhenUnknown?[tb,tI]:[tb]}async function tR(t){return I((await tf(t,["shell","pm","list","packages","-3"])).stdout)}function tx(t){let e=new Set(["com","android","google","app","apps","service","services","mobile","client"]),a=t.split(".").flatMap(t=>t.split(/[_-]+/)).map(t=>t.trim().toLowerCase()).filter(t=>t.length>0),n=a[a.length-1]??t;for(let t=a.length-1;t>=0;t-=1){let i=a[t];if(i&&!e.has(i)){n=i;break}}return n.split(/[^a-z0-9]+/i).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}async function tU(t){let e=await tF(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]]);if(e)return e;let a=await tF(t,[["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]);return a||{}}async function tP(t){return await tB(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]])}async function tF(t,e){for(let a of e){let e=N((await tf(t,a,{allowFailure:!0})).stdout??"");if(e)return e}return null}async function tB(t,e){for(let a of e){let e=O((await tf(t,a,{allowFailure:!0})).stdout??"",(t,e)=>(function(t,e){let a=t.split("}")[0]?.trim()??t.trim(),n=v.exec(a);if(n){let t=n[1];return{package:t,focusedWindow:`Application Not Responding: ${t}`,raw:e}}let i=_.exec(a);if(!i)return null;let r=i[1];if(void 0===r)return null;let o=r.trim().replace(/\s+/g," "),s=M.exec(o)?.[1];return{...s?{package:s}:{},focusedWindow:o,raw:e}})(t,e));if(e)return e}return null}async function t$(t,e){let a=function(t){let e;try{e=new URL(t)}catch{return null}let a=e.hostname.toLowerCase();if(!tD.has(a)||!e.port)return null;let n=Number(e.port);return Number.isInteger(n)?`tcp:${n}`:null}(e);if(!a)return;let n=f(m(t));try{await n.ensure({local:a,remote:a})}catch(e){let t={localPort:a.replace("tcp:",""),operation:`adb reverse ${a} ${a}`};throw e instanceof i&&Object.assign(t,{hint:e.details?.hint,diagnosticId:e.details?.diagnosticId,logPath:e.details?.logPath}),new i("COMMAND_FAILED",`Failed to ensure Android port reverse ${a} before opening localhost URL`,t,e)}}function tV(t){return/^[A-Za-z0-9_@%+=:,./-]+$/.test(t)?t:`'${t.replace(/'/g,"'\\''")}'`}function tW(t){return(t.launchArgs??[]).map(tV)}async function tG(t,e,a){var n;t.booted||await tp(t.id);let i="string"==typeof(n=a)?{activity:n}:n??{},r=i.activity,o=e.trim();if(E(o))return void await tj(t,o,i);if(void 0!==i.url)return void await tH(t,e,i);let s=await tT(t,e),l=tS(t)[0]??tb;"intent"===s.type?await tK(t,s.value,i):r?await tz(t,s.value,r,l,i):await tq(t,s.value,l,i)}async function tj(t,e,a){var n;let r;if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening a deep link URL");await t$(t,e),await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",e,...(n=a.appBundleId,(r=n?.trim())?["-p",r]:[]),...tW(a)])}async function tH(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening an app-bound deep link URL");let n=a.url?.trim()??"";if(!E(n))throw new i("INVALID_ARGS","Android app-bound open requires a valid URL target");let r=await tJ(t,e,"app-bound open");await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",n,"-p",r,...tW(a)])}async function tK(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override requires a package name, not an intent");await tf(t,["shell","am","start","-W","-a",e,...tW(a)])}async function tz(t,e,a,n,i){let r=a.includes("/")?a:`${e}/${a.startsWith(".")?a:`.${a}`}`;try{await tf(t,tZ(r,n,i))}catch(a){throw await tY(t,e,a),a}}async function tq(t,e,a,n){let r=await tf(t,["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",a,"-p",e,...tW(n)],{allowFailure:!0});if(0===r.exitCode&&!t3(r.stdout,r.stderr))return;let o=await t1(t,e);if(!o){if(!await tQ(t,e))throw tX(e);throw new i("COMMAND_FAILED",`Failed to launch ${e}`,{stdout:r.stdout,stderr:r.stderr})}await tf(t,tZ(o,a,n))}function tZ(t,e,a){return["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",e,"-n",t,...tW(a)]}async function tJ(t,e,a){let n=await tT(t,e);if("intent"===n.type)throw new i("INVALID_ARGS",`Android ${a} requires a package name, not an intent`);return n.value}function tX(t){return new i("APP_NOT_INSTALLED",`No package found matching "${t}"`,{package:t,hint:tO})}async function tQ(t,e){let a=await tf(t,["shell","pm","path",e],{allowFailure:!0}),n=`${a.stdout}
 ${a.stderr}`;return!!(0===a.exitCode&&/\bpackage:/i.test(n))||(t0(n),!1)}async function tY(t,e,a){if(t0(a instanceof i?`${String(a.details?.stdout??"")}
-${String(a.details?.stderr??"")}`:"")||!await tQ(t,e))throw tX(e)}function t0(t){return/\bunknown package\b/i.test(t)||/\bpackage .* (?:was|is) not found\b/i.test(t)||/\bpackage .* does not exist\b/i.test(t)||/\bcould not find package\b/i.test(t)}async function t1(t,e){for(let a of Array.from(new Set(tS(t,{includeFallbackWhenUnknown:!0})))){let n=await tf(t,["shell","cmd","package","resolve-activity","--brief","-a","android.intent.action.MAIN","-c",a,e],{allowFailure:!0});if(0!==n.exitCode)continue;let i=t2(n.stdout);if(i)return i}return null}function t9(t,e){let a=`${t}
-${e}`;return/Error:.*(?:Activity not started|unable to resolve Intent)/i.test(a)}function t2(t){let e=t.split("\n").map(t=>t.trim()).filter(Boolean);for(let t=e.length-1;t>=0;t-=1){let a=e[t];if(void 0===a||!a.includes("/"))continue;let n=a.split(/\s+/)[0];if(void 0!==n)return n}return null}async function t3(t){t.booted||await tp(t.id)}async function t4(t,e){if("settings"===e.trim().toLowerCase()){await tf(t,["shell","am","force-stop","com.android.settings"]),await t5(t,"com.android.settings");return}let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","Close requires a package name, not an intent");await tf(t,["shell","am","force-stop",a.value]),await t5(t,a.value)}async function t5(t,e){await t8(t,e),await t6(t,e)}async function t8(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){let a=await t7(t);if(a?.package!==e)return;await p(50)}}async function t7(t){for(let e of[["shell","dumpsys","window","windows"],["shell","dumpsys","window"],["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]){let a=N((await tf(t,e,{allowFailure:!0})).stdout??"");if(a)return a}return null}async function t6(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){if(!await et(t,e)&&(await p(150),!await et(t,e)))return;await p(50)}}async function et(t,e){return((await tf(t,["shell","pidof",e],{allowFailure:!0})).stdout??"").trim().length>0}async function ee(t,e){let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","App uninstall requires a package name, not an intent");let n=await tf(t,["uninstall",a.value],{allowFailure:!0});if(0!==n.exitCode){let t=`${n.stdout}
-${n.stderr}`.toLowerCase();if(!t.includes("unknown package")&&!t.includes("not installed"))throw new i("COMMAND_FAILED",`adb uninstall failed for ${a.value}`,{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})}return{package:a.value}}let ea=null;async function en(){let t=`${process.env.PATH??""}::${process.env.AGENT_DEVICE_BUNDLETOOL_JAR??""}`;if(ea?.key===t)return ea.invocation;if(await l("bundletool")){let e={cmd:"bundletool",prefixArgs:[]};return ea={key:t,invocation:e},e}let e=await s(process.env.AGENT_DEVICE_BUNDLETOOL_JAR,"AGENT_DEVICE_BUNDLETOOL_JAR");if(!e)throw new i("TOOL_MISSING","bundletool not found in PATH. Install bundletool or set AGENT_DEVICE_BUNDLETOOL_JAR to a bundletool-all.jar path.");let a={cmd:"java",prefixArgs:["-jar",e]};return ea={key:t,invocation:a},a}async function ei(t){let e=await en();await o(e.cmd,[...e.prefixArgs,...t])}async function er(n,i){let r=m(n),o="universal";if(r.installBundle)return void await r.installBundle(i,{mode:o});let s=await t.mkdtemp(a.join(e.tmpdir(),"agent-device-aab-")),l=a.join(s,"bundle.apks");try{await ei(["build-apks","--bundle",i,"--output",l,"--mode",o]),await ei(["install-apks","--apks",l,"--device-id",n.id])}finally{await t.rm(s,{recursive:!0,force:!0})}}async function eo(t,e){".aab"===a.extname(e).toLowerCase()?await er(t,e):await w(e,{device:t,replace:!0})}async function es(t){return new Set((await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean))}async function el(t,e){let a=Array.from(await es(t)).filter(t=>!e.has(t));if(1===a.length)return a[0]}async function ed(t,e){await tE.invalidateWhile(tC(t),async()=>{t.booted||await tp(t.id),await eo(t,e)})}async function eu(t,e,a){let n=a?void 0:await es(t);return await ed(t,e),a??(n?await el(t,n):void 0)}async function ec(t,e){t.booted||await tp(t.id);let a=await tv({kind:"path",path:e});try{let e=await eu(t,a.installablePath,a.packageName),n=e?tx(e):void 0;return{archivePath:a.archivePath,installablePath:a.installablePath,packageName:e,appName:n,launchTarget:e}}finally{await a.cleanup()}}async function ep(t,e,a){return await tE.invalidateWhile(tC(t),async()=>{t.booted||await tp(t.id);let{package:n}=await ee(t,e),i=await tv({kind:"path",path:a},{resolveIdentity:!1});try{await ed(t,i.installablePath)}finally{await i.cleanup()}return{package:n}})}async function ef(t,e={}){let a=["logcat","-d","-v","time"];void 0!==e.lines&&a.push("-t",String(Math.max(1,Math.floor(e.lines))));let n=await t(a,{allowFailure:!0,timeoutMs:e.timeoutMs,signal:e.signal});if(0!==n.exitCode)throw new i("COMMAND_FAILED","Failed to capture Android logcat",{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode});return n.stdout}function em(t,e={}){if(!t.spawn)throw new i("UNSUPPORTED_OPERATION","Android ADB provider does not support streams",{capability:"adb.spawn"});let a=["logcat","-v","time"];e.pid&&a.push("--pid",e.pid);let n=t.spawn(a,{stdio:["ignore","pipe","pipe"],signal:e.signal});return e.output&&n.stdout&&n.stdout.pipe(e.output,{end:!1}),n}export{R as Deadline,tm as androidDeviceForSerial,H as bootFailureHint,ef as captureAndroidLogcatWithAdb,ty as classifyAndroidAppTarget,j as classifyBootFailure,t4 as closeAndroidApp,L as createAppResolutionCache,tc as ensureAndroidEmulatorBooted,tg as formatAndroidInstalledPackageRequiredMessage,tU as getAndroidAppState,tP as getAndroidBlockingDialogFocus,tx as inferAndroidAppName,ec as installAndroidApp,eu as installAndroidInstallablePathAndResolvePackageName,t9 as isAmStartError,tw as isClipboardShellUnsupported,E as isDeepLinkTarget,S as isEnvTruthy,G as isInfrastructureBootFailureReason,C as isWebUrl,tL as listAndroidApps,tr as listAndroidDevices,tG as openAndroidApp,t3 as openAndroidDevice,N as parseAndroidForegroundApp,t2 as parseAndroidLaunchComponent,b as parseAndroidLaunchablePackages,I as parseAndroidUserInstalledPackages,$ as parseSerialAllowlist,tv as prepareAndroidInstallArtifact,ep as reinstallAndroidApp,tT as resolveAndroidApp,V as resolveAndroidSerialAllowlist,T as resolveIosDeviceDeepLinkBundleId,B as resolveIosSimulatorDeviceSetPath,x as retryWithPolicy,tf as runAndroidAdb,em as streamAndroidLogcatWithAdb,tp as waitForAndroidBoot,U as withRetry};
+${String(a.details?.stderr??"")}`:"")||!await tQ(t,e))throw tX(e)}function t0(t){return/\bunknown package\b/i.test(t)||/\bpackage .* (?:was|is) not found\b/i.test(t)||/\bpackage .* does not exist\b/i.test(t)||/\bcould not find package\b/i.test(t)}async function t1(t,e){for(let a of Array.from(new Set(tS(t,{includeFallbackWhenUnknown:!0})))){let n=await tf(t,["shell","cmd","package","resolve-activity","--brief","-a","android.intent.action.MAIN","-c",a,e],{allowFailure:!0});if(0!==n.exitCode)continue;let i=t4(n.stdout);if(i)return i}return null}function t3(t,e){let a=`${t}
+${e}`;return/Error:.*(?:Activity not started|unable to resolve Intent)/i.test(a)}function t4(t){let e=t.split("\n").map(t=>t.trim()).filter(Boolean);for(let t=e.length-1;t>=0;t-=1){let a=e[t];if(void 0===a||!a.includes("/"))continue;let n=a.split(/\s+/)[0];if(void 0!==n)return n}return null}async function t2(t){t.booted||await tp(t.id)}async function t5(t,e){if("settings"===e.trim().toLowerCase()){await tf(t,["shell","am","force-stop","com.android.settings"]),await t9(t,"com.android.settings");return}let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","Close requires a package name, not an intent");await tf(t,["shell","am","force-stop",a.value]),await t9(t,a.value)}async function t9(t,e){await t7(t,e),await t6(t,e)}async function t7(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){let a=await t8(t);if(a?.package!==e)return;await p(50)}}async function t8(t){for(let e of[["shell","dumpsys","window","windows"],["shell","dumpsys","window"],["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]){let a=N((await tf(t,e,{allowFailure:!0})).stdout??"");if(a)return a}return null}async function t6(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){if(!await et(t,e)&&(await p(150),!await et(t,e)))return;await p(50)}}async function et(t,e){return((await tf(t,["shell","pidof",e],{allowFailure:!0})).stdout??"").trim().length>0}async function ee(t,e){let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","App uninstall requires a package name, not an intent");let n=await tf(t,["uninstall",a.value],{allowFailure:!0});if(0!==n.exitCode){let t=`${n.stdout}
+${n.stderr}`.toLowerCase();if(!t.includes("unknown package")&&!t.includes("not installed"))throw new i("COMMAND_FAILED",`adb uninstall failed for ${a.value}`,{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})}return{package:a.value}}let ea=null;async function en(){let t=`${process.env.PATH??""}::${process.env.AGENT_DEVICE_BUNDLETOOL_JAR??""}`;if(ea?.key===t)return ea.invocation;if(await l("bundletool")){let e={cmd:"bundletool",prefixArgs:[]};return ea={key:t,invocation:e},e}let e=await s(process.env.AGENT_DEVICE_BUNDLETOOL_JAR,"AGENT_DEVICE_BUNDLETOOL_JAR");if(!e)throw new i("TOOL_MISSING","bundletool not found in PATH. Install bundletool or set AGENT_DEVICE_BUNDLETOOL_JAR to a bundletool-all.jar path.");let a={cmd:"java",prefixArgs:["-jar",e]};return ea={key:t,invocation:a},a}async function ei(t){let e=await en();await o(e.cmd,[...e.prefixArgs,...t])}async function er(n,i){let r=m(n),o="universal";if(r.installBundle)return void await r.installBundle(i,{mode:o});let s=await t.mkdtemp(a.join(e.tmpdir(),"agent-device-aab-")),l=a.join(s,"bundle.apks");try{await ei(["build-apks","--bundle",i,"--output",l,"--mode",o]),await ei(["install-apks","--apks",l,"--device-id",n.id])}finally{await t.rm(s,{recursive:!0,force:!0})}}async function eo(t,e){".aab"===a.extname(e).toLowerCase()?await er(t,e):await w(e,{device:t,replace:!0})}async function es(t){return new Set((await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean))}async function el(t,e){let a=Array.from(await es(t)).filter(t=>!e.has(t));if(1===a.length)return a[0]}async function ed(t,e){await tE.invalidateWhile(tC(t),async()=>{t.booted||await tp(t.id),await eo(t,e)})}async function eu(t,e,a){let n=a?void 0:await es(t);return await ed(t,e),a??(n?await el(t,n):void 0)}async function ec(t,e){t.booted||await tp(t.id);let a=await tv({kind:"path",path:e});try{let e=await eu(t,a.installablePath,a.packageName),n=e?tx(e):void 0;return{archivePath:a.archivePath,installablePath:a.installablePath,packageName:e,appName:n,launchTarget:e}}finally{await a.cleanup()}}async function ep(t,e,a){return await tE.invalidateWhile(tC(t),async()=>{t.booted||await tp(t.id);let{package:n}=await ee(t,e),i=await tv({kind:"path",path:a},{resolveIdentity:!1});try{await ed(t,i.installablePath)}finally{await i.cleanup()}return{package:n}})}async function ef(t,e={}){let a=["logcat","-d","-v","time"];void 0!==e.lines&&a.push("-t",String(Math.max(1,Math.floor(e.lines))));let n=await t(a,{allowFailure:!0,timeoutMs:e.timeoutMs,signal:e.signal});if(0!==n.exitCode)throw new i("COMMAND_FAILED","Failed to capture Android logcat",{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode});return n.stdout}function em(t,e={}){if(!t.spawn)throw new i("UNSUPPORTED_OPERATION","Android ADB provider does not support streams",{capability:"adb.spawn"});let a=["logcat","-v","time"];e.pid&&a.push("--pid",e.pid);let n=t.spawn(a,{stdio:["ignore","pipe","pipe"],signal:e.signal});return e.output&&n.stdout&&n.stdout.pipe(e.output,{end:!1}),n}export{R as Deadline,tm as androidDeviceForSerial,H as bootFailureHint,ef as captureAndroidLogcatWithAdb,ty as classifyAndroidAppTarget,j as classifyBootFailure,t5 as closeAndroidApp,L as createAppResolutionCache,tc as ensureAndroidEmulatorBooted,tg as formatAndroidInstalledPackageRequiredMessage,tU as getAndroidAppState,tP as getAndroidBlockingDialogFocus,tx as inferAndroidAppName,ec as installAndroidApp,eu as installAndroidInstallablePathAndResolvePackageName,t3 as isAmStartError,tw as isClipboardShellUnsupported,E as isDeepLinkTarget,S as isEnvTruthy,G as isInfrastructureBootFailureReason,C as isWebUrl,tL as listAndroidApps,tr as listAndroidDevices,tG as openAndroidApp,t2 as openAndroidDevice,N as parseAndroidForegroundApp,t4 as parseAndroidLaunchComponent,b as parseAndroidLaunchablePackages,I as parseAndroidUserInstalledPackages,$ as parseSerialAllowlist,tv as prepareAndroidInstallArtifact,ep as reinstallAndroidApp,tT as resolveAndroidApp,V as resolveAndroidSerialAllowlist,T as resolveIosDeviceDeepLinkBundleId,B as resolveIosSimulatorDeviceSetPath,x as retryWithPolicy,tf as runAndroidAdb,em as streamAndroidLogcatWithAdb,tp as waitForAndroidBoot,U as withRetry};

package/dist/src/368.js

@@ -0,0 +1 @@
+import e,{promises as t}from"node:fs";import n from"node:path";import{Worker as a}from"node:worker_threads";import{fileURLToPath as r}from"node:url";import i from"node:crypto";import s from"node:os";import{buildMobileSnapshotPresentation as o,isSparseSnapshotQualityVerdict as l,now as d,isNodeVisibleInEffectiveViewport as u,sleep as c,publicSnapshotCaptureAnnotations as p,scrollCommand as h,longPressCommand as f,appendScreenshotScriptFlags as m,successText as w,focusCommand as g,toBackendResult as b,swipeCommand as y,recordingQualityInputToExportQuality as k,resolveInteractionTarget as v,toBackendContext as x,snapshotCaptureAnnotationsFrom as A,requireIntInRange as M,formatReactNativeOverlayWarning as S,pinchCommand as I,renderSnapshotQualityWarnings as P}from"./9873.js";import{emitDiagnostic as R}from"./432.js";import{asAppError as N,toAppErrorCode as _,AppError as D}from"./733.js";import{computeScreenshotDiffPixels as O,PNG as E,toBuffer as T,decodePng as C}from"./4418.js";import{expandRect as U,intersectArea as $,unionRects as L,rectCenter as B,clamp as q,normalizedRect as G,squaredDistance as X}from"./6024.js";import{whichCmd as Y,runCmd as F}from"./8875.js";import{formatSnapshotLine as K,formatRole as j,displayLabel as H,buildSnapshotDisplayLines as V}from"./7244.js";import{normalizeRef as z,findNodeByRef as W,buildSnapshotPresentationKey as J,usesMobileSnapshotPresentation as Z}from"./4291.js";import{extractNodeText as Q,findSnapshotAncestor as ee,parseSelectorChain as et,isNodeVisible as en,buildSnapshotNodeByIndex as ea,isNodeEditable as er,findSelectorChainMatch as ei,buildSelectorChainForNode as es,resolveSelectorChain as eo,findNodeByLabel as el,resolveRefLabel as ed,extractReadableText as eu,formatSelectorFailure as ec,normalizeType as ep,isFillableType as eh}from"./9836.js";import{findBestMatchesByLocator as ef}from"./587.js";import{isProcessAlive as em,readProcessStartTime as ew}from"./5628.js";import{sleep as eg}from"./5560.js";import{resolveAppsFilter as eb,assertResolvedAppsFilter as ey}from"./2748.js";let ek=/^-?\d+(\.\d+)?$/,ev=/^[^\s"\\]+$/,ex=new Map([["--count","count"],["--interval-ms","intervalMs"],["--hold-ms","holdMs"],["--jitter-px","jitterPx"]]),eA=new Map([["--count","count"],["--pause-ms","pauseMs"]]),eM=new Map([["--delay-ms","delayMs"]]);function eS(e){return"click"===e||"press"===e}function eI(e){return eS(e)||"longpress"===e}function eP(e){return"type"===e||"fill"===e}function eR(e){return e_(e,eD)}function eN(e){return JSON.stringify(e)}function e_(e,t){return t(e)?e:eN(e)}function eD(e){return eO(e)&&e.startsWith("@")||ek.test(e)}function eO(e){return ev.test(e)}function eE(e){let t=(e.positionals??[]).map(e=>eR(e));return[e.command,...t].join(" ")}function eT(e,t){let n=t.flags??{};if(eS(t.command)){"number"==typeof n.count&&e.push("--count",String(n.count)),"number"==typeof n.intervalMs&&e.push("--interval-ms",String(n.intervalMs)),"number"==typeof n.holdMs&&e.push("--hold-ms",String(n.holdMs)),"number"==typeof n.jitterPx&&e.push("--jitter-px",String(n.jitterPx)),!0===n.doubleTap&&e.push("--double-tap");let t=n.clickButton;t&&"primary"!==t&&e.push("--button",t);return}if("swipe"===t.command){"number"==typeof n.count&&e.push("--count",String(n.count)),"number"==typeof n.pauseMs&&e.push("--pause-ms",String(n.pauseMs)),("one-way"===n.pattern||"ping-pong"===n.pattern)&&e.push("--pattern",n.pattern);return}eP(t.command)&&"number"==typeof n.delayMs&&e.push("--delay-ms",String(n.delayMs))}function eC(e,t){t&&(("ios"===t.platform||"android"===t.platform)&&e.push("--platform",t.platform),"string"==typeof t.metroHost&&t.metroHost.length>0&&e.push("--metro-host",e_(t.metroHost,eO)),"number"==typeof t.metroPort&&e.push("--metro-port",String(t.metroPort)),"string"==typeof t.bundleUrl&&t.bundleUrl.length>0&&e.push("--bundle-url",e_(t.bundleUrl,eO)),"string"==typeof t.launchUrl&&t.launchUrl.length>0&&e.push("--launch-url",e_(t.launchUrl,eO)))}function eU(e,t){let n=[],a={},r=eS(e)?ex:"swipe"===e?eA:eP(e)?eM:void 0;for(let i=0;i<t.length;i+=1){let s=t[i];if(eS(e)&&"--double-tap"===s){a.doubleTap=!0;continue}let o=t[i+1];if(eS(e)&&"--button"===s&&void 0!==o){("primary"===o||"secondary"===o||"middle"===o)&&(a.clickButton=o),i+=1;continue}let l=r?.get(s);if(l&&void 0!==o){let e=eL(o);if(null!==e){a[l]=e,i+=1;continue}}if("swipe"===e&&"--pattern"===s&&void 0!==o){("one-way"===o||"ping-pong"===o)&&(a.pattern=o),i+=1;continue}n.push(s)}return{positionals:n,flags:a}}function e$(e){let t=[],n={};for(let a=0;a<e.length;a+=1){let r=e[a],i=e[a+1];if("--platform"===r&&void 0!==i){("ios"===i||"android"===i)&&(n.platform=i),a+=1;continue}if("--metro-host"===r&&void 0!==i){n.metroHost=i,a+=1;continue}if("--metro-port"===r&&void 0!==i){let e=eL(i);null!==e&&(n.metroPort=e),a+=1;continue}if("--bundle-url"===r&&void 0!==i){n.bundleUrl=i,a+=1;continue}if("--launch-url"===r&&void 0!==i){n.launchUrl=i,a+=1;continue}t.push(r)}return{positionals:t,flags:n}}function eL(e){if(!e)return null;let t=Number(e);return!Number.isFinite(t)||t<0?null:Math.floor(t)}function eB(e){var t;let n=[],a={};for(let t of e){if("--relaunch"===t){a.relaunch=!0;continue}n.push(t)}let r=e$(n);return{positionals:r.positionals,flags:a,runtime:(t=r.flags).platform||t.metroHost||void 0!==t.metroPort||t.bundleUrl||t.launchUrl?r.flags:void 0}}function eq(e,t={}){let n=[e.command];if("snapshot"===e.command)e.flags?.snapshotInteractiveOnly&&n.push("-i"),"number"==typeof e.flags?.snapshotDepth&&n.push("-d",String(e.flags.snapshotDepth)),e.flags?.snapshotScope&&n.push("-s",eR(e.flags.snapshotScope)),e.flags?.snapshotRaw&&n.push("--raw");else if("open"===e.command){for(let t of e.positionals??[])n.push(eR(t));e.flags?.relaunch&&n.push("--relaunch"),eC(n,e.runtime)}else if("runtime"===e.command)!function(e,t,n={}){let a=t.positionals??[];for(let t of n.includeAllPositionals?a:a.slice(0,1))e.push(e_(t,eO));eC(e,t.flags)}(n,e,{includeAllPositionals:t.runtimeIncludeAllPositionals});else if("record"===e.command)!function(e,t){let[n,...a]=t.positionals??[];for(let t of(n&&e.push(e_(n,eO)),a))e.push(eR(t));"number"==typeof t.flags?.fps&&e.push("--fps",String(t.flags.fps)),"number"==typeof t.flags?.screenshotMaxSize&&e.push("--max-size",String(t.flags.screenshotMaxSize)),("number"==typeof t.flags?.quality||"string"==typeof t.flags?.quality)&&e.push("--quality",String(t.flags.quality)),t.flags?.hideTouches&&e.push("--hide-touches")}(n,e);else if("screenshot"===e.command){for(let t of e.positionals??[])n.push(eR(t));m(n,e.flags)}else{for(let t of e.positionals??[])n.push(eR(t));eT(n,e)}return n.join(" ")}let eG=["status","get","dismiss","enter","return"];function eX(e){return eG.includes(e)}function eY(e){let t=e?.trim().split(/\s+/,1)[0];if(!t||!t.startsWith("@")||t.length<3)return null;let n=t.slice(1);return/^[A-Za-z_-]*\d[\w-]*$/i.test(n)||/^(?:ref|node|element|el)[\w-]*$/i.test(n)?t:null}class eF extends Error{}let eK=null,ej=!1,eH=!1,eV=0,ez=new Map;function eW(e){ej=!0,eH||(eH=!0,R({level:"warn",phase:"png_worker_unavailable",data:{reason:e}}),process.emitWarning(`PNG worker unavailable, falling back to in-process PNG processing: ${e}`))}function eJ(e){let t=ez.get(e.id);t&&(ez.delete(e.id),e0(),e.ok?t.resolve(e.result):t.reject(new D(_(e.error.code),e.error.message,e.error.details)))}function eZ(e,t){eK===e&&(eW(t.message),eK=null,e.terminate().catch(()=>{}),eQ(new eF(`PNG worker failed: ${t.message}`)))}function eQ(e){let t=[...ez.values()];for(let n of(ez.clear(),t))n.reject(e)}function e0(){eK&&(ez.size>0?eK.ref():eK.unref())}function e1(){if(ej)return null;if(eK)return eK;let t=function(t,a){try{let i=r(t),s=n.extname(i)||".js";return[n.join(n.dirname(i),`${a}${s}`),n.join(n.dirname(i),"internal",`${a}${s}`)].find(t=>e.existsSync(t))??null}catch{return null}}(import.meta.url,"png-worker");if(!t)return eW("worker entry module not found next to the current module"),null;try{let e=new a(t,{execArgv:t.endsWith(".ts")?["--experimental-strip-types"]:[]});return e.on("message",eJ),e.on("error",t=>{eZ(e,t)}),e.on("exit",t=>{eZ(e,Error(`PNG worker exited with code ${t}`))}),e.unref(),eK=e,e}catch(e){return eW(`failed to spawn worker: ${e instanceof Error?e.message:String(e)}`),null}}async function e2(e,t){try{return await function(e){let t=e1();if(!t)return Promise.reject(new eF("PNG worker is unavailable"));let n=eV+=1;return new Promise((a,r)=>{ez.set(n,{resolve:a,reject:r}),e0();try{t.postMessage({...e,id:n})}catch(e){ez.delete(n),e0(),r(new eF(`failed to post job to PNG worker: ${e instanceof Error?e.message:String(e)}`))}})}(e)}catch(e){if(e instanceof eF)return t();throw e}}function e4(){e1()}async function e3(){let e=eK;eK=null,eQ(new eF("PNG worker terminated")),e&&await e.terminate()}async function e5(e,t){let n=await e2({kind:"decode",png:e,label:t},()=>{let n=C(e,t);return{kind:"decode",width:n.width,height:n.height,data:n.data}});return new E({width:n.width,height:n.height,data:T(n.data)})}async function e8(e){return T((await e2({kind:"encode",width:e.width,height:e.height,data:e.data},()=>({kind:"encode",png:E.sync.write(e)}))).png)}async function e6(e){let{kind:t,...n}=await e2({kind:"diff-pixels",...e},()=>({kind:"diff-pixels",...O(e)}));return{...n,diffData:T(n.diffData)}}let e7=[0,187,255,255];function e9(e,t,n,a){if(t<0||t>=e.width||n<0||n>=e.height)return;let r=(n*e.width+t)*4;e.data[r]=a[0],e.data[r+1]=a[1],e.data[r+2]=a[2],e.data[r+3]=a[3]}function te(e,t,n){return Math.min(Math.max(e,t),n)}let tt=[{x:-1,y:-1},{x:0,y:-1},{x:1,y:-1},{x:-1,y:0},{x:1,y:0},{x:-1,y:1},{x:0,y:1},{x:1,y:1}];function tn(e){let{mask:t,width:n,height:a,hooks:r}=e,i=new Uint8Array(t.length),s=new Int32Array(t.length),o=[];for(let e=0;e<t.length;e+=1){var l,d;if(!ta(t,i,e))continue;let u=0,c=(l=s,i[d=e]=1,l[0]=d,1),p=r.create(e);for(;u<c;){let e=s[u];u+=1,r.visit(p,e),c=function(e){let{mask:t,visited:n,queue:a,width:r,height:i,pixelIndex:s}=e,o=s%r,l=Math.floor(s/r),d=e.queueEnd;for(let e of tt){var u,c,p,h;let s=o+e.x,f=l+e.y;if(u=s,c=f,p=r,h=i,!(u>=0)||!(u<p)||!(c>=0)||!(c<h))continue;let m=f*r+s;ta(t,n,m)&&(d=function(e,t,n,a){return t[a]=1,e[n]=a,n+1}(a,n,d,m))}return d}({mask:t,visited:i,queue:s,queueEnd:c,width:n,height:a,pixelIndex:e})}o.push(p)}return o}function ta(e,t,n){return 1===e[n]&&1!==t[n]}let tr={icon:90,toggle:90,chevron:75,separator:45,visual:35,background:10},ti={leading:20,trailing:20,separator:10,unknown:0,background:-30};function ts(e){return"background"!==e.likelyKind}function to(e,t){return e.width>=.25*t.width||e.height>=.06*t.height}function tl(e,t){let n,a=0;for(let r of t){let t=th(e,r.rect);t<=a||(a=t,n=r)}return n}function td(e){let t=[];for(let n of[...e].sort((e,t)=>e.rect.y-t.rect.y)){let e=t.find(e=>{var t,a;return t=e.rect,th(t,a=n.rect)>0||Math.abs(B(t).y-B(a).y)<=.5*Math.max(t.height,a.height)});if(!e){t.push({rect:n.rect,blocks:[n]});continue}e.blocks.push(n),e.blocks.sort((e,t)=>e.rect.x-t.rect.x),e.rect=L([e.rect,n.rect])}return t}function tu(e,t){let n,a=B(e);for(let e of t){let t=Math.sqrt(X(a,B(e.rect)));n&&t>=n.distance||(n={block:e,distance:t})}return n}function tc(e){let t=tp(e);return e.differentPixels>=24&&t.width>=3&&t.height>=3}function tp(e){return{x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1}}function th(e,t){return Math.max(0,Math.min(e.y+e.height,t.y+t.height)-Math.max(e.y,t.y))}async function tf(e){if(await Y("tesseract"))try{let[t,n]=await Promise.all([tw(e.baselinePath),tw(e.currentPath)]);if(0!==t.exitCode||0!==n.exitCode)return;let a=tm(t.stdout,e.width,e.height),r=tm(n.stdout,e.width,e.height),i=function(e,t){let n=new Set,a=[];for(let i of e){var r;let e=tx(i.text),s=function(e,t,n,a){let r=null,i=1/0;for(let s=0;s<n.length;s+=1){if(a.has(s))continue;let o=n[s];if(tx(o.text)!==t)continue;let l=B(e.normalizedRect),d=X(l,B(o.normalizedRect));d>=i||(r=s,i=d)}return r}(i,e,t,n);if(null===s)continue;n.add(s);let o=function(e,t){let n={x:t.rect.x-e.rect.x,y:t.rect.y-e.rect.y,width:t.rect.width-e.rect.width,height:t.rect.height-e.rect.height},a=tS(t.rect.width/e.rect.width),r=tS(t.rect.height/e.rect.height),i=Math.abs(a-1)>=.08||Math.abs(r-1)>=.12;return{text:e.text,baselineRect:e.rect,currentRect:t.rect,delta:n,confidence:Math.round(100*Math.min(e.confidence,t.confidence))/100,possibleTextMetricMismatch:i}}(i,t[s]);r=o,(Math.abs(r.delta.x)>=2||Math.abs(r.delta.y)>=2||Math.abs(r.delta.width)>=2||Math.abs(r.delta.height)>=2||r.possibleTextMetricMismatch)&&a.push(o)}return a.sort((e,t)=>tg(t)-tg(e)).slice(0,12)}(a,r),s=function(e){let t=[];for(let n of[...e].sort((e,t)=>e.currentRect.y-t.currentRect.y)){let e=t.find(e=>32>=Math.abs(n.delta.x-tA(e.map(e=>e.delta.x))));e?e.push(n):t.push([n])}return t.filter(e=>e.length>=2).map(tb).filter(e=>e.yRange.max-e.yRange.min<=60).sort((e,t)=>ty(t)-ty(e)).slice(0,4)}(i);if(0===a.length&&0===r.length)return;return{provider:"tesseract",baselineBlocks:a.length,currentBlocks:r.length,baselineBlocksRaw:a,currentBlocksRaw:r,matches:i,...s.length>0?{movementClusters:s}:{}}}catch{return}}function tm(e,t,n){let[a,...r]=e.split(/\r?\n/);if(!a)return[];let i=new Map(a.split("	").map((e,t)=>[e,t])),s=[];for(let e of r){var o;if(!e.trim())continue;let t=e.split("	"),n=tv(t,i,"level"),a=tk(t,i,"text").trim(),r=tv(t,i,"conf");if(5!==n||(o=a,!/[\p{L}\p{N}]/u.test(o))||r<0)continue;let l=tv(t,i,"left"),d=tv(t,i,"top"),u=tv(t,i,"width"),c=tv(t,i,"height");u<=0||c<=0||s.push({key:[tk(t,i,"page_num"),tk(t,i,"block_num"),tk(t,i,"par_num"),tk(t,i,"line_num")].join(":"),text:a,confidence:r,rect:{x:l,y:d,width:u,height:c}})}let l=new Map;for(let e of s){let t=l.get(e.key);t?t.push(e):l.set(e.key,[e])}return Array.from(l.values()).flatMap(e=>(function(e){let t=[...e].sort((e,t)=>e.rect.x-t.rect.x),n=[],a=[];for(let e of t){let t=a.at(-1);if(!t){a.push(e);continue}if(e.rect.x-(t.rect.x+t.rect.width)>Math.max(48,2.5*Math.max(t.rect.height,e.rect.height))){n.push(a),a=[e];continue}a.push(e)}return a.length>0&&n.push(a),n})(e)).map(e=>(function(e,t,n){if(0===e.length)return null;let a=[...e].sort((e,t)=>e.rect.x-t.rect.x),r=L(a.map(e=>e.rect)),i=Math.round(100*tA(a.map(e=>e.confidence)))/100;return{text:a.map(e=>e.text).join(" "),confidence:i,rect:r,normalizedRect:G({x:tM(r.x/t),y:tM(r.y/n),width:tM(r.width/t),height:tM(r.height/n)})}})(e,t,n)).filter(e=>null!==e)}function tw(e){return F("tesseract",[e,"stdout","-l","eng","tsv"],{allowFailure:!0,timeoutMs:1e4})}function tg(e){return Math.abs(e.delta.x)+Math.abs(e.delta.y)+Math.abs(e.delta.width)+Math.abs(e.delta.height)+25*!!e.possibleTextMetricMismatch}function tb(e){let t=e.map(e=>e.delta.x),n=e.map(e=>e.delta.y);return{texts:e.map(e=>e.text),xRange:{min:Math.min(...t),max:Math.max(...t)},yRange:{min:Math.min(...n),max:Math.max(...n)}}}function ty(e){return 2*Math.abs((e.xRange.min+e.xRange.max)/2)+Math.abs((e.yRange.min+e.yRange.max)/2)}function tk(e,t,n){let a=t.get(n);return void 0===a?"":e[a]??""}function tv(e,t,n){let a=Number(tk(e,t,n));return Number.isFinite(a)?a:0}function tx(e){return e.trim().replace(/\s+/g," ").toLowerCase()}function tA(e){return e.reduce((e,t)=>e+t,0)/e.length}function tM(e){return Math.round(100*e*100)/100}function tS(e){return Math.round(1e3*e)/1e3}function tI(e,t,n,a){return{r:Math.round(e/a),g:Math.round(t/a),b:Math.round(n/a)}}function tP(e){return .2126*e.r+.7152*e.g+.0722*e.b}function tR(e){return`#${tN(e.r)}${tN(e.g)}${tN(e.b)}`}function tN(e){return e.toString(16).padStart(2,"0")}function t_(e){return Math.round(100*e*100)/100}let tD=255*Math.sqrt(3);async function tO(e,a,r={}){var i,s,o,l,d;let u,c,p,h;await tE(e,"Baseline image not found"),await tE(a,"Current screenshot not found");let f=r.outputPath,[m,w]=await Promise.all([t.readFile(e),t.readFile(a)]),[g,b]=await Promise.all([e5(m,"baseline screenshot"),e5(w,"current screenshot")]);tT(g.width,g.height,"baseline screenshot",r.maxPixels),tT(b.width,b.height,"current screenshot",r.maxPixels);let y=r.threshold??.1;if(g.width!==b.width||g.height!==b.height){let e=g.width*g.height;return await tC(r.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:g.width,height:g.height},actual:{width:b.width,height:b.height}}}}let k=g.width*g.height,{diffData:v,diffMask:x,differentPixels:A}=await e6({width:g.width,height:g.height,baselineData:g.data,currentData:b.data,maxColorDistance:y*tD}),M=A>0?(s=(u=function(e){let{diffMask:t,baseline:n,current:a}=e,{width:r,height:i}=n;return tn({mask:t,width:r,height:i,hooks:{create:e=>{var t,n;let a,i;return a=(t=e)%(n=r),{minX:a,minY:i=Math.floor(t/n),maxX:a,maxY:i,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}},visit:(e,t)=>{var i,s,o,l,d;let u,c,p;return i=e,s=t,o=r,l=n,d=a,u=s%o,c=Math.floor(s/o),p=4*s,void(i.minX=Math.min(i.minX,u),i.minY=Math.min(i.minY,c),i.maxX=Math.max(i.maxX,u),i.maxY=Math.max(i.maxY,c),i.differentPixels+=1,i.baselineRed+=l.data[p],i.baselineGreen+=l.data[p+1],i.baselineBlue+=l.data[p+2],i.currentRed+=d.data[p],i.currentGreen+=d.data[p+1],i.currentBlue+=d.data[p+2])}}})}(i={diffMask:x,baseline:g,current:b,totalPixels:k,differentPixels:A,maxRegions:r.maxRegions})).length<=2e3?function(e){let t=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return 0!==n?n:e.minX-t.minX})){var n,a;let e=t.find(e=>{var t,n,a;return t=e,n=r,a=12,t.minX-a<=n.maxX&&n.minX-a<=t.maxX&&t.minY-a<=n.maxY&&n.minY-a<=t.maxY});if(!e){t.push({...r});continue}n=e,a=r,n.minX=Math.min(n.minX,a.minX),n.minY=Math.min(n.minY,a.minY),n.maxX=Math.max(n.maxX,a.maxX),n.maxY=Math.max(n.maxY,a.maxY),n.differentPixels+=a.differentPixels,n.baselineRed+=a.baselineRed,n.baselineGreen+=a.baselineGreen,n.baselineBlue+=a.baselineBlue,n.currentRed+=a.currentRed,n.currentGreen+=a.currentGreen,n.currentBlue+=a.currentBlue}return t}(u):u,s.flatMap(e=>{var t,n,a;let r;return(t=e,n=i.baseline.width,a=i.baseline.height,r=t.maxX-t.minX+1,t.maxY-t.minY+1>=Math.max(48,Math.round(.07*a))&&r>=.35*n)?function(e,t,n){var a;let r=function(e,t){let n=[],a=null;for(let r=0;r<e.length;r+=1){if(e[r]<=t){a??=r;continue}null!==a&&(r-a>=6&&n.push([a,r-1]),a=null)}return null!==a&&e.length-a>=6&&n.push([a,e.length-1]),n}((a=function(e,t,n){let a=[];for(let r=e.minY;r<=e.maxY;r+=1){let i=0;for(let a=e.minX;a<=e.maxX;a+=1)1===t[r*n+a]&&(i+=1);a.push(i)}return a}(e,t.diffMask,t.baseline.width)).map((e,t)=>{let n=0,r=0,i=Math.max(0,t-3),s=Math.min(a.length-1,t+3);for(let e=i;e<=s;e+=1)n+=a[e],r+=1;return Math.round(n/r)}),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),i=function(e,t,n){let a=[],r=e.minY;for(let[i,s]of t){let t=e.minY+Math.round((i+s)/2);t-r+1<n||e.maxY-t<n||(a.push([r,t]),r=t+1)}return a.push([r,e.maxY]),a}(e,r,n);if(i.length<=1)return[e];let s=i.map(([n,a])=>(function(e,t,n,a){let r=null;for(let o=t;o<=n;o+=1)for(let t=e.minX;t<=e.maxX;t+=1){var i,s;let e=o*a.baseline.width+t;1===a.diffMask[e]&&function(e,t,n,a,r,i){let s=4*t;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,a),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,a),e.differentPixels+=1,e.baselineRed+=r.data[s],e.baselineGreen+=r.data[s+1],e.baselineBlue+=r.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}(r??={minX:i=t,minY:s=o,maxX:i,maxY:s,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0},e,t,o,a.baseline,a.current)}return r})(e,n,a,t)).filter(e=>null!==e);return s.length>1?s:[e]}(e,i,Math.max(24,Math.round(.03*i.baseline.height))):[e]})).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(0!==n)return n;let a=e.minY-t.minY;return 0!==a?a:e.minX-t.minX}).slice(0,Math.max(0,i.maxRegions??8)).map((e,t)=>{var n,a,r,s,o,l,d,u,c,p,h;let f,m,w,g,b,y,k,v,x,A,M,S,I,P,R,N,_;return n=e,a=t+1,r={width:i.baseline.width,height:i.baseline.height,totalPixels:i.totalPixels,differentPixels:i.differentPixels},y={x:n.minX,y:n.minY,width:n.maxX-n.minX+1,height:n.maxY-n.minY+1},k={x:Math.round(n.minX+y.width/2),y:Math.round(n.minY+y.height/2)},v=tI(n.baselineRed,n.baselineGreen,n.baselineBlue,n.differentPixels),x=tI(n.currentRed,n.currentGreen,n.currentBlue,n.differentPixels),A=y.width*y.height,M=t_(n.differentPixels/A),S=Math.round(tP(v)),I=Math.round(tP(x)),P=(s=y,o=r.width,l=r.height,s.width>=.55*o&&s.height>=.12*l?"large-area":s.width>=2.5*s.height?"horizontal-band":s.height>=2.5*s.width?"vertical-band":"compact"),R=(f=A/r.totalPixels)>=.04?"large":f>=.01?"medium":"small",N=(d=v,u=x,m=tP(d),Math.abs(w=tP(u)-m)>=12?w>0?"brighter":"darker":Math.max(Math.abs(u.r-d.r),Math.abs(u.g-d.g),Math.abs(u.b-d.b))>=12?"color-shift":"mixed"),_=(c=k,p=r.width,h=r.height,g=c.x<p/3?"left":c.x>2*p/3?"right":"center",b=c.y<h/3?"top":c.y>2*h/3?"bottom":"middle","center"===g&&"middle"===b?"center":`${b}-${g}`),{index:a,rect:y,normalizedRect:G({x:t_(y.x/r.width),y:t_(y.y/r.height),width:t_(y.width/r.width),height:t_(y.height/r.height)}),differentPixels:n.differentPixels,shareOfDiffPercentage:t_(n.differentPixels/r.differentPixels),densityPercentage:M,shape:P,size:R,location:_,averageBaselineColorHex:tR(v),averageCurrentColorHex:tR(x),baselineLuminance:S,currentLuminance:I,dominantChange:N}}):[];if(A>0&&f){let e=new E({width:g.width,height:g.height,data:v});for(let t of M)t.rect.width<4||t.rect.height<4||function(e,t){let n=te(t.x,0,e.width-1),a=te(t.y,0,e.height-1),r=te(t.x+t.width-1,0,e.width-1),i=te(t.y+t.height-1,0,e.height-1);for(let t=0;t<2;t+=1){for(let s=n;s<=r;s+=1)e9(e,s,a+t,e7),e9(e,s,i-t,e7);for(let s=a;s<=i;s+=1)e9(e,n+t,s,e7),e9(e,r-t,s,e7)}}(e,t.rect);await t.mkdir(n.dirname(f),{recursive:!0}),await t.writeFile(f,await e8(e))}else await tC(r.outputPath);let S=A>0?await tf({baselinePath:e,currentPath:a,width:g.width,height:g.height}):void 0,I=S&&(S.matches.length>0||(S.movementClusters?.length??0)>0)?{provider:S.provider,baselineBlocks:S.baselineBlocks,currentBlocks:S.currentBlocks,matches:S.matches,...S.movementClusters?{movementClusters:S.movementClusters}:{}}:void 0,P=A>0&&S?(c=function(e){let t=[];for(let n of e.sort((e,t)=>e.minY-t.minY||e.minX-t.minX)){let e=t.find(e=>{var t,a,r;return t=e,a=n,r=10,t.minX-r<=a.maxX&&a.minX-r<=t.maxX&&t.minY-r<=a.maxY&&a.minY-r<=t.maxY});if(!e){t.push({...n});continue}e.minX=Math.min(e.minX,n.minX),e.minY=Math.min(e.minY,n.minY),e.maxX=Math.max(e.maxX,n.maxX),e.maxY=Math.max(e.maxY,n.maxY),e.differentPixels+=n.differentPixels}return t}((l=function(e,t,n,a){let r=new Uint8Array(e);if(!a)return r;for(let e of[...a.baselineBlocksRaw,...a.currentBlocksRaw])!function(e,t,n,a){let r=q(Math.floor(a.x),0,t-1),i=q(Math.floor(a.y),0,n-1),s=q(Math.ceil(a.x+a.width),0,t),o=q(Math.ceil(a.y+a.height),0,n);for(let n=i;n<o;n+=1)for(let a=r;a<s;a+=1)e[n*t+a]=0}(r,t,n,U(e.rect,8));return r}((o={diffMask:x,width:g.width,height:g.height,regions:M,ocr:S}).diffMask,o.width,o.height,o.ocr),d=o.width,tn({mask:l,width:d,height:o.height,hooks:{create:e=>{var t,n;let a,r;return a=(t=e)%(n=d),{minX:a,minY:r=Math.floor(t/n),maxX:a,maxY:r,differentPixels:0}},visit:(e,t)=>{var n,a,r;let i,s;return n=e,i=(a=t)%(r=d),s=Math.floor(a/r),void(n.minX=Math.min(n.minX,i),n.minY=Math.min(n.minY,s),n.maxX=Math.max(n.maxX,i),n.maxY=Math.max(n.maxY,s),n.differentPixels+=1)}}}))),p=td(o.ocr?.currentBlocksRaw??[]),h=td(o.ocr?.baselineBlocksRaw??[]),c.filter(tc).map(e=>{var t,n,a,r,i,s,l,d,u,c,f;let m,w,g,b,y,k,v,x,A,M;return t=e,n=o,a=p,r=h,b=function(e,t){let n,a=0;for(let r of t){let t=$(e,r.rect);t<=a||(a=t,n=r)}return n?.index}(g=tp(t),n.regions),y=function(e,t,n){let a=tl(e,t);if(a)return tu(e,a.blocks);let r=tl(e,n);return r?tu(e,r.blocks):void 0}(g,a,r),k=function(e,t,n){if(e.height<=3&&e.width>=.12*n)return"separator";if(!t)return e.width>=.4*n?"background":"unknown";if(e.width>=.4*n)return"background";let a=e.x+e.width/2,r=t.x+t.width/2;return a<r-t.width/2?"leading":a>r+t.width/2?"trailing":e.width>=.35*n?"background":"unknown"}(g,y?.block.rect,n.width),v=(i=g,s=k,l=t.differentPixels,d=n,m=i.width/i.height,w=l/(i.width*i.height),"separator"===s?"separator":"background"===s?"background":"trailing"===s&&m>=1.5&&m<=3.8&&w>=.35?"toggle":"trailing"===s&&i.width<=.06*d.width&&i.height<=.04*d.height?"chevron":"leading"===s&&m>=.55&&m<=1.8?"icon":to(i,d)?"background":"visual"),x={...b?{regionIndex:b}:{},slot:k,likelyKind:v,rect:g},{...b?{regionIndex:b}:{},slot:k,likelyKind:v,rect:g,...y?{nearestText:y.block.text.trim().replace(/^[^\p{L}\p{N}]+/u,"").replace(/^\p{L}\s+/u,"")}:{},score:(u=x,c=t.differentPixels,f=n,A=to(u.rect,f)?-35:0,M=20*!!u.regionIndex,tr[u.likelyKind]+ti[u.slot]+M+A+Math.min(20,c/200))}}).filter(e=>e.rect.y>=.08*o.height).filter(ts).sort((e,t)=>t.score-e.score).slice(0,Math.max(0,o.maxDeltas??12)).map((e,t)=>{var n;return n=e,{index:t+1,...n.regionIndex?{regionIndex:n.regionIndex}:{},slot:n.slot,likelyKind:n.likelyKind,rect:n.rect,...n.nearestText?{nearestText:n.nearestText}:{}}})):[],R=k>0?Math.round(A/k*1e4)/100:0;return{...A>0&&f?{diffPath:f}:{},...M.length>0?{regions:M}:{},...I?{ocr:I}:{},...P.length>0?{nonTextDeltas:P}:{},totalPixels:k,differentPixels:A,mismatchPercentage:R,match:0===A}}async function tE(e,n){try{await t.access(e)}catch{throw new D("INVALID_ARGS",`${n}: ${e}`)}}function tT(e,t,n,a){if(null==a||a<=0)return;let r=e*t;if(!(r<=a))throw new D("INVALID_ARGS",`${n} is ${r} pixels, which exceeds the configured maxImagePixels limit of ${a}`)}async function tC(e){if(e)try{await t.unlink(e)}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function tU(e){return e.width*e.height}function t$(e){return Math.round(100*e*100)/100}async function tL(e,t,n){if("path"===t.kind&&!e.policy.allowLocalInputPaths)throw new D("INVALID_ARGS",`Local ${n.field??"input"} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,n)}catch(e){throw N(e)}}async function tB(e,t,n){if(t?.kind==="path"&&!e.policy.allowLocalOutputPaths)throw new D("INVALID_ARGS","Local output paths are not allowed by command policy");try{return await e.artifacts.reserveOutput(t,{...n,visibility:n.visibility??"client-visible",requestedClientPath:t?.kind==="downloadableArtifact"?t.clientPath??n.requestedClientPath:n.requestedClientPath})}catch(e){throw N(e)}}async function tq(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw N(e)}}let tG=async(e,t)=>{let n,a,r;if(!t.baseline)throw new D("INVALID_ARGS","diff screenshot requires a baseline image");let i=function(e){if(null==e||""===e)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new D("INVALID_ARGS","--threshold must be a number between 0 and 1");return t}(t.threshold),s=t.current??{kind:"live"};if(t.overlayRefs&&!tV(s))throw new D("INVALID_ARGS","diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs");let o=await tL(e,t.baseline,{usage:"diff screenshot baseline",field:"baseline"}),l=[];try{let d;d=tV(s)?(a=await tX(e,t)).path:(n=await tL(e,s,{usage:"diff screenshot current",field:"current"})).path,r=t.out?await tB(e,t.out,{field:"diffPath",ext:".png"}):void 0;let u=await tO(o.path,d,{threshold:i,outputPath:r?.path,maxPixels:e.policy.maxImagePixels});tV(s)&&(u=await tY(e,t,r?.path,u,l));let c=u.diffPath?await r?.publish():void 0;return c&&l.push(c),u.diffPath||await r?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await r?.cleanup?.(),e}finally{await o.cleanup?.(),await n?.cleanup?.(),await a?.cleanup?.()}};async function tX(e,t){let n=await tq(e,{prefix:"agent-device-diff-current",ext:".png"});try{await tF(e,t,n.path,tK(t))}catch(e){throw await n.cleanup(),e}return n}async function tY(e,t,n,a,r){var i,s,o,l;if(!t.overlayRefs)return a;if(a.match||a.dimensionMismatch)return n&&await tH(n),a;let d=(i=t,s=n,i.currentOverlayOut?i.currentOverlayOut:i.out?.kind==="path"?{kind:"path",path:tj(s??i.out.path)}:i.out?.kind==="downloadableArtifact"?{kind:"downloadableArtifact",...i.out.clientPath?{clientPath:tj(i.out.clientPath)}:{},...i.out.fileName?{fileName:tj(i.out.fileName)}:{}}:void 0),u=await tB(e,d,{field:"currentOverlayPath",ext:".png"});try{let n=await tF(e,t,u.path,{overlayRefs:!0,...tK(t)}),i=await u.publish();return i&&r.push(i),{...a,currentOverlayPath:n.path??u.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...a.regions&&n.overlayRefs?{regions:(o=a.regions,l=n.overlayRefs,o.map(e=>{var t,n;let a,r=(t=e,n=l,a=tU(t.rect),n.map(e=>{let n=e.overlayRect,r=$(t.rect,n);return r<=0?null:{ref:e.ref,...e.label?{label:e.label}:{},rect:n,overlayCoveragePercentage:t$(r/tU(n)),regionCoveragePercentage:t$(r/a)}}).filter(e=>null!==e).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return 0!==n?n:t.overlayCoveragePercentage-e.overlayCoveragePercentage}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage})));return r.length>0?{...e,currentOverlayMatches:r}:e}))}:{}}}catch(e){throw await u.cleanup?.(),e}}async function tF(e,t,n,a={}){if(!e.backend.captureScreenshot)throw new D("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},n,a)??{}}function tK(e){return e.surface?{surface:e.surface}:{}}function tj(e){let t=n.extname(e),a=t?e.slice(0,-t.length):e;return`${a}.current-overlay${t||".png"}`}async function tH(e){try{await t.unlink(tj(e))}catch(e){var n;if(!("object"==typeof(n=e)&&null!==n&&"code"in n&&"ENOENT"===n.code))throw e}}function tV(e){return"live"===e.kind}async function tz(e,n){if(!Number.isInteger(n)||n<1)throw new D("INVALID_ARGS","Screenshot max size must be a positive integer");let a=await e5(await t.readFile(e),"screenshot"),r=Math.max(a.width,a.height);if(r<=n)return;let i=n/r,s=Math.max(1,Math.round(a.width*i)),o=Math.max(1,Math.round(a.height*i)),l=function(e,t,n){let a=new E({width:t,height:n});for(let r=0;r<n;r+=1){let i=r*e.height/n,s=(r+1)*e.height/n;for(let n=0;n<t;n+=1){let o=n*e.width/t,l=(n+1)*e.width/t,d=0,u=0,c=0,p=0,h=0;for(let t=Math.floor(i);t<Math.ceil(s);t+=1){let n=Math.min(t+1,s)-Math.max(t,i);for(let a=Math.floor(o);a<Math.ceil(l);a+=1){let r=n*(Math.min(a+1,l)-Math.max(a,o)),i=(t*e.width+a)*4;d+=(e.data[i]??0)*r,u+=(e.data[i+1]??0)*r,c+=(e.data[i+2]??0)*r,p+=(e.data[i+3]??0)*r,h+=r}}let f=(r*a.width+n)*4;a.data[f]=Math.round(d/h),a.data[f+1]=Math.round(u/h),a.data[f+2]=Math.round(c/h),a.data[f+3]=Math.round(p/h)}}return a}(a,s,o);await t.writeFile(e,await e8(l))}let tW=async(e,t)=>{let n;if(!e.backend.captureScreenshot)throw new D("UNSUPPORTED_OPERATION","screenshot is not supported by this backend");let a=await tB(e,t.out,{field:"path",ext:".png"});try{await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},a.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,stabilize:t.stabilize,surface:t.surface}),void 0!==t.maxSize&&await tz(a.path,t.maxSize),n=await a.publish()}catch(e){throw await a.cleanup?.(),e}return{path:a.path,...n?{artifacts:[n]}:{},...w(`Saved screenshot: ${a.path}`)}};function tJ(e,t){let n=j(e.type??"Element"),a=H(e,n),r=!1===e.enabled?"disabled":"enabled",i=!0===e.selected?"selected":"unselected",s=!0===e.hittable?"hittable":"not-hittable";return[String(t??e.depth??0),n,a,r,i,s].join("|")}function tZ(e,t){return t.flatten?e.map(e=>({text:K(e,0,!1),comparable:tJ(e,0)})):V(e).map(e=>({text:e.text,comparable:tJ(e.node,e.depth)}))}function tQ(e,t){return e.get(t)??0}function t0(e){return e.map(e=>({index:e.index,depth:e.depth,parentIndex:e.parentIndex,type:e.type,role:e.role,subrole:e.subrole,label:e.label,value:e.value,identifier:e.identifier,enabled:e.enabled,selected:e.selected,focused:e.focused,hittable:e.hittable,rect:e.rect,bundleId:e.bundleId,appName:e.appName,windowTitle:e.windowTitle,surface:e.surface,hiddenContentAbove:e.hiddenContentAbove,hiddenContentBelow:e.hiddenContentBelow,interactionBlocked:e.interactionBlocked,presentationHints:e.presentationHints}))}let t1=async(e,t)=>{var n;let a,r,i=await t4(e,t),s=function(e){var t,n,a,r,i;let{previous:s,current:o,options:l,identity:d}=e;if(!0===l.forceFull||!0===l.raw||!s||!1===s.comparisonSafe||!1===o.comparisonSafe||(t=s,n=o,a=d,t.backend&&n.backend&&t.backend!==n.backend||a?.previousAppBundleId&&a.currentAppBundleId&&a.previousAppBundleId!==a.currentAppBundleId)||!s.presentationKey||s.presentationKey!==o.presentationKey||(r=s,i=o,r.truncated!==i.truncated||JSON.stringify(t0(r.nodes))!==JSON.stringify(t0(i.nodes))))return;let u=l.scope?.trim();return{ageMs:Math.max(0,o.createdAt-s.createdAt),nodeCount:o.nodes.length,...!0===l.interactiveOnly?{interactiveOnly:!0}:{},...u?{scope:u}:{}}}({previous:i.session?.snapshot,current:i.snapshot,options:t,identity:{previousAppBundleId:i.session?.appBundleId,currentAppBundleId:i.result.appBundleId??i.session?.appBundleId}});return await e.sessions.set(t3(t.session,i)),{nodes:i.snapshot.nodes,truncated:i.snapshot.truncated??!1,visibility:function(e){let{nodes:t,backend:n,snapshotRaw:a}=e;if(a||!Z(n))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let r=o(t),i=new Set;return r.hiddenCount>0&&i.add("offscreen-nodes"),r.nodes.some(e=>e.hiddenContentAbove)&&i.add("scroll-hidden-above"),r.nodes.some(e=>e.hiddenContentBelow)&&i.add("scroll-hidden-below"),{partial:i.size>0,visibleNodeCount:r.nodes.length,totalNodeCount:t.length,reasons:[...i]}}({nodes:i.snapshot.nodes,backend:i.snapshot.backend,snapshotRaw:t.raw}),...p({...i.annotations,warnings:i.warnings}),...s?{unchanged:s}:{},...i.result.snapshotDiagnostics?{snapshotDiagnostics:i.result.snapshotDiagnostics}:{},...(a=(n=i).result.appName??n.session?.appName,r=n.result.appBundleId??n.session?.appBundleId,{...a||r?{appName:a??r}:{},...r?{appBundleId:r}:{}})}},t2=async(e,t)=>{let n=await t4(e,t),a=!0===t.interactiveOnly,r=n.session?.snapshot,i=t3(t.session,n);if(!r){let t=function(e,t={}){return tZ(e,t).length}(n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let s=function(e,t,n={}){let a=function(e,t){let n=e.length,a=t.length,r=n+a,i=new Map,s=[];i.set(1,0);for(let o=0;o<=r;o+=1){s.push(new Map(i));for(let r=-o;r<=o;r+=2){let l=r===-o||r!==o&&tQ(i,r-1)<tQ(i,r+1)?tQ(i,r+1):tQ(i,r-1)+1,d=l-r;for(;l<n&&d<a&&e[l].comparable===t[d].comparable;)l+=1,d+=1;if(i.set(r,l),l>=n&&d>=a)return function(e,t,n,a,r){let i=[],s=a,o=r;for(let a=e.length-1;a>=0;a-=1){let r=e[a],l=s-o,d=l===-a||l!==a&&tQ(r,l-1)<tQ(r,l+1)?l+1:l-1,u=tQ(r,d),c=u-d;for(;s>u&&o>c;)i.push({kind:"unchanged",text:n[o-1].text}),s-=1,o-=1;if(0===a)break;s===u?(i.push({kind:"added",text:n[c].text}),o=c):(i.push({kind:"removed",text:t[u].text}),s=u)}return i.reverse(),i}(s,e,t,n,a)}}return[]}(tZ(e,n),tZ(t,n)),r={additions:0,removals:0,unchanged:0};for(let e of a)"added"===e.kind&&(r.additions+=1),"removed"===e.kind&&(r.removals+=1),"unchanged"===e.kind&&(r.unchanged+=1);return{summary:r,lines:a}}(r.nodes,n.snapshot.nodes,{flatten:a});return await e.sessions.set(i),{mode:"snapshot",baselineInitialized:!1,summary:s.summary,lines:s.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function t4(e,t){var n,a,r,i,s,o,l;let u,c,p,h,f;if(!e.backend.captureSnapshot)throw new D("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let m=t.session??"default",w=await e.sessions.get(m),g=await e.backend.captureSnapshot({session:m,requestId:t.requestId,appId:w?.appId,appBundleId:w?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,depth:t.depth,scope:t.scope,raw:t.raw}),b=(a=g,r=e,n=a.snapshot?a.snapshot:{nodes:a.nodes??[],truncated:a.truncated,backend:a.backend,createdAt:d(r)},n.presentationKey?n:{...n,presentationKey:J(t)}),y=A(g),k=d(e);return{snapshot:b,result:g,session:w,annotations:y,warnings:(u=[...(i={result:g,annotations:y,snapshot:b,options:t,session:w,capturedAt:b.createdAt??k,runtimeNow:k}).annotations.warnings??[]],i.annotations.quality&&u.push(...P(i.annotations.quality,i.snapshot.nodes)),u.push(...function(e){let t=e.annotations.analysis;if("android"!==e.snapshot.backend||!0!==e.options.interactiveOnly||e.snapshot.nodes.length>0||!t||(t.rawNodeCount??0)<12)return[];let n=[`Interactive snapshot is empty after filtering ${t.rawNodeCount} raw Android nodes. Likely causes: the app content is not accessibility-visible yet, a transient route change, or depth/filter options hid the target.`];return"number"==typeof e.options.depth&&"number"==typeof t.maxDepth&&t.maxDepth>=e.options.depth+2&&n.push(`Interactive output is empty at depth ${e.options.depth}; retry without -d.`),n}(i)),i.annotations.quality||(u.push(...function(e){if("xctest"!==e.snapshot.backend||!0!==e.options.interactiveOnly||1!==e.snapshot.nodes.length)return[];let t=e.snapshot.nodes[0];return t?.type!=="Application"?[]:["iOS interactive snapshot exposed only the application root. XCTest accessibility queries can fail to enumerate some simulator UI trees even when screenshots and direct gestures still work. Use screenshot as visual truth, try a scoped/full snapshot for diagnostics, and prefer direct selectors when known."]}(i)),u.push(...(c=new Set((s=i.snapshot.nodes).map(e=>e.parentIndex).filter(e=>void 0!==e)),s.filter(e=>!(c.has(e.index)||(e.type?.toLowerCase()??"").includes("text"))&&(e.label??"").split(", ").length>10).map(e=>{let t=(e.label??"").split(", ").length,n=e.identifier?` (${e.identifier})`:"";return`@${e.ref} [${e.type??"element"}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})))),(p=function(e){if(e?.backend!=="uiautomator-dump")return;let t=e.fallbackReason?` Reason: ${e.fallbackReason}`:"";return`Android snapshot helper unavailable; using stock UIAutomator dump, which can time out on busy React Native UIs.${t}`}(i.annotations.androidSnapshot))&&u.push(p),(h=S(i.snapshot.nodes))&&u.push(h),(f=function(e){var t,n,a,r,i,s;let o=e.session?.snapshot;if(!e.annotations.freshness&&o&&(t=o,n=e.snapshot,void 0===t.presentationKey||void 0===n.presentationKey||t.presentationKey===n.presentationKey)&&(a=o,r=e.capturedAt,[r,e.runtimeNow].some(e=>{let t=e-a.createdAt;return t>=0&&t<=2e3}))&&(i=o.nodes.length,s=e.snapshot.nodes.length,!(i<12)&&s<=Math.floor(.2*i)))return t5}(i))&&u.push(f),u.push(...(o=i.annotations.freshness,l=i.snapshot.backend,o?.staleAfterRetries&&"android"===l?"stuck-route"===o.reason?[`Recent ${o.action} was followed by a nearly identical snapshot after ${o.retryCount} automatic retr${1===o.retryCount?"y":"ies"}. If you expected navigation or submit, the tree may still be stale. Use screenshot as visual truth, wait briefly, then re-snapshot once.`]:"sharp-drop"===o.reason?[t5]:[]:[])),Array.from(new Set(u)))}}function t3(e,t){let n=t.session?.name??e??"default";return{...t.session??{name:n},name:n,snapshot:t.snapshot,appName:t.result.appName??t.session?.appName,appBundleId:t.result.appBundleId??t.session?.appBundleId}}let t5="Recent snapshots dropped sharply in node count, which suggests stale or mid-transition UI. Use screenshot as visual truth, wait briefly, then re-snapshot once.",t8=async(e,t)=>await ne(e,t,"press"),t6=async(e,t)=>await ne(e,t,"click"),t7=async(e,t)=>{var n;if(!t.text)throw new D("INVALID_ARGS","fill requires text");let a=await v(e,t,{action:"fill",requireInteractive:!0,promoteToHittableAncestor:!1});if(!e.backend.fill)throw new D("UNSUPPORTED_OPERATION","fill is not supported by this backend");let r=b(await e.backend.fill(x(e,t),a.point,t.text,{delayMs:t.delayMs})),i="node"in a?a.node.type??"":"",s=i&&!eh(i,e.backend.platform)?`fill target ${n=a,n.target?.kind==="ref"?n.target.ref:n.target?.kind==="selector"?n.target.selector:"point"} resolved to "${i}", attempting fill anyway.`:void 0;return{...a,text:t.text,...s?{warning:s}:{},...r?{backendResult:r}:{}}},t9=async(e,t)=>{let n=t.text;if(!n)throw new D("INVALID_ARGS","type requires text");let a=eY(n);if(a)throw new D("INVALID_ARGS",`type does not accept a target ref like "${a}"`,{hint:`Use fill ${a} "text" to target that field, or press ${a} then type "text" to append.`});if(!e.backend.typeText)throw new D("UNSUPPORTED_OPERATION","type is not supported by this backend");let r=M(t.delayMs??0,"delay-ms",0,1e4),i=b(await e.backend.typeText(x(e,t),n,{delayMs:r}));return{kind:"text",text:n,delayMs:r,...i?{backendResult:i}:{},...w(`Typed ${Array.from(n).length} chars`)}};async function ne(e,t,n){let a=await v(e,t,{action:n,requireInteractive:!0,promoteToHittableAncestor:!0});if(!e.backend.tap)throw new D("UNSUPPORTED_OPERATION","tap is not supported by this backend");let r=b(await e.backend.tap(x(e,t),a.point,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap}));return{...a,...r?{backendResult:r}:{}}}function nt(e){return["visible","hidden","exists","editable","selected","text"].includes(e)}function nn(e){let{predicate:t,node:n,nodes:a,expectedText:r,platform:i}=e,s=Q(n),o=er(n,i),l=!0===n.selected,d="text"===t?en(n):function(e,t,n){var a,r,i;let s;if("android"===n&&!1===e.visibleToUser)return!1;if(na(e.rect))return function(e,t){return u(e,t)}(e,t);if(e.rect)return!1;if("android"!==n&&!0===e.hittable)return!0;let o=(a=e,r=t,i=n,s=ea(r),ee(r,a,s,e=>!function(e,t){if("android"===t&&!1===e.visibleToUser)return!1;let n=ep(e.type??"");return!(n.includes("application")||n.includes("window")||n.includes("scrollview")||n.includes("tableview")||n.includes("collectionview"))&&"table"!==n&&"list"!==n&&"listview"!==n&&("android"===t?!0===e.hittable&&na(e.rect):!0===e.hittable||na(e.rect))}(e,i)?null:e));return!!o&&(na(o.rect)?function(e,t){return u(e,t)}(o,t):"android"!==n&&!0===o.hittable)}(n,a,i),c=!1;switch(t){case"visible":c=d;break;case"hidden":c=!d;break;case"editable":c=o;break;case"selected":c=l;break;case"text":c=s===(r??"")}let p="text"===t?`expected="${r??""}" actual="${s}"`:`actual=${JSON.stringify({visible:d,editable:o,selected:l})}`;return{pass:c,actualText:s,details:p}}function na(e){return!!(e&&Number.isFinite(e.x)&&Number.isFinite(e.y)&&Number.isFinite(e.width)&&Number.isFinite(e.height)&&e.width>0&&e.height>0)}async function nr(e,t){let n=t??"default",a=await e.sessions.get(n);if(!a)throw new D("SESSION_NOT_FOUND","No active session. Run open first.");if(!a.snapshot)throw new D("INVALID_ARGS","No snapshot in session. Run snapshot first.");return{sessionName:n,session:a,snapshot:a.snapshot}}async function ni(e,t,n={updateSession:!0}){let a=e.backend.captureSnapshot;if(!a)throw new D("UNSUPPORTED_OPERATION","snapshot is not supported by this backend");let r=t.session??"default",i=await e.sessions.get(r),s=await a(x(e,t),{interactiveOnly:!1,depth:t.depth,scope:n.scope??t.scope,raw:t.raw}),o=s.snapshot??{nodes:s.nodes??[],truncated:s.truncated,backend:s.backend,...s.quality?{snapshotQuality:s.quality}:{},createdAt:d(e)};return n.updateSession&&i&&!l(o.snapshotQuality)&&await e.sessions.set({...i,snapshot:o}),{sessionName:r,session:i,snapshot:o}}async function ns(e,t,n){if(e.backend.readText){let a=await e.backend.readText(x(e,{session:t.sessionName}),n);if(a.text.trim())return a.text}return eu(n)}let no=async(e,t)=>{let n=t.locator??"any";if(!t.query)throw new D("INVALID_ARGS","find requires a value");if("wait"===t.action)return await nw(e,t,n);let{capture:a,match:r}=await ng(e,t,n);if(!r)throw new D("COMMAND_FAILED","find did not match any element");if("exists"===t.action)return{kind:"found",found:!0};let i=`@${r.ref}`;return"get_attrs"===t.action?{kind:"attrs",ref:i,node:r}:{kind:"text",ref:i,text:await ns(e,a,r),node:r}},nl=async(e,t)=>{if("ref"===t.target.kind){let n=await nr(e,t.session),a=function(e,t,n){let a=z(t);if(!a)throw new D("INVALID_ARGS",n.invalidRefMessage);let r=W(e,a)??(n.fallbackLabel.length>0?el(e,n.fallbackLabel):null);if(!r)throw new D("COMMAND_FAILED",n.notFoundMessage);return{ref:a,node:r}}(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??"",invalidRefMessage:"get text requires a ref like @e2",notFoundMessage:`Ref ${t.target.ref} not found`}),r=es(a.node,e.backend.platform,{action:"get"}),i={kind:"ref",ref:`@${a.ref}`};return"attrs"===t.property?{kind:"attrs",target:i,node:a.node,selectorChain:r}:{kind:"text",target:i,text:await ns(e,n,a.node),node:a.node,selectorChain:r}}let n=await nv(e,t,t.session??"default",{selector:t.target.selector,disambiguateAmbiguous:"text"===t.property}),a=es(n.node,e.backend.platform,{action:"get"});if("attrs"===t.property)return{kind:"attrs",target:{kind:"selector",selector:n.selector},node:n.node,selectorChain:a};let r=await ns(e,n.capture,n.node);return{kind:"text",target:{kind:"selector",selector:n.selector},text:r,node:n.node,selectorChain:a}},nd=async(e,t)=>{let n=await nl(e,{...t,property:"text",target:t.target});if("text"!==n.kind)throw new D("COMMAND_FAILED","getText returned non-text result");return n},nu=async(e,t)=>{let n=await nl(e,{...t,property:"attrs",target:t.target});if("attrs"!==n.kind)throw new D("COMMAND_FAILED","getAttrs returned non-attrs result");return n},nc=async(e,t)=>{if(!nt(t.predicate))throw new D("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");if("text"===t.predicate&&!t.expectedText)throw new D("INVALID_ARGS","is text requires expected text value");let n=await ni(e,t,{updateSession:!0}),a=et(t.selector);if("exists"===t.predicate){let r=ei(n.snapshot.nodes,a,{platform:e.backend.platform});if(!r)throw new D("COMMAND_FAILED",ec(a,[],{unique:!1}));return{predicate:t.predicate,pass:!0,selector:r.selector.raw,matches:r.matches,selectorChain:a.selectors.map(e=>e.raw)}}let r=eo(n.snapshot.nodes,a,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:!1});if(!r)throw new D("COMMAND_FAILED",ec(a,[],{unique:!0}),{command:"is",reason:"selector_not_found",predicate:t.predicate,selector:a.raw});let i=nn({predicate:t.predicate,node:r.node,nodes:n.snapshot.nodes,expectedText:t.expectedText,platform:e.backend.platform});if(!i.pass)throw new D("COMMAND_FAILED",`is ${t.predicate} failed for selector ${r.selector.raw}: ${i.details}`,{command:"is",reason:"predicate_failed",predicate:t.predicate,selector:r.selector.raw,predicateDetails:i.details});return{predicate:t.predicate,pass:!0,selector:r.selector.raw,..."text"===t.predicate?{text:i.actualText}:{},selectorChain:a.selectors.map(e=>e.raw)}},np=async(e,t)=>await nc(e,{...t,predicate:"visible",selector:t.target.selector}),nh=async(e,t)=>await nc(e,{...t,predicate:"hidden",selector:t.target.selector}),nf=async(e,t)=>{if("sleep"===t.target.kind)return await c(e,t.target.durationMs),{kind:"sleep",waitedMs:t.target.durationMs};if("ref"===t.target.kind){let n=await nr(e,t.session),a=z(t.target.ref);if(!a)throw new D("INVALID_ARGS",`Invalid ref: ${t.target.ref}`);let r=W(n.snapshot.nodes,a),i=r?ed(r,n.snapshot.nodes):void 0;if(!i)throw new D("COMMAND_FAILED",`Ref ${t.target.ref} not found or has no label`);return await ny(e,t,i,t.target.timeoutMs)}if("selector"===t.target.kind)return await nb(e,t,t.target.selector,t.target.timeoutMs);if(!t.target.text)throw new D("INVALID_ARGS","wait requires text");return await ny(e,t,t.target.text,t.target.timeoutMs)},nm=async(e,t)=>{let n=await nf(e,{...t,target:{kind:"text",text:t.text,timeoutMs:t.timeoutMs}});if("text"!==n.kind)throw new D("COMMAND_FAILED","waitForText returned non-text result");return n};async function nw(e,t,n){let a=t.timeoutMs??1e4,r=d(e);for(;d(e)-r<a;){let{match:a}=await ng(e,t,n);if(a)return{kind:"found",found:!0,waitedMs:d(e)-r};await c(e,300)}throw new D("COMMAND_FAILED","find wait timed out")}async function ng(e,t,n){let a=await ni(e,t,{updateSession:!0,scope:"text"===n||"label"===n||"any"===n?t.query:void 0});if(l(a.snapshot.snapshotQuality))throw new D("COMMAND_FAILED","find could not read the current accessibility tree",{reason:a.snapshot.snapshotQuality.reason,hint:"The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen."});let r=ef(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0];return{capture:a,match:r}}async function nb(e,t,n,a){let r=a??1e4,i=d(e),s=et(n);for(;d(e)-i<r;){let n=ei((await ni(e,t,{updateSession:!0})).snapshot.nodes,s,{platform:e.backend.platform});if(n)return{kind:"selector",selector:n.selector.raw,waitedMs:d(e)-i};await c(e,300)}throw new D("COMMAND_FAILED",`wait timed out for selector: ${n}`)}async function ny(e,t,n,a){let r=a??1e4,i=d(e);for(;d(e)-i<r;){if(e.backend.findText?(await e.backend.findText(x(e,t),n)).found:await nk(e,t,n))return{kind:"text",text:n,waitedMs:d(e)-i};await c(e,300)}throw new D("COMMAND_FAILED",`wait timed out for text: ${n}`)}async function nk(e,t,n){return!!el((await ni(e,t,{updateSession:!0})).snapshot.nodes,n)}async function nv(e,t,n,a){let r=await ni(e,{...t,session:n},{updateSession:!0}),i=et(a.selector),s=eo(r.snapshot.nodes,i,{platform:e.backend.platform,requireRect:!1,requireUnique:!0,disambiguateAmbiguous:a.disambiguateAmbiguous});if(!s)throw new D("COMMAND_FAILED",ec(i,[],{unique:!0}));return{capture:r,node:s.node,selector:s.selector.raw,ref:`@${s.node.ref}`}}function nx(e,t){if(void 0!==e)return nA(e,t)}function nA(e,t){let n=e?.trim();if(!n)throw new D("INVALID_ARGS",`${t} must be a non-empty string`);return n}let nM=async(e,t={})=>{if(!e.backend.listDevices)throw new D("UNSUPPORTED_OPERATION","admin.devices is not supported by this backend");return{kind:"adminDevices",devices:await e.backend.listDevices(x(e,t),t.filter)}},nS=async(e,t={})=>{if(!e.backend.bootDevice)throw new D("UNSUPPORTED_OPERATION","admin.boot is not supported by this backend");let n=nT(t.target),a=b(await e.backend.bootDevice(x(e,t),n));return{kind:"deviceBooted",...n?{target:n}:{},...a?{backendResult:a}:{},...w("Booted device")}},nI=async(e,t={})=>{if(!e.backend.shutdownDevice)throw new D("UNSUPPORTED_OPERATION","admin.shutdown is not supported by this backend");let n=nT(t.target),a=b(await e.backend.shutdownDevice(x(e,t),n));return{kind:"deviceShutdown",...n?{target:n}:{},...a?{backendResult:a}:{},...w("Shutdown device")}},nP=async(e,t)=>await n_(e,t,"install"),nR=async(e,t)=>await n_(e,t,"reinstall"),nN=async(e,t)=>await n_(e,t,"installFromSource");async function n_(e,t,n){let a="reinstall"===n?"reinstallApp":"installApp",r=e.backend[a];if(!r)throw new D("UNSUPPORTED_OPERATION",`admin.${n} is not supported by this backend`);let i="app"in t&&void 0!==t.app?nA(t.app,"app"):void 0;if("installFromSource"!==n&&!i)throw new D("INVALID_ARGS",`admin.${n} requires app`);let s=x(e,t),o=await nD(e,s,t.source);try{var l,d,u,c,p;let t,a,h,f,m,g,y,k,v=await r.call(e.backend,s,{...i?{app:i}:{},source:o.source});return l=n,d=i,u=o.source,c=v,t=b(c),a=nC(c,"appName"),h=nC(c,"appId"),f=nC(c,"bundleId"),m=nC(c,"packageName"),g=nC(c,"launchTarget"),y=nC(c,"installablePath"),k=nC(c,"archivePath"),{kind:"reinstall"===l?"appReinstalled":"installFromSource"===l?"appInstalledFromSource":"appInstalled",...d?{app:d}:{},source:u,...h?{appId:h}:{},...a?{appName:a}:{},...f?{bundleId:f}:{},...m?{packageName:m}:{},...g?{launchTarget:g}:{},...y?{installablePath:y}:{},...k?{archivePath:k}:{},...t?{backendResult:t}:{},...w(`${"reinstall"===l?"Reinstalled":"Installed"}: ${a??g??d??(p=u,"path"===p.kind?p.path:"uploadedArtifact"===p.kind?p.id:p.url)}`)}}finally{await o.cleanup?.()}}async function nD(e,t,n){let a=nE(n),r=await nO(e,a);try{let n=e.backend.resolveInstallSource?await e.backend.resolveInstallSource(t,r.source):r.source;return{source:nE(n),...r.cleanup?{cleanup:r.cleanup}:{}}}catch(e){if(r.cleanup)try{await r.cleanup()}catch{}throw e}}async function nO(e,t){if("url"===t.kind)return{source:t};let n=await tL(e,t,{usage:"admin.install",field:"source"});return{source:{kind:"path",path:n.path},...n.cleanup?{cleanup:n.cleanup}:{}}}function nE(e){if(!e||"object"!=typeof e)throw new D("INVALID_ARGS","install source is required");if("path"===e.kind)return{kind:"path",path:nA(e.path,"source.path")};if("uploadedArtifact"===e.kind)return{kind:"uploadedArtifact",id:nA(e.id,"source.id")};if("url"===e.kind){let t=nA(e.url,"source.url");return function(e){let t;try{t=new URL(e)}catch{throw new D("INVALID_ARGS",`Invalid install source URL: ${e}`)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new D("INVALID_ARGS","Install source URL must use http or https")}(t),{kind:"url",url:t}}throw new D("INVALID_ARGS","install source kind must be path, uploadedArtifact, or url")}function nT(e){if(!e)return;let t=nx(e.id,"target.id"),n=nx(e.name,"target.name"),a={...t?{id:t}:{},...n?{name:n}:{},...e.platform?{platform:e.platform}:{},...e.target?{target:e.target}:{},...void 0!==e.headless?{headless:e.headless}:{}};return Object.keys(a).length>0?a:void 0}function nC(e,t){let n=e[t];return"string"==typeof n&&n.length>0?n:void 0}let nU=/^[A-Za-z0-9_.:-]{1,64}$/,n$=async(e,t)=>{var n;if(!e.backend.openApp)throw new D("UNSUPPORTED_OPERATION","apps.open is not supported by this backend");let a=function(e){var t;let n=nx(e.app,"app"),a=nx(e.appId,"appId"),r=nx(e.bundleId,"bundleId"),i=nx(e.packageName,"packageName"),s=nx(e.url,"url"),o=nx(e.activity,"activity"),l={...n?{app:n}:{},...a?{appId:a}:{},...r?{bundleId:r}:{},...i?{packageName:i}:{},...s?{url:s}:{},...o?{activity:o}:{}};if(!((t=l).app??t.appId??t.bundleId??t.packageName??t.url??t.activity))throw new D("INVALID_ARGS","apps.open requires app, appId, bundleId, packageName, url, or activity");return l}(t),r=b(await e.backend.openApp(nK(e,t),a,{launchArgs:t.launchArgs,relaunch:t.relaunch}));return{kind:"appOpened",target:a,relaunch:!0===t.relaunch,...r?{backendResult:r}:{},...w(`Opened: ${(n=a).app??n.appId??n.bundleId??n.packageName??n.url??n.activity??"app"}`)}},nL=async(e,t={})=>{if(!e.backend.closeApp)throw new D("UNSUPPORTED_OPERATION","apps.close is not supported by this backend");let n=nx(t.app,"app"),a=b(await e.backend.closeApp(nK(e,t),n));return{kind:"appClosed",...n?{app:n}:{},...a?{backendResult:a}:{},...w(n?`Closed: ${n}`:"Closed app")}},nB=async(e,t={})=>{if(!e.backend.listApps)throw new D("UNSUPPORTED_OPERATION","apps.list is not supported by this backend");return{kind:"appsList",apps:await e.backend.listApps(nK(e,t),ey(t.filter))}},nq=async(e,t)=>{if(!e.backend.getAppState)throw new D("UNSUPPORTED_OPERATION","apps.state is not supported by this backend");let n=nA(t.app,"app"),a=await e.backend.getAppState(nK(e,t),n);return{kind:"appState",app:n,state:a}},nG=async(e,t)=>{if(!e.backend.pushFile)throw new D("UNSUPPORTED_OPERATION","apps.push is not supported by this backend");let n=nA(t.app,"app"),a=await nY(e,t.input);try{let r=await e.backend.pushFile(nK(e,t),a.backendInput,n),i=b(r);return{kind:"appPushed",app:n,inputKind:a.inputKind,...i?{backendResult:i}:{},...w(`Pushed to ${n}`)}}finally{await a.cleanup?.()}},nX=async(e,t)=>{var n,a;if(!e.backend.triggerAppEvent)throw new D("UNSUPPORTED_OPERATION","apps.triggerEvent is not supported by this backend");let r=function(e){let t=nA(e,"name");if(!nU.test(t))throw new D("INVALID_ARGS",`Invalid apps.triggerEvent name: ${t}`,{hint:"Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash."});return t}(t.name);n=t.payload,a=`apps.triggerEvent payload for "${r}"`,void 0!==n&&nF(n,a,8192);let i=b(await e.backend.triggerAppEvent(nK(e,t),{name:r,...t.payload?{payload:t.payload}:{}}));return{kind:"appEventTriggered",name:r,...t.payload?{payload:t.payload}:{},...i?{backendResult:i}:{},...w(`Triggered app event: ${r}`)}};async function nY(e,t){if(!t||"object"!=typeof t)throw new D("INVALID_ARGS","apps.push requires an input");if("json"===t.kind)return nF(t.payload,"apps.push JSON payload",8192),{backendInput:{kind:"json",payload:t.payload},inputKind:"json"};let n=await tL(e,t,{usage:"apps.push",field:"input"});return{backendInput:{kind:"file",path:n.path},inputKind:"file",...n.cleanup?{cleanup:n.cleanup}:{}}}function nF(e,t,n){if(function(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new D("INVALID_ARGS",`${t} must be a JSON object`)}(e,t),Buffer.byteLength(function(e,t){try{let n=JSON.stringify(e);if("string"!=typeof n)throw new D("INVALID_ARGS",`${t} must be JSON-serializable`);return n}catch{throw new D("INVALID_ARGS",`${t} must be JSON-serializable`)}}(e,t),"utf8")>n)throw new D("INVALID_ARGS",`${t} exceeds ${n} bytes`)}function nK(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}let nj=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i,nH=/\b[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\b/g;function nV(e){var t,n;let a=!1,r=e;return{value:(t=r=(r=(r=(r=(r=r.replaceAll(/(authorization|token|secret|password|passwd|api[-_]?key)=([^&\s]+)/gi,(e,t)=>(a=!0,`${String(t)}=[REDACTED]`))).replaceAll(/("(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)"\s*:\s*")([^"]*)(")/gi,(e,t,n,r)=>(a=!0,`${String(t)}[REDACTED]${String(r)}`))).replaceAll(/\b(Bearer\s+)([^\s",;]+)/gi,(e,t)=>(a=!0,`${String(t)}[REDACTED]`))).replaceAll(/((?:authorization|cookie|token|secret|password|passwd|api[-_]?key)\s*[:=]\s*)([^\s,;&]+)/gi,(e,t)=>(a=!0,`${String(t)}[REDACTED]`))).replaceAll(nH,()=>(a=!0,"[REDACTED]")),n=()=>{a=!0},r=/(https?:\/\/|token|secret|password|authorization|cookie|api[-_]?key)/i.test(t)?t.replaceAll(/https?:\/\/[^\s"'<>)]+/gi,e=>{let t=nz(e);return t?(t.redacted&&n(),t.value):e}):t),redacted:a}}function nz(e){try{let t=new URL(e),n=function(e){let t=!1;for(let n of Array.from(e.searchParams.keys()))nj.test(n)&&(e.searchParams.set(n,"[REDACTED]"),t=!0);return t}(t);return(t.username||t.password)&&(t.username="REDACTED",t.password="REDACTED",n=!0),{value:t.toString(),redacted:n}}catch{return}}let nW=/(?:authorization|cookie|token|secret|password|passwd|api[-_]?key)/i;function nJ(e){if(!e)return{redacted:!1};let t=!1,n={};for(let[a,r]of Object.entries(e))if(nW.test(a))n[a]="[REDACTED]",t=!0;else{let e=n1(r,2048);n[a]=e.value??"",t||=e.redacted}return{value:n,redacted:t}}function nZ(e){return void 0===e?{redacted:!1}:function(e){try{let t=JSON.parse(e),n=n0(t,nV);return n2(JSON.stringify(n.value),2048,n.redacted)}catch{return}}(e)??n1(e,2048)}function nQ(e){return n0(e,e=>n1(e,2048))}function n0(e,t){if(void 0===e)return{redacted:!1};if("string"==typeof e)return t(e);if(!e||"object"!=typeof e)return{value:e,redacted:!1};if(Array.isArray(e)){let n=!1;return{value:e.map(e=>{let a=n0(e,t);return n||=a.redacted,a.value}),redacted:n}}let n=!1,a={};for(let[r,i]of Object.entries(e)){if(nW.test(r)){a[r]="[REDACTED]",n=!0;continue}let e=n0(i,t);a[r]=e.value,n||=e.redacted}return{value:a,redacted:n}}function n1(e,t){if(void 0===e)return{redacted:!1};let n=nV(e);return n2(n.value,t,n.redacted)}function n2(e,t,n){if(void 0===e)return{redacted:n};let a=e;return a.length>t&&(a=`${a.slice(0,t)}...[truncated]`,n=!0),{value:a,redacted:n}}let n4=async(e,t={})=>{var n,a;let r;if(!e.backend.readLogs)throw new D("UNSUPPORTED_OPERATION","diagnostics.logs is not supported by this backend");return r=!0===(n=await e.backend.readLogs(await n8(e,t),{...n6(a=t,100,500,"logs limit"),...void 0!==a.levels?{levels:n9(a.levels,"levels")}:{},...void 0!==a.search?{search:nA(a.search,"search")}:{},...void 0!==a.source?{source:nA(a.source,"source")}:{}})).redacted,{kind:"diagnosticsLogs",entries:n.entries.map(e=>{let t=n1(e.message,4096),n=nQ(e.metadata);return r||=t.redacted||n.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.level?{level:e.level}:{},message:t.value??"",...e.source?{source:e.source}:{},...n.value?{metadata:n.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:r,...n.notes?{notes:n.notes}:{}}},n3=async(e,t={})=>{var n,a,r;let i;if(!e.backend.dumpNetwork)throw new D("UNSUPPORTED_OPERATION","diagnostics.network is not supported by this backend");let s={...n6(r=t,25,200,"network limit"),include:function(e){if(void 0===e)return"summary";if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new D("INVALID_ARGS","network include must be summary, headers, body, or all")}(r.include)};return n=await e.backend.dumpNetwork(await n8(e,t),s),a=s.include??"summary",i=!0===n.redacted,{kind:"diagnosticsNetwork",entries:n.entries.map(e=>{var t;let n=e.url?nz(t=e.url)??n1(t,2048):void 0,r="headers"===a||"all"===a?nJ(e.requestHeaders):void 0,s="headers"===a||"all"===a?nJ(e.responseHeaders):void 0,o="body"===a||"all"===a?nZ(e.requestBody):void 0,l="body"===a||"all"===a?nZ(e.responseBody):void 0,d=nQ(e.metadata);return i||=(n?.redacted??!1)||(r?.redacted??!1)||(s?.redacted??!1)||(o?.redacted??!1)||(l?.redacted??!1)||d.redacted,{...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...n?{url:n.value}:{},...void 0!==e.status?{status:e.status}:{},...void 0!==e.durationMs?{durationMs:e.durationMs}:{},...r?.value?{requestHeaders:r.value}:{},...s?.value?{responseHeaders:s.value}:{},...o?.value!==void 0?{requestBody:o.value}:{},...l?.value!==void 0?{responseBody:l.value}:{},...d.value?{metadata:d.value}:{}}}),...n.nextCursor?{nextCursor:n.nextCursor}:{},...n.timeWindow?{timeWindow:n.timeWindow}:{},...n.backend?{backend:n.backend}:{},redacted:i,...n.notes?{notes:n.notes}:{}}},n5=async(e,t={})=>{var n,a;let r;if(!e.backend.measurePerf)throw new D("UNSUPPORTED_OPERATION","diagnostics.perf is not supported by this backend");return r=!0===(n=await e.backend.measurePerf(await n8(e,t),{...n7(a=t),...void 0!==a.sampleMs?{sampleMs:M(a.sampleMs,"sampleMs",100,6e4)}:{},...void 0!==a.metrics?{metrics:n9(a.metrics,"metrics",20)}:{}})).redacted,{kind:"diagnosticsPerf",metrics:n.metrics.map(e=>{let t=n1(e.message,4096),n=nQ(e.metadata);return r||=t.redacted||n.redacted,{name:e.name,...void 0!==e.value?{value:e.value}:{},...e.unit?{unit:e.unit}:{},...e.status?{status:e.status}:{},...void 0!==t.value?{message:t.value}:{},...n.value?{metadata:n.value}:{}}}),...n.startedAt?{startedAt:n.startedAt}:{},...n.endedAt?{endedAt:n.endedAt}:{},...n.backend?{backend:n.backend}:{},redacted:r,...n.notes?{notes:n.notes}:{}}};async function n8(e,t){let n=x(e,t),a=t.session?await e.sessions.get(t.session):void 0;return{...n,...t.appId??a?.appId?{appId:t.appId??a?.appId}:{},...t.appBundleId??a?.appBundleId?{appBundleId:t.appBundleId??a?.appBundleId}:{}}}function n6(e,t,n,a){return{...n7(e),...void 0!==e.cursor?{cursor:nA(e.cursor,"cursor")}:{},limit:void 0===e.limit?t:M(e.limit,a,1,n)}}function n7(e){return{...void 0!==e.since?{since:nA(e.since,"since")}:{},...void 0!==e.until?{until:nA(e.until,"until")}:{}}}function n9(e,t,n=50){if(!Array.isArray(e))throw new D("INVALID_ARGS",`${t} must be an array of strings`);if(e.length>n)throw new D("INVALID_ARGS",`${t} must contain at most ${n} entries`);return e.map((e,n)=>nA(e,`${t}[${n}]`))}let ae=async(e,t)=>{let n=an(t.action,"record"),a="start"===n?e.backend.startRecording:e.backend.stopRecording;if(!a)throw new D("UNSUPPORTED_OPERATION",`record ${n} is not supported by this backend`);let r=t.out?await tB(e,t.out,{field:"path",ext:".mp4"}):void 0;try{var i,s,o,l,d,u,c;let p,h,f,m,w=(i=t,s=r?.path,p={},s&&(p.outPath=s),h=(o=i.fps,void 0===o?void 0:M(o,"fps",1,60)),void 0!==h&&(p.fps=h),f=(l=i.maxSize,void 0===l?void 0:M(l,"maxSize",1,Number.MAX_SAFE_INTEGER)),void 0!==f&&(p.maxSize=f),m=function(e){if(void 0===e)return;let t=k(e);if(void 0===t)throw new D("INVALID_ARGS","quality must be one of: medium, high (legacy numeric values 5-10 are accepted)");return t}(i.quality),void 0!==m&&(p.quality=m),void 0!==i.hideTouches&&(p.showTouches=!0!==i.hideTouches),p),g=await a.call(e.backend,x(e,t),w),b=await r?.publish();return d=n,u=g,c=b,{..."string"==typeof u.path?{path:u.path}:{},..."string"==typeof u.telemetryPath?{telemetryPath:u.telemetryPath}:{},..."string"==typeof u.warning?{warning:u.warning}:{},...aa(d,u,c,{startKind:"recordingStarted",stopKind:"recordingStopped",startMessage:"Recording started",stopMessage:"Recording stopped"})}}catch(e){throw await r?.cleanup?.(),e}},at=async(e,t)=>{let n=an(t.action,"trace"),a="start"===n?e.backend.startTrace:e.backend.stopTrace;if(!a)throw new D("UNSUPPORTED_OPERATION",`trace ${n} is not supported by this backend`);let r=t.out?await tB(e,t.out,{field:"outPath",ext:".trace"}):void 0;try{var i,s,o;let l={...r?.path?{outPath:r.path}:{}},d=await a.call(e.backend,x(e,t),l),u=await r?.publish();return i=n,s=d,o=u,{..."string"==typeof s.outPath?{outPath:s.outPath}:{},...aa(i,s,o,{startKind:"traceStarted",stopKind:"traceStopped",startMessage:"Trace started",stopMessage:"Trace stopped"})}}catch(e){throw await r?.cleanup?.(),e}};function an(e,t){if("start"===e||"stop"===e)return e;throw new D("INVALID_ARGS",`${t} action must be start or stop`)}function aa(e,t,n,a){return{kind:"start"===e?a.startKind:a.stopKind,action:e,...n?{artifact:n}:{},backendResult:t,...w("start"===e?a.startMessage:a.stopMessage)}}let ar=async(e,t={})=>{if(!e.backend.pressBack)throw new D("UNSUPPORTED_OPERATION","system.back is not supported by this backend");let n=t.mode??"in-app";if("in-app"!==n&&"system"!==n)throw new D("INVALID_ARGS","system.back mode must be in-app or system");let a=b(await e.backend.pressBack(x(e,t),{mode:n}));return{kind:"systemBack",mode:n,...a?{backendResult:a}:{},...w("Back")}},ai=async(e,t={})=>{if(!e.backend.pressHome)throw new D("UNSUPPORTED_OPERATION","system.home is not supported by this backend");let n=b(await e.backend.pressHome(x(e,t)));return{kind:"systemHome",...n?{backendResult:n}:{},...w("Home")}},as=async(e,t)=>{if(!e.backend.rotate)throw new D("UNSUPPORTED_OPERATION","system.rotate is not supported by this backend");let n=function(e){switch(e){case"portrait":case"portrait-upside-down":case"landscape-left":case"landscape-right":return e;default:throw new D("INVALID_ARGS","system.rotate orientation must be portrait, portrait-upside-down, landscape-left, or landscape-right")}}(t.orientation),a=b(await e.backend.rotate(x(e,t),n));return{kind:"systemRotated",orientation:n,...a?{backendResult:a}:{},...w(`Rotated to ${n}`)}},ao=async(e,t={})=>{var n,a,r,i,s,o,l;if(!e.backend.setKeyboard)throw new D("UNSUPPORTED_OPERATION","system.keyboard is not supported by this backend");let d=t.action??"status";if(!eX(d))throw new D("INVALID_ARGS","system.keyboard action must be status, get, dismiss, enter, or return");let u=await e.backend.setKeyboard(x(e,t),{action:d}),c=b(u),p=(n=u)&&"object"==typeof n?u:{};return"enter"===d||"return"===d?{kind:"keyboardEnterPressed",action:"enter",state:p,...(a=c)?{backendResult:a}:{},...w("Keyboard enter pressed")}:"dismiss"===d?(r=d,{kind:"keyboardDismissed",action:r,state:i=p,...(s=c)?{backendResult:s}:{},...w(!1===i.dismissed?"Keyboard already hidden":"Keyboard dismissed")}):(o=d,{kind:"keyboardState",action:o,state:p,...(l=c)?{backendResult:l}:{}})},al=async(e,t)=>{if("read"===t.action){if(!e.backend.getClipboard)throw new D("UNSUPPORTED_OPERATION","system.clipboard read is not supported by this backend");let n=await e.backend.getClipboard(x(e,t));return{kind:"clipboardText",action:"read",text:"string"==typeof n?n:n.text}}if("write"!==t.action)throw new D("INVALID_ARGS","system.clipboard action must be read or write");if(!e.backend.setClipboard)throw new D("UNSUPPORTED_OPERATION","system.clipboard write is not supported by this backend");if("string"!=typeof t.text)throw new D("INVALID_ARGS","system.clipboard write requires text");let n=b(await e.backend.setClipboard(x(e,t),t.text));return{kind:"clipboardUpdated",action:"write",textLength:Array.from(t.text).length,...n?{backendResult:n}:{},...w("Clipboard updated")}},ad=async(e,t={})=>{if(!e.backend.openSettings)throw new D("UNSUPPORTED_OPERATION","system.settings is not supported by this backend");let n=nx(t.target,"target"),a=b(await e.backend.openSettings(x(e,t),n));return{kind:"settingsOpened",...n?{target:n}:{},...a?{backendResult:a}:{},...w(n?`Opened settings: ${n}`:"Opened settings")}},au=async(e,t={})=>{var n,a;if(!e.backend.handleAlert)throw new D("UNSUPPORTED_OPERATION","system.alert is not supported by this backend");let r=t.action??"get";if("get"!==r&&"accept"!==r&&"dismiss"!==r&&"wait"!==r)throw new D("INVALID_ARGS","system.alert action must be get, accept, dismiss, or wait");let i=void 0===t.timeoutMs?void 0:M(t.timeoutMs,"timeoutMs",0,12e4),s=await e.backend.handleAlert(x(e,t),r,{timeoutMs:i});return n=r,a=s,"get"===n?function(e){if("alertStatus"!==e.kind)throw new D("COMMAND_FAILED","system.alert get returned an invalid backend result");return{kind:"alertStatus",action:"get",alert:e.alert}}(a):"wait"===n?function(e){if("alertWait"!==e.kind)throw new D("COMMAND_FAILED","system.alert wait returned an invalid backend result");return{kind:"alertWait",action:"wait",alert:e.alert,...void 0!==e.waitedMs?{waitedMs:e.waitedMs}:{},...void 0!==e.timedOut?{timedOut:e.timedOut}:{},...w(e.alert?"Alert visible":"Alert wait timed out")}}(a):function(e,t){if("alertHandled"!==t.kind)throw new D("COMMAND_FAILED",`system.alert ${e} returned an invalid backend result`);return{kind:"alertHandled",action:e,handled:t.handled,...t.alert?{alert:t.alert}:{},...t.button?{button:t.button}:{},...w(t.handled?`Alert ${e}ed`:"No alert handled")}}(n,a)},ac=async(e,t={})=>{if(!e.backend.openAppSwitcher)throw new D("UNSUPPORTED_OPERATION","system.appSwitcher is not supported by this backend");let n=b(await e.backend.openAppSwitcher(x(e,t)));return{kind:"appSwitcherOpened",...n?{backendResult:n}:{},...w("Opened app switcher")}};function ap(e){let t={backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??function(e=[]){let t=new Map(e.map(e=>[e.name,ah(e)]));return{get:e=>ah(t.get(e)),set:e=>{t.set(e.name,ah(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>ah(e))}}(),policy:e.policy??function(e={}){return{allowLocalInputPaths:!1,allowLocalOutputPaths:!1,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal};return{...t,capture:{screenshot:e=>tW(t,e),diffScreenshot:e=>tG(t,e),snapshot:e=>t1(t,e),diffSnapshot:e=>t2(t,e)},selectors:{find:e=>no(t,e),get:e=>nl(t,e),getText:(e,n={})=>nd(t,{...n,target:e}),getAttrs:(e,n={})=>nu(t,{...n,target:e}),is:e=>nc(t,e),isVisible:(e,n={})=>np(t,{...n,target:e}),isHidden:(e,n={})=>nh(t,{...n,target:e}),wait:e=>nf(t,e),waitForText:(e,n={})=>nm(t,{...n,text:e})},interactions:{click:(e,n={})=>t6(t,{...n,target:e}),press:(e,n={})=>t8(t,{...n,target:e}),fill:(e,n,a={})=>t7(t,{...a,target:e,text:n}),typeText:(e,n={})=>t9(t,{...n,text:e}),focus:(e,n={})=>g(t,{...n,target:e}),longPress:(e,n={})=>f(t,{...n,target:e}),swipe:e=>y(t,e),scroll:e=>h(t,e),pinch:e=>I(t,e)},system:{back:e=>ar(t,e),home:e=>ai(t,e),rotate:e=>as(t,e),keyboard:e=>ao(t,e),clipboard:e=>al(t,e),settings:e=>ad(t,e),alert:e=>au(t,e),appSwitcher:e=>ac(t,e)},apps:{open:e=>n$(t,e),close:e=>nL(t,e),list:(e={})=>nB(t,{...e,filter:eb(e.filter)}),state:e=>nq(t,e),push:e=>nG(t,e),triggerEvent:e=>nX(t,e)},admin:{devices:e=>nM(t,e),boot:e=>nS(t,e),shutdown:e=>nI(t,e),install:e=>nP(t,e),reinstall:e=>nR(t,e),installFromSource:e=>nN(t,e)},recording:{record:e=>ae(t,e),trace:e=>at(t,e)},observability:{logs:e=>n4(t,e),network:e=>n3(t,e),perf:e=>n5(t,e)}}}function ah(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:function(e){try{return structuredClone(e)}catch{return{...e}}}(e.metadata)}:{}}}function af(e={}){return{allowLocalInputPaths:!0,allowLocalOutputPaths:!0,maxImagePixels:2e7,allowNamedBackendCapabilities:[],...e}}async function am(t){let{lockDirPath:a,owner:r}=t,i=n.join(a,"owner.json"),s=Date.now()+(t.timeoutMs??3e4),o=t.pollMs??100,l=t.ownerGraceMs??5e3,d=t.description??"process lock";for(e.mkdirSync(n.dirname(a),{recursive:!0});Date.now()<s;)try{e.mkdirSync(a),function(t,n){let a=`${t}.${process.pid}.${Date.now()}.tmp`;e.writeFileSync(a,JSON.stringify(n),"utf8"),e.renameSync(a,t)}(i,r);let t=!1;return async()=>{t||(t=!0,e.rmSync(a,{recursive:!0,force:!0}))}}catch(t){if("EEXIST"!==t.code)throw t;if(function(t,n,a){let r=null;try{r=e.statSync(t)}catch{return!0}let i=aw(n);if(i){var s;return!(Number.isInteger((s=i).pid)&&!(s.pid<=0)&&em(s.pid)&&(!s.startTime||ew(s.pid)===s.startTime))&&(e.rmSync(t,{recursive:!0,force:!0}),!0)}return!(Date.now()-r.mtimeMs<a)&&(e.rmSync(t,{recursive:!0,force:!0}),!0)}(a,i,l))continue;await eg(o)}throw new D("COMMAND_FAILED",`Timed out waiting for ${d}`,{lockDirPath:a,...function(t,n){let a,r=Date.now(),i=aw(n);try{a=Math.max(0,Math.round(r-e.statSync(t).mtimeMs))}catch{}return{...void 0!==a?{lockAgeMs:a}:{},...i?{ownerPid:i.pid,ownerStartTime:i.startTime,ownerAgeMs:Math.max(0,Math.round(r-i.acquiredAtMs))}:{}}}(a,i)})}function aw(t){try{return JSON.parse(e.readFileSync(t,"utf8"))}catch{return null}}let ag="0.27.1",ab="agent-browser";async function ay(e){let t=ax(e);if(t.installed){var n=t;if(!n.installed)throw aI(n);return{command:n.binaryPath,env:aS(n,process.env)}}throw aI(t)}async function ak(t){let a=ax(t);var r,i=a.nodeMajor;if(!(i>=24))throw new D("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."});let s=await am({lockDirPath:n.join(a.installDir,"..",".agent-browser-install.lock"),owner:{pid:process.pid,startTime:ew(process.pid),acquiredAtMs:Date.now()},timeoutMs:3e5,description:"managed agent-browser setup"});try{let a=ax(t);if(a.installed)return a;return e.mkdirSync(a.installDir,{recursive:!0}),await aA(a),await aM(a,["install"],{timeoutMs:3e5}),await aM(a,["doctor","--offline","--quick"],{timeoutMs:6e4}),r=a,e.writeFileSync(n.join(r.installDir,"manifest.json"),JSON.stringify({package:ab,version:ag,node:process.version,installedAt:new Date().toISOString()},null,2),"utf8"),ax(t)}finally{await s()}}async function av(e){let t=ax(e);if(!t.installed)throw aI(t);let n=await aM(t,["doctor","--offline","--quick"],{timeoutMs:6e4,allowFailure:!0});return{status:t,...n}}function ax(t){var a,r;let o,l=t.stateDir??process.env.AGENT_DEVICE_STATE_DIR??n.join(process.env.HOME??process.cwd(),".agent-device"),d=n.join(l,"tools","agent-browser",ag),u=(a=d,o=n.join(a,"package"),n.join(o,"node_modules",".bin","win32"===process.platform?"agent-browser.cmd":"agent-browser")),c=n.join(d,"home"),p=function(e){if("win32"===process.platform)return n.join(e,"home");let t=i.createHash("sha1").update(e).digest("hex").slice(0,12);return n.join(s.tmpdir(),"agent-device-web",t)}(d),h=function(t){try{return e.accessSync(t,e.constants.X_OK),!0}catch{return!1}}(u)&&(r=d,e.existsSync(n.join(r,"manifest.json"))),f=Number.parseInt(process.versions.node.split(".")[0]??"0",10);return{version:ag,stateDir:l,installDir:d,binaryPath:u,homeDir:c,runtimeHomeDir:p,installed:h,nodeMajor:f,nodeSupported:f>=24}}async function aA(t){let a=n.join(t.installDir,"package");e.mkdirSync(a,{recursive:!0}),await F("npm",["install","--prefix",a,"--no-audit","--no-fund","--no-save",`${ab}@${ag}`],{env:process.env,timeoutMs:3e5})}async function aM(e,t,n){return await F(e.binaryPath,t,{allowFailure:n.allowFailure,env:aS(e,process.env),timeoutMs:n.timeoutMs})}function aS(t,a){return e.mkdirSync(t.homeDir,{recursive:!0}),function(t){if(t.runtimeHomeDir!==t.homeDir){e.mkdirSync(n.dirname(t.runtimeHomeDir),{recursive:!0});try{let n=e.lstatSync(t.runtimeHomeDir);if(n.isSymbolicLink()&&e.readlinkSync(t.runtimeHomeDir)===t.homeDir||n.isDirectory())return;n.isSymbolicLink()&&e.unlinkSync(t.runtimeHomeDir)}catch(e){var a;if(!("object"==typeof(a=e)&&null!==a&&"code"in a&&"ENOENT"===a.code))throw e}try{e.symlinkSync(t.homeDir,t.runtimeHomeDir,"dir")}catch{e.mkdirSync(t.runtimeHomeDir,{recursive:!0})}}}(t),{...a,HOME:t.runtimeHomeDir}}function aI(e){return new D("TOOL_MISSING","Managed web browser backend is not installed.",{version:ag,installDir:e.installDir,hint:!1===e.nodeSupported?`Web automation requires Node 24+; current Node is ${process.version}.`:"Run `agent-device web setup` to install the managed web backend."})}function aP(e){let t=N(e);return"TOOL_MISSING"!==t.code?t:new D(t.code,t.message,{...t.details??{},hint:"string"==typeof t.details?.hint?t.details.hint:"Run `agent-device web setup` to install the managed web backend."})}export{am as acquireProcessLock,eT as appendScriptSeriesFlags,ap as createAgentDevice,e5 as decodePngAsync,av as doctorManagedAgentBrowser,e8 as encodePngAsync,nn as evaluateIsPredicate,eY as findMistargetedTypeRefToken,eq as formatPortableActionLine,eE as formatScriptActionSummary,eR as formatScriptArg,eN as formatScriptStringLiteral,eS as isClickLikeCommand,eX as isKeyboardAction,nt as isSupportedPredicate,eI as isTouchTargetCommand,af as localCommandPolicy,aP as mapManagedAgentBrowserError,eB as parseReplayOpenFlags,e$ as parseReplayRuntimeFlags,eU as parseReplaySeriesFlags,e4 as prewarmPngWorker,ay as resolveAgentBrowserTool,ak as setupManagedAgentBrowser,e3 as terminatePngWorker};

package/dist/src/4291.js

@@ -0,0 +1 @@
+import"./733.js";import{PLATFORM_SELECTORS as t}from"./5910.js";function e(t){return"xctest"===t||"android"===t||"macos-helper"===t||"linux-atspi"===t||"web"===t}function n(t){return void 0===t||"xctest"===t||"android"===t}function a(t){return t.map((t,e)=>({...t,ref:`e${e+1}`}))}function r(t){let e=t.trim();return e.startsWith("@")?e.slice(1)||null:e.startsWith("e")?e:null}function i(t,e){return t.find(t=>t.ref===e)??null}function o(t){return JSON.stringify({interactiveOnly:t?.interactiveOnly===!0,depth:"number"==typeof t?.depth?t.depth:null,scope:t?.scope?.trim()||null,raw:t?.raw===!0})}function s(t){if(t)return{depth:t.snapshotDepth,interactiveOnly:t.snapshotInteractiveOnly,raw:t.snapshotRaw,scope:t.snapshotScope}}function d(t){return{x:Math.round(t.x+t.width/2),y:Math.round(t.y+t.height/2)}}let l=["reject","strip"],c=["ios-simulator","ios-instance","android-instance"],u=["socket","http","dual"],m=["auto","socket","http"],f=["none","tenant"],p=["summary","headers","body","all"];function h(t){return{parse:e=>t(e,"$")}}function $(t,e){throw Error(`${t}: ${e}`)}function I(t,e){return(!t||"object"!=typeof t||Array.isArray(t))&&$(e,"Expected an object"),t}function E(t,e){return"string"!=typeof t&&$(e,"Expected a string"),t}function S(t,e){let n=E(t,e).trim();return n||$(e,"Expected a non-empty string"),n}function v(t,e){return Number.isInteger(t)||$(e,"Expected an integer"),t}function y(t,e,n){let a=t[e];return void 0===a?void 0:E(a,`${n}.${e}`)}function b(t,e,n){let a=t[e];if(void 0!==a)return"boolean"!=typeof a&&$(`${n}.${e}`,"Expected a boolean"),a}function M(t,e,n){let a=t[e];return void 0===a?void 0:v(a,`${n}.${e}`)}function N(t,e,n){let a=t[e];return void 0===a?void 0:I(a,`${n}.${e}`)}function P(t,e,n,a){let r=t[e];if(void 0!==r)return"string"==typeof r&&n.includes(r)||$(`${a}.${e}`,`Expected one of: ${n.join(", ")}`),r}function x(t,e){let n=I(t,e),a={};for(let[t,r]of Object.entries(n))a[t]=E(r,`${e}.${t}`);return a}let O=h((t,e)=>{let n=I(t,e);return{platform:P(n,"platform",["ios","android"],e),metroHost:y(n,"metroHost",e),metroPort:M(n,"metroPort",e),bundleUrl:y(n,"bundleUrl",e),launchUrl:y(n,"launchUrl",e)}}),R=h((e,n)=>{var a,r;let i=I(e,n),o=(a=i.positionals,r=`${n}.positionals`,Array.isArray(a)||$(r,"Expected an array"),a),s=N(i,"meta",n);return{token:y(i,"token",n),session:y(i,"session",n),command:E(i.command,`${n}.command`),positionals:o.map((t,e)=>E(t,`${n}.positionals[${String(e)}]`)),flags:N(i,"flags",n),runtime:void 0===i.runtime?void 0:O.parse(i.runtime),meta:void 0===s?void 0:{requestId:y(s,"requestId",`${n}.meta`),debug:b(s,"debug",`${n}.meta`),cwd:y(s,"cwd",`${n}.meta`),sessionExplicit:b(s,"sessionExplicit",`${n}.meta`),tenantId:y(s,"tenantId",`${n}.meta`),runId:y(s,"runId",`${n}.meta`),leaseId:y(s,"leaseId",`${n}.meta`),leaseTtlMs:M(s,"leaseTtlMs",`${n}.meta`),leaseBackend:P(s,"leaseBackend",c,`${n}.meta`),sessionIsolation:P(s,"sessionIsolation",f,`${n}.meta`),uploadedArtifactId:y(s,"uploadedArtifactId",`${n}.meta`),clientArtifactPaths:void 0===s.clientArtifactPaths?void 0:x(s.clientArtifactPaths,`${n}.meta.clientArtifactPaths`),installSource:void 0===s.installSource?void 0:function(t,e){let n=I(t,e),a=E(n.kind,`${e}.kind`);if("url"===a){let t=E(n.url,`${e}.url`),r=void 0===n.headers?void 0:x(n.headers,`${e}.headers`);return r?{kind:a,url:t,headers:r}:{kind:a,url:t}}if("path"===a)return{kind:a,path:E(n.path,`${e}.path`)};if("github-actions-artifact"===a){let t,a,r,i,o;return t=S(n.owner,`${e}.owner`),a=S(n.repo,`${e}.repo`),r=void 0!==n.artifactId,i=void 0!==n.runId,o=void 0!==n.artifactName,(r&&(i||o)&&$(`${e}`,"Expected either artifactId or artifactName, not both"),r||!i||o||$(`${e}`,"Expected artifactName when runId is specified"),r||o||$(`${e}`,"Expected artifactId or artifactName"),r)?{kind:"github-actions-artifact",owner:t,repo:a,artifactId:v(n.artifactId,`${e}.artifactId`)}:{kind:"github-actions-artifact",owner:t,repo:a,...i?{runId:v(n.runId,`${e}.runId`)}:{},artifactName:S(n.artifactName,`${e}.artifactName`)}}$(`${e}.kind`,'Expected "url", "path", or "github-actions-artifact"')}(s.installSource,`${n}.meta.installSource`),retainMaterializedPaths:b(s,"retainMaterializedPaths",`${n}.meta`),materializedPathRetentionMs:M(s,"materializedPathRetentionMs",`${n}.meta`),materializationId:y(s,"materializationId",`${n}.meta`),lockPolicy:P(s,"lockPolicy",l,`${n}.meta`),lockPlatform:P(s,"lockPlatform",t,`${n}.meta`)}}});function _(t,e){return{token:y(t,"token",e),session:y(t,"session",e),tenantId:y(t,"tenantId",e),tenant:y(t,"tenant",e),runId:y(t,"runId",e)}}let g=h((t,e)=>{let n=I(t,e);return{..._(n,e),ttlMs:M(n,"ttlMs",e),backend:P(n,"backend",c,e)}}),k=h((t,e)=>{let n,a={record:n=I(t,e),leaseId:y(n,"leaseId",e),ttlMs:M(n,"ttlMs",e)};return{..._(a.record,e),leaseId:a.leaseId,ttlMs:a.ttlMs}}),A=h((t,e)=>{let n=I(t,e);return void 0!==n.ttlMs&&$(`${e}.ttlMs`,"Unexpected field"),{..._(n,e),leaseId:y(n,"leaseId",e)}}),w=h((t,e)=>{let n,a=I(t,e);return{jsonrpc:y(a,"jsonrpc",e),id:(null==(n=a.id)||"string"!=typeof n&&"number"!=typeof n&&$(`${e}.id`,"Expected a string, number, or null"),n),method:y(a,"method",e),params:a.params}});export{l as DAEMON_LOCK_POLICIES,u as DAEMON_SERVER_MODES,m as DAEMON_TRANSPORT_PREFERENCES,c as LEASE_BACKENDS,p as NETWORK_INCLUDE_MODES,f as SESSION_ISOLATION_MODES,a as attachRefs,o as buildSnapshotPresentationKey,d as centerOfRect,R as daemonCommandRequestSchema,O as daemonRuntimeSchema,i as findNodeByRef,e as isSnapshotBackend,w as jsonRpcRequestSchema,g as leaseAllocateSchema,k as leaseHeartbeatSchema,A as leaseReleaseSchema,r as normalizeRef,s as snapshotPresentationOptionsFromFlags,n as usesMobileSnapshotPresentation};

package/dist/src/{7599.js → 432.js}

@@ -1,4 +1,4 @@
-import{AsyncLocalStorage as t}from"node:async_hooks";import e from"node:crypto";import n from"node:fs";import o from"node:os";import i from"node:path";import{redactDiagnosticData as r}from"./9152.js";let s=new t;function a(){return e.randomBytes(8).toString("hex")}async function c(t,n){let o={...t,diagnosticId:`${Date.now().toString(36)}-${e.randomBytes(4).toString("hex")}`,events:[],liveWrittenEventCount:0};return await s.run(o,n)}function l(t){let e=s.getStore();e&&Object.assign(e,t)}function d(){let t=s.getStore();return t?{diagnosticId:t.diagnosticId,requestId:t.requestId,session:t.session,command:t.command,debug:t.debug}:{}}function g(t){let e=s.getStore();if(!e)return;let n={ts:new Date().toISOString(),level:t.level??"info",phase:t.phase,session:e.session,requestId:e.requestId,command:e.command,durationMs:t.durationMs,data:t.data?r(t.data):void 0};if(e.events.push(n),!e.debug)return;let o=`${JSON.stringify(n)}
+import{AsyncLocalStorage as t}from"node:async_hooks";import e from"node:crypto";import n from"node:fs";import o from"node:os";import i from"node:path";import{redactDiagnosticData as r}from"./733.js";let s=new t;function a(){return e.randomBytes(8).toString("hex")}async function c(t,n){let o={...t,diagnosticId:`${Date.now().toString(36)}-${e.randomBytes(4).toString("hex")}`,events:[],liveWrittenEventCount:0};return await s.run(o,n)}function l(t){let e=s.getStore();e&&Object.assign(e,t)}function d(){let t=s.getStore();return t?{diagnosticId:t.diagnosticId,requestId:t.requestId,session:t.session,command:t.command,debug:t.debug}:{}}function g(t){let e=s.getStore();if(!e)return;let n={ts:new Date().toISOString(),level:t.level??"info",phase:t.phase,session:e.session,requestId:e.requestId,command:e.command,durationMs:t.durationMs,data:t.data?r(t.data):void 0};if(e.events.push(n),!e.debug)return;let o=`${JSON.stringify(n)}
 `;try{e.logPath&&(f(e.logPath,o),e.liveWrittenEventCount=e.events.length),e.traceLogPath&&f(e.traceLogPath,o),e.logPath||e.traceLogPath||process.stderr.write(`[agent-device][diag] ${o}`)}catch{}}async function u(t,e,n){let o=Date.now();try{let i=await e();return g({level:"info",phase:t,durationMs:Date.now()-o,data:n}),i}catch(e){throw g({level:"error",phase:t,durationMs:Date.now()-o,data:{...n??{},error:e instanceof Error?e.message:String(e)}}),e}}function m(t={}){let e=s.getStore();if(!e||!t.force&&!e.debug||0===e.events.length)return null;try{if(e.logPath){let t=e.events.slice(e.liveWrittenEventCount);if(t.length>0){let n=t.map(t=>JSON.stringify(r(t)));f(e.logPath,`${n.join("\n")}
 `)}let n=e.logPath;return e.events=[],e.liveWrittenEventCount=0,n}let t=(e.session??"default").replace(/[^a-zA-Z0-9._-]/g,"_"),s=new Date().toISOString().slice(0,10),a=i.join(o.homedir(),".agent-device","logs",t,s);n.mkdirSync(a,{recursive:!0});let c=new Date().toISOString().replace(/[:.]/g,"-"),l=i.join(a,`${c}-${e.diagnosticId}.ndjson`),d=e.events.map(t=>JSON.stringify(r(t)));return n.writeFileSync(l,`${d.join("\n")}
 `),e.events=[],l}catch{return null}}function f(t,e){n.mkdirSync(i.dirname(t),{recursive:!0}),n.appendFileSync(t,e,"utf8")}export{a as createRequestId,g as emitDiagnostic,m as flushDiagnosticsToSessionFile,d as getDiagnosticsMeta,l as updateDiagnosticsScope,u as withDiagnosticTimer,c as withDiagnosticsScope};