agent-device 0.17.3 → 0.17.5

package/dist/src/cli.js

@@ -1,4 +1,4 @@
-import{pathToFileURL as e}from"node:url";import t from"node:fs";import n from"node:crypto";import r from"node:path";import{ensureCompanionTunnel as o,stopCompanionTunnel as s}from"./1974.js";import{REACT_DEVTOOLS_COMPANION_RUN_ARG as a}from"./2301.js";import{REMOTE_CONFIG_FIELD_SPECS as i,resolveRemoteConfigProfile as l,resolveRemoteConfigPath as c}from"./208.js";import{asAppError as d,normalizeError as u,AppError as f}from"./9152.js";import{createRequestId as m,withDiagnosticsScope as p,getDiagnosticsMeta as g,flushDiagnosticsToSessionFile as h,emitDiagnostic as w}from"./7599.js";import{resolveDaemonPaths as v}from"./9238.js";import{stopMetroTunnel as I}from"./metro.js";import{runCmdStreaming as y,runCmd as A}from"./9818.js";import{formatSnapshotDiffText as _,formatScreenshotDiffText as S,printHumanError as C,printJson as D,formatCliOutput as k}from"./cli-output.js";import{parseSelectorChain as N}from"./7847.js";import{stringifyMaestroYamlDocuments as U,parseReplayScriptDetailed as b,formatMaestroPoint as R,readReplayScriptMetadata as E}from"./2403.js";import{resolveUserPath as P,expandUserHomePath as T}from"./3267.js";import{captureCliReaders as L,interactionCliReaders as B,replayCliReaders as x,batchCliReaders as M,appCliReaders as O,observabilityCliReaders as $,parseInstallSourceConfig as G,gestureCliReaders as V,reactNativeCliReaders as j,recordingCliReaders as K,selectorCliReaders as H,systemCliReaders as F,perfCliReaders as q}from"./6133.js";import{isCommandName as J,metroCliReaders as z,debuggingCliReaders as W}from"./5611.js";import{runCommand as Z}from"./command-surface.js";import{createLocalArtifactAdapter as Y}from"./7719.js";import{localCommandPolicy as X,createAgentDevice as Q}from"./123.js";import{isClientBackedCliCommandName as ee}from"./6088.js";import{mergeDefinedFlags as et,parseOptionValueFromSource as en,getConfigurableOptionSpecs as er,getOptionSpec as eo,usage as es,parseRawArgs as ea,usageForCommand as ei,finalizeParsedArgs as el}from"./args.js";import{readVersion as ec}from"./9671.js";import{createAgentDeviceClient as ed,sendToDaemon as eu}from"./9542.js";import{maybeRunUpgradeNotifier as ef}from"./113.js";let em={slug:"react-devtools-companion",runArg:a,displayName:"React DevTools companion"};async function ep(e){return await o({...e,definition:em,localBaseUrl:e.localBaseUrl??"http://127.0.0.1:8097",registerPath:"/api/react-devtools/companion/register",unregisterPath:"/api/react-devtools/companion/unregister",devicePort:e.devicePort??8097})}async function eg(e){return await s({...e,definition:em})}function eh(e){var n;let r,o=eA(e);if(!t.existsSync(o))return null;try{r=JSON.parse(t.readFileSync(o,"utf8"))}catch(t){return ek(e,t),null}return!(!(n=r)||"object"!=typeof n||Array.isArray(n))&&1===n.version&&"string"==typeof n.session&&"string"==typeof n.remoteConfigPath&&"string"==typeof n.remoteConfigHash&&(void 0===n.daemon||"object"==typeof n.daemon&&null!==n.daemon&&!Array.isArray(n.daemon))&&"string"==typeof n.tenant&&"string"==typeof n.runId&&(void 0===n.leaseId||"string"==typeof n.leaseId)&&(void 0===n.leaseBackend||"string"==typeof n.leaseBackend)&&"string"==typeof n.connectedAt&&"string"==typeof n.updatedAt?r:(ek(e),null)}function ew(e){let n=eA({stateDir:e.stateDir,session:e.state.session});t.mkdirSync(r.dirname(n),{recursive:!0}),eD(n,e.state),eD(e_(e.stateDir),{session:e.state.session})}function ev(e){return{baseUrl:function(e){if(!e)return;let t=new URL(e);for(let e of(t.username="",t.password="",[...t.searchParams.keys()]))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,"")}(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function eI(e){t.rmSync(eA(e),{force:!0});let n=e_(e.stateDir);eC(e.stateDir)===e.session&&t.rmSync(n,{force:!0})}function ey(e){try{return n.createHash("sha256").update(t.readFileSync(e)).digest("hex")}catch(t){throw new f("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function eA(e){return r.join(e.stateDir,"remote-connections",`${function(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,"_");if(!t)return"default";if(t===e)return t;let r=n.createHash("sha256").update(e).digest("hex").slice(0,8);return`${t}-${r}`}(e.session)}.json`)}function e_(e){return r.join(e,"remote-connections",".active-session.json")}function eS(e){let t=eC(e.stateDir);return t?eh({stateDir:e.stateDir,session:t}):null}function eC(e){let n=e_(e);if(t.existsSync(n))try{let e=JSON.parse(t.readFileSync(n,"utf8"));return"string"==typeof e.session?e.session:void 0}catch{return}}function eD(e,n){t.writeFileSync(e,`${JSON.stringify(n,null,2)}
+import{pathToFileURL as e}from"node:url";import t from"node:fs";import n from"node:crypto";import r from"node:path";import{ensureCompanionTunnel as o,stopCompanionTunnel as s}from"./1974.js";import{REACT_DEVTOOLS_COMPANION_RUN_ARG as a}from"./2301.js";import{REMOTE_CONFIG_FIELD_SPECS as i,resolveRemoteConfigProfile as l,resolveRemoteConfigPath as c}from"./208.js";import{asAppError as d,normalizeError as u,AppError as f}from"./9152.js";import{createRequestId as m,withDiagnosticsScope as p,getDiagnosticsMeta as g,flushDiagnosticsToSessionFile as h,emitDiagnostic as w}from"./7599.js";import{resolveDaemonPaths as v}from"./4012.js";import{stopMetroTunnel as I}from"./metro.js";import{runCmdStreaming as y,runCmd as A}from"./9818.js";import{formatSnapshotDiffText as _,formatScreenshotDiffText as S,printHumanError as C,printJson as D,formatCliOutput as k}from"./cli-output.js";import{parseSelectorChain as N}from"./7847.js";import{stringifyMaestroYamlDocuments as U,parseReplayScriptDetailed as b,formatMaestroPoint as R,readReplayScriptMetadata as E}from"./2403.js";import{resolveUserPath as P,expandUserHomePath as T}from"./3267.js";import{captureCliReaders as L,interactionCliReaders as B,replayCliReaders as x,batchCliReaders as M,appCliReaders as O,observabilityCliReaders as $,parseInstallSourceConfig as G,gestureCliReaders as V,reactNativeCliReaders as j,recordingCliReaders as K,selectorCliReaders as H,systemCliReaders as F,perfCliReaders as q}from"./6133.js";import{isCommandName as J,metroCliReaders as z,debuggingCliReaders as W}from"./5611.js";import{runCommand as Z}from"./command-surface.js";import{createLocalArtifactAdapter as Y}from"./7719.js";import{localCommandPolicy as X,createAgentDevice as Q}from"./123.js";import{isClientBackedCliCommandName as ee}from"./6088.js";import{mergeDefinedFlags as et,parseOptionValueFromSource as en,getConfigurableOptionSpecs as er,getOptionSpec as eo,usage as es,parseRawArgs as ea,usageForCommand as ei,finalizeParsedArgs as el}from"./args.js";import{readVersion as ec}from"./9671.js";import{createAgentDeviceClient as ed,sendToDaemon as eu}from"./9542.js";import{maybeRunUpgradeNotifier as ef}from"./113.js";let em={slug:"react-devtools-companion",runArg:a,displayName:"React DevTools companion"};async function ep(e){return await o({...e,definition:em,localBaseUrl:e.localBaseUrl??"http://127.0.0.1:8097",registerPath:"/api/react-devtools/companion/register",unregisterPath:"/api/react-devtools/companion/unregister",devicePort:e.devicePort??8097})}async function eg(e){return await s({...e,definition:em})}function eh(e){var n;let r,o=eA(e);if(!t.existsSync(o))return null;try{r=JSON.parse(t.readFileSync(o,"utf8"))}catch(t){return ek(e,t),null}return!(!(n=r)||"object"!=typeof n||Array.isArray(n))&&1===n.version&&"string"==typeof n.session&&"string"==typeof n.remoteConfigPath&&"string"==typeof n.remoteConfigHash&&(void 0===n.daemon||"object"==typeof n.daemon&&null!==n.daemon&&!Array.isArray(n.daemon))&&"string"==typeof n.tenant&&"string"==typeof n.runId&&(void 0===n.leaseId||"string"==typeof n.leaseId)&&(void 0===n.leaseBackend||"string"==typeof n.leaseBackend)&&"string"==typeof n.connectedAt&&"string"==typeof n.updatedAt?r:(ek(e),null)}function ew(e){let n=eA({stateDir:e.stateDir,session:e.state.session});t.mkdirSync(r.dirname(n),{recursive:!0}),eD(n,e.state),eD(e_(e.stateDir),{session:e.state.session})}function ev(e){return{baseUrl:function(e){if(!e)return;let t=new URL(e);for(let e of(t.username="",t.password="",[...t.searchParams.keys()]))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,"")}(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function eI(e){t.rmSync(eA(e),{force:!0});let n=e_(e.stateDir);eC(e.stateDir)===e.session&&t.rmSync(n,{force:!0})}function ey(e){try{return n.createHash("sha256").update(t.readFileSync(e)).digest("hex")}catch(t){throw new f("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function eA(e){return r.join(e.stateDir,"remote-connections",`${function(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,"_");if(!t)return"default";if(t===e)return t;let r=n.createHash("sha256").update(e).digest("hex").slice(0,8);return`${t}-${r}`}(e.session)}.json`)}function e_(e){return r.join(e,"remote-connections",".active-session.json")}function eS(e){let t=eC(e.stateDir);return t?eh({stateDir:e.stateDir,session:t}):null}function eC(e){let n=e_(e);if(t.existsSync(n))try{let e=JSON.parse(t.readFileSync(n,"utf8"));return"string"==typeof e.session?e.session:void 0}catch{return}}function eD(e,n){t.writeFileSync(e,`${JSON.stringify(n,null,2)}
 `,{encoding:"utf8",mode:384}),t.chmodSync(e,384)}function ek(e,t){w({level:"warn",phase:"remote_connection_state_invalid",data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),eI(e)}let eN=i.map(e=>e.key);function eU(e){let t={};for(let n of eN){let r=e[n];void 0!==r&&(t[n]=r)}return t}let eb=new Set(["connect","connection","close","disconnect","metro","session"]),eR=new Set(["open"]);async function eE(e){let t,n,{command:r,flags:o,client:s}=e;if(!o.remoteConfig)return{flags:o,runtime:e.runtime};let a=v(o.stateDir).baseDir,i=l({configPath:o.remoteConfig,cwd:process.cwd(),env:process.env}),c={...eU(i.profile),...o,remoteConfig:i.resolvedPath},d=eh({stateDir:a,session:c.session??"default"});if(d&&d.remoteConfigPath!==i.resolvedPath)throw new f("INVALID_ARGS","A different remote connection is already active for this session. Run connect --force or disconnect before using a different --remote-config.",{session:d.session,activeRemoteConfig:d.remoteConfigPath,requestedRemoteConfig:i.resolvedPath});let u=d??function(e,t){if(!e.tenant)throw new f("INVALID_ARGS","remote command requires tenant in remote config or via --tenant <id>.");if(!e.runId)throw new f("INVALID_ARGS","remote command requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new f("INVALID_ARGS","remote command requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let n=new Date().toISOString();return{version:1,session:e.session??"default",remoteConfigPath:t,remoteConfigHash:ey(t),daemon:ev(e),tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend??ex(e),platform:e.platform,target:e.target,connectedAt:n,updatedAt:n}}(c,i.resolvedPath),m={...c,session:u.session},p=function(e,t){if(e)return eO(e,t)?e:void 0}(u.runtime,m.platform)??e.runtime,g=u,h=!d;if(w=r,!eb.has(w)){let e=u.leaseBackend??function(e,t){let n=ex(e);if(n)return n;throw new f("INVALID_ARGS",`${t} requires --platform ios|android or --lease-backend when the remote connection has not resolved a lease yet.`)}(o,r);var w,I,y,A,_,S=u,C=o,D=e;if(S.leaseBackend&&S.leaseBackend!==D)throw new f("INVALID_ARGS","Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.",{session:S.session,leaseBackend:S.leaseBackend});if(S.platform&&C.platform&&S.platform!==C.platform)throw new f("INVALID_ARGS","Active remote connection is already bound to a different platform. Re-run connect --force to replace it.",{session:S.session,platform:S.platform});if(S.target&&C.target&&S.target!==C.target)throw new f("INVALID_ARGS","Active remote connection is already bound to a different target. Re-run connect --force to replace it.",{session:S.session,target:S.target});let t=await e$(s,g,e);m.leaseId=t.leaseId,m.leaseBackend=e,m.platform=g.platform??m.platform,m.target=g.target??m.target,(g.leaseId!==t.leaseId||g.leaseBackend!==e)&&(g={...g,leaseId:t.leaseId,leaseBackend:e,platform:g.platform??o.platform,target:g.target??o.target,updatedAt:new Date().toISOString()},h=!0)}if(I=r,y=e.batchSteps,(eR.has(I)||"batch"===I&&y&&y.some(e=>{let t=e.command.trim().toLowerCase();return eR.has(t)&&void 0===e.runtime}))&&eM(m)&&(!g.leaseId&&m.leaseId&&(g={...g,leaseId:m.leaseId,leaseBackend:m.leaseBackend}),e.forceRuntimePrepare||!p||!eO(p,m.platform))){if(!g.leaseId)throw new f("INVALID_ARGS",`${r} requires a resolved remote lease before Metro runtime can be prepared.`);let e=await eP(m,s,u.remoteConfigPath,u.session,{tenantId:u.tenant,runId:u.runId,leaseId:g.leaseId});p=e.runtime;let o=(A=g.metro,_=e.cleanup,A?.projectRoot!==_?.projectRoot||A?.profileKey!==_?.profileKey||A?.consumerKey!==_?.consumerKey);t=o?g.metro:void 0,n=o?e.cleanup:void 0,g={...g,runtime:e.runtime,metro:e.cleanup,updatedAt:new Date().toISOString()},h=!0}if(h)try{ew({stateDir:a,state:g})}catch(e){throw await eT(n),e}return await eT(t),{flags:{...m,session:g.session,leaseId:g.leaseId,leaseBackend:g.leaseBackend,platform:g.platform??m.platform,target:g.target??m.target},runtime:p}}async function eP(e,t,n,r,o){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new f("INVALID_ARGS",'Deferred Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)throw new f("INVALID_ARGS","Deferred Metro preparation requires metroPublicBaseUrl or metroProxyBaseUrl when Metro settings are provided.");let s=await t.metro.prepare({projectRoot:e.metroProjectRoot,kind:function(e){if(void 0!==e){if("auto"===e||"react-native"===e||"expo"===e)return e;throw new f("INVALID_ARGS","metro prepare --kind must be auto, react-native, or expo")}}(e.metroKind),publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,bridgeScope:o,launchUrl:e.launchUrl,companionProfileKey:n,companionConsumerKey:r,port:e.metroPreparePort,listenHost:e.metroListenHost,statusHost:e.metroStatusHost,startupTimeoutMs:e.metroStartupTimeoutMs,probeTimeoutMs:e.metroProbeTimeoutMs,reuseExisting:!e.metroNoReuseExisting&&void 0,installDependenciesIfNeeded:!e.metroNoInstallDeps&&void 0,runtimeFilePath:e.metroRuntimeFile});return{runtime:"ios"===e.platform?s.iosRuntime:s.androidRuntime,cleanup:e.metroProxyBaseUrl?{projectRoot:s.projectRoot,profileKey:n,consumerKey:r}:void 0}}async function eT(e){if(e)try{await I(e)}catch{}}async function eL(e){try{await eg({projectRoot:process.cwd(),stateDir:e.stateDir,profileKey:e.state.remoteConfigPath,consumerKey:e.state.session})}catch{}}async function eB(e,t){if(t.leaseId)try{await e.leases.release({tenant:t.tenant,runId:t.runId,leaseId:t.leaseId,daemonBaseUrl:t.daemon?.baseUrl,daemonTransport:t.daemon?.transport,daemonServerMode:t.daemon?.serverMode})}catch{}}function ex(e){return e.leaseBackend?e.leaseBackend:"android"===e.platform?"android-instance":"ios"===e.platform?"ios-instance":void 0}function eM(e){let t=e.metroKind;return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||t)}function eO(e,t){return!e.platform||!t||"ios"!==t&&"android"!==t||e.platform===t}async function e$(e,t,n){if(t.leaseId&&t.leaseBackend===n){let r=await eG(e,t.leaseId,{tenant:t.tenant,runId:t.runId,leaseBackend:n});if(r)return r}return await e.leases.allocate({tenant:t.tenant,runId:t.runId,leaseBackend:n})}async function eG(e,t,n){try{return await e.leases.heartbeat({tenant:n.tenant,runId:n.runId,leaseId:t,leaseBackend:n.leaseBackend})}catch(e){var r;if((r=e)instanceof f&&"UNAUTHORIZED"===r.code&&(r.details?.reason==="LEASE_NOT_FOUND"||r.details?.reason==="LEASE_EXPIRED"||r.details?.reason==="LEASE_REVOKED"))return;throw e}}async function eV(e,t){let n=await e.text(),r={};if(n.trim().length>0)try{r=JSON.parse(n)}catch(n){throw new f("COMMAND_FAILED",t.invalidJsonMessage,{status:e.status},n instanceof Error?n:void 0)}if(!e.ok)throw new f("UNAUTHORIZED",t.rejectedMessage,{status:e.status,response:r});return r}async function ej(e){return await eK({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:"connect"===e.command&&!e.flags.noLogin,env:e.env})}async function eK(e){let t=e.env??e.io?.env??process.env;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:"none"};if(e8(e.flags.daemonAuthToken))return{flags:e.flags,source:"flag"};if(e8(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{flags:e.flags,source:"env"};if(!function(e,t){if("1"===t.AGENT_DEVICE_CLOUD_AUTH||"true"===t.AGENT_DEVICE_CLOUD_AUTH||e8(t.AGENT_DEVICE_CLOUD_BASE_URL))return!0;try{let t=new URL(e).hostname.toLowerCase();return"agent-device.dev"===t||t.endsWith(".agent-device.dev")}catch{return!1}}(e.flags.daemonBaseUrl,t))return{flags:e.flags,source:"none"};let n=await ez({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(n)return{flags:{...e.flags,daemonAuthToken:n.accessToken},source:"cli-session"};if(!e.allowInteractiveLogin){if(e.flags.noLogin)throw new f("UNAUTHORIZED","Remote daemon authentication is required.",{hint:"Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN."});throw eX(e.command,t)}let r=await eF({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:"login"}}async function eH(e){let t=e.env??e.io?.env??process.env;if(e8(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:eQ(t)};if(e8(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:t.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:eQ(t)};let n=await ez({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(n)return{accessToken:n.accessToken,cloudBaseUrl:n.cloudBaseUrl};if(e.flags.noLogin)throw new f("UNAUTHORIZED","Cloud connection profile authentication is required.",{hint:"Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN."});let r=await eF({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io,commandLabel:"agent-device connect"});return{accessToken:r.accessToken,cloudBaseUrl:r.session.cloudBaseUrl}}async function eF(e){let n,o,s,a=e.env??e.io?.env??process.env,i=(d=a,u=e.io,n=u?.stdinIsTTY??process.stdin.isTTY,o=u?.stdoutIsTTY??process.stdout.isTTY,"true"!==(m=d).CI&&"true"!==m.GITHUB_ACTIONS&&"true"!==m.BUILDKITE&&n&&o?(p=d).SSH_TTY||p.SSH_CONNECTION||"true"===p.CODESPACES||p.GITPOD_WORKSPACE_ID||"true"===p.REMOTE_CONTAINERS?"device-code":"local-browser":"non-interactive");if("non-interactive"===i)throw eX(e.commandLabel??"agent-device connect",a);let l=eQ(a),c=await eY({baseUrl:l,pathName:"/api/control-plane/device-auth/start",body:{client:"agent-device",tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});var d,u,m,p,g,h,w=c;if(!e8(w.deviceCode)||!e8(w.userCode)||!e8(w.verificationUri))throw new f("COMMAND_FAILED","Cloud auth start returned an unusable response.");let v=c.verificationUriComplete??c.verificationUri,I="local-browser"===i?c.verificationUri:(g=c.verificationUri,h=c.userCode,(s=new URL(g)).searchParams.set("user_code",h),s.toString());"local-browser"===i?(e1(e.io,`Opening ${c.verificationUri}...
 `),await e0(v,e.io)):e1(e.io,`Open this URL on your machine:
 ${I}
@@ -7,10 +7,10 @@ Waiting for approval for 10 minutes...
 `);let y=await eZ({cloudBaseUrl:l,deviceCode:c.deviceCode,expiresIn:c.expiresIn,interval:c.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),A=y.cliSession?.refreshCredential??y.cliSession?.refreshToken;if(!e8(y.accessToken)||!e8(A))throw new f("UNAUTHORIZED","Device authorization did not return CLI credentials.");let _=new Date(e.io?.now?.()??Date.now()).toISOString(),S={version:1,id:y.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:l,workspaceId:y.cliSession?.workspaceId,accountId:y.cliSession?.accountId,name:y.cliSession?.name,refreshCredential:A,createdAt:_,expiresAt:y.cliSession?.expiresAt};return function(e){let n=eJ(e.stateDir);t.mkdirSync(r.dirname(n),{recursive:!0,mode:448}),t.writeFileSync(n,`${JSON.stringify(e.session,null,2)}
 `,{mode:384});try{t.chmodSync(n,384)}catch{}}({stateDir:e.stateDir,session:S}),{accessToken:y.accessToken,expiresAt:y.expiresAt,session:S}}function eq(e){let n=eJ(e.stateDir);if(!t.existsSync(n))return null;try{let e=JSON.parse(t.readFileSync(n,"utf8"));if(1!==e.version||!e8(e.id)||!e8(e.cloudBaseUrl)||!e8(e.refreshCredential)||!e8(e.createdAt))return null;return e}catch{return null}}function eJ(e){return r.join(e,"auth","cli-session.json")}async function ez(e){let t=eq({stateDir:e.stateDir});return!t||e3(t.expiresAt,e.io?.now)?null:{accessToken:(await eW({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:eQ(e.env,t.cloudBaseUrl)}}async function eW(e){let t=eQ(e.env,e.session.cloudBaseUrl),n=await eY({baseUrl:t,pathName:"/api/control-plane/cli-session/refresh",body:{refreshCredential:e.session.refreshCredential,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});if(e8(n.accessToken))return{accessToken:n.accessToken,expiresAt:n.expiresAt};if("revoked"===n.status||"revoked"===n.error)throw new f("UNAUTHORIZED","Stored cloud CLI session was revoked.",{hint:"Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.",status:n.status,error:n.error});throw new f("UNAUTHORIZED","Failed to refresh CLI session.",{hint:"Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.",status:n.status,error:n.error})}async function eZ(e){let t=e.now??Date.now,n=Math.min((e.expiresIn??600)*1e3,6e5),r=t()+n,o=Math.max(1e3,(e.interval??5)*1e3);for(;t()<r;){let t=await eY({baseUrl:e.cloudBaseUrl,pathName:"/api/control-plane/device-auth/poll",body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if("approved"===t.status||e8(t.accessToken))return t;if("slow_down"===t.status||"slow_down"===t.error)o+=1e3;else if("authorization_pending"!==t.status&&"authorization_pending"!==t.error)throw new f("UNAUTHORIZED","Device authorization was not approved.",{status:t.status,error:t.error});await e2(o)}throw new f("TIMEOUT","Device authorization expired before approval.")}async function eY(e){let t=e.fetchImpl??fetch,n=await t(new URL(e.pathName,e.baseUrl),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(e.body),signal:AbortSignal.timeout(15e3)});return await eV(n,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${n.status}).`,rejectedMessage:"Cloud auth endpoint rejected the request."})}function eX(e,t){let n=eQ(t);return new f("UNAUTHORIZED",`${e} cannot perform interactive login in CI or a non-interactive shell.`,{hint:`Create a service/API token: ${new URL("/api-keys",n).toString()} Then set AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...`})}function eQ(e,t){let n=e.AGENT_DEVICE_CLOUD_BASE_URL??t??"https://cloud.agent-device.dev";try{return new URL(n).toString().replace(/\/+$/,"")}catch(e){throw new f("INVALID_ARGS","Invalid AGENT_DEVICE_CLOUD_BASE_URL.",{cloudBaseUrl:n},e instanceof Error?e:void 0)}}async function e0(e,t){if(t?.openBrowser)return void await t.openBrowser(e);let n=process.platform;try{"darwin"===n?await A("open",[e],{allowFailure:!0,timeoutMs:5e3}):"win32"===n?await A("cmd",["/c","start","",e],{allowFailure:!0,timeoutMs:5e3}):await A("xdg-open",[e],{allowFailure:!0,timeoutMs:5e3})}catch{e1(t,`Open this URL on your machine:
 ${e}
-`)}}function e1(e,t){(e?.stderr??process.stderr).write(t)}function e3(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function e8(e){return"string"==typeof e&&e.trim().length>0}async function e2(e){await new Promise(t=>setTimeout(t,e))}async function e9(e){let o=await eH({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{env:e.env,fetch:e.fetchImpl}}),s=await e5({cloudBaseUrl:o.cloudBaseUrl,accessToken:o.accessToken,fetchImpl:e.fetchImpl}),a=function(e){try{return l(e)}catch(n){let t=d(n);throw new f("COMMAND_FAILED","Cloud connection profile returned invalid remote config.",{generatedConfigPath:e.configPath,cause:t.message},t)}}({configPath:function(e){var o;let s=function e(t){return Array.isArray(t)?t.map(e):t&&"object"==typeof t?Object.fromEntries(Object.entries(t).filter(([,e])=>void 0!==e).sort(([e],[t])=>e.localeCompare(t)).map(([t,n])=>[t,e(n)])):t}(e.profile),a=r.join(e.stateDir,"remote-connections","generated");t.mkdirSync(a,{recursive:!0,mode:448});let i=r.join(a,`cloud-${(o=s,n.createHash("sha256").update(JSON.stringify(o)).digest("hex").slice(0,16))}.json`);t.writeFileSync(i,`${JSON.stringify(s,null,2)}
+`)}}function e1(e,t){(e?.stderr??process.stderr).write(t)}function e3(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function e8(e){return"string"==typeof e&&e.trim().length>0}async function e2(e){await new Promise(t=>setTimeout(t,e))}async function e4(e){let o=await eH({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{env:e.env,fetch:e.fetchImpl}}),s=await e5({cloudBaseUrl:o.cloudBaseUrl,accessToken:o.accessToken,fetchImpl:e.fetchImpl}),a=function(e){try{return l(e)}catch(n){let t=d(n);throw new f("COMMAND_FAILED","Cloud connection profile returned invalid remote config.",{generatedConfigPath:e.configPath,cause:t.message},t)}}({configPath:function(e){var o;let s=function e(t){return Array.isArray(t)?t.map(e):t&&"object"==typeof t?Object.fromEntries(Object.entries(t).filter(([,e])=>void 0!==e).sort(([e],[t])=>e.localeCompare(t)).map(([t,n])=>[t,e(n)])):t}(e.profile),a=r.join(e.stateDir,"remote-connections","generated");t.mkdirSync(a,{recursive:!0,mode:448});let i=r.join(a,`cloud-${(o=s,n.createHash("sha256").update(JSON.stringify(o)).digest("hex").slice(0,16))}.json`);t.writeFileSync(i,`${JSON.stringify(s,null,2)}
 `,{mode:384});try{t.chmodSync(i,384)}catch{}return i}({stateDir:e.stateDir,profile:s}),cwd:e.cwd,env:e.env});return{flags:{...eU(a.profile),...e.flags,remoteConfig:a.resolvedPath,daemonAuthToken:o.accessToken},remoteConfigPath:a.resolvedPath}}async function e5(e){let t=e.fetchImpl??fetch,n=await t(new URL("/api/control-plane/connection-profile",e.cloudBaseUrl),{method:"GET",headers:{authorization:`Bearer ${e.accessToken}`},signal:AbortSignal.timeout(15e3)});var r=await eV(n,{invalidJsonMessage:`Cloud connection profile endpoint returned invalid JSON (${n.status}).`,rejectedMessage:"Cloud connection profile endpoint rejected the request."});if(!r||"object"!=typeof r||Array.isArray(r))throw new f("COMMAND_FAILED","Cloud connection profile response is invalid.");let o=r.connection;if(!o||"object"!=typeof o)throw new f("COMMAND_FAILED","Cloud connection profile response is missing profile.");if(void 0!==o.remoteConfigProfile){var s=o.remoteConfigProfile;if(!s||"object"!=typeof s||Array.isArray(s))throw new f("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is invalid.");if(0===Object.keys(s).length)throw new f("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is empty.");return s}throw new f("COMMAND_FAILED","Cloud connection profile did not include remoteConfigProfile.")}function e6(e,t,n){var r;if(e.json)return void D({success:!0,data:t});let o=n?.();o&&(r=o,process.stdout.write(r.endsWith("\n")?r:`${r}
-`))}let e4=async({flags:e,client:t})=>{var r,o,s,a;let i=v(e.stateDir).baseDir,c=e.remoteConfig?function(e){if(!e.remoteConfig)throw new f("INVALID_ARGS","connect requires --remote-config <path>.");let t=l({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env});return{flags:e,remoteConfigPath:t.resolvedPath}}(e):await e9({flags:e,stateDir:i,cwd:process.cwd(),env:process.env}),d=c.flags,u=d.tenant,m=d.runId;if(!u)throw new f("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!m)throw new f("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!d.daemonBaseUrl)throw new f("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let p=d.session?null:eS({stateDir:i}),g=d.session??p?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${n.randomBytes(3).toString("hex")}`;if(!eh({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${n.randomBytes(2).toString("hex")}`}(i),h=ey(c.remoteConfigPath),w=ev(d),I=p?.session===g?p:eh({stateDir:i,session:g});if(I&&(r=I,o={flags:d,session:g,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:h,desiredLeaseBackend:ex(d),daemon:w},r.remoteConfigPath!==o.remoteConfigPath||r.remoteConfigHash!==o.remoteConfigHash||r.session!==o.session||r.tenant!==o.flags.tenant||r.runId!==o.flags.runId||void 0!==o.desiredLeaseBackend&&r.leaseBackend!==o.desiredLeaseBackend||void 0!==o.flags.platform&&r.platform!==o.flags.platform||void 0!==o.flags.target&&r.target!==o.flags.target||(s=r.daemon,a=o.daemon,(s?.baseUrl??void 0)!==(a?.baseUrl??void 0)||(s?.transport??void 0)!==(a?.transport??void 0)||(s?.serverMode??void 0)!==(a?.serverMode??void 0)))&&!d.force)throw new f("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:g,remoteConfig:I.remoteConfigPath});let y=new Date().toISOString(),A={version:1,session:g,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:h,daemon:w,tenant:u,runId:m,leaseId:I&&!d.force?I.leaseId:void 0,leaseBackend:I&&!d.force?I.leaseBackend:ex(d),platform:d.platform??(I&&!d.force?I.platform:void 0),target:d.target??(I&&!d.force?I.target:void 0),runtime:I&&!d.force?I.runtime:void 0,metro:I&&!d.force?I.metro:void 0,connectedAt:I&&!d.force?I.connectedAt:y,updatedAt:y};ew({stateDir:i,state:A}),I&&d.force&&(await eT(I.metro),await eL({stateDir:i,state:I}),await eB(t,I));let _=tr(A),S=function(e,t){if(!t.runtime&&(eM(e)||ts(t.remoteConfigPath)))return to(t.remoteConfigPath)}(d,A);return e6(d,ta(A,S),()=>[`Connected remote session "${g}" tenant "${u}" run "${m}" ${A.leaseId?`lease ${A.leaseId}`:"lease pending"}`,_?.message,S?.message].filter(e=>!!e).join("\n")),!0},e7=async({flags:e,client:t})=>{let{session:n,stateDir:r,state:o}=tt(e);if(!o)return tn(e,n),!0;let s=o.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await eT(o.metro),await eL({stateDir:r,state:o});let a=!1;if(o.leaseId)try{a=(await t.leases.release({tenant:o.tenant,runId:o.runId,leaseId:o.leaseId})).released}catch{}return eI({stateDir:r,session:s}),e6(e,{connected:!1,session:s,released:a},()=>`Disconnected remote session "${s}".`),!0},te=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new f("INVALID_ARGS","connection accepts only: status");let{session:n,state:r}=tt(t);if(!r)return tn(t,n),!0;let o=tr(r),s=function(e){if(!e.runtime&&ts(e.remoteConfigPath))return to(e.remoteConfigPath)}(r);return e6(t,ta(r,s),()=>[`Connected remote session "${r.session}".`,`tenant=${r.tenant} runId=${r.runId} leaseId=${r.leaseId??"pending"} backend=${r.leaseBackend??"pending"}`,`remoteConfig=${r.remoteConfigPath}`,r.runtime?"metro=prepared":"metro=not-prepared",o?.message,s?.message].filter(e=>!!e).join("\n")),!0};function tt(e){let t=e.session??"default",n=v(e.stateDir).baseDir;return{session:t,stateDir:n,state:eh({stateDir:n,session:t})??(e.session?null:eS({stateDir:n}))}}function tn(e,t){e6(e,{connected:!1,session:t},()=>`No remote connection for "${t}".`)}function tr(e){if(!e.leaseId)return{status:"deferred",nextSteps:["agent-device install-from-source <artifact-url> --platform ios|android","agent-device open <app-id> --relaunch","agent-device snapshot -i","agent-device devices"],message:"Lease allocation is pending; run install-from-source, open, snapshot, or devices when ready to allocate or refresh the lease."+(void 0===e.platform&&void 0===e.leaseBackend?" Add --platform ios|android if the profile does not set a platform.":"")}}function to(e){let t=`agent-device metro prepare --remote-config ${e}`;return{status:"deferred",nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function ts(e){try{let t=l({configPath:e,cwd:process.cwd(),env:process.env}).profile;return!!(t.metroPublicBaseUrl||t.metroProxyBaseUrl||t.metroProjectRoot||t.metroKind)}catch{return!1}}function ta(e,t){let r=tr(e);return{connected:!0,session:e.session,tenant:e.tenant,runId:e.runId,leaseAllocated:!!e.leaseId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,platform:e.platform,target:e.target,remoteConfig:e.remoteConfigPath,remoteConfigHash:e.remoteConfigHash,daemonBaseUrlFingerprint:function(e){if(e)return n.createHash("sha256").update(e).digest("hex").slice(0,12)}(e.daemon?.baseUrl),metro:e.metro?{prepared:!0,projectRoot:e.metro.projectRoot}:{prepared:!1},...r?{leasePreparation:r}:{},...t?{runtimePreparation:t}:{},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let ti=async({positionals:e,flags:n})=>{let r=e[0]??"status",o=v(n.stateDir).baseDir;if("status"===r){var s;let e,t=(e=eq({stateDir:(s={stateDir:o}).stateDir}))?{authenticated:!0,source:"cli-session",sessionId:e.id,cloudBaseUrl:e.cloudBaseUrl,workspaceId:e.workspaceId,accountId:e.accountId,name:e.name,createdAt:e.createdAt,expiresAt:e.expiresAt,expired:e3(e.expiresAt,s.now)}:{authenticated:!1,source:"none"};return e6(n,t,()=>{var e;return(e=t).authenticated?["Authenticated with cloud CLI session.",`cloud=${e.cloudBaseUrl}`,`session=${e.sessionId}`,e.workspaceId?`workspace=${e.workspaceId}`:null,e.accountId?`account=${e.accountId}`:null,e.expiresAt?`expiresAt=${e.expiresAt}`:null,e.expired?"status=expired":null].filter(e=>!!e).join("\n"):"Not authenticated."}),!0}if("login"===r){let e=await eF({stateDir:o,flags:n,commandLabel:"agent-device auth login"});return e6(n,{authenticated:!0,source:"cli-session",sessionId:e.session.id,cloudBaseUrl:e.session.cloudBaseUrl,workspaceId:e.session.workspaceId,accountId:e.session.accountId,expiresAt:e.session.expiresAt,agentTokenExpiresAt:e.expiresAt},()=>"Authenticated with cloud CLI session."),!0}if("logout"===r){let e,r=(e=eJ({stateDir:o}.stateDir),!!t.existsSync(e)&&(t.rmSync(e,{force:!0}),!0));return e6(n,{authenticated:!1,removed:r},()=>r?"Removed stored cloud CLI session.":"No stored cloud CLI session."),!0}throw new f("INVALID_ARGS","auth accepts only: status, login, logout")},tl=new Set(["id","text","label"]),tc=new Set(["enabled","selected"]),td={open:function(e){var t,n,r;let o,s,a,[i,l]=e.positionals;if(!i)return{kind:"unsupported",message:"open requires an app id or URL"};if(tI(i))return{kind:"commands",commands:[{openLink:i}]};let c=(t=e,n=i,(a=(r=t,o=r.flags?.launchArgs,s={},r.flags?.relaunch===!0&&(s.stopApp=!0),r.flags?.clearAppState===!0&&(s.clearState=!0),Array.isArray(o)&&o.length>0&&(s.launchArguments=o),Object.keys(s).length>0?s:void 0))?{launchApp:{appId:n,...a}}:"launchApp");return l&&tI(l)?{kind:"config",appId:i,commands:[c,{openLink:l}]}:l?{kind:"unsupported",message:"open with a non-URL second argument is unsupported"}:{kind:"config",appId:i,commands:[c]}},click:tu,press:tu,longpress:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"longpress requires a target"};let r=tp(t,n);return r?{kind:"commands",commands:[{longPressOn:r}],warnings:(function(e){let[t,n,r]=e.positionals,o=ty(t)&&ty(n)?r:n;return o&&ty(o)?[Number(o)]:[]})(e).map(tf)}:{kind:"unsupported",message:"longpress target is not Maestro-compatible"}},fill:function(e){let[t,n]=e.positionals;if(!t||void 0===n)return{kind:"unsupported",message:"fill requires a target and text"};let r=tp(t);return r?{kind:"commands",commands:[{tapOn:r},{inputText:n}],warnings:["fill exports as tapOn + inputText; Maestro may append text instead of replacing existing field contents"]}:{kind:"unsupported",message:"fill target is not Maestro-compatible"}},type:function(e){var t;let[n]=e.positionals;if(void 0===n)return{kind:"unsupported",message:"type requires text"};let r=0!==(t=n).length&&[...t].every(e=>"\b"===e)?t.length:null;return null!==r?{kind:"commands",commands:[{eraseText:r}]}:{kind:"commands",commands:[{inputText:n}]}},keyboard:function(e){let[t]=e.positionals;return"dismiss"===t?{kind:"commands",commands:["hideKeyboard"]}:"enter"===t||"return"===t?{kind:"commands",commands:[{pressKey:"Enter"}]}:{kind:"unsupported",message:`keyboard ${t??""}`.trim()}},back:()=>({kind:"commands",commands:["back"]}),wait:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"wait requires a target or duration"};if(ty(t))return{kind:"commands",commands:[{waitForAnimationToEnd:{timeout:Number(t)}}],warnings:["wait <ms> exports as waitForAnimationToEnd and may return before the full duration"]};if("text"===t&&n)return{kind:"commands",commands:[{extendedWaitUntil:{visible:n,timeout:tw(e,17e3)}}]};let r=tg(t);return r?{kind:"commands",commands:[{extendedWaitUntil:{visible:r,timeout:tw(e,17e3)}}]}:{kind:"unsupported",message:"wait selector is not Maestro-compatible"}},find:function(e){let[t,n,r]=e.positionals;return"text"===t&&n&&r?"exists"===r?{kind:"commands",commands:[{assertVisible:n}]}:"missing"===r||"not-exists"===r?{kind:"commands",commands:[{assertNotVisible:n}]}:{kind:"unsupported",message:`find text assertion "${r}" is unsupported`}:{kind:"unsupported",message:"only find text <query> exists|missing exports to Maestro"}},screenshot:function(e){let[t]=e.positionals;return t?{kind:"commands",commands:[{takeScreenshot:t}]}:{kind:"unsupported",message:"screenshot requires an output path"}},scroll:function(e){let[t]=e.positionals;return t&&"down"!==t?{kind:"unsupported",message:`scroll ${t} is not exported yet`}:{kind:"commands",commands:["scroll"]}},swipe:function(e){var t,n;let r,o=function(e){let[t,n,r,o,s]=e.positionals;if(ty(t)&&ty(n)&&ty(r)&&ty(o))return{start:R(t,n),end:R(r,o),...s&&ty(s)?{duration:Number(s)}:{}}}(e);if(!o)return{kind:"unsupported",message:"only coordinate swipe exports to Maestro"};let s=(t=e,Number.isInteger(r=t.flags?.count??1)&&r>=1?r:null);if(null===s)return{kind:"unsupported",message:"swipe count must be a positive integer"};let a=(n=e,n.flags?.pauseMs!==void 0?"swipe --pause-ms has no Maestro equivalent":n.flags?.pattern&&"one-way"!==n.flags.pattern?"swipe ping-pong pattern has no Maestro equivalent":void 0);return a?{kind:"unsupported",message:a}:{kind:"commands",commands:Array.from({length:s},()=>({swipe:o}))}}};function tu(e){var t,n,r,o,s;let a,i,[l,c]=e.positionals;if(!l)return{kind:"unsupported",message:`${e.command} requires a target`};let d=tp(l,c);if(!d)return{kind:"unsupported",message:"tap target is not Maestro-compatible"};let u=(a=(n=t=e,n.flags?.jitterPx!==void 0?"tap --jitter-px has no Maestro equivalent":n.flags?.clickButton&&"primary"!==n.flags.clickButton?`tap --button ${n.flags.clickButton} has no Maestro equivalent`:void 0))?{ok:!1,message:a}:{ok:!0,options:(r=t,i={},"number"==typeof r.flags?.count&&r.flags.count>1&&(i.repeat=r.flags.count),"number"==typeof r.flags?.intervalMs&&r.flags.intervalMs>0&&(i.delay=r.flags.intervalMs),i)};return u.ok?e.flags?.doubleTap===!0?{kind:"commands",commands:[{doubleTapOn:d}],warnings:tm(e,"doubleTapOn")}:"number"==typeof e.flags?.holdMs?{kind:"commands",commands:[{longPressOn:d}],warnings:[tf(e.flags.holdMs),...tm(e,"longPressOn")]}:{kind:"commands",commands:[(o=d,0===Object.keys(s=u.options).length?{tapOn:o}:"string"==typeof o?{tapOn:{text:o,...s}}:o&&"object"==typeof o&&!Array.isArray(o)?{tapOn:{...o,...s}}:{tapOn:o})]}:{kind:"unsupported",message:u.message}}function tf(e){return`long-press duration exports as Maestro longPressOn; Maestro uses its default long-press duration instead of ${e}ms`}function tm(e,t){let n=[];return"number"==typeof e.flags?.count&&e.flags.count>1&&n.push(`tap --count ${e.flags.count} is not represented by Maestro ${t}`),"number"==typeof e.flags?.intervalMs&&e.flags.intervalMs>0&&n.push(`tap --interval-ms ${e.flags.intervalMs} is not represented by Maestro ${t}`),n}function tp(e,t){return ty(e)&&ty(t)?{point:R(e,t)}:e.startsWith("@")?null:tg(e)}function tg(e){let t;try{t=N(e)}catch{return e.includes("=")||e.includes("||")?null:e}let n=function(e){if(e.length<=1)return null;let t=e.flatMap(e=>1===e.terms.length&&tl.has(e.terms[0].key)?[e.terms[0].value]:[]);if(t.length!==e.length||0===t.length)return null;let n=t[0];return"string"!=typeof n?null:t.every(e=>e===n)?n:null}(t.selectors);return null!==n?n:1!==t.selectors.length?null:function(e){let t={};for(let o of e.terms){var n,r;if(n=t,r=o,tl.has(r.key)?"string"!=typeof r.value||!!n.id||!!n.text||!!n.label||(n[r.key]=r.value,!!0):!tc.has(r.key)||"boolean"!=typeof r.value||(n[r.key]=r.value,!!0))return null}return Object.keys(t).length>0?t:null}(t.selectors[0])}function th(e,t,n,r){for(let o of t??[])e.warnings.push({line:r,action:tv(n),message:o})}function tw(e,t){let n=e.positionals.at(-1);return n&&ty(n)?Number(n):t}function tv(e){return[e.command,...e.positionals??[]].join(" ").trim()}function tI(e){return/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(e)}function ty(e){return void 0!==e&&Number.isFinite(Number(e))}let tA=async e=>{let{positionals:t}=e;return"export"!==t[0]?function({positionals:e,flags:t}){if(e.length>1)throw new f("INVALID_ARGS","replay accepts exactly one input path: replay <path>");if(void 0!==t.replayExportFormat||void 0!==t.out)throw new f("INVALID_ARGS","replay --format/--out are only supported with replay export.");return!1}(e):await t_(e)};async function t_({positionals:e,flags:n}){let o;var s,a=e,i=n;if(a.length>2)throw new f("INVALID_ARGS","replay export accepts exactly one input path: replay export <file.ad>");if(i.replayUpdate)throw new f("INVALID_ARGS","replay export does not support --update.");if(i.replayMaestro)throw new f("INVALID_ARGS","replay export reads .ad files; omit --maestro.");if(i.replayEnv?.length)throw new f("INVALID_ARGS","replay export does not evaluate --env substitutions.");let l=i.replayExportFormat??"maestro";if("maestro"!==l)throw new f("INVALID_ARGS",`Unsupported replay export format: ${l}`);let c=e[1];if(!c)throw new f("INVALID_ARGS","replay export requires an input path.");let d=P(c),u=function(e,t={}){var n,r,o,s;let a={config:(n=t.metadata,n?.env&&Object.keys(n.env).length>0?{env:n.env}:{}),warnings:[],unsupported:[]},i=[];for(let[n,o]of e.entries()){let e=t.actionLines?.[n]??n+1,s=(r=o,td[r.command]?.(r)??{kind:"unsupported",message:`${r.command} has no Maestro equivalent`});switch(s.kind){case"commands":i.push(...s.commands),th(a,s.warnings,o,e);break;case"config":(function(e,t,n,r){if(!e.config.appId){e.config.appId=t;return}e.config.appId!==t&&e.unsupported.push({line:r,action:tv(n),message:`multiple app ids cannot be represented in one Maestro config (${e.config.appId} vs ${t})`})})(a,s.appId,o,e),i.push(...s.commands),th(a,s.warnings,o,e);break;case"unsupported":a.unsupported.push({line:e,action:tv(o),message:s.message})}}if(a.unsupported.length>0)throw new f("INVALID_ARGS",`Cannot export replay to Maestro YAML: unsupported .ad action ${a.unsupported.map(e=>`line ${e.line} (${e.action}): ${e.message}`).join("; ")}.`,{unsupported:a.unsupported});return{yaml:(o=a.config,s=i,U(Object.keys(o).length>0?[o,s]:[s])),warnings:a.warnings}}((o=b(s=t.readFileSync(d,"utf8"))).actions,{actionLines:o.actionLines,metadata:E(s)}),m="string"==typeof n.out?P(n.out):void 0;for(let e of(m&&(t.mkdirSync(r.dirname(m),{recursive:!0}),t.writeFileSync(m,u.yaml)),u.warnings))process.stderr.write(`Warning: line ${e.line}: ${e.message}
-`);return e6(n,{format:n.replayExportFormat??"maestro",sourcePath:d,...m?{path:m}:{yaml:u.yaml},warnings:u.warnings},()=>m??u.yaml),!0}let tS={...O,...L,...B,...V,...H,...$,...q,...W,...j,...K,...x,...F,...z,...M};async function tC(e){return(await tD(e)).result}async function tD(e){var t,n,r;let o=(t=e.command,n=e.positionals,r=e.flags,tS[t](n,r)),s=await Z(e.client,e.command,o);return{result:s,cliOutput:k({name:e.command,input:o,result:s})}}let tk={connect:e4,disconnect:e7,connection:te,auth:ti,replay:tA,screenshot:async({positionals:e,flags:t,client:n})=>{let r=await tC({client:n,command:"screenshot",positionals:e,flags:t});return e6(t,{path:r.path,...r.overlayRefs?{overlayRefs:r.overlayRefs}:{}},()=>r.overlayRefs?`Annotated ${r.overlayRefs.length} refs onto ${r.path}`:r.path),!0},diff:async({positionals:e,flags:t,client:n})=>{var r;if("snapshot"===e[0]){let r=await tC({client:n,command:"diff",positionals:e,flags:t});return e6(t,r,()=>_(r)),!0}if("screenshot"!==e[0])return!1;let o=t.baseline;if(!o||"string"!=typeof o)throw new f("INVALID_ARGS","diff screenshot requires --baseline <path>");let s=P(o),a="string"==typeof t.out?P(t.out):void 0,i=e[1];if(e.length>2)throw new f("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let l=Q({backend:(r=n,{platform:function(e){switch(e.platform){case"android":case"linux":case"macos":return e.platform;default:return"ios"}}(t),captureScreenshot:async(e,t,n)=>{let o=await r.capture.screenshot({path:t,session:e.session,overlayRefs:n?.overlayRefs,fullscreen:n?.fullscreen,stabilize:n?.stabilize,surface:n?.surface});return{path:o.path,...o.overlayRefs?{overlayRefs:o.overlayRefs}:{}}}}),artifacts:Y(),sessions:{get:e=>({name:e}),set:()=>{}},policy:X()}),c=await l.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:s},current:i?{kind:"path",path:P(i)}:{kind:"live"},...a?{out:{kind:"path",path:a}}:{},threshold:function(e){if(null!=e&&""!==e)return Number(e)}(t.threshold),overlayRefs:t.overlayRefs,surface:t.surface});return e6(t,c,()=>S(c)),!0}};async function tN(e){let t={...e.flags},n=tk[e.command];return!!(n&&await n({...e,flags:t}))||!!ee(e.command)&&await tU({...e,command:e.command,flags:t})}async function tU(e){let{runGenericClientBackedCommand:t}=await import("./generic.js");return await t(e)}function tb(e,t,n){return n||(e.push(t),"")}async function tR(e,t,n){let{flags:r}=t,o=function(e){var t;if(!e?.metroProxyBaseUrl||"android-instance"!==(t=e.leaseBackend)&&"ios-instance"!==t)return null;let n=[],r={serverBaseUrl:tb(n,"metroProxyBaseUrl",e.metroProxyBaseUrl),bearerToken:tb(n,"metroBearerToken",e.metroBearerToken),tenantId:tb(n,"tenant",e.tenant),runId:tb(n,"runId",e.runId),leaseId:tb(n,"leaseId",e.leaseId)};if(n.length>0)throw new f("INVALID_ARGS",`react-devtools remote bridge requires ${n.join(", ")}.`,{missing:n});return r}(r);if(!o)return n();let s=t.stateDir??process.cwd(),a=t.session??r?.session??"default",i=r?.remoteConfig??`${o.tenantId}:${o.runId}:${o.leaseId}`;if("stop"===e[0])try{return await n()}finally{await eg({projectRoot:t.cwd??process.cwd(),stateDir:s,profileKey:i,consumerKey:a})}return await ep({projectRoot:t.cwd??process.cwd(),stateDir:s,serverBaseUrl:o.serverBaseUrl,bearerToken:o.bearerToken,bridgeScope:{tenantId:o.tenantId,runId:o.runId,leaseId:o.leaseId},session:a,profileKey:i,consumerKey:a,env:t.env??process.env}),await n()}async function tE(e,t={}){let n=t.cwd??process.cwd(),r=t.env??process.env,o=await tR(e,t,async()=>(await y("npm",["exec","--yes","--package","agent-react-devtools@0.4.0","--","agent-react-devtools",...e],{cwd:n,env:r,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode);var s,a=t.flags;return 0!==o&&"wait"===(s=e)[0]&&s.includes("--connected")&&"ios-instance"===a?.leaseBackend&&process.stderr.write("Hint: Remote iOS React DevTools connects during JavaScript startup.\nIf the app was already open before `agent-device react-devtools start`, relaunch it with `agent-device open <bundle-id> --platform ios --relaunch`, then retry `agent-device react-devtools wait --connected`.\n"),o}function tP(e,t={}){let n=tT(t),r={...e};return n.defaultPlatform&&void 0===r.platform&&(r.platform=n.defaultPlatform),r}function tT(e){var t,n,r,o;let s,a=e.env??process.env,i=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new f("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(a.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??a.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:i,lockPolicy:(n=e.policyOverrides,r=a,o=l,(s=n?.sessionLock??n?.sessionLockConflicts??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new f("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}(r.AGENT_DEVICE_SESSION_LOCK))||(n?.sessionLocked===!0||o?"reject":void 0))}}let tL={sendToDaemon:eu},tB=new Set(["launchUrl","kind","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),tx=new Set(["connect","connection","close","disconnect","metro","session"]);async function tM(e,n=tL){let o=m(),s=ec(),a=function(e){try{let t=ea(e);return tO(t.command??"",t.providedFlags)}catch{return e.includes("--debug")||e.includes("-v")||e.includes("--verbose")}}(e),i=e.includes("--json"),I=function(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n.startsWith("--session=")){let e=n.slice(10).trim();return e.length>0?e:null}if("--session"===n){let n=e[t+1]?.trim();if(n&&!n.startsWith("-"))return n;break}}return null}(e)??process.env.AGENT_DEVICE_SESSION??"default";await p({session:I,requestId:o,command:e[0],debug:a},async()=>{var m,p,I,y,A,_,S,k,N,U,b,R,E,L,B,x,M;let O,$,V,j,K,H,F;try{let n,o,s,a,i,c,d,u;m={cwd:process.cwd(),env:process.env},n=ea(e),o=m?.env??process.env,s=m?.cwd??process.cwd(),y=n.command,a=null!==y&&(p={remoteConfig:n.flags.remoteConfig,cwd:s,env:o}).remoteConfig?{...eU(l({configPath:p.remoteConfig,cwd:p.cwd,env:p.env}).profile),remoteConfig:p.remoteConfig}:{},d=et((i=(I={command:n.command,cwd:s,cliFlags:n.flags,env:o}).env??process.env,c=et({},function(e){let n={};for(let r of e)et(n,function(e,n){let r,o;if(!t.existsSync(e)){if(n)throw new f("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=t.readFileSync(e,"utf8")}catch(t){throw new f("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{o=JSON.parse(r)}catch(t){throw new f("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!o||"object"!=typeof o||Array.isArray(o))throw new f("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let n={};for(let[r,o]of Object.entries(e)){if("installSource"===r){n.installSource=G(o,t);continue}let e=eo(r);if(!e)throw new f("INVALID_ARGS",`Unknown config key "${r}" in ${t}.`);if(!e.config.enabled)throw new f("INVALID_ARGS",`Unsupported config key "${r}" in ${t}.`);n[r]=en(e,o,t,r)}return n}(o,`config file ${e}`)}(r.path,r.required));return n}((A=I.cwd,_=I.cliFlags.config,S=i,(u=_??S.AGENT_DEVICE_CONFIG)?[{path:(k=u,N=A,U=S,P(k,{cwd:N,env:U})),required:!0}]:[{path:(b=S,r.join(T("~",{env:b}),".agent-device","config.json")),required:!1},{path:r.resolve(A,"agent-device.json"),required:!1}]))),et(c,function(e,t){let n={};for(let r of er(t)){if("installSource"===r.key)continue;let t=r.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(n[r.key]=en(r,t.value,`environment variable ${t.name}`,t.name))}return n}(i,I.command))),a),O={...el(n,{strictFlags:m?.strictFlags,defaultFlags:d}),providedFlags:n.providedFlags}}catch(t){w({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=u(t,{diagnosticId:g().diagnosticId,logPath:h({force:!0})??void 0});i?D({success:!1,error:e}):C(e,{showDetails:a}),process.exit(1);return}for(let e of O.warnings)process.stderr.write(`Warning: ${e}
+`))}let e9=async({flags:e,client:t})=>{var r,o,s,a;let i=v(e.stateDir).baseDir,c=e.remoteConfig?function(e){if(!e.remoteConfig)throw new f("INVALID_ARGS","connect requires --remote-config <path>.");let t=l({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env});return{flags:e,remoteConfigPath:t.resolvedPath}}(e):await e4({flags:e,stateDir:i,cwd:process.cwd(),env:process.env}),d=c.flags,u=d.tenant,m=d.runId;if(!u)throw new f("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!m)throw new f("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!d.daemonBaseUrl)throw new f("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let p=d.session?null:eS({stateDir:i}),g=d.session??p?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${n.randomBytes(3).toString("hex")}`;if(!eh({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${n.randomBytes(2).toString("hex")}`}(i),h=ey(c.remoteConfigPath),w=ev(d),I=p?.session===g?p:eh({stateDir:i,session:g});if(I&&(r=I,o={flags:d,session:g,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:h,desiredLeaseBackend:ex(d),daemon:w},r.remoteConfigPath!==o.remoteConfigPath||r.remoteConfigHash!==o.remoteConfigHash||r.session!==o.session||r.tenant!==o.flags.tenant||r.runId!==o.flags.runId||void 0!==o.desiredLeaseBackend&&r.leaseBackend!==o.desiredLeaseBackend||void 0!==o.flags.platform&&r.platform!==o.flags.platform||void 0!==o.flags.target&&r.target!==o.flags.target||(s=r.daemon,a=o.daemon,(s?.baseUrl??void 0)!==(a?.baseUrl??void 0)||(s?.transport??void 0)!==(a?.transport??void 0)||(s?.serverMode??void 0)!==(a?.serverMode??void 0)))&&!d.force)throw new f("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:g,remoteConfig:I.remoteConfigPath});let y=new Date().toISOString(),A={version:1,session:g,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:h,daemon:w,tenant:u,runId:m,leaseId:I&&!d.force?I.leaseId:void 0,leaseBackend:I&&!d.force?I.leaseBackend:ex(d),platform:d.platform??(I&&!d.force?I.platform:void 0),target:d.target??(I&&!d.force?I.target:void 0),runtime:I&&!d.force?I.runtime:void 0,metro:I&&!d.force?I.metro:void 0,connectedAt:I&&!d.force?I.connectedAt:y,updatedAt:y};ew({stateDir:i,state:A}),I&&d.force&&(await eT(I.metro),await eL({stateDir:i,state:I}),await eB(t,I));let _=tr(A),S=function(e,t){if(!t.runtime&&(eM(e)||ts(t.remoteConfigPath)))return to(t.remoteConfigPath)}(d,A);return e6(d,ta(A,S),()=>[`Connected remote session "${g}" tenant "${u}" run "${m}" ${A.leaseId?`lease ${A.leaseId}`:"lease pending"}`,_?.message,S?.message].filter(e=>!!e).join("\n")),!0},e7=async({flags:e,client:t})=>{let{session:n,stateDir:r,state:o}=tt(e);if(!o)return tn(e,n),!0;let s=o.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await eT(o.metro),await eL({stateDir:r,state:o});let a=!1;if(o.leaseId)try{a=(await t.leases.release({tenant:o.tenant,runId:o.runId,leaseId:o.leaseId})).released}catch{}return eI({stateDir:r,session:s}),e6(e,{connected:!1,session:s,released:a},()=>`Disconnected remote session "${s}".`),!0},te=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new f("INVALID_ARGS","connection accepts only: status");let{session:n,state:r}=tt(t);if(!r)return tn(t,n),!0;let o=tr(r),s=function(e){if(!e.runtime&&ts(e.remoteConfigPath))return to(e.remoteConfigPath)}(r);return e6(t,ta(r,s),()=>[`Connected remote session "${r.session}".`,`tenant=${r.tenant} runId=${r.runId} leaseId=${r.leaseId??"pending"} backend=${r.leaseBackend??"pending"}`,`remoteConfig=${r.remoteConfigPath}`,r.runtime?"metro=prepared":"metro=not-prepared",o?.message,s?.message].filter(e=>!!e).join("\n")),!0};function tt(e){let t=e.session??"default",n=v(e.stateDir).baseDir;return{session:t,stateDir:n,state:eh({stateDir:n,session:t})??(e.session?null:eS({stateDir:n}))}}function tn(e,t){e6(e,{connected:!1,session:t},()=>`No remote connection for "${t}".`)}function tr(e){if(!e.leaseId)return{status:"deferred",nextSteps:["agent-device install-from-source <artifact-url> --platform ios|android","agent-device open <app-id> --relaunch","agent-device snapshot -i","agent-device devices"],message:"Lease allocation is pending; run install-from-source, open, snapshot, or devices when ready to allocate or refresh the lease."+(void 0===e.platform&&void 0===e.leaseBackend?" Add --platform ios|android if the profile does not set a platform.":"")}}function to(e){let t=`agent-device metro prepare --remote-config ${e}`;return{status:"deferred",nextStep:t,message:`Metro runtime is not prepared yet; it will be prepared automatically on first open, or run "${t}" to inspect it before launch.`}}function ts(e){try{let t=l({configPath:e,cwd:process.cwd(),env:process.env}).profile;return!!(t.metroPublicBaseUrl||t.metroProxyBaseUrl||t.metroProjectRoot||t.metroKind)}catch{return!1}}function ta(e,t){let r=tr(e);return{connected:!0,session:e.session,tenant:e.tenant,runId:e.runId,leaseAllocated:!!e.leaseId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,platform:e.platform,target:e.target,remoteConfig:e.remoteConfigPath,remoteConfigHash:e.remoteConfigHash,daemonBaseUrlFingerprint:function(e){if(e)return n.createHash("sha256").update(e).digest("hex").slice(0,12)}(e.daemon?.baseUrl),metro:e.metro?{prepared:!0,projectRoot:e.metro.projectRoot}:{prepared:!1},...r?{leasePreparation:r}:{},...t?{runtimePreparation:t}:{},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let ti=async({positionals:e,flags:n})=>{let r=e[0]??"status",o=v(n.stateDir).baseDir;if("status"===r){var s;let e,t=(e=eq({stateDir:(s={stateDir:o}).stateDir}))?{authenticated:!0,source:"cli-session",sessionId:e.id,cloudBaseUrl:e.cloudBaseUrl,workspaceId:e.workspaceId,accountId:e.accountId,name:e.name,createdAt:e.createdAt,expiresAt:e.expiresAt,expired:e3(e.expiresAt,s.now)}:{authenticated:!1,source:"none"};return e6(n,t,()=>{var e;return(e=t).authenticated?["Authenticated with cloud CLI session.",`cloud=${e.cloudBaseUrl}`,`session=${e.sessionId}`,e.workspaceId?`workspace=${e.workspaceId}`:null,e.accountId?`account=${e.accountId}`:null,e.expiresAt?`expiresAt=${e.expiresAt}`:null,e.expired?"status=expired":null].filter(e=>!!e).join("\n"):"Not authenticated."}),!0}if("login"===r){let e=await eF({stateDir:o,flags:n,commandLabel:"agent-device auth login"});return e6(n,{authenticated:!0,source:"cli-session",sessionId:e.session.id,cloudBaseUrl:e.session.cloudBaseUrl,workspaceId:e.session.workspaceId,accountId:e.session.accountId,expiresAt:e.session.expiresAt,agentTokenExpiresAt:e.expiresAt},()=>"Authenticated with cloud CLI session."),!0}if("logout"===r){let e,r=(e=eJ({stateDir:o}.stateDir),!!t.existsSync(e)&&(t.rmSync(e,{force:!0}),!0));return e6(n,{authenticated:!1,removed:r},()=>r?"Removed stored cloud CLI session.":"No stored cloud CLI session."),!0}throw new f("INVALID_ARGS","auth accepts only: status, login, logout")},tl=new Set(["id","text","label"]),tc=new Set(["enabled","selected"]),td={open:function(e){var t,n,r;let o,s,a,[i,l]=e.positionals;if(!i)return{kind:"unsupported",message:"open requires an app id or URL"};if(tI(i))return{kind:"commands",commands:[{openLink:i}]};let c=(t=e,n=i,(a=(r=t,o=r.flags?.launchArgs,s={},r.flags?.relaunch===!0&&(s.stopApp=!0),r.flags?.clearAppState===!0&&(s.clearState=!0),Array.isArray(o)&&o.length>0&&(s.launchArguments=o),Object.keys(s).length>0?s:void 0))?{launchApp:{appId:n,...a}}:"launchApp");return l&&tI(l)?{kind:"config",appId:i,commands:[c,{openLink:l}]}:l?{kind:"unsupported",message:"open with a non-URL second argument is unsupported"}:{kind:"config",appId:i,commands:[c]}},click:tu,press:tu,longpress:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"longpress requires a target"};let r=tp(t,n);return r?{kind:"commands",commands:[{longPressOn:r}],warnings:(function(e){let[t,n,r]=e.positionals,o=ty(t)&&ty(n)?r:n;return o&&ty(o)?[Number(o)]:[]})(e).map(tf)}:{kind:"unsupported",message:"longpress target is not Maestro-compatible"}},fill:function(e){let[t,n]=e.positionals;if(!t||void 0===n)return{kind:"unsupported",message:"fill requires a target and text"};let r=tp(t);return r?{kind:"commands",commands:[{tapOn:r},{inputText:n}],warnings:["fill exports as tapOn + inputText; Maestro may append text instead of replacing existing field contents"]}:{kind:"unsupported",message:"fill target is not Maestro-compatible"}},type:function(e){var t;let[n]=e.positionals;if(void 0===n)return{kind:"unsupported",message:"type requires text"};let r=0!==(t=n).length&&[...t].every(e=>"\b"===e)?t.length:null;return null!==r?{kind:"commands",commands:[{eraseText:r}]}:{kind:"commands",commands:[{inputText:n}]}},keyboard:function(e){let[t]=e.positionals;return"dismiss"===t?{kind:"commands",commands:["hideKeyboard"]}:"enter"===t||"return"===t?{kind:"commands",commands:[{pressKey:"Enter"}]}:{kind:"unsupported",message:`keyboard ${t??""}`.trim()}},back:()=>({kind:"commands",commands:["back"]}),wait:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"wait requires a target or duration"};if(ty(t))return{kind:"commands",commands:[{waitForAnimationToEnd:{timeout:Number(t)}}],warnings:["wait <ms> exports as waitForAnimationToEnd and may return before the full duration"]};if("text"===t&&n)return{kind:"commands",commands:[{extendedWaitUntil:{visible:n,timeout:tw(e,17e3)}}]};let r=tg(t);return r?{kind:"commands",commands:[{extendedWaitUntil:{visible:r,timeout:tw(e,17e3)}}]}:{kind:"unsupported",message:"wait selector is not Maestro-compatible"}},find:function(e){let[t,n,r]=e.positionals;return"text"===t&&n&&r?"exists"===r?{kind:"commands",commands:[{assertVisible:n}]}:"missing"===r||"not-exists"===r?{kind:"commands",commands:[{assertNotVisible:n}]}:{kind:"unsupported",message:`find text assertion "${r}" is unsupported`}:{kind:"unsupported",message:"only find text <query> exists|missing exports to Maestro"}},screenshot:function(e){let[t]=e.positionals;return t?{kind:"commands",commands:[{takeScreenshot:t}]}:{kind:"unsupported",message:"screenshot requires an output path"}},scroll:function(e){let[t]=e.positionals;return t&&"down"!==t?{kind:"unsupported",message:`scroll ${t} is not exported yet`}:{kind:"commands",commands:["scroll"]}},swipe:function(e){var t,n;let r,o=function(e){let[t,n,r,o,s]=e.positionals;if(ty(t)&&ty(n)&&ty(r)&&ty(o))return{start:R(t,n),end:R(r,o),...s&&ty(s)?{duration:Number(s)}:{}}}(e);if(!o)return{kind:"unsupported",message:"only coordinate swipe exports to Maestro"};let s=(t=e,Number.isInteger(r=t.flags?.count??1)&&r>=1?r:null);if(null===s)return{kind:"unsupported",message:"swipe count must be a positive integer"};let a=(n=e,n.flags?.pauseMs!==void 0?"swipe --pause-ms has no Maestro equivalent":n.flags?.pattern&&"one-way"!==n.flags.pattern?"swipe ping-pong pattern has no Maestro equivalent":void 0);return a?{kind:"unsupported",message:a}:{kind:"commands",commands:Array.from({length:s},()=>({swipe:o}))}}};function tu(e){var t,n,r,o,s;let a,i,[l,c]=e.positionals;if(!l)return{kind:"unsupported",message:`${e.command} requires a target`};let d=tp(l,c);if(!d)return{kind:"unsupported",message:"tap target is not Maestro-compatible"};let u=(a=(n=t=e,n.flags?.jitterPx!==void 0?"tap --jitter-px has no Maestro equivalent":n.flags?.clickButton&&"primary"!==n.flags.clickButton?`tap --button ${n.flags.clickButton} has no Maestro equivalent`:void 0))?{ok:!1,message:a}:{ok:!0,options:(r=t,i={},"number"==typeof r.flags?.count&&r.flags.count>1&&(i.repeat=r.flags.count),"number"==typeof r.flags?.intervalMs&&r.flags.intervalMs>0&&(i.delay=r.flags.intervalMs),i)};return u.ok?e.flags?.doubleTap===!0?{kind:"commands",commands:[{doubleTapOn:d}],warnings:tm(e,"doubleTapOn")}:"number"==typeof e.flags?.holdMs?{kind:"commands",commands:[{longPressOn:d}],warnings:[tf(e.flags.holdMs),...tm(e,"longPressOn")]}:{kind:"commands",commands:[(o=d,0===Object.keys(s=u.options).length?{tapOn:o}:"string"==typeof o?{tapOn:{text:o,...s}}:o&&"object"==typeof o&&!Array.isArray(o)?{tapOn:{...o,...s}}:{tapOn:o})]}:{kind:"unsupported",message:u.message}}function tf(e){return`long-press duration exports as Maestro longPressOn; Maestro uses its default long-press duration instead of ${e}ms`}function tm(e,t){let n=[];return"number"==typeof e.flags?.count&&e.flags.count>1&&n.push(`tap --count ${e.flags.count} is not represented by Maestro ${t}`),"number"==typeof e.flags?.intervalMs&&e.flags.intervalMs>0&&n.push(`tap --interval-ms ${e.flags.intervalMs} is not represented by Maestro ${t}`),n}function tp(e,t){return ty(e)&&ty(t)?{point:R(e,t)}:e.startsWith("@")?null:tg(e)}function tg(e){let t;try{t=N(e)}catch{return e.includes("=")||e.includes("||")?null:e}let n=function(e){if(e.length<=1)return null;let t=e.flatMap(e=>1===e.terms.length&&tl.has(e.terms[0].key)?[e.terms[0].value]:[]);if(t.length!==e.length||0===t.length)return null;let n=t[0];return"string"!=typeof n?null:t.every(e=>e===n)?n:null}(t.selectors);return null!==n?n:1!==t.selectors.length?null:function(e){let t={};for(let o of e.terms){var n,r;if(n=t,r=o,tl.has(r.key)?"string"!=typeof r.value||!!n.id||!!n.text||!!n.label||(n[r.key]=r.value,!!0):!tc.has(r.key)||"boolean"!=typeof r.value||(n[r.key]=r.value,!!0))return null}return Object.keys(t).length>0?t:null}(t.selectors[0])}function th(e,t,n,r){for(let o of t??[])e.warnings.push({line:r,action:tv(n),message:o})}function tw(e,t){let n=e.positionals.at(-1);return n&&ty(n)?Number(n):t}function tv(e){return[e.command,...e.positionals??[]].join(" ").trim()}function tI(e){return/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(e)}function ty(e){return void 0!==e&&Number.isFinite(Number(e))}let tA=async e=>{let{positionals:t}=e;return"export"!==t[0]?function({positionals:e,flags:t}){if(e.length>1)throw new f("INVALID_ARGS","replay accepts exactly one input path: replay <path>");if(void 0!==t.replayExportFormat||void 0!==t.out)throw new f("INVALID_ARGS","replay --format/--out are only supported with replay export.");return!1}(e):await t_(e)};async function t_({positionals:e,flags:n}){let o;var s,a=e,i=n;if(a.length>2)throw new f("INVALID_ARGS","replay export accepts exactly one input path: replay export <file.ad>");if(i.replayUpdate)throw new f("INVALID_ARGS","replay export does not support --update.");if(i.replayMaestro)throw new f("INVALID_ARGS","replay export reads .ad files; omit --maestro.");if(i.replayEnv?.length)throw new f("INVALID_ARGS","replay export does not evaluate --env substitutions.");let l=i.replayExportFormat??"maestro";if("maestro"!==l)throw new f("INVALID_ARGS",`Unsupported replay export format: ${l}`);let c=e[1];if(!c)throw new f("INVALID_ARGS","replay export requires an input path.");let d=P(c),u=function(e,t={}){var n,r,o,s;let a={config:(n=t.metadata,n?.env&&Object.keys(n.env).length>0?{env:n.env}:{}),warnings:[],unsupported:[]},i=[];for(let[n,o]of e.entries()){let e=t.actionLines?.[n]??n+1,s=(r=o,td[r.command]?.(r)??{kind:"unsupported",message:`${r.command} has no Maestro equivalent`});switch(s.kind){case"commands":i.push(...s.commands),th(a,s.warnings,o,e);break;case"config":(function(e,t,n,r){if(!e.config.appId){e.config.appId=t;return}e.config.appId!==t&&e.unsupported.push({line:r,action:tv(n),message:`multiple app ids cannot be represented in one Maestro config (${e.config.appId} vs ${t})`})})(a,s.appId,o,e),i.push(...s.commands),th(a,s.warnings,o,e);break;case"unsupported":a.unsupported.push({line:e,action:tv(o),message:s.message})}}if(a.unsupported.length>0)throw new f("INVALID_ARGS",`Cannot export replay to Maestro YAML: unsupported .ad action ${a.unsupported.map(e=>`line ${e.line} (${e.action}): ${e.message}`).join("; ")}.`,{unsupported:a.unsupported});return{yaml:(o=a.config,s=i,U(Object.keys(o).length>0?[o,s]:[s])),warnings:a.warnings}}((o=b(s=t.readFileSync(d,"utf8"))).actions,{actionLines:o.actionLines,metadata:E(s)}),m="string"==typeof n.out?P(n.out):void 0;for(let e of(m&&(t.mkdirSync(r.dirname(m),{recursive:!0}),t.writeFileSync(m,u.yaml)),u.warnings))process.stderr.write(`Warning: line ${e.line}: ${e.message}
+`);return e6(n,{format:n.replayExportFormat??"maestro",sourcePath:d,...m?{path:m}:{yaml:u.yaml},warnings:u.warnings},()=>m??u.yaml),!0}let tS={...O,...L,...B,...V,...H,...$,...q,...W,...j,...K,...x,...F,...z,...M};async function tC(e){return(await tD(e)).result}async function tD(e){var t,n,r;let o=(t=e.command,n=e.positionals,r=e.flags,tS[t](n,r)),s=await Z(e.client,e.command,o);return{result:s,cliOutput:k({name:e.command,input:o,result:s})}}let tk={connect:e9,disconnect:e7,connection:te,auth:ti,replay:tA,screenshot:async({positionals:e,flags:t,client:n})=>{let r=await tC({client:n,command:"screenshot",positionals:e,flags:t});return e6(t,{path:r.path,...r.overlayRefs?{overlayRefs:r.overlayRefs}:{}},()=>r.overlayRefs?`Annotated ${r.overlayRefs.length} refs onto ${r.path}`:r.path),!0},diff:async({positionals:e,flags:t,client:n})=>{var r;if("snapshot"===e[0]){let r=await tC({client:n,command:"diff",positionals:e,flags:t});return e6(t,r,()=>_(r)),!0}if("screenshot"!==e[0])return!1;let o=t.baseline;if(!o||"string"!=typeof o)throw new f("INVALID_ARGS","diff screenshot requires --baseline <path>");let s=P(o),a="string"==typeof t.out?P(t.out):void 0,i=e[1];if(e.length>2)throw new f("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let l=Q({backend:(r=n,{platform:function(e){switch(e.platform){case"android":case"linux":case"macos":return e.platform;default:return"ios"}}(t),captureScreenshot:async(e,t,n)=>{let o=await r.capture.screenshot({path:t,session:e.session,overlayRefs:n?.overlayRefs,fullscreen:n?.fullscreen,stabilize:n?.stabilize,surface:n?.surface});return{path:o.path,...o.overlayRefs?{overlayRefs:o.overlayRefs}:{}}}}),artifacts:Y(),sessions:{get:e=>({name:e}),set:()=>{}},policy:X()}),c=await l.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:s},current:i?{kind:"path",path:P(i)}:{kind:"live"},...a?{out:{kind:"path",path:a}}:{},threshold:function(e){if(null!=e&&""!==e)return Number(e)}(t.threshold),overlayRefs:t.overlayRefs,surface:t.surface});return e6(t,c,()=>S(c)),!0}};async function tN(e){let t={...e.flags},n=tk[e.command];return!!(n&&await n({...e,flags:t}))||!!ee(e.command)&&await tU({...e,command:e.command,flags:t})}async function tU(e){let{runGenericClientBackedCommand:t}=await import("./generic.js");return await t(e)}function tb(e,t,n){return n||(e.push(t),"")}async function tR(e,t,n){let{flags:r}=t,o=function(e){var t;if(!e?.metroProxyBaseUrl||"android-instance"!==(t=e.leaseBackend)&&"ios-instance"!==t)return null;let n=[],r={serverBaseUrl:tb(n,"metroProxyBaseUrl",e.metroProxyBaseUrl),bearerToken:tb(n,"metroBearerToken",e.metroBearerToken),tenantId:tb(n,"tenant",e.tenant),runId:tb(n,"runId",e.runId),leaseId:tb(n,"leaseId",e.leaseId)};if(n.length>0)throw new f("INVALID_ARGS",`react-devtools remote bridge requires ${n.join(", ")}.`,{missing:n});return r}(r);if(!o)return n();let s=t.stateDir??process.cwd(),a=t.session??r?.session??"default",i=r?.remoteConfig??`${o.tenantId}:${o.runId}:${o.leaseId}`;if("stop"===e[0])try{return await n()}finally{await eg({projectRoot:t.cwd??process.cwd(),stateDir:s,profileKey:i,consumerKey:a})}return await ep({projectRoot:t.cwd??process.cwd(),stateDir:s,serverBaseUrl:o.serverBaseUrl,bearerToken:o.bearerToken,bridgeScope:{tenantId:o.tenantId,runId:o.runId,leaseId:o.leaseId},session:a,profileKey:i,consumerKey:a,env:t.env??process.env}),await n()}async function tE(e,t={}){let n=t.cwd??process.cwd(),r=t.env??process.env,o=await tR(e,t,async()=>(await y("npm",["exec","--yes","--package","agent-react-devtools@0.4.0","--","agent-react-devtools",...e],{cwd:n,env:r,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode);var s,a=t.flags;return 0!==o&&"wait"===(s=e)[0]&&s.includes("--connected")&&"ios-instance"===a?.leaseBackend&&process.stderr.write("Hint: Remote iOS React DevTools connects during JavaScript startup.\nIf the app was already open before `agent-device react-devtools start`, relaunch it with `agent-device open <bundle-id> --platform ios --relaunch`, then retry `agent-device react-devtools wait --connected`.\n"),o}function tP(e,t={}){let n=tT(t),r={...e};return n.defaultPlatform&&void 0===r.platform&&(r.platform=n.defaultPlatform),r}function tT(e){var t,n,r,o;let s,a=e.env??process.env,i=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new f("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(a.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??a.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:i,lockPolicy:(n=e.policyOverrides,r=a,o=l,(s=n?.sessionLock??n?.sessionLockConflicts??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new f("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}(r.AGENT_DEVICE_SESSION_LOCK))||(n?.sessionLocked===!0||o?"reject":void 0))}}let tL={sendToDaemon:eu},tB=new Set(["launchUrl","kind","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),tx=new Set(["connect","connection","close","disconnect","metro","session"]);async function tM(e,n=tL){let o=m(),s=ec(),a=function(e){try{let t=ea(e);return tO(t.command??"",t.providedFlags)}catch{return e.includes("--debug")||e.includes("-v")||e.includes("--verbose")}}(e),i=e.includes("--json"),I=function(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n.startsWith("--session=")){let e=n.slice(10).trim();return e.length>0?e:null}if("--session"===n){let n=e[t+1]?.trim();if(n&&!n.startsWith("-"))return n;break}}return null}(e)??process.env.AGENT_DEVICE_SESSION??"default";await p({session:I,requestId:o,command:e[0],debug:a},async()=>{var m,p,I,y,A,_,S,k,N,U,b,R,E,L,B,x,M;let O,$,V,j,K,H,F;try{let n,o,s,a,i,c,d,u;m={cwd:process.cwd(),env:process.env},n=ea(e),o=m?.env??process.env,s=m?.cwd??process.cwd(),y=n.command,a=null!==y&&(p={remoteConfig:n.flags.remoteConfig,cwd:s,env:o}).remoteConfig?{...eU(l({configPath:p.remoteConfig,cwd:p.cwd,env:p.env}).profile),remoteConfig:p.remoteConfig}:{},d=et((i=(I={command:n.command,cwd:s,cliFlags:n.flags,env:o}).env??process.env,c=et({},function(e){let n={};for(let r of e)et(n,function(e,n){let r,o;if(!t.existsSync(e)){if(n)throw new f("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=t.readFileSync(e,"utf8")}catch(t){throw new f("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{o=JSON.parse(r)}catch(t){throw new f("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!o||"object"!=typeof o||Array.isArray(o))throw new f("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let n={};for(let[r,o]of Object.entries(e)){if("installSource"===r){n.installSource=G(o,t);continue}let e=eo(r);if(!e)throw new f("INVALID_ARGS",`Unknown config key "${r}" in ${t}.`);if(!e.config.enabled)throw new f("INVALID_ARGS",`Unsupported config key "${r}" in ${t}.`);n[r]=en(e,o,t,r)}return n}(o,`config file ${e}`)}(r.path,r.required));return n}((A=I.cwd,_=I.cliFlags.config,S=i,(u=_??S.AGENT_DEVICE_CONFIG)?[{path:(k=u,N=A,U=S,P(k,{cwd:N,env:U})),required:!0}]:[{path:(b=S,r.join(T("~",{env:b}),".agent-device","config.json")),required:!1},{path:r.resolve(A,"agent-device.json"),required:!1}]))),et(c,function(e,t){let n={};for(let r of er(t)){if("installSource"===r.key)continue;let t=r.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(n[r.key]=en(r,t.value,`environment variable ${t.name}`,t.name))}return n}(i,I.command))),a),O={...el(n,{strictFlags:m?.strictFlags,defaultFlags:d}),providedFlags:n.providedFlags}}catch(t){w({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=u(t,{diagnosticId:g().diagnosticId,logPath:h({force:!0})??void 0});i?D({success:!1,error:e}):C(e,{showDetails:a}),process.exit(1);return}for(let e of O.warnings)process.stderr.write(`Warning: ${e}
 `);O.flags.version&&(process.stdout.write(`${s}
 `),process.exit(0));let q="help"===O.command,z=O.flags.help;if(q||z){q&&O.positionals.length>1&&(C(new f("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=q?O.positionals[0]:O.command;e||(process.stdout.write(`${es()}
 `),process.exit(0));let t=ei(e);t&&(process.stdout.write(t),process.exit(0)),C(new f("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${es()}

package/dist/src/index.d.ts

@@ -450,6 +450,7 @@ export declare type CaptureSnapshotResult = {
     appBundleId?: string;
     visibility?: SnapshotVisibility;
     unchanged?: SnapshotUnchanged;
+    snapshotDiagnostics?: SnapshotDiagnosticsSummary;
     identifiers: AgentDeviceIdentifiers;
 } & PublicSnapshotCaptureAnnotations;
 
@@ -1255,6 +1256,11 @@ declare type SnapshotCaptureFreshness = {
     reason?: 'empty-interactive' | 'sharp-drop' | 'stuck-route';
 };
 
+declare type SnapshotDiagnosticsSummary = {
+    stats: SnapshotTimingStats;
+    warning?: string;
+};
+
 export declare type SnapshotNode = RawSnapshotNode & {
     ref: string;
 };
@@ -1272,6 +1278,16 @@ declare type SnapshotQualityVerdict = {
     collapsedLeafIndexes?: number[];
 };
 
+declare type SnapshotTimingStats = {
+    count: number;
+    p50Ms: number;
+    p95Ms: number;
+    maxMs: number;
+    slowThresholdMs: number;
+    platform?: Platform;
+    backends?: Record<string, number>;
+};
+
 declare type SnapshotUnchanged = {
     ageMs: number;
     nodeCount: number;