agent-device 0.21.13 → 0.21.15

package/dist/src/mechanics.js

@@ -1,20 +1,20 @@
-import{r as e}from"./rolldown-runtime.js";import{D as t,L as n,O as r,U as i,g as a,m as o}from"./sdk-contracts.js";import"./capture.js";import{O as s}from"./sdk-batch-runner.js";import{a as c,d as l,i as u,l as d,o as f,r as p,t as ee,u as te}from"./android-input-ownership.js";import{Hr as ne,Kr as re,Vr as ie,Wr as ae}from"./sdk-batch.js";import{i as oe,n as se,r as ce}from"./snapshot-scope.js";import{_ as le,d as ue,p as de}from"./scroll-gesture.js";import{r as fe}from"./success-text.js";import{n as pe}from"./alert-contract.js";import{_ as me,d as he,n as ge,v as _e,x as ve,y as ye}from"./location-coordinates.js";import{r as be}from"./mobile-snapshot-semantics.js";import"./device.js";import{n as xe}from"./device-rotation.js";import{c as m,r as h}from"./diagnostics.js";import{a as Se,c as Ce,h as we,n as Te,s as Ee}from"./exec.js";import{t as g}from"./timeouts.js";import{i as De}from"./tv-remote.js";import"./diagnostics2.js";import"./command.js";import{a as _,n as Oe,o as v}from"./device-shell.js";import"./retry.js";import{a as ke,r as Ae}from"./version.js";import{n as je,r as Me}from"./install-source2.js";import{_ as Ne,a as y,c as Pe,d as b,f as Fe,g as x,h as S,i as Ie,l as Le,n as Re,o as C,p as ze,r as Be,s as Ve,t as He,u as Ue,v as We}from"./adb-executor.js";import{c as Ge,h as Ke,i as qe,o as Je,r as Ye,u as Xe}from"./adb-transport.js";import{i as Ze,n as w,o as Qe,s as $e}from"./adb-failure.js";import{a as et,i as tt,n as nt,o as T}from"./adb.js";import{i as rt,n as it,r as at}from"./gesture-plan.js";import{n as ot,r as st,s as ct}from"./android-system-chrome.js";import{a as lt,c as ut,i as dt,l as ft,n as pt,o as mt,r as ht,s as gt,u as _t}from"./app-lifecycle.js";import{a as vt,i as yt,n as bt,o as xt,r as St,t as Ct}from"./app-deployment-resolution.js";import{a as wt,i as Tt,n as Et,o as Dt,t as Ot}from"./app-parsers.js";import{i as kt,n as At,r as jt,t as Mt}from"./window-state.js";import{n as Nt}from"./toolchain-probe.js";import{t as Pt}from"./keyed-lock.js";import{t as Ft}from"./bounds.js";import{t as It}from"./entities.js";import{n as Lt}from"./startup-recovery-fence.js";import{n as Rt}from"./numeric.js";import E from"node:path";import zt from"node:net";import{TextDecoder as Bt}from"node:util";const Vt=new Map;async function Ht(e){let t=Vt.get(e.deviceKey);if(t!==void 0)return t;let n;try{let t=await e.adb([`features`],{allowFailure:!0,timeoutMs:2e3,...e.signal?{signal:e.signal}:{}});if(t.exitCode!==0)return!1;n=t.stdout}catch{return!1}let r=Wt(n).includes(`shell_v2`);return Vt.set(e.deviceKey,r),r}function Ut(){Vt.clear()}function Wt(e){return e.split(`
-`).map(e=>e.trim()).filter(Boolean)}const Gt=new Set([`com.android.permissioncontroller`,`com.google.android.permissioncontroller`,`com.google.android.packageinstaller`,`com.android.packageinstaller`]);function Kt(e){return Gt.has(e)}const qt=new Set([`android`,`com.android.systemui`]),Jt=/^android:id\/(?:alertTitle|message|button[123]|parentPanel|buttonPanel|contentPanel)$/i,Yt=/^android:id\/button[123]$/i,Xt=/(?:^|:)id\/permission_/i,Zt=/\b(?:is(?:n't| not) responding|keeps stopping|has stopped|close app|app info)\b/i,Qt=/^(?:ok|allow|allow all|while using the app|only this time|yes|continue|save|confirm|turn on|open settings)$/i,$t=/^(?:cancel|deny|don.t allow|don’t allow|not now|no|dismiss|close|close app|later|skip)$/i;function en(e){if(e!==null){if(Yt.test(e))return`button`;if(Jt.test(e))return`content`}}function tn(e){let t=an(e.filter(nn)),n=t.nodes;if(n.length===0)return null;let r=un(n),i=n.filter(e=>D(e)&&!bn(e)),a=pn(i),o=mn(i,a);if(!a&&!o&&r.length===0)return null;let s=xn(n);return{alert:{...a?{title:a}:{},...o?{message:o}:{},buttons:r.map(e=>e.label),platform:`android`,source:t.source,...s?{packageName:s}:{}},buttons:r}}function nn(e){return!d(e)}function rn(e,t){let n=t===`accept`?`accept`:`dismiss`;return e.find(e=>e.role===n)||(t===`dismiss`?e.find(e=>e.role===`neutral`)??null:e.length===1?e[0]??null:null)}function an(e){let t=e.filter(e=>vn(e));if(t.length)return{nodes:t,source:`permission`};let n=ln(e);return n.length?{nodes:n,source:`system-dialog`}:{nodes:on(e),source:`native-dialog`}}function on(e){let t=e.filter(e=>sn(e.type??``)),n=e.filter(e=>Jt.test(e.identifier??``)),r=t.length?[...t,...n]:cn(n);if(r.length===0)return[];let i=hn(e,r);return i===void 0?r:_n(e,i)}function sn(e){let t=Math.max(e.lastIndexOf(`.`),e.lastIndexOf(`$`));return e.slice(t+1).toLowerCase().endsWith(`dialog`)}function cn(e){let t=e.some(e=>Yt.test(e.identifier??``)),n=e.some(e=>!Yt.test(e.identifier??``));return t&&n?e:[]}function ln(e){let t=e.filter(e=>yn(e));if(t.length===0)return[];let n=hn(e,t);return n===void 0?t:_n(e,n).filter(e=>e.bundleId&&qt.has(e.bundleId))}function un(e){let t=new Set,n=[];for(let r of e){let e=D(r);if(!e||!r.rect||!bn(r))continue;let i=e.trim().toLowerCase();if(!i||t.has(i))continue;t.add(i);let o=a(r.rect);n.push({label:e,x:o.x,y:o.y,role:dn(r,e)})}return n}function dn(e,t){return fn(e.identifier??``)||(Qt.test(t.trim())?`accept`:$t.test(t.trim())?`dismiss`:`neutral`)}function fn(e){return/(?:^|:)id\/button1$/i.test(e)?`accept`:/(?:^|:)id\/button2$/i.test(e)?`dismiss`:/(?:^|:)id\/button3$/i.test(e)?`neutral`:/(?:^|:)id\/permission_allow/i.test(e)?`accept`:/(?:^|:)id\/permission_deny/i.test(e)?`dismiss`:null}function pn(e){return D(e.find(e=>/(?:^|:)id\/(?:alertTitle|permission_message)$/i.test(e.identifier??``)))||D(e[0])}function mn(e,t){let n=e.map(e=>D(e)).filter(e=>e&&e!==t);return n.length?[...new Set(n)].join(`
-`):void 0}function hn(e,t){let n=t[0];if(!n)return;let r=gn(e,n.index);for(let n of t.slice(1)){let t=new Set(gn(e,n.index));for(let e=r.length-1;e>=0;--e)t.has(r[e])||r.splice(e,1)}return r.at(-1)}function gn(e,t){let n=new Map(e.map(e=>[e.index,e])),r=[],i=n.get(t);for(;i;)r.push(i.index),i=i.parentIndex===void 0?void 0:n.get(i.parentIndex);return r.reverse()}function _n(e,t){let n=new Map;for(let t of e){if(t.parentIndex===void 0)continue;let e=n.get(t.parentIndex)??[];e.push(t),n.set(t.parentIndex,e)}let r=new Set([t]),i=[t];for(let e of i)for(let t of n.get(e)??[])r.has(t.index)||(r.add(t.index),i.push(t.index));return e.filter(e=>r.has(e.index))}function vn(e){let t=e.bundleId??``;return Gt.has(t)||Xt.test(e.identifier??``)}function yn(e){let t=e.bundleId??``;return qt.has(t)&&Zt.test(D(e))}function bn(e){let t=e.type??``,n=e.identifier??``;return!!(e.hittable||/\bbutton\b/i.test(t)||Yt.test(n)||/(?:^|:)id\/permission_(?:allow|deny)/i.test(n))}function D(e){return e?[e.label,e.value].filter(e=>typeof e==`string`&&e.trim().length>0)[0]?.trim()??``:``}function xn(e){return e.find(e=>e.bundleId)?.bundleId}function Sn(e,n,r){if(typeof e!=`number`||!Number.isInteger(e))throw new t(`INVALID_ARGS`,`Android ${r} manifest ${n} must be an integer.`);return e}function O(e,n,r,i){if(e!==r)throw new t(`INVALID_ARGS`,`Android ${i} manifest ${n} must be "${r}".`);return r}function Cn(e,n,r){if(typeof e!=`string`||e.length===0)throw new t(`INVALID_ARGS`,`Android ${r} manifest ${n} is required.`);return e}function wn(e,n){let r=Cn(e,`sha256`,n).trim().toLowerCase();if(r.length!==64||!/^[0-9a-f]+$/.test(r))throw new t(`INVALID_ARGS`,`Android ${n} manifest sha256 must be a 64-character hex string.`);return r}function Tn(e){let t={status:[],results:[],currentStatus:null,currentResult:null};for(let n of e.split(/\r?\n/))En(n,t);return Dn(t),{status:t.status,results:t.results}}function En(e,t){if(e.startsWith(`INSTRUMENTATION_STATUS: `)){t.currentStatus??={},An(e.slice(24),t.currentStatus);return}if(e.startsWith(`INSTRUMENTATION_STATUS_CODE: `)){On(t);return}if(e.startsWith(`INSTRUMENTATION_RESULT: `)){t.currentResult??={},An(e.slice(24),t.currentResult);return}e.startsWith(`INSTRUMENTATION_CODE: `)&&kn(t)}function Dn(e){On(e),kn(e)}function On(e){e.currentStatus&&=(e.status.push(e.currentStatus),null)}function kn(e){e.currentResult&&=(e.results.push(e.currentResult),null)}function An(e,t){let n=e.indexOf(`=`);n<0||(t[e.slice(0,n)]=e.slice(n+1))}function k(e){if(e===void 0)return;let t=Number(e);return Number.isFinite(t)?t:void 0}function A(e){if(e===`true`)return!0;if(e===`false`)return!1}function jn(e){if(!Number.isFinite(e.x)||!Number.isFinite(e.y)||!Number.isFinite(e.width)||!Number.isFinite(e.height)||e.width<=0||e.height<=0)throw new t(`COMMAND_FAILED`,`Android helper returned an invalid gesture viewport`);return e}const Mn=1e4;async function Nn(e,t){try{return await He(e,t)}catch(e){throw Qe(e)}}async function Pn(e){let{adb:t,adbProvider:n,packageName:r,versionCode:i,apkPath:a,sha256:o,cache:s,deviceKey:c,installTimeoutMs:l,helperLabel:u}=e,d=`${c}\0${r}\0${i}\0${o}`;if(s.has(d))return{packageName:r,versionCode:i,installedSha256:o,installed:!1,reason:`current`};await Vn(a,o,u);let f=await Fn({adb:t,adbProvider:n,packageName:r,versionCode:i,sha256:o});if(f.reason===`current`)return s.add(d),{packageName:r,versionCode:i,...f,installed:!1};let p=await Nn(a,{provider:n,replace:!0,allowFailure:!0,timeoutMs:l});if(p.exitCode!==0)throw w(`Failed to install ${u}`,p,{packageName:r,versionCode:i,reason:f.reason});return s.add(d),{packageName:r,versionCode:i,...f,installed:!0}}async function Fn(e){let{adb:t,adbProvider:n,packageName:r,versionCode:i,sha256:a,signal:o}=e,s=await Rn(t,r,o);if(s===void 0)return{reason:`missing`};if(s<i)return{installedVersionCode:s,reason:`outdated`};if(s>i)return{installedVersionCode:s,reason:`current`};try{let e=await zn(t,n,r,o);return{installedVersionCode:s,installedSha256:e,reason:e===a?`current`:`mismatched`}}catch{return o?.throwIfAborted(),{installedVersionCode:s,reason:`unverifiable`}}}async function In(e){let r=x().files,i=ke(),a=E.join(Ae(),`android`,e.helperDirName,`dist`),o=E.join(a,e.manifestFileName(i));try{let t=e.parseManifest(JSON.parse(await r.readText(o))),n=E.join(a,t.assetName);return await r.access(n),{apkPath:n,manifest:t}}catch(r){throw new t(`UNSUPPORTED_OPERATION`,e.unavailableMessage,{manifestPath:o,error:n(r).message},r)}}function Ln(e){return async t=>await Pn({adb:t.adb,adbProvider:t.adbProvider,packageName:t.artifact.manifest.packageName,versionCode:t.artifact.manifest.versionCode,apkPath:t.artifact.apkPath,sha256:t.artifact.manifest.sha256,cache:e.cache,deviceKey:t.deviceKey,installTimeoutMs:e.installTimeoutMs,helperLabel:e.helperLabel})}async function Rn(e,t,n){let r=await b(e,[`cmd`,`package`,`list`,`packages`,`--show-versioncode`,t],{allowFailure:!0,timeoutMs:5e3,signal:n});if(r.exitCode!==0)return;let i=RegExp(`package:${Un(t)}(?:\\s|$).*versionCode:(\\d+)`).exec(`${r.stdout}\n${r.stderr}`);return i?Number(i[1]):void 0}async function zn(e,n,r,i){let a=await b(e,[`pm`,`path`,r],{allowFailure:!0,timeoutMs:Mn,signal:i}),o=Bn(`${a.stdout}\n${a.stderr}`);if(a.exitCode!==0||!o)throw new t(`COMMAND_FAILED`,`Could not resolve installed Android helper APK`);let s=x().files,c=await s.makeTempDirectory(`agent-device-helper-`),l=E.join(c,`base.apk`);try{let e=await Re(o,l,{provider:n,allowFailure:!0,timeoutMs:Mn,signal:i});if(e.exitCode!==0)throw w(`Could not read installed Android helper APK`,e,{packageName:r,remotePath:o});return await Hn(l)}finally{await s.remove(c,{recursive:!0,force:!0})}}function Bn(e){return e.split(/\r?\n/).map(e=>e.startsWith(`package:`)?e.slice(8).trim():``).find(e=>e.endsWith(`/base.apk`))}async function Vn(e,n,r){let i=await Hn(e);if(i!==n)throw new t(`COMMAND_FAILED`,`${r} APK checksum mismatch`,{apkPath:e,expectedSha256:n,actualSha256:i})}async function Hn(e){let t=x().files;return t.sha256(await t.readBytes(e))}function Un(e){return e.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`)}const Wn=`android-snapshot-helper-v1`,Gn=`uiautomator-xml`,Kn=5e3,qn=3e4;function Jn(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`Android snapshot helper manifest must be an object.`);let n=e;return{name:Xn(n.name,`name`,`android-snapshot-helper`),version:j(n.version,`version`),releaseTag:Qn(n.releaseTag),assetName:Qn(n.assetName),apkUrl:$n(n.apkUrl,`apkUrl`),sha256:Zn(n.sha256),checksumName:Qn(n.checksumName),packageName:j(n.packageName,`packageName`),versionCode:Yn(n.versionCode,`versionCode`),instrumentationRunner:j(n.instrumentationRunner,`instrumentationRunner`),minSdk:Yn(n.minSdk,`minSdk`),targetSdk:n.targetSdk===void 0?void 0:Yn(n.targetSdk,`targetSdk`),outputFormat:Xn(n.outputFormat,`outputFormat`,Gn),statusProtocol:Xn(n.statusProtocol,`statusProtocol`,Wn)}}function Yn(e,t){return Sn(e,t,`snapshot helper`)}function Xn(e,t,n){return O(e,t,n,`snapshot helper`)}function Zn(e){let n=j(e,`sha256`).trim().toLowerCase();if(n.length!==64||!er(n))throw new t(`INVALID_ARGS`,`Android snapshot helper manifest sha256 must be a 64-character hex string.`);return n}function j(e,n){if(typeof e!=`string`||e.trim().length===0)throw new t(`INVALID_ARGS`,`Android snapshot helper manifest ${n} is required.`);return e}function Qn(e){return typeof e==`string`&&e.trim().length>0?e:void 0}function $n(e,t){return e===null?null:j(e,t)}function er(e){for(let t of e){let e=t.charCodeAt(0);if(!(e>=48&&e<=57)&&!(e>=97&&e<=102))return!1}return!0}const M=new Map;function tr(e){let t=`${e.deviceKey}\0${e.packageName}\0${e.versionCode}\0`;for(let e of M.keys())e.startsWith(t)&&ar(e)}function nr(){M.clear()}function rr(e,t,n,r){return e?`${e}\0${t}\0${n}\0${r}`:void 0}function ir(e,t){if(!e)return;let[n,r]=e.split(`\0`),i=`${n}\0${r}\0`;for(let t of M.keys())t!==e&&t.startsWith(i)&&M.delete(t);M.set(e,t)}function ar(e){e&&M.delete(e)}async function or(e){let{adb:t,artifact:n}=e,r=e.installPolicy??`missing-or-outdated`,i=n.manifest.packageName,a=n.manifest.versionCode,o=n.manifest.sha256;if(r===`never`)return{packageName:i,versionCode:a,installed:!1,reason:`skipped`};let s=rr(e.deviceKey,i,a,o),c=s?M.get(s):void 0;if(s&&r!==`always`&&c!==void 0)return{packageName:i,versionCode:a,installedVersionCode:c,installedSha256:o,installed:!1,reason:`current`};await Vn(n.apkPath,o,`Android snapshot helper`);let l=r===`always`?{installedVersionCode:await lr(t,i,e.timeoutMs,e.signal),reason:`forced`}:await Fn({adb:t,adbProvider:cr(e.adbProvider,t),packageName:i,versionCode:a,sha256:o,signal:e.signal}),{installedVersionCode:u}=l,d=`installedSha256`in l?l.installedSha256:void 0,f=l.reason;if(f===`current`){if(u===void 0)throw Error(`Expected installed versionCode for current Android snapshot helper`);return ir(s,u),{packageName:i,versionCode:a,installedVersionCode:u,installedSha256:d,installed:!1,reason:f}}let p;try{p=await ur(t,e.adbProvider??t,n.apkPath,{packageName:i,timeoutMs:e.timeoutMs,signal:e.signal})}catch(e){throw ar(s),sr(e,{packageName:i,versionCode:a})}if(p.exitCode!==0)throw ar(s),sr(w(`Failed to install Android snapshot helper`,p,{packageName:i,versionCode:a}));return ir(s,a),{packageName:i,versionCode:a,installedVersionCode:u,installedSha256:d,installed:!0,reason:f}}function sr(e,t){let n=r(e,`COMMAND_FAILED`);return n.details={...t,...n.details,androidSnapshotHelperInstallFailure:!0},n}function cr(e,t){return e?typeof e==`function`?{exec:e}:e:{exec:t}}async function lr(e,t,n,r){let i=await b(e,[`cmd`,`package`,`list`,`packages`,`--show-versioncode`,t],{allowFailure:!0,timeoutMs:n,signal:r});if(i.exitCode===0)return dr(`${i.stdout}\n${i.stderr}`,t)}async function ur(e,t,n,r){let i=async()=>await Nn(n,{allowFailure:!0,provider:t,replace:!0,timeoutMs:r.timeoutMs,signal:r.signal}),a=await i();if(a.exitCode===0||!fr(a))return a;let o=await e([`uninstall`,r.packageName],{allowFailure:!0,timeoutMs:r.timeoutMs,signal:r.signal}),s=await i();return s.exitCode===0?s:{...s,stderr:[s.stderr,o.stderr?`Previous uninstall stderr after INSTALL_FAILED_UPDATE_INCOMPATIBLE: ${o.stderr}`:``].filter(Boolean).join(`
-`)}}function dr(e,t){let n=`package:${t}`;for(let t of e.split(/\r?\n/)){if(!t.startsWith(n)||t.length>n.length&&!/\s/.test(t[n.length]??``))continue;let e=/(?:^|\s)versionCode:(\d+)(?:\s|$)/.exec(t);if(e)return Number(e[1])}}function fr(e){return`${e.stdout}\n${e.stderr}`.includes(`INSTALL_FAILED_UPDATE_INCOMPATIBLE`)}function pr(e){return e.errorType===`java.util.concurrent.TimeoutException`?`accessibility-timeout`:void 0}function mr(e){return e===137?`accessibility-timeout`:void 0}function hr(e){return e?{androidCaptureFailureReason:e}:{}}function gr(){return new Promise((e,t)=>{let n=zt.createServer();n.unref(),n.on(`error`,t),n.listen(0,`127.0.0.1`,()=>{let r=n.address();if(!r||typeof r==`string`){n.close(()=>t(Error(`Failed to allocate a local TCP port`)));return}let i=r.port;n.close(()=>e(i))})})}function _r(e,n,r,i){return new Promise((a,o)=>{let s=zt.connect({host:`127.0.0.1`,port:e}),c=[],l=setTimeout(()=>{u(),s.destroy(),o(new t(`COMMAND_FAILED`,`Android snapshot helper session request timed out`,{command:n,timeoutMs:r,port:e}))},r),u=()=>{clearTimeout(l),i?.removeEventListener(`abort`,d)},d=()=>{u(),s.destroy(),o(i?.reason??new DOMException(`The operation was aborted`,`AbortError`))};if(i?.addEventListener(`abort`,d,{once:!0}),i?.aborted){d();return}s.on(`connect`,()=>s.write(`${n}\n`)),s.on(`data`,e=>c.push(Buffer.from(e))),s.on(`error`,e=>{u(),o(e)}),s.on(`close`,()=>{u(),a(Buffer.concat(c).toString(`utf8`))})})}async function vr(e){let t=`snapshot-${Date.now()}-${Math.random().toString(16).slice(2)}`;return wr(await _r(e.port,`snapshot ${t}`,yr(e),e.signal),t)}function yr(e){return Math.min(e.commandTimeoutMs,Math.max(e.timeoutMs+3e3,3e3))}function br(e,n,r){return new Promise((i,a)=>{let o=``,s=setTimeout(()=>{r?.removeEventListener(`abort`,l),a(new t(`COMMAND_FAILED`,`Android snapshot helper session did not become ready`,{output:o,timeoutMs:n,reason:`android_snapshot_helper_session_ready_timeout`}))},n),c=e=>{o+=e.toString(),o.includes(`agentDeviceProtocol=android-snapshot-helper-v1`)&&o.includes(`sessionReady=true`)&&(clearTimeout(s),r?.removeEventListener(`abort`,l),i())},l=()=>{clearTimeout(s),a(r?.reason??new DOMException(`The operation was aborted`,`AbortError`))};if(r?.addEventListener(`abort`,l,{once:!0}),r?.aborted){l();return}e.stdout?.on(`data`,c),e.stderr?.on(`data`,c),e.once(`exit`,(e,n)=>{clearTimeout(s),r?.removeEventListener(`abort`,l),a(new t(`COMMAND_FAILED`,`Android snapshot helper session exited before ready`,{output:o,exitCode:e,signal:n,reason:`android_snapshot_helper_session_exited_before_ready`}))}),e.on(`error`,e=>{clearTimeout(s),r?.removeEventListener(`abort`,l),a(e)})})}function xr(e){let t=e.indexOf(`
+import{r as e}from"./rolldown-runtime.js";import{A as t,B as n,G as r,_ as i,h as a,j as o,q as s}from"./sdk-contracts.js";import"./capture.js";import{O as c}from"./sdk-batch-runner.js";import{a as l,d as u,i as d,l as f,o as p,r as m,t as ee,u as te}from"./android-input-ownership.js";import{Gr as ne,Hr as re,Jr as ie,Kr as ae,Ur as oe,Vr as se,Xr as ce}from"./sdk-batch.js";import{_ as le,d as ue,p as de}from"./scroll-gesture.js";import{r as fe}from"./success-text.js";import{n as pe}from"./alert-contract.js";import{S as me,_ as he,b as ge,g as _e,u as ve,v as ye,y as be}from"./settings.js";import{n as xe}from"./location-coordinates.js";import{r as Se}from"./mobile-snapshot-semantics.js";import"./device.js";import{n as Ce}from"./device-rotation.js";import{c as h,r as g}from"./diagnostics.js";import{a as we,c as Te,h as Ee,n as De,s as Oe}from"./exec.js";import{t as _}from"./timeouts.js";import{i as ke}from"./tv-remote.js";import"./diagnostics2.js";import"./command.js";import{a as v,n as Ae,o as y}from"./device-shell.js";import"./retry.js";import{a as je,r as Me}from"./version.js";import{n as Ne,r as Pe}from"./install-source2.js";import{_ as Fe,a as b,c as Ie,d as x,f as Le,g as S,h as C,i as Re,l as ze,n as Be,o as w,p as Ve,r as He,s as Ue,t as We,u as Ge,v as Ke}from"./adb-executor.js";import{c as qe,h as Je,i as Ye,o as Xe,r as Ze,u as Qe}from"./adb-transport.js";import{i as $e,n as T,o as et,s as tt}from"./adb-failure.js";import{a as nt,i as rt,n as it,o as E}from"./adb.js";import{i as at,n as ot,r as st}from"./gesture-plan.js";import{n as ct}from"./android-snapshot-quality.js";import{a as lt,c as ut,i as dt,l as ft,n as pt,o as mt,r as ht,s as gt,u as _t}from"./app-lifecycle.js";import{a as vt,i as yt,n as bt,o as xt,r as St,t as Ct}from"./app-deployment-resolution.js";import{a as wt,i as Tt,n as Et,o as Dt,t as Ot}from"./app-parsers.js";import{i as kt,n as At,r as jt,t as Mt}from"./window-state.js";import{n as Nt}from"./toolchain-probe.js";import{t as Pt}from"./keyed-lock.js";import{n as Ft,r as It}from"./android-system-chrome.js";import{t as Lt}from"./bounds.js";import{t as Rt}from"./entities.js";import{n as zt}from"./startup-recovery-fence.js";import{n as Bt}from"./numeric.js";import D from"node:path";import Vt from"node:net";import{TextDecoder as Ht}from"node:util";const Ut=new Map;async function Wt(e){let t=Ut.get(e.deviceKey);if(t!==void 0)return t;let n;try{let t=await e.adb([`features`],{allowFailure:!0,timeoutMs:2e3,...e.signal?{signal:e.signal}:{}});if(t.exitCode!==0)return!1;n=t.stdout}catch{return!1}let r=Kt(n).includes(`shell_v2`);return Ut.set(e.deviceKey,r),r}function Gt(){Ut.clear()}function Kt(e){return e.split(`
+`).map(e=>e.trim()).filter(Boolean)}const qt=new Set([`com.android.permissioncontroller`,`com.google.android.permissioncontroller`,`com.google.android.packageinstaller`,`com.android.packageinstaller`]);function Jt(e){return qt.has(e)}const Yt=new Set([`android`,`com.android.systemui`]),Xt=/^android:id\/(?:alertTitle|message|button[123]|parentPanel|buttonPanel|contentPanel)$/i,Zt=/^android:id\/button[123]$/i,Qt=/(?:^|:)id\/permission_/i,$t=/\b(?:is(?:n't| not) responding|keeps stopping|has stopped|close app|app info)\b/i,en=/^(?:ok|allow|allow all|while using the app|only this time|yes|continue|save|confirm|turn on|open settings)$/i,tn=/^(?:cancel|deny|don.t allow|don’t allow|not now|no|dismiss|close|close app|later|skip)$/i;function nn(e){if(e!==null){if(Zt.test(e))return`button`;if(Xt.test(e))return`content`}}function rn(e){let t=sn(e.filter(an)),n=t.nodes;if(n.length===0)return null;let r=fn(n),i=n.filter(e=>O(e)&&!Sn(e)),a=hn(i),o=gn(i,a);if(!a&&!o&&r.length===0)return null;let s=Cn(n);return{alert:{...a?{title:a}:{},...o?{message:o}:{},buttons:r.map(e=>e.label),platform:`android`,source:t.source,...s?{packageName:s}:{}},buttons:r}}function an(e){return!f(e)}function on(e,t){let n=t===`accept`?`accept`:`dismiss`;return e.find(e=>e.role===n)||(t===`dismiss`?e.find(e=>e.role===`neutral`)??null:e.length===1?e[0]??null:null)}function sn(e){let t=e.filter(e=>bn(e));if(t.length)return{nodes:t,source:`permission`};let n=dn(e);return n.length?{nodes:n,source:`system-dialog`}:{nodes:cn(e),source:`native-dialog`}}function cn(e){let t=e.filter(e=>ln(e.type??``)),n=e.filter(e=>Xt.test(e.identifier??``)),r=t.length?[...t,...n]:un(n);if(r.length===0)return[];let i=_n(e,r);return i===void 0?r:yn(e,i)}function ln(e){let t=Math.max(e.lastIndexOf(`.`),e.lastIndexOf(`$`));return e.slice(t+1).toLowerCase().endsWith(`dialog`)}function un(e){let t=e.some(e=>Zt.test(e.identifier??``)),n=e.some(e=>!Zt.test(e.identifier??``));return t&&n?e:[]}function dn(e){let t=e.filter(e=>xn(e));if(t.length===0)return[];let n=_n(e,t);return n===void 0?t:yn(e,n).filter(e=>e.bundleId&&Yt.has(e.bundleId))}function fn(e){let t=new Set,n=[];for(let r of e){let e=O(r);if(!e||!r.rect||!Sn(r))continue;let a=e.trim().toLowerCase();if(!a||t.has(a))continue;t.add(a);let o=i(r.rect);n.push({label:e,x:o.x,y:o.y,role:pn(r,e)})}return n}function pn(e,t){return mn(e.identifier??``)||(en.test(t.trim())?`accept`:tn.test(t.trim())?`dismiss`:`neutral`)}function mn(e){return/(?:^|:)id\/button1$/i.test(e)?`accept`:/(?:^|:)id\/button2$/i.test(e)?`dismiss`:/(?:^|:)id\/button3$/i.test(e)?`neutral`:/(?:^|:)id\/permission_allow/i.test(e)?`accept`:/(?:^|:)id\/permission_deny/i.test(e)?`dismiss`:null}function hn(e){return O(e.find(e=>/(?:^|:)id\/(?:alertTitle|permission_message)$/i.test(e.identifier??``)))||O(e[0])}function gn(e,t){let n=e.map(e=>O(e)).filter(e=>e&&e!==t);return n.length?[...new Set(n)].join(`
+`):void 0}function _n(e,t){let n=t[0];if(!n)return;let r=vn(e,n.index);for(let n of t.slice(1)){let t=new Set(vn(e,n.index));for(let e=r.length-1;e>=0;--e)t.has(r[e])||r.splice(e,1)}return r.at(-1)}function vn(e,t){let n=new Map(e.map(e=>[e.index,e])),r=[],i=n.get(t);for(;i;)r.push(i.index),i=i.parentIndex===void 0?void 0:n.get(i.parentIndex);return r.reverse()}function yn(e,t){let n=new Map;for(let t of e){if(t.parentIndex===void 0)continue;let e=n.get(t.parentIndex)??[];e.push(t),n.set(t.parentIndex,e)}let r=new Set([t]),i=[t];for(let e of i)for(let t of n.get(e)??[])r.has(t.index)||(r.add(t.index),i.push(t.index));return e.filter(e=>r.has(e.index))}function bn(e){let t=e.bundleId??``;return qt.has(t)||Qt.test(e.identifier??``)}function xn(e){let t=e.bundleId??``;return Yt.has(t)&&$t.test(O(e))}function Sn(e){let t=e.type??``,n=e.identifier??``;return!!(e.hittable||/\bbutton\b/i.test(t)||Zt.test(n)||/(?:^|:)id\/permission_(?:allow|deny)/i.test(n))}function O(e){return e?[e.label,e.value].filter(e=>typeof e==`string`&&e.trim().length>0)[0]?.trim()??``:``}function Cn(e){return e.find(e=>e.bundleId)?.bundleId}function wn(e,n,r){if(typeof e!=`number`||!Number.isInteger(e))throw new t(`INVALID_ARGS`,`Android ${r} manifest ${n} must be an integer.`);return e}function k(e,n,r,i){if(e!==r)throw new t(`INVALID_ARGS`,`Android ${i} manifest ${n} must be "${r}".`);return r}function Tn(e,n,r){if(typeof e!=`string`||e.length===0)throw new t(`INVALID_ARGS`,`Android ${r} manifest ${n} is required.`);return e}function En(e,n){let r=Tn(e,`sha256`,n).trim().toLowerCase();if(r.length!==64||!/^[0-9a-f]+$/.test(r))throw new t(`INVALID_ARGS`,`Android ${n} manifest sha256 must be a 64-character hex string.`);return r}function Dn(e){let t={status:[],results:[],currentStatus:null,currentResult:null};for(let n of e.split(/\r?\n/))On(n,t);return kn(t),{status:t.status,results:t.results}}function On(e,t){if(e.startsWith(`INSTRUMENTATION_STATUS: `)){t.currentStatus??={},Mn(e.slice(24),t.currentStatus);return}if(e.startsWith(`INSTRUMENTATION_STATUS_CODE: `)){An(t);return}if(e.startsWith(`INSTRUMENTATION_RESULT: `)){t.currentResult??={},Mn(e.slice(24),t.currentResult);return}e.startsWith(`INSTRUMENTATION_CODE: `)&&jn(t)}function kn(e){An(e),jn(e)}function An(e){e.currentStatus&&=(e.status.push(e.currentStatus),null)}function jn(e){e.currentResult&&=(e.results.push(e.currentResult),null)}function Mn(e,t){let n=e.indexOf(`=`);n<0||(t[e.slice(0,n)]=e.slice(n+1))}function A(e){if(e===void 0)return;let t=Number(e);return Number.isFinite(t)?t:void 0}function Nn(e){if(e===`true`)return!0;if(e===`false`)return!1}function Pn(e){if(!Number.isFinite(e.x)||!Number.isFinite(e.y)||!Number.isFinite(e.width)||!Number.isFinite(e.height)||e.width<=0||e.height<=0)throw new t(`COMMAND_FAILED`,`Android helper returned an invalid gesture viewport`);return e}const Fn=1e4;async function In(e,t){try{return await We(e,t)}catch(e){throw et(e)}}async function Ln(e){let{adb:t,adbProvider:n,packageName:r,versionCode:i,apkPath:a,sha256:o,cache:s,deviceKey:c,installTimeoutMs:l,helperLabel:u}=e,d=`${c}\0${r}\0${i}\0${o}`;if(s.has(d))return{packageName:r,versionCode:i,installedSha256:o,installed:!1,reason:`current`};await Wn(a,o,u);let f=await Rn({adb:t,adbProvider:n,packageName:r,versionCode:i,sha256:o});if(f.reason===`current`)return s.add(d),{packageName:r,versionCode:i,...f,installed:!1};let p=await In(a,{provider:n,replace:!0,allowFailure:!0,timeoutMs:l});if(p.exitCode!==0)throw T(`Failed to install ${u}`,p,{packageName:r,versionCode:i,reason:f.reason});return s.add(d),{packageName:r,versionCode:i,...f,installed:!0}}async function Rn(e){let{adb:t,adbProvider:n,packageName:r,versionCode:i,sha256:a,signal:o}=e,s=await Vn(t,r,o);if(s===void 0)return{reason:`missing`};if(s<i)return{installedVersionCode:s,reason:`outdated`};if(s>i)return{installedVersionCode:s,reason:`current`};try{let e=await Hn(t,n,r,o);return{installedVersionCode:s,installedSha256:e,reason:e===a?`current`:`mismatched`}}catch{return o?.throwIfAborted(),{installedVersionCode:s,reason:`unverifiable`}}}async function zn(e){let r=S().files,i=je(),a=D.join(Me(),`android`,e.helperDirName,`dist`),o=D.join(a,e.manifestFileName(i));try{let t=e.parseManifest(JSON.parse(await r.readText(o))),n=D.join(a,t.assetName);return await r.access(n),{apkPath:n,manifest:t}}catch(r){throw new t(`UNSUPPORTED_OPERATION`,e.unavailableMessage,{manifestPath:o,error:n(r).message},r)}}function Bn(e){return async t=>await Ln({adb:t.adb,adbProvider:t.adbProvider,packageName:t.artifact.manifest.packageName,versionCode:t.artifact.manifest.versionCode,apkPath:t.artifact.apkPath,sha256:t.artifact.manifest.sha256,cache:e.cache,deviceKey:t.deviceKey,installTimeoutMs:e.installTimeoutMs,helperLabel:e.helperLabel})}async function Vn(e,t,n){let r=await x(e,[`cmd`,`package`,`list`,`packages`,`--show-versioncode`,t],{allowFailure:!0,timeoutMs:5e3,signal:n});if(r.exitCode!==0)return;let i=RegExp(`package:${Kn(t)}(?:\\s|$).*versionCode:(\\d+)`).exec(`${r.stdout}\n${r.stderr}`);return i?Number(i[1]):void 0}async function Hn(e,n,r,i){let a=await x(e,[`pm`,`path`,r],{allowFailure:!0,timeoutMs:Fn,signal:i}),o=Un(`${a.stdout}\n${a.stderr}`);if(a.exitCode!==0||!o)throw new t(`COMMAND_FAILED`,`Could not resolve installed Android helper APK`);let s=S().files,c=await s.makeTempDirectory(`agent-device-helper-`),l=D.join(c,`base.apk`);try{let e=await Be(o,l,{provider:n,allowFailure:!0,timeoutMs:Fn,signal:i});if(e.exitCode!==0)throw T(`Could not read installed Android helper APK`,e,{packageName:r,remotePath:o});return await Gn(l)}finally{await s.remove(c,{recursive:!0,force:!0})}}function Un(e){return e.split(/\r?\n/).map(e=>e.startsWith(`package:`)?e.slice(8).trim():``).find(e=>e.endsWith(`/base.apk`))}async function Wn(e,n,r){let i=await Gn(e);if(i!==n)throw new t(`COMMAND_FAILED`,`${r} APK checksum mismatch`,{apkPath:e,expectedSha256:n,actualSha256:i})}async function Gn(e){let t=S().files;return t.sha256(await t.readBytes(e))}function Kn(e){return e.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`)}const qn=`android-snapshot-helper-v1`,Jn=`uiautomator-xml`,Yn=5e3,Xn=3e4;function Zn(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`Android snapshot helper manifest must be an object.`);let n=e;return{name:$n(n.name,`name`,`android-snapshot-helper`),version:j(n.version,`version`),releaseTag:tr(n.releaseTag),assetName:tr(n.assetName),apkUrl:nr(n.apkUrl,`apkUrl`),sha256:er(n.sha256),checksumName:tr(n.checksumName),packageName:j(n.packageName,`packageName`),versionCode:Qn(n.versionCode,`versionCode`),instrumentationRunner:j(n.instrumentationRunner,`instrumentationRunner`),minSdk:Qn(n.minSdk,`minSdk`),targetSdk:n.targetSdk===void 0?void 0:Qn(n.targetSdk,`targetSdk`),outputFormat:$n(n.outputFormat,`outputFormat`,Jn),statusProtocol:$n(n.statusProtocol,`statusProtocol`,qn)}}function Qn(e,t){return wn(e,t,`snapshot helper`)}function $n(e,t,n){return k(e,t,n,`snapshot helper`)}function er(e){let n=j(e,`sha256`).trim().toLowerCase();if(n.length!==64||!rr(n))throw new t(`INVALID_ARGS`,`Android snapshot helper manifest sha256 must be a 64-character hex string.`);return n}function j(e,n){if(typeof e!=`string`||e.trim().length===0)throw new t(`INVALID_ARGS`,`Android snapshot helper manifest ${n} is required.`);return e}function tr(e){return typeof e==`string`&&e.trim().length>0?e:void 0}function nr(e,t){return e===null?null:j(e,t)}function rr(e){for(let t of e){let e=t.charCodeAt(0);if(!(e>=48&&e<=57)&&!(e>=97&&e<=102))return!1}return!0}const M=new Map;function ir(e){let t=`${e.deviceKey}\0${e.packageName}\0${e.versionCode}\0`;for(let e of M.keys())e.startsWith(t)&&ur(e)}const ar=`android-snapshot-helper-not-current`;function or(e){return o(e).details?.reason===ar}function sr(){M.clear()}function cr(e,t,n,r){return e?`${e}\0${t}\0${n}\0${r}`:void 0}function lr(e,t){if(!e)return;let[n,r]=e.split(`\0`),i=`${n}\0${r}\0`;for(let t of M.keys())t!==e&&t.startsWith(i)&&M.delete(t);M.set(e,t)}function ur(e){e&&M.delete(e)}async function dr(e){let{adb:n,artifact:r}=e,i=e.installPolicy??`missing-or-outdated`,a=r.manifest.packageName,o=r.manifest.versionCode,s=r.manifest.sha256;if(i===`never`)return{packageName:a,versionCode:o,installed:!1,reason:`skipped`};let c=cr(e.deviceKey,a,o,s),l=c?M.get(c):void 0;if(c&&i!==`always`&&l!==void 0)return{packageName:a,versionCode:o,installedVersionCode:l,installedSha256:s,installed:!1,reason:`current`};await Wn(r.apkPath,s,`Android snapshot helper`);let u=i===`always`?{installedVersionCode:await mr(n,a,e.timeoutMs,e.signal),reason:`forced`}:await Rn({adb:n,adbProvider:pr(e.adbProvider,n),packageName:a,versionCode:o,sha256:s,signal:e.signal}),{installedVersionCode:d}=u,f=`installedSha256`in u?u.installedSha256:void 0,p=u.reason;if(p===`current`){if(d===void 0)throw Error(`Expected installed versionCode for current Android snapshot helper`);return lr(c,d),{packageName:a,versionCode:o,installedVersionCode:d,installedSha256:f,installed:!1,reason:p}}if(i===`current-only`)throw new t(`COMMAND_FAILED`,`Android snapshot helper is not installed at the current version`,{reason:ar,packageName:a,versionCode:o,installedVersionCode:d});let m;try{m=await hr(n,e.adbProvider??n,r.apkPath,{packageName:a,timeoutMs:e.timeoutMs,signal:e.signal})}catch(e){throw ur(c),fr(e,{packageName:a,versionCode:o})}if(m.exitCode!==0)throw ur(c),fr(T(`Failed to install Android snapshot helper`,m,{packageName:a,versionCode:o}));return lr(c,o),{packageName:a,versionCode:o,installedVersionCode:d,installedSha256:f,installed:!0,reason:p}}function fr(e,t){let n=o(e,`COMMAND_FAILED`);return n.details={...t,...n.details,androidSnapshotHelperInstallFailure:!0},n}function pr(e,t){return e?typeof e==`function`?{exec:e}:e:{exec:t}}async function mr(e,t,n,r){let i=await x(e,[`cmd`,`package`,`list`,`packages`,`--show-versioncode`,t],{allowFailure:!0,timeoutMs:n,signal:r});if(i.exitCode===0)return gr(`${i.stdout}\n${i.stderr}`,t)}async function hr(e,t,n,r){let i=async()=>await In(n,{allowFailure:!0,provider:t,replace:!0,timeoutMs:r.timeoutMs,signal:r.signal}),a=await i();if(a.exitCode===0||!_r(a))return a;let o=await e([`uninstall`,r.packageName],{allowFailure:!0,timeoutMs:r.timeoutMs,signal:r.signal}),s=await i();return s.exitCode===0?s:{...s,stderr:[s.stderr,o.stderr?`Previous uninstall stderr after INSTALL_FAILED_UPDATE_INCOMPATIBLE: ${o.stderr}`:``].filter(Boolean).join(`
+`)}}function gr(e,t){let n=`package:${t}`;for(let t of e.split(/\r?\n/)){if(!t.startsWith(n)||t.length>n.length&&!/\s/.test(t[n.length]??``))continue;let e=/(?:^|\s)versionCode:(\d+)(?:\s|$)/.exec(t);if(e)return Number(e[1])}}function _r(e){return`${e.stdout}\n${e.stderr}`.includes(`INSTALL_FAILED_UPDATE_INCOMPATIBLE`)}function vr(e){return e.errorType===`java.util.concurrent.TimeoutException`?`accessibility-timeout`:void 0}function yr(e){return e===137?`accessibility-timeout`:void 0}function br(e){return e?{androidCaptureFailureReason:e}:{}}function xr(){return new Promise((e,t)=>{let n=Vt.createServer();n.unref(),n.on(`error`,t),n.listen(0,`127.0.0.1`,()=>{let r=n.address();if(!r||typeof r==`string`){n.close(()=>t(Error(`Failed to allocate a local TCP port`)));return}let i=r.port;n.close(()=>e(i))})})}function Sr(e,n,r,i){return new Promise((a,o)=>{let s=Vt.connect({host:`127.0.0.1`,port:e}),c=[],l=setTimeout(()=>{u(),s.destroy(),o(new t(`COMMAND_FAILED`,`Android snapshot helper session request timed out`,{command:n,timeoutMs:r,port:e}))},r),u=()=>{clearTimeout(l),i?.removeEventListener(`abort`,d)},d=()=>{u(),s.destroy(),o(i?.reason??new DOMException(`The operation was aborted`,`AbortError`))};if(i?.addEventListener(`abort`,d,{once:!0}),i?.aborted){d();return}s.on(`connect`,()=>s.write(`${n}\n`)),s.on(`data`,e=>c.push(Buffer.from(e))),s.on(`error`,e=>{u(),o(e)}),s.on(`close`,()=>{u(),a(Buffer.concat(c).toString(`utf8`))})})}async function Cr(e){let t=`snapshot-${Date.now()}-${Math.random().toString(16).slice(2)}`;return kr(await Sr(e.port,`snapshot ${t}`,wr(e),e.signal),t)}function wr(e){return Math.min(e.commandTimeoutMs,Math.max(e.timeoutMs+3e3,3e3))}function Tr(e,n,r){return new Promise((i,a)=>{let o=``,s=setTimeout(()=>{r?.removeEventListener(`abort`,l),a(new t(`COMMAND_FAILED`,`Android snapshot helper session did not become ready`,{output:o,timeoutMs:n,reason:`android_snapshot_helper_session_ready_timeout`}))},n),c=e=>{o+=e.toString(),o.includes(`agentDeviceProtocol=android-snapshot-helper-v1`)&&o.includes(`sessionReady=true`)&&(clearTimeout(s),r?.removeEventListener(`abort`,l),i())},l=()=>{clearTimeout(s),a(r?.reason??new DOMException(`The operation was aborted`,`AbortError`))};if(r?.addEventListener(`abort`,l,{once:!0}),r?.aborted){l();return}e.stdout?.on(`data`,c),e.stderr?.on(`data`,c),e.once(`exit`,(e,n)=>{clearTimeout(s),r?.removeEventListener(`abort`,l),a(new t(`COMMAND_FAILED`,`Android snapshot helper session exited before ready`,{output:o,exitCode:e,signal:n,reason:`android_snapshot_helper_session_exited_before_ready`}))}),e.on(`error`,e=>{clearTimeout(s),r?.removeEventListener(`abort`,l),a(e)})})}function Er(e){let t=e.indexOf(`
 
-`);return Dr(e.slice(0,t<0?e.length:t))}function Sr(e,n){if(e.agentDeviceProtocol!==`android-snapshot-helper-v1`)throw new t(`COMMAND_FAILED`,`Android automation helper session returned wrong protocol`,{headers:e});if(e.requestId!==n)throw new t(`COMMAND_FAILED`,`Android automation helper session returned stale output`,{headers:e,requestId:n})}function Cr(e,t){let n=xr(e);return n.agentDeviceProtocol===`android-snapshot-helper-v1`&&n.requestId===t&&n.ok===`true`}function wr(e,n){let r=e.indexOf(`
+`);return Mr(e.slice(0,t<0?e.length:t))}function Dr(e,n){if(e.agentDeviceProtocol!==`android-snapshot-helper-v1`)throw new t(`COMMAND_FAILED`,`Android automation helper session returned wrong protocol`,{headers:e});if(e.requestId!==n)throw new t(`COMMAND_FAILED`,`Android automation helper session returned stale output`,{headers:e,requestId:n})}function Or(e,t){let n=Er(e);return n.agentDeviceProtocol===`android-snapshot-helper-v1`&&n.requestId===t&&n.ok===`true`}function kr(e,n){let r=e.indexOf(`
 
-`);if(r<0)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned malformed output`,{response:e});let i=Dr(e.slice(0,r)),a=e.slice(r+2);return Tr(i,n),Er(i,a),{xml:a,metadata:Or(i)}}function Tr(e,n){if(e.agentDeviceProtocol!==`android-snapshot-helper-v1`)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned wrong protocol`,{headers:e});if(e.outputFormat!==`uiautomator-xml`)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned wrong output format`,{headers:e});if(e.requestId!==n)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned stale output`,{headers:e,requestId:n});if(e.ok!==`true`)throw new t(`COMMAND_FAILED`,e.message||e.errorType||`Android snapshot helper session returned an error`,{helper:e,...hr(pr(e))})}function Er(e,n){let r=k(e.byteLength);if(r!==void 0&&Buffer.byteLength(n,`utf8`)!==r)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned truncated XML`,{headers:e,actualByteLength:Buffer.byteLength(n,`utf8`)});if(!n.includes(`<hierarchy`)||!n.includes(`</hierarchy>`))throw new t(`COMMAND_FAILED`,`Android snapshot helper session did not return XML`,{headers:e,xml:n})}function Dr(e){let t={};for(let n of e.split(/\r?\n/)){let e=n.indexOf(`=`);e<0||(t[n.slice(0,e)]=n.slice(e+1))}return t}function Or(e){return{helperApiVersion:e.helperApiVersion,outputFormat:Gn,waitForIdleTimeoutMs:k(e.waitForIdleTimeoutMs),waitForIdleQuietMs:k(e.waitForIdleQuietMs),timeoutMs:k(e.timeoutMs),maxDepth:k(e.maxDepth),maxNodes:k(e.maxNodes),rootPresent:A(e.rootPresent),captureMode:e.captureMode===`interactive-windows`||e.captureMode===`active-window`?e.captureMode:void 0,windowCount:k(e.windowCount),nodeCount:k(e.nodeCount),truncated:A(e.truncated),elapsedMs:k(e.elapsedMs)}}function N(e,n,r,i){if(i instanceof t){let a=i.details??{};return new t(i.code,i.message,{...a,action:e,package:r,tool:n,hint:typeof a.hint==`string`?a.hint:jr(n,a)},i)}return new t(`COMMAND_FAILED`,`Failed to ${e} Android ${n} for ${r}`,{action:e,package:r,tool:n,hint:kr(n)},i)}function kr(e){return e===`simpleperf`?`Verify simpleperf is available, the app process is running, and the app/device permits native CPU profiling.`:`Verify perfetto is available, the app process is running, and the device permits trace capture.`}function Ar(e){return e===`simpleperf`?`Use an emulator/system image with simpleperf available, or install the Android NDK simpleperf binary for this device.`:`Use Android 10+ or a system image that exposes the perfetto command-line binary.`}function jr(e,t){let n=(typeof t.stderr==`string`?t.stderr:``).toLowerCase();return e===`simpleperf`?Mr(n):Pr(n)?`Use a device image that permits perfetto trace capture for shell, keep the app running, then retry perf trace start.`:kr(e)}function Mr(e){return Nr(e)?`Use a debuggable/profileable Android app or a device image that permits simpleperf for the target process, then retry perf cpu profile start.`:e.includes(`not supported`)||e.includes(`failed to open perf event`)?`This device image does not expose the requested simpleperf event for the app process. Try a different emulator/system image or a profileable app.`:kr(`simpleperf`)}function Nr(e){return e.includes(`permission denied`)||e.includes(`not profileable`)||e.includes(`profileable`)}function Pr(e){return e.includes(`permission denied`)||e.includes(`not allowed`)}const Fr=`adb-shell-simpleperf`,Ir=`adb-shell-perfetto`,Lr=15e3,P=3e4,Rr=`/data/local/tmp`;async function zr(e,n){try{let t=await b(e,[`pidof`,n],{allowFailure:!0,timeoutMs:Lr}),r=Vr(t.stdout);if(t.exitCode===0&&r)return r}catch{}throw new t(`COMMAND_FAILED`,`No active Android app process found for ${n}`,{package:n,hint:`Run open <app> for this session again, wait for the app UI to appear, then retry perf.`})}async function Br(e,n,r){let i=await b(e,[_(`command -v ${v(n)} || which ${v(n)}`)],{allowFailure:!0,timeoutMs:Lr});if(!(i.exitCode===0&&i.stdout.trim()))throw new t(`UNSUPPORTED_OPERATION`,`Android device does not expose ${n}`,{package:r,tool:n,hint:Ar(n)})}function Vr(e){return e.trim().split(/\s+/).find(e=>/^\d+$/.test(e))}const Hr=2e3,Ur=`android_snapshot_helper_runtime_occupied`,F=new Map;function Wr(e){return`${e.platform}:${e.id}`}async function Gr(e){await ii({adb:e.adb,packageName:e.packageName}),await qr({deviceKey:e.deviceKey,packageName:e.packageName,adb:e.adb,cause:e.cause})}async function Kr(e){let t=F.get(e.deviceKey);if(!t)return;await ii({adb:e.adb,packageName:t.packageName,timeoutMs:5e3,...e.signal?{signal:e.signal}:{}}),e.signal?.throwIfAborted();let n=await Xr({adb:e.adb,packageName:t.packageName});if(n===`occupied`&&(await g(250),n=await Xr({adb:e.adb,packageName:t.packageName})),n===`occupied`)throw Yr({deviceKey:e.deviceKey,packageName:t.packageName,cause:t.cause});n!==`unknown`&&F.delete(e.deviceKey)}async function qr(e){let t=e.release??await Xr({adb:e.adb,packageName:e.packageName});if(t===`released`)return F.delete(e.deviceKey),t;let n=e.cause instanceof Error?e.cause.message:String(e.cause);return F.set(e.deviceKey,{packageName:e.packageName,cause:n}),h({level:`warn`,phase:`android_snapshot_helper_retirement_pending`,data:{deviceKey:e.deviceKey,packageName:e.packageName,release:t}}),t}function Jr(e){return e instanceof t&&e.details?.reason===Ur}function Yr(e){let n=e.cause instanceof Error?e.cause.message:String(e.cause);return new t(`COMMAND_FAILED`,`Android automation helper is still holding device automation ownership`,{reason:Ur,deviceKey:e.deviceKey,packageName:e.packageName,cause:n,hint:`Retry after the helper process exits, or restart the device if Android keeps reporting the helper as running.`})}async function Xr(e){try{let t=await b(e.adb,[`pidof`,e.packageName,_(`|| echo AGENT_DEVICE_NO_HELPER`)],{allowFailure:!0,timeoutMs:Hr}),n=t.stdout.trim();return Vr(n)?`occupied`:n===`AGENT_DEVICE_NO_HELPER`&&t.stderr.trim().length===0?`released`:`unknown`}catch{return`unknown`}}async function Zr(e){let t=AbortSignal.timeout(e.timeoutMs);return await Promise.all([...e.forceStopRuntime?[ii({adb:e.adb,packageName:e.packageName,timeoutMs:e.timeoutMs,signal:t})]:[],ai({...e,signal:t})]),{timedOut:t.aborted}}function Qr(e){let t=$r(e);return{ended:t?Promise.resolve():new Promise(t=>{e.once(`close`,()=>t()),e.once(`exit`,()=>t())}),hasEnded:()=>$r(e),completedCleanly:()=>!t&&e.exitCode===0&&e.signalCode==null}}function $r(e){return e.exitCode!=null||e.signalCode!=null}async function ei(e,t,n){let r,i,a=await Promise.race([e.then(()=>!0),new Promise(e=>{r=setTimeout(()=>e(!1),t)}),...n?[new Promise(e=>{i=()=>e(!1),n.addEventListener(`abort`,i,{once:!0}),n.aborted&&i()})]:[]]);return r&&clearTimeout(r),i&&n?.removeEventListener(`abort`,i),a}async function ti(e){if(e.processExit.hasEnded())return!0;try{e.process.kill(`SIGTERM`)}catch{}return await ei(e.processExit.ended,e.timeoutMs)}function ni(e){F.delete(e)}function ri(){F.clear()}async function ii(e){await b(e.adb,[`am`,`force-stop`,e.packageName],{allowFailure:!0,timeoutMs:e.timeoutMs??2e3,...e.signal?{signal:e.signal}:{}}).catch(()=>{})}async function ai(e){e.process.stdin?.end(),e.process.stdout?.destroy(),e.process.stderr?.destroy(),await e.adb([`forward`,`--remove`,`tcp:${e.port}`],{allowFailure:!0,timeoutMs:e.timeoutMs,signal:e.signal})}async function oi(e){let n=ci(e),r=e.deviceKey??`android:default`;await Kr({deviceKey:r,adb:e.adb,signal:e.signal});let i;try{i=await e.adb(li(n),{allowFailure:!0,timeoutMs:n.commandTimeoutMs,signal:e.signal})}catch(t){throw e.signal?.aborted?(await Gr({deviceKey:r,packageName:n.packageName,adb:e.adb,cause:t}),e.signal.throwIfAborted(),t):t}e.signal?.aborted&&(await Gr({deviceKey:r,packageName:n.packageName,adb:e.adb,cause:e.signal.reason}),e.signal.throwIfAborted());let{output:a,cleanupDone:o}=await ui(e,n,i);if(n.outputPath&&!o&&await _i(e.adb,n.outputPath),i.exitCode!==0)throw new t(`COMMAND_FAILED`,`Android snapshot helper failed`,Te(i,{helper:a.metadata}));return a}function si(e){return{adb:e.adb,adbProvider:e.adbProvider,deviceKey:e.deviceKey,helperVersion:e.artifact.manifest.version,helperVersionCode:e.artifact.manifest.versionCode,helperSha256:e.artifact.manifest.sha256,packageName:e.artifact.manifest.packageName,instrumentationRunner:e.artifact.manifest.instrumentationRunner,waitForIdleTimeoutMs:500,timeoutMs:Kn,commandTimeoutMs:qn,...e.signal?{signal:e.signal}:{}}}function ci(e){let t=I(e.timeoutMs,8e3),n=I(e.packageName,`com.callstack.agentdevice.snapshothelper`);return{waitForIdleTimeoutMs:I(e.waitForIdleTimeoutMs,500),waitForIdleQuietMs:I(e.waitForIdleQuietMs,100),timeoutMs:t,commandTimeoutMs:I(e.commandTimeoutMs,t+5e3),maxDepth:I(e.maxDepth,128),maxNodes:I(e.maxNodes,5e3),packageName:n,runner:I(e.instrumentationRunner,`${n}/.SnapshotInstrumentation`),...e.outputPath?{outputPath:e.outputPath}:{},...e.emitChunks===void 0?{}:{emitChunks:e.emitChunks}}}function I(e,t){return e===void 0?t:e}function li(e,t={}){return Oe(`adb`,`shell`,[`am`,`instrument`,`-w`,`-e`,`waitForIdleTimeoutMs`,String(e.waitForIdleTimeoutMs),`-e`,`waitForIdleQuietMs`,String(e.waitForIdleQuietMs),`-e`,`timeoutMs`,String(e.timeoutMs),`-e`,`maxDepth`,String(e.maxDepth),`-e`,`maxNodes`,String(e.maxNodes),...e.outputPath?[`-e`,`outputPath`,e.outputPath]:[],...e.emitChunks===void 0?[]:[`-e`,`emitChunks`,String(e.emitChunks)],...t.sessionPort===void 0?[]:[`-e`,`sessionPort`,t.sessionPort],e.runner])}async function ui(e,t,n){try{return{output:vi(`${n.stdout}\n${n.stderr}`),cleanupDone:!1}}catch(r){return await di(e,t,n,r)}}async function di(e,n,r,i){if(i instanceof t&&r.exitCode!==0&&i.details?.helper)throw i;let a=await fi(e,n,r);if(a)return{output:a,cleanupDone:!0};throw new t(`COMMAND_FAILED`,r.exitCode===0?`Android snapshot helper output could not be parsed`:`Android snapshot helper failed before returning parseable output`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode,...hr(mr(r.exitCode))},i)}async function fi(e,t,n){if(!(n.exitCode!==0||!t.outputPath))return await mi(e.adb,t.outputPath,gi(`${n.stdout}\n${n.stderr}`)??pi(t))}function pi(e){return{outputFormat:Gn,waitForIdleTimeoutMs:e.waitForIdleTimeoutMs,waitForIdleQuietMs:e.waitForIdleQuietMs,timeoutMs:e.timeoutMs,maxDepth:e.maxDepth,maxNodes:e.maxNodes,transport:`instrumentation`}}async function mi(e,t,n){let r;try{r=await b(e,hi(t),{allowFailure:!0,timeoutMs:5e3})}catch{return}if(r.exitCode!==0)return;let i=r.stdout.trim();if(!(!i.includes(`<hierarchy`)||!i.includes(`</hierarchy>`)))return{xml:i,metadata:n}}function hi(e){return[`sh`,`-c`,`cat "$1"; status=$?; rm -f "$1"; exit "$status"`,`agent-device-snapshot-helper-output`,e]}function gi(e){try{return Ei(bi(Tn(e).results))}catch{return null}}async function _i(e,t){try{await b(e,[`rm`,`-f`,t],{allowFailure:!0,timeoutMs:5e3})}catch{}}function vi(e){let t=Tn(e),n=bi(t.results);return{xml:Si(yi(t.status),n),metadata:{...Ei(n),transport:`instrumentation`}}}function yi(e){let t=[];for(let n of e){if(n.agentDeviceProtocol!==`android-snapshot-helper-v1`||n.outputFormat!==`uiautomator-xml`)continue;let{payloadBase64:e}=n;e!==void 0&&t.push({index:L(n.chunkIndex),count:L(n.chunkCount),payloadBase64:e})}return t}function bi(e){let n=e.find(e=>e.agentDeviceProtocol===Wn);if(!n)throw new t(`COMMAND_FAILED`,`Android snapshot helper did not return a final result`);if(n.ok!==`true`)throw new t(`COMMAND_FAILED`,xi(n),{errorType:n.errorType,helper:n,...hr(pr(n))});return n}function xi(e){return e.message&&e.message!==`null`?e.message:e.errorType||`Android snapshot helper returned an error`}function Si(e,n){if(e.length===0)throw new t(`COMMAND_FAILED`,`Android snapshot helper did not return XML chunks`,{helper:n});let r=Ci(e),i=Buffer.concat(Ti(wi(e,r),r)).toString(`utf8`);if(!i.includes(`<hierarchy`)||!i.includes(`</hierarchy>`))throw new t(`COMMAND_FAILED`,`Android snapshot helper output did not contain XML`,{xml:i});return i}function Ci(e){let n=e[0]?.count??e.length;if(n<1||e.length!==n||e.some(e=>e.count!==n))throw new t(`COMMAND_FAILED`,`Android snapshot helper returned incomplete XML chunks`,{expectedChunks:n,actualChunks:e.length});return n}function wi(e,n){let r=new Map;for(let i of e){if(i.index===void 0||i.index<0||i.index>=n)throw new t(`COMMAND_FAILED`,`Android snapshot helper returned invalid chunk index`,{chunkIndex:i.index,expectedChunks:n});if(r.has(i.index))throw new t(`COMMAND_FAILED`,`Android snapshot helper returned duplicate XML chunks`,{chunkIndex:i.index});r.set(i.index,i.payloadBase64)}return r}function Ti(e,n){let r=[];for(let i=0;i<n;i+=1){let a=e.get(i);if(a===void 0)throw new t(`COMMAND_FAILED`,`Android snapshot helper returned incomplete XML chunks`,{missingChunkIndex:i,expectedChunks:n});r.push(Buffer.from(a,`base64`))}return r}function Ei(e){return{helperApiVersion:e.helperApiVersion,outputFormat:Gn,waitForIdleTimeoutMs:L(e.waitForIdleTimeoutMs),waitForIdleQuietMs:L(e.waitForIdleQuietMs),timeoutMs:L(e.timeoutMs),maxDepth:L(e.maxDepth),maxNodes:L(e.maxNodes),rootPresent:Oi(e.rootPresent),captureMode:Di(e.captureMode),windowCount:L(e.windowCount),nodeCount:L(e.nodeCount),truncated:Oi(e.truncated),elapsedMs:L(e.elapsedMs)}}function Di(e){return e===`interactive-windows`||e===`active-window`?e:void 0}const L=k,Oi=A,ki=5e3,R=new Map,z=new Map;async function Ai(e){return await ji(e)!==void 0}async function ji(e){let t=e.deviceKey??`android:default`;if(await Kr({deviceKey:t,adb:e.adb,signal:e.signal}),!Ui()||!e.adbProvider?.spawn)return;let n=ci(e),r=Vi(n),i=await Ni({deviceKey:t,identity:Bi(t,r,e),options:e,resolved:r,startBudgetMs:Hi(n.commandTimeoutMs)});return i?{session:i,resolved:r,deviceKey:t}:void 0}function Mi(e){return R.get(e)}async function Ni(e){if(!Ii(e.identity))return await Pi(e.deviceKey,e.identity),R.get(e.deviceKey)??await Fi(e)}async function Pi(e,t){let n=R.get(e);!n||Ri(n,t)||await B(e,{force:$r(n.process)})}async function Fi(e){let n=Date.now();try{return await zi(e)}catch(r){e.options.signal?.throwIfAborted(),z.set(e.identity,Date.now()+Li(Date.now()-n)),h({level:`warn`,phase:`android_snapshot_helper_session_start_failed`,data:{deviceKey:e.deviceKey,reason:r instanceof t?r.details?.reason:void 0,detail:r instanceof Error?r.message:String(r)}});return}}function Ii(e){let t=z.get(e);return t===void 0?!1:t>Date.now()||(z.delete(e),!1)}function Li(e){return Math.min(Math.max(e,1e4),6e4)}function Ri(e,t){return e.identity===t&&!$r(e.process)}async function zi(e){let t=await gr();await e.options.adb([`forward`,`tcp:${t}`,`tcp:${t}`],{allowFailure:!1,timeoutMs:ki,signal:e.options.signal});let n=li({...e.resolved,outputPath:void 0,emitChunks:!1},{sessionPort:t}),r=e.options.adbProvider.spawn(n,{allowFailure:!0,captureOutput:!1}),i={identity:e.identity,deviceKey:e.deviceKey,helper:{packageName:e.resolved.packageName,runner:e.resolved.runner,helperVersion:e.options.helperVersion,helperVersionCode:e.options.helperVersionCode,sha256:e.options.helperSha256},port:t,adb:e.options.adb,process:r,startedAtMs:Date.now(),capturedCount:0};try{return await br(r,e.startBudgetMs,e.options.signal),R.set(e.deviceKey,i),z.delete(e.identity),ni(e.deviceKey),h({phase:`android_snapshot_helper_session_ready`,data:{deviceKey:e.deviceKey,port:t,packageName:e.resolved.packageName,runner:e.resolved.runner}}),i}catch(t){let n=Qr(r);try{r.kill(`SIGTERM`)}catch{}throw await Promise.all([ei(n.ended,250),Zr({adb:i.adb,process:i.process,port:i.port,packageName:i.helper.packageName,timeoutMs:Hr,forceStopRuntime:!0})]),await qr({deviceKey:e.deviceKey,packageName:i.helper.packageName,adb:i.adb,cause:t}),t}}function Bi(e,t,n){return JSON.stringify({deviceKey:e,packageName:t.packageName,runner:t.runner,helperVersion:n.helperVersion,helperVersionCode:n.helperVersionCode,helperSha256:n.helperSha256,waitForIdleTimeoutMs:t.waitForIdleTimeoutMs,waitForIdleQuietMs:t.waitForIdleQuietMs,timeoutMs:t.timeoutMs,maxDepth:t.maxDepth,maxNodes:t.maxNodes})}function Vi(e){let t=Math.min(e.timeoutMs,2e3);return{...e,timeoutMs:t,commandTimeoutMs:Math.min(e.commandTimeoutMs,t+3e3)}}function Hi(e){return Math.min(e,Math.max(Math.floor(e/2),5e3))}function Ui(){let e=x().environment.AGENT_DEVICE_ANDROID_SNAPSHOT_HELPER_SESSION;return e===void 0||!/^(0|false|no|off)$/i.test(e)}async function B(e,t={}){let n=R.get(e);if(!n)return!1;R.delete(e);let r=Qr(n.process),i=t.force===!0||t.signal?.aborted===!0,a=await Wi(n,r,i,t.signal),o=r.hasEnded(),s=a.acknowledged&&a.exited,c=s&&await Ht({adb:n.adb,deviceKey:e,signal:t.signal}),l=i?t.signal?.aborted===!0?250:Hr:ki,u=i?250:2e3,[d,f]=await Promise.all([ti({process:n.process,processExit:r,timeoutMs:u}),Zr({adb:n.adb,process:n.process,port:n.port,packageName:n.helper.packageName,timeoutMs:l,forceStopRuntime:t.resetRuntime===!0||!c})]),p=await qr({deviceKey:e,packageName:n.helper.packageName,adb:n.adb,cause:t.cause,...c?{release:`released`}:{}});return h({phase:`android_snapshot_helper_session_stop`,data:{deviceKey:e,port:n.port,capturedCount:n.capturedCount,lifetimeMs:Date.now()-n.startedAtMs,quitAcknowledged:a.acknowledged,quitExitObserved:s,releaseProvenByQuit:c,release:p,forceKilled:!o&&d,forced:i||t.signal?.aborted===!0,externalCleanupTimedOut:f.timedOut}}),!0}async function Wi(e,t,n,r){if(n)return{acknowledged:!1,exited:!1};let i=`quit-${Date.now()}`;try{let n=Cr(await _r(e.port,`quit ${i}`,1e3,r),i);return{acknowledged:n,exited:n&&await ei(t.ended,11e3,r)&&t.completedCleanly()}}catch{return{acknowledged:!1,exited:!1}}}async function Gi(e){await B(Wr(e))}async function Ki(){try{await Promise.allSettled([...R.keys()].map(async e=>{await B(e)}))}finally{R.clear(),z.clear(),ri(),Ut()}}async function qi(e){let t=await ji(e);if(t)return await Ji({session:t.session,deviceKey:t.deviceKey,options:e,resolved:t.resolved})}async function Ji(e){let{session:t,deviceKey:n,options:r,resolved:i}=e;try{let e=t.capturedCount>0,n=await vr({port:t.port,timeoutMs:i.timeoutMs,commandTimeoutMs:i.commandTimeoutMs,signal:r.signal});return t.capturedCount+=1,{xml:n.xml,metadata:{...n.metadata,transport:`persistent-session`,sessionReused:e}}}catch(e){await B(n,{force:!0,signal:r.signal,cause:e}),r.signal?.throwIfAborted(),h({level:`warn`,phase:`android_snapshot_helper_session_fallback`,data:{deviceKey:n,reason:e instanceof Error?e.message:String(e),uiAutomationConnectionTimeout:ct(e)===`accessibility-timeout`}});return}}async function Yi(e){let n=Mi(e.deviceKey);if(!n)return;if(!Xi(n.helper,e.helper)){h({level:`warn`,phase:`android_snapshot_helper_session_touch_identity_mismatch`,data:{deviceKey:e.deviceKey,sessionHelper:n.helper,requestedHelper:e.helper}}),await B(e.deviceKey);return}let r=`${e.action}-${Date.now()}-${Math.random().toString(16).slice(2)}`,i=e.payloadBase64?`${e.action} ${r} ${e.payloadBase64}`:`${e.action} ${r}`,a;try{a=xr(await _r(n.port,i,e.timeoutMs)),Sr(a,r)}catch(t){throw await B(e.deviceKey),t}if(a.ok!==`true`)throw new t(`COMMAND_FAILED`,a.message||a.errorType||`Android automation helper ${e.action} failed`,{errorType:a.errorType,helper:a});return a}function Xi(e,t){return e.packageName===t.packageName&&e.runner===t.runner&&Zi(e.helperVersion,t.helperVersion)&&Zi(e.helperVersionCode,t.helperVersionCode)&&Zi(e.sha256,t.sha256)}function Zi(e,t){return e===void 0||t===void 0||e===t}const Qi=`android-touch-plan-v1`,$i=45e3,ea=`ANDROID_TOUCH_HELPER_NO_FINAL_RESULT`,ta=`ANDROID_TOUCH_HELPER_REPORTED_FAILURE`;async function na(e,t){let n=await aa(e),r=sa(t),i=Math.max(45e3,r.durationMs+15e3),a=Buffer.from(JSON.stringify({protocol:Qi,...r})).toString(`base64`),o=await m(`android_touch_helper_gesture`,async()=>{let e=await Yi({deviceKey:n.deviceKey,action:`gesture`,helper:ia(n.artifact),payloadBase64:a,timeoutMs:i});return e?{...da(e),helperTransport:`persistent-session`}:{...await la({adb:n.adb,runner:n.artifact.manifest.instrumentationRunner,extraArgs:[`-e`,`mode`,`gesture`,`-e`,`payloadBase64`,a],timeoutMs:i,readResult:da}),helperTransport:`instrumentation`}},{packageName:n.artifact.manifest.packageName,version:n.artifact.manifest.version});return{backend:`android-helper`,helperVersion:n.artifact.manifest.version,installReason:n.install.reason,...o}}async function ra(e,t={}){let n=await aa(e);t.helperSessionScope===`daemon-session`&&await Ai(si({adb:n.adb,adbProvider:n.adbProvider,artifact:n.artifact,deviceKey:n.deviceKey}));try{let e=await Yi({deviceKey:n.deviceKey,action:`viewport`,helper:ia(n.artifact),timeoutMs:$i});if(e)return fa(e)}catch(e){await B(n.deviceKey),h({level:`warn`,phase:`android_touch_helper_viewport_session_fallback`,data:{reason:e instanceof Error?e.message:String(e)}})}return await la({adb:n.adb,runner:n.artifact.manifest.instrumentationRunner,extraArgs:[`-e`,`mode`,`viewport`],timeoutMs:$i,readResult:fa})}function ia(e){return{packageName:e.manifest.packageName,runner:e.manifest.instrumentationRunner,helperVersion:e.manifest.version,helperVersionCode:e.manifest.versionCode,sha256:e.manifest.sha256}}async function aa(e){let t=C(e),n=t.snapshotHelperArtifact??await oa(),r=Wr(e);await Kr({deviceKey:r,adb:t.exec});let i=await m(`android_touch_helper_install`,async()=>await or({adb:t.exec,adbProvider:t,artifact:n,deviceKey:r,timeoutMs:3e4}),{packageName:n.manifest.packageName,versionCode:n.manifest.versionCode});return h({phase:`android_touch_helper_install_decision`,data:i}),i.installed&&await B(r),{adb:t.exec,adbProvider:t,artifact:n,install:i,deviceKey:r}}async function oa(){return await In({helperDirName:`snapshot-helper`,manifestFileName:e=>`agent-device-android-snapshot-helper-${e}.manifest.json`,parseManifest:e=>{let t=Jn(e);return{...t,assetName:t.assetName??`agent-device-android-snapshot-helper-${t.version}.apk`}},unavailableMessage:`Android touch gestures require the bundled Android automation helper artifact, but it was not found or could not be read`})}function sa(e){return{kind:e.topology===`single`?`swipe`:`transform`,durationMs:e.durationMs,pointers:e.pointers.map(ca)}}function ca(e){return{pointerId:e.pointerId,samples:e.samples.map(({offsetMs:e,point:t})=>({offsetMs:e,x:t.x,y:t.y}))}}async function la(e){let n=await b(e.adb,[`am`,`instrument`,`-w`,...e.extraArgs,e.runner],{allowFailure:!0,timeoutMs:e.timeoutMs}),r;try{r=ua(`${n.stdout}\n${n.stderr}`)}catch(e){if(e instanceof t){if(e.code===ta)throw new t(`COMMAND_FAILED`,e.message,e.details,e);if(e.code!==ea)throw e}throw new t(`COMMAND_FAILED`,n.exitCode===0?`Android automation helper output could not be parsed`:`Android automation helper failed before returning parseable output`,Te(n),e)}if(n.exitCode!==0)throw new t(`COMMAND_FAILED`,`Android automation helper failed`,Te(n,{helper:r}));return e.readResult(r)}function ua(e){let n=Tn(e).results.find(e=>e.agentDeviceProtocol===Wn);if(!n)throw new t(ea,`Android automation helper did not return a final result`);if(n.ok!==`true`)throw new t(ta,n.message&&n.message!==`null`?n.message:n.errorType||`Android automation helper returned an error`,{errorType:n.errorType,helper:n});return n}function da(e){return{helperKind:e.kind,helperApiVersion:e.helperApiVersion,injectedEvents:k(e.injectedEvents),elapsedMs:k(e.elapsedMs)}}function fa(e){let n=k(e.x),r=k(e.y),i=k(e.width),a=k(e.height);if(n===void 0||r===void 0||i===void 0||a===void 0)throw new t(`COMMAND_FAILED`,`Android helper returned an invalid gesture viewport`);let o=pa(e);return{viewport:jn({x:n,y:r,width:i,height:a}),...o?{keyboard:o}:{}}}function pa(e){let t=k(e.keyboardX),n=k(e.keyboardY),r=k(e.keyboardWidth),i=k(e.keyboardHeight);if(t!==void 0&&n!==void 0&&r!==void 0&&i!==void 0)return{x:t,y:n,width:r,height:i}}function ma(e){if(e.topology===`two`||e.intent===`longPress`)return e;let{releaseBehavior:t,...n}=e,[{pointerId:r,samples:i}]=n.pointers,a=[...new Set([...rt(e.durationMs,`android`),...i.map(({offsetMs:e})=>e)])].sort((e,t)=>e-t),o=0,s=a.map(e=>{for(;o<i.length-2&&e>i[o+1].offsetMs;)o+=1;let n=i[o],r=i[o+1],a=r.offsetMs-n.offsetMs,s=(e-n.offsetMs)/a;return{offsetMs:e,point:e===r.offsetMs||a===0?r.point:at(n.point,r.point,t===`controlled`?ha(s,a):s)}}),c=[s[0],s[1],s[2],...s.slice(3)];return{...n,pointers:[{pointerId:r,samples:c}]}}function ha(e,t){let n=Math.min(16/t,.5);return e<n?e**2/n:1-(1-e)**2/(1-n)}async function ga(e,t){let n=ma(t),r=Pe(e);if(r){let e=n.intent===`longPress`?{...n,viewport:jn(await r.gestureViewport())}:n;return{backend:`provider-native-touch`,...await r.touch(e)??{}}}return await na(e,n)}async function _a(e,t={}){return(await va(e,t)).viewport}async function va(e,t={}){let n=Pe(e);return n?{viewport:jn(await n.gestureViewport())}:await ra(e,t)}async function ya(e,t,n){await T(e,[`input`,`tap`,t,n])}async function ba(e,t,n){let r=De(t);await T(e,[`input`,...n&&n>0?[`keyevent`,`--longpress`]:[`keyevent`],r])}async function xa(e){await T(e,[`input`,`keyevent`,`4`])}async function Sa(e){await T(e,[`input`,`keyevent`,`3`])}async function Ca(e){await T(e,[`input`,`keyevent`,`ENTER`])}async function wa(e,t){let n=Pa(t);await T(e,[`settings`,`put`,`system`,`accelerometer_rotation`,`0`]),await T(e,[`settings`,`put`,`system`,`user_rotation`,n]),await Ea(e,t,n)}const Ta=15e3;async function Ea(e,n,r){let i=Date.now()+Ta,a=await Da(e,n,i);for(;a!==void 0&&a!==r&&Date.now()<i;)await g(Math.min(500,Oa(i))),a=await Da(e,n,i);if(a!==void 0&&a!==r)throw new t(`COMMAND_FAILED`,`orientation ${n} did not take effect: the display still reports rotation ${a} after ${Ta}ms`,{requestedRotation:Number(r),observedRotation:Number(a),hint:"The foreground app may pin its orientation, or the device may ignore user_rotation. Check `adb shell dumpsys display | grep mCurrentOrientation` and the app manifest."})}async function Da(e,n,r){try{let t=await T(e,[`dumpsys`,`display`],{timeoutMs:Oa(r)});return/mCurrentOrientation=(\d)/.exec(t.stdout)?.[1]}catch(e){throw new t(`COMMAND_FAILED`,`orientation ${n} could not confirm the display rotation: ${e instanceof Error?e.message:String(e)}`,{hint:"The device did not answer `dumpsys display` within the orientation budget."})}}function Oa(e){return Math.max(1,e-Date.now())}async function ka(e){await T(e,[`input`,`keyevent`,`187`])}async function Aa(e,t,n,r=800){let i={x:t,y:n};return await ga(e,{topology:`single`,intent:`longPress`,durationMs:r,pointers:[{pointerId:0,samples:[{offsetMs:0,point:i},{offsetMs:r,point:i}]}]})}async function ja(e,t,n){await ya(e,t,n)}async function Ma(e,t,n){let{viewport:r,keyboard:i}=await va(e,{helperSessionScope:n?.helperSessionScope}),a=Na(t,r,i),o=ue({direction:t,amount:n?.amount,pixels:n?.pixels,referenceWidth:a.viewport.width,referenceHeight:a.viewport.height}),s={...o,referenceWidth:a.viewport.x+a.viewport.width,referenceHeight:a.viewport.y+a.viewport.height,x1:a.viewport.x+o.x1,y1:a.viewport.y+o.y1,x2:a.viewport.x+o.x2,y2:a.viewport.y+o.y2},c=Math.max(n?.durationMs??300,16),l=await ga(e,{...it({intent:`pan`,origin:{x:s.x1,y:s.y1},delta:{x:s.x2-s.x1,y:s.y2-s.y1},durationMs:c},a.viewport,`android`),releaseBehavior:n?.releaseBehavior??`controlled`});return{...s,...a.evidence,...n?.durationMs===void 0?{}:{durationMs:c},...l}}function Na(e,t,n){if(n===void 0)return{viewport:t,evidence:{}};let r=de(t,n);if(r.kind===`occluded`)throw le(e,{keyboardMinY:r.keyboardMinY,visibleHeight:r.visibleHeight,viewportHeight:t.height});return r.kind===`avoided`?{viewport:r.viewport,evidence:{keyboardAvoided:!0,keyboardMinY:r.keyboardMinY}}:{viewport:t,evidence:{}}}function Pa(e){let n=xe[e];if(n===void 0)throw new t(`INVALID_ARGS`,`Unsupported Android rotation: ${e}`);return String(n)}async function Fa(e){let n=(await T(e,[`wm`,`size`])).stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(!n)throw new t(`COMMAND_FAILED`,`Unable to read screen size`);return{width:Number(n[1]),height:Number(n[2])}}async function Ia(e,t,n){return t===`wait`?await La(n.captureNodes,n.timeoutMs??1e4):t===`get`?Ua((await Ha(n.captureNodes))?.alert??null):await Ra(e,t,n.captureNodes)}async function La(e,n){let r=Date.now(),i=await Va(e,n);if(!i)throw new t(`COMMAND_FAILED`,`alert wait timed out`);return{kind:`alertWait`,platform:`android`,action:`wait`,alert:i.alert,waitedMs:Date.now()-r,...fe(`Alert visible`)}}async function Ra(e,n,r){let i=await Va(r,pe);if(!i)throw new t(`COMMAND_FAILED`,`alert not found`,{hint:`If a sheet is visible in snapshot but alert reports no alert, it is likely app-owned UI. Use snapshot -i and press the visible label/ref.`});let a=rn(i.buttons,n);if(a)return await ya(e,a.x,a.y),await za(i.alert,n,r),Wa(n,i.alert,a.label,{x:a.x,y:a.y});if(n===`dismiss`)return await xa(e),await za(i.alert,n,r),Wa(n,i.alert,`Back`);throw new t(`COMMAND_FAILED`,`alert accept found an alert but no accept button`,{alert:i.alert,hint:`Inspect alert get --json for visible buttons, then use press by visible label/ref if needed.`})}async function za(e,n,r){let i=Date.now();for(;;){let a=await Ha(r);if(!a||!Ba(a.alert,e))return;if(Date.now()-i>=2e3)throw new t(`COMMAND_FAILED`,`alert ${n} did not dismiss the visible alert`,{alert:e,hint:`The alert button was pressed but the dialog is still visible. Inspect alert get --json, then press the visible button by label/ref or retry.`});await g(300)}}function Ba(e,t){return e.title===t.title&&e.buttons.join(`\0`)===t.buttons.join(`\0`)}async function Va(e,t){let n=Date.now();for(;Date.now()-n<t;){let t=await Ha(e);if(t)return t;await g(300)}return null}async function Ha(e){return tn(await m(`snapshot_capture`,e,{backend:`android`,purpose:`alert`}))}function Ua(e){return{kind:`alertStatus`,platform:`android`,action:`get`,alert:e,...fe(e?`Alert visible`:`No alert visible`)}}function Wa(e,t,n,r){return{kind:`alertHandled`,platform:`android`,action:e,handled:!0,alert:t,button:n,...r?{coordinates:r}:{},...fe(`Alert ${e}ed`)}}const Ga=`android.intent.category.LAUNCHER`,Ka=`android.intent.category.DEFAULT`;async function qa(e,t){await b(e,[`am`,`force-stop`,t])}async function Ja(e,t,n=[Ga]){for(let r of n){let n=await b(e,[`cmd`,`package`,`resolve-activity`,`--brief`,`-a`,`android.intent.action.MAIN`,`-c`,r,t],{allowFailure:!0});if(n.exitCode!==0)continue;let i=mt(n.stdout);if(i)return i}return null}async function Ya(e,n,r={}){let i=r.category??Ga;if(r.activity){await b(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Ka,`-c`,i,`-n`,Xa(n,r.activity)]);return}let a=await b(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Ka,`-c`,i,`-p`,n],{allowFailure:!0});if(a.exitCode===0&&!ht(a.stdout,a.stderr))return;let o=await Ja(e,n,[i]);if(!o)throw new t(`COMMAND_FAILED`,`Failed to resolve Android launch component for ${n}`,{stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode});await b(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Ka,`-c`,i,`-n`,o])}function Xa(e,t){return t.includes(`/`)?t:`${e}/${t.startsWith(`.`)?t:`.${t}`}`}let Za=null;function Qa(e){return`${e.PATH??``}::${e.AGENT_DEVICE_BUNDLETOOL_JAR??``}`}async function $a(e){let n=Qa(e);if(Za?.key===n)return Za.invocation;if(await we(`bundletool`)){let e={cmd:`bundletool`,prefixArgs:[]};return Za={key:n,invocation:e},e}let r=await Ee(e.AGENT_DEVICE_BUNDLETOOL_JAR,`AGENT_DEVICE_BUNDLETOOL_JAR`);if(!r)throw new t(`TOOL_MISSING`,`bundletool not found in PATH. Install bundletool or set AGENT_DEVICE_BUNDLETOOL_JAR to a bundletool-all.jar path.`);let i={cmd:`java`,prefixArgs:[`-jar`,r]};return Za={key:n,invocation:i},i}async function eo(e,t,n){let r=await $a(n);await Ce(r.cmd,[...r.prefixArgs,...e],{signal:t})}function to(e){return E.extname(e).toLowerCase()===`.aab`}async function no(e,t,n={}){let r=C(e),i=`universal`;if(r.installBundle){await r.installBundle(t,{mode:i,signal:n.signal});return}let a=x().files,o=await a.makeTempDirectory(`agent-device-aab-`),s=E.join(o,`bundle.apks`);try{await eo([`build-apks`,`--bundle`,t,`--output`,s,`--mode`,i],n.signal,n.environment??x().environment),await eo([`install-apks`,`--apks`,s,`--device-id`,e.id],n.signal,n.environment??x().environment)}finally{await a.remove(o,{recursive:!0,force:!0})}}async function ro(e,t,n={}){if(to(t)){await no(e,t,n);return}await He(t,{device:e,replace:!0,signal:n.signal})}async function io(e,t,n={}){await yt(e,async()=>{e.booted||await ut(e.id,void 0,n.signal),await ro(e,t,n)})}const ao=[`mInputShown`,`mIsInputViewShown`,`isInputViewShown`,`mDecorViewVisible`,`mWindowVisible`,`mInShowWindow`],oo=new Map([[2,`number`],[3,`phone`],[4,`datetime`]]),so=new Set([32,208]),co=new Set([128,224,144]);async function lo(e){return await V(y(e))}async function V(e){let t=await b(e,[`dumpsys`,`input_method`],{allowFailure:!0});if(t.exitCode!==0)throw w(`Failed to query Android keyboard state`,t);return po(t.stdout)}async function uo(e){return await fo(y(e))}async function fo(e){let n=await V(e),r=n,i=0;for(;r.visible&&i<2;)await b(e,[`input`,`keyevent`,`111`]),i+=1,await g(120),r=await V(e);if(n.visible&&r.visible)throw new t(`UNSUPPORTED_OPERATION`,`Android keyboard dismiss is unavailable for the current IME without back navigation.`,{attempts:i,inputType:r.inputType,type:r.type,inputMethodPackage:r.inputMethodPackage,focusedPackage:r.focusedPackage,focusedResourceId:r.focusedResourceId,inputOwner:r.inputOwner});return{attempts:i,wasVisible:n.visible,dismissed:n.visible&&!r.visible,visible:r.visible,inputType:r.inputType,type:r.type,inputMethodPackage:r.inputMethodPackage,focusedPackage:r.focusedPackage,focusedResourceId:r.focusedResourceId,inputOwner:r.inputOwner}}function po(e){let t=vo(e)??mo(e),n=ho(e),r=go(e,/\bpackageName=([A-Za-z0-9_.]+)\b/g),i=go(e,/\b(?:resourceId|resource-id)=([^\s,}]+)/g),a=f(e),o=ee(r,i,a);return _o(r,i,a),{visible:t??!1,inputType:n,type:n?So(n):void 0,inputMethodPackage:a,focusedPackage:r,focusedResourceId:i,inputOwner:o}}function mo(e){let t=e.match(/\bmImeWindowVis=0x([0-9a-fA-F]+)\b/)?.[1];if(!t)return null;let n=Number.parseInt(t,16);return Number.isNaN(n)?null:!!(n&1)}function ho(e){let t=go(e,/\binputType=0x([0-9a-fA-F]+)\b/gi);return t?`0x${t.toLowerCase()}`:void 0}function go(e,t){let n;for(let r of e.matchAll(t))n=r[1];return n}function _o(e,t,n){n||!u(e)&&!c(t)||h({level:`warn`,phase:`android_input_ownership_fallback`,data:{focusedPackage:e,focusedResourceId:t}})}function vo(e){return bo(yo(e,ao))}function yo(e,t){let n=new Map,r=RegExp(`\\b(${t.join(`|`)})=([a-zA-Z]+)\\b`,`g`);for(let t of e.matchAll(r)){let e=t[1],r=t[2]?.toLowerCase();!e||r!==`true`&&r!==`false`||n.set(e,r===`true`)}return n}function bo(e){if(e.size===0)return null;let t=xo(e,[`mWindowVisible`,`mDecorViewVisible`,`mInShowWindow`]);if(t!==void 0)return t;let n=e.get(`mInputShown`);return n===void 0?xo(e,[`mIsInputViewShown`,`isInputViewShown`])??null:n}function xo(e,t){for(let n of t){let t=e.get(n);if(t!==void 0)return t}}function So(e){let t=Number.parseInt(e.replace(/^0x/i,``),16);if(Number.isNaN(t))return`unknown`;let n=t&15,r=oo.get(n);if(r)return r;if(n!==1)return`unknown`;let i=t&4080;return so.has(i)?`email`:co.has(i)?`password`:`text`}async function Co(e){return await wo(y(e))}async function wo(e){return Oo(await Do(e,[`cmd`,`clipboard`,`get`,`text`],`read`))}async function To(e,t){await Eo(y(e),t)}async function Eo(e,t){await Do(e,[`cmd`,`clipboard`,`set`,`text`,t],`write`)}async function Do(e,t,n){let{androidClipboardShellCommandUnavailableError:r,classifyAndroidClipboardShellResponse:i}=await import(`./clipboard-shell-response.js`),a=await b(e,t,{allowFailure:!0}),o=i(a);if(o===`no-shell-command`)throw r(n);if(o===`call-failed`)throw w(`Failed to ${n} Android clipboard text`,a);return a.stdout}function Oo(e){let t=e.replaceAll(`\r
+`);if(r<0)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned malformed output`,{response:e});let i=Mr(e.slice(0,r)),a=e.slice(r+2);return Ar(i,n),jr(i,a),{xml:a,metadata:Nr(i)}}function Ar(e,n){if(e.agentDeviceProtocol!==`android-snapshot-helper-v1`)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned wrong protocol`,{headers:e});if(e.outputFormat!==`uiautomator-xml`)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned wrong output format`,{headers:e});if(e.requestId!==n)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned stale output`,{headers:e,requestId:n});if(e.ok!==`true`)throw new t(`COMMAND_FAILED`,e.message||e.errorType||`Android snapshot helper session returned an error`,{helper:e,...br(vr(e))})}function jr(e,n){let r=A(e.byteLength);if(r!==void 0&&Buffer.byteLength(n,`utf8`)!==r)throw new t(`COMMAND_FAILED`,`Android snapshot helper session returned truncated XML`,{headers:e,actualByteLength:Buffer.byteLength(n,`utf8`)});if(!n.includes(`<hierarchy`)||!n.includes(`</hierarchy>`))throw new t(`COMMAND_FAILED`,`Android snapshot helper session did not return XML`,{headers:e,xml:n})}function Mr(e){let t={};for(let n of e.split(/\r?\n/)){let e=n.indexOf(`=`);e<0||(t[n.slice(0,e)]=n.slice(e+1))}return t}function Nr(e){return{helperApiVersion:e.helperApiVersion,outputFormat:Jn,waitForIdleTimeoutMs:A(e.waitForIdleTimeoutMs),waitForIdleQuietMs:A(e.waitForIdleQuietMs),timeoutMs:A(e.timeoutMs),maxDepth:A(e.maxDepth),maxNodes:A(e.maxNodes),rootPresent:Nn(e.rootPresent),captureMode:e.captureMode===`interactive-windows`||e.captureMode===`active-window`?e.captureMode:void 0,windowCount:A(e.windowCount),nodeCount:A(e.nodeCount),truncated:Nn(e.truncated),elapsedMs:A(e.elapsedMs),pixelDensity:A(e.pixelDensity)}}function N(e,n,r,i){if(i instanceof t){let a=i.details??{};return new t(i.code,i.message,{...a,action:e,package:r,tool:n,hint:typeof a.hint==`string`?a.hint:Ir(n,a)},i)}return new t(`COMMAND_FAILED`,`Failed to ${e} Android ${n} for ${r}`,{action:e,package:r,tool:n,hint:Pr(n)},i)}function Pr(e){return e===`simpleperf`?`Verify simpleperf is available, the app process is running, and the app/device permits native CPU profiling.`:`Verify perfetto is available, the app process is running, and the device permits trace capture.`}function Fr(e){return e===`simpleperf`?`Use an emulator/system image with simpleperf available, or install the Android NDK simpleperf binary for this device.`:`Use Android 10+ or a system image that exposes the perfetto command-line binary.`}function Ir(e,t){let n=(typeof t.stderr==`string`?t.stderr:``).toLowerCase();return e===`simpleperf`?Lr(n):zr(n)?`Use a device image that permits perfetto trace capture for shell, keep the app running, then retry perf trace start.`:Pr(e)}function Lr(e){return Rr(e)?`Use a debuggable/profileable Android app or a device image that permits simpleperf for the target process, then retry perf cpu profile start.`:e.includes(`not supported`)||e.includes(`failed to open perf event`)?`This device image does not expose the requested simpleperf event for the app process. Try a different emulator/system image or a profileable app.`:Pr(`simpleperf`)}function Rr(e){return e.includes(`permission denied`)||e.includes(`not profileable`)||e.includes(`profileable`)}function zr(e){return e.includes(`permission denied`)||e.includes(`not allowed`)}const Br=`adb-shell-simpleperf`,Vr=`adb-shell-perfetto`,Hr=15e3,P=3e4,Ur=`/data/local/tmp`;async function Wr(e,n){try{let t=await x(e,[`pidof`,n],{allowFailure:!0,timeoutMs:Hr}),r=Kr(t.stdout);if(t.exitCode===0&&r)return r}catch{}throw new t(`COMMAND_FAILED`,`No active Android app process found for ${n}`,{package:n,hint:`Run open <app> for this session again, wait for the app UI to appear, then retry perf.`})}async function Gr(e,n,r){let i=await x(e,[v(`command -v ${y(n)} || which ${y(n)}`)],{allowFailure:!0,timeoutMs:Hr});if(!(i.exitCode===0&&i.stdout.trim()))throw new t(`UNSUPPORTED_OPERATION`,`Android device does not expose ${n}`,{package:r,tool:n,hint:Fr(n)})}function Kr(e){return e.trim().split(/\s+/).find(e=>/^\d+$/.test(e))}const qr=2e3,Jr=`android_snapshot_helper_runtime_occupied`,F=new Map;function Yr(e){return`${e.platform}:${e.id}`}async function Xr(e){await li({adb:e.adb,packageName:e.packageName}),await Qr({deviceKey:e.deviceKey,packageName:e.packageName,adb:e.adb,cause:e.cause})}async function Zr(e){let t=F.get(e.deviceKey);if(!t)return;await li({adb:e.adb,packageName:t.packageName,timeoutMs:5e3,...e.signal?{signal:e.signal}:{}}),e.signal?.throwIfAborted();let n=await ti({adb:e.adb,packageName:t.packageName});if(n===`occupied`&&(await _(250),n=await ti({adb:e.adb,packageName:t.packageName})),n===`occupied`)throw ei({deviceKey:e.deviceKey,packageName:t.packageName,cause:t.cause});n!==`unknown`&&F.delete(e.deviceKey)}async function Qr(e){let t=e.release??await ti({adb:e.adb,packageName:e.packageName});if(t===`released`)return F.delete(e.deviceKey),t;let n=e.cause instanceof Error?e.cause.message:String(e.cause);return F.set(e.deviceKey,{packageName:e.packageName,cause:n}),g({level:`warn`,phase:`android_snapshot_helper_retirement_pending`,data:{deviceKey:e.deviceKey,packageName:e.packageName,release:t}}),t}function $r(e){return e instanceof t&&e.details?.reason===Jr}function ei(e){let n=e.cause instanceof Error?e.cause.message:String(e.cause);return new t(`COMMAND_FAILED`,`Android automation helper is still holding device automation ownership`,{reason:Jr,deviceKey:e.deviceKey,packageName:e.packageName,cause:n,hint:`Retry after the helper process exits, or restart the device if Android keeps reporting the helper as running.`})}async function ti(e){try{let t=await x(e.adb,[`pidof`,e.packageName,v(`|| echo AGENT_DEVICE_NO_HELPER`)],{allowFailure:!0,timeoutMs:qr}),n=t.stdout.trim();return Kr(n)?`occupied`:n===`AGENT_DEVICE_NO_HELPER`&&t.stderr.trim().length===0?`released`:`unknown`}catch{return`unknown`}}async function ni(e){let t=AbortSignal.timeout(e.timeoutMs);return await Promise.all([...e.forceStopRuntime?[li({adb:e.adb,packageName:e.packageName,timeoutMs:e.timeoutMs,signal:t})]:[],ui({...e,signal:t})]),{timedOut:t.aborted}}function ri(e){let t=ii(e);return{ended:t?Promise.resolve():new Promise(t=>{e.once(`close`,()=>t()),e.once(`exit`,()=>t())}),hasEnded:()=>ii(e),completedCleanly:()=>!t&&e.exitCode===0&&e.signalCode==null}}function ii(e){return e.exitCode!=null||e.signalCode!=null}async function ai(e,t,n){let r,i,a=await Promise.race([e.then(()=>!0),new Promise(e=>{r=setTimeout(()=>e(!1),t)}),...n?[new Promise(e=>{i=()=>e(!1),n.addEventListener(`abort`,i,{once:!0}),n.aborted&&i()})]:[]]);return r&&clearTimeout(r),i&&n?.removeEventListener(`abort`,i),a}async function oi(e){if(e.processExit.hasEnded())return!0;try{e.process.kill(`SIGTERM`)}catch{}return await ai(e.processExit.ended,e.timeoutMs)}function si(e){F.delete(e)}function ci(){F.clear()}async function li(e){await x(e.adb,[`am`,`force-stop`,e.packageName],{allowFailure:!0,timeoutMs:e.timeoutMs??2e3,...e.signal?{signal:e.signal}:{}}).catch(()=>{})}async function ui(e){e.process.stdin?.end(),e.process.stdout?.destroy(),e.process.stderr?.destroy(),await e.adb([`forward`,`--remove`,`tcp:${e.port}`],{allowFailure:!0,timeoutMs:e.timeoutMs,signal:e.signal})}async function di(e){let n=pi(e),r=e.deviceKey??`android:default`;await Zr({deviceKey:r,adb:e.adb,signal:e.signal});let i;try{i=await e.adb(mi(n),{allowFailure:!0,timeoutMs:n.commandTimeoutMs,signal:e.signal})}catch(t){throw e.signal?.aborted?(await Xr({deviceKey:r,packageName:n.packageName,adb:e.adb,cause:t}),e.signal.throwIfAborted(),t):t}e.signal?.aborted&&(await Xr({deviceKey:r,packageName:n.packageName,adb:e.adb,cause:e.signal.reason}),e.signal.throwIfAborted());let{output:a,cleanupDone:o}=await hi(e,n,i);if(n.outputPath&&!o&&await Si(e.adb,n.outputPath),i.exitCode!==0)throw new t(`COMMAND_FAILED`,`Android snapshot helper failed`,De(i,{helper:a.metadata}));return a}function fi(e){return{adb:e.adb,adbProvider:e.adbProvider,deviceKey:e.deviceKey,helperVersion:e.artifact.manifest.version,helperVersionCode:e.artifact.manifest.versionCode,helperSha256:e.artifact.manifest.sha256,packageName:e.artifact.manifest.packageName,instrumentationRunner:e.artifact.manifest.instrumentationRunner,waitForIdleTimeoutMs:500,timeoutMs:Yn,commandTimeoutMs:Xn,...e.signal?{signal:e.signal}:{}}}function pi(e){let t=I(e.timeoutMs,8e3),n=I(e.packageName,`com.callstack.agentdevice.snapshothelper`);return{waitForIdleTimeoutMs:I(e.waitForIdleTimeoutMs,500),waitForIdleQuietMs:I(e.waitForIdleQuietMs,100),timeoutMs:t,commandTimeoutMs:I(e.commandTimeoutMs,t+5e3),maxDepth:I(e.maxDepth,128),maxNodes:I(e.maxNodes,5e3),packageName:n,runner:I(e.instrumentationRunner,`${n}/.SnapshotInstrumentation`),...e.outputPath?{outputPath:e.outputPath}:{},...e.emitChunks===void 0?{}:{emitChunks:e.emitChunks}}}function I(e,t){return e===void 0?t:e}function mi(e,t={}){return Ae(`adb`,`shell`,[`am`,`instrument`,`-w`,`-e`,`waitForIdleTimeoutMs`,String(e.waitForIdleTimeoutMs),`-e`,`waitForIdleQuietMs`,String(e.waitForIdleQuietMs),`-e`,`timeoutMs`,String(e.timeoutMs),`-e`,`maxDepth`,String(e.maxDepth),`-e`,`maxNodes`,String(e.maxNodes),...e.outputPath?[`-e`,`outputPath`,e.outputPath]:[],...e.emitChunks===void 0?[]:[`-e`,`emitChunks`,String(e.emitChunks)],...t.sessionPort===void 0?[]:[`-e`,`sessionPort`,t.sessionPort],e.runner])}async function hi(e,t,n){try{return{output:Ci(`${n.stdout}\n${n.stderr}`),cleanupDone:!1}}catch(r){return await gi(e,t,n,r)}}async function gi(e,n,r,i){if(i instanceof t&&r.exitCode!==0&&i.details?.helper)throw i;let a=await _i(e,n,r);if(a)return{output:a,cleanupDone:!0};throw new t(`COMMAND_FAILED`,r.exitCode===0?`Android snapshot helper output could not be parsed`:`Android snapshot helper failed before returning parseable output`,{stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode,...br(yr(r.exitCode))},i)}async function _i(e,t,n){if(!(n.exitCode!==0||!t.outputPath))return await yi(e.adb,t.outputPath,xi(`${n.stdout}\n${n.stderr}`)??vi(t))}function vi(e){return{outputFormat:Jn,waitForIdleTimeoutMs:e.waitForIdleTimeoutMs,waitForIdleQuietMs:e.waitForIdleQuietMs,timeoutMs:e.timeoutMs,maxDepth:e.maxDepth,maxNodes:e.maxNodes,transport:`instrumentation`}}async function yi(e,t,n){let r;try{r=await x(e,bi(t),{allowFailure:!0,timeoutMs:5e3})}catch{return}if(r.exitCode!==0)return;let i=r.stdout.trim();if(!(!i.includes(`<hierarchy`)||!i.includes(`</hierarchy>`)))return{xml:i,metadata:n}}function bi(e){return[`sh`,`-c`,`cat "$1"; status=$?; rm -f "$1"; exit "$status"`,`agent-device-snapshot-helper-output`,e]}function xi(e){try{return ji(Ti(Dn(e).results))}catch{return null}}async function Si(e,t){try{await x(e,[`rm`,`-f`,t],{allowFailure:!0,timeoutMs:5e3})}catch{}}function Ci(e){let t=Dn(e),n=Ti(t.results);return{xml:Di(wi(t.status),n),metadata:{...ji(n),transport:`instrumentation`}}}function wi(e){let t=[];for(let n of e){if(n.agentDeviceProtocol!==`android-snapshot-helper-v1`||n.outputFormat!==`uiautomator-xml`)continue;let{payloadBase64:e}=n;e!==void 0&&t.push({index:L(n.chunkIndex),count:L(n.chunkCount),payloadBase64:e})}return t}function Ti(e){let n=e.find(e=>e.agentDeviceProtocol===qn);if(!n)throw new t(`COMMAND_FAILED`,`Android snapshot helper did not return a final result`);if(n.ok!==`true`)throw new t(`COMMAND_FAILED`,Ei(n),{errorType:n.errorType,helper:n,...br(vr(n))});return n}function Ei(e){return e.message&&e.message!==`null`?e.message:e.errorType||`Android snapshot helper returned an error`}function Di(e,n){if(e.length===0)throw new t(`COMMAND_FAILED`,`Android snapshot helper did not return XML chunks`,{helper:n});let r=Oi(e),i=Buffer.concat(Ai(ki(e,r),r)).toString(`utf8`);if(!i.includes(`<hierarchy`)||!i.includes(`</hierarchy>`))throw new t(`COMMAND_FAILED`,`Android snapshot helper output did not contain XML`,{xml:i});return i}function Oi(e){let n=e[0]?.count??e.length;if(n<1||e.length!==n||e.some(e=>e.count!==n))throw new t(`COMMAND_FAILED`,`Android snapshot helper returned incomplete XML chunks`,{expectedChunks:n,actualChunks:e.length});return n}function ki(e,n){let r=new Map;for(let i of e){if(i.index===void 0||i.index<0||i.index>=n)throw new t(`COMMAND_FAILED`,`Android snapshot helper returned invalid chunk index`,{chunkIndex:i.index,expectedChunks:n});if(r.has(i.index))throw new t(`COMMAND_FAILED`,`Android snapshot helper returned duplicate XML chunks`,{chunkIndex:i.index});r.set(i.index,i.payloadBase64)}return r}function Ai(e,n){let r=[];for(let i=0;i<n;i+=1){let a=e.get(i);if(a===void 0)throw new t(`COMMAND_FAILED`,`Android snapshot helper returned incomplete XML chunks`,{missingChunkIndex:i,expectedChunks:n});r.push(Buffer.from(a,`base64`))}return r}function ji(e){return{helperApiVersion:e.helperApiVersion,outputFormat:Jn,waitForIdleTimeoutMs:L(e.waitForIdleTimeoutMs),waitForIdleQuietMs:L(e.waitForIdleQuietMs),timeoutMs:L(e.timeoutMs),maxDepth:L(e.maxDepth),maxNodes:L(e.maxNodes),rootPresent:Ni(e.rootPresent),captureMode:Mi(e.captureMode),windowCount:L(e.windowCount),nodeCount:L(e.nodeCount),truncated:Ni(e.truncated),elapsedMs:L(e.elapsedMs),pixelDensity:L(e.pixelDensity)}}function Mi(e){return e===`interactive-windows`||e===`active-window`?e:void 0}const L=A,Ni=Nn,Pi=5e3,R=new Map,z=new Map;async function Fi(e){return await Ii(e)!==void 0}async function Ii(e){let t=e.deviceKey??`android:default`;if(await Zr({deviceKey:t,adb:e.adb,signal:e.signal}),!Ji()||!e.adbProvider?.spawn)return;let n=pi(e),r=Ki(n),i=await Ri({deviceKey:t,identity:Gi(t,r,e),options:e,resolved:r,startBudgetMs:qi(n.commandTimeoutMs)});return i?{session:i,resolved:r,deviceKey:t}:void 0}function Li(e){return R.get(e)}async function Ri(e){if(!Vi(e.identity))return await zi(e.deviceKey,e.identity),R.get(e.deviceKey)??await Bi(e)}async function zi(e,t){let n=R.get(e);!n||Ui(n,t)||await B(e,{force:ii(n.process)})}async function Bi(e){let n=Date.now();try{return await Wi(e)}catch(r){e.options.signal?.throwIfAborted(),z.set(e.identity,Date.now()+Hi(Date.now()-n)),g({level:`warn`,phase:`android_snapshot_helper_session_start_failed`,data:{deviceKey:e.deviceKey,reason:r instanceof t?r.details?.reason:void 0,detail:r instanceof Error?r.message:String(r)}});return}}function Vi(e){let t=z.get(e);return t===void 0?!1:t>Date.now()||(z.delete(e),!1)}function Hi(e){return Math.min(Math.max(e,1e4),6e4)}function Ui(e,t){return e.identity===t&&!ii(e.process)}async function Wi(e){let t=await xr();await e.options.adb([`forward`,`tcp:${t}`,`tcp:${t}`],{allowFailure:!1,timeoutMs:Pi,signal:e.options.signal});let n=mi({...e.resolved,outputPath:void 0,emitChunks:!1},{sessionPort:t}),r=e.options.adbProvider.spawn(n,{allowFailure:!0,captureOutput:!1}),i={identity:e.identity,deviceKey:e.deviceKey,helper:{packageName:e.resolved.packageName,runner:e.resolved.runner,helperVersion:e.options.helperVersion,helperVersionCode:e.options.helperVersionCode,sha256:e.options.helperSha256},port:t,adb:e.options.adb,process:r,startedAtMs:Date.now(),capturedCount:0};try{return await Tr(r,e.startBudgetMs,e.options.signal),R.set(e.deviceKey,i),z.delete(e.identity),si(e.deviceKey),g({phase:`android_snapshot_helper_session_ready`,data:{deviceKey:e.deviceKey,port:t,packageName:e.resolved.packageName,runner:e.resolved.runner}}),i}catch(t){let n=ri(r);try{r.kill(`SIGTERM`)}catch{}throw await Promise.all([ai(n.ended,250),ni({adb:i.adb,process:i.process,port:i.port,packageName:i.helper.packageName,timeoutMs:qr,forceStopRuntime:!0})]),await Qr({deviceKey:e.deviceKey,packageName:i.helper.packageName,adb:i.adb,cause:t}),t}}function Gi(e,t,n){return JSON.stringify({deviceKey:e,packageName:t.packageName,runner:t.runner,helperVersion:n.helperVersion,helperVersionCode:n.helperVersionCode,helperSha256:n.helperSha256,waitForIdleTimeoutMs:t.waitForIdleTimeoutMs,waitForIdleQuietMs:t.waitForIdleQuietMs,timeoutMs:t.timeoutMs,maxDepth:t.maxDepth,maxNodes:t.maxNodes})}function Ki(e){let t=Math.min(e.timeoutMs,2e3);return{...e,timeoutMs:t,commandTimeoutMs:Math.min(e.commandTimeoutMs,t+3e3)}}function qi(e){return Math.min(e,Math.max(Math.floor(e/2),5e3))}function Ji(){let e=S().environment.AGENT_DEVICE_ANDROID_SNAPSHOT_HELPER_SESSION;return e===void 0||!/^(0|false|no|off)$/i.test(e)}async function B(e,t={}){let n=R.get(e);if(!n)return!1;R.delete(e);let r=ri(n.process),i=t.force===!0||t.signal?.aborted===!0,a=await Yi(n,r,i,t.signal),o=r.hasEnded(),s=a.acknowledged&&a.exited,c=s&&await Wt({adb:n.adb,deviceKey:e,signal:t.signal}),l=i?t.signal?.aborted===!0?250:qr:Pi,u=i?250:2e3,[d,f]=await Promise.all([oi({process:n.process,processExit:r,timeoutMs:u}),ni({adb:n.adb,process:n.process,port:n.port,packageName:n.helper.packageName,timeoutMs:l,forceStopRuntime:t.resetRuntime===!0||!c})]),p=await Qr({deviceKey:e,packageName:n.helper.packageName,adb:n.adb,cause:t.cause,...c?{release:`released`}:{}});return g({phase:`android_snapshot_helper_session_stop`,data:{deviceKey:e,port:n.port,capturedCount:n.capturedCount,lifetimeMs:Date.now()-n.startedAtMs,quitAcknowledged:a.acknowledged,quitExitObserved:s,releaseProvenByQuit:c,release:p,forceKilled:!o&&d,forced:i||t.signal?.aborted===!0,externalCleanupTimedOut:f.timedOut}}),!0}async function Yi(e,t,n,r){if(n)return{acknowledged:!1,exited:!1};let i=`quit-${Date.now()}`;try{let n=Or(await Sr(e.port,`quit ${i}`,1e3,r),i);return{acknowledged:n,exited:n&&await ai(t.ended,11e3,r)&&t.completedCleanly()}}catch{return{acknowledged:!1,exited:!1}}}async function Xi(e){await B(Yr(e))}async function Zi(){try{await Promise.allSettled([...R.keys()].map(async e=>{await B(e)}))}finally{R.clear(),z.clear(),ci(),Gt()}}async function Qi(e){let t=await Ii(e);if(t)return await $i({session:t.session,deviceKey:t.deviceKey,options:e,resolved:t.resolved})}async function $i(e){let{session:t,deviceKey:n,options:r,resolved:i}=e;try{let e=t.capturedCount>0,n=await Cr({port:t.port,timeoutMs:i.timeoutMs,commandTimeoutMs:i.commandTimeoutMs,signal:r.signal});return t.capturedCount+=1,{xml:n.xml,metadata:{...n.metadata,transport:`persistent-session`,sessionReused:e}}}catch(e){await B(n,{force:!0,signal:r.signal,cause:e}),r.signal?.throwIfAborted(),g({level:`warn`,phase:`android_snapshot_helper_session_fallback`,data:{deviceKey:n,reason:e instanceof Error?e.message:String(e),uiAutomationConnectionTimeout:ct(e)===`accessibility-timeout`}});return}}async function ea(e){let n=Li(e.deviceKey);if(!n)return;if(!ta(n.helper,e.helper)){g({level:`warn`,phase:`android_snapshot_helper_session_touch_identity_mismatch`,data:{deviceKey:e.deviceKey,sessionHelper:n.helper,requestedHelper:e.helper}}),await B(e.deviceKey);return}let r=`${e.action}-${Date.now()}-${Math.random().toString(16).slice(2)}`,i=e.payloadBase64?`${e.action} ${r} ${e.payloadBase64}`:`${e.action} ${r}`,a;try{a=Er(await Sr(n.port,i,e.timeoutMs)),Dr(a,r)}catch(t){throw await B(e.deviceKey),t}if(a.ok!==`true`)throw new t(`COMMAND_FAILED`,a.message||a.errorType||`Android automation helper ${e.action} failed`,{errorType:a.errorType,helper:a});return a}function ta(e,t){return e.packageName===t.packageName&&e.runner===t.runner&&na(e.helperVersion,t.helperVersion)&&na(e.helperVersionCode,t.helperVersionCode)&&na(e.sha256,t.sha256)}function na(e,t){return e===void 0||t===void 0||e===t}const ra=`android-touch-plan-v1`,ia=45e3,aa=`ANDROID_TOUCH_HELPER_NO_FINAL_RESULT`,oa=`ANDROID_TOUCH_HELPER_REPORTED_FAILURE`;async function sa(e,t){let n=await ua(e),r=fa(t),i=Math.max(45e3,r.durationMs+15e3),a=Buffer.from(JSON.stringify({protocol:ra,...r})).toString(`base64`),o=await h(`android_touch_helper_gesture`,async()=>{let e=await ea({deviceKey:n.deviceKey,action:`gesture`,helper:la(n.artifact),payloadBase64:a,timeoutMs:i});return e?{...ga(e),helperTransport:`persistent-session`}:{...await ma({adb:n.adb,runner:n.artifact.manifest.instrumentationRunner,extraArgs:[`-e`,`mode`,`gesture`,`-e`,`payloadBase64`,a],timeoutMs:i,readResult:ga}),helperTransport:`instrumentation`}},{packageName:n.artifact.manifest.packageName,version:n.artifact.manifest.version});return{backend:`android-helper`,helperVersion:n.artifact.manifest.version,installReason:n.install.reason,...o}}async function ca(e,t={}){let n=await ua(e);t.helperSessionScope===`daemon-session`&&await Fi(fi({adb:n.adb,adbProvider:n.adbProvider,artifact:n.artifact,deviceKey:n.deviceKey}));try{let e=await ea({deviceKey:n.deviceKey,action:`viewport`,helper:la(n.artifact),timeoutMs:ia});if(e)return _a(e)}catch(e){await B(n.deviceKey),g({level:`warn`,phase:`android_touch_helper_viewport_session_fallback`,data:{reason:e instanceof Error?e.message:String(e)}})}return await ma({adb:n.adb,runner:n.artifact.manifest.instrumentationRunner,extraArgs:[`-e`,`mode`,`viewport`],timeoutMs:ia,readResult:_a})}function la(e){return{packageName:e.manifest.packageName,runner:e.manifest.instrumentationRunner,helperVersion:e.manifest.version,helperVersionCode:e.manifest.versionCode,sha256:e.manifest.sha256}}async function ua(e){let t=w(e),n=t.snapshotHelperArtifact??await da(),r=Yr(e);await Zr({deviceKey:r,adb:t.exec});let i=await h(`android_touch_helper_install`,async()=>await dr({adb:t.exec,adbProvider:t,artifact:n,deviceKey:r,timeoutMs:3e4}),{packageName:n.manifest.packageName,versionCode:n.manifest.versionCode});return g({phase:`android_touch_helper_install_decision`,data:i}),i.installed&&await B(r),{adb:t.exec,adbProvider:t,artifact:n,install:i,deviceKey:r}}async function da(){return await zn({helperDirName:`snapshot-helper`,manifestFileName:e=>`agent-device-android-snapshot-helper-${e}.manifest.json`,parseManifest:e=>{let t=Zn(e);return{...t,assetName:t.assetName??`agent-device-android-snapshot-helper-${t.version}.apk`}},unavailableMessage:`Android touch gestures require the bundled Android automation helper artifact, but it was not found or could not be read`})}function fa(e){return{kind:e.topology===`single`?`swipe`:`transform`,durationMs:e.durationMs,pointers:e.pointers.map(pa)}}function pa(e){return{pointerId:e.pointerId,samples:e.samples.map(({offsetMs:e,point:t})=>({offsetMs:e,x:t.x,y:t.y}))}}async function ma(e){let n=await x(e.adb,[`am`,`instrument`,`-w`,...e.extraArgs,e.runner],{allowFailure:!0,timeoutMs:e.timeoutMs}),r;try{r=ha(`${n.stdout}\n${n.stderr}`)}catch(e){if(e instanceof t){if(e.code===oa)throw new t(`COMMAND_FAILED`,e.message,e.details,e);if(e.code!==aa)throw e}throw new t(`COMMAND_FAILED`,n.exitCode===0?`Android automation helper output could not be parsed`:`Android automation helper failed before returning parseable output`,De(n),e)}if(n.exitCode!==0)throw new t(`COMMAND_FAILED`,`Android automation helper failed`,De(n,{helper:r}));return e.readResult(r)}function ha(e){let n=Dn(e).results.find(e=>e.agentDeviceProtocol===qn);if(!n)throw new t(aa,`Android automation helper did not return a final result`);if(n.ok!==`true`)throw new t(oa,n.message&&n.message!==`null`?n.message:n.errorType||`Android automation helper returned an error`,{errorType:n.errorType,helper:n});return n}function ga(e){return{helperKind:e.kind,helperApiVersion:e.helperApiVersion,injectedEvents:A(e.injectedEvents),elapsedMs:A(e.elapsedMs)}}function _a(e){let n=A(e.x),r=A(e.y),i=A(e.width),a=A(e.height);if(n===void 0||r===void 0||i===void 0||a===void 0)throw new t(`COMMAND_FAILED`,`Android helper returned an invalid gesture viewport`);let o=va(e);return{viewport:Pn({x:n,y:r,width:i,height:a}),...o?{keyboard:o}:{}}}function va(e){let t=A(e.keyboardX),n=A(e.keyboardY),r=A(e.keyboardWidth),i=A(e.keyboardHeight);if(t!==void 0&&n!==void 0&&r!==void 0&&i!==void 0)return{x:t,y:n,width:r,height:i}}function ya(e){if(e.topology===`two`||e.intent===`longPress`)return e;let{releaseBehavior:t,...n}=e,[{pointerId:r,samples:i}]=n.pointers,a=[...new Set([...at(e.durationMs,`android`),...i.map(({offsetMs:e})=>e)])].sort((e,t)=>e-t),o=0,s=a.map(e=>{for(;o<i.length-2&&e>i[o+1].offsetMs;)o+=1;let n=i[o],r=i[o+1],a=r.offsetMs-n.offsetMs,s=(e-n.offsetMs)/a;return{offsetMs:e,point:e===r.offsetMs||a===0?r.point:st(n.point,r.point,t===`controlled`?ba(s,a):s)}}),c=[s[0],s[1],s[2],...s.slice(3)];return{...n,pointers:[{pointerId:r,samples:c}]}}function ba(e,t){let n=Math.min(16/t,.5);return e<n?e**2/n:1-(1-e)**2/(1-n)}async function xa(e,t){let n=ya(t),r=Ie(e);if(r){let e=n.intent===`longPress`?{...n,viewport:Pn(await r.gestureViewport())}:n;return{backend:`provider-native-touch`,...await r.touch(e)??{}}}return await sa(e,n)}async function Sa(e,t={}){return(await Ca(e,t)).viewport}async function Ca(e,t={}){let n=Ie(e);return n?{viewport:Pn(await n.gestureViewport())}:await ca(e,t)}async function wa(e,t,n){await E(e,[`input`,`tap`,t,n])}async function Ta(e,t,n){let r=ke(t);await E(e,[`input`,...n&&n>0?[`keyevent`,`--longpress`]:[`keyevent`],r])}async function Ea(e){await E(e,[`input`,`keyevent`,`4`])}async function Da(e){await E(e,[`input`,`keyevent`,`3`])}async function Oa(e){await E(e,[`input`,`keyevent`,`ENTER`])}async function ka(e,t){let n=za(t);await E(e,[`settings`,`put`,`system`,`accelerometer_rotation`,`0`]),await E(e,[`settings`,`put`,`system`,`user_rotation`,n]),await ja(e,t,n)}const Aa=15e3;async function ja(e,n,r){let i=Date.now()+Aa,a=await Ma(e,n,i);for(;a!==void 0&&a!==r&&Date.now()<i;)await _(Math.min(500,Na(i))),a=await Ma(e,n,i);if(a!==void 0&&a!==r)throw new t(`COMMAND_FAILED`,`orientation ${n} did not take effect: the display still reports rotation ${a} after ${Aa}ms`,{requestedRotation:Number(r),observedRotation:Number(a),hint:"The foreground app may pin its orientation, or the device may ignore user_rotation. Check `adb shell dumpsys display | grep mCurrentOrientation` and the app manifest."})}async function Ma(e,n,r){try{let t=await E(e,[`dumpsys`,`display`],{timeoutMs:Na(r)});return/mCurrentOrientation=(\d)/.exec(t.stdout)?.[1]}catch(e){throw new t(`COMMAND_FAILED`,`orientation ${n} could not confirm the display rotation: ${e instanceof Error?e.message:String(e)}`,{hint:"The device did not answer `dumpsys display` within the orientation budget."})}}function Na(e){return Math.max(1,e-Date.now())}async function Pa(e){await E(e,[`input`,`keyevent`,`187`])}async function Fa(e,t,n,r=800){let i={x:t,y:n};return await xa(e,{topology:`single`,intent:`longPress`,durationMs:r,pointers:[{pointerId:0,samples:[{offsetMs:0,point:i},{offsetMs:r,point:i}]}]})}async function Ia(e,t,n){await wa(e,t,n)}async function La(e,t,n){let{viewport:r,keyboard:i}=await Ca(e,{helperSessionScope:n?.helperSessionScope}),a=Ra(t,r,i),o=ue({direction:t,amount:n?.amount,pixels:n?.pixels,referenceWidth:a.viewport.width,referenceHeight:a.viewport.height}),s={...o,referenceWidth:a.viewport.x+a.viewport.width,referenceHeight:a.viewport.y+a.viewport.height,x1:a.viewport.x+o.x1,y1:a.viewport.y+o.y1,x2:a.viewport.x+o.x2,y2:a.viewport.y+o.y2},c=Math.max(n?.durationMs??300,16),l=await xa(e,{...ot({intent:`pan`,origin:{x:s.x1,y:s.y1},delta:{x:s.x2-s.x1,y:s.y2-s.y1},durationMs:c},a.viewport,`android`),releaseBehavior:n?.releaseBehavior??`controlled`});return{...s,...a.evidence,...n?.durationMs===void 0?{}:{durationMs:c},...l}}function Ra(e,t,n){if(n===void 0)return{viewport:t,evidence:{}};let r=de(t,n);if(r.kind===`occluded`)throw le(e,{keyboardMinY:r.keyboardMinY,visibleHeight:r.visibleHeight,viewportHeight:t.height});return r.kind===`avoided`?{viewport:r.viewport,evidence:{keyboardAvoided:!0,keyboardMinY:r.keyboardMinY}}:{viewport:t,evidence:{}}}function za(e){let n=Ce[e];if(n===void 0)throw new t(`INVALID_ARGS`,`Unsupported Android rotation: ${e}`);return String(n)}async function Ba(e){let n=(await E(e,[`wm`,`size`])).stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(!n)throw new t(`COMMAND_FAILED`,`Unable to read screen size`);return{width:Number(n[1]),height:Number(n[2])}}async function Va(e,t,n){return t===`wait`?await Ha(n.captureNodes,n.timeoutMs??1e4):t===`get`?Ja((await qa(n.captureNodes))?.alert??null):await Ua(e,t,n.captureNodes)}async function Ha(e,n){let r=Date.now(),i=await Ka(e,n);if(!i)throw new t(`COMMAND_FAILED`,`alert wait timed out`);return{kind:`alertWait`,platform:`android`,action:`wait`,alert:i.alert,waitedMs:Date.now()-r,...fe(`Alert visible`)}}async function Ua(e,n,r){let i=await Ka(r,pe);if(!i)throw new t(`COMMAND_FAILED`,`alert not found`,{hint:`If a sheet is visible in snapshot but alert reports no alert, it is likely app-owned UI. Use snapshot -i and press the visible label/ref.`});let a=on(i.buttons,n);if(a)return await wa(e,a.x,a.y),await Wa(i.alert,n,r),Ya(n,i.alert,a.label,{x:a.x,y:a.y});if(n===`dismiss`)return await Ea(e),await Wa(i.alert,n,r),Ya(n,i.alert,`Back`);throw new t(`COMMAND_FAILED`,`alert accept found an alert but no accept button`,{alert:i.alert,hint:`Inspect alert get --json for visible buttons, then use press by visible label/ref if needed.`})}async function Wa(e,n,r){let i=Date.now();for(;;){let a=await qa(r);if(!a||!Ga(a.alert,e))return;if(Date.now()-i>=2e3)throw new t(`COMMAND_FAILED`,`alert ${n} did not dismiss the visible alert`,{alert:e,hint:`The alert button was pressed but the dialog is still visible. Inspect alert get --json, then press the visible button by label/ref or retry.`});await _(300)}}function Ga(e,t){return e.title===t.title&&e.buttons.join(`\0`)===t.buttons.join(`\0`)}async function Ka(e,t){let n=Date.now();for(;Date.now()-n<t;){let t=await qa(e);if(t)return t;await _(300)}return null}async function qa(e){return rn(await h(`snapshot_capture`,e,{backend:`android`,purpose:`alert`}))}function Ja(e){return{kind:`alertStatus`,platform:`android`,action:`get`,alert:e,...fe(e?`Alert visible`:`No alert visible`)}}function Ya(e,t,n,r){return{kind:`alertHandled`,platform:`android`,action:e,handled:!0,alert:t,button:n,...r?{coordinates:r}:{},...fe(`Alert ${e}ed`)}}const Xa=`android.intent.category.LAUNCHER`,Za=`android.intent.category.DEFAULT`;async function Qa(e,t){await x(e,[`am`,`force-stop`,t])}async function $a(e,t,n=[Xa]){for(let r of n){let n=await x(e,[`cmd`,`package`,`resolve-activity`,`--brief`,`-a`,`android.intent.action.MAIN`,`-c`,r,t],{allowFailure:!0});if(n.exitCode!==0)continue;let i=mt(n.stdout);if(i)return i}return null}async function eo(e,n,r={}){let i=r.category??Xa;if(r.activity){await x(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Za,`-c`,i,`-n`,to(n,r.activity)]);return}let a=await x(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Za,`-c`,i,`-p`,n],{allowFailure:!0});if(a.exitCode===0&&!ht(a.stdout,a.stderr))return;let o=await $a(e,n,[i]);if(!o)throw new t(`COMMAND_FAILED`,`Failed to resolve Android launch component for ${n}`,{stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode});await x(e,[`am`,`start`,`-W`,`-a`,`android.intent.action.MAIN`,`-c`,Za,`-c`,i,`-n`,o])}function to(e,t){return t.includes(`/`)?t:`${e}/${t.startsWith(`.`)?t:`.${t}`}`}let no=null;function ro(e){return`${e.PATH??``}::${e.AGENT_DEVICE_BUNDLETOOL_JAR??``}`}async function io(e){let n=ro(e);if(no?.key===n)return no.invocation;if(await Ee(`bundletool`)){let e={cmd:`bundletool`,prefixArgs:[]};return no={key:n,invocation:e},e}let r=await Oe(e.AGENT_DEVICE_BUNDLETOOL_JAR,`AGENT_DEVICE_BUNDLETOOL_JAR`);if(!r)throw new t(`TOOL_MISSING`,`bundletool not found in PATH. Install bundletool or set AGENT_DEVICE_BUNDLETOOL_JAR to a bundletool-all.jar path.`);let i={cmd:`java`,prefixArgs:[`-jar`,r]};return no={key:n,invocation:i},i}async function ao(e,t,n){let r=await io(n);await Te(r.cmd,[...r.prefixArgs,...e],{signal:t})}function oo(e){return D.extname(e).toLowerCase()===`.aab`}async function so(e,t,n={}){let r=w(e),i=`universal`;if(r.installBundle){await r.installBundle(t,{mode:i,signal:n.signal});return}let a=S().files,o=await a.makeTempDirectory(`agent-device-aab-`),s=D.join(o,`bundle.apks`);try{await ao([`build-apks`,`--bundle`,t,`--output`,s,`--mode`,i],n.signal,n.environment??S().environment),await ao([`install-apks`,`--apks`,s,`--device-id`,e.id],n.signal,n.environment??S().environment)}finally{await a.remove(o,{recursive:!0,force:!0})}}async function co(e,t,n={}){if(oo(t)){await so(e,t,n);return}await We(t,{device:e,replace:!0,signal:n.signal})}async function lo(e,t,n={}){await yt(e,async()=>{e.booted||await ut(e.id,void 0,n.signal),await co(e,t,n)})}const uo=[`mInputShown`,`mIsInputViewShown`,`isInputViewShown`,`mDecorViewVisible`,`mWindowVisible`,`mInShowWindow`],fo=new Map([[2,`number`],[3,`phone`],[4,`datetime`]]),po=new Set([32,208]),mo=new Set([128,224,144]);async function ho(e){return await V(b(e))}async function V(e){let t=await x(e,[`dumpsys`,`input_method`],{allowFailure:!0});if(t.exitCode!==0)throw T(`Failed to query Android keyboard state`,t);return vo(t.stdout)}async function go(e){return await _o(b(e))}async function _o(e){let n=await V(e),r=n,i=0;for(;r.visible&&i<2;)await x(e,[`input`,`keyevent`,`111`]),i+=1,await _(120),r=await V(e);if(n.visible&&r.visible)throw new t(`UNSUPPORTED_OPERATION`,`Android keyboard dismiss is unavailable for the current IME without back navigation.`,{attempts:i,inputType:r.inputType,type:r.type,inputMethodPackage:r.inputMethodPackage,focusedPackage:r.focusedPackage,focusedResourceId:r.focusedResourceId,inputOwner:r.inputOwner});return{attempts:i,wasVisible:n.visible,dismissed:n.visible&&!r.visible,visible:r.visible,inputType:r.inputType,type:r.type,inputMethodPackage:r.inputMethodPackage,focusedPackage:r.focusedPackage,focusedResourceId:r.focusedResourceId,inputOwner:r.inputOwner}}function vo(e){let t=Co(e)??yo(e),n=bo(e),r=xo(e,/\bpackageName=([A-Za-z0-9_.]+)\b/g),i=xo(e,/\b(?:resourceId|resource-id)=([^\s,}]+)/g),a=p(e),o=ee(r,i,a);return So(r,i,a),{visible:t??!1,inputType:n,type:n?Do(n):void 0,inputMethodPackage:a,focusedPackage:r,focusedResourceId:i,inputOwner:o}}function yo(e){let t=e.match(/\bmImeWindowVis=0x([0-9a-fA-F]+)\b/)?.[1];if(!t)return null;let n=Number.parseInt(t,16);return Number.isNaN(n)?null:!!(n&1)}function bo(e){let t=xo(e,/\binputType=0x([0-9a-fA-F]+)\b/gi);return t?`0x${t.toLowerCase()}`:void 0}function xo(e,t){let n;for(let r of e.matchAll(t))n=r[1];return n}function So(e,t,n){n||!d(e)&&!l(t)||g({level:`warn`,phase:`android_input_ownership_fallback`,data:{focusedPackage:e,focusedResourceId:t}})}function Co(e){return To(wo(e,uo))}function wo(e,t){let n=new Map,r=RegExp(`\\b(${t.join(`|`)})=([a-zA-Z]+)\\b`,`g`);for(let t of e.matchAll(r)){let e=t[1],r=t[2]?.toLowerCase();!e||r!==`true`&&r!==`false`||n.set(e,r===`true`)}return n}function To(e){if(e.size===0)return null;let t=Eo(e,[`mWindowVisible`,`mDecorViewVisible`,`mInShowWindow`]);if(t!==void 0)return t;let n=e.get(`mInputShown`);return n===void 0?Eo(e,[`mIsInputViewShown`,`isInputViewShown`])??null:n}function Eo(e,t){for(let n of t){let t=e.get(n);if(t!==void 0)return t}}function Do(e){let t=Number.parseInt(e.replace(/^0x/i,``),16);if(Number.isNaN(t))return`unknown`;let n=t&15,r=fo.get(n);if(r)return r;if(n!==1)return`unknown`;let i=t&4080;return po.has(i)?`email`:mo.has(i)?`password`:`text`}async function Oo(e){return await ko(b(e))}async function ko(e){return No(await Mo(e,[`cmd`,`clipboard`,`get`,`text`],`read`))}async function Ao(e,t){await jo(b(e),t)}async function jo(e,t){await Mo(e,[`cmd`,`clipboard`,`set`,`text`,t],`write`)}async function Mo(e,t,n){let{androidClipboardShellCommandUnavailableError:r,classifyAndroidClipboardShellResponse:i}=await import(`./clipboard-shell-response.js`),a=await x(e,t,{allowFailure:!0}),o=i(a);if(o===`no-shell-command`)throw r(n);if(o===`call-failed`)throw T(`Failed to ${n} Android clipboard text`,a);return a.stdout}function No(e){let t=e.replaceAll(`\r
 `,`
-`).replace(/\n$/,``),n=t.match(/^clipboard text:\s*(.*)$/i);return n?n[1]??``:t.trim().toLowerCase()===`null`?``:t}const ko=`com.callstack.agentdevice.imehelper`,Ao=`android-ime-helper-v1`;async function jo(e){return e.imeHelperArtifact??await Mo()}async function Mo(){return await x().resolveHelperArtifact({helperDirName:`ime-helper`,manifestFileName:e=>`agent-device-android-ime-helper-${e}.manifest.json`,parseManifest:No,unavailableMessage:`Android test IME text entry requires the bundled Android IME helper artifact, but it was not found or could not be read`})}const H=`IME helper`;function No(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`Android IME helper manifest must be an object.`);let n=e;return{name:O(n.name,`name`,`android-ime-helper`,H),version:Cn(n.version,`version`,H),assetName:Cn(n.assetName,`assetName`,H),sha256:wn(n.sha256,H),packageName:O(n.packageName,`packageName`,ko,H),versionCode:Sn(n.versionCode,`versionCode`,H),serviceComponent:O(n.serviceComponent,`serviceComponent`,`com.callstack.agentdevice.imehelper/.TestInputMethodService`,H),broadcastProtocol:O(n.broadcastProtocol,`broadcastProtocol`,Ao,H)}}const Po=new Set;async function Fo(e){return await x().ensureHelperInstalled({cache:Po,installTimeoutMs:3e4,helperLabel:`Android IME helper`},e)}function Io(){Po.clear()}function U(e){return`${e.platform}:${e.id}`}function Lo(e){return e===ko}async function Ro(e,t,n){await Bo(e,t,`com.callstack.agentdevice.imehelper.ACTION_INPUT_TEXT_B64`,{text:Buffer.from(n,`utf8`).toString(`base64`)})}async function zo(e,t){await Bo(e,t,`com.callstack.agentdevice.imehelper.ACTION_CLEAR_TEXT`,{})}async function Bo(e,t,n,r){let i=[`am`,`broadcast`,`-p`,t,`-a`,n];i.push(`--es`,`protocol`,Ao);for(let[e,t]of Object.entries(r))i.push(`--es`,e,t);let a=await b(e,i,{allowFailure:!0,timeoutMs:1e4});if(a.exitCode!==0)throw w(`Android IME helper broadcast failed`,a,{action:n,packageName:t})}const Vo=`agent_device_ime_helper_previous_ime`,Ho=`secure`,Uo=`default_input_method`,Wo={previousIme:Vo,defaultInputMethod:Uo};async function W(e){let t=await b(e,[`settings`,`get`,Ho,Uo],{allowFailure:!0,timeoutMs:5e3});return Yo(t.exitCode===0?t.stdout:``)}async function G(e){let t=await b(e,[`settings`,`get`,Ho,Vo],{allowFailure:!0,timeoutMs:5e3});return Yo(t.exitCode===0?t.stdout:``)||void 0}async function Go(e,t){return(await b(e,[`settings`,`put`,Ho,Vo,t],{allowFailure:!0,timeoutMs:5e3})).exitCode===0&&await G(e)===t}async function Ko(e){await b(e,[`settings`,`delete`,Ho,Vo],{allowFailure:!0,timeoutMs:5e3})}async function qo(e,t,r){try{(t?await Go(e,t):await Jo(e))||S({level:`warn`,phase:`android_test_ime_record_rollback_failed`,data:{device:r,hadPriorRecord:t!==void 0}})}catch(e){S({level:`warn`,phase:`android_test_ime_record_rollback_failed`,data:{device:r,hadPriorRecord:t!==void 0,error:n(e).message}})}}async function Jo(e){return await Ko(e),await G(e)===void 0}function Yo(e){let t=e.trim();return!t||t===`null`?``:t}const K=new Set,Xo=new Map;function Zo(e){return K.has(U(e))}function Qo(e,t,n){return Pt(Xo,`${e}:${t}`,n)}function $o(){K.clear()}function es(e,t){let n=U(e);t?K.add(n):K.delete(n)}async function ts(e,t){return await Qo(t.stateDir,e.id,async()=>{let n=U(e);if(!K.has(n))return{restored:!1,reason:`no-record`};K.delete(n);let r=await rs(y(e),e);return ns(r.reason)&&await x().imeRecoveryMarkers.clear(t.stateDir,e.id),r})}function ns(e){return e===`ok`||e===`helper-not-active`||e===`no-record`}async function rs(e,t){let n=t.id;if(K.has(U(t)))return{restored:!1,reason:`owned-by-live-session`};let r=await G(e);if(!r)return{restored:!1,reason:`no-record`};let i=await W(e);if(i!==`com.callstack.agentdevice.imehelper/.TestInputMethodService`)return S({level:`debug`,phase:`android_test_ime_restore_skipped`,data:{device:n,currentIme:i,previousIme:r}}),{restored:!1,previousIme:r,reason:`helper-not-active`};await b(e,[`ime`,`set`,r],{allowFailure:!0,timeoutMs:1e4});let a=await W(e);return a===r?(await Ko(e).catch(()=>{}),S({phase:`android_test_ime_restored`,data:{device:n,previousIme:r}}),{restored:!0,previousIme:r,reason:`ok`}):(S({level:`warn`,phase:`android_test_ime_restore_failed`,data:{device:n,previousIme:r,afterIme:a}}),{restored:!1,previousIme:r,reason:`set-failed`})}async function is(e){let t=x().imeRecoveryMarkers,r=await t.read(e.stateDir);if(r.length===0)return;let i;try{i=new Set(await e.listSerials())}catch(e){S({level:`debug`,phase:`android_test_ime_startup_scan_failed`,data:{error:n(e).message}});return}for(let a of r){if(!i.has(a))continue;let r={platform:`android`,id:a,name:a,kind:a.startsWith(`emulator-`)?`emulator`:`device`,booted:!0};try{await Qo(e.stateDir,a,async()=>{let n=await rs(y(r),r);n.restored&&S({level:`warn`,phase:`android_test_ime_orphan_restored`,data:{device:a,previousIme:n.previousIme}}),ns(n.reason)&&await t.clear(e.stateDir,a)})}catch(e){S({level:`debug`,phase:`android_test_ime_orphan_restore_failed`,data:{device:a,error:n(e).message}})}}}async function as(){x();try{return(await Ne(Xe([`devices`]),{timeoutMs:5e3})).stdout.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0&&!e.startsWith(`List of devices`)).map(e=>e.split(/\s+/)).filter(e=>e[1]===`device`).map(e=>e[0])}catch{return[]}}const os=2e3;async function ss(e=x().environment,t=x().files){let n=e.ANDROID_HOME||e.ANDROID_SDK_ROOT,r=await ys(n,t),i=await Nt(`adb`,[`version`]);return i?hs({license:r,sdkRoot:n,versionLine:i}):vs(n,r)}async function cs(e,t){if(e.platform!==`android`)return[];let n=y(e,t.transportOverrides.androidAdb),r=[];return t.shouldProbeMetro&&r.push(await ms(n,e.id,t.metroPort)),r.push(await ls(n,e)),r}async function ls(e,t){try{let n=await W(e),r=Zo(t);return n===await us()&&!r?await ds(e,t,n):fs(t,n,r)}catch(e){return ps(e)}}async function us(){try{return(await Mo()).manifest.serviceComponent}catch{return}}async function ds(e,t,n){let r=(await b(e,[`settings`,`get`,`secure`,Wo.previousIme],{allowFailure:!0,timeoutMs:os})).stdout.trim(),i=r&&r!==`null`?r:void 0;return{id:`android-test-ime`,status:`fail`,summary:`Android test IME helper is the active input method on ${t.id}, but no active session owns it -- likely left over from a crashed session.`,hint:`A stuck test IME leaves the real keyboard unavailable on this device until restored.`,command:i?`adb -s ${t.id} shell ime set ${i}`:`adb -s ${t.id} shell ime list -s`,evidence:{currentIme:n,previousIme:i}}}function fs(e,t,n){return{id:`android-test-ime`,status:`pass`,summary:n?`Android test IME helper is active for this session on ${e.id}.`:`Android test IME helper is not active on ${e.id}; the device's normal IME is in use.`,evidence:{currentIme:t}}}function ps(e){let t=n(e);return{id:`android-test-ime`,status:`warn`,summary:`Could not inspect the Android test IME helper state.`,hint:t.message,evidence:{code:t.code}}}async function ms(e,t,r){try{let n=await e([`reverse`,`--list`],{allowFailure:!0,timeoutMs:os}),i=`tcp:${r} tcp:${r}`,a=n.stdout.includes(i);return{id:`android-reverse`,status:a?`pass`:`warn`,summary:a?`Android adb reverse exists for Metro port ${r}.`:`Android adb reverse is missing for Metro port ${r}.`,command:a?void 0:`adb -s ${t} reverse tcp:${r} tcp:${r}`,evidence:{stdout:n.stdout.trim()}}}catch(e){let t=n(e);return{id:`android-reverse`,status:`warn`,summary:`Could not inspect Android adb reverse mappings.`,hint:t.message,evidence:{code:t.code}}}}function hs(e){return{id:`toolchain`,status:gs(e),summary:e.versionLine?`Android toolchain: ${e.versionLine}; ${_s(e.sdkRoot)}.`:`Android toolchain: adb is present but version check failed.`,hint:e.license===`missing`?`Accept Android SDK licenses before installing/building apps.`:void 0,command:e.license===`missing`?`sdkmanager --licenses`:void 0,evidence:{adbVersion:e.versionLine??null,androidHome:e.sdkRoot??null,license:e.license}}}function gs(e){return e.versionLine&&e.sdkRoot&&e.license!==`missing`?`pass`:`info`}function _s(e){return e?`ANDROID_HOME/ANDROID_SDK_ROOT set`:`ANDROID_HOME unset`}function vs(e,t){return{id:`toolchain`,status:`info`,summary:`Android toolchain: adb not found on PATH.`,hint:`Install Android platform-tools or add adb to PATH.`,evidence:{androidHome:e??null,license:t}}}async function ys(e,t){if(!e)return`unknown`;try{return await t.access(E.join(e,`licenses`,`android-sdk-license`)),`accepted`}catch{return`missing`}}function bs(e,t){if(!t)return{expected:e,actual:null,failureReason:`text_mismatch`,targetInput:null,actualInput:null};let n=ws(t),r={failureReason:t.reason??`text_mismatch`,targetInput:Ss(t.targetInput),actualInput:Ss(t.actualInput)};return n?{...r,expectedLength:Array.from(e).length,actual:null,masked:!0,actualLength:Array.from(t.actual??``).length}:{...r,expected:e,actual:t.actual}}function q(e){return e?e.password?!0:xs(e.text):!1}function xs(e){return e?Array.from(e).every(Cs):!1}function Ss(e){if(!e)return null;let t=q(e);return{...e,text:t?null:e.text,...t?{textRedacted:!0}:{}}}function Cs(e){return e===`•`||e===`*`||e===`●`}function ws(e){return e.masked===!0||q(e.targetInput)||q(e.actualInput)}const Ts=new WeakMap;function Es(e,t){return t&&Ts.set(e,t),e}function Ds(e){return Ts.get(e)}function Os(e){return e.clickable}function ks(e){return e.focusable||e.focused===!0}function J(e){return Os(e)||ks(e)}function As(e){let t=e.trim();return t?/^[\w.]+:id\/[\w.-]+$/i.test(t):!1}function js(e,t){return{raw:e,...t?{effectiveRect:t}:{}}}function Ms(e,t,n){if(!e)return;let r=Fs(e);return t&&(r=Ps(r,t)),n&&(r=Ps(r,n)),r}function Ns(e){return{...e.raw,...e.effectiveRect?{rect:e.effectiveRect}:{rect:void 0},hittable:e.raw.hittable===!0&&ae(e.effectiveRect)?!0:void 0}}function Ps(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height),o=i>n&&a>r;return{x:o?n:e.x,y:o?r:e.y,width:o?i-n:0,height:o?a-r:0}}function Fs(e){return{x:e.x,y:e.y,width:Math.max(0,e.width),height:Math.max(0,e.height)}}function Is(e,t){let n=new Set;return Ls(e,n,t),zs(e,n,t),n}function Ls(e,t,n){for(let r of e.children){if(n?.check(`work`),r.visibleToUser===!1){t.add(r);continue}Ls(r,t,n)}}function Rs(e,t,n){return n?.check(`work`),e.children.filter(e=>!t.has(e)&&e.visibleToUser!==!1)}function zs(e,t,n){let r=Rs(e,t,n).filter(Vs);if(r.length<2)return;let i=r.filter(e=>Hs(e)&&Us(e));if(i.length===0)return;let a=Bs(i);for(let r of Rs(e,t,n))n?.check(`work`),Hs(r)&&(Us(r)&&(a===void 0||r.windowLayer===a)||t.add(r))}function Bs(e){let t=e.map(e=>e.windowLayer).filter(e=>e!==void 0);return t.length>0?Math.max(...t):void 0}function Vs(e){return e.windowIndex!==void 0||e.windowType!==void 0}function Hs(e){return e.windowType===1}function Us(e){return e.windowActive===!0||e.windowFocused===!0}function Ws(e,t,n,r,i){let a=new Set(e.sourceNodes),o=Ks(t,i),s=Gs(o,n,qs(o,a,i),i);if(!s)return{nodes:[],sourceNodes:[]};let c=new Set(Ks([s],i)),l=[];for(let[t,n]of e.sourceNodes.entries())i.check(`work`),c.has(n)&&l.push(t);if(l.length===0)return{nodes:[],sourceNodes:[]};let u=1/0;for(let t of l)i.check(`work`),u=Math.min(u,e.nodes[t]?.depth??0);let d=[];for(let t of l)i.check(`work`),(e.nodes[t]?.depth??0)-u<=r&&d.push(t);return i.consume(d.length),{nodes:oe(d.map(t=>e.nodes[t]),u),sourceNodes:d.map(t=>e.sourceNodes[t])}}function Gs(e,t,n,r){for(let i of e)if(r.check(`work`),se(i,t)&&n.has(i))return i;return null}function Ks(e,t){let n=[],r=[...e].reverse();for(;r.length>0;){t.check(`work`);let e=r.pop();n.push(e);for(let n=e.children.length-1;n>=0;--n)t.check(`work`),r.push(e.children[n])}return n}function qs(e,t,n){let r=new Set;for(let i=e.length-1;i>=0;--i){n.check(`work`);let a=e[i];if(t.has(a)){r.add(a);continue}for(let e of a.children)if(n.check(`work`),r.has(e)){r.add(a);break}}return r}function Js(e,t,n,r,i){if(e.visibleToUser===!1)return!1;let a=Ys(e);return t.interactiveOnly?Xs(e,a,n,r,i):a.isStructural||a.isVisual?$s(e,a,r):!0}function Ys(e){let t=tc(e.type),n=!!(e.label&&e.label.trim().length>0),r=!!(e.identifier&&e.identifier.trim().length>0);return{type:t,hasMeaningfulText:n&&!As(e.label??``),hasMeaningfulId:r&&!As(e.identifier??``),isStructural:nc(t),isVisual:t===`imageview`||t===`imagebutton`}}function Xs(e,t,n,r,i){return Qs(e)?!1:J(e)||ie(t.type)&&r?!0:Zs(t,n,r,i)}function Zs(e,t,n,r){return!e.hasMeaningfulText&&!e.hasMeaningfulId||e.isVisual||e.isStructural&&!r&&!t?!1:t||n||r}function Qs(e){return!!(e.rect&&(e.rect.width<=0||e.rect.height<=0))}function $s(e,t,n){return J(e)||t.hasMeaningfulText||t.hasMeaningfulId?!0:n}function ec(e){if(!e)return!1;let t=tc(e);return t.includes(`recyclerview`)||t.includes(`listview`)||t.includes(`gridview`)}function tc(e){return e?e.toLowerCase():``}function nc(e){let t=e.split(`.`).pop()??e;return t.includes(`layout`)||t===`viewgroup`||t===`view`}function rc(e,t,n,r){return{...js(e,t),...n?{clipsDescendants:!0}:{},...r?{windowRect:r}:{}}}const ic=`ANDROID_SNAPSHOT_PRESENTATION_FAILED`;var Y=class extends Error{code=ic;qualityReasonCode=`presentation-failed`;details;analysis;constructor(e,t,n){super(e),this.name=`AndroidSnapshotPresentationFailure`,this.details=t,this.analysis=n}};function ac(e){return e instanceof Y?e.code===ic:!!(e&&typeof e==`object`&&e.code===ic)}var oc=class{workUnits=0;options;defaultMaxWorkUnits;deadlineAtMs;constructor(e,t){this.options=e,this.defaultMaxWorkUnits=t;let n=e.now??Date.now;this.deadlineAtMs=e.deadlineAtMs??n()+dc()}get workUnitCount(){return this.workUnits}check(e){this.consume(1)}consume(e){this.workUnits+=e;let t=this.options.maxWorkUnits??this.defaultMaxWorkUnits;if(this.workUnits>t)throw new Y(`Android snapshot presentation exceeded its linear work budget`,{phase:`complexity`,workUnits:this.workUnits,maxWorkUnits:t});if((this.options.now??Date.now)()>=this.deadlineAtMs)throw new Y(`Android snapshot presentation exceeded its cooperative deadline`,{phase:`deadline`,workUnits:this.workUnits,deadlineAtMs:this.deadlineAtMs,maxWorkUnits:t})}};function sc(e,t){return new oc(e??{},t)}function cc(e,t,n){let r=new Map;for(let i of e){n.check(`regular-invariant`);let e=lc(i,r,t),a=i.effectiveRect;if(!a||!ae(a)){if(Ns(i).hittable===!0)throw new Y(`Android regular snapshot node ${i.raw.index} with degenerate effective geometry was marked hittable`,{phase:`regular-invariant`,workUnits:n.workUnitCount,nodeIndex:i.raw.index,frame:a});r.set(i.raw.index,e);continue}if(e&&!uc(a,e))throw new Y(`Android regular snapshot node ${i.raw.index} escaped its cumulative clip`,{phase:`regular-invariant`,workUnits:n.workUnitCount,nodeIndex:i.raw.index,frame:a,clip:e});r.set(i.raw.index,i.clipsDescendants?a:e)}}function lc(e,t,n){let r=e.raw.parentIndex;return r===void 0?e.windowRect??n:t.get(r)??e.windowRect??n}function uc(e,t){let n=1e-4;return e.x>=t.x-n&&e.y>=t.y-n&&e.x+e.width<=t.x+t.width+n&&e.y+e.height<=t.y+t.height+n}function dc(){return 250}function fc(e,t,n){let r=n.depth??1/0,i=ce(n.scope),a=Ac(e),o=sc(n.androidPresentation,Math.max(1024,a.rawNodeCount*128)),s={nodes:[],sourceNodes:[],...t===void 0?{}:{maxNodes:t},maxDepth:i?1/0:r,options:n,analysis:a,interactiveDescendantMemo:new Map,hidden:new Set,presentationBudget:o,presentationNodes:[],truncated:!1};try{o.check(`work`),s.viewport=Cc(e,o),s.hidden=n.raw?new Set:Is(e,o);for(let t of e.children)if(mc(s,t,0),s.truncated)break;n.raw||cc(s.presentationNodes,s.viewport,o);let t=s.nodes,a=new Map(s.sourceNodes.map((e,t)=>[e,t])),{nodes:c,sourceNodes:l}=i?Ws(s,e.children,i,r,o):s,u={nodes:c,sourceNodes:l,occlusionContext:{nodes:t,sourceIndexByNodeIndex:new Map(l.flatMap((e,t)=>{let n=a.get(e),r=c[t]?.index;return n===void 0||r===void 0?[]:[[r,n]]})),androidSiblingOrderByNodeIndex:pc(s.sourceNodes)},analysis:s.analysis};return s.truncated?{...u,truncated:!0}:u}catch(e){throw ac(e)&&(e.analysis??=s.analysis),e}}function pc(e){let t=new Map,n=new Map;for(let[r,i]of e.entries()){let e=Ds(i);if(!e)continue;let a=t.get(e.parent);a===void 0&&(a=t.size,t.set(e.parent,a)),n.set(r,{group:a,order:e.order})}return n}function mc(e,t,n,r,i=!1,a=!1,o=!1,s,c){if(e.presentationBudget.check(`work`),hc(e,t,n))return;let l=t.windowRect??s??e.viewport,u=gc(e,t,c,l),d=_c(e,t,r,i,a,o,u,l),f=i||J(t),p=a||ec(t.type),ee=vc(e,t,u,c);yc(e,t,n,d,f,p,o||st(t.identifier),l,ee)}function hc(e,t,n){return e.maxNodes!==void 0&&e.nodes.length>=e.maxNodes?(e.truncated=!0,!0):n>e.maxDepth||e.hidden.has(t)}function gc(e,t,n,r){return e.options.raw?t.rect:Ms(t.rect,r,n)}function _c(e,t,n,r,i,a,o,s){return!e.options.raw&&!Js(t,e.options,r,Ec(e,t),i)?n:bc(e,t,n,a||st(t.identifier),o,s)}function vc(e,t,n,r){return e.options.raw||!wc(t)?r:n}function yc(e,t,n,r,i,a,o,s,c){for(let l of t.children)if(mc(e,l,n+1,r,i,a,o,s,c),e.truncated)return}function bc(e,t,n,r,i,a){let o=e.nodes.length;return e.sourceNodes.push(t),Sc(e,t,xc(e,t,n,r),i,a),o}function xc(e,t,n,r){return{index:e.nodes.length,type:t.type??void 0,label:t.label??void 0,value:t.value??void 0,identifier:t.identifier??void 0,bundleId:t.packageName??void 0,rect:t.rect,enabled:t.enabled,focused:t.focused,selected:t.selected,editable:t.editable,password:t.password,hintShowing:t.hintShowing,selectionStart:t.selectionStart,selectionEnd:t.selectionEnd,visibleToUser:t.visibleToUser,hittable:J(t)||void 0,depth:Tc(e.nodes,n),parentIndex:n,...Dc(t,e.hidden),...r?{systemChrome:!0}:{}}}function Sc(e,t,n,r,i){let a=rc(n,r,!e.options.raw&&wc(t),i);e.presentationNodes.push(a),e.nodes.push(e.options.raw?a.raw:Ns(a))}function Cc(e,t){let n=[],r=[...e.children];for(;r.length>0;){t.check(`work`);let e=r.pop();ae(e.windowRect)&&n.push(e.windowRect),r.push(...e.children)}return re(n)??void 0}function wc(e){return e.scrollable===!0&&ie(e.type)}function Tc(e,t){return t===void 0?0:(e[t]?.depth??-1)+1}function Ec(e,t){let n=e.interactiveDescendantMemo.get(t);if(n!==void 0)return n;for(let n of t.children)if(!e.hidden.has(n)&&n.visibleToUser!==!1&&(J(n)||Ec(e,n)))return e.interactiveDescendantMemo.set(t,!0),!0;return e.interactiveDescendantMemo.set(t,!1),!1}function Dc(e,t){return Oc(e,t)?{...e.canScrollBackward?{hiddenContentAbove:!0}:{},...e.canScrollForward?{hiddenContentBelow:!0}:{}}:{}}function Oc(e,t){if(!e.scrollable||!ie(e.type)||`${e.type??``}`.toLowerCase().includes(`horizontalscrollview`))return!1;let n=kc(e,t);return!(n&&n.horizontal>n.vertical&&n.horizontal>16)}function kc(e,t){let n=e.children.filter(e=>!t.has(e)&&e.visibleToUser!==!1);if(!e.rect||n.length===0)return null;let r=n.map(e=>e.rect).filter(e=>e!==void 0);if(r.length===0)return null;let i=Math.min(...r.map(e=>e.x)),a=Math.max(...r.map(e=>e.x+e.width)),o=Math.min(...r.map(e=>e.y)),s=Math.max(...r.map(e=>e.y+e.height));return{horizontal:Math.max(0,a-i-e.rect.width),vertical:Math.max(0,s-o-e.rect.height)}}function Ac(e){let t=0,n=0,r=[...e.children];for(;r.length>0;){let e=r.pop();t+=1,n=Math.max(n,e.depth),r.push(...e.children)}return{rawNodeCount:t,maxDepth:n}}function jc(){let e=[],t=()=>e.at(-1)===!0;return{open(n,r){let i=t()||st(n);return r||e.push(i),i},close(){e.pop()}}}function*Mc(e){let t=/<node\b[^>]*>|<\/node>/g,n=jc(),r=t.exec(e);for(;r;){let i=r[0];if(i.startsWith(`</node`))n.close();else{let e=Nc(i);yield n.open(e.resourceId,i.endsWith(`/>`))?{...e,systemChrome:!0}:e}r=t.exec(e)}}function Nc(e){let t=Pc(e),n=Ft(t.bounds);return{...t,...n?{rect:n}:{}}}function Pc(e){let t=Fc(e),n=e=>Uc(t,e),r=e=>{let t=n(e);if(t!==null)return t===`true`},i=e=>{let t=n(e);if(t===null||t.trim()===``)return;let r=Number(t);return Number.isFinite(r)?r:void 0},a=(e,t)=>{let n=i(t);return n===void 0?{}:{[e]:n}},o=(e,t)=>{let r=Ft(n(t));return r===void 0?{}:{[e]:r}},s=(e,t)=>{let n=r(t);return n===void 0?{}:{[e]:n}};return{text:n(`text`),desc:n(`content-desc`),resourceId:n(`resource-id`),packageName:n(`package`),className:n(`class`),bounds:n(`bounds`),clickable:r(`clickable`),enabled:r(`enabled`),focusable:r(`focusable`),focused:r(`focused`),password:r(`password`),...s(`editable`,`editable`),...a(`selectionStart`,`selection-start`),...a(`selectionEnd`,`selection-end`),...s(`hintShowing`,`hint-showing`),...s(`visibleToUser`,`visible-to-user`),...s(`selected`,`selected`),...a(`drawingOrder`,`drawing-order`),...s(`scrollable`,`scrollable`),...s(`canScrollForward`,`can-scroll-forward`),...s(`canScrollBackward`,`can-scroll-backward`),...a(`windowIndex`,`window-index`),...a(`windowType`,`window-type`),...a(`windowLayer`,`window-layer`),...s(`windowActive`,`window-active`),...s(`windowFocused`,`window-focused`),...o(`windowRect`,`window-bounds`)}}function Fc(e){let t=new Map,n=e.indexOf(` `),r=e.lastIndexOf(`>`);if(n<0||r<=n)return t;let i=n;for(;i<r;){let n=Ic(e,i,r);if(!n)break;t.set(n.name,n.value),i=n.nextCursor}return t}function Ic(e,t,n){if(t=Rc(e,t,n),t>=n||zc(e[t]))return;let r=t;t=Lc(e,t,n);let i=e.slice(r,t);if(t=Rc(e,t,n),!i||e[t]!==`=`)return;t=Rc(e,t+1,n);let a=e[t];if(!Bc(a))return;let o=t+1,s=e.indexOf(a,o);if(!(s<0||s>=n))return{name:i,value:It(e.slice(o,s)),nextCursor:s+1}}function Lc(e,t,n){for(;t<n&&!Hc(e[t]??``);)t+=1;return t}function Rc(e,t,n){for(;t<n&&Vc(e[t]??``);)t+=1;return t}function zc(e){return e===`/`||e===`>`}function Bc(e){return e===`"`||e===`'`}function Vc(e){return e===` `||e===`
-`||e===`\r`||e===`	`}function Hc(e){return e===`=`||e===`/`||e===`>`||Vc(e)}function Uc(e,t){return e.get(t)??null}function Wc(e){let t={type:null,label:null,value:null,identifier:null,packageName:null,clickable:!1,focusable:!1,depth:-1,children:[]},n=[t],r=/<node\b[^>]*>|<\/node>/g,i=r.exec(e);for(;i;){let t=i[0];if(t.startsWith(`</node`)){n.length>1&&n.pop(),i=r.exec(e);continue}let a=Nc(t),o=n.at(-1),s=Gc(a,o.depth+1,o);o.children.push(s),t.endsWith(`/>`)||n.push(s),i=r.exec(e)}return t}function Gc(e,t,n){return Es({type:e.className,label:e.text||e.desc,value:e.text,identifier:e.resourceId,packageName:e.packageName,rect:e.rect,enabled:e.enabled,focused:e.focused,selected:e.selected,editable:e.editable,password:e.password,hintShowing:e.hintShowing,selectionStart:e.selectionStart,selectionEnd:e.selectionEnd,visibleToUser:e.visibleToUser,clickable:e.clickable===!0,focusable:e.focusable===!0,scrollable:e.scrollable,canScrollForward:e.canScrollForward,canScrollBackward:e.canScrollBackward,windowIndex:e.windowIndex,windowType:e.windowType,windowLayer:e.windowLayer,windowActive:e.windowActive,windowFocused:e.windowFocused,windowRect:e.windowRect,depth:t,parentIndex:void 0,children:[]},e.drawingOrder===void 0?void 0:{parent:n,order:e.drawingOrder})}function Kc(e){let t=new Map;return e.nodes.forEach((n,r)=>{t.set(n.index,e.sourceNodes[r]?.clickable)}),{kind:`exact`,provider:`android-helper`,clickableByNodeIndex:t}}const qc=new Set([`android`,`com.android.systemui`]);function Jc(e,t,n={}){if(t.backend!==`android-helper`)return{outcome:`ok`};let r=al(e,n.foregroundAppPackage);return Zc(r,t)?Yc(r,t,`empty-helper-output`,`Android snapshot helper returned no accessibility nodes`):rl(r)?{outcome:`ok`}:Xc(r)?{outcome:`system-surface-only`}:Qc(r)?{outcome:`ok`}:$c(r)?Yc(r,t,`content-poor-app-window`,`Android snapshot helper returned insufficient foreground app content`):el(r)||tl(r,t)?Yc(r,t,`content-poor-app-window`,`Android snapshot helper returned insufficient application window content`):nl(r)?Yc(r,t,`system-window-only`,`Android snapshot helper returned only non-application windows`):{outcome:`ok`}}function Yc(e,t,n,r){return{outcome:`unusable`,decision:il(e,t,n,r)}}function Xc(e){return e.windowRootCount>0&&e.applicationWindowRootCount===0&&e.activeSystemSurfaceMeaningfulNodeCount>=3}function Zc(e,t){return e.nodeCount===0||t.nodeCount===0||t.rootPresent===!1}function Qc(e){return $c(e)&&e.inputMethodMeaningfulNodeCount>=2}function $c(e){let t=e.foregroundAppMeaningfulNodeCount;return t===void 0?!1:t===0?e.applicationMeaningfulNodeCount<2:t<2&&e.meaningfulNodeCount>t}function el(e){return e.foregroundAppMeaningfulNodeCount===void 0&&e.applicationWindowRootCount>0&&e.applicationMeaningfulNodeCount<2}function tl(e,t){return e.foregroundAppMeaningfulNodeCount===void 0&&e.windowRootCount===0&&(t.windowCount??0)>1&&e.nonSystemMeaningfulNodeCount<2}function nl(e){return e.windowRootCount>0&&e.applicationWindowRootCount===0||e.windowRootCount===0&&e.nodeCount>0&&e.systemUiNodeCount===e.nodeCount}function rl(e){return e.hasAlertButtonIdentifier&&e.hasAlertContentIdentifier}function il(e,t,n,r){return{reason:n,failureReason:r,diagnostics:yl(e,t)}}function al(e,t){let n=ol(t);for(let t of Mc(e))sl(n,t);return ml(n)}function ol(e){return{nodeCount:0,systemUiNodeCount:0,windowRootCount:0,applicationWindowRootCount:0,activeSystemSurfaceMeaningfulNodeCount:0,meaningfulNodeCount:0,applicationMeaningfulNodeCount:0,nonSystemMeaningfulNodeCount:0,inputMethodMeaningfulNodeCount:0,hasAlertButtonIdentifier:!1,hasAlertContentIdentifier:!1,...e===void 0?{}:{foregroundAppPackage:e,foregroundAppMeaningfulNodeCount:0},windowTypes:new Set}}function sl(e,t){e.nodeCount+=1,vl(t.packageName)&&(e.systemUiNodeCount+=1),t.visibleToUser!==!1&&cl(e,t.resourceId),ll(e,t),ul(e,t)}function cl(e,t){let n=en(t);n===`button`&&(e.hasAlertButtonIdentifier=!0),n===`content`&&(e.hasAlertContentIdentifier=!0)}function ll(e,t){t.windowType!==void 0&&(e.currentWindowType=t.windowType,e.currentWindowActiveOrFocused=t.windowActive===!0||t.windowFocused===!0,e.windowRootCount+=1,e.windowTypes.add(t.windowType),t.windowType===1&&(e.applicationWindowRootCount+=1))}function ul(e,t){hl(t)&&(e.meaningfulNodeCount+=1,dl(e,t),pl(e,t))}function dl(e,t){e.currentWindowType===1&&!_l(t.packageName)&&(e.applicationMeaningfulNodeCount+=1),fl(e)&&!ot(t)&&(e.activeSystemSurfaceMeaningfulNodeCount+=1)}function fl(e){return e.currentWindowType!==void 0&&e.currentWindowType!==1&&e.currentWindowActiveOrFocused===!0}function pl(e,t){_l(t.packageName)||(e.nonSystemMeaningfulNodeCount+=1),p({packageName:t.packageName,resourceId:t.resourceId})&&(e.inputMethodMeaningfulNodeCount+=1),e.foregroundAppPackage!==void 0&&t.packageName===e.foregroundAppPackage&&(e.foregroundAppMeaningfulNodeCount=(e.foregroundAppMeaningfulNodeCount??0)+1)}function ml(e){return{nodeCount:e.nodeCount,systemUiNodeCount:e.systemUiNodeCount,windowRootCount:e.windowRootCount,applicationWindowRootCount:e.applicationWindowRootCount,activeSystemSurfaceMeaningfulNodeCount:e.activeSystemSurfaceMeaningfulNodeCount,meaningfulNodeCount:e.meaningfulNodeCount,applicationMeaningfulNodeCount:e.applicationMeaningfulNodeCount,nonSystemMeaningfulNodeCount:e.nonSystemMeaningfulNodeCount,inputMethodMeaningfulNodeCount:e.inputMethodMeaningfulNodeCount,hasAlertButtonIdentifier:e.hasAlertButtonIdentifier,hasAlertContentIdentifier:e.hasAlertContentIdentifier,...e.foregroundAppPackage===void 0?{}:{foregroundAppPackage:e.foregroundAppPackage,foregroundAppMeaningfulNodeCount:e.foregroundAppMeaningfulNodeCount??0},windowTypes:[...e.windowTypes].sort((e,t)=>e-t).slice(0,8)}}function hl(e){return e.visibleToUser===!1?!1:gl(e.text)||gl(e.desc)||gl(e.resourceId)}function gl(e){return e!==null&&e.trim()!==``}function _l(e){return e===null||qc.has(e)}function vl(e){return e!==null&&qc.has(e)}function yl(e,t){return{helperNodeCount:e.nodeCount,helperSystemUiNodeCount:e.systemUiNodeCount,helperWindowRootCount:e.windowRootCount,helperApplicationWindowRootCount:e.applicationWindowRootCount,helperMeaningfulNodeCount:e.meaningfulNodeCount,helperApplicationMeaningfulNodeCount:e.applicationMeaningfulNodeCount,helperNonSystemMeaningfulNodeCount:e.nonSystemMeaningfulNodeCount,helperInputMethodMeaningfulNodeCount:e.inputMethodMeaningfulNodeCount,...e.foregroundAppPackage===void 0?{}:{helperForegroundAppPackage:e.foregroundAppPackage,helperForegroundAppMeaningfulNodeCount:e.foregroundAppMeaningfulNodeCount,helperForegroundAppMeaningfulNodeThreshold:2},helperWindowTypes:e.windowTypes,...t.captureMode?{helperCaptureMode:t.captureMode}:{}}}async function bl(e){let t=await B(e.deviceKey,{resetRuntime:!0,signal:e.signal,cause:e.cause});e.signal?.throwIfAborted(),t||await xl(e.adb,e.packageName)}async function xl(e,t){await ii({adb:e,packageName:t}),await g(150),h({level:`debug`,phase:`android_snapshot_helper_runtime_reset`,data:{packageName:t}})}const Sl=Symbol(`androidSnapshotCaptureEvidence`);function Cl(e,t){return Object.defineProperty(e,Sl,{value:t}),e}function wl(e){let t={...e,backend:`android`,producer:`android-uiautomator`},n=e[Sl];return te(t,n.clickability),n.occlusionContext&&l(t,n.occlusionContext),t}async function Tl(e,t={}){let n=C(e,t.helperAdb).exec;return(await Nl(e,t,n)).xml}async function El(e,t={}){let n=C(e,t.helperAdb).exec,r=await Nl(e,t,n),i=r.xml,a=Wc(i),o=kl(r.metadata,a),s={...t,androidPresentation:{...t.androidPresentation,deadlineAtMs:t.androidPresentation?.deadlineAtMs??Date.now()+250}};try{let e=fc(a,void 0,s),n=Ol(e.truncated,r.metadata);t.interactiveOnly&&t.includeHiddenContentHints!==!1&&Ml({options:s,tree:a,xml:i,interactiveSnapshot:e});let{sourceNodes:c,occlusionContext:l,...u}=e;return Cl({...u,...jl(n),androidSnapshot:o,quality:{state:`healthy`,backend:`android-helper`}},{clickability:Kc(e),occlusionContext:l})}catch(e){if(!ac(e))throw e;return Dl({failure:e,androidSnapshot:o})}}function Dl(e){return Cl({nodes:[],truncated:!0,analysis:e.failure.analysis??{rawNodeCount:0,maxDepth:0},androidSnapshot:{...e.androidSnapshot,presentationFailure:{phase:e.failure.details.phase,workUnits:e.failure.details.workUnits,...e.failure.details.maxWorkUnits===void 0?{}:{maxWorkUnits:e.failure.details.maxWorkUnits}}},quality:{state:`sparse`,backend:`android-helper`,reason:e.failure.message,reasonCode:e.failure.qualityReasonCode}},{clickability:{kind:`exact`,provider:`android-helper`,clickableByNodeIndex:new Map}})}function Ol(e,t){return e===!0||t.helperTruncated===!0||e}function kl(e,t){return Al(t)===!1?{...e,occlusionScanUnavailable:!0}:e}function Al(e){let t=[...e.children];if(t.length!==0){for(;t.length>0;){let e=t.pop();if(Ds(e)!==void 0)return!0;t.push(...e.children)}return!1}}function jl(e){return e===!0?{truncated:!0}:{}}function Ml(e){if(Zl(e.interactiveSnapshot.nodes).size>0||Xl(e.xml))return;let t=fc(e.tree,void 0,{...e.options,interactiveOnly:!1});Ql(be(o(t.nodes)),t,e.interactiveSnapshot)}async function Nl(e,t,n){let r=C(e,t.helperAdb),i=await m(`android_snapshot_helper_artifact_resolution`,async()=>await Jl(t.helperArtifact??r.snapshotHelperArtifact));if(i.artifact)return await Pl(e,t,n,i.artifact);throw h({level:`error`,phase:`android_snapshot_helper_unavailable`,data:{reason:i.errorReason??`artifact_not_found`}}),Yl(i.errorReason)}async function Pl(e,t,n,r){let i=Wr(e),a=C(e,t.helperAdb),o=t.helperSessionScope!==`daemon-session`;try{let e;for(let o=0;;o+=1){o>0&&await zl(t.signal);let s=await Rl({options:t,adb:n,adbProvider:a,artifact:r,helperDeviceKey:i,attempt:o,previousContentReason:e});if(s.outcome===`captured`)return s.capture;if(o+1>=3)return await Bl({contentRecovery:s.decision,attempts:o+1,helperDeviceKey:i,artifact:r,adb:n,signal:t.signal});e=s.decision.reason}}finally{o&&await B(i)}}async function Fl(e,t,n,r,i){let a=await m(`android_snapshot_helper_install`,async()=>await or({adb:t,adbProvider:n,artifact:r,deviceKey:i,installPolicy:e.helperInstallPolicy,timeoutMs:3e4,signal:e.signal}),{packageName:r.manifest.packageName,versionCode:r.manifest.versionCode,installPolicy:e.helperInstallPolicy??`missing-or-outdated`});return h({phase:`android_snapshot_helper_install_decision`,data:{packageName:a.packageName,versionCode:a.versionCode,installedVersionCode:a.installedVersionCode,artifactSha256:r.manifest.sha256,installedSha256:a.installedSha256,installed:a.installed,reason:a.reason}}),a}async function Il(e){let{signal:t,adb:r,adbProvider:i,artifact:a,helperDeviceKey:o}=e,s=si({adb:r,adbProvider:i,artifact:a,deviceKey:o,signal:t});try{let e=await m(`android_snapshot_helper_session_capture`,async()=>await qi(s),{packageName:a.manifest.packageName,version:a.manifest.version,timeoutMs:Kn});if(e)return e}catch(e){if(t?.throwIfAborted(),Jr(e))throw e;h({level:`warn`,phase:`android_snapshot_helper_session_fallback`,data:{reason:n(e).message}}),await xl(r,a.manifest.packageName)}return await m(`android_snapshot_helper_capture`,async()=>await oi(s),{packageName:a.manifest.packageName,version:a.manifest.version,timeoutMs:Kn,commandTimeoutMs:qn})}function Ll(e,t,n){return{xml:e.xml,metadata:{backend:`android-helper`,helperVersion:t.manifest.version,helperApiVersion:e.metadata.helperApiVersion,helperTransport:e.metadata.transport,helperSessionReused:e.metadata.sessionReused,installReason:n,waitForIdleTimeoutMs:e.metadata.waitForIdleTimeoutMs,waitForIdleQuietMs:e.metadata.waitForIdleQuietMs,timeoutMs:e.metadata.timeoutMs,maxDepth:e.metadata.maxDepth,maxNodes:e.metadata.maxNodes,rootPresent:e.metadata.rootPresent,captureMode:e.metadata.captureMode,windowCount:e.metadata.windowCount,nodeCount:e.metadata.nodeCount,helperTruncated:e.metadata.truncated,elapsedMs:e.metadata.elapsedMs}}}async function Rl(e){let{options:t,adb:n,adbProvider:r,artifact:i,helperDeviceKey:a,attempt:o}=e,s;try{let e=await Fl(t,n,r,i,a);e.installed&&await B(a),s=Ll(await Il({signal:t.signal,adb:n,adbProvider:r,artifact:i,helperDeviceKey:a}),i,e.reason)}catch(e){return t.signal?.throwIfAborted(),{outcome:`captured`,capture:await Vl({error:e,helperDeviceKey:a,artifact:i,adb:n})}}let c=Jc(s.xml,s.metadata,{foregroundAppPackage:t.appBundleId});if(c.outcome===`unusable`)return{outcome:`unusable`,decision:c.decision};let l=c.outcome===`system-surface-only`;return!l&&o>0&&h({phase:`android_snapshot_helper_content_recaptured`,data:{attempts:o+1,recoveredFromReason:e.previousContentReason}}),{outcome:`captured`,capture:{xml:s.xml,metadata:l?{...s.metadata,systemSurfaceOnly:!0}:s.metadata}}}async function zl(e){e?.throwIfAborted(),await g(250),e?.throwIfAborted()}async function Bl(e){throw h({level:`error`,phase:`android_snapshot_helper_content_invalid`,data:{reason:e.contentRecovery.reason,failureReason:e.contentRecovery.failureReason,attempts:e.attempts,...e.contentRecovery.diagnostics}}),await bl({adb:e.adb,deviceKey:e.helperDeviceKey,packageName:e.artifact.manifest.packageName,signal:e.signal,cause:e.contentRecovery.failureReason}),new t(`COMMAND_FAILED`,e.contentRecovery.failureReason,{...e.contentRecovery.diagnostics,androidSnapshotHelperFailureReason:e.contentRecovery.reason,attempts:e.attempts,retriable:!0,hint:`Retry after the app UI stabilizes. If this persists, capture a screenshot and report the helper diagnostics; agent-device does not substitute a second snapshot engine.`})}async function Vl(e){let t=Hl(e.error);throw h({level:`error`,phase:`android_snapshot_helper_failed`,data:{reason:t}}),await B(e.helperDeviceKey),await xl(e.adb,e.artifact.manifest.packageName),tr({deviceKey:e.helperDeviceKey,packageName:e.artifact.manifest.packageName,versionCode:e.artifact.manifest.versionCode}),Ul(e.error,t)}function Hl(e){let t=n(e),r=ql(t.details?.helper);if(r&&r!==t.message)return`${t.message}: ${r}`;if(r)return r;let i=(typeof t.details?.stderr==`string`?t.details.stderr.trim():``).split(/\r?\n/).find(e=>e.trim());return i?`${t.message}: ${i}`:t.message}function Ul(e,r){let a=n(e),o=Wl(a);return new t(i(a.code),`Android snapshot helper failed: ${r}`,{...a.details,...Kl(a),androidSnapshotHelperFailureReason:r,...o?{androidCaptureFailureReason:o}:{},hint:Gl(a,o)},e)}function Wl(e){return ct(e)}function Gl(e,t){return t===`accessibility-timeout`?`Android accessibility snapshots can be blocked by busy or continuously changing app UI. Use screenshot as visual truth after this timeout and report the busy UI if it persists.`:e.details?.androidSnapshotHelperInstallFailure===!0?[e.hint,`This is a device-side install failure (adb rejection or OEM policy) — the helper artifact itself is present, this is not a missing/unbuilt build.`].filter(Boolean).join(` `):e.hint??`Retry once. If the helper still fails, run agent-device doctor and report the diagnostic log; agent-device does not substitute a second snapshot engine.`}function Kl(e){let t={};return e.diagnosticId!==void 0&&(t.diagnosticId=e.diagnosticId),e.logPath!==void 0&&(t.logPath=e.logPath),e.retriable!==void 0&&(t.retriable=e.retriable),e.supportedOn!==void 0&&(t.supportedOn=e.supportedOn),t}function ql(e){if(!e||typeof e!=`object`||!(`message`in e))return;let t=String(e.message).trim();return t&&t!==`null`?t:void 0}async function Jl(e){if(e)return{artifact:e};let t=ke(),r=E.join(Ae(),`android`,`snapshot-helper`,`dist`),i=E.join(r,`agent-device-android-snapshot-helper-${t}.manifest.json`);try{await x().files.access(i)}catch{return{}}try{let e=Jn(JSON.parse(await x().files.readText(i))),t=E.join(r,e.assetName??`agent-device-android-snapshot-helper-${e.version}.apk`);return await x().files.access(t),{artifact:{apkPath:t,manifest:e}}}catch(e){return{errorReason:n(e).message}}}function Yl(e){let n=e??`the bundled helper artifact was not found`;return new t(`COMMAND_FAILED`,`Android snapshot helper is unavailable: ${n}`,{androidSnapshotHelperFailureReason:n,hint:"Run `pnpm build:android` to build the helper dist for a source checkout — the runtime needs android/snapshot-helper/dist/agent-device-android-snapshot-helper-<version>.manifest.json and the .apk it references. Packaged installs ship these via the prepack script; if they are missing from a packaged install, reinstall agent-device."})}function Xl(e){return e.includes(` can-scroll-forward=`)||e.includes(` can-scroll-backward=`)}function Zl(e){let t=new Map;for(let n of e){let e={};n.hiddenContentAbove&&(e.hiddenContentAbove=!0),n.hiddenContentBelow&&(e.hiddenContentBelow=!0),(e.hiddenContentAbove||e.hiddenContentBelow)&&t.set(n.index,e)}return t}function Ql(e,t,n){if(e.size===0)return;let r=new Map;for(let[e,t]of n.sourceNodes.entries()){let i=n.nodes[e];i&&r.set(t,i)}for(let[n,i]of e){let e=t.sourceNodes[n];if(!e)continue;let a=r.get(e);a&&(i.hiddenContentAbove&&(a.hiddenContentAbove=!0),i.hiddenContentBelow&&(a.hiddenContentBelow=!0))}}async function $l(e,t,n,r,i={}){let a=[0,150,350],o=null,s=null,c=await vu(e);for(let l of a){l>0&&await g(l);let a=await cu(e,t,n,r,c,i);if(o=a,a.reason===`ime_capture`)return a;s=a.ok?a:null}return s??o??{ok:!1,actual:null,reason:`text_mismatch`,targetInput:null,actualInput:null}}async function eu(e,t,n,r={}){return au(await Tl(e,r),t,n)}async function tu(e,t,n,r){let i=await vu(e);return lu(await Tl(e,r),t,n,i).targetInput}async function nu(e,t,n,r={}){try{return await tu(e,t,n,r)}catch(e){return h({level:`warn`,phase:`android_fill_pre_action_target_capture_failed`,data:{error:e instanceof Error?e.message:String(e)}}),null}}function X(e,n,r){if(r?.ok)return;let i=r?ru(e,n,r):null;if(i)return i;throw new t(`COMMAND_FAILED`,ou(r),su(e,r))}function ru(e,t,n){let r=n.targetInput,i=n.actualInput;if(e.length===0||n.reason===`ime_capture`||!t||!r||!i||q(t)||q(r)||q(i)||!wu(t,r)||!wu(t,i)||t.text===n.actual)return null;let a=Tu(t);return h({level:`warn`,phase:`android_fill_verification_unconfirmed`,data:{target:a}}),{verification:`unconfirmed`,requested:e,before:t.text,after:n.actual,target:a}}function iu(e,t,n,r,i={}){let a=lu(e,t,n,i);return uu(a)?{ok:!1,actual:a.actualInput?.text??null,reason:`ime_capture`,targetInput:a.targetInput,actualInput:a.actualInput}:du(a,r)??fu(a,r)}function au(e,t,n){return lu(e,t,n).targetInput?.text??null}function ou(e){return e?.reason===`ime_capture`?`Android fill input was captured by the active keyboard instead of the app field`:e?.reason===`masked_unverified`?`Android fill verification could not confirm masked text value`:`Android fill verification failed`}function su(e,t){let n=bs(e,t);return t?.reason===`ime_capture`&&(n.hint=`The focused input belongs to the Android keyboard/IME, not the app field. Disable handwriting/stylus input or switch to a standard IME, then retry fill.`),n}async function cu(e,t,n,r,i,a){return iu(await Tl(e,a),t,n,r,i)}function lu(e,t,n,r={}){let i={focusedEdit:null,editAtPoint:null,anyAtPoint:null};for(let a of Mc(e)){let e=_u(a,r);e&&yu(i,e,t,n)}return xu(i)}function uu(e){let{targetInput:t,actualInput:n}=e;return!t||!n||n===t?!1:n.inputMethodOwned&&!t.inputMethodOwned}function du(e,t){let n=e.actualInput;if(!n||!Cu(n))return null;let r=n.text??null,i=Array.from(pu(n)).length,a=Array.from(t).length,o=a===0?i===0:i>0&&i===a;return{ok:o,actual:r,reason:o?void 0:`masked_unverified`,masked:!0,targetInput:e.targetInput,actualInput:n}}function fu(e,t){let n=e.actualInput;return{ok:n!==null&&mu(pu(n),t),actual:n?.text??null,reason:`text_mismatch`,targetInput:e.targetInput,actualInput:n}}function pu(e){return e.hintShowing?``:e.text??``}function mu(e,t){if(e===t)return!0;if(t.length===0)return!1;let n=hu(e),r=hu(t);return!n||!r?!1:!!(n===r||gu(n,r))}function hu(e){return e.replaceAll(/\s+/g,` `).trim()}function gu(e,t){if(e.length!==t.length||e.length===0||e.slice(1)!==t.slice(1))return!1;let n=e[0],r=t[0];return!n||!r?!1:r.toLowerCase()===r&&n===r.toUpperCase()}function _u(e,t){if(!e.rect)return null;let n=e.text??``,r=Math.max(1,e.rect.width*e.rect.height);return{text:n||null,className:e.className,resourceId:e.resourceId,packageName:e.packageName,rect:e.rect,focused:e.focused??!1,password:e.password===!0,inputMethodOwned:p({packageName:e.packageName,resourceId:e.resourceId,activeInputMethodPackage:t.activeInputMethodPackage}),area:r,editText:Su(e.className??``),hintShowing:e.hintShowing===!0}}async function vu(e){try{return{activeInputMethodPackage:(await lo(e)).inputMethodPackage}}catch(e){return h({level:`warn`,phase:`android_fill_verification_input_method_probe_failed`,data:{error:e instanceof Error?e.message:String(e)}}),{}}}function yu(e,t,n,r){let i=ne(t.rect,n,r);if(i&&t.editText&&(e.editAtPoint=bu(e.editAtPoint,t)),t.focused&&t.editText){e.focusedEdit=bu(e.focusedEdit,t);return}i&&t.text&&(e.anyAtPoint=bu(e.anyAtPoint,t))}function bu(e,t){return e&&e.area<t.area?e:t}function xu(e){let t=e.editAtPoint??e.anyAtPoint;return{targetInput:t,actualInput:(e.focusedEdit?.text?e.focusedEdit:null)??t}}function Su(e){let t=e.toLowerCase();return t.includes(`edittext`)||t.includes(`textfield`)}function Cu(e){return q(e)}function wu(e,t){return e.resourceId||t.resourceId?e.resourceId===t.resourceId&&e.packageName===t.packageName:e.className===t.className&&e.packageName===t.packageName&&e.rect.x===t.rect.x&&e.rect.y===t.rect.y&&e.rect.width===t.rect.width&&e.rect.height===t.rect.height}function Tu(e){return{resourceId:e.resourceId,className:e.className,packageName:e.packageName,rect:e.rect}}async function Eu(e,t){return await Lt(t.stateDir),await Qo(t.stateDir,e.id,async()=>await Ou(e,t))}function Du(e){let t=r(e).details?.hint;return{outcome:`helper-unavailable`,reason:n(e).message,...typeof t==`string`?{hint:t}:{}}}async function Ou(e,t){let n=x().imeRecoveryMarkers,r=y(e),i=C(e),a=U(e),o;try{o=await jo(i),await Fo({adb:r,adbProvider:i,artifact:o,deviceKey:a})}catch(e){return Du(e)}let{manifest:s}=o,c=await W(r);if(c===s.serviceComponent){let i=await n.write(t.stateDir,e.id),o=await G(r);return i&&K.add(a),{outcome:`settled`,activated:!1,alreadyActive:!0,...i?{}:{persistFailed:!0},previousIme:o,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName}}let l=await G(r);if(!await Go(r,c))return await qo(r,l,e.id),S({level:`warn`,phase:`android_test_ime_persist_failed`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!1,alreadyActive:!1,persistFailed:!0,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName};let u=(await n.read(t.stateDir)).includes(e.id);if(!await n.write(t.stateDir,e.id))return await qo(r,l,e.id),S({level:`warn`,phase:`android_test_ime_marker_persist_failed`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!1,alreadyActive:!1,persistFailed:!0,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName};await b(r,[`ime`,`enable`,s.serviceComponent],{allowFailure:!0,timeoutMs:1e4});let d=await b(r,[`ime`,`set`,s.serviceComponent],{allowFailure:!0,timeoutMs:1e4}),f=await W(r);return f===s.serviceComponent?(K.add(a),S({phase:`android_test_ime_activated`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!0,alreadyActive:!1,previousIme:c,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName}):(K.delete(a),await qo(r,l,e.id),u||await n.clear(t.stateDir,e.id),S({level:`warn`,phase:`android_test_ime_activate_failed`,data:{device:e.id,activeIme:f,stderr:d.stderr.trim()}}),{outcome:`settled`,activated:!1,alreadyActive:!1,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName})}function ku(e){return E.join(e,`android-test-ime-pending`)}function Au(e,t){return E.join(ku(e),encodeURIComponent(t))}async function ju(e,t){let r=x().files,i,a=!1;try{let n=ku(e);if(i=Au(e,t),await r.ensureDirectory(n),(await Pu(i))?.serial===t)return!0;let o={version:1,serial:t};if(await r.writeAtomicText(i,`${JSON.stringify(o)}\n`,384),a=!0,(await Pu(i))?.serial!==t)throw Error(`Android test IME marker read-back did not match the requested device.`);return!0}catch(o){return a&&i&&await r.remove(i,{force:!0}).catch(()=>{}),h({level:`debug`,phase:`android_test_ime_marker_write_failed`,data:{stateDir:e,serial:t,error:n(o).message}}),!1}}async function Mu(e,t){await x().files.remove(Au(e,t),{force:!0}).catch(()=>{})}async function Nu(e){let t=x().files,n;try{n=await t.readDirectory(ku(e))}catch{return[]}let r=[];for(let t of n)try{let n=E.join(ku(e),t),i=await Pu(n);i&&Au(e,i.serial)===n&&r.push(i.serial)}catch{}return[...new Set(r)].sort()}async function Pu(e){try{return Fu(await x().files.readText(e))}catch{return}}function Fu(e){try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))return;let n=t;return n.version===1&&typeof n.serial==`string`&&n.serial.length>0?{version:1,serial:n.serial}:void 0}catch{return}}const Iu=new Bt(`utf-16le`);let Lu;async function Ru(e,t){for(let n of[`AndroidManifest.xml`,`base/manifest/AndroidManifest.xml`]){let r=await zu(e,n,t);if(!r)continue;let i=Bu(r);if(i)return i}return await Yu(e,t)}async function zu(e,t,n){try{let r=await Ce(`unzip`,[`-p`,e,t],{allowFailure:!0,binaryStdout:!0,signal:n});return r.exitCode!==0||!r.stdoutBuffer||r.stdoutBuffer.length===0?void 0:r.stdoutBuffer}catch{n?.throwIfAborted();return}}function Bu(e){return e.subarray(0,Math.min(e.length,128)).toString(`utf8`).trimStart().startsWith(`<`)?Vu(e.toString(`utf8`)):Hu(e)}function Vu(e){return e.match(/<manifest\b[^>]*\bpackage\s*=\s*["']([^"']+)["']/i)?.[1]}function Hu(e){if(e.length<8||e.readUInt16LE(0)!==3)return;let t;for(let n=e.readUInt16LE(2);n+8<=e.length;){let r=e.readUInt16LE(n),i=e.readUInt16LE(n+2),a=e.readUInt32LE(n+4);if(a<=0||n+a>e.length)return;if(r===1)t=Wu(e.subarray(n,n+a));else if(r===258&&t){let r=Uu(e,n,i,t);if(r)return r}n+=a}}function Uu(e,t,n,r){if(n<36||t+n>e.length||r[e.readUInt32LE(t+20)]!==`manifest`)return;let i=e.readUInt16LE(t+24),a=e.readUInt16LE(t+26),o=e.readUInt16LE(t+28),s=t+i;for(let t=0;t<o;t+=1){let n=s+t*a;if(n+20>e.length)return;if(r[e.readUInt32LE(n+4)]!==`package`)continue;let i=e.readUInt32LE(n+8);if(i!==4294967295)return r[i];let o=e.readUInt8(n+15),c=e.readUInt32LE(n+16);return o===3?r[c]:void 0}}function Wu(e){if(e.length<28)return[];let t=e.readUInt32LE(8),n=e.readUInt32LE(16),r=e.readUInt32LE(20),i=!!(n&256),a=[];for(let n=0;n<t;n+=1){let t=28+n*4;if(t+4>e.length)return a;let o=r+e.readUInt32LE(t);a.push(i?Gu(e,o):Ku(e,o))}return a}function Gu(e,t){let[,n]=qu(e,t),[r,i]=qu(e,t+n),a=t+n+i;return e.subarray(a,a+r).toString(`utf8`)}function Ku(e,t){let[n,r]=Ju(e,t),i=t+r;return Iu.decode(e.subarray(i,i+n*2))}function qu(e,t){let n=e.readUInt8(t);if(!(n&128))return[n,1];let r=e.readUInt8(t+1);return[(n&127)<<8|r,2]}function Ju(e,t){let n=e.readUInt16LE(t);if(!(n&32768))return[n,2];let r=e.readUInt16LE(t+2);return[(n&32767)<<16|r,4]}async function Yu(e,t){t?.throwIfAborted();let n=await Xu();if(!n)return;let r=await Ce(n,[`dump`,`badging`,e],{allowFailure:!0,signal:t});if(r.exitCode===0)return r.stdout.match(/package:\s+name='([^']+)'/)?.[1]}async function Xu(){if(Lu!==void 0)return Lu??void 0;try{let e=x().files;for(let t of _t()){let n=E.join(t,`build-tools`);try{let t=(await e.readDirectory(n)).sort((e,t)=>t.localeCompare(e,void 0,{numeric:!0}));for(let r of t){let t=E.join(n,r,`aapt`);if(E.isAbsolute(t)&&await e.isExecutable(t))return Lu=t,t}}catch{}}}catch{}Lu=null}async function Zu(e,t){let n=e.kind===`url`&&je(e.url),r=await Me({source:e,isInstallablePath:(e,t)=>t.isFile()&&Qu(e),installableLabel:`Android installable (.apk or .aab)`,allowArchiveExtraction:e.kind!==`url`||n,signal:t?.signal});try{let e=t?.resolveIdentity===!1?{}:await $u(r.installablePath,t?.signal);return{archivePath:r.archivePath,installablePath:r.installablePath,packageName:e.packageName,cleanup:r.cleanup}}catch(e){throw await r.cleanup(),e}}function Qu(e){let t=E.extname(e).toLowerCase();return t===`.apk`||t===`.aab`}async function $u(e,t){let n=E.extname(e).toLowerCase();return n!==`.apk`&&n!==`.aab`?{}:{packageName:await Ru(e,t)}}async function ed(e,n,r,i={}){let a=typeof r.action==`string`&&r.action.trim()?r.action.trim():`${n}.TEST_PUSH`,o=[`am`,`broadcast`,`-a`,a,`-p`,n],s=typeof r.receiver==`string`?r.receiver.trim():``;s&&o.push(`-n`,s);let c=r.extras;if(c!==void 0&&(typeof c!=`object`||!c||Array.isArray(c)))throw new t(`INVALID_ARGS`,`Android push payload extras must be an object`);let l=c??{},u=0;for(let[e,t]of Object.entries(l))e&&(td(o,e,t),u+=1);return await T(e,o,{signal:i.signal}),{action:a,extrasCount:u}}function td(e,n,r){if(typeof r==`string`){e.push(`--es`,n,r);return}if(typeof r==`boolean`){e.push(`--ez`,n,r?`true`:`false`);return}if(typeof r==`number`&&Number.isFinite(r)){if(Number.isInteger(r)){e.push(`--ei`,n,String(r));return}e.push(`--ef`,n,String(r));return}throw new t(`INVALID_ARGS`,`Unsupported Android broadcast extra type for "${n}". Use string, boolean, or number.`)}function Z(e){let t=e.replaceAll(`,`,``).match(/^-?\d+(?:\.\d+)?/);if(!t)return null;let n=Number(t[0]);return Number.isFinite(n)?n:null}function nd(e){let t=sd(e.map(e=>e.intendedVsyncNs)),n=[];for(let e=1;e<t.length;e+=1){let r=t[e]-t[e-1];r>=4e6&&r<=5e7&&n.push(r)}if(n.length!==0)return cd(n)}function rd(e){let{frames:t,frameDeadlineNs:n,summaryDroppedFrameCount:r}=e;return r===void 0?n===void 0?[]:t.filter(e=>e.durationNs>n):r<=0?[]:[...t].sort((e,t)=>t.durationNs-e.durationNs).slice(0,r).sort((e,t)=>e.intendedVsyncNs-t.intendedVsyncNs)}function id(e){let{frames:t,windowStartNs:n,measuredAtMs:r,uptimeMs:i}=e;if(t.length===0||n===void 0)return[];let a=[],o=[];for(let e of t){let t=o.at(-1);if(!t||e.intendedVsyncNs-t.frameCompletedNs<=5e8){o.push(e);continue}a.push(o),o=[e]}return o.length>0&&a.push(o),a.map(e=>od({frames:e,windowStartNs:n,measuredAtMs:r,uptimeMs:i})).sort((e,t)=>t.missedDeadlineFrameCount-e.missedDeadlineFrameCount||t.worstFrameMs-e.worstFrameMs).slice(0,3).sort((e,t)=>e.startOffsetMs-t.startOffsetMs)}function ad(e){return Math.round(e*10)/10}function od(e){let{frames:t,windowStartNs:n,measuredAtMs:r,uptimeMs:i}=e,a=Math.min(...t.map(e=>e.intendedVsyncNs)),o=Math.max(...t.map(e=>e.frameCompletedNs)),s=Math.max(0,Math.round((a-n)/1e6)),c=Math.max(s,Math.round((o-n)/1e6)),l=i!==void 0&&Number.isFinite(r)?r-i:void 0;return{startOffsetMs:s,endOffsetMs:c,startAt:l===void 0?void 0:new Date(l+a/1e6).toISOString(),endAt:l===void 0?void 0:new Date(l+o/1e6).toISOString(),missedDeadlineFrameCount:t.length,worstFrameMs:ad(Math.max(...t.map(e=>e.durationNs))/1e6)}}function sd(e){return[...new Set(e.filter(e=>Number.isFinite(e)))].sort((e,t)=>e-t)}function cd(e){let t=[...e].sort((e,t)=>e-t),n=Math.floor(t.length/2);return t.length%2==1?t[n]:(t[n-1]+t[n])/2}function ld(e,t,n){ud(e,t);let r=bd(e),i=gd(e),a=fd(i,r,t),o=Date.parse(n),s=Sd({frames:i,measuredAtMs:o,summary:r}),c=rd({frames:i,frameDeadlineNs:a,summaryDroppedFrameCount:r?.droppedFrameCount}),l=r?.sampleWindowMs??s.sampleWindowMs??Ed(i),u=pd(r,i,c),d=hd({droppedFrames:c,timing:s,measuredAtMs:o,summary:r});return{...u,sampleWindowMs:l,...md(a),windowStartedAt:s.windowStartedAt,windowEndedAt:s.windowEndedAt,timestampSource:s.timestampSource,measuredAt:n,method:`adb-shell-dumpsys-gfxinfo-framestats`,source:r?`android-gfxinfo-summary`:`framestats-rows`,worstWindows:d&&d.length>0?d:void 0}}function ud(e,n){if(/no process found for:/i.test(e))throw new t(`COMMAND_FAILED`,`Android gfxinfo did not find a running process for ${n}`,{metric:`fps`,package:n,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf after the interaction you want to inspect.`})}function dd(e){throw new t(`COMMAND_FAILED`,`Failed to parse Android framestats output for ${e}`,{metric:`fps`,package:e,hint:`Retry perf after exercising the app screen. If the problem persists, capture adb shell dumpsys gfxinfo <package> framestats output for debugging.`})}function fd(e,n,r){let i=nd(e);if(!n&&e.length===0&&dd(r),n||i!==void 0)return i;throw new t(`COMMAND_FAILED`,`Failed to infer Android frame deadline from framestats output for ${r}`,{metric:`fps`,package:r,hint:`Retry perf after a longer interaction window so consecutive Android frame timestamps are available.`})}function pd(e,t,n){let r=e?.totalFrameCount??t.length,i=e?.droppedFrameCount??n.length;return{totalFrameCount:r,droppedFrameCount:i,droppedFramePercent:e?.droppedFramePercent??(r>0?Rt(i/r*100):0)}}function md(e){return{frameDeadlineMs:e===void 0?void 0:ad(e/1e6),refreshRateHz:e===void 0?void 0:ad(1e9/e)}}function hd(e){let{droppedFrames:t,timing:n,measuredAtMs:r,summary:i}=e;if(t.length===0)return;let a=id({frames:t,windowStartNs:n.windowStartNs,measuredAtMs:r,uptimeMs:i?.uptimeMs});return a.length>0?a:void 0}function gd(e){let t=[],n=null;for(let r of e.split(`
-`)){let e=r.trim();if(e.length===0||e===`---PROFILEDATA---`)continue;let i=e.split(`,`).map(e=>e.trim());if(_d(i)){n=new Map(i.map((e,t)=>[e,t]));continue}let a=vd(i,n);a&&t.push(a)}return t.sort((e,t)=>e.intendedVsyncNs-t.intendedVsyncNs)}function _d(e){return e.includes(`IntendedVsync`)&&e.includes(`FrameCompleted`)}function vd(e,t){if(!t||e.length<t.size)return;let n=yd(e,t,`Flags`),r=yd(e,t,`IntendedVsync`),i=yd(e,t,`FrameCompleted`);if(!(n!==0||r===null||i===null||r<=0||i<=r))return{intendedVsyncNs:r,frameCompletedNs:i,durationNs:i-r}}function yd(e,t,n){let r=t.get(n);if(r===void 0)return null;let i=Number(e[r]);return Number.isFinite(i)?i:null}function bd(e){let t=e.split(/\nProfile data in ms:\n/i)[0]??``,n=Dd(t,`Total frames rendered`),r=t.match(/^\s*Janky frames:\s*([0-9][0-9,]*)\s*\(([0-9.]+)%\)/im);if(n===void 0||!r)return;let i=r[1],a=r[2];if(i===void 0||a===void 0)return;let o=Z(i)??void 0,s=Number(a);if(o===void 0||!Number.isFinite(s)||n<0)return;let c=Dd(t,`Uptime`),l=Dd(t,`Stats since`);return{droppedFramePercent:Rt(s),droppedFrameCount:o,totalFrameCount:n,sampleWindowMs:xd({uptimeMs:c,statsSinceNs:l}),uptimeMs:c,statsSinceNs:l}}function xd(e){let{uptimeMs:t,statsSinceNs:n}=e;if(t===void 0||n===void 0)return;let r=t-Math.round(n/1e6);return r>=0?r:void 0}function Sd(e){let{frames:t,measuredAtMs:n,summary:r}=e,i=Cd(t),a=r?.statsSinceNs,o=a??i.firstFrameNs,s=wd(o,i.lastFrameNs),c=r?.sampleWindowMs??s;if(!Number.isFinite(n)||r?.uptimeMs===void 0||o===void 0)return{sampleWindowMs:c,windowStartNs:o};let l=n-r.uptimeMs;return{sampleWindowMs:c,windowStartNs:o,windowStartedAt:new Date(l+o/1e6).toISOString(),windowEndedAt:Td({deviceBootWallClockMs:l,measuredAtMs:n,summaryStartNs:a,lastFrameNs:i.lastFrameNs}),timestampSource:`estimated-from-device-uptime`}}function Cd(e){return e.length===0?{}:{firstFrameNs:Math.min(...e.map(e=>e.intendedVsyncNs)),lastFrameNs:Math.max(...e.map(e=>e.frameCompletedNs))}}function wd(e,t){if(e!==void 0&&t!==void 0)return Math.max(0,Math.round((t-e)/1e6))}function Td(e){let{deviceBootWallClockMs:t,measuredAtMs:n,summaryStartNs:r,lastFrameNs:i}=e;return r===void 0?i===void 0?void 0:new Date(t+i/1e6).toISOString():new Date(n).toISOString()}function Ed(e){if(e.length===0)return;let t=Cd(e);return wd(t.firstFrameNs,t.lastFrameNs)}function Dd(e,t){let n=t.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`),r=e.match(RegExp(`^\\s*${n}:\\s*([0-9][0-9,]*)`,`im`));if(!r)return;let i=r[1];return i===void 0?void 0:Z(i)??void 0}async function Od(e,t,n={}){let r=y(e,n.adb);try{let i=ld((await b(r,[`dumpsys`,`gfxinfo`,t,`framestats`],{timeoutMs:15e3})).stdout,t,new Date().toISOString());return await kd(e,t,n),i}catch(e){throw Ad(t,e)}}async function kd(e,t,n={}){let r=y(e,n.adb);try{await b(r,[`dumpsys`,`gfxinfo`,t,`reset`],{allowFailure:!0,timeoutMs:3e3})}catch{}}function Ad(e,n){return n instanceof t?new t(n.code,n.message,{...n.details??{},metric:`fps`,package:e},n):new t(`COMMAND_FAILED`,`Failed to sample Android fps for ${e}`,{metric:`fps`,package:e},n)}async function jd(e,t,n,r,i){return{capture:{durationMs:r,packageName:t.packageName,appPid:t.appPid,artifactPath:t.outPath,sizeBytes:n},frameHealth:t.kind===`perfetto`?await Md(e,t.packageName,i):void 0,notes:[t.kind===`perfetto`?`Frame health is sampled from Android gfxinfo around the trace window; open the Perfetto artifact for timeline root cause.`:`Open the Simpleperf report artifact for symbol-level CPU attribution.`]}}async function Md(e,t,n){try{let r=await Od(e,t,n);return{available:!0,droppedFramePercent:r.droppedFramePercent,droppedFrameCount:r.droppedFrameCount,totalFrameCount:r.totalFrameCount,method:r.method,worstWindows:r.worstWindows?.slice(0,3).map(e=>({startOffsetMs:e.startOffsetMs,endOffsetMs:e.endOffsetMs,missedDeadlineFrameCount:e.missedDeadlineFrameCount,worstFrameMs:e.worstFrameMs}))}}catch(e){return{available:!1,reason:e instanceof Error?e.message:`Android frame health was not available`}}}async function Nd(e,t,n){let r=y(e,n.adb);await zd(r,t),await Hd(r,t),await Vd(r,t,n.files);let i=await Rd(t.outPath,n.files);await Id(r,t.remotePath);let a=Date.now(),o=Math.max(0,a-t.startedAt),s=await jd(e,t,i,o,{adb:r});return{...t,action:`stop`,platform:`android`,state:`stopped`,stoppedAt:a,durationMs:o,sizeBytes:i,method:t.kind===`simpleperf`?Fr:Ir,artifact:{path:t.outPath,sizeBytes:i},summary:s,message:`Stopped Android ${t.kind} ${t.type} for ${t.packageName}`}}async function Pd(e,t,n={}){let r=y(e,n.adb);try{t.state===`running`&&(await zd(r,t),await Hd(r,t).catch(()=>{}))}finally{await Id(r,t.remotePath)}}function Fd(e,t,n=Rr){return`${n}/agent-device-${e.replaceAll(/[^A-Za-z0-9_.-]/g,`_`)}-${Date.now()}-${t}`}async function Id(e,t){try{await b(e,[`rm`,`-f`,t],{allowFailure:!0,timeoutMs:Lr})}catch{}}async function Ld(e,t,n=x().files){await n.ensureDirectory(E.dirname(e)),await n.writeBytes(e,Buffer.from(`${JSON.stringify(t,null,2)}\n`))}async function Rd(e,n=x().files){try{return(await n.stat(e)).size}catch(n){throw new t(`COMMAND_FAILED`,`Profiler artifact was not written: ${e}`,{outPath:e,hint:`Retry the profiling command and check daemon logs if the artifact path is still missing.`},n)}}async function zd(e,t){try{await b(e,[_(Bd(t.profilerPid))],{timeoutMs:P})}catch(e){throw N(`stop`,t.kind,t.packageName,e)}}function Bd(e){return[`pid=${v(e)}`,`kill -INT "$pid" 2>/dev/null || true`,`for i in 1 2 3 4 5 6 7 8 9 10; do kill -0 "$pid" 2>/dev/null || exit 0; sleep 0.2; done`,`kill -TERM "$pid" 2>/dev/null || true`,`for i in 1 2 3 4 5 6 7 8 9 10; do kill -0 "$pid" 2>/dev/null || exit 0; sleep 0.2; done`,`echo "profiler process did not stop after SIGTERM" >&2`,`exit 1`].join(`; `)}async function Vd(e,n,r){await(r??x().files).ensureDirectory(E.dirname(n.outPath));try{await e([`pull`,n.remotePath,n.outPath],{timeoutMs:P})}catch(e){throw new t(`COMMAND_FAILED`,`Failed to pull Android ${n.kind} artifact for ${n.packageName}`,{package:n.packageName,tool:n.kind,remotePath:n.remotePath,outPath:n.outPath,hint:`Check that the profiling command ran long enough to create an artifact, then retry stop with the same session.`},e)}}async function Hd(e,n){let r;for(let t=0;t<12;t+=1){let t=await Ud(e,n.remotePath);if(t!==void 0&&t>0&&t===r)return;r=t,await g(250)}throw new t(`COMMAND_FAILED`,`Android ${n.kind} artifact is not ready to pull`,{package:n.packageName,tool:n.kind,remotePath:n.remotePath,hint:`The profiler stopped, but the remote artifact was missing, empty, or still changing. Retry stop with the same session or inspect the device-side artifact.`})}async function Ud(e,t){let n=v(t),r=await b(e,[_(`if [ -f ${n} ]; then stat -c %s ${n} 2>/dev/null || wc -c < ${n}; fi`)],{allowFailure:!0,timeoutMs:Lr});if(r.exitCode!==0)return;let i=Number(r.stdout.trim().split(/\s+/)[0]);return Number.isFinite(i)?i:void 0}async function Wd(e,t,n,r={}){let i=y(e,r.adb),a=await zr(i,t);await Br(i,`perfetto`,t);let o=Fd(t,`app.perfetto-trace`,`/data/misc/perfetto-traces`),s;try{await kd(e,t,{adb:i}),s=await Kd(i,o,t)}catch(e){throw await Id(i,o),e}return{type:`trace`,kind:`perfetto`,packageName:t,appPid:a,profilerPid:s,remotePath:o,outPath:n,startedAt:Date.now(),state:`running`,action:`start`,platform:`android`,method:Ir,message:`Started Android Perfetto trace for ${t}`}}async function Gd(e,t,n,r={}){return await Nd(e,{...t,outPath:n},r)}async function Kd(e,n,r){try{let i=Vr((await b(e,[`perfetto`,`--background-wait`,`-o`,n,`-t`,`3600s`,`sched`,`freq`,`idle`,`am`,`wm`,`gfx`,`view`,`binder_driver`,`hal`,`dalvik`],{timeoutMs:P})).stdout);if(i)return i;throw new t(`COMMAND_FAILED`,`Android perfetto did not return a profiler pid`,{package:r,tool:`perfetto`,hint:`Retry perf trace start. If perfetto exits immediately, verify the device permits trace capture.`})}catch(e){throw N(`start`,`perfetto`,r,e)}}function qd(e){let t=[];for(let n of s(e)){let e=n.match(/^([0-9]+(?:\.[0-9]+)?)%\s+(.+)$/);if(!e)continue;let r=Number(e[1]),i=e[2]?.trim();if(!Number.isFinite(r)||!i)continue;let a=i.split(/\s{2,}/).filter(Boolean);if(t.push({percentage:Rt(r),command:a[0],dso:a[1],symbol:a.slice(2).join(` `)||void 0}),t.length>=50)break}return t}async function Jd(e,t,n,r={}){let i=y(e,r.adb),a=await zr(i,t);await Br(i,`simpleperf`,t);let o=Fd(t,`cpu.perf.data`),s;try{s=await Zd(i,a,o,t)}catch(e){throw await Id(i,o),e}return{type:`cpu-profile`,kind:`simpleperf`,packageName:t,appPid:a,profilerPid:s,remotePath:o,outPath:n,startedAt:Date.now(),state:`running`,action:`start`,platform:`android`,method:Fr,message:`Started Android Simpleperf CPU profile for ${t}`}}async function Yd(e,t,n,r={}){return await Nd(e,{...t,outPath:n},r)}async function Xd(e,t,n,r={}){let i=y(e,r.adb);await Br(i,`simpleperf`,t.packageName);let a=await ef(i,t),o=new Date().toISOString(),s=qd(a.stdout),c=s.slice(0,10).map(e=>({symbol:e.symbol??`<unknown>`,binary:e.dso,selfSamplePercent:e.percentage}));await Ld(n,{kind:`simpleperf-report`,generatedAt:o,packageName:t.packageName,appPid:t.appPid,sourceProfilePath:t.outPath,sourceRemotePath:t.remotePath,entryCount:s.length,summary:{topFunctions:c},entries:s},r.files);let l=await Rd(n,r.files);return{action:`report`,platform:`android`,type:`cpu-profile-report`,kind:`simpleperf`,packageName:t.packageName,appPid:t.appPid,sourceProfilePath:t.outPath,outPath:n,sizeBytes:l,generatedAt:o,entryCount:s.length,summary:{topFunctions:c},method:Fr,message:`Wrote Android Simpleperf report for ${t.packageName}`}}async function Zd(e,n,r,i){try{let a=Vr((await b(e,[_(Qd(n,r))],{timeoutMs:P})).stdout);if(a)return a;throw new t(`COMMAND_FAILED`,`Android simpleperf did not return a profiler pid`,{package:i,tool:`simpleperf`,hint:`Retry perf. If simpleperf exits immediately, verify the app is profileable and the device permits native profiling.`})}catch(e){throw N(`start`,`simpleperf`,i,e)}}function Qd(e,t){return $d([`simpleperf`,`record`,`-e`,`cpu-clock:u`,`-p`,e,`-o`,t,`--duration`,`3600`],`simpleperf`)}function $d(e,t){let n=e.map(v).join(` `),r=`${Rr}/agent-device-${t}-${Date.now()}.err`;return[`err=${v(r)}`,`(${n}) >/dev/null 2>"$err" & pid=$!`,`sleep 1`,`if kill -0 "$pid" 2>/dev/null; then rm -f "$err"; echo "$pid"; exit 0; fi`,`cat "$err" >&2`,`rm -f "$err"`,`exit 1`].join(`; `)}async function ef(e,t){try{return await b(e,[`simpleperf`,`report`,`-i`,t.remotePath,`--stdio`,`--sort`,`comm,dso,symbol`],{timeoutMs:P})}catch(e){throw N(`report`,`simpleperf`,t.packageName,e)}}const tf=15e3,nf=12e4;async function rf(e,t,n={}){let r=y(e,n.adb);try{return cf((await b(r,[`dumpsys`,`meminfo`,t],{timeoutMs:tf})).stdout,t,new Date().toISOString())}catch(e){throw gf(`memory`,t,e)}}async function af(e,n,r,i={}){let a=y(e,i.adb),o=i.files??x().files,s=await lf(a,n),c=uf(n);await o.ensureDirectory(E.dirname(r));let l=await of(o,r);try{Se(await b(a,[`am`,`dumpheap`,n,c],{allowFailure:!0,timeoutMs:nf}),`Failed to capture Android heap dump for ${n}`,e=>({kind:`android-hprof`,package:n,pid:s,remotePath:c,hint:df(e.stdout,e.stderr)}));let e=await a([`pull`,c,r],{allowFailure:!0,timeoutMs:nf});if(e.exitCode!==0)throw await sf(o,r,l),w(`Failed to pull Android heap dump for ${n}`,e,{kind:`android-hprof`,package:n,pid:s,remotePath:c,path:r,hint:`Verify the daemon can write the requested --out path and retry. The heap dump stays on-device only until cleanup runs.`});let i=await o.stat(r).catch(()=>null);if(!i?.isFile||i.size<=0)throw await sf(o,r,l),new t(`COMMAND_FAILED`,`Android heap dump artifact is missing or empty`,{kind:`android-hprof`,package:n,pid:s,path:r,remotePath:c,hint:`Retry with a writable --out path. If the file is still empty, inspect adb pull output with --debug.`});return{available:!0,kind:`android-hprof`,path:r,sizeBytes:i.size,measuredAt:new Date().toISOString(),method:`adb-shell-am-dumpheap`,packageName:n,pid:s,remotePath:c}}finally{await b(a,[`rm`,`-f`,c],{allowFailure:!0,timeoutMs:tf}).catch(()=>{})}}async function of(e,t){return await e.stat(t).then(e=>e.isFile).catch(()=>!1)}async function sf(e,t,n){n||await e.remove(t,{force:!0}).catch(()=>{})}function cf(e,n,r){if(/no process found for:/i.test(e))throw new t(`COMMAND_FAILED`,`Android meminfo did not find a running process for ${n}`,{metric:`memory`,package:n,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf.`});let i=_f(e,`TOTAL PSS`)??vf(e);if(i===void 0)throw new t(`COMMAND_FAILED`,`Failed to parse Android meminfo output for ${n}`,{metric:`memory`,package:n,hint:`Retry perf after reopening the app session. If the problem persists, capture adb shell dumpsys meminfo output for debugging.`});return{totalPssKb:i,totalRssKb:_f(e,`TOTAL RSS`),measuredAt:r,method:`adb-shell-dumpsys-meminfo`,topConsumers:ff(e)}}async function lf(e,n){let r=await b(e,[`pidof`,n],{allowFailure:!0,timeoutMs:tf}),i=r.stdout.trim().split(/\s+/).map(Number).find(e=>Number.isInteger(e)&&e>0);if(r.exitCode===0&&i!==void 0)return i;throw new t(`COMMAND_FAILED`,`No running Android process found for ${n}`,{kind:`android-hprof`,package:n,stdout:r.stdout,stderr:r.stderr,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf memory snapshot.`})}function uf(e){return`/data/local/tmp/agent-device-${e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`)}-${Date.now()}.hprof`}function df(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`profileable`)||n.includes(`debuggable`)||n.includes(`not allowed`)?`Android heap dumps require a debuggable/profileable app process on many devices. Use a debug/profileable build, reopen the app, then retry.`:n.includes(`permission`)||n.includes(`denied`)?`The device denied heap dump access. Use a debug/profileable build or a device image that permits app heap dumping.`:`Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, run with --debug and inspect adb am dumpheap output.`}function ff(e){let t=e.split(`
-`).flatMap(e=>pf(e)??[]).sort((e,t)=>t.pssKb-e.pssKb).slice(0,5);return t.length>0?t:void 0}function pf(e){let t=e.trim();if(mf(t))return;let n=t.match(/^(.+?)\s+([0-9][0-9,]*(?:\(\d+\))?)(?:\s|$)/);if(n)return hf(n[1],n[2])}function mf(e){if(!e||e.startsWith(`**`)||e.startsWith(`-`)||e.includes(`:`))return!0;let t=/^\S.+\s+\d/.test(e);return/^(pss|total|native|dalvik|unknown|app summary\b)/i.test(e)&&!t}function hf(e,t){let n=e?.trim(),r=t?Z(t):null;if(!(!n||n===`TOTAL`||r===null||r<=0)&&!/^(pss|private|shared|heap|size|alloc|free)$/i.test(n))return{name:n,pssKb:r}}function gf(e,n,r){return r instanceof t?new t(r.code,r.message,{...r.details??{},metric:e,package:n},r):new t(`COMMAND_FAILED`,`Failed to sample Android ${e} for ${n}`,{metric:e,package:n},r)}function _f(e,t){let n=t.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`),r=e.match(RegExp(`${n}:\\s*([0-9][0-9,]*)`,`i`));if(!r)return;let i=r[1];return i===void 0?void 0:Z(i)??void 0}function vf(e){for(let t of e.split(`
-`)){let e=t.trim();if(!/^TOTAL\b(?!\s+PSS:)/.test(e))continue;let n=e.split(/\s+/).slice(1).find(e=>Z(e)!==null);return n?Z(n)??void 0:void 0}}async function yf(e,t,n){let r=await T(e,[`dumpsys`,`package`,t],{allowFailure:!0});return r.exitCode===0?kf(r.stdout,n):{requested:void 0,grants:void 0}}async function bf(e){let t=await T(e,[`am`,`get-current-user`],{allowFailure:!0});if(t.exitCode!==0)return;let n=Number.parseInt(t.stdout.trim(),10);return Number.isInteger(n)&&n>=0?n:void 0}const xf=/^\s*User (\d+):/,Sf=/^\s*runtime permissions:\s*$/,Cf=/^\s*([\w.]+): granted=(true|false)\b/,wf=/^\s*Package \[.+?\]/,Tf=/^\s*requested permissions:\s*$/,Ef=/^\s*([A-Za-z][\w.]*)/;function Df(e){return e.split(`
-`).filter(e=>e.trim().length>0).map(e=>({text:e,indent:e.length-e.trimStart().length}))}function Of(e,t){let n=Q(Q(Q(Df(e),e=>e.indent===0&&e.text.trim()===`Packages:`),e=>xf.exec(e.text)?.[1]===String(t)),e=>Sf.test(e.text));if(!n)return;let r=new Map;for(let{text:e}of n){let t=Cf.exec(e);t&&r.set(t[1],t[2]===`true`?`granted`:`not_granted`)}return r}function Q(e,t){if(!e)return;let n=e.findIndex(e=>t(e));if(n<0)return;let r=e.slice(n+1),i=r.findIndex(t=>t.indent<=e[n].indent);return i<0?r:r.slice(0,i)}function kf(e,t){return{requested:Af(e),grants:Of(e,t)}}function Af(e){let t=Q(Q(Q(Df(e),e=>e.indent===0&&e.text.trim()===`Packages:`),e=>wf.test(e.text)),e=>Tf.test(e.text));if(!t)return;let n=[];for(let{text:e}of t){let t=Ef.exec(e)?.[1];t&&t.includes(`.`)&&!n.includes(t)&&n.push(t)}return n}function jf(e,t,n){if(n!==`not_granted`)return`${n===`granted`?`${t} was granted before this revoke, and Android kills an app when a granted permission is revoked: if ${e} was running it is no longer.`:`Whether ${t} was granted before this revoke could not be read (adb did not report the acting user's runtime permission state), and Android kills an app when a granted permission is revoked: ${e} may no longer be running.`} Relaunch it with open ${e} --relaunch before the next interaction.`}const Mf=[`all`,`camera`,`microphone`,`photos`,`contacts`,`notifications`,`calendar`,`location`,`media-library`],Nf={calendar:[`android.permission.WRITE_CALENDAR`,`android.permission.READ_CALENDAR`],camera:[`android.permission.CAMERA`],contacts:[`android.permission.READ_CONTACTS`,`android.permission.WRITE_CONTACTS`],location:[`android.permission.ACCESS_FINE_LOCATION`,`android.permission.ACCESS_COARSE_LOCATION`],"media-library":[`android.permission.WRITE_EXTERNAL_STORAGE`,`android.permission.READ_EXTERNAL_STORAGE`,`android.permission.READ_MEDIA_AUDIO`,`android.permission.READ_MEDIA_IMAGES`,`android.permission.READ_MEDIA_VIDEO`],microphone:[`android.permission.RECORD_AUDIO`]};async function Pf(e){let n=await bf(e);if(n!==void 0)return n;throw new t(`COMMAND_FAILED`,`Could not determine which Android user the session runs as, so no permission was changed.`,{deviceId:e.id,hint:`Check adb -s ${e.id} shell am get-current-user — if the device is still booting, retry once it reports a user. agent-device refuses to change permissions it cannot scope, because pm would silently apply them to user 0.`})}async function Ff(e,t,n,r){let i=me(n),a=Zf(r?.permissionTarget,r?.permissionMode),o=await Pf(e),s=[`--user`,String(o)];if(a.kind===`all`)return await If(e,t,i,o,s);if(i===`grant`){await Yf(e,t,a,o,s);return}if(a.kind===`pm`)return await ep(e,t,i,a,o,s);let{grants:c}=await yf(e,t,o),l=await Xf(e,t,i,a,s),{priorGrantState:u,warnings:d}=np(t,l,l.map(e=>c?.get(e)??`unknown`));return{permission:l.join(`,`),priorGrantState:u,...d.length>0?{warnings:d}:{}}}async function If(e,n,r,i,a){let{requested:o,grants:s}=await yf(e,n,i);if(o===void 0)throw new t(`COMMAND_FAILED`,`Could not read declared permissions for ${n}, so no permission was changed.`,{appPackage:n});let c=r===`grant`?void 0:s,l=[],u=[];for(let t of Hf(o))await Lf({device:e,appPackage:n,action:r,userArgs:a,grants:c,applied:l,warnings:u},t);return{permission:`all`,applied:l,...u.length>0?{warnings:u}:{}}}async function Lf(e,t){return t.kind===`notification`?await Rf(e):t.kind===`photos`?await zf(e):await Bf(e,t.value)}async function Rf(e){let{device:t,appPackage:n,action:r,userArgs:i,grants:a,applied:o,warnings:s}=e;await ip(t,n,r,{appOps:`POST_NOTIFICATION`,permission:`android.permission.POST_NOTIFICATIONS`},i),o.push(`android.permission.POST_NOTIFICATIONS`),Uf(s,a,n,`android.permission.POST_NOTIFICATIONS`)}async function zf(e){let{device:t,appPackage:n,action:r,userArgs:i,warnings:a}=e,o=await Kf(t,n,r===`grant`?`grant`:`revoke`,i);if(o===void 0){a.push(`Skipped Android photos permission for ${n}: device refused both media candidates.`);return}await Vf(e,o)}async function Bf(e,t){let{device:n,appPackage:r,action:i,userArgs:a,warnings:o}=e,s=await Wf(n,i===`grant`?`grant`:`revoke`,a,r,t);if(!s.ok){o.push(`Skipped ${t} for ${r}: ${s.reason}`);return}await Vf(e,t)}async function Vf(e,t){let{device:n,appPackage:r,action:i,userArgs:a,grants:o,applied:s,warnings:c}=e;s.push(t),i===`reset`&&await ap(n,r,t,a),i!==`grant`&&Uf(c,o,r,t)}function Hf(e){let t=[],n=!1;for(let r of e)r===`android.permission.POST_NOTIFICATIONS`?t.push({kind:`notification`}):r===`android.permission.READ_MEDIA_IMAGES`||r===`android.permission.READ_EXTERNAL_STORAGE`?n||(n=!0,t.push({kind:`photos`})):t.push({kind:`pm`,value:r});return t}function Uf(e,t,n,r){let i=jf(n,r,t?.get(r)??`unknown`);i&&e.push(i)}async function Wf(e,t,n,r,i){let a=await T(e,[`pm`,t,...n,r,i],{allowFailure:!0});if(a.exitCode===0)return{ok:!0};if(Gf(a.stderr))return{ok:!1,reason:Jf(a.stderr)};throw w(`Failed to ${t} Android permission ${i} for ${r}`,a,{appPackage:r,permission:i})}function Gf(e){let t=e.toLowerCase();return t.includes(`not a changeable permission`)||t.includes(`has not requested permission`)||t.includes(`is not a runtime permission`)||t.includes(`unknown permission`)||t.includes(`managed by role`)}async function Kf(e,t,n,r){try{return await rp(e,t,n,r)}catch(e){if(qf(e))return;throw e}}function qf(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=e.details?.attempts;return!Array.isArray(n)||n.length===0?!1:n.every(e=>typeof e.stderr==`string`&&Gf(e.stderr))}function Jf(e){let t=e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0),n=t[0]??`unknown device error`;return(n.endsWith(`:`)&&t[1]?`${n} ${t[1]}`:n).slice(0,200)}async function Yf(e,t,n,r,i){if(n.kind===`notifications`)await ip(e,t,`grant`,n,i);else if(n.kind===`photos`)await rp(e,t,`grant`,i);else if(n.kind===`pm`)for(let a of await Qf(e,t,n.values,r))await T(e,[`pm`,`grant`,...i,t,a]);else if(n.kind===`all`)throw Error(`Unhandled Android permission target: all is resolved by the caller.`);else throw Error(`Unhandled Android permission target: ${JSON.stringify(n)}`)}async function Xf(e,t,n,r,i){if(r.kind===`notifications`)return await ip(e,t,n,r,i),[r.permission];if(r.kind===`photos`){let r=await rp(e,t,`revoke`,i);return n===`reset`&&await ap(e,t,r,i),[r]}throw r.kind===`pm`?Error(`Unhandled Android permission target: pm is resolved by the caller.`):r.kind===`all`?Error(`Unhandled Android permission target: all is resolved by the caller.`):Error(`Unhandled Android permission target: ${JSON.stringify(r)}`)}function Zf(e,n){let r=_e(e);if(n?.trim())throw new t(`INVALID_ARGS`,`Android does not support permission modes. Received: ${n}.`);if(r===`all`)return{kind:`all`};if(r===`photos`)return{kind:`photos`};if(r===`notifications`)return{kind:`notifications`,appOps:`POST_NOTIFICATION`,permission:`android.permission.POST_NOTIFICATIONS`};let i=r in Nf?Nf[r]:void 0;if(i)return{kind:`pm`,values:i};throw new t(`INVALID_ARGS`,`Unsupported permission target on Android: ${e}. Use ${Mf.join(`|`)}.`,{hint:`Android custom permission ids are attempted through all, not individually.`})}async function Qf(e,t,n,r){let{requested:i}=await yf(e,t,r);return $f(i,n,t)}function $f(e,n,r){if(e===void 0)return n;let i=n.filter(t=>e.includes(t));if(i.length===0)throw new t(`COMMAND_FAILED`,`Package ${r} has not requested permission ${n.join(`, `)}, so no permission was changed.`,{appPackage:r,permission:n.join(`,`)});return i}async function ep(e,t,n,r,i,a){let{requested:o,grants:s}=await yf(e,t,i),c=$f(o,r.values,t);await tp(e,t,c,n,a);let{priorGrantState:l,warnings:u}=np(t,c,c.map(e=>s?.get(e)??`unknown`));return{permission:[...c].join(`,`),priorGrantState:l,...u.length>0?{warnings:u}:{}}}async function tp(e,t,n,r,i){for(let r of n)await T(e,[`pm`,`revoke`,...i,t,r]);if(r===`reset`)for(let r of n)await ap(e,t,r,i)}function np(e,t,n){return{priorGrantState:n.includes(`granted`)?`granted`:n.includes(`unknown`)?`unknown`:`not_granted`,warnings:t.flatMap((t,r)=>{let i=jf(e,t,n[r]);return i?[i]:[]})}}async function rp(e,n,r,i){let a=await op(e),o=a!==null&&a>=33?[`android.permission.READ_MEDIA_IMAGES`,`android.permission.READ_EXTERNAL_STORAGE`]:[`android.permission.READ_EXTERNAL_STORAGE`,`android.permission.READ_MEDIA_IMAGES`],s=[];for(let t of o){let a=await T(e,[`pm`,r,...i,n,t],{allowFailure:!0});if(a.exitCode===0)return t;s.push({permission:t,stderr:a.stderr,exitCode:a.exitCode})}throw new t(`COMMAND_FAILED`,`Failed to ${r} Android photos permission`,{appPackage:n,sdkInt:a,attempts:s})}async function ip(e,t,n,r,i){let a=n===`grant`?`allow`:n===`deny`?`deny`:`default`;n===`grant`?await T(e,[`pm`,`grant`,...i,t,r.permission],{allowFailure:!0}):(await T(e,[`pm`,`revoke`,...i,t,r.permission],{allowFailure:!0}),n===`reset`&&await ap(e,t,r.permission,i)),await T(e,[`appops`,`set`,...i,t,r.appOps,a])}async function ap(e,t,n,r){for(let i of[`user-set`,`user-fixed`])await T(e,[`pm`,`clear-permission-flags`,...r,t,n,i],{allowFailure:!0})}async function op(e){let t=await T(e,[`getprop`,`ro.build.version.sdk`],{allowFailure:!0});if(t.exitCode!==0)return null;let n=Number.parseInt(t.stdout.trim(),10);return!Number.isFinite(n)||n<=0?null:n}function sp(e){let n=e.trim().toLowerCase();if(n===`light`)return`light`;if(n===`dark`)return`dark`;if(n===`toggle`)return`toggle`;throw new t(`INVALID_ARGS`,`Invalid appearance state: ${e}. Use light|dark|toggle.`)}function cp(e){let n=e.toLowerCase();if(n===`on`||n===`true`||n===`1`)return!0;if(n===`off`||n===`false`||n===`0`)return!1;throw new t(`INVALID_ARGS`,`Invalid setting state: ${e}`)}function lp(e){return e.map(e=>({args:e.args.join(` `),exitCode:e.exitCode,stderr:e.stderr.slice(0,400)}))}const up=[`cmd`,`connectivity`,`airplane-mode`];async function dp(e,n){let r=n?`enabled`:`disabled`;await fp(e),await T(e,[...up,n?`enable`:`disable`]);let i=await pp(e);if(i!==r)throw new t(`COMMAND_FAILED`,`Android airplane mode reads ${i} after requesting ${r}.`,{deviceId:e.id,requested:r,airplaneMode:i});return{airplaneMode:i}}async function fp(e){let{state:n,result:r}=await mp(e);if(!n)throw r.exitCode!==0&&nt(r.stdout,r.stderr)?new t(`UNSUPPORTED_OPERATION`,`The connectivity service on this Android build has no airplane-mode command, so nothing was changed.`,{deviceId:e.id,hint:`settings airplane needs cmd connectivity airplane-mode, which requires Android 11 (API 30) or newer. Use a newer device or emulator image.`,stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode}):w(`Failed to read Android airplane mode`,r,{deviceId:e.id})}async function pp(e){let{state:t,result:n}=await mp(e);if(t)return t;throw w(`Failed to read Android airplane mode after changing it`,n,{deviceId:e.id})}async function mp(e){let t=await T(e,[...up],{allowFailure:!0});return{state:t.exitCode===0?hp(t.stdout):void 0,result:t}}function hp(e){let t=e.trim().toLowerCase();if(t===`enabled`)return`enabled`;if(t===`disabled`)return`disabled`}const gp=[`window_animation_scale`,`transition_animation_scale`,`animator_duration_scale`],_p={"extra-small":`0.82`,small:`0.88`,medium:`0.94`,large:`1.0`,"extra-large":`1.12`,"extra-extra-large":`1.24`,"extra-extra-extra-large":`1.35`,"accessibility-medium":`1.5`,"accessibility-large":`1.75`,"accessibility-extra-large":`2.0`,"accessibility-extra-extra-large":`2.5`,"accessibility-extra-extra-extra-large":`3.2`},vp=_p.large;async function yp(e,n,r,i,a){switch(n.toLowerCase()){case`wifi`:{let t=cp(r);await T(e,[`svc`,`wifi`,t?`enable`:`disable`]);return}case`airplane`:return await dp(e,cp(r));case`location`:{if(r.toLowerCase()===`set`){if(e.kind!==`emulator`)throw new t(`UNSUPPORTED_OPERATION`,`Android precise location coordinates are supported only on emulators.`,{deviceId:e.id,hint:`Use an Android emulator for adb emu geo fix, or configure location through device/provider tooling.`});let{latitude:n,longitude:r}=ge(a);return await tt(e,[`emu`,`geo`,`fix`,String(r),String(n)]),{latitude:n,longitude:r}}let n=cp(r)?`3`:`0`;await T(e,[`settings`,`put`,`secure`,`location_mode`,n]);return}case`animations`:{let t=cp(r)?`1`:`0`;for(let n of gp)await T(e,[`settings`,`put`,`global`,n,t]);return{scale:t,keys:[...gp]}}case`appearance`:{let t=await kp(e,r);await T(e,[`cmd`,`uimode`,`night`,t===`dark`?`yes`:`no`]);return}case`clear-app-state`:{if(r.toLowerCase()!==`clear`)throw new t(`INVALID_ARGS`,`settings clear-app-state only supports clear.`);if(!i)throw new t(`INVALID_ARGS`,`settings clear-app-state requires an app id or an active app session.`);let n=await St(e,i);if(n.type===`intent`)throw new t(`INVALID_ARGS`,`settings clear-app-state requires a package name, not an intent.`);await T(e,[`am`,`force-stop`,n.value],{allowFailure:!0});let a=await T(e,[`pm`,`clear`,n.value],{allowFailure:!0});if(a.exitCode!==0||!/\bSuccess\b/i.test(a.stdout))throw new t(`COMMAND_FAILED`,`Failed to clear Android app data for ${n.value}`,{package:n.value,stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode});return{package:n.value,cleared:!0}}case`fingerprint`:await Ep(e,Tp(r));return;case`permission`:if(!i)throw new t(`INVALID_ARGS`,`permission setting requires an active app in session`);return await Ff(e,i,r,a);case`text-size`:return await Sp(e,r);default:throw new t(`INVALID_ARGS`,`Unsupported setting: ${n}`)}}const bp={"text-size":Cp};async function xp(e,t){return await bp[t](e)}async function Sp(e,t){let n=ye(t),r=_p[n];return await T(e,[`settings`,`put`,`system`,`font_scale`,r]),ve(n,r)}async function Cp(e){let n=(await T(e,[`settings`,`get`,`system`,`font_scale`])).stdout.trim(),r=n===`null`?vp:n,i=/^(\d+(\.\d+)?)$/.test(r)?Number(r):NaN;if(!Number.isFinite(i)||i<=0)throw new t(`COMMAND_FAILED`,`Android reported an unusable font scale: ${n||`(empty)`}`,{deviceId:e.id,fontScale:n,hint:"Run `adb shell settings get system font_scale` to see what the device holds."});return ve(wp(i),r)}function wp(e){let t=he[0],n=1/0;for(let r of he){let i=Math.abs(Number.parseFloat(_p[r])-e);i>=n||(t=r,n=i)}return t}function Tp(e){let n=e.trim().toLowerCase();if(n===`match`)return`match`;if(n===`nonmatch`)return`nonmatch`;throw new t(`INVALID_ARGS`,`Invalid fingerprint state: ${e}. Use match|nonmatch.`)}async function Ep(e,n){let r=Dp(e,n),i=[];for(let t of r){let n=await tt(e,t,{allowFailure:!0});if(n.exitCode===0)return;i.push({args:t,stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})}let a=lp(i);throw i.length>0&&i.every(e=>Op(e.stdout,e.stderr))?new t(`UNSUPPORTED_OPERATION`,`Android fingerprint simulation is not supported on this target/runtime.`,{deviceId:e.id,action:n,hint:`Use an Android emulator with biometric support, or a device/runtime that exposes cmd fingerprint.`,attempts:a}):new t(`COMMAND_FAILED`,`Failed to simulate Android fingerprint.`,{deviceId:e.id,action:n,attempts:a})}function Dp(e,t){let n=t===`match`?`1`:`9999`,r=[Oe(`adb`,`shell`,[`cmd`,`fingerprint`,`touch`,n]),Oe(`adb`,`shell`,[`cmd`,`fingerprint`,`finger`,n])];return e.kind===`emulator`&&r.push([`emu`,`finger`,`touch`,n]),r}function Op(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`unknown command`)||n.includes(`can't find service: fingerprint`)||n.includes(`service fingerprint was not found`)||n.includes(`fingerprint cmd unavailable`)||n.includes(`emu command is not supported`)||n.includes(`emulator console is not running`)||n.includes(`fingerprint`)&&n.includes(`not found`)}async function kp(e,n){let r=sp(n);if(r!==`toggle`)return r;let i=await T(e,[`cmd`,`uimode`,`night`],{allowFailure:!0});if(i.exitCode!==0)throw w(`Failed to read current Android appearance`,i);let a=Ap(i.stdout,i.stderr);if(!a)throw new t(`COMMAND_FAILED`,`Unable to determine current Android appearance for toggle`,{stdout:i.stdout,stderr:i.stderr});return a===`auto`?`dark`:a===`dark`?`light`:`dark`}function Ap(e,t){let n=/night mode:\s*(yes|no|auto)\b/i.exec(`${e}\n${t}`);if(!n)return null;let r=n[1]?.toLowerCase();return r===`yes`?`dark`:r===`no`?`light`:r===`auto`?`auto`:null}const jp=Buffer.from([137,80,78,71,13,10,26,10]);async function Mp(e,t,n={}){if(n.stabilize===!1){await Fp(e,t);return}await Np(e);try{await g(1e3),await Fp(e,t)}finally{await Pp(e).catch(()=>{})}}async function Np(e){let t=t=>T(e,t,{allowFailure:!0});await t([`settings`,`put`,`global`,`sysui_demo_allowed`,`1`]);let n=e=>t([`am`,`broadcast`,`-a`,`com.android.systemui.demo`,`-e`,`command`,...e]);await n([`clock`,`-e`,`hhmm`,`0941`]),await n([`notifications`,`-e`,`visible`,`false`])}async function Pp(e){await T(e,[`am`,`broadcast`,`-a`,`com.android.systemui.demo`,`-e`,`command`,`exit`],{allowFailure:!0})}async function Fp(e,n){let r=await et(e,[`screencap`,`-p`],{binaryStdout:!0});if(!r.stdoutBuffer)throw new t(`COMMAND_FAILED`,`Failed to capture screenshot`);let i=r.stdoutBuffer.indexOf(jp);if(i<0)throw new t(`COMMAND_FAILED`,`Screenshot data does not contain a valid PNG header`);let a=Ip(r.stdoutBuffer,i);if(!a)throw new t(`COMMAND_FAILED`,`Screenshot data does not contain a complete PNG payload`);await x().files.writeBytes(n,r.stdoutBuffer.subarray(i,a))}function Ip(e,t){let n=t+jp.length;for(;n+8<=e.length;){let t=e.readUInt32BE(n),r=n+4,i=e.toString(`ascii`,r,r+4),a=n+12+t;if(a>e.length)return null;if(i===`IEND`)return a;n=a}return null}async function Lp(e,t,n=0){let r=Ve(e);if(r){await r({action:`type`,text:t,delayMs:n}),$(`type`,`provider-native`,t);return}let i=await Hp(e,`type`,t);if(i.backend===`test-ime`){await Up(e,i.packageName,t,n);return}if(n>0&&Array.from(t).length>1){await Gp(e,{action:`type`,text:t,chunkSize:1,delayMs:n});return}await Gp(e,{action:`type`,text:t,chunkSize:8,delayMs:0})}async function Rp(e,t,n,r,i=0,a={}){let o=await nu(e,t,n,a),s=Ve(e);if(s)return await s({action:`fill`,target:{x:t,y:n},text:r,delayMs:i}),$(`fill`,`provider-native`,r),X(r,o,await $l(e,t,n,r,a));let c=null;for(let s of zp(i)){await ja(e,t,n);let i=await Hp(e,`fill`,r);if(i.backend===`test-ime`)return X(r,o,await Wp(e,i.packageName,t,n,r,o,a));let l=await Bp(e,{x:t,y:n,text:r,beforeTarget:o,attempt:s},a);if(c=l,l.ok)return;if(l.reason===`ime_capture`)return X(r,o,l);let u=ru(r,o,l);if(u)return u}return X(r,o,c)}function zp(e){return[{clearPadding:12,minClear:8,maxClear:48,chunkSize:e>0?1:8,inputDelayMs:e},{clearPadding:24,minClear:16,maxClear:96,chunkSize:e>0?1:4,inputDelayMs:e>0?e:15}]}async function Bp(e,t,n){let{x:r,y:i,text:a,beforeTarget:o,attempt:s}=t;return await qp(e,Vp(a,o,s)),await Gp(e,{action:`fill`,text:a,chunkSize:s.chunkSize,delayMs:s.inputDelayMs}),$l(e,r,i,a,n)}function Vp(e,t,n){let r=Array.from(e).length;return nm(r>0?r+n.clearPadding:t?.text?Array.from(t.text).length+n.clearPadding:n.maxClear,n.minClear,n.maxClear)}async function Hp(e,t,n){if(Zo(e))return{backend:`test-ime`,packageName:(await jo(C(e))).manifest.packageName};let r=await Jp(e,t),i=r?.inputMethodPackage;return Lo(i)?{backend:`test-ime`,packageName:i}:(Xp(n),Yp(r,t),{backend:`adb-shell`})}async function Up(e,t,n,r){let i=y(e),a=n.split(`
-`);for(let[n,o]of a.entries()){let s=r>0?tm(o,1):[o];for(let[e,o]of s.entries())o&&await Ro(i,t,o),r>0&&(e+1<s.length||n+1<a.length)&&await g(r);n+1<a.length&&await T(e,[`input`,`keyevent`,`ENTER`])}$(`type`,`test-ime`,n)}async function Wp(e,t,n,r,i,a,o){let s=y(e),c=null;for(let l=0;l<2;l+=1){l>0&&await ja(e,n,r),await zo(s,t),i&&await Ro(s,t,i);let u=await $l(e,n,r,i,o);if(c=u,u.ok||ru(i,a,u))break}return $(`fill`,`test-ime`,i),c}async function Gp(e,t){let n=t.text.split(`
-`);for(let[r,i]of n.entries()){let a=tm(i,t.chunkSize);for(let[i,o]of a.entries())await Kp(e,o),t.delayMs>0&&(i+1<a.length||r+1<n.length)&&await g(t.delayMs);r+1<n.length&&await T(e,[`input`,`keyevent`,`ENTER`])}$(t.action,`adb-shell`,t.text)}async function Kp(e,t){if(t)try{await T(e,[`input`,`text`,Qp(t)])}catch(e){throw $p(e)?em(t,e):e}}async function qp(e,t){let n=Math.max(0,t);await T(e,[`input`,`keyevent`,`KEYCODE_MOVE_END`],{allowFailure:!0});for(let t=0;t<n;t+=24){let r=Math.min(24,n-t);await T(e,[`input`,`keyevent`,...Array(r).fill(`KEYCODE_DEL`)],{allowFailure:!0})}}async function Jp(e,t){try{return await lo(e)}catch(e){return h({level:`warn`,phase:`android_input_ownership_probe_failed`,data:{action:t,error:e instanceof Error?e.message:String(e)}}),null}}function Yp(e,n){if(!(!e||e.inputOwner!==`ime`))throw new t(`COMMAND_FAILED`,`KEYBOARD_OVERLAY_BLOCKING: Android text input is blocked because the focused input belongs to the active keyboard/IME.`,{failureReason:`ime_capture`,action:n,inputOwner:e.inputOwner,inputType:e.inputType,type:e.type,inputMethodPackage:e.inputMethodPackage,focusedPackage:e.focusedPackage,focusedResourceId:e.focusedResourceId,nextAction:`Focused input appears to be owned by the keyboard/IME; dismiss or change the IME before retrying text entry.`})}function Xp(e){if(!Zp(e))throw em(e)}function Zp(e){for(let t of e){let e=t.codePointAt(0);if(e!==void 0&&t!==`
-`&&(e<32||e>126))return!1}return!0}function Qp(e){return e.replaceAll(` `,`%s`)}function $p(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=e.details?.stderr,r=(typeof n==`string`?n:``).toLowerCase();return!!(r.includes(`exception occurred while executing 'text'`)||r.includes(`nullpointerexception`)&&r.includes(`inputshellcommand.sendtext`))}function em(e,n){return new t(`COMMAND_FAILED`,"Android text input requires provider-native text injection or the bundled test IME helper for non-ASCII/control characters; the adb-shell fallback supports ASCII text only. On emulators the test IME activates automatically; on real devices pass `open --test-ime` to enable it (see `agent-device doctor` for the current IME state).",{backend:`adb-shell`,textLength:Array.from(e).length,textPreview:e.slice(0,32)},n instanceof Error?n:void 0)}function tm(e,t){let n=Math.max(1,Math.floor(t)),r=[],i=Array.from(e);for(let e=0;e<i.length;e+=n)r.push(i.slice(e,e+n).join(``));return r.length>0?r:[``]}function $(e,t,n){h({phase:`android_text_injection`,data:{action:e,backend:t,textLength:Array.from(n).length}})}function nm(e,t,n){return Math.max(t,Math.min(n,e))}var rm=e({ANDROID_FOCUSED_WINDOW_MARKER:()=>Ot,ANDROID_FOCUS_MARKERS:()=>Et,ANDROID_IME_HELPER_SERVICE_COMPONENT:()=>`com.callstack.agentdevice.imehelper/.TestInputMethodService`,ANDROID_SNAPSHOT_PRESENTATION_DEFAULT_DEADLINE_MS:()=>250,ANDROID_TEST_IME_SETTINGS_KEYS:()=>Wo,ANDROID_TOUCH_PLAN_PROTOCOL:()=>Qi,AndroidSnapshotPresentationFailure:()=>Y,activateAndroidTestIme:()=>Eu,androidAdbForwardsDeviceExitStatus:()=>Ht,androidAdbHostTarget:()=>Ye,androidAdbInvocation:()=>qe,androidAdbResultError:()=>w,androidAdbSerialTarget:()=>Je,androidAppsDiscoveryHint:()=>Ct,androidCaptureFailureReasonDetail:()=>hr,androidCaptureFailureReasonFromExitCode:()=>mr,androidCaptureFailureReasonFromHelperResult:()=>pr,androidClipboardShellSupportForResult:()=>am,androidDeviceChecks:()=>cs,androidFillFailureDetails:()=>su,androidFillFailureMessage:()=>ou,androidRevokedPermissionWarning:()=>jf,androidSnapshotPublicationInput:()=>wl,androidToolchainCheck:()=>ss,androidUiNodes:()=>Mc,annotateAndroidNativePerfError:()=>N,appSwitcherAndroid:()=>ka,attachAdbFailureHint:()=>Ze,backAndroid:()=>xa,buildAndroidFillUnconfirmedVerification:()=>ru,buildAndroidNativeToolUnavailableHint:()=>Ar,buildAndroidSnapshotClickabilityEvidence:()=>Kc,buildAndroidSnapshotHelperArgs:()=>li,buildAndroidSnapshotHelperCaptureOptions:()=>si,buildUiHierarchySnapshot:()=>fc,captureAndroidHeapSnapshot:()=>af,captureAndroidLogcatWithAdb:()=>om,captureAndroidSnapshotWithHelper:()=>oi,captureAndroidSnapshotWithHelperSession:()=>qi,classifyAdbFailure:()=>$e,classifyAndroidAlertIdentifier:()=>en,classifyAndroidAppTarget:()=>vt,classifyAndroidHelperContent:()=>Jc,cleanupAndroidNativePerfSession:()=>Pd,clearAndroidImeHelperText:()=>zo,clearAndroidTestImeRecoveryMarker:()=>Mu,closeAndroidApp:()=>pt,completeAndroidFillVerification:()=>X,createAndroidPortReverseManager:()=>ze,createAndroidSnapshotCapture:()=>Cl,createAndroidSnapshotPresentationBudget:()=>sc,createAndroidSnapshotPresentationNode:()=>rc,createAndroidWindowDumpReader:()=>Mt,createDeviceAdbExecutor:()=>Be,createLocalAndroidAdbProvider:()=>Ie,dismissAndroidKeyboard:()=>uo,dismissAndroidKeyboardWithAdb:()=>fo,ensureAndroidEmulatorBooted:()=>gt,ensureAndroidImeHelper:()=>Fo,ensureAndroidSdkPathConfigured:()=>ft,ensureAndroidSnapshotHelper:()=>or,executeAndroidTouchHelperPlan:()=>na,executeAndroidTouchPlan:()=>ga,fillAndroid:()=>Rp,findAndroidAlertCandidate:()=>tn,focusAndroid:()=>ja,forceStopAndroidAppWithAdb:()=>qa,forgetAndroidSnapshotHelperInstall:()=>tr,formatAndroidInstalledPackageRequiredMessage:()=>xt,getAndroidAppState:()=>At,getAndroidBlockingDialogObservation:()=>jt,getAndroidImeHelperDeviceKey:()=>U,getAndroidKeyboardState:()=>lo,getAndroidKeyboardStatusWithAdb:()=>V,getAndroidScreenSize:()=>Fa,handleAndroidAlert:()=>Ia,homeAndroid:()=>Sa,inferAndroidAppName:()=>bt,inferAndroidPackageAfterOpen:()=>cm,inspectInstalledAndroidHelper:()=>Fn,installAndroidAdbPackage:()=>He,installAndroidInstallablePath:()=>io,isAmStartError:()=>ht,isAndroidImeHelperPackage:()=>Lo,isAndroidPermissionPackage:()=>Kt,isAndroidSnapshotPresentationFailure:()=>ac,isAndroidTestImeActive:()=>Zo,listAndroidAdbSerialsQuick:()=>as,listAndroidAppsWithAdb:()=>im,longPressAndroid:()=>Aa,lowerAndroidAdbInvocation:()=>Ge,lowerAndroidTouchPlan:()=>ma,makeEnsureAndroidHelperInstalled:()=>Ln,normalizeAndroidTouchHelperGestureRequest:()=>sa,openAndroidApp:()=>dt,openAndroidAppWithAdb:()=>Ya,openAndroidDevice:()=>lt,parseAndroidAdbArgv:()=>Xe,parseAndroidHelperManifest:()=>Jn,parseAndroidLaunchComponent:()=>mt,parseAndroidLaunchablePackages:()=>Tt,parseAndroidSnapshotHelperManifest:()=>Jn,parseAndroidSnapshotHelperOutput:()=>vi,parseAndroidUserInstalledPackages:()=>wt,parseInstrumentationRecords:()=>Tn,parseUiHierarchyTree:()=>Wc,prepareAndroidInstallArtifact:()=>Zu,pressAndroid:()=>ya,pressAndroidEnter:()=>Ca,pressAndroidTvRemote:()=>ba,pullAndroidAdbFile:()=>Re,pushAndroidNotification:()=>ed,readAndroidBlockingDialogFocus:()=>Dt,readAndroidClipboardText:()=>Co,readAndroidClipboardWithAdb:()=>wo,readAndroidDefaultInputMethod:()=>W,readAndroidFillTargetBeforeMutation:()=>nu,readAndroidGestureViewport:()=>_a,readAndroidHelperManifestInteger:()=>Sn,readAndroidHelperManifestLiteral:()=>O,readAndroidSetting:()=>xp,readAndroidTestImeRecoveryMarkers:()=>Nu,readAndroidTextAtPoint:()=>eu,readAndroidTextAtPointInHierarchy:()=>au,readAndroidTouchHelperFinalRecord:()=>ua,readAndroidTouchHelperViewportReading:()=>ra,readInstrumentationResultBoolean:()=>A,readInstrumentationResultNumber:()=>k,resetAndroidAdbShellProtocolProbes:()=>Ut,resetAndroidFramePerfStats:()=>kd,resetAndroidImeHelperInstallCache:()=>Io,resetAndroidSnapshotHelperInstallCache:()=>nr,resetAndroidSnapshotHelperRuntime:()=>xl,resetAndroidSnapshotHelperSessions:()=>Ki,resetAndroidTestImeActivationCacheForTests:()=>$o,resetAndroidWindowDumpFocusMemoForTests:()=>kt,resolveAndroidAdbExecutor:()=>y,resolveAndroidAdbProvider:()=>C,resolveAndroidApp:()=>St,resolveAndroidArchivePackageName:()=>Ru,resolveAndroidHelperArtifact:()=>In,resolveAndroidImeHelperArtifact:()=>Mo,resolveAndroidPackageForOpen:()=>sm,resolveAndroidSnapshotHelperCaptureOptions:()=>ci,resolveAndroidTextInjector:()=>Ve,resolveAndroidTouchProvider:()=>Pe,resolveScopedAndroidAdbBackgroundTransport:()=>Le,restoreAndroidTestIme:()=>ts,restoreOrphanedAndroidTestImeOnDaemonStartup:()=>is,retireAndroidSnapshotHelperAfterContentFailure:()=>bl,runAdbExecOut:()=>Ue,runAdbShell:()=>b,runAndroidAdb:()=>tt,runAndroidExecOut:()=>et,runAndroidHostAdb:()=>Ne,runAndroidShell:()=>T,runAndroidSnapshotHelperSessionTouchCommand:()=>Yi,sampleAndroidFramePerf:()=>Od,sampleAndroidMemoryPerf:()=>rf,screenshotAndroid:()=>Mp,scrollAndroid:()=>Ma,selectAndroidImeHelperArtifact:()=>jo,sendAndroidImeHelperText:()=>Ro,serializeAndroidAdbInvocation:()=>Ke,setAndroidOrientation:()=>wa,setAndroidPermission:()=>Ff,setAndroidSetting:()=>yp,setAndroidTestImeActiveForTests:()=>es,sleep:()=>g,snapshotAndroid:()=>El,startAndroidPerfettoTrace:()=>Wd,startAndroidSimpleperfProfile:()=>Jd,stopAndroidPerfettoTrace:()=>Gd,stopAndroidSimpleperfProfile:()=>Yd,stopAndroidSnapshotHelperSession:()=>B,stopAndroidSnapshotHelperSessionForDevice:()=>Gi,typeAndroid:()=>Lp,validateAndroidGestureViewport:()=>jn,validateAndroidRegularPresentation:()=>cc,verifyAndroidFilledText:()=>$l,verifyAndroidFilledTextInHierarchy:()=>iu,verifyAndroidHelperApkChecksum:()=>Vn,waitForAndroidBoot:()=>ut,withAndroidAdbProvider:()=>Fe,withAndroidAppResolutionCacheInvalidated:()=>yt,withAndroidHostAdbTransport:()=>We,writeAndroidClipboardText:()=>To,writeAndroidClipboardWithAdb:()=>Eo,writeAndroidSimpleperfReport:()=>Xd,writeAndroidTestImeRecoveryMarker:()=>ju});async function im(...e){let{listAndroidAppsWithAdb:t}=await import(`./app-helpers.js`);return await t(...e)}async function am(...e){let{androidClipboardShellSupportForResult:t}=await import(`./clipboard-shell-response.js`);return t(...e)}async function om(...e){let{captureAndroidLogcatWithAdb:t}=await import(`./logcat.js`);return await t(...e)}async function sm(...e){let{resolveAndroidPackageForOpen:t}=await import(`./open-target-resolution.js`);return await t(...e)}async function cm(...e){let{inferAndroidPackageAfterOpen:t}=await import(`./open-target-resolution.js`);return await t(...e)}export{Ma as A,xa as C,ya as D,Aa as E,ga as M,_a as N,Ca as O,ka as S,Sa as T,To as _,Lp as a,Ya as b,yp as c,uo as d,fo as f,wo as g,Co as h,Rp as i,wa as j,ba as k,El as l,V as m,im as n,Mp as o,lo as p,rm as r,xp as s,om as t,wl as u,Eo as v,ja as w,Ia as x,qa as y};
+`).replace(/\n$/,``),n=t.match(/^clipboard text:\s*(.*)$/i);return n?n[1]??``:t.trim().toLowerCase()===`null`?``:t}const Po=`com.callstack.agentdevice.imehelper`,Fo=`android-ime-helper-v1`;async function Io(e){return e.imeHelperArtifact??await Lo()}async function Lo(){return await S().resolveHelperArtifact({helperDirName:`ime-helper`,manifestFileName:e=>`agent-device-android-ime-helper-${e}.manifest.json`,parseManifest:Ro,unavailableMessage:`Android test IME text entry requires the bundled Android IME helper artifact, but it was not found or could not be read`})}const H=`IME helper`;function Ro(e){if(!e||typeof e!=`object`||Array.isArray(e))throw new t(`INVALID_ARGS`,`Android IME helper manifest must be an object.`);let n=e;return{name:k(n.name,`name`,`android-ime-helper`,H),version:Tn(n.version,`version`,H),assetName:Tn(n.assetName,`assetName`,H),sha256:En(n.sha256,H),packageName:k(n.packageName,`packageName`,Po,H),versionCode:wn(n.versionCode,`versionCode`,H),serviceComponent:k(n.serviceComponent,`serviceComponent`,`com.callstack.agentdevice.imehelper/.TestInputMethodService`,H),broadcastProtocol:k(n.broadcastProtocol,`broadcastProtocol`,Fo,H)}}const zo=new Set;async function Bo(e){return await S().ensureHelperInstalled({cache:zo,installTimeoutMs:3e4,helperLabel:`Android IME helper`},e)}function Vo(){zo.clear()}function U(e){return`${e.platform}:${e.id}`}function Ho(e){return e===Po}async function Uo(e,t,n){await Go(e,t,`com.callstack.agentdevice.imehelper.ACTION_INPUT_TEXT_B64`,{text:Buffer.from(n,`utf8`).toString(`base64`)})}async function Wo(e,t){await Go(e,t,`com.callstack.agentdevice.imehelper.ACTION_CLEAR_TEXT`,{})}async function Go(e,t,n,r){let i=[`am`,`broadcast`,`-p`,t,`-a`,n];i.push(`--es`,`protocol`,Fo);for(let[e,t]of Object.entries(r))i.push(`--es`,e,t);let a=await x(e,i,{allowFailure:!0,timeoutMs:1e4});if(a.exitCode!==0)throw T(`Android IME helper broadcast failed`,a,{action:n,packageName:t})}const Ko=`agent_device_ime_helper_previous_ime`,qo=`secure`,Jo=`default_input_method`,Yo={previousIme:Ko,defaultInputMethod:Jo};async function W(e){let t=await x(e,[`settings`,`get`,qo,Jo],{allowFailure:!0,timeoutMs:5e3});return es(t.exitCode===0?t.stdout:``)}async function G(e){let t=await x(e,[`settings`,`get`,qo,Ko],{allowFailure:!0,timeoutMs:5e3});return es(t.exitCode===0?t.stdout:``)||void 0}async function Xo(e,t){return(await x(e,[`settings`,`put`,qo,Ko,t],{allowFailure:!0,timeoutMs:5e3})).exitCode===0&&await G(e)===t}async function Zo(e){await x(e,[`settings`,`delete`,qo,Ko],{allowFailure:!0,timeoutMs:5e3})}async function Qo(e,t,r){try{(t?await Xo(e,t):await $o(e))||C({level:`warn`,phase:`android_test_ime_record_rollback_failed`,data:{device:r,hadPriorRecord:t!==void 0}})}catch(e){C({level:`warn`,phase:`android_test_ime_record_rollback_failed`,data:{device:r,hadPriorRecord:t!==void 0,error:n(e).message}})}}async function $o(e){return await Zo(e),await G(e)===void 0}function es(e){let t=e.trim();return!t||t===`null`?``:t}const K=new Set,ts=new Map;function ns(e){return K.has(U(e))}function rs(e,t,n){return Pt(ts,`${e}:${t}`,n)}function is(){K.clear()}function as(e,t){let n=U(e);t?K.add(n):K.delete(n)}async function os(e,t){return await rs(t.stateDir,e.id,async()=>{let n=U(e);if(!K.has(n))return{restored:!1,reason:`no-record`};K.delete(n);let r=await cs(b(e),e);return ss(r.reason)&&await S().imeRecoveryMarkers.clear(t.stateDir,e.id),r})}function ss(e){return e===`ok`||e===`helper-not-active`||e===`no-record`}async function cs(e,t){let n=t.id;if(K.has(U(t)))return{restored:!1,reason:`owned-by-live-session`};let r=await G(e);if(!r)return{restored:!1,reason:`no-record`};let i=await W(e);if(i!==`com.callstack.agentdevice.imehelper/.TestInputMethodService`)return C({level:`debug`,phase:`android_test_ime_restore_skipped`,data:{device:n,currentIme:i,previousIme:r}}),{restored:!1,previousIme:r,reason:`helper-not-active`};await x(e,[`ime`,`set`,r],{allowFailure:!0,timeoutMs:1e4});let a=await W(e);return a===r?(await Zo(e).catch(()=>{}),C({phase:`android_test_ime_restored`,data:{device:n,previousIme:r}}),{restored:!0,previousIme:r,reason:`ok`}):(C({level:`warn`,phase:`android_test_ime_restore_failed`,data:{device:n,previousIme:r,afterIme:a}}),{restored:!1,previousIme:r,reason:`set-failed`})}async function ls(e){let t=S().imeRecoveryMarkers,r=await t.read(e.stateDir);if(r.length===0)return;let i;try{i=new Set(await e.listSerials())}catch(e){C({level:`debug`,phase:`android_test_ime_startup_scan_failed`,data:{error:n(e).message}});return}for(let a of r){if(!i.has(a))continue;let r={platform:`android`,id:a,name:a,kind:a.startsWith(`emulator-`)?`emulator`:`device`,booted:!0};try{await rs(e.stateDir,a,async()=>{let n=await cs(b(r),r);n.restored&&C({level:`warn`,phase:`android_test_ime_orphan_restored`,data:{device:a,previousIme:n.previousIme}}),ss(n.reason)&&await t.clear(e.stateDir,a)})}catch(e){C({level:`debug`,phase:`android_test_ime_orphan_restore_failed`,data:{device:a,error:n(e).message}})}}}async function us(){S();try{return(await Fe(Qe([`devices`]),{timeoutMs:5e3})).stdout.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0&&!e.startsWith(`List of devices`)).map(e=>e.split(/\s+/)).filter(e=>e[1]===`device`).map(e=>e[0])}catch{return[]}}const ds=2e3;async function fs(e=S().environment,t=S().files){let n=e.ANDROID_HOME||e.ANDROID_SDK_ROOT,r=await ws(n,t),i=await Nt(`adb`,[`version`]);return i?bs({license:r,sdkRoot:n,versionLine:i}):Cs(n,r)}async function ps(e,t){if(e.platform!==`android`)return[];let n=b(e,t.transportOverrides.androidAdb),r=[];return t.shouldProbeMetro&&r.push(await ys(n,e.id,t.metroPort)),r.push(await ms(n,e)),r}async function ms(e,t){try{let n=await W(e),r=ns(t);return n===await hs()&&!r?await gs(e,t,n):_s(t,n,r)}catch(e){return vs(e)}}async function hs(){try{return(await Lo()).manifest.serviceComponent}catch{return}}async function gs(e,t,n){let r=(await x(e,[`settings`,`get`,`secure`,Yo.previousIme],{allowFailure:!0,timeoutMs:ds})).stdout.trim(),i=r&&r!==`null`?r:void 0;return{id:`android-test-ime`,status:`fail`,summary:`Android test IME helper is the active input method on ${t.id}, but no active session owns it -- likely left over from a crashed session.`,hint:`A stuck test IME leaves the real keyboard unavailable on this device until restored.`,command:i?`adb -s ${t.id} shell ime set ${i}`:`adb -s ${t.id} shell ime list -s`,evidence:{currentIme:n,previousIme:i}}}function _s(e,t,n){return{id:`android-test-ime`,status:`pass`,summary:n?`Android test IME helper is active for this session on ${e.id}.`:`Android test IME helper is not active on ${e.id}; the device's normal IME is in use.`,evidence:{currentIme:t}}}function vs(e){let t=n(e);return{id:`android-test-ime`,status:`warn`,summary:`Could not inspect the Android test IME helper state.`,hint:t.message,evidence:{code:t.code}}}async function ys(e,t,r){try{let n=await e([`reverse`,`--list`],{allowFailure:!0,timeoutMs:ds}),i=`tcp:${r} tcp:${r}`,a=n.stdout.includes(i);return{id:`android-reverse`,status:a?`pass`:`warn`,summary:a?`Android adb reverse exists for Metro port ${r}.`:`Android adb reverse is missing for Metro port ${r}.`,command:a?void 0:`adb -s ${t} reverse tcp:${r} tcp:${r}`,evidence:{stdout:n.stdout.trim()}}}catch(e){let t=n(e);return{id:`android-reverse`,status:`warn`,summary:`Could not inspect Android adb reverse mappings.`,hint:t.message,evidence:{code:t.code}}}}function bs(e){return{id:`toolchain`,status:xs(e),summary:e.versionLine?`Android toolchain: ${e.versionLine}; ${Ss(e.sdkRoot)}.`:`Android toolchain: adb is present but version check failed.`,hint:e.license===`missing`?`Accept Android SDK licenses before installing/building apps.`:void 0,command:e.license===`missing`?`sdkmanager --licenses`:void 0,evidence:{adbVersion:e.versionLine??null,androidHome:e.sdkRoot??null,license:e.license}}}function xs(e){return e.versionLine&&e.sdkRoot&&e.license!==`missing`?`pass`:`info`}function Ss(e){return e?`ANDROID_HOME/ANDROID_SDK_ROOT set`:`ANDROID_HOME unset`}function Cs(e,t){return{id:`toolchain`,status:`info`,summary:`Android toolchain: adb not found on PATH.`,hint:`Install Android platform-tools or add adb to PATH.`,evidence:{androidHome:e??null,license:t}}}async function ws(e,t){if(!e)return`unknown`;try{return await t.access(D.join(e,`licenses`,`android-sdk-license`)),`accepted`}catch{return`missing`}}function Ts(e,t){if(!t)return{expected:e,actual:null,failureReason:`text_mismatch`,targetInput:null,actualInput:null};let n=ks(t),r={failureReason:t.reason??`text_mismatch`,targetInput:Ds(t.targetInput),actualInput:Ds(t.actualInput)};return n?{...r,expectedLength:Array.from(e).length,actual:null,masked:!0,actualLength:Array.from(t.actual??``).length}:{...r,expected:e,actual:t.actual}}function q(e){return e?e.password?!0:Es(e.text):!1}function Es(e){return e?Array.from(e).every(Os):!1}function Ds(e){if(!e)return null;let t=q(e);return{...e,text:t?null:e.text,...t?{textRedacted:!0}:{}}}function Os(e){return e===`•`||e===`*`||e===`●`}function ks(e){return e.masked===!0||q(e.targetInput)||q(e.actualInput)}const As=new WeakMap;function js(e,t){return t&&As.set(e,t),e}function Ms(e){return As.get(e)}function Ns(e){return e.clickable}function Ps(e){return e.focusable||e.focused===!0}function J(e){return Ns(e)||Ps(e)}function Fs(e){let t=e.trim();return t?/^[\w.]+:id\/[\w.-]+$/i.test(t):!1}function Is(e,t){return{raw:e,...t?{effectiveRect:t}:{}}}function Ls(e,t,n){if(!e)return;let r=Bs(e);return t&&(r=zs(r,t)),n&&(r=zs(r,n)),r}function Rs(e){return{...e.raw,...e.effectiveRect?{rect:e.effectiveRect}:{rect:void 0},hittable:e.raw.hittable===!0&&ie(e.effectiveRect)?!0:void 0}}function zs(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height),o=i>n&&a>r;return{x:o?n:e.x,y:o?r:e.y,width:o?i-n:0,height:o?a-r:0}}function Bs(e){return{x:e.x,y:e.y,width:Math.max(0,e.width),height:Math.max(0,e.height)}}function Vs(e,t){let n=new Set;return Hs(e,n,t),Ws(e,n,t),n}function Hs(e,t,n){for(let r of e.children){if(n?.check(`work`),r.visibleToUser===!1){t.add(r);continue}Hs(r,t,n)}}function Us(e,t,n){return n?.check(`work`),e.children.filter(e=>!t.has(e)&&e.visibleToUser!==!1)}function Ws(e,t,n){let r=Us(e,t,n).filter(Ks);if(r.length<2)return;let i=r.filter(e=>qs(e)&&Js(e));if(i.length===0)return;let a=Gs(i);for(let r of Us(e,t,n))n?.check(`work`),qs(r)&&(Js(r)&&(a===void 0||r.windowLayer===a)||t.add(r))}function Gs(e){let t=e.map(e=>e.windowLayer).filter(e=>e!==void 0);return t.length>0?Math.max(...t):void 0}function Ks(e){return e.windowIndex!==void 0||e.windowType!==void 0}function qs(e){return e.windowType===1}function Js(e){return e.windowActive===!0||e.windowFocused===!0}function Ys(e,t,n,r,i){let a=new Set(e.sourceNodes),o=Zs(t,i),s=Xs(o,n,Qs(o,a,i),i);if(!s)return{nodes:[],sourceNodes:[]};let c=new Set(Zs([s],i)),l=[];for(let[t,n]of e.sourceNodes.entries())i.check(`work`),c.has(n)&&l.push(t);if(l.length===0)return{nodes:[],sourceNodes:[]};let u=1/0;for(let t of l)i.check(`work`),u=Math.min(u,e.nodes[t]?.depth??0);let d=[];for(let t of l)i.check(`work`),(e.nodes[t]?.depth??0)-u<=r&&d.push(t);return i.consume(d.length),{nodes:oe(d.map(t=>e.nodes[t]),u),sourceNodes:d.map(t=>e.sourceNodes[t])}}function Xs(e,t,n,r){for(let i of e)if(r.check(`work`),se(i,t)&&n.has(i))return i;return null}function Zs(e,t){let n=[],r=[...e].reverse();for(;r.length>0;){t.check(`work`);let e=r.pop();n.push(e);for(let n=e.children.length-1;n>=0;--n)t.check(`work`),r.push(e.children[n])}return n}function Qs(e,t,n){let r=new Set;for(let i=e.length-1;i>=0;--i){n.check(`work`);let a=e[i];if(t.has(a)){r.add(a);continue}for(let e of a.children)if(n.check(`work`),r.has(e)){r.add(a);break}}return r}function $s(e,t,n,r,i){if(e.visibleToUser===!1)return!1;let a=ec(e);return t.interactiveOnly?tc(e,a,n,r,i):a.isStructural||a.isVisual?ic(e,a,r):!0}function ec(e){let t=oc(e.type),n=!!(e.label&&e.label.trim().length>0),r=!!(e.identifier&&e.identifier.trim().length>0);return{type:t,hasMeaningfulText:n&&!Fs(e.label??``),hasMeaningfulId:r&&!Fs(e.identifier??``),isStructural:sc(t),isVisual:t===`imageview`||t===`imagebutton`}}function tc(e,t,n,r,i){return rc(e)?!1:J(e)||ne(t.type)&&r?!0:nc(t,n,r,i)}function nc(e,t,n,r){return!e.hasMeaningfulText&&!e.hasMeaningfulId||e.isVisual||e.isStructural&&!r&&!t?!1:t||n||r}function rc(e){return!!(e.rect&&(e.rect.width<=0||e.rect.height<=0))}function ic(e,t,n){return J(e)||t.hasMeaningfulText||t.hasMeaningfulId?!0:n}function ac(e){if(!e)return!1;let t=oc(e);return t.includes(`recyclerview`)||t.includes(`listview`)||t.includes(`gridview`)}function oc(e){return e?e.toLowerCase():``}function sc(e){let t=e.split(`.`).pop()??e;return t.includes(`layout`)||t===`viewgroup`||t===`view`}function cc(e,t,n,r){return{...Is(e,t),...n?{clipsDescendants:!0}:{},...r?{windowRect:r}:{}}}const lc=`ANDROID_SNAPSHOT_PRESENTATION_FAILED`;var Y=class extends Error{code=lc;qualityReasonCode=`presentation-failed`;details;analysis;constructor(e,t,n){super(e),this.name=`AndroidSnapshotPresentationFailure`,this.details=t,this.analysis=n}};function uc(e){return e instanceof Y?e.code===lc:!!(e&&typeof e==`object`&&e.code===lc)}var dc=class{workUnits=0;options;defaultMaxWorkUnits;deadlineAtMs;constructor(e,t){this.options=e,this.defaultMaxWorkUnits=t;let n=e.now??Date.now;this.deadlineAtMs=e.deadlineAtMs??n()+gc()}get workUnitCount(){return this.workUnits}check(e){this.consume(1)}consume(e){this.workUnits+=e;let t=this.options.maxWorkUnits??this.defaultMaxWorkUnits;if(this.workUnits>t)throw new Y(`Android snapshot presentation exceeded its linear work budget`,{phase:`complexity`,workUnits:this.workUnits,maxWorkUnits:t});if((this.options.now??Date.now)()>=this.deadlineAtMs)throw new Y(`Android snapshot presentation exceeded its cooperative deadline`,{phase:`deadline`,workUnits:this.workUnits,deadlineAtMs:this.deadlineAtMs,maxWorkUnits:t})}};function fc(e,t){return new dc(e??{},t)}function pc(e,t,n){let r=new Map;for(let i of e){n.check(`regular-invariant`);let e=mc(i,r,t),a=i.effectiveRect;if(!a||!ie(a)){if(Rs(i).hittable===!0)throw new Y(`Android regular snapshot node ${i.raw.index} with degenerate effective geometry was marked hittable`,{phase:`regular-invariant`,workUnits:n.workUnitCount,nodeIndex:i.raw.index,frame:a});r.set(i.raw.index,e);continue}if(e&&!hc(a,e))throw new Y(`Android regular snapshot node ${i.raw.index} escaped its cumulative clip`,{phase:`regular-invariant`,workUnits:n.workUnitCount,nodeIndex:i.raw.index,frame:a,clip:e});r.set(i.raw.index,i.clipsDescendants?a:e)}}function mc(e,t,n){let r=e.raw.parentIndex;return r===void 0?e.windowRect??n:t.get(r)??e.windowRect??n}function hc(e,t){let n=1e-4;return e.x>=t.x-n&&e.y>=t.y-n&&e.x+e.width<=t.x+t.width+n&&e.y+e.height<=t.y+t.height+n}function gc(){return 250}function _c(e,t,n){let r=n.depth??1/0,i=re(n.scope),a=Fc(e),o=fc(n.androidPresentation,Math.max(1024,a.rawNodeCount*128)),s={nodes:[],sourceNodes:[],...t===void 0?{}:{maxNodes:t},maxDepth:i?1/0:r,options:n,analysis:a,interactiveDescendantMemo:new Map,hidden:new Set,presentationBudget:o,presentationNodes:[],truncated:!1};try{o.check(`work`),s.viewport=Oc(e,o),s.hidden=n.raw?new Set:Vs(e,o);for(let t of e.children)if(yc(s,t,0),s.truncated)break;n.raw||pc(s.presentationNodes,s.viewport,o);let t=s.nodes,a=new Map(s.sourceNodes.map((e,t)=>[e,t])),{nodes:c,sourceNodes:l}=i?Ys(s,e.children,i,r,o):s,u={nodes:c,sourceNodes:l,occlusionContext:{nodes:t,sourceIndexByNodeIndex:new Map(l.flatMap((e,t)=>{let n=a.get(e),r=c[t]?.index;return n===void 0||r===void 0?[]:[[r,n]]})),androidSiblingOrderByNodeIndex:vc(s.sourceNodes)},analysis:s.analysis};return s.truncated?{...u,truncated:!0}:u}catch(e){throw uc(e)&&(e.analysis??=s.analysis),e}}function vc(e){let t=new Map,n=new Map;for(let[r,i]of e.entries()){let e=Ms(i);if(!e)continue;let a=t.get(e.parent);a===void 0&&(a=t.size,t.set(e.parent,a)),n.set(r,{group:a,order:e.order})}return n}function yc(e,t,n,r,i=!1,a=!1,o=!1,s,c){if(e.presentationBudget.check(`work`),bc(e,t,n))return;let l=t.windowRect??s??e.viewport,u=xc(e,t,c,l),d=Sc(e,t,r,i,a,o,u,l),f=i||J(t),p=a||ac(t.type),m=Cc(e,t,u,c);wc(e,t,n,d,f,p,o||It(t.identifier),l,m)}function bc(e,t,n){return e.maxNodes!==void 0&&e.nodes.length>=e.maxNodes?(e.truncated=!0,!0):n>e.maxDepth||e.hidden.has(t)}function xc(e,t,n,r){return e.options.raw?t.rect:Ls(t.rect,r,n)}function Sc(e,t,n,r,i,a,o,s){return!e.options.raw&&!$s(t,e.options,r,jc(e,t),i)?n:Tc(e,t,n,a||It(t.identifier),o,s)}function Cc(e,t,n,r){return e.options.raw||!kc(t)?r:n}function wc(e,t,n,r,i,a,o,s,c){for(let l of t.children)if(yc(e,l,n+1,r,i,a,o,s,c),e.truncated)return}function Tc(e,t,n,r,i,a){let o=e.nodes.length;return e.sourceNodes.push(t),Dc(e,t,Ec(e,t,n,r),i,a),o}function Ec(e,t,n,r){return{index:e.nodes.length,type:t.type??void 0,label:t.label??void 0,value:t.value??void 0,contentDescription:t.contentDescription,identifier:t.identifier??void 0,bundleId:t.packageName??void 0,rect:t.rect,enabled:t.enabled,focused:t.focused,selected:t.selected,heading:t.heading,roleDescription:t.roleDescription,checked:t.checked,editable:t.editable,password:t.password,hintShowing:t.hintShowing,placeholder:t.placeholder,selectionStart:t.selectionStart,selectionEnd:t.selectionEnd,visibleToUser:t.visibleToUser,hittable:J(t)||void 0,depth:Ac(e.nodes,n),parentIndex:n,...Mc(t,e.hidden),...r?{systemChrome:!0}:{}}}function Dc(e,t,n,r,i){let a=cc(n,r,!e.options.raw&&kc(t),i);e.presentationNodes.push(a),e.nodes.push(e.options.raw?a.raw:Rs(a))}function Oc(e,t){let n=[],r=[...e.children];for(;r.length>0;){t.check(`work`);let e=r.pop();ie(e.windowRect)&&n.push(e.windowRect),r.push(...e.children)}return ce(n)??void 0}function kc(e){return e.scrollable===!0&&ne(e.type)}function Ac(e,t){return t===void 0?0:(e[t]?.depth??-1)+1}function jc(e,t){let n=e.interactiveDescendantMemo.get(t);if(n!==void 0)return n;for(let n of t.children)if(!e.hidden.has(n)&&n.visibleToUser!==!1&&(J(n)||jc(e,n)))return e.interactiveDescendantMemo.set(t,!0),!0;return e.interactiveDescendantMemo.set(t,!1),!1}function Mc(e,t){return Nc(e,t)?{...e.canScrollBackward?{hiddenContentAbove:!0}:{},...e.canScrollForward?{hiddenContentBelow:!0}:{}}:{}}function Nc(e,t){if(!e.scrollable||!ne(e.type)||`${e.type??``}`.toLowerCase().includes(`horizontalscrollview`))return!1;let n=Pc(e,t);return!(n&&n.horizontal>n.vertical&&n.horizontal>16)}function Pc(e,t){let n=e.children.filter(e=>!t.has(e)&&e.visibleToUser!==!1);if(!e.rect||n.length===0)return null;let r=n.map(e=>e.rect).filter(e=>e!==void 0);if(r.length===0)return null;let i=Math.min(...r.map(e=>e.x)),a=Math.max(...r.map(e=>e.x+e.width)),o=Math.min(...r.map(e=>e.y)),s=Math.max(...r.map(e=>e.y+e.height));return{horizontal:Math.max(0,a-i-e.rect.width),vertical:Math.max(0,s-o-e.rect.height)}}function Fc(e){let t=0,n=0,r=[...e.children];for(;r.length>0;){let e=r.pop();t+=1,n=Math.max(n,e.depth),r.push(...e.children)}return{rawNodeCount:t,maxDepth:n}}function Ic(){let e=[],t=()=>e.at(-1)===!0;return{open(n,r){let i=t()||It(n);return r||e.push(i),i},close(){e.pop()}}}function*Lc(e){let t=/<node\b[^>]*>|<\/node>/g,n=Ic(),r=t.exec(e);for(;r;){let i=r[0];if(i.startsWith(`</node`))n.close();else{let e=Rc(i);yield n.open(e.resourceId,i.endsWith(`/>`))?{...e,systemChrome:!0}:e}r=t.exec(e)}}function Rc(e){let t=zc(e),n=Lt(t.bounds);return{...t,...n?{rect:n}:{}}}function zc(e){let t=Bc(e),n=e=>Jc(t,e),r=e=>{let t=n(e);if(t!==null)return t===`true`},i=e=>{let t=n(e);if(t===null||t.trim()===``)return;let r=Number(t);return Number.isFinite(r)?r:void 0},a=(e,t)=>{let n=i(t);return n===void 0?{}:{[e]:n}},o=(e,t)=>{let r=Lt(n(t));return r===void 0?{}:{[e]:r}},s=(e,t)=>{let r=n(t);return r===null||r===``?{}:{[e]:r}},c=(e,t)=>{let n=r(t);return n===void 0?{}:{[e]:n}};return{text:n(`text`),desc:n(`content-desc`),resourceId:n(`resource-id`),packageName:n(`package`),className:n(`class`),bounds:n(`bounds`),clickable:r(`clickable`),enabled:r(`enabled`),focusable:r(`focusable`),focused:r(`focused`),password:r(`password`),...c(`editable`,`editable`),...a(`selectionStart`,`selection-start`),...a(`selectionEnd`,`selection-end`),...c(`hintShowing`,`hint-showing`),...s(`hint`,`hint`),...c(`visibleToUser`,`visible-to-user`),...c(`selected`,`selected`),...c(`heading`,`heading`),...s(`roleDescription`,`role-description`),...c(`checked`,`checked`),...a(`drawingOrder`,`drawing-order`),...c(`scrollable`,`scrollable`),...c(`canScrollForward`,`can-scroll-forward`),...c(`canScrollBackward`,`can-scroll-backward`),...a(`windowIndex`,`window-index`),...a(`windowType`,`window-type`),...a(`windowLayer`,`window-layer`),...c(`windowActive`,`window-active`),...c(`windowFocused`,`window-focused`),...o(`windowRect`,`window-bounds`)}}function Bc(e){let t=new Map,n=e.indexOf(` `),r=e.lastIndexOf(`>`);if(n<0||r<=n)return t;let i=n;for(;i<r;){let n=Vc(e,i,r);if(!n)break;t.set(n.name,n.value),i=n.nextCursor}return t}function Vc(e,t,n){if(t=Uc(e,t,n),t>=n||Wc(e[t]))return;let r=t;t=Hc(e,t,n);let i=e.slice(r,t);if(t=Uc(e,t,n),!i||e[t]!==`=`)return;t=Uc(e,t+1,n);let a=e[t];if(!Gc(a))return;let o=t+1,s=e.indexOf(a,o);if(!(s<0||s>=n))return{name:i,value:Rt(e.slice(o,s)),nextCursor:s+1}}function Hc(e,t,n){for(;t<n&&!qc(e[t]??``);)t+=1;return t}function Uc(e,t,n){for(;t<n&&Kc(e[t]??``);)t+=1;return t}function Wc(e){return e===`/`||e===`>`}function Gc(e){return e===`"`||e===`'`}function Kc(e){return e===` `||e===`
+`||e===`\r`||e===`	`}function qc(e){return e===`=`||e===`/`||e===`>`||Kc(e)}function Jc(e,t){return e.get(t)??null}function Yc(e){let t={type:null,label:null,value:null,identifier:null,packageName:null,clickable:!1,focusable:!1,depth:-1,children:[]},n=[t],r=/<node\b[^>]*>|<\/node>/g,i=r.exec(e);for(;i;){let t=i[0];if(t.startsWith(`</node`)){n.length>1&&n.pop(),i=r.exec(e);continue}let a=Rc(t),o=n.at(-1),s=Xc(a,o.depth+1,o);o.children.push(s),t.endsWith(`/>`)||n.push(s),i=r.exec(e)}return t}function Xc(e,t,n){let r=e.text||e.desc;return js({type:e.className,label:r,value:e.text,...e.desc&&e.desc!==r?{contentDescription:e.desc}:{},identifier:e.resourceId,packageName:e.packageName,rect:e.rect,enabled:e.enabled,focused:e.focused,selected:e.selected,heading:e.heading,roleDescription:e.roleDescription,checked:e.checked,editable:e.editable,password:e.password,hintShowing:e.hintShowing,placeholder:e.hint,selectionStart:e.selectionStart,selectionEnd:e.selectionEnd,visibleToUser:e.visibleToUser,clickable:e.clickable===!0,focusable:e.focusable===!0,scrollable:e.scrollable,canScrollForward:e.canScrollForward,canScrollBackward:e.canScrollBackward,windowIndex:e.windowIndex,windowType:e.windowType,windowLayer:e.windowLayer,windowActive:e.windowActive,windowFocused:e.windowFocused,windowRect:e.windowRect,depth:t,parentIndex:void 0,children:[]},e.drawingOrder===void 0?void 0:{parent:n,order:e.drawingOrder})}function Zc(e){let t=new Map;return e.nodes.forEach((n,r)=>{t.set(n.index,e.sourceNodes[r]?.clickable)}),{kind:`exact`,provider:`android-helper`,clickableByNodeIndex:t}}const Qc=new Set([`android`,`com.android.systemui`]);function $c(e,t,n={}){if(t.backend!==`android-helper`)return{outcome:`ok`};let r=ul(e,n.foregroundAppPackage);return nl(r,t)?el(r,t,`empty-helper-output`,`Android snapshot helper returned no accessibility nodes`):cl(r)?{outcome:`ok`}:tl(r)?{outcome:`system-surface-only`}:rl(r)?{outcome:`ok`}:il(r)?el(r,t,`content-poor-app-window`,`Android snapshot helper returned insufficient foreground app content`):al(r)||ol(r,t)?el(r,t,`content-poor-app-window`,`Android snapshot helper returned insufficient application window content`):sl(r)?el(r,t,`system-window-only`,`Android snapshot helper returned only non-application windows`):{outcome:`ok`}}function el(e,t,n,r){return{outcome:`unusable`,decision:ll(e,t,n,r)}}function tl(e){return e.windowRootCount>0&&e.applicationWindowRootCount===0&&e.activeSystemSurfaceMeaningfulNodeCount>=3}function nl(e,t){return e.nodeCount===0||t.nodeCount===0||t.rootPresent===!1}function rl(e){return il(e)&&e.inputMethodMeaningfulNodeCount>=2}function il(e){let t=e.foregroundAppMeaningfulNodeCount;return t===void 0?!1:t===0?e.applicationMeaningfulNodeCount<2:t<2&&e.meaningfulNodeCount>t}function al(e){return e.foregroundAppMeaningfulNodeCount===void 0&&e.applicationWindowRootCount>0&&e.applicationMeaningfulNodeCount<2}function ol(e,t){return e.foregroundAppMeaningfulNodeCount===void 0&&e.windowRootCount===0&&(t.windowCount??0)>1&&e.nonSystemMeaningfulNodeCount<2}function sl(e){return e.windowRootCount>0&&e.applicationWindowRootCount===0||e.windowRootCount===0&&e.nodeCount>0&&e.systemUiNodeCount===e.nodeCount}function cl(e){return e.hasAlertButtonIdentifier&&e.hasAlertContentIdentifier}function ll(e,t,n,r){return{reason:n,failureReason:r,diagnostics:wl(e,t)}}function ul(e,t){let n=dl(t);for(let t of Lc(e))fl(n,t);return yl(n)}function dl(e){return{nodeCount:0,systemUiNodeCount:0,windowRootCount:0,applicationWindowRootCount:0,activeSystemSurfaceMeaningfulNodeCount:0,meaningfulNodeCount:0,applicationMeaningfulNodeCount:0,nonSystemMeaningfulNodeCount:0,inputMethodMeaningfulNodeCount:0,hasAlertButtonIdentifier:!1,hasAlertContentIdentifier:!1,...e===void 0?{}:{foregroundAppPackage:e,foregroundAppMeaningfulNodeCount:0},windowTypes:new Set}}function fl(e,t){e.nodeCount+=1,Cl(t.packageName)&&(e.systemUiNodeCount+=1),t.visibleToUser!==!1&&pl(e,t.resourceId),ml(e,t),hl(e,t)}function pl(e,t){let n=nn(t);n===`button`&&(e.hasAlertButtonIdentifier=!0),n===`content`&&(e.hasAlertContentIdentifier=!0)}function ml(e,t){t.windowType!==void 0&&(e.currentWindowType=t.windowType,e.currentWindowActiveOrFocused=t.windowActive===!0||t.windowFocused===!0,e.windowRootCount+=1,e.windowTypes.add(t.windowType),t.windowType===1&&(e.applicationWindowRootCount+=1))}function hl(e,t){bl(t)&&(e.meaningfulNodeCount+=1,gl(e,t),vl(e,t))}function gl(e,t){e.currentWindowType===1&&!Sl(t.packageName)&&(e.applicationMeaningfulNodeCount+=1),_l(e)&&!Ft(t)&&(e.activeSystemSurfaceMeaningfulNodeCount+=1)}function _l(e){return e.currentWindowType!==void 0&&e.currentWindowType!==1&&e.currentWindowActiveOrFocused===!0}function vl(e,t){Sl(t.packageName)||(e.nonSystemMeaningfulNodeCount+=1),m({packageName:t.packageName,resourceId:t.resourceId})&&(e.inputMethodMeaningfulNodeCount+=1),e.foregroundAppPackage!==void 0&&t.packageName===e.foregroundAppPackage&&(e.foregroundAppMeaningfulNodeCount=(e.foregroundAppMeaningfulNodeCount??0)+1)}function yl(e){return{nodeCount:e.nodeCount,systemUiNodeCount:e.systemUiNodeCount,windowRootCount:e.windowRootCount,applicationWindowRootCount:e.applicationWindowRootCount,activeSystemSurfaceMeaningfulNodeCount:e.activeSystemSurfaceMeaningfulNodeCount,meaningfulNodeCount:e.meaningfulNodeCount,applicationMeaningfulNodeCount:e.applicationMeaningfulNodeCount,nonSystemMeaningfulNodeCount:e.nonSystemMeaningfulNodeCount,inputMethodMeaningfulNodeCount:e.inputMethodMeaningfulNodeCount,hasAlertButtonIdentifier:e.hasAlertButtonIdentifier,hasAlertContentIdentifier:e.hasAlertContentIdentifier,...e.foregroundAppPackage===void 0?{}:{foregroundAppPackage:e.foregroundAppPackage,foregroundAppMeaningfulNodeCount:e.foregroundAppMeaningfulNodeCount??0},windowTypes:[...e.windowTypes].sort((e,t)=>e-t).slice(0,8)}}function bl(e){return e.visibleToUser===!1?!1:xl(e.text)||xl(e.desc)||xl(e.resourceId)}function xl(e){return e!==null&&e.trim()!==``}function Sl(e){return e===null||Qc.has(e)}function Cl(e){return e!==null&&Qc.has(e)}function wl(e,t){return{helperNodeCount:e.nodeCount,helperSystemUiNodeCount:e.systemUiNodeCount,helperWindowRootCount:e.windowRootCount,helperApplicationWindowRootCount:e.applicationWindowRootCount,helperMeaningfulNodeCount:e.meaningfulNodeCount,helperApplicationMeaningfulNodeCount:e.applicationMeaningfulNodeCount,helperNonSystemMeaningfulNodeCount:e.nonSystemMeaningfulNodeCount,helperInputMethodMeaningfulNodeCount:e.inputMethodMeaningfulNodeCount,...e.foregroundAppPackage===void 0?{}:{helperForegroundAppPackage:e.foregroundAppPackage,helperForegroundAppMeaningfulNodeCount:e.foregroundAppMeaningfulNodeCount,helperForegroundAppMeaningfulNodeThreshold:2},helperWindowTypes:e.windowTypes,...t.captureMode?{helperCaptureMode:t.captureMode}:{}}}async function Tl(e){let t=await B(e.deviceKey,{resetRuntime:!0,signal:e.signal,cause:e.cause});e.signal?.throwIfAborted(),t||await El(e.adb,e.packageName)}async function El(e,t){await li({adb:e,packageName:t}),await _(150),g({level:`debug`,phase:`android_snapshot_helper_runtime_reset`,data:{packageName:t}})}const Dl=Symbol(`androidSnapshotCaptureEvidence`);function Ol(e,t){return Object.defineProperty(e,Dl,{value:t}),e}function kl(e){let t={...e,backend:`android`,producer:`android-uiautomator`},n=e[Dl];return te(t,n.clickability),n.occlusionContext&&u(t,n.occlusionContext),t}async function Al(e,t={}){let n=w(e,t.helperAdb).exec;return(await Rl(e,t,n)).xml}async function jl(e,t={}){let n=w(e,t.helperAdb).exec,r=await Rl(e,t,n),i=r.xml,a=Yc(i),o=Pl(r.metadata,a),s={...t,androidPresentation:{...t.androidPresentation,deadlineAtMs:t.androidPresentation?.deadlineAtMs??Date.now()+250}};try{let e=_c(a,void 0,s),n=Nl(e.truncated,r.metadata);t.interactiveOnly&&t.includeHiddenContentHints!==!1&&Ll({options:s,tree:a,xml:i,interactiveSnapshot:e});let{sourceNodes:c,occlusionContext:l,...u}=e;return Ol({...u,...Il(n),androidSnapshot:o,quality:{state:`healthy`,backend:`android-helper`}},{clickability:Zc(e),occlusionContext:l})}catch(e){if(!uc(e))throw e;return Ml({failure:e,androidSnapshot:o})}}function Ml(e){return Ol({nodes:[],truncated:!0,analysis:e.failure.analysis??{rawNodeCount:0,maxDepth:0},androidSnapshot:{...e.androidSnapshot,presentationFailure:{phase:e.failure.details.phase,workUnits:e.failure.details.workUnits,...e.failure.details.maxWorkUnits===void 0?{}:{maxWorkUnits:e.failure.details.maxWorkUnits}}},quality:{state:`sparse`,backend:`android-helper`,reason:e.failure.message,reasonCode:e.failure.qualityReasonCode}},{clickability:{kind:`exact`,provider:`android-helper`,clickableByNodeIndex:new Map}})}function Nl(e,t){return e===!0||t.helperTruncated===!0||e}function Pl(e,t){return Fl(t)===!1?{...e,occlusionScanUnavailable:!0}:e}function Fl(e){let t=[...e.children];if(t.length!==0){for(;t.length>0;){let e=t.pop();if(Ms(e)!==void 0)return!0;t.push(...e.children)}return!1}}function Il(e){return e===!0?{truncated:!0}:{}}function Ll(e){if(au(e.interactiveSnapshot.nodes).size>0||iu(e.xml))return;let t=_c(e.tree,void 0,{...e.options,interactiveOnly:!1});ou(Se(a(t.nodes)),t,e.interactiveSnapshot)}async function Rl(e,t,n){let r=w(e,t.helperAdb),i=await h(`android_snapshot_helper_artifact_resolution`,async()=>await nu(t.helperArtifact??r.snapshotHelperArtifact));if(i.artifact)return await zl(e,t,n,i.artifact);throw g({level:`error`,phase:`android_snapshot_helper_unavailable`,data:{reason:i.errorReason??`artifact_not_found`}}),ru(i.errorReason)}async function zl(e,t,n,r){let i=Yr(e),a=w(e,t.helperAdb),o=Bl(t,i);try{let e;for(let o=0;;o+=1){o>0&&await Kl(t.signal);let s=await Gl({options:t,adb:n,adbProvider:a,artifact:r,helperDeviceKey:i,attempt:o,previousContentReason:e});if(s.outcome===`captured`)return s.capture;if(o+1>=3||t.transient!==void 0&&Date.now()>=t.transient.settleBy)return await ql({contentRecovery:s.decision,attempts:o+1,helperDeviceKey:i,artifact:r,adb:n,signal:t.signal,retireHelper:t.transient===void 0});e=s.decision.reason}}finally{o&&await B(i)}}function Bl(e,t){return e.transient?Li(t)===void 0:e.helperSessionScope!==`daemon-session`}function Vl(e){return e.transient?`current-only`:e.helperInstallPolicy??`missing-or-outdated`}async function Hl(e,t,n,r,i){let a=await h(`android_snapshot_helper_install`,async()=>await dr({adb:t,adbProvider:n,artifact:r,deviceKey:i,installPolicy:Vl(e),timeoutMs:3e4,signal:e.signal}),{packageName:r.manifest.packageName,versionCode:r.manifest.versionCode,installPolicy:Vl(e)});return g({phase:`android_snapshot_helper_install_decision`,data:{packageName:a.packageName,versionCode:a.versionCode,installedVersionCode:a.installedVersionCode,artifactSha256:r.manifest.sha256,installedSha256:a.installedSha256,installed:a.installed,reason:a.reason}}),a}async function Ul(e){let{signal:t,adb:r,adbProvider:i,artifact:a,helperDeviceKey:o}=e,s=fi({adb:r,adbProvider:i,artifact:a,deviceKey:o,signal:t});try{let e=await h(`android_snapshot_helper_session_capture`,async()=>await Qi(s),{packageName:a.manifest.packageName,version:a.manifest.version,timeoutMs:Yn});if(e)return e}catch(e){if(t?.throwIfAborted(),$r(e))throw e;g({level:`warn`,phase:`android_snapshot_helper_session_fallback`,data:{reason:n(e).message}}),await El(r,a.manifest.packageName)}return await h(`android_snapshot_helper_capture`,async()=>await di(s),{packageName:a.manifest.packageName,version:a.manifest.version,timeoutMs:Yn,commandTimeoutMs:Xn})}function Wl(e,t,n){return{xml:e.xml,metadata:{backend:`android-helper`,pixelDensity:e.metadata.pixelDensity,helperVersion:t.manifest.version,helperApiVersion:e.metadata.helperApiVersion,helperTransport:e.metadata.transport,helperSessionReused:e.metadata.sessionReused,installReason:n,waitForIdleTimeoutMs:e.metadata.waitForIdleTimeoutMs,waitForIdleQuietMs:e.metadata.waitForIdleQuietMs,timeoutMs:e.metadata.timeoutMs,maxDepth:e.metadata.maxDepth,maxNodes:e.metadata.maxNodes,rootPresent:e.metadata.rootPresent,captureMode:e.metadata.captureMode,windowCount:e.metadata.windowCount,nodeCount:e.metadata.nodeCount,helperTruncated:e.metadata.truncated,elapsedMs:e.metadata.elapsedMs}}}async function Gl(e){let{options:t,adb:n,adbProvider:r,artifact:i,helperDeviceKey:a,attempt:o}=e,s;try{let e=await Hl(t,n,r,i,a);e.installed&&await B(a),s=Wl(await Ul({signal:t.signal,adb:n,adbProvider:r,artifact:i,helperDeviceKey:a}),i,e.reason)}catch(e){if(t.signal?.throwIfAborted(),or(e))throw e;return{outcome:`captured`,capture:await Yl({error:e,helperDeviceKey:a,artifact:i,adb:n})}}let c=$c(s.xml,s.metadata,{foregroundAppPackage:t.appBundleId});if(c.outcome===`unusable`)return{outcome:`unusable`,decision:c.decision};let l=c.outcome===`system-surface-only`;return!l&&o>0&&g({phase:`android_snapshot_helper_content_recaptured`,data:{attempts:o+1,recoveredFromReason:e.previousContentReason}}),{outcome:`captured`,capture:{xml:s.xml,metadata:l?{...s.metadata,systemSurfaceOnly:!0}:s.metadata}}}async function Kl(e){e?.throwIfAborted(),await _(250),e?.throwIfAborted()}async function ql(e){throw g({level:`error`,phase:`android_snapshot_helper_content_invalid`,data:{reason:e.contentRecovery.reason,failureReason:e.contentRecovery.failureReason,attempts:e.attempts,...e.contentRecovery.diagnostics}}),e.retireHelper&&await Tl({adb:e.adb,deviceKey:e.helperDeviceKey,packageName:e.artifact.manifest.packageName,signal:e.signal,cause:e.contentRecovery.failureReason}),Jl(e.contentRecovery,e.attempts)}function Jl(e,n){return new t(`COMMAND_FAILED`,e.failureReason,{...e.diagnostics,androidSnapshotHelperFailureReason:e.reason,attempts:n,retriable:!0,hint:`Retry after the app UI stabilizes. If this persists, capture a screenshot and report the helper diagnostics; agent-device does not substitute a second snapshot engine.`})}async function Yl(e){let t=Xl(e.error);throw g({level:`error`,phase:`android_snapshot_helper_failed`,data:{reason:t}}),await B(e.helperDeviceKey),await El(e.adb,e.artifact.manifest.packageName),ir({deviceKey:e.helperDeviceKey,packageName:e.artifact.manifest.packageName,versionCode:e.artifact.manifest.versionCode}),Zl(e.error,t)}function Xl(e){let t=n(e),r=tu(t.details?.helper);if(r&&r!==t.message)return`${t.message}: ${r}`;if(r)return r;let i=(typeof t.details?.stderr==`string`?t.details.stderr.trim():``).split(/\r?\n/).find(e=>e.trim());return i?`${t.message}: ${i}`:t.message}function Zl(e,r){let i=n(e),a=Ql(i);return new t(s(i.code),`Android snapshot helper failed: ${r}`,{...i.details,...eu(i),androidSnapshotHelperFailureReason:r,...a?{androidCaptureFailureReason:a}:{},hint:$l(i,a)},e)}function Ql(e){return ct(e)}function $l(e,t){return t===`accessibility-timeout`?`Android accessibility snapshots can be blocked by busy or continuously changing app UI. Use screenshot as visual truth after this timeout and report the busy UI if it persists.`:e.details?.androidSnapshotHelperInstallFailure===!0?[e.hint,`This is a device-side install failure (adb rejection or OEM policy) — the helper artifact itself is present, this is not a missing/unbuilt build.`].filter(Boolean).join(` `):e.hint??`Retry once. If the helper still fails, run agent-device doctor and report the diagnostic log; agent-device does not substitute a second snapshot engine.`}function eu(e){let t={};return e.diagnosticId!==void 0&&(t.diagnosticId=e.diagnosticId),e.logPath!==void 0&&(t.logPath=e.logPath),e.retriable!==void 0&&(t.retriable=e.retriable),e.supportedOn!==void 0&&(t.supportedOn=e.supportedOn),t}function tu(e){if(!e||typeof e!=`object`||!(`message`in e))return;let t=String(e.message).trim();return t&&t!==`null`?t:void 0}async function nu(e){if(e)return{artifact:e};let t=je(),r=D.join(Me(),`android`,`snapshot-helper`,`dist`),i=D.join(r,`agent-device-android-snapshot-helper-${t}.manifest.json`);try{await S().files.access(i)}catch{return{}}try{let e=Zn(JSON.parse(await S().files.readText(i))),t=D.join(r,e.assetName??`agent-device-android-snapshot-helper-${e.version}.apk`);return await S().files.access(t),{artifact:{apkPath:t,manifest:e}}}catch(e){return{errorReason:n(e).message}}}function ru(e){let n=e??`the bundled helper artifact was not found`;return new t(`COMMAND_FAILED`,`Android snapshot helper is unavailable: ${n}`,{androidSnapshotHelperFailureReason:n,hint:"Run `pnpm build:android` to build the helper dist for a source checkout — the runtime needs android/snapshot-helper/dist/agent-device-android-snapshot-helper-<version>.manifest.json and the .apk it references. Packaged installs ship these via the prepack script; if they are missing from a packaged install, reinstall agent-device."})}function iu(e){return e.includes(` can-scroll-forward=`)||e.includes(` can-scroll-backward=`)}function au(e){let t=new Map;for(let n of e){let e={};n.hiddenContentAbove&&(e.hiddenContentAbove=!0),n.hiddenContentBelow&&(e.hiddenContentBelow=!0),(e.hiddenContentAbove||e.hiddenContentBelow)&&t.set(n.index,e)}return t}function ou(e,t,n){if(e.size===0)return;let r=new Map;for(let[e,t]of n.sourceNodes.entries()){let i=n.nodes[e];i&&r.set(t,i)}for(let[n,i]of e){let e=t.sourceNodes[n];if(!e)continue;let a=r.get(e);a&&(i.hiddenContentAbove&&(a.hiddenContentAbove=!0),i.hiddenContentBelow&&(a.hiddenContentBelow=!0))}}const su=Object.freeze({now:()=>Date.now(),sleep:_});async function cu(e,t,n,r,i={},a=su){let o=await Du(e),s=a.now()+1500,c=null;for(;;){let l=await _u(e,t,n,r,o,i);if(l.reason===`ime_capture`)return l;let u=s-a.now();if(l.ok&&c?.ok||u<=0)return l;c=l,await a.sleep(Math.min(150,u))}}async function lu(e,t,n,r={}){return mu(await Al(e,r),t,n)}async function uu(e,t,n,r){let i=await Du(e);return vu(await Al(e,r),t,n,i).targetInput}async function du(e,t,n,r={}){try{return await uu(e,t,n,r)}catch(e){return g({level:`warn`,phase:`android_fill_pre_action_target_capture_failed`,data:{error:e instanceof Error?e.message:String(e)}}),null}}function X(e,n,r){if(r?.ok)return;let i=r?fu(e,n,r):null;if(i)return i;throw new t(`COMMAND_FAILED`,hu(r),gu(e,r))}function fu(e,t,n){let r=n.targetInput,i=n.actualInput;if(e.length===0||n.reason===`ime_capture`||!t||!r||!i||q(t)||q(r)||q(i)||!Nu(t,r)||!Nu(t,i)||t.text===n.actual)return null;let a=Pu(t);return g({level:`warn`,phase:`android_fill_verification_unconfirmed`,data:{target:a}}),{verification:`unconfirmed`,requested:e,before:t.text,after:n.actual,target:a}}function pu(e,t,n,r,i={}){let a=vu(e,t,n,i);return yu(a)?{ok:!1,actual:a.actualInput?.text??null,reason:`ime_capture`,targetInput:a.targetInput,actualInput:a.actualInput}:bu(a,r)??xu(a,r)}function mu(e,t,n){return vu(e,t,n).targetInput?.text??null}function hu(e){return e?.reason===`ime_capture`?`Android fill input was captured by the active keyboard instead of the app field`:e?.reason===`masked_unverified`?`Android fill verification could not confirm masked text value`:`Android fill verification failed`}function gu(e,t){let n=Ts(e,t);return t?.reason===`ime_capture`&&(n.hint=`The focused input belongs to the Android keyboard/IME, not the app field. Disable handwriting/stylus input or switch to a standard IME, then retry fill.`),n}async function _u(e,t,n,r,i,a){return pu(await Al(e,a),t,n,r,i)}function vu(e,t,n,r={}){let i={focusedEdit:null,editAtPoint:null,anyAtPoint:null};for(let a of Lc(e)){let e=Eu(a,r);e&&Ou(i,e,t,n)}return Au(i)}function yu(e){let{targetInput:t,actualInput:n}=e;return!t||!n||n===t?!1:n.inputMethodOwned&&!t.inputMethodOwned}function bu(e,t){let n=e.actualInput;if(!n||!Mu(n))return null;let r=n.text??null,i=Array.from(Su(n)).length,a=Array.from(t).length,o=a===0?i===0:i>0&&i===a;return{ok:o,actual:r,reason:o?void 0:`masked_unverified`,masked:!0,targetInput:e.targetInput,actualInput:n}}function xu(e,t){let n=e.actualInput;return{ok:n!==null&&Cu(Su(n),t),actual:n?.text??null,reason:`text_mismatch`,targetInput:e.targetInput,actualInput:n}}function Su(e){return e.hintShowing?``:e.text??``}function Cu(e,t){if(e===t)return!0;if(t.length===0)return!1;let n=wu(e),r=wu(t);return!n||!r?!1:!!(n===r||Tu(n,r))}function wu(e){return e.replaceAll(/\s+/g,` `).trim()}function Tu(e,t){if(e.length!==t.length||e.length===0||e.slice(1)!==t.slice(1))return!1;let n=e[0],r=t[0];return!n||!r?!1:r.toLowerCase()===r&&n===r.toUpperCase()}function Eu(e,t){if(!e.rect)return null;let n=e.text??``,r=Math.max(1,e.rect.width*e.rect.height);return{text:n||null,className:e.className,resourceId:e.resourceId,packageName:e.packageName,rect:e.rect,focused:e.focused??!1,password:e.password===!0,inputMethodOwned:m({packageName:e.packageName,resourceId:e.resourceId,activeInputMethodPackage:t.activeInputMethodPackage}),area:r,editText:ju(e.className??``),hintShowing:e.hintShowing===!0}}async function Du(e){try{return{activeInputMethodPackage:(await ho(e)).inputMethodPackage}}catch(e){return g({level:`warn`,phase:`android_fill_verification_input_method_probe_failed`,data:{error:e instanceof Error?e.message:String(e)}}),{}}}function Ou(e,t,n,r){let i=ae(t.rect,n,r);if(i&&t.editText&&(e.editAtPoint=ku(e.editAtPoint,t)),t.focused&&t.editText){e.focusedEdit=ku(e.focusedEdit,t);return}i&&t.text&&(e.anyAtPoint=ku(e.anyAtPoint,t))}function ku(e,t){return e&&e.area<t.area?e:t}function Au(e){let t=e.editAtPoint??e.anyAtPoint;return{targetInput:t,actualInput:(e.focusedEdit?.text?e.focusedEdit:null)??t}}function ju(e){let t=e.toLowerCase();return t.includes(`edittext`)||t.includes(`textfield`)}function Mu(e){return q(e)}function Nu(e,t){return e.resourceId||t.resourceId?e.resourceId===t.resourceId&&e.packageName===t.packageName:e.className===t.className&&e.packageName===t.packageName&&e.rect.x===t.rect.x&&e.rect.y===t.rect.y&&e.rect.width===t.rect.width&&e.rect.height===t.rect.height}function Pu(e){return{resourceId:e.resourceId,className:e.className,packageName:e.packageName,rect:e.rect}}async function Fu(e,t){return await zt(t.stateDir),await rs(t.stateDir,e.id,async()=>await Lu(e,t))}function Iu(e){let t=o(e).details?.hint;return{outcome:`helper-unavailable`,reason:n(e).message,...typeof t==`string`?{hint:t}:{}}}async function Lu(e,t){let n=S().imeRecoveryMarkers,r=b(e),i=w(e),a=U(e),o;try{o=await Io(i),await Bo({adb:r,adbProvider:i,artifact:o,deviceKey:a})}catch(e){return Iu(e)}let{manifest:s}=o,c=await W(r);if(c===s.serviceComponent){let i=await n.write(t.stateDir,e.id),o=await G(r);return i&&K.add(a),{outcome:`settled`,activated:!1,alreadyActive:!0,...i?{}:{persistFailed:!0},previousIme:o,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName}}let l=await G(r);if(!await Xo(r,c))return await Qo(r,l,e.id),C({level:`warn`,phase:`android_test_ime_persist_failed`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!1,alreadyActive:!1,persistFailed:!0,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName};let u=(await n.read(t.stateDir)).includes(e.id);if(!await n.write(t.stateDir,e.id))return await Qo(r,l,e.id),C({level:`warn`,phase:`android_test_ime_marker_persist_failed`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!1,alreadyActive:!1,persistFailed:!0,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName};await x(r,[`ime`,`enable`,s.serviceComponent],{allowFailure:!0,timeoutMs:1e4});let d=await x(r,[`ime`,`set`,s.serviceComponent],{allowFailure:!0,timeoutMs:1e4}),f=await W(r);return f===s.serviceComponent?(K.add(a),C({phase:`android_test_ime_activated`,data:{device:e.id,previousIme:c}}),{outcome:`settled`,activated:!0,alreadyActive:!1,previousIme:c,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName}):(K.delete(a),await Qo(r,l,e.id),u||await n.clear(t.stateDir,e.id),C({level:`warn`,phase:`android_test_ime_activate_failed`,data:{device:e.id,activeIme:f,stderr:d.stderr.trim()}}),{outcome:`settled`,activated:!1,alreadyActive:!1,helperServiceComponent:s.serviceComponent,helperPackageName:s.packageName})}function Ru(e){return D.join(e,`android-test-ime-pending`)}function zu(e,t){return D.join(Ru(e),encodeURIComponent(t))}async function Bu(e,t){let r=S().files,i,a=!1;try{let n=Ru(e);if(i=zu(e,t),await r.ensureDirectory(n),(await Uu(i))?.serial===t)return!0;let o={version:1,serial:t};if(await r.writeAtomicText(i,`${JSON.stringify(o)}\n`,384),a=!0,(await Uu(i))?.serial!==t)throw Error(`Android test IME marker read-back did not match the requested device.`);return!0}catch(o){return a&&i&&await r.remove(i,{force:!0}).catch(()=>{}),g({level:`debug`,phase:`android_test_ime_marker_write_failed`,data:{stateDir:e,serial:t,error:n(o).message}}),!1}}async function Vu(e,t){await S().files.remove(zu(e,t),{force:!0}).catch(()=>{})}async function Hu(e){let t=S().files,n;try{n=await t.readDirectory(Ru(e))}catch{return[]}let r=[];for(let t of n)try{let n=D.join(Ru(e),t),i=await Uu(n);i&&zu(e,i.serial)===n&&r.push(i.serial)}catch{}return[...new Set(r)].sort()}async function Uu(e){try{return Wu(await S().files.readText(e))}catch{return}}function Wu(e){try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))return;let n=t;return n.version===1&&typeof n.serial==`string`&&n.serial.length>0?{version:1,serial:n.serial}:void 0}catch{return}}const Gu=new Ht(`utf-16le`);let Ku;async function qu(e,t){for(let n of[`AndroidManifest.xml`,`base/manifest/AndroidManifest.xml`]){let r=await Ju(e,n,t);if(!r)continue;let i=Yu(r);if(i)return i}return await id(e,t)}async function Ju(e,t,n){try{let r=await Te(`unzip`,[`-p`,e,t],{allowFailure:!0,binaryStdout:!0,signal:n});return r.exitCode!==0||!r.stdoutBuffer||r.stdoutBuffer.length===0?void 0:r.stdoutBuffer}catch{n?.throwIfAborted();return}}function Yu(e){return e.subarray(0,Math.min(e.length,128)).toString(`utf8`).trimStart().startsWith(`<`)?Xu(e.toString(`utf8`)):Zu(e)}function Xu(e){return e.match(/<manifest\b[^>]*\bpackage\s*=\s*["']([^"']+)["']/i)?.[1]}function Zu(e){if(e.length<8||e.readUInt16LE(0)!==3)return;let t;for(let n=e.readUInt16LE(2);n+8<=e.length;){let r=e.readUInt16LE(n),i=e.readUInt16LE(n+2),a=e.readUInt32LE(n+4);if(a<=0||n+a>e.length)return;if(r===1)t=$u(e.subarray(n,n+a));else if(r===258&&t){let r=Qu(e,n,i,t);if(r)return r}n+=a}}function Qu(e,t,n,r){if(n<36||t+n>e.length||r[e.readUInt32LE(t+20)]!==`manifest`)return;let i=e.readUInt16LE(t+24),a=e.readUInt16LE(t+26),o=e.readUInt16LE(t+28),s=t+i;for(let t=0;t<o;t+=1){let n=s+t*a;if(n+20>e.length)return;if(r[e.readUInt32LE(n+4)]!==`package`)continue;let i=e.readUInt32LE(n+8);if(i!==4294967295)return r[i];let o=e.readUInt8(n+15),c=e.readUInt32LE(n+16);return o===3?r[c]:void 0}}function $u(e){if(e.length<28)return[];let t=e.readUInt32LE(8),n=e.readUInt32LE(16),r=e.readUInt32LE(20),i=!!(n&256),a=[];for(let n=0;n<t;n+=1){let t=28+n*4;if(t+4>e.length)return a;let o=r+e.readUInt32LE(t);a.push(i?ed(e,o):td(e,o))}return a}function ed(e,t){let[,n]=nd(e,t),[r,i]=nd(e,t+n),a=t+n+i;return e.subarray(a,a+r).toString(`utf8`)}function td(e,t){let[n,r]=rd(e,t),i=t+r;return Gu.decode(e.subarray(i,i+n*2))}function nd(e,t){let n=e.readUInt8(t);if(!(n&128))return[n,1];let r=e.readUInt8(t+1);return[(n&127)<<8|r,2]}function rd(e,t){let n=e.readUInt16LE(t);if(!(n&32768))return[n,2];let r=e.readUInt16LE(t+2);return[(n&32767)<<16|r,4]}async function id(e,t){t?.throwIfAborted();let n=await ad();if(!n)return;let r=await Te(n,[`dump`,`badging`,e],{allowFailure:!0,signal:t});if(r.exitCode===0)return r.stdout.match(/package:\s+name='([^']+)'/)?.[1]}async function ad(){if(Ku!==void 0)return Ku??void 0;try{let e=S().files;for(let t of _t()){let n=D.join(t,`build-tools`);try{let t=(await e.readDirectory(n)).sort((e,t)=>t.localeCompare(e,void 0,{numeric:!0}));for(let r of t){let t=D.join(n,r,`aapt`);if(D.isAbsolute(t)&&await e.isExecutable(t))return Ku=t,t}}catch{}}}catch{}Ku=null}async function od(e,t){let n=e.kind===`url`&&Ne(e.url),r=await Pe({source:e,isInstallablePath:(e,t)=>t.isFile()&&sd(e),installableLabel:`Android installable (.apk or .aab)`,allowArchiveExtraction:e.kind!==`url`||n,signal:t?.signal});try{let e=t?.resolveIdentity===!1?{}:await cd(r.installablePath,t?.signal);return{archivePath:r.archivePath,installablePath:r.installablePath,packageName:e.packageName,cleanup:r.cleanup}}catch(e){throw await r.cleanup(),e}}function sd(e){let t=D.extname(e).toLowerCase();return t===`.apk`||t===`.aab`}async function cd(e,t){let n=D.extname(e).toLowerCase();return n!==`.apk`&&n!==`.aab`?{}:{packageName:await qu(e,t)}}async function ld(e,n,r,i={}){let a=typeof r.action==`string`&&r.action.trim()?r.action.trim():`${n}.TEST_PUSH`,o=[`am`,`broadcast`,`-a`,a,`-p`,n],s=typeof r.receiver==`string`?r.receiver.trim():``;s&&o.push(`-n`,s);let c=r.extras;if(c!==void 0&&(typeof c!=`object`||!c||Array.isArray(c)))throw new t(`INVALID_ARGS`,`Android push payload extras must be an object`);let l=c??{},u=0;for(let[e,t]of Object.entries(l))e&&(ud(o,e,t),u+=1);return await E(e,o,{signal:i.signal}),{action:a,extrasCount:u}}function ud(e,n,r){if(typeof r==`string`){e.push(`--es`,n,r);return}if(typeof r==`boolean`){e.push(`--ez`,n,r?`true`:`false`);return}if(typeof r==`number`&&Number.isFinite(r)){if(Number.isInteger(r)){e.push(`--ei`,n,String(r));return}e.push(`--ef`,n,String(r));return}throw new t(`INVALID_ARGS`,`Unsupported Android broadcast extra type for "${n}". Use string, boolean, or number.`)}function Z(e){let t=e.replaceAll(`,`,``).match(/^-?\d+(?:\.\d+)?/);if(!t)return null;let n=Number(t[0]);return Number.isFinite(n)?n:null}function dd(e){let t=gd(e.map(e=>e.intendedVsyncNs)),n=[];for(let e=1;e<t.length;e+=1){let r=t[e]-t[e-1];r>=4e6&&r<=5e7&&n.push(r)}if(n.length!==0)return _d(n)}function fd(e){let{frames:t,frameDeadlineNs:n,summaryDroppedFrameCount:r}=e;return r===void 0?n===void 0?[]:t.filter(e=>e.durationNs>n):r<=0?[]:[...t].sort((e,t)=>t.durationNs-e.durationNs).slice(0,r).sort((e,t)=>e.intendedVsyncNs-t.intendedVsyncNs)}function pd(e){let{frames:t,windowStartNs:n,measuredAtMs:r,uptimeMs:i}=e;if(t.length===0||n===void 0)return[];let a=[],o=[];for(let e of t){let t=o.at(-1);if(!t||e.intendedVsyncNs-t.frameCompletedNs<=5e8){o.push(e);continue}a.push(o),o=[e]}return o.length>0&&a.push(o),a.map(e=>hd({frames:e,windowStartNs:n,measuredAtMs:r,uptimeMs:i})).sort((e,t)=>t.missedDeadlineFrameCount-e.missedDeadlineFrameCount||t.worstFrameMs-e.worstFrameMs).slice(0,3).sort((e,t)=>e.startOffsetMs-t.startOffsetMs)}function md(e){return Math.round(e*10)/10}function hd(e){let{frames:t,windowStartNs:n,measuredAtMs:r,uptimeMs:i}=e,a=Math.min(...t.map(e=>e.intendedVsyncNs)),o=Math.max(...t.map(e=>e.frameCompletedNs)),s=Math.max(0,Math.round((a-n)/1e6)),c=Math.max(s,Math.round((o-n)/1e6)),l=i!==void 0&&Number.isFinite(r)?r-i:void 0;return{startOffsetMs:s,endOffsetMs:c,startAt:l===void 0?void 0:new Date(l+a/1e6).toISOString(),endAt:l===void 0?void 0:new Date(l+o/1e6).toISOString(),missedDeadlineFrameCount:t.length,worstFrameMs:md(Math.max(...t.map(e=>e.durationNs))/1e6)}}function gd(e){return[...new Set(e.filter(e=>Number.isFinite(e)))].sort((e,t)=>e-t)}function _d(e){let t=[...e].sort((e,t)=>e-t),n=Math.floor(t.length/2);return t.length%2==1?t[n]:(t[n-1]+t[n])/2}function vd(e,t,n){yd(e,t);let r=kd(e),i=Td(e),a=xd(i,r,t),o=Date.parse(n),s=jd({frames:i,measuredAtMs:o,summary:r}),c=fd({frames:i,frameDeadlineNs:a,summaryDroppedFrameCount:r?.droppedFrameCount}),l=r?.sampleWindowMs??s.sampleWindowMs??Fd(i),u=Sd(r,i,c),d=wd({droppedFrames:c,timing:s,measuredAtMs:o,summary:r});return{...u,sampleWindowMs:l,...Cd(a),windowStartedAt:s.windowStartedAt,windowEndedAt:s.windowEndedAt,timestampSource:s.timestampSource,measuredAt:n,method:`adb-shell-dumpsys-gfxinfo-framestats`,source:r?`android-gfxinfo-summary`:`framestats-rows`,worstWindows:d&&d.length>0?d:void 0}}function yd(e,n){if(/no process found for:/i.test(e))throw new t(`COMMAND_FAILED`,`Android gfxinfo did not find a running process for ${n}`,{metric:`fps`,package:n,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf after the interaction you want to inspect.`})}function bd(e){throw new t(`COMMAND_FAILED`,`Failed to parse Android framestats output for ${e}`,{metric:`fps`,package:e,hint:`Retry perf after exercising the app screen. If the problem persists, capture adb shell dumpsys gfxinfo <package> framestats output for debugging.`})}function xd(e,n,r){let i=dd(e);if(!n&&e.length===0&&bd(r),n||i!==void 0)return i;throw new t(`COMMAND_FAILED`,`Failed to infer Android frame deadline from framestats output for ${r}`,{metric:`fps`,package:r,hint:`Retry perf after a longer interaction window so consecutive Android frame timestamps are available.`})}function Sd(e,t,n){let r=e?.totalFrameCount??t.length,i=e?.droppedFrameCount??n.length;return{totalFrameCount:r,droppedFrameCount:i,droppedFramePercent:e?.droppedFramePercent??(r>0?Bt(i/r*100):0)}}function Cd(e){return{frameDeadlineMs:e===void 0?void 0:md(e/1e6),refreshRateHz:e===void 0?void 0:md(1e9/e)}}function wd(e){let{droppedFrames:t,timing:n,measuredAtMs:r,summary:i}=e;if(t.length===0)return;let a=pd({frames:t,windowStartNs:n.windowStartNs,measuredAtMs:r,uptimeMs:i?.uptimeMs});return a.length>0?a:void 0}function Td(e){let t=[],n=null;for(let r of e.split(`
+`)){let e=r.trim();if(e.length===0||e===`---PROFILEDATA---`)continue;let i=e.split(`,`).map(e=>e.trim());if(Ed(i)){n=new Map(i.map((e,t)=>[e,t]));continue}let a=Dd(i,n);a&&t.push(a)}return t.sort((e,t)=>e.intendedVsyncNs-t.intendedVsyncNs)}function Ed(e){return e.includes(`IntendedVsync`)&&e.includes(`FrameCompleted`)}function Dd(e,t){if(!t||e.length<t.size)return;let n=Od(e,t,`Flags`),r=Od(e,t,`IntendedVsync`),i=Od(e,t,`FrameCompleted`);if(!(n!==0||r===null||i===null||r<=0||i<=r))return{intendedVsyncNs:r,frameCompletedNs:i,durationNs:i-r}}function Od(e,t,n){let r=t.get(n);if(r===void 0)return null;let i=Number(e[r]);return Number.isFinite(i)?i:null}function kd(e){let t=e.split(/\nProfile data in ms:\n/i)[0]??``,n=Id(t,`Total frames rendered`),r=t.match(/^\s*Janky frames:\s*([0-9][0-9,]*)\s*\(([0-9.]+)%\)/im);if(n===void 0||!r)return;let i=r[1],a=r[2];if(i===void 0||a===void 0)return;let o=Z(i)??void 0,s=Number(a);if(o===void 0||!Number.isFinite(s)||n<0)return;let c=Id(t,`Uptime`),l=Id(t,`Stats since`);return{droppedFramePercent:Bt(s),droppedFrameCount:o,totalFrameCount:n,sampleWindowMs:Ad({uptimeMs:c,statsSinceNs:l}),uptimeMs:c,statsSinceNs:l}}function Ad(e){let{uptimeMs:t,statsSinceNs:n}=e;if(t===void 0||n===void 0)return;let r=t-Math.round(n/1e6);return r>=0?r:void 0}function jd(e){let{frames:t,measuredAtMs:n,summary:r}=e,i=Md(t),a=r?.statsSinceNs,o=a??i.firstFrameNs,s=Nd(o,i.lastFrameNs),c=r?.sampleWindowMs??s;if(!Number.isFinite(n)||r?.uptimeMs===void 0||o===void 0)return{sampleWindowMs:c,windowStartNs:o};let l=n-r.uptimeMs;return{sampleWindowMs:c,windowStartNs:o,windowStartedAt:new Date(l+o/1e6).toISOString(),windowEndedAt:Pd({deviceBootWallClockMs:l,measuredAtMs:n,summaryStartNs:a,lastFrameNs:i.lastFrameNs}),timestampSource:`estimated-from-device-uptime`}}function Md(e){return e.length===0?{}:{firstFrameNs:Math.min(...e.map(e=>e.intendedVsyncNs)),lastFrameNs:Math.max(...e.map(e=>e.frameCompletedNs))}}function Nd(e,t){if(e!==void 0&&t!==void 0)return Math.max(0,Math.round((t-e)/1e6))}function Pd(e){let{deviceBootWallClockMs:t,measuredAtMs:n,summaryStartNs:r,lastFrameNs:i}=e;return r===void 0?i===void 0?void 0:new Date(t+i/1e6).toISOString():new Date(n).toISOString()}function Fd(e){if(e.length===0)return;let t=Md(e);return Nd(t.firstFrameNs,t.lastFrameNs)}function Id(e,t){let n=t.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`),r=e.match(RegExp(`^\\s*${n}:\\s*([0-9][0-9,]*)`,`im`));if(!r)return;let i=r[1];return i===void 0?void 0:Z(i)??void 0}async function Ld(e,t,n={}){let r=b(e,n.adb);try{let i=vd((await x(r,[`dumpsys`,`gfxinfo`,t,`framestats`],{timeoutMs:15e3})).stdout,t,new Date().toISOString());return await Rd(e,t,n),i}catch(e){throw zd(t,e)}}async function Rd(e,t,n={}){let r=b(e,n.adb);try{await x(r,[`dumpsys`,`gfxinfo`,t,`reset`],{allowFailure:!0,timeoutMs:3e3})}catch{}}function zd(e,n){return n instanceof t?new t(n.code,n.message,{...n.details??{},metric:`fps`,package:e},n):new t(`COMMAND_FAILED`,`Failed to sample Android fps for ${e}`,{metric:`fps`,package:e},n)}async function Bd(e,t,n,r,i){return{capture:{durationMs:r,packageName:t.packageName,appPid:t.appPid,artifactPath:t.outPath,sizeBytes:n},frameHealth:t.kind===`perfetto`?await Vd(e,t.packageName,i):void 0,notes:[t.kind===`perfetto`?`Frame health is sampled from Android gfxinfo around the trace window; open the Perfetto artifact for timeline root cause.`:`Open the Simpleperf report artifact for symbol-level CPU attribution.`]}}async function Vd(e,t,n){try{let r=await Ld(e,t,n);return{available:!0,droppedFramePercent:r.droppedFramePercent,droppedFrameCount:r.droppedFrameCount,totalFrameCount:r.totalFrameCount,method:r.method,worstWindows:r.worstWindows?.slice(0,3).map(e=>({startOffsetMs:e.startOffsetMs,endOffsetMs:e.endOffsetMs,missedDeadlineFrameCount:e.missedDeadlineFrameCount,worstFrameMs:e.worstFrameMs}))}}catch(e){return{available:!1,reason:e instanceof Error?e.message:`Android frame health was not available`}}}async function Hd(e,t,n){let r=b(e,n.adb);await Jd(r,t),await Zd(r,t),await Xd(r,t,n.files);let i=await qd(t.outPath,n.files);await Gd(r,t.remotePath);let a=Date.now(),o=Math.max(0,a-t.startedAt),s=await Bd(e,t,i,o,{adb:r});return{...t,action:`stop`,platform:`android`,state:`stopped`,stoppedAt:a,durationMs:o,sizeBytes:i,method:t.kind===`simpleperf`?Br:Vr,artifact:{path:t.outPath,sizeBytes:i},summary:s,message:`Stopped Android ${t.kind} ${t.type} for ${t.packageName}`}}async function Ud(e,t,n={}){let r=b(e,n.adb);try{t.state===`running`&&(await Jd(r,t),await Zd(r,t).catch(()=>{}))}finally{await Gd(r,t.remotePath)}}function Wd(e,t,n=Ur){return`${n}/agent-device-${e.replaceAll(/[^A-Za-z0-9_.-]/g,`_`)}-${Date.now()}-${t}`}async function Gd(e,t){try{await x(e,[`rm`,`-f`,t],{allowFailure:!0,timeoutMs:Hr})}catch{}}async function Kd(e,t,n=S().files){await n.ensureDirectory(D.dirname(e)),await n.writeBytes(e,Buffer.from(`${JSON.stringify(t,null,2)}\n`))}async function qd(e,n=S().files){try{return(await n.stat(e)).size}catch(n){throw new t(`COMMAND_FAILED`,`Profiler artifact was not written: ${e}`,{outPath:e,hint:`Retry the profiling command and check daemon logs if the artifact path is still missing.`},n)}}async function Jd(e,t){try{await x(e,[v(Yd(t.profilerPid))],{timeoutMs:P})}catch(e){throw N(`stop`,t.kind,t.packageName,e)}}function Yd(e){return[`pid=${y(e)}`,`kill -INT "$pid" 2>/dev/null || true`,`for i in 1 2 3 4 5 6 7 8 9 10; do kill -0 "$pid" 2>/dev/null || exit 0; sleep 0.2; done`,`kill -TERM "$pid" 2>/dev/null || true`,`for i in 1 2 3 4 5 6 7 8 9 10; do kill -0 "$pid" 2>/dev/null || exit 0; sleep 0.2; done`,`echo "profiler process did not stop after SIGTERM" >&2`,`exit 1`].join(`; `)}async function Xd(e,n,r){await(r??S().files).ensureDirectory(D.dirname(n.outPath));try{await e([`pull`,n.remotePath,n.outPath],{timeoutMs:P})}catch(e){throw new t(`COMMAND_FAILED`,`Failed to pull Android ${n.kind} artifact for ${n.packageName}`,{package:n.packageName,tool:n.kind,remotePath:n.remotePath,outPath:n.outPath,hint:`Check that the profiling command ran long enough to create an artifact, then retry stop with the same session.`},e)}}async function Zd(e,n){let r;for(let t=0;t<12;t+=1){let t=await Qd(e,n.remotePath);if(t!==void 0&&t>0&&t===r)return;r=t,await _(250)}throw new t(`COMMAND_FAILED`,`Android ${n.kind} artifact is not ready to pull`,{package:n.packageName,tool:n.kind,remotePath:n.remotePath,hint:`The profiler stopped, but the remote artifact was missing, empty, or still changing. Retry stop with the same session or inspect the device-side artifact.`})}async function Qd(e,t){let n=y(t),r=await x(e,[v(`if [ -f ${n} ]; then stat -c %s ${n} 2>/dev/null || wc -c < ${n}; fi`)],{allowFailure:!0,timeoutMs:Hr});if(r.exitCode!==0)return;let i=Number(r.stdout.trim().split(/\s+/)[0]);return Number.isFinite(i)?i:void 0}async function $d(e,t,n,r={}){let i=b(e,r.adb),a=await Wr(i,t);await Gr(i,`perfetto`,t);let o=Wd(t,`app.perfetto-trace`,`/data/misc/perfetto-traces`),s;try{await Rd(e,t,{adb:i}),s=await tf(i,o,t)}catch(e){throw await Gd(i,o),e}return{type:`trace`,kind:`perfetto`,packageName:t,appPid:a,profilerPid:s,remotePath:o,outPath:n,startedAt:Date.now(),state:`running`,action:`start`,platform:`android`,method:Vr,message:`Started Android Perfetto trace for ${t}`}}async function ef(e,t,n,r={}){return await Hd(e,{...t,outPath:n},r)}async function tf(e,n,r){try{let i=Kr((await x(e,[`perfetto`,`--background-wait`,`-o`,n,`-t`,`3600s`,`sched`,`freq`,`idle`,`am`,`wm`,`gfx`,`view`,`binder_driver`,`hal`,`dalvik`],{timeoutMs:P})).stdout);if(i)return i;throw new t(`COMMAND_FAILED`,`Android perfetto did not return a profiler pid`,{package:r,tool:`perfetto`,hint:`Retry perf trace start. If perfetto exits immediately, verify the device permits trace capture.`})}catch(e){throw N(`start`,`perfetto`,r,e)}}function nf(e){let t=[];for(let n of c(e)){let e=n.match(/^([0-9]+(?:\.[0-9]+)?)%\s+(.+)$/);if(!e)continue;let r=Number(e[1]),i=e[2]?.trim();if(!Number.isFinite(r)||!i)continue;let a=i.split(/\s{2,}/).filter(Boolean);if(t.push({percentage:Bt(r),command:a[0],dso:a[1],symbol:a.slice(2).join(` `)||void 0}),t.length>=50)break}return t}async function rf(e,t,n,r={}){let i=b(e,r.adb),a=await Wr(i,t);await Gr(i,`simpleperf`,t);let o=Wd(t,`cpu.perf.data`),s;try{s=await sf(i,a,o,t)}catch(e){throw await Gd(i,o),e}return{type:`cpu-profile`,kind:`simpleperf`,packageName:t,appPid:a,profilerPid:s,remotePath:o,outPath:n,startedAt:Date.now(),state:`running`,action:`start`,platform:`android`,method:Br,message:`Started Android Simpleperf CPU profile for ${t}`}}async function af(e,t,n,r={}){return await Hd(e,{...t,outPath:n},r)}async function of(e,t,n,r={}){let i=b(e,r.adb);await Gr(i,`simpleperf`,t.packageName);let a=await uf(i,t),o=new Date().toISOString(),s=nf(a.stdout),c=s.slice(0,10).map(e=>({symbol:e.symbol??`<unknown>`,binary:e.dso,selfSamplePercent:e.percentage}));await Kd(n,{kind:`simpleperf-report`,generatedAt:o,packageName:t.packageName,appPid:t.appPid,sourceProfilePath:t.outPath,sourceRemotePath:t.remotePath,entryCount:s.length,summary:{topFunctions:c},entries:s},r.files);let l=await qd(n,r.files);return{action:`report`,platform:`android`,type:`cpu-profile-report`,kind:`simpleperf`,packageName:t.packageName,appPid:t.appPid,sourceProfilePath:t.outPath,outPath:n,sizeBytes:l,generatedAt:o,entryCount:s.length,summary:{topFunctions:c},method:Br,message:`Wrote Android Simpleperf report for ${t.packageName}`}}async function sf(e,n,r,i){try{let a=Kr((await x(e,[v(cf(n,r))],{timeoutMs:P})).stdout);if(a)return a;throw new t(`COMMAND_FAILED`,`Android simpleperf did not return a profiler pid`,{package:i,tool:`simpleperf`,hint:`Retry perf. If simpleperf exits immediately, verify the app is profileable and the device permits native profiling.`})}catch(e){throw N(`start`,`simpleperf`,i,e)}}function cf(e,t){return lf([`simpleperf`,`record`,`-e`,`cpu-clock:u`,`-p`,e,`-o`,t,`--duration`,`3600`],`simpleperf`)}function lf(e,t){let n=e.map(y).join(` `),r=`${Ur}/agent-device-${t}-${Date.now()}.err`;return[`err=${y(r)}`,`(${n}) >/dev/null 2>"$err" & pid=$!`,`sleep 1`,`if kill -0 "$pid" 2>/dev/null; then rm -f "$err"; echo "$pid"; exit 0; fi`,`cat "$err" >&2`,`rm -f "$err"`,`exit 1`].join(`; `)}async function uf(e,t){try{return await x(e,[`simpleperf`,`report`,`-i`,t.remotePath,`--stdio`,`--sort`,`comm,dso,symbol`],{timeoutMs:P})}catch(e){throw N(`report`,`simpleperf`,t.packageName,e)}}const df=15e3,ff=12e4;async function pf(e,t,n={}){let r=b(e,n.adb);try{return _f((await x(r,[`dumpsys`,`meminfo`,t],{timeoutMs:df})).stdout,t,new Date().toISOString())}catch(e){throw Tf(`memory`,t,e)}}async function mf(e,n,r,i={}){let a=b(e,i.adb),o=i.files??S().files,s=await vf(a,n),c=yf(n);await o.ensureDirectory(D.dirname(r));let l=await hf(o,r);try{we(await x(a,[`am`,`dumpheap`,n,c],{allowFailure:!0,timeoutMs:ff}),`Failed to capture Android heap dump for ${n}`,e=>({kind:`android-hprof`,package:n,pid:s,remotePath:c,hint:bf(e.stdout,e.stderr)}));let e=await a([`pull`,c,r],{allowFailure:!0,timeoutMs:ff});if(e.exitCode!==0)throw await gf(o,r,l),T(`Failed to pull Android heap dump for ${n}`,e,{kind:`android-hprof`,package:n,pid:s,remotePath:c,path:r,hint:`Verify the daemon can write the requested --out path and retry. The heap dump stays on-device only until cleanup runs.`});let i=await o.stat(r).catch(()=>null);if(!i?.isFile||i.size<=0)throw await gf(o,r,l),new t(`COMMAND_FAILED`,`Android heap dump artifact is missing or empty`,{kind:`android-hprof`,package:n,pid:s,path:r,remotePath:c,hint:`Retry with a writable --out path. If the file is still empty, inspect adb pull output with --debug.`});return{available:!0,kind:`android-hprof`,path:r,sizeBytes:i.size,measuredAt:new Date().toISOString(),method:`adb-shell-am-dumpheap`,packageName:n,pid:s,remotePath:c}}finally{await x(a,[`rm`,`-f`,c],{allowFailure:!0,timeoutMs:df}).catch(()=>{})}}async function hf(e,t){return await e.stat(t).then(e=>e.isFile).catch(()=>!1)}async function gf(e,t,n){n||await e.remove(t,{force:!0}).catch(()=>{})}function _f(e,n,r){if(/no process found for:/i.test(e))throw new t(`COMMAND_FAILED`,`Android meminfo did not find a running process for ${n}`,{metric:`memory`,package:n,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf.`});let i=Ef(e,`TOTAL PSS`)??Df(e);if(i===void 0)throw new t(`COMMAND_FAILED`,`Failed to parse Android meminfo output for ${n}`,{metric:`memory`,package:n,hint:`Retry perf after reopening the app session. If the problem persists, capture adb shell dumpsys meminfo output for debugging.`});return{totalPssKb:i,totalRssKb:Ef(e,`TOTAL RSS`),measuredAt:r,method:`adb-shell-dumpsys-meminfo`,topConsumers:xf(e)}}async function vf(e,n){let r=await x(e,[`pidof`,n],{allowFailure:!0,timeoutMs:df}),i=r.stdout.trim().split(/\s+/).map(Number).find(e=>Number.isInteger(e)&&e>0);if(r.exitCode===0&&i!==void 0)return i;throw new t(`COMMAND_FAILED`,`No running Android process found for ${n}`,{kind:`android-hprof`,package:n,stdout:r.stdout,stderr:r.stderr,hint:`Run open <app> for this session again to ensure the Android app is active, then retry perf memory snapshot.`})}function yf(e){return`/data/local/tmp/agent-device-${e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`)}-${Date.now()}.hprof`}function bf(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`profileable`)||n.includes(`debuggable`)||n.includes(`not allowed`)?`Android heap dumps require a debuggable/profileable app process on many devices. Use a debug/profileable build, reopen the app, then retry.`:n.includes(`permission`)||n.includes(`denied`)?`The device denied heap dump access. Use a debug/profileable build or a device image that permits app heap dumping.`:`Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, run with --debug and inspect adb am dumpheap output.`}function xf(e){let t=e.split(`
+`).flatMap(e=>Sf(e)??[]).sort((e,t)=>t.pssKb-e.pssKb).slice(0,5);return t.length>0?t:void 0}function Sf(e){let t=e.trim();if(Cf(t))return;let n=t.match(/^(.+?)\s+([0-9][0-9,]*(?:\(\d+\))?)(?:\s|$)/);if(n)return wf(n[1],n[2])}function Cf(e){if(!e||e.startsWith(`**`)||e.startsWith(`-`)||e.includes(`:`))return!0;let t=/^\S.+\s+\d/.test(e);return/^(pss|total|native|dalvik|unknown|app summary\b)/i.test(e)&&!t}function wf(e,t){let n=e?.trim(),r=t?Z(t):null;if(!(!n||n===`TOTAL`||r===null||r<=0)&&!/^(pss|private|shared|heap|size|alloc|free)$/i.test(n))return{name:n,pssKb:r}}function Tf(e,n,r){return r instanceof t?new t(r.code,r.message,{...r.details??{},metric:e,package:n},r):new t(`COMMAND_FAILED`,`Failed to sample Android ${e} for ${n}`,{metric:e,package:n},r)}function Ef(e,t){let n=t.replaceAll(/[.*+?^${}()|[\]\\]/g,String.raw`\$&`),r=e.match(RegExp(`${n}:\\s*([0-9][0-9,]*)`,`i`));if(!r)return;let i=r[1];return i===void 0?void 0:Z(i)??void 0}function Df(e){for(let t of e.split(`
+`)){let e=t.trim();if(!/^TOTAL\b(?!\s+PSS:)/.test(e))continue;let n=e.split(/\s+/).slice(1).find(e=>Z(e)!==null);return n?Z(n)??void 0:void 0}}async function Of(e,t,n){let r=await E(e,[`dumpsys`,`package`,t],{allowFailure:!0});return r.exitCode===0?Rf(r.stdout,n):{requested:void 0,grants:void 0}}async function kf(e){let t=await E(e,[`am`,`get-current-user`],{allowFailure:!0});if(t.exitCode!==0)return;let n=Number.parseInt(t.stdout.trim(),10);return Number.isInteger(n)&&n>=0?n:void 0}const Af=/^\s*User (\d+):/,jf=/^\s*runtime permissions:\s*$/,Mf=/^\s*([\w.]+): granted=(true|false)\b/,Nf=/^\s*Package \[.+?\]/,Pf=/^\s*requested permissions:\s*$/,Ff=/^\s*([A-Za-z][\w.]*)/;function If(e){return e.split(`
+`).filter(e=>e.trim().length>0).map(e=>({text:e,indent:e.length-e.trimStart().length}))}function Lf(e,t){let n=Q(Q(Q(If(e),e=>e.indent===0&&e.text.trim()===`Packages:`),e=>Af.exec(e.text)?.[1]===String(t)),e=>jf.test(e.text));if(!n)return;let r=new Map;for(let{text:e}of n){let t=Mf.exec(e);t&&r.set(t[1],t[2]===`true`?`granted`:`not_granted`)}return r}function Q(e,t){if(!e)return;let n=e.findIndex(e=>t(e));if(n<0)return;let r=e.slice(n+1),i=r.findIndex(t=>t.indent<=e[n].indent);return i<0?r:r.slice(0,i)}function Rf(e,t){return{requested:zf(e),grants:Lf(e,t)}}function zf(e){let t=Q(Q(Q(If(e),e=>e.indent===0&&e.text.trim()===`Packages:`),e=>Nf.test(e.text)),e=>Pf.test(e.text));if(!t)return;let n=[];for(let{text:e}of t){let t=Ff.exec(e)?.[1];t&&t.includes(`.`)&&!n.includes(t)&&n.push(t)}return n}function Bf(e,t,n){if(n!==`not_granted`)return`${n===`granted`?`${t} was granted before this revoke, and Android kills an app when a granted permission is revoked: if ${e} was running it is no longer.`:`Whether ${t} was granted before this revoke could not be read (adb did not report the acting user's runtime permission state), and Android kills an app when a granted permission is revoked: ${e} may no longer be running.`} Relaunch it with open ${e} --relaunch before the next interaction.`}const Vf=[`all`,`camera`,`microphone`,`photos`,`contacts`,`notifications`,`calendar`,`location`,`media-library`],Hf={calendar:[`android.permission.WRITE_CALENDAR`,`android.permission.READ_CALENDAR`],camera:[`android.permission.CAMERA`],contacts:[`android.permission.READ_CONTACTS`,`android.permission.WRITE_CONTACTS`],location:[`android.permission.ACCESS_FINE_LOCATION`,`android.permission.ACCESS_COARSE_LOCATION`],"media-library":[`android.permission.WRITE_EXTERNAL_STORAGE`,`android.permission.READ_EXTERNAL_STORAGE`,`android.permission.READ_MEDIA_AUDIO`,`android.permission.READ_MEDIA_IMAGES`,`android.permission.READ_MEDIA_VIDEO`],microphone:[`android.permission.RECORD_AUDIO`]};async function Uf(e){let n=await kf(e);if(n!==void 0)return n;throw new t(`COMMAND_FAILED`,`Could not determine which Android user the session runs as, so no permission was changed.`,{deviceId:e.id,hint:`Check adb -s ${e.id} shell am get-current-user — if the device is still booting, retry once it reports a user. agent-device refuses to change permissions it cannot scope, because pm would silently apply them to user 0.`})}async function Wf(e,t,n,r){let i=he(n),a=op(r?.permissionTarget,r?.permissionMode),o=await Uf(e),s=[`--user`,String(o)];if(a.kind===`all`)return await Gf(e,t,i,o,s);if(i===`grant`){await ip(e,t,a,o,s);return}if(a.kind===`pm`)return await lp(e,t,i,a,o,s);let{grants:c}=await Of(e,t,o),l=await ap(e,t,i,a,s),{priorGrantState:u,warnings:d}=dp(t,l,l.map(e=>c?.get(e)??`unknown`));return{permission:l.join(`,`),priorGrantState:u,...d.length>0?{warnings:d}:{}}}async function Gf(e,n,r,i,a){let{requested:o,grants:s}=await Of(e,n,i);if(o===void 0)throw new t(`COMMAND_FAILED`,`Could not read declared permissions for ${n}, so no permission was changed.`,{appPackage:n});let c=r===`grant`?void 0:s,l=[],u=[];for(let t of Zf(o))await Kf({device:e,appPackage:n,action:r,userArgs:a,grants:c,applied:l,warnings:u},t);return{permission:`all`,applied:l,...u.length>0?{warnings:u}:{}}}async function Kf(e,t){return t.kind===`notification`?await qf(e):t.kind===`photos`?await Jf(e):await Yf(e,t.value)}async function qf(e){let{device:t,appPackage:n,action:r,userArgs:i,grants:a,applied:o,warnings:s}=e;await pp(t,n,r,{appOps:`POST_NOTIFICATION`,permission:`android.permission.POST_NOTIFICATIONS`},i),o.push(`android.permission.POST_NOTIFICATIONS`),Qf(s,a,n,`android.permission.POST_NOTIFICATIONS`)}async function Jf(e){let{device:t,appPackage:n,action:r,userArgs:i,warnings:a}=e,o=await tp(t,n,r===`grant`?`grant`:`revoke`,i);if(o===void 0){a.push(`Skipped Android photos permission for ${n}: device refused both media candidates.`);return}await Xf(e,o)}async function Yf(e,t){let{device:n,appPackage:r,action:i,userArgs:a,warnings:o}=e,s=await $f(n,i===`grant`?`grant`:`revoke`,a,r,t);if(!s.ok){o.push(`Skipped ${t} for ${r}: ${s.reason}`);return}await Xf(e,t)}async function Xf(e,t){let{device:n,appPackage:r,action:i,userArgs:a,grants:o,applied:s,warnings:c}=e;s.push(t),i===`reset`&&await mp(n,r,t,a),i!==`grant`&&Qf(c,o,r,t)}function Zf(e){let t=[],n=!1;for(let r of e)r===`android.permission.POST_NOTIFICATIONS`?t.push({kind:`notification`}):r===`android.permission.READ_MEDIA_IMAGES`||r===`android.permission.READ_EXTERNAL_STORAGE`?n||(n=!0,t.push({kind:`photos`})):t.push({kind:`pm`,value:r});return t}function Qf(e,t,n,r){let i=Bf(n,r,t?.get(r)??`unknown`);i&&e.push(i)}async function $f(e,t,n,r,i){let a=await E(e,[`pm`,t,...n,r,i],{allowFailure:!0});if(a.exitCode===0)return{ok:!0};if(ep(a.stderr))return{ok:!1,reason:rp(a.stderr)};throw T(`Failed to ${t} Android permission ${i} for ${r}`,a,{appPackage:r,permission:i})}function ep(e){let t=e.toLowerCase();return t.includes(`not a changeable permission`)||t.includes(`has not requested permission`)||t.includes(`is not a runtime permission`)||t.includes(`unknown permission`)||t.includes(`managed by role`)}async function tp(e,t,n,r){try{return await fp(e,t,n,r)}catch(e){if(np(e))return;throw e}}function np(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=e.details?.attempts;return!Array.isArray(n)||n.length===0?!1:n.every(e=>typeof e.stderr==`string`&&ep(e.stderr))}function rp(e){let t=e.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0),n=t[0]??`unknown device error`;return(n.endsWith(`:`)&&t[1]?`${n} ${t[1]}`:n).slice(0,200)}async function ip(e,t,n,r,i){if(n.kind===`notifications`)await pp(e,t,`grant`,n,i);else if(n.kind===`photos`)await fp(e,t,`grant`,i);else if(n.kind===`pm`)for(let a of await sp(e,t,n.values,r))await E(e,[`pm`,`grant`,...i,t,a]);else if(n.kind===`all`)throw Error(`Unhandled Android permission target: all is resolved by the caller.`);else throw Error(`Unhandled Android permission target: ${JSON.stringify(n)}`)}async function ap(e,t,n,r,i){if(r.kind===`notifications`)return await pp(e,t,n,r,i),[r.permission];if(r.kind===`photos`){let r=await fp(e,t,`revoke`,i);return n===`reset`&&await mp(e,t,r,i),[r]}throw r.kind===`pm`?Error(`Unhandled Android permission target: pm is resolved by the caller.`):r.kind===`all`?Error(`Unhandled Android permission target: all is resolved by the caller.`):Error(`Unhandled Android permission target: ${JSON.stringify(r)}`)}function op(e,n){let r=ye(e);if(n?.trim())throw new t(`INVALID_ARGS`,`Android does not support permission modes. Received: ${n}.`);if(r===`all`)return{kind:`all`};if(r===`photos`)return{kind:`photos`};if(r===`notifications`)return{kind:`notifications`,appOps:`POST_NOTIFICATION`,permission:`android.permission.POST_NOTIFICATIONS`};let i=r in Hf?Hf[r]:void 0;if(i)return{kind:`pm`,values:i};throw new t(`INVALID_ARGS`,`Unsupported permission target on Android: ${e}. Use ${Vf.join(`|`)}.`,{hint:`Android custom permission ids are attempted through all, not individually.`})}async function sp(e,t,n,r){let{requested:i}=await Of(e,t,r);return cp(i,n,t)}function cp(e,n,r){if(e===void 0)return n;let i=n.filter(t=>e.includes(t));if(i.length===0)throw new t(`COMMAND_FAILED`,`Package ${r} has not requested permission ${n.join(`, `)}, so no permission was changed.`,{appPackage:r,permission:n.join(`,`)});return i}async function lp(e,t,n,r,i,a){let{requested:o,grants:s}=await Of(e,t,i),c=cp(o,r.values,t);await up(e,t,c,n,a);let{priorGrantState:l,warnings:u}=dp(t,c,c.map(e=>s?.get(e)??`unknown`));return{permission:[...c].join(`,`),priorGrantState:l,...u.length>0?{warnings:u}:{}}}async function up(e,t,n,r,i){for(let r of n)await E(e,[`pm`,`revoke`,...i,t,r]);if(r===`reset`)for(let r of n)await mp(e,t,r,i)}function dp(e,t,n){return{priorGrantState:n.includes(`granted`)?`granted`:n.includes(`unknown`)?`unknown`:`not_granted`,warnings:t.flatMap((t,r)=>{let i=Bf(e,t,n[r]);return i?[i]:[]})}}async function fp(e,n,r,i){let a=await hp(e),o=a!==null&&a>=33?[`android.permission.READ_MEDIA_IMAGES`,`android.permission.READ_EXTERNAL_STORAGE`]:[`android.permission.READ_EXTERNAL_STORAGE`,`android.permission.READ_MEDIA_IMAGES`],s=[];for(let t of o){let a=await E(e,[`pm`,r,...i,n,t],{allowFailure:!0});if(a.exitCode===0)return t;s.push({permission:t,stderr:a.stderr,exitCode:a.exitCode})}throw new t(`COMMAND_FAILED`,`Failed to ${r} Android photos permission`,{appPackage:n,sdkInt:a,attempts:s})}async function pp(e,t,n,r,i){let a=n===`grant`?`allow`:n===`deny`?`deny`:`default`;n===`grant`?await E(e,[`pm`,`grant`,...i,t,r.permission],{allowFailure:!0}):(await E(e,[`pm`,`revoke`,...i,t,r.permission],{allowFailure:!0}),n===`reset`&&await mp(e,t,r.permission,i)),await E(e,[`appops`,`set`,...i,t,r.appOps,a])}async function mp(e,t,n,r){for(let i of[`user-set`,`user-fixed`])await E(e,[`pm`,`clear-permission-flags`,...r,t,n,i],{allowFailure:!0})}async function hp(e){let t=await E(e,[`getprop`,`ro.build.version.sdk`],{allowFailure:!0});if(t.exitCode!==0)return null;let n=Number.parseInt(t.stdout.trim(),10);return!Number.isFinite(n)||n<=0?null:n}const gp=[`cmd`,`connectivity`,`airplane-mode`];async function _p(e,n){let r=n?`enabled`:`disabled`;await vp(e),await E(e,[...gp,n?`enable`:`disable`]);let i=await yp(e);if(i!==r)throw new t(`COMMAND_FAILED`,`Android airplane mode reads ${i} after requesting ${r}.`,{deviceId:e.id,requested:r,airplaneMode:i});return{airplaneMode:i}}async function vp(e){let{state:n,result:r}=await bp(e);if(!n)throw r.exitCode!==0&&it(r.stdout,r.stderr)?new t(`UNSUPPORTED_OPERATION`,`The connectivity service on this Android build has no airplane-mode command, so nothing was changed.`,{deviceId:e.id,hint:`settings airplane needs cmd connectivity airplane-mode, which requires Android 11 (API 30) or newer. Use a newer device or emulator image.`,stdout:r.stdout,stderr:r.stderr,exitCode:r.exitCode}):T(`Failed to read Android airplane mode`,r,{deviceId:e.id})}async function yp(e){let{state:t,result:n}=await bp(e);if(t)return t;throw T(`Failed to read Android airplane mode after changing it`,n,{deviceId:e.id})}async function bp(e){let t=await E(e,[...gp],{allowFailure:!0});return{state:t.exitCode===0?xp(t.stdout):void 0,result:t}}function xp(e){let t=e.trim().toLowerCase();if(t===`enabled`)return`enabled`;if(t===`disabled`)return`disabled`}const Sp=[`window_animation_scale`,`transition_animation_scale`,`animator_duration_scale`],Cp={"extra-small":`0.82`,small:`0.88`,medium:`0.94`,large:`1.0`,"extra-large":`1.12`,"extra-extra-large":`1.24`,"extra-extra-extra-large":`1.35`,"accessibility-medium":`1.5`,"accessibility-large":`1.75`,"accessibility-extra-large":`2.0`,"accessibility-extra-extra-large":`2.5`,"accessibility-extra-extra-extra-large":`3.2`},wp=Cp.large;async function Tp(e,n,r,i,a){switch(n.toLowerCase()){case`wifi`:{let t=be(r);await E(e,[`svc`,`wifi`,t?`enable`:`disable`]);return}case`airplane`:return await _p(e,be(r));case`location`:{if(r.toLowerCase()===`set`){if(e.kind!==`emulator`)throw new t(`UNSUPPORTED_OPERATION`,`Android precise location coordinates are supported only on emulators.`,{deviceId:e.id,hint:`Use an Android emulator for adb emu geo fix, or configure location through device/provider tooling.`});let{latitude:n,longitude:r}=xe(a);return await rt(e,[`emu`,`geo`,`fix`,String(r),String(n)]),{latitude:n,longitude:r}}let n=be(r)?`3`:`0`;await E(e,[`settings`,`put`,`secure`,`location_mode`,n]);return}case`animations`:{let t=be(r)?`1`:`0`;for(let n of Sp)await E(e,[`settings`,`put`,`global`,n,t]);return{scale:t,keys:[...Sp]}}case`appearance`:{let t=await Fp(e,r);await E(e,[`cmd`,`uimode`,`night`,t===`dark`?`yes`:`no`]);return}case`clear-app-state`:{if(r.toLowerCase()!==`clear`)throw new t(`INVALID_ARGS`,`settings clear-app-state only supports clear.`);if(!i)throw new t(`INVALID_ARGS`,`settings clear-app-state requires an app id or an active app session.`);let n=await St(e,i);if(n.type===`intent`)throw new t(`INVALID_ARGS`,`settings clear-app-state requires a package name, not an intent.`);await E(e,[`am`,`force-stop`,n.value],{allowFailure:!0});let a=await E(e,[`pm`,`clear`,n.value],{allowFailure:!0});if(a.exitCode!==0||!/\bSuccess\b/i.test(a.stdout))throw new t(`COMMAND_FAILED`,`Failed to clear Android app data for ${n.value}`,{package:n.value,stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode});return{package:n.value,cleared:!0}}case`fingerprint`:await Mp(e,jp(r));return;case`permission`:if(!i)throw new t(`INVALID_ARGS`,`permission setting requires an active app in session`);return await Wf(e,i,r,a);case`text-size`:return await Op(e,r);default:throw new t(`INVALID_ARGS`,`Unsupported setting: ${n}`)}}const Ep={"text-size":kp};async function Dp(e,t){return await Ep[t](e)}async function Op(e,t){let n=ge(t),r=Cp[n];return await E(e,[`settings`,`put`,`system`,`font_scale`,r]),me(n,r)}async function kp(e){let n=(await E(e,[`settings`,`get`,`system`,`font_scale`])).stdout.trim(),r=n===`null`?wp:n,i=/^(\d+(\.\d+)?)$/.test(r)?Number(r):NaN;if(!Number.isFinite(i)||i<=0)throw new t(`COMMAND_FAILED`,`Android reported an unusable font scale: ${n||`(empty)`}`,{deviceId:e.id,fontScale:n,hint:"Run `adb shell settings get system font_scale` to see what the device holds."});return me(Ap(i),r)}function Ap(e){let t=ve[0],n=1/0;for(let r of ve){let i=Math.abs(Number.parseFloat(Cp[r])-e);i>=n||(t=r,n=i)}return t}function jp(e){let n=e.trim().toLowerCase();if(n===`match`)return`match`;if(n===`nonmatch`)return`nonmatch`;throw new t(`INVALID_ARGS`,`Invalid fingerprint state: ${e}. Use match|nonmatch.`)}async function Mp(e,n){let i=Np(e,n),a=[];for(let t of i){let n=await rt(e,t,{allowFailure:!0});if(n.exitCode===0)return;a.push({args:t,stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})}let o=r(a);throw a.length>0&&a.every(e=>Pp(e.stdout,e.stderr))?new t(`UNSUPPORTED_OPERATION`,`Android fingerprint simulation is not supported on this target/runtime.`,{deviceId:e.id,action:n,hint:`Use an Android emulator with biometric support, or a device/runtime that exposes cmd fingerprint.`,attempts:o}):new t(`COMMAND_FAILED`,`Failed to simulate Android fingerprint.`,{deviceId:e.id,action:n,attempts:o})}function Np(e,t){let n=t===`match`?`1`:`9999`,r=[Ae(`adb`,`shell`,[`cmd`,`fingerprint`,`touch`,n]),Ae(`adb`,`shell`,[`cmd`,`fingerprint`,`finger`,n])];return e.kind===`emulator`&&r.push([`emu`,`finger`,`touch`,n]),r}function Pp(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`unknown command`)||n.includes(`can't find service: fingerprint`)||n.includes(`service fingerprint was not found`)||n.includes(`fingerprint cmd unavailable`)||n.includes(`emu command is not supported`)||n.includes(`emulator console is not running`)||n.includes(`fingerprint`)&&n.includes(`not found`)}async function Fp(e,n){let r=_e(n);if(r!==`toggle`)return r;let i=await E(e,[`cmd`,`uimode`,`night`],{allowFailure:!0});if(i.exitCode!==0)throw T(`Failed to read current Android appearance`,i);let a=Ip(i.stdout,i.stderr);if(!a)throw new t(`COMMAND_FAILED`,`Unable to determine current Android appearance for toggle`,{stdout:i.stdout,stderr:i.stderr});return a===`auto`?`dark`:a===`dark`?`light`:`dark`}function Ip(e,t){let n=/night mode:\s*(yes|no|auto)\b/i.exec(`${e}\n${t}`);if(!n)return null;let r=n[1]?.toLowerCase();return r===`yes`?`dark`:r===`no`?`light`:r===`auto`?`auto`:null}const Lp=Buffer.from([137,80,78,71,13,10,26,10]);async function Rp(e,t,n={}){if(n.stabilize===!1){await Vp(e,t);return}await zp(e);try{await _(1e3),await Vp(e,t)}finally{await Bp(e).catch(()=>{})}}async function zp(e){let t=t=>E(e,t,{allowFailure:!0});await t([`settings`,`put`,`global`,`sysui_demo_allowed`,`1`]);let n=e=>t([`am`,`broadcast`,`-a`,`com.android.systemui.demo`,`-e`,`command`,...e]);await n([`clock`,`-e`,`hhmm`,`0941`]),await n([`notifications`,`-e`,`visible`,`false`])}async function Bp(e){await E(e,[`am`,`broadcast`,`-a`,`com.android.systemui.demo`,`-e`,`command`,`exit`],{allowFailure:!0})}async function Vp(e,n){let r=await nt(e,[`screencap`,`-p`],{binaryStdout:!0});if(!r.stdoutBuffer)throw new t(`COMMAND_FAILED`,`Failed to capture screenshot`);let i=r.stdoutBuffer.indexOf(Lp);if(i<0)throw new t(`COMMAND_FAILED`,`Screenshot data does not contain a valid PNG header`);let a=Hp(r.stdoutBuffer,i);if(!a)throw new t(`COMMAND_FAILED`,`Screenshot data does not contain a complete PNG payload`);await S().files.writeBytes(n,r.stdoutBuffer.subarray(i,a))}function Hp(e,t){let n=t+Lp.length;for(;n+8<=e.length;){let t=e.readUInt32BE(n),r=n+4,i=e.toString(`ascii`,r,r+4),a=n+12+t;if(a>e.length)return null;if(i===`IEND`)return a;n=a}return null}async function Up(e,t,n=0){let r=Ue(e);if(r){await r({action:`type`,text:t,delayMs:n}),$(`type`,`provider-native`,t);return}let i=await Jp(e,`type`,t);if(i.backend===`test-ime`){await Yp(e,i.packageName,t,n);return}if(n>0&&Array.from(t).length>1){await Zp(e,{action:`type`,text:t,chunkSize:1,delayMs:n});return}await Zp(e,{action:`type`,text:t,chunkSize:8,delayMs:0})}async function Wp(e,t,n,r,i=0,a={}){let o=await du(e,t,n,a),s=Ue(e);if(s)return await s({action:`fill`,target:{x:t,y:n},text:r,delayMs:i}),$(`fill`,`provider-native`,r),X(r,o,await cu(e,t,n,r,a));let c=null;for(let s of Gp(i)){await Ia(e,t,n);let i=await Jp(e,`fill`,r);if(i.backend===`test-ime`)return X(r,o,await Xp(e,i.packageName,t,n,r,o,a));let l=await Kp(e,{x:t,y:n,text:r,beforeTarget:o,attempt:s},a);if(c=l,l.ok)return;if(l.reason===`ime_capture`)return X(r,o,l);let u=fu(r,o,l);if(u)return u}return X(r,o,c)}function Gp(e){return[{clearPadding:12,minClear:8,maxClear:48,chunkSize:e>0?1:8,inputDelayMs:e},{clearPadding:24,minClear:16,maxClear:96,chunkSize:e>0?1:4,inputDelayMs:e>0?e:15}]}async function Kp(e,t,n){let{x:r,y:i,text:a,beforeTarget:o,attempt:s}=t;return await $p(e,qp(a,o,s)),await Zp(e,{action:`fill`,text:a,chunkSize:s.chunkSize,delayMs:s.inputDelayMs}),cu(e,r,i,a,n)}function qp(e,t,n){let r=Array.from(e).length;return cm(r>0?r+n.clearPadding:t?.text?Array.from(t.text).length+n.clearPadding:n.maxClear,n.minClear,n.maxClear)}async function Jp(e,t,n){if(ns(e))return{backend:`test-ime`,packageName:(await Io(w(e))).manifest.packageName};let r=await em(e,t),i=r?.inputMethodPackage;return Ho(i)?{backend:`test-ime`,packageName:i}:(nm(n),tm(r,t),{backend:`adb-shell`})}async function Yp(e,t,n,r){let i=b(e),a=n.split(`
+`);for(let[n,o]of a.entries()){let s=r>0?sm(o,1):[o];for(let[e,o]of s.entries())o&&await Uo(i,t,o),r>0&&(e+1<s.length||n+1<a.length)&&await _(r);n+1<a.length&&await E(e,[`input`,`keyevent`,`ENTER`])}$(`type`,`test-ime`,n)}async function Xp(e,t,n,r,i,a,o){let s=b(e),c=null;for(let l=0;l<2;l+=1){l>0&&await Ia(e,n,r),await Wo(s,t),i&&await Uo(s,t,i);let u=await cu(e,n,r,i,o);if(c=u,u.ok||fu(i,a,u))break}return $(`fill`,`test-ime`,i),c}async function Zp(e,t){let n=t.text.split(`
+`);for(let[r,i]of n.entries()){let a=sm(i,t.chunkSize);for(let[i,o]of a.entries())await Qp(e,o),t.delayMs>0&&(i+1<a.length||r+1<n.length)&&await _(t.delayMs);r+1<n.length&&await E(e,[`input`,`keyevent`,`ENTER`])}$(t.action,`adb-shell`,t.text)}async function Qp(e,t){if(t)try{await E(e,[`input`,`text`,im(t)])}catch(e){throw am(e)?om(t,e):e}}async function $p(e,t){let n=Math.max(0,t);await E(e,[`input`,`keyevent`,`KEYCODE_MOVE_END`],{allowFailure:!0});for(let t=0;t<n;t+=24){let r=Math.min(24,n-t);await E(e,[`input`,`keyevent`,...Array(r).fill(`KEYCODE_DEL`)],{allowFailure:!0})}}async function em(e,t){try{return await ho(e)}catch(e){return g({level:`warn`,phase:`android_input_ownership_probe_failed`,data:{action:t,error:e instanceof Error?e.message:String(e)}}),null}}function tm(e,n){if(!(!e||e.inputOwner!==`ime`))throw new t(`COMMAND_FAILED`,`KEYBOARD_OVERLAY_BLOCKING: Android text input is blocked because the focused input belongs to the active keyboard/IME.`,{failureReason:`ime_capture`,action:n,inputOwner:e.inputOwner,inputType:e.inputType,type:e.type,inputMethodPackage:e.inputMethodPackage,focusedPackage:e.focusedPackage,focusedResourceId:e.focusedResourceId,nextAction:`Focused input appears to be owned by the keyboard/IME; dismiss or change the IME before retrying text entry.`})}function nm(e){if(!rm(e))throw om(e)}function rm(e){for(let t of e){let e=t.codePointAt(0);if(e!==void 0&&t!==`
+`&&(e<32||e>126))return!1}return!0}function im(e){return e.replaceAll(` `,`%s`)}function am(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=e.details?.stderr,r=(typeof n==`string`?n:``).toLowerCase();return!!(r.includes(`exception occurred while executing 'text'`)||r.includes(`nullpointerexception`)&&r.includes(`inputshellcommand.sendtext`))}function om(e,n){return new t(`COMMAND_FAILED`,"Android text input requires provider-native text injection or the bundled test IME helper for non-ASCII/control characters; the adb-shell fallback supports ASCII text only. On emulators the test IME activates automatically; on real devices pass `open --test-ime` to enable it (see `agent-device doctor` for the current IME state).",{backend:`adb-shell`,textLength:Array.from(e).length,textPreview:e.slice(0,32)},n instanceof Error?n:void 0)}function sm(e,t){let n=Math.max(1,Math.floor(t)),r=[],i=Array.from(e);for(let e=0;e<i.length;e+=n)r.push(i.slice(e,e+n).join(``));return r.length>0?r:[``]}function $(e,t,n){g({phase:`android_text_injection`,data:{action:e,backend:t,textLength:Array.from(n).length}})}function cm(e,t,n){return Math.max(t,Math.min(n,e))}var lm=e({ANDROID_FOCUSED_WINDOW_MARKER:()=>Ot,ANDROID_FOCUS_MARKERS:()=>Et,ANDROID_IME_HELPER_SERVICE_COMPONENT:()=>`com.callstack.agentdevice.imehelper/.TestInputMethodService`,ANDROID_SNAPSHOT_PRESENTATION_DEFAULT_DEADLINE_MS:()=>250,ANDROID_TEST_IME_SETTINGS_KEYS:()=>Yo,ANDROID_TOUCH_PLAN_PROTOCOL:()=>ra,AndroidSnapshotPresentationFailure:()=>Y,activateAndroidTestIme:()=>Fu,androidAdbForwardsDeviceExitStatus:()=>Wt,androidAdbHostTarget:()=>Ze,androidAdbInvocation:()=>Ye,androidAdbResultError:()=>T,androidAdbSerialTarget:()=>Xe,androidAppsDiscoveryHint:()=>Ct,androidCaptureFailureReasonDetail:()=>br,androidCaptureFailureReasonFromExitCode:()=>yr,androidCaptureFailureReasonFromHelperResult:()=>vr,androidClipboardShellSupportForResult:()=>dm,androidDeviceChecks:()=>ps,androidFillFailureDetails:()=>gu,androidFillFailureMessage:()=>hu,androidRevokedPermissionWarning:()=>Bf,androidSnapshotPublicationInput:()=>kl,androidToolchainCheck:()=>fs,androidUiNodes:()=>Lc,annotateAndroidNativePerfError:()=>N,appSwitcherAndroid:()=>Pa,attachAdbFailureHint:()=>$e,backAndroid:()=>Ea,buildAndroidFillUnconfirmedVerification:()=>fu,buildAndroidNativeToolUnavailableHint:()=>Fr,buildAndroidSnapshotClickabilityEvidence:()=>Zc,buildAndroidSnapshotHelperArgs:()=>mi,buildAndroidSnapshotHelperCaptureOptions:()=>fi,buildUiHierarchySnapshot:()=>_c,captureAndroidHeapSnapshot:()=>mf,captureAndroidLogcatWithAdb:()=>fm,captureAndroidSnapshotWithHelper:()=>di,captureAndroidSnapshotWithHelperSession:()=>Qi,classifyAdbFailure:()=>tt,classifyAndroidAlertIdentifier:()=>nn,classifyAndroidAppTarget:()=>vt,classifyAndroidHelperContent:()=>$c,cleanupAndroidNativePerfSession:()=>Ud,clearAndroidImeHelperText:()=>Wo,clearAndroidTestImeRecoveryMarker:()=>Vu,closeAndroidApp:()=>pt,completeAndroidFillVerification:()=>X,createAndroidPortReverseManager:()=>Ve,createAndroidSnapshotCapture:()=>Ol,createAndroidSnapshotPresentationBudget:()=>fc,createAndroidSnapshotPresentationNode:()=>cc,createAndroidWindowDumpReader:()=>Mt,createDeviceAdbExecutor:()=>He,createLocalAndroidAdbProvider:()=>Re,dismissAndroidKeyboard:()=>go,dismissAndroidKeyboardWithAdb:()=>_o,ensureAndroidEmulatorBooted:()=>gt,ensureAndroidImeHelper:()=>Bo,ensureAndroidSdkPathConfigured:()=>ft,ensureAndroidSnapshotHelper:()=>dr,executeAndroidTouchHelperPlan:()=>sa,executeAndroidTouchPlan:()=>xa,fillAndroid:()=>Wp,findAndroidAlertCandidate:()=>rn,focusAndroid:()=>Ia,forceStopAndroidAppWithAdb:()=>Qa,forgetAndroidSnapshotHelperInstall:()=>ir,formatAndroidInstalledPackageRequiredMessage:()=>xt,getAndroidAppState:()=>At,getAndroidBlockingDialogObservation:()=>jt,getAndroidImeHelperDeviceKey:()=>U,getAndroidKeyboardState:()=>ho,getAndroidKeyboardStatusWithAdb:()=>V,getAndroidScreenSize:()=>Ba,handleAndroidAlert:()=>Va,homeAndroid:()=>Da,inferAndroidAppName:()=>bt,inferAndroidPackageAfterOpen:()=>mm,inspectInstalledAndroidHelper:()=>Rn,installAndroidAdbPackage:()=>We,installAndroidInstallablePath:()=>lo,isAmStartError:()=>ht,isAndroidImeHelperPackage:()=>Ho,isAndroidPermissionPackage:()=>Jt,isAndroidSnapshotPresentationFailure:()=>uc,isAndroidTestImeActive:()=>ns,listAndroidAdbSerialsQuick:()=>us,listAndroidAppsWithAdb:()=>um,longPressAndroid:()=>Fa,lowerAndroidAdbInvocation:()=>qe,lowerAndroidTouchPlan:()=>ya,makeEnsureAndroidHelperInstalled:()=>Bn,normalizeAndroidTouchHelperGestureRequest:()=>fa,openAndroidApp:()=>dt,openAndroidAppWithAdb:()=>eo,openAndroidDevice:()=>lt,parseAndroidAdbArgv:()=>Qe,parseAndroidHelperManifest:()=>Zn,parseAndroidLaunchComponent:()=>mt,parseAndroidLaunchablePackages:()=>Tt,parseAndroidSnapshotHelperManifest:()=>Zn,parseAndroidSnapshotHelperOutput:()=>Ci,parseAndroidUserInstalledPackages:()=>wt,parseInstrumentationRecords:()=>Dn,parseUiHierarchyTree:()=>Yc,prepareAndroidInstallArtifact:()=>od,pressAndroid:()=>wa,pressAndroidEnter:()=>Oa,pressAndroidTvRemote:()=>Ta,pullAndroidAdbFile:()=>Be,pushAndroidNotification:()=>ld,readAndroidBlockingDialogFocus:()=>Dt,readAndroidClipboardText:()=>Oo,readAndroidClipboardWithAdb:()=>ko,readAndroidDefaultInputMethod:()=>W,readAndroidFillTargetBeforeMutation:()=>du,readAndroidGestureViewport:()=>Sa,readAndroidHelperManifestInteger:()=>wn,readAndroidHelperManifestLiteral:()=>k,readAndroidSetting:()=>Dp,readAndroidTestImeRecoveryMarkers:()=>Hu,readAndroidTextAtPoint:()=>lu,readAndroidTextAtPointInHierarchy:()=>mu,readAndroidTouchHelperFinalRecord:()=>ha,readAndroidTouchHelperViewportReading:()=>ca,readInstrumentationResultBoolean:()=>Nn,readInstrumentationResultNumber:()=>A,resetAndroidAdbShellProtocolProbes:()=>Gt,resetAndroidFramePerfStats:()=>Rd,resetAndroidImeHelperInstallCache:()=>Vo,resetAndroidSnapshotHelperInstallCache:()=>sr,resetAndroidSnapshotHelperRuntime:()=>El,resetAndroidSnapshotHelperSessions:()=>Zi,resetAndroidTestImeActivationCacheForTests:()=>is,resetAndroidWindowDumpFocusMemoForTests:()=>kt,resolveAndroidAdbExecutor:()=>b,resolveAndroidAdbProvider:()=>w,resolveAndroidApp:()=>St,resolveAndroidArchivePackageName:()=>qu,resolveAndroidHelperArtifact:()=>zn,resolveAndroidImeHelperArtifact:()=>Lo,resolveAndroidPackageForOpen:()=>pm,resolveAndroidSnapshotHelperCaptureOptions:()=>pi,resolveAndroidTextInjector:()=>Ue,resolveAndroidTouchProvider:()=>Ie,resolveScopedAndroidAdbBackgroundTransport:()=>ze,restoreAndroidTestIme:()=>os,restoreOrphanedAndroidTestImeOnDaemonStartup:()=>ls,retireAndroidSnapshotHelperAfterContentFailure:()=>Tl,runAdbExecOut:()=>Ge,runAdbShell:()=>x,runAndroidAdb:()=>rt,runAndroidExecOut:()=>nt,runAndroidHostAdb:()=>Fe,runAndroidShell:()=>E,runAndroidSnapshotHelperSessionTouchCommand:()=>ea,sampleAndroidFramePerf:()=>Ld,sampleAndroidMemoryPerf:()=>pf,screenshotAndroid:()=>Rp,scrollAndroid:()=>La,selectAndroidImeHelperArtifact:()=>Io,sendAndroidImeHelperText:()=>Uo,serializeAndroidAdbInvocation:()=>Je,setAndroidOrientation:()=>ka,setAndroidPermission:()=>Wf,setAndroidSetting:()=>Tp,setAndroidTestImeActiveForTests:()=>as,sleep:()=>_,snapshotAndroid:()=>jl,startAndroidPerfettoTrace:()=>$d,startAndroidSimpleperfProfile:()=>rf,stopAndroidPerfettoTrace:()=>ef,stopAndroidSimpleperfProfile:()=>af,stopAndroidSnapshotHelperSession:()=>B,stopAndroidSnapshotHelperSessionForDevice:()=>Xi,typeAndroid:()=>Up,validateAndroidGestureViewport:()=>Pn,validateAndroidRegularPresentation:()=>pc,verifyAndroidFilledText:()=>cu,verifyAndroidFilledTextInHierarchy:()=>pu,verifyAndroidHelperApkChecksum:()=>Wn,waitForAndroidBoot:()=>ut,withAndroidAdbProvider:()=>Le,withAndroidAppResolutionCacheInvalidated:()=>yt,withAndroidHostAdbTransport:()=>Ke,writeAndroidClipboardText:()=>Ao,writeAndroidClipboardWithAdb:()=>jo,writeAndroidSimpleperfReport:()=>of,writeAndroidTestImeRecoveryMarker:()=>Bu});async function um(...e){let{listAndroidAppsWithAdb:t}=await import(`./app-helpers.js`);return await t(...e)}async function dm(...e){let{androidClipboardShellSupportForResult:t}=await import(`./clipboard-shell-response.js`);return t(...e)}async function fm(...e){let{captureAndroidLogcatWithAdb:t}=await import(`./logcat.js`);return await t(...e)}async function pm(...e){let{resolveAndroidPackageForOpen:t}=await import(`./open-target-resolution.js`);return await t(...e)}async function mm(...e){let{inferAndroidPackageAfterOpen:t}=await import(`./open-target-resolution.js`);return await t(...e)}export{La as A,Ea as C,wa as D,Fa as E,xa as M,Sa as N,Oa as O,Pa as S,Da as T,Ao as _,Up as a,eo as b,Tp as c,go as d,_o as f,ko as g,Oo as h,Wp as i,ka as j,Ta as k,jl as l,V as m,um as n,Rp as o,ho as p,lm as r,Dp as s,fm as t,kl as u,jo as v,Ia as w,Va as x,Qa as y};