agent-device 0.17.6 → 0.17.8

package/dist/src/cli.js

@@ -1,21 +1,32 @@
-import{pathToFileURL as e}from"node:url";import t from"node:fs";import n from"node:crypto";import o from"node:path";import{resolveRemoteConfigProfile as r,resolveRemoteConfigPath as s,REMOTE_CONFIG_FIELD_SPECS as a,parseSourceValue as i,buildPrimaryEnvVarName as l}from"./4723.js";import{isClientBackedCliCommandName as c,listCliCommandNames as d}from"./2133.js";import{getCliCommandSchema as u,applyCommandDefaults as f,getCommandSchema as m}from"./9581.js";import{asAppError as p,normalizeError as g,AppError as h}from"./733.js";import{buildCommandUsageText as w,buildUsageText as v}from"./cli-help.js";import{ensureCompanionTunnel as y,stopCompanionTunnel as I}from"./8275.js";import{REACT_DEVTOOLS_COMPANION_RUN_ARG as A}from"./4069.js";import{createRequestId as _,withDiagnosticsScope as S,getDiagnosticsMeta as k,flushDiagnosticsToSessionFile as D,emitDiagnostic as C}from"./432.js";import{resolveDaemonPaths as N}from"./2892.js";import{stopMetroTunnel as b}from"./metro.js";import{runCmdStreaming as R,runCmd as U}from"./8875.js";import{formatSnapshotDiffText as E,formatScreenshotDiffText as P,printHumanError as L,printJson as T}from"./6311.js";import{parseSelectorChain as x}from"./9836.js";import{stringifyMaestroYamlDocuments as B,parseReplayScriptDetailed as M,formatMaestroPoint as O,readReplayScriptMetadata as $}from"./4428.js";import{resolveUserPath as V,expandUserHomePath as G}from"./9612.js";import{interactionCliReaders as j,observabilityCliReaders as K,parseInstallSourceConfig as F,getFlagDefinition as H,gestureCliReaders as q,reactNativeCliReaders as W,getFlagDefinitions as J,captureCliReaders as z,GLOBAL_FLAG_KEYS as Z,replayCliReaders as Y,batchCliReaders as X,appCliReaders as Q,selectorCliReaders as ee,recordingCliReaders as et,systemCliReaders as en,perfCliReaders as eo}from"./9873.js";import{isCommandName as er,metroCliReaders as es,debuggingCliReaders as ea}from"./2948.js";import{formatCliOutput as ei}from"./cli-output.js";import{runCommand as el}from"./command-surface.js";import{createLocalArtifactAdapter as ec}from"./314.js";import{localCommandPolicy as ed,createAgentDevice as eu}from"./5299.js";import{readVersion as ef}from"./7244.js";import{createAgentDeviceClient as em,sendToDaemon as ep}from"./9919.js";import{maybeRunUpgradeNotifier as eg}from"./5448.js";function eh(e,t){for(let[n,o]of Object.entries(t))void 0!==o&&(e[n]=o);return e}let ew=new Set(["config","remoteConfig","help","version","batchSteps","githubActionsArtifact"]),ev=new Set(["appsFilter","iosSimulatorDeviceSet","sessionLocked","sessionLockConflicts"]),ey=function(){let e=new Map;for(let t of J()){let n=e.get(t.key);n?n.push(t):e.set(t.key,[t])}let t=new Map;for(let e of Z)t.set(e,new Set(["*"]));for(let e of d())for(let n of u(e).allowedFlags??[]){let o=t.get(n);o&&o.has("*")||(o?o.add(e):t.set(n,new Set([e])))}return[...e.entries()].map(([e,n])=>({key:e,flagDefinitions:n,config:{enabled:!ew.has(e),key:e},env:{names:ev.has(e)?[]:[l(e)]},supportsCommand(n){let o=t.get(e);return!!o&&(!!o.has("*")||!!n&&o.has(n))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),eI=new Map(ey.map(e=>[e.key,e]));function eA(e,t){return eI.get(e)?.supportsCommand(t)??!1}function e_(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let n=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===n.type){let t=n.enumValues??e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...n,setValue:void 0,enumValues:t}}return n}function eS(e){let t={json:!1,help:!1,version:!1},n=null,o=[],r=[],s=!0;for(let c=0;c<e.length;c+=1){var a,i,l;let d=e[c];if(s&&"--"===d){s=!1;continue}if(!s){n?o.push(d):n=eN(d);continue}let u=d.startsWith("--"),f=d.startsWith("-")&&d.length>1;if(!u&&!f){n?o.push(d):n=eN(d);continue}let[p,g]=u?ek(d):[d,void 0];if(a=n,"-c"===p&&("snapshot"===a||"diff"===a))continue;let w=H(p);if(i=n,l=w,"react-devtools"===i&&(!l||!eA(l.key,i))){o.push(d);continue}if(!w){if(function(e,t,n){var o;if(o=n,!/^-\d+(\.\d+)?$/.test(o)||!e)return!1;let r=m(e);if(!r||r.allowsExtraPositionals)return!0;let s=r.positionalArgs??[];return 0!==s.length&&(t.length<s.length||s.some(e=>e.includes("?")))}(n,o,d)){n?o.push(d):n=d;continue}throw new h("INVALID_ARGS",`Unknown flag: ${p}`)}let v=function(e,t,n,o){if(void 0!==e.setValue){if(void 0!==n)throw new h("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==n)throw new h("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==n){if(0===n.trim().length)throw new h("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:n,consumeNext:!1}}return void 0===o||eC(o)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(o)?{value:!0,consumeNext:!1}:{value:o,consumeNext:!0}}let r=n??o;if(void 0===r||void 0===n&&eC(r))throw new h("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:r,consumeNext:void 0===n};if("enum"===e.type){if(!e.enumValues?.includes(r))throw new h("INVALID_ARGS",`Invalid ${eD(t)}: ${r}`);return{value:r,consumeNext:void 0===n}}let s=Number(r);if(!Number.isFinite(s)||"number"==typeof e.min&&s<e.min||"number"==typeof e.max&&s>e.max)throw new h("INVALID_ARGS",`Invalid ${eD(t)}: ${r}`);return{value:Math.floor(s),consumeNext:void 0===n}}(w,p,g,e[c+1]);v.consumeNext&&(c+=1);let y=t[w.key];if(w.multiple){let e=Array.isArray(y)?[...y,v.value]:void 0===y?[v.value]:[y,v.value];t[w.key]=e}else t[w.key]=v.value;r.push({key:w.key,token:p})}return{command:n,positionals:o,flags:t,warnings:[],providedFlags:r}}function ek(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function eD(e){return e.replace(/^-+/,"")}function eC(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?ek(e):[e,void 0];return void 0!==H(t)}function eN(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}let eb={slug:"react-devtools-companion",runArg:A,displayName:"React DevTools companion"};async function eR(e){return await y({...e,definition:eb,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 eU(e){return await I({...e,definition:eb})}function eE(e){var n;let o,r=eB(e);if(!t.existsSync(r))return null;try{o=JSON.parse(t.readFileSync(r,"utf8"))}catch(t){return eG(e,t),null}return!(!(n=o)||"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?o:(eG(e),null)}function eP(e){let n=eB({stateDir:e.stateDir,session:e.state.session});t.mkdirSync(o.dirname(n),{recursive:!0}),eV(n,e.state),eV(eM(e.stateDir),{session:e.state.session})}function eL(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 eT(e){t.rmSync(eB(e),{force:!0});let n=eM(e.stateDir);e$(e.stateDir)===e.session&&t.rmSync(n,{force:!0})}function ex(e){try{return n.createHash("sha256").update(t.readFileSync(e)).digest("hex")}catch(t){throw new h("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function eB(e){return o.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 o=n.createHash("sha256").update(e).digest("hex").slice(0,8);return`${t}-${o}`}(e.session)}.json`)}function eM(e){return o.join(e,"remote-connections",".active-session.json")}function eO(e){let t=e$(e.stateDir);return t?eE({stateDir:e.stateDir,session:t}):null}function e$(e){let n=eM(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 eV(e,n){t.writeFileSync(e,`${JSON.stringify(n,null,2)}
-`,{encoding:"utf8",mode:384}),t.chmodSync(e,384)}function eG(e,t){C({level:"warn",phase:"remote_connection_state_invalid",data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),eT(e)}let ej=a.map(e=>e.key);function eK(e){let t={};for(let n of ej){let o=e[n];void 0!==o&&(t[n]=o)}return t}let eF=new Set(["connect","connection","close","disconnect","metro","session"]),eH=new Set(["open"]);async function eq(e){let t,n,{command:o,flags:s,client:a}=e;if(!s.remoteConfig)return{flags:s,runtime:e.runtime};let i=N(s.stateDir).baseDir,l=r({configPath:s.remoteConfig,cwd:process.cwd(),env:process.env}),c={...eK(l.profile),...s,remoteConfig:l.resolvedPath},d=eE({stateDir:i,session:c.session??"default"});if(d&&d.remoteConfigPath!==l.resolvedPath)throw new h("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:l.resolvedPath});let u=d??function(e,t){if(!e.tenant)throw new h("INVALID_ARGS","remote command requires tenant in remote config or via --tenant <id>.");if(!e.runId)throw new h("INVALID_ARGS","remote command requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new h("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:ex(t),daemon:eL(e),tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend??eY(e),platform:e.platform,target:e.target,connectedAt:n,updatedAt:n}}(c,l.resolvedPath),f={...c,session:u.session},m=function(e,t){if(e)return eQ(e,t)?e:void 0}(u.runtime,f.platform)??e.runtime,p=u,g=!d;if(w=o,!eF.has(w)){let e=u.leaseBackend??function(e,t){let n=eY(e);if(n)return n;throw new h("INVALID_ARGS",`${t} requires --platform ios|android or --lease-backend when the remote connection has not resolved a lease yet.`)}(s,o);var w,v,y,I,A,_=u,S=s,k=e;if(_.leaseBackend&&_.leaseBackend!==k)throw new h("INVALID_ARGS","Active remote connection is already bound to a different lease backend. Re-run connect --force to replace it.",{session:_.session,leaseBackend:_.leaseBackend});if(_.platform&&S.platform&&_.platform!==S.platform)throw new h("INVALID_ARGS","Active remote connection is already bound to a different platform. Re-run connect --force to replace it.",{session:_.session,platform:_.platform});if(_.target&&S.target&&_.target!==S.target)throw new h("INVALID_ARGS","Active remote connection is already bound to a different target. Re-run connect --force to replace it.",{session:_.session,target:_.target});let t=await e0(a,p,e);f.leaseId=t.leaseId,f.leaseBackend=e,f.platform=p.platform??f.platform,f.target=p.target??f.target,(p.leaseId!==t.leaseId||p.leaseBackend!==e)&&(p={...p,leaseId:t.leaseId,leaseBackend:e,platform:p.platform??s.platform,target:p.target??s.target,updatedAt:new Date().toISOString()},g=!0)}if(v=o,y=e.batchSteps,(eH.has(v)||"batch"===v&&y&&y.some(e=>{let t=e.command.trim().toLowerCase();return eH.has(t)&&void 0===e.runtime}))&&eX(f)&&(!p.leaseId&&f.leaseId&&(p={...p,leaseId:f.leaseId,leaseBackend:f.leaseBackend}),e.forceRuntimePrepare||!m||!eQ(m,f.platform))){if(!p.leaseId)throw new h("INVALID_ARGS",`${o} requires a resolved remote lease before Metro runtime can be prepared.`);let e=await eW(f,a,u.remoteConfigPath,u.session,{tenantId:u.tenant,runId:u.runId,leaseId:p.leaseId});m=e.runtime;let r=(I=p.metro,A=e.cleanup,I?.projectRoot!==A?.projectRoot||I?.profileKey!==A?.profileKey||I?.consumerKey!==A?.consumerKey);t=r?p.metro:void 0,n=r?e.cleanup:void 0,p={...p,runtime:e.runtime,metro:e.cleanup,updatedAt:new Date().toISOString()},g=!0}if(g)try{eP({stateDir:i,state:p})}catch(e){throw await eJ(n),e}return await eJ(t),{flags:{...f,session:p.session,leaseId:p.leaseId,leaseBackend:p.leaseBackend,platform:p.platform??f.platform,target:p.target??f.target},runtime:m}}async function eW(e,t,n,o,r){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new h("INVALID_ARGS",'Deferred Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)throw new h("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 h("INVALID_ARGS","metro prepare --kind must be auto, react-native, or expo")}}(e.metroKind),publicBaseUrl:e.metroPublicBaseUrl,proxyBaseUrl:e.metroProxyBaseUrl,bearerToken:e.metroBearerToken,bridgeScope:r,launchUrl:e.launchUrl,companionProfileKey:n,companionConsumerKey:o,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:o}:void 0}}async function eJ(e){if(e)try{await b(e)}catch{}}async function ez(e){try{await eU({projectRoot:process.cwd(),stateDir:e.stateDir,profileKey:e.state.remoteConfigPath,consumerKey:e.state.session})}catch{}}async function eZ(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 eY(e){return e.leaseBackend?e.leaseBackend:"android"===e.platform?"android-instance":"ios"===e.platform?"ios-instance":void 0}function eX(e){let t=e.metroKind;return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||t)}function eQ(e,t){return!e.platform||!t||"ios"!==t&&"android"!==t||e.platform===t}async function e0(e,t,n){if(t.leaseId&&t.leaseBackend===n){let o=await e1(e,t.leaseId,{tenant:t.tenant,runId:t.runId,leaseBackend:n});if(o)return o}return await e.leases.allocate({tenant:t.tenant,runId:t.runId,leaseBackend:n})}async function e1(e,t,n){try{return await e.leases.heartbeat({tenant:n.tenant,runId:n.runId,leaseId:t,leaseBackend:n.leaseBackend})}catch(e){var o;if((o=e)instanceof h&&"UNAUTHORIZED"===o.code&&(o.details?.reason==="LEASE_NOT_FOUND"||o.details?.reason==="LEASE_EXPIRED"||o.details?.reason==="LEASE_REVOKED"))return;throw e}}async function e3(e,t){let n=await e.text(),o={};if(n.trim().length>0)try{o=JSON.parse(n)}catch(n){throw new h("COMMAND_FAILED",t.invalidJsonMessage,{status:e.status},n instanceof Error?n:void 0)}if(!e.ok)throw new h("UNAUTHORIZED",t.rejectedMessage,{status:e.status,response:o});return o}async function e8(e){return await e2({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:"connect"===e.command&&!e.flags.noLogin,env:e.env})}async function e2(e){let t=e.env??e.io?.env??process.env;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:"none"};if(tl(e.flags.daemonAuthToken))return{flags:e.flags,source:"flag"};if(tl(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||tl(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 e7({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 h("UNAUTHORIZED","Remote daemon authentication is required.",{hint:"Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN."});throw to(e.command,t)}let o=await e9({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:o.accessToken},source:"login"}}async function e4(e){let t=e.env??e.io?.env??process.env;if(tl(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:tr(t)};if(tl(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:t.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:tr(t)};let n=await e7({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 h("UNAUTHORIZED","Cloud connection profile authentication is required.",{hint:"Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN."});let o=await e9({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io,commandLabel:"agent-device connect"});return{accessToken:o.accessToken,cloudBaseUrl:o.session.cloudBaseUrl}}async function e9(e){let n,r,s,a=e.env??e.io?.env??process.env,i=(d=a,u=e.io,n=u?.stdinIsTTY??process.stdin.isTTY,r=u?.stdoutIsTTY??process.stdout.isTTY,"true"!==(f=d).CI&&"true"!==f.GITHUB_ACTIONS&&"true"!==f.BUILDKITE&&n&&r?(m=d).SSH_TTY||m.SSH_CONNECTION||"true"===m.CODESPACES||m.GITPOD_WORKSPACE_ID||"true"===m.REMOTE_CONTAINERS?"device-code":"local-browser":"non-interactive");if("non-interactive"===i)throw to(e.commandLabel??"agent-device connect",a);let l=tr(a),c=await tn({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,f,m,p,g,w=c;if(!tl(w.deviceCode)||!tl(w.userCode)||!tl(w.verificationUri))throw new h("COMMAND_FAILED","Cloud auth start returned an unusable response.");let v=c.verificationUriComplete??c.verificationUri,y="local-browser"===i?c.verificationUri:(p=c.verificationUri,g=c.userCode,(s=new URL(p)).searchParams.set("user_code",g),s.toString());"local-browser"===i?(ta(e.io,`Opening ${c.verificationUri}...
-`),await ts(v,e.io)):ta(e.io,`Open this URL on your machine:
-${y}
+import{pathToFileURL as e}from"node:url";import t from"node:fs";import n,{randomBytes as r,randomUUID as o}from"node:crypto";import s from"node:path";import a from"node:http";import{Readable as i}from"node:stream";import{pipeline as l}from"node:stream/promises";import{resolveRemoteConfigProfile as c,resolveRemoteConfigPath as d,REMOTE_CONFIG_FIELD_SPECS as u,parseSourceValue as f,buildPrimaryEnvVarName as m}from"./4723.js";import{isClientBackedCliCommandName as p,listCliCommandNames as g}from"./2133.js";import{getCliCommandSchema as h,applyCommandDefaults as w,getCommandSchema as v}from"./9581.js";import{asAppError as y,normalizeError as I,AppError as A}from"./733.js";import{buildCommandUsageText as S,buildUsageText as _}from"./cli-help.js";import{ensureCompanionTunnel as k,stopCompanionTunnel as D}from"./8275.js";import{REACT_DEVTOOLS_COMPANION_RUN_ARG as C}from"./4069.js";import{createRequestId as N,withDiagnosticsScope as b,getDiagnosticsMeta as R,flushDiagnosticsToSessionFile as U,emitDiagnostic as E}from"./432.js";import{buildDaemonHealthPayload as x,resolveDaemonPaths as T}from"./8358.js";import{stopMetroTunnel as P}from"./metro.js";import{runCmdStreaming as L,runCmd as B}from"./8875.js";import{formatSnapshotDiffText as $,formatScreenshotDiffText as M,printHumanError as O,printJson as V}from"./6311.js";import{setupManagedAgentBrowser as G,localCommandPolicy as j,doctorManagedAgentBrowser as K,timingSafeStringEqual as H,createAgentDevice as F}from"./2577.js";import{ensureDaemon as q,sendToDaemon as J,createAgentDeviceClient as W,resolveClientSettings as z}from"./9919.js";import{parseSelectorChain as Z}from"./9836.js";import{stringifyMaestroYamlDocuments as Y,parseReplayScriptDetailed as X,formatMaestroPoint as Q,readReplayScriptMetadata as ee}from"./4428.js";import{resolveUserPath as et,expandUserHomePath as en}from"./9612.js";import{interactionCliReaders as er,observabilityCliReaders as eo,parseInstallSourceConfig as es,getFlagDefinition as ea,gestureCliReaders as ei,reactNativeCliReaders as el,getFlagDefinitions as ec,captureCliReaders as ed,GLOBAL_FLAG_KEYS as eu,replayCliReaders as ef,batchCliReaders as em,appCliReaders as ep,selectorCliReaders as eg,recordingCliReaders as eh,systemCliReaders as ew,perfCliReaders as ev}from"./9873.js";import{isCommandName as ey,metroCliReaders as eI,debuggingCliReaders as eA}from"./2948.js";import{formatCliOutput as eS}from"./cli-output.js";import{runCommand as e_}from"./command-surface.js";import{createLocalArtifactAdapter as ek}from"./314.js";import{readVersion as eD}from"./7244.js";import{maybeRunUpgradeNotifier as eC}from"./5448.js";function eN(e,t){for(let[n,r]of Object.entries(t))void 0!==r&&(e[n]=r);return e}let eb=new Set(["config","remoteConfig","help","version","batchSteps","githubActionsArtifact"]),eR=new Set(["appsFilter","iosSimulatorDeviceSet","sessionLocked","sessionLockConflicts"]),eU=function(){let e=new Map;for(let t of ec()){let n=e.get(t.key);n?n.push(t):e.set(t.key,[t])}let t=new Map;for(let e of eu)t.set(e,new Set(["*"]));for(let e of g()){let n=h(e);for(let r of[...n.allowedFlags??[],...n.supportedFlags??[]]){let n=t.get(r);n&&n.has("*")||(n?n.add(e):t.set(r,new Set([e])))}}return[...e.entries()].map(([e,n])=>({key:e,flagDefinitions:n,config:{enabled:!eb.has(e),key:e},env:{names:eR.has(e)?[]:[m(e)]},supportsCommand(n){let r=t.get(e);return!!r&&(!!r.has("*")||!!n&&r.has(n))}})).sort((e,t)=>e.key.localeCompare(t.key))}(),eE=new Map(eU.map(e=>[e.key,e]));function ex(e,t){return eE.get(e)?.supportsCommand(t)??!1}function eT(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let n=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===n.type){let t=n.enumValues??e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...n,setValue:void 0,enumValues:t}}return n}function eP(e){let t={json:!1,help:!1,version:!1},n=null,r=[],o=[],s=!0;for(let c=0;c<e.length;c+=1){var a,i,l;let d=e[c];if(s&&"--"===d){s=!1;continue}if(!s){n?r.push(d):n=eM(d);continue}let u=d.startsWith("--"),f=d.startsWith("-")&&d.length>1;if(!u&&!f){n?r.push(d):n=eM(d);continue}let[m,p]=u?eL(d):[d,void 0];if(a=n,"-c"===m&&("snapshot"===a||"diff"===a))continue;let g=function(e,t){let n=ec().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??ea(e);if(t){let e=n.find(e=>ex(e.key,t));if(e)return e}return ea(e)}(m,n);if(i=n,l=g,"react-devtools"===i&&(!l||!ex(l.key,i))){r.push(d);continue}if(!g){if(function(e,t,n){var r;if(r=n,!/^-\d+(\.\d+)?$/.test(r)||!e)return!1;let o=v(e);if(!o||o.allowsExtraPositionals)return!0;let s=o.positionalArgs??[];return 0!==s.length&&(t.length<s.length||s.some(e=>e.includes("?")))}(n,r,d)){n?r.push(d):n=d;continue}throw new A("INVALID_ARGS",`Unknown flag: ${m}`)}let h=function(e,t,n,r){if(void 0!==e.setValue){if(void 0!==n)throw new A("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==n)throw new A("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==n){if(0===n.trim().length)throw new A("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:n,consumeNext:!1}}return void 0===r||e$(r)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(r)?{value:!0,consumeNext:!1}:{value:r,consumeNext:!0}}let o=n??r;if(void 0===o||void 0===n&&e$(o))throw new A("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:o,consumeNext:void 0===n};if("enum"===e.type){if(!e.enumValues?.includes(o))throw new A("INVALID_ARGS",`Invalid ${eB(t)}: ${o}`);return{value:o,consumeNext:void 0===n}}let s=Number(o);if(!Number.isFinite(s)||"number"==typeof e.min&&s<e.min||"number"==typeof e.max&&s>e.max)throw new A("INVALID_ARGS",`Invalid ${eB(t)}: ${o}`);return{value:Math.floor(s),consumeNext:void 0===n}}(g,m,p,e[c+1]);h.consumeNext&&(c+=1);let w=t[g.key];if(g.multiple){let e=Array.isArray(w)?[...w,h.value]:void 0===w?[h.value]:[w,h.value];t[g.key]=e}else t[g.key]=h.value;o.push({key:g.key,token:m})}return{command:n,positionals:r,flags:t,warnings:[],providedFlags:o}}function eL(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function eB(e){return e.replace(/^-+/,"")}function e$(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?eL(e):[e,void 0];return void 0!==ea(t)}function eM(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}let eO={slug:"react-devtools-companion",runArg:C,displayName:"React DevTools companion"};async function eV(e){return await k({...e,definition:eO,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 D({...e,definition:eO})}function ej(e){var n;let r,o=eJ(e);if(!t.existsSync(o))return null;try{r=JSON.parse(t.readFileSync(o,"utf8"))}catch(t){return eX(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:(eX(e),null)}function eK(e){let n=eJ({stateDir:e.stateDir,session:e.state.session});t.mkdirSync(s.dirname(n),{recursive:!0}),eY(n,e.state),eY(eW(e.stateDir),{session:e.state.session})}function eH(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 eF(e){t.rmSync(eJ(e),{force:!0});let n=eW(e.stateDir);eZ(e.stateDir)===e.session&&t.rmSync(n,{force:!0})}function eq(e){try{return n.createHash("sha256").update(t.readFileSync(e)).digest("hex")}catch(t){throw new A("INVALID_ARGS",`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function eJ(e){return s.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 eW(e){return s.join(e,"remote-connections",".active-session.json")}function ez(e){let t=eZ(e.stateDir);return t?ej({stateDir:e.stateDir,session:t}):null}function eZ(e){let n=eW(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 eY(e,n){t.writeFileSync(e,`${JSON.stringify(n,null,2)}
+`,{encoding:"utf8",mode:384}),t.chmodSync(e,384)}function eX(e,t){E({level:"warn",phase:"remote_connection_state_invalid",data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),eF(e)}let eQ=u.map(e=>e.key);function e0(e){let t={};for(let n of eQ){let r=e[n];void 0!==r&&(t[n]=r)}return t}let e1=new Set(["connect","connection","close","disconnect","metro","session"]),e3=new Set(["open"]);async function e8(e){let t,n,{command:r,flags:o,client:s}=e;if(!o.remoteConfig)return{flags:o,runtime:e.runtime};let a=T(o.stateDir).baseDir,i=c({configPath:o.remoteConfig,cwd:process.cwd(),env:process.env}),l={...e0(i.profile),...o,remoteConfig:i.resolvedPath},d=ej({stateDir:a,session:l.session??"default"});if(d&&d.remoteConfigPath!==i.resolvedPath)throw new A("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 A("INVALID_ARGS","remote command requires tenant in remote config or via --tenant <id>.");if(!e.runId)throw new A("INVALID_ARGS","remote command requires runId in remote config or via --run-id <id>.");if(!e.daemonBaseUrl)throw new A("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:eq(t),daemon:eH(e),tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend??e6(e),platform:e.platform,target:e.target,connectedAt:n,updatedAt:n}}(l,i.resolvedPath),f={...l,session:u.session},m=function(e,t){if(e)return te(e,t)?e:void 0}(u.runtime,f.platform)??e.runtime,p=u,g=!d;if(h=r,!e1.has(h)){let e=u.leaseBackend??function(e,t){let n=e6(e);if(n)return n;throw new A("INVALID_ARGS",`${t} requires --platform ios|android or --lease-backend when the remote connection has not resolved a lease yet.`)}(o,r);var h,w,v,y,I,S=u,_=o,k=e;if(S.leaseBackend&&S.leaseBackend!==k)throw new A("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&&_.platform&&S.platform!==_.platform)throw new A("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&&_.target&&S.target!==_.target)throw new A("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 tt(s,p,e);f.leaseId=t.leaseId,f.leaseBackend=e,f.platform=p.platform??f.platform,f.target=p.target??f.target,(p.leaseId!==t.leaseId||p.leaseBackend!==e)&&(p={...p,leaseId:t.leaseId,leaseBackend:e,platform:p.platform??o.platform,target:p.target??o.target,updatedAt:new Date().toISOString()},g=!0)}if(w=r,v=e.batchSteps,(e3.has(w)||"batch"===w&&v&&v.some(e=>{let t=e.command.trim().toLowerCase();return e3.has(t)&&void 0===e.runtime}))&&e9(f)&&(!p.leaseId&&f.leaseId&&(p={...p,leaseId:f.leaseId,leaseBackend:f.leaseBackend}),e.forceRuntimePrepare||!m||!te(m,f.platform))){if(!p.leaseId)throw new A("INVALID_ARGS",`${r} requires a resolved remote lease before Metro runtime can be prepared.`);let e=await e2(f,s,u.remoteConfigPath,u.session,{tenantId:u.tenant,runId:u.runId,leaseId:p.leaseId});m=e.runtime;let o=(y=p.metro,I=e.cleanup,y?.projectRoot!==I?.projectRoot||y?.profileKey!==I?.profileKey||y?.consumerKey!==I?.consumerKey);t=o?p.metro:void 0,n=o?e.cleanup:void 0,p={...p,runtime:e.runtime,metro:e.cleanup,updatedAt:new Date().toISOString()},g=!0}if(g)try{eK({stateDir:a,state:p})}catch(e){throw await e4(n),e}return await e4(t),{flags:{...f,session:p.session,leaseId:p.leaseId,leaseBackend:p.leaseBackend,platform:p.platform??f.platform,target:p.target??f.target},runtime:m}}async function e2(e,t,n,r,o){if(!e.metroProjectRoot&&!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)return{};if("ios"!==e.platform&&"android"!==e.platform)throw new A("INVALID_ARGS",'Deferred Metro preparation requires platform "ios" or "android".');if(!e.metroPublicBaseUrl&&!e.metroProxyBaseUrl)throw new A("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 A("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 e4(e){if(e)try{await P(e)}catch{}}async function e5(e){try{await eG({projectRoot:process.cwd(),stateDir:e.stateDir,profileKey:e.state.remoteConfigPath,consumerKey:e.state.session})}catch{}}async function e7(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 e6(e){return e.leaseBackend?e.leaseBackend:"android"===e.platform?"android-instance":"ios"===e.platform?"ios-instance":void 0}function e9(e){let t=e.metroKind;return!!(e.metroPublicBaseUrl||e.metroProxyBaseUrl||e.metroProjectRoot||t)}function te(e,t){return!e.platform||!t||"ios"!==t&&"android"!==t||e.platform===t}async function tt(e,t,n){if(t.leaseId&&t.leaseBackend===n){let r=await tn(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 tn(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 A&&"UNAUTHORIZED"===r.code&&(r.details?.reason==="LEASE_NOT_FOUND"||r.details?.reason==="LEASE_EXPIRED"||r.details?.reason==="LEASE_REVOKED"))return;throw e}}async function tr(e,t){let n=await e.text(),r={};if(n.trim().length>0)try{r=JSON.parse(n)}catch(n){throw new A("COMMAND_FAILED",t.invalidJsonMessage,{status:e.status},n instanceof Error?n:void 0)}if(!e.ok)throw new A("UNAUTHORIZED",t.rejectedMessage,{status:e.status,response:r});return r}async function to(e){return await ts({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:"connect"===e.command&&!e.flags.noLogin,env:e.env})}async function ts(e){let t=e.env??e.io?.env??process.env;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:"none"};if(ty(e.flags.daemonAuthToken))return{flags:e.flags,source:"flag"};if(ty(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||ty(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 td({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 A("UNAUTHORIZED","Remote daemon authentication is required.",{hint:"Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN."});throw tp(e.command,t)}let r=await ti({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:"login"}}async function ta(e){let t=e.env??e.io?.env??process.env;if(ty(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:tg(t)};if(ty(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:t.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:tg(t)};let n=await td({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 A("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 ti({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 ti(e){let n,r,o,a=e.env??e.io?.env??process.env,i=(d=a,u=e.io,n=u?.stdinIsTTY??process.stdin.isTTY,r=u?.stdoutIsTTY??process.stdout.isTTY,"true"!==(f=d).CI&&"true"!==f.GITHUB_ACTIONS&&"true"!==f.BUILDKITE&&n&&r?(m=d).SSH_TTY||m.SSH_CONNECTION||"true"===m.CODESPACES||m.GITPOD_WORKSPACE_ID||"true"===m.REMOTE_CONTAINERS?"device-code":"local-browser":"non-interactive");if("non-interactive"===i)throw tp(e.commandLabel??"agent-device connect",a);let l=tg(a),c=await tm({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,f,m,p,g,h=c;if(!ty(h.deviceCode)||!ty(h.userCode)||!ty(h.verificationUri))throw new A("COMMAND_FAILED","Cloud auth start returned an unusable response.");let w=c.verificationUriComplete??c.verificationUri,v="local-browser"===i?c.verificationUri:(p=c.verificationUri,g=c.userCode,(o=new URL(p)).searchParams.set("user_code",g),o.toString());"local-browser"===i?(tw(e.io,`Opening ${c.verificationUri}...
+`),await th(w,e.io)):tw(e.io,`Open this URL on your machine:
+${v}
 
 Waiting for approval for 10 minutes...
-`);let I=await tt({cloudBaseUrl:l,deviceCode:c.deviceCode,expiresIn:c.expiresIn,interval:c.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),A=I.cliSession?.refreshCredential??I.cliSession?.refreshToken;if(!tl(I.accessToken)||!tl(A))throw new h("UNAUTHORIZED","Device authorization did not return CLI credentials.");let _=new Date(e.io?.now?.()??Date.now()).toISOString(),S={version:1,id:I.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:l,workspaceId:I.cliSession?.workspaceId,accountId:I.cliSession?.accountId,name:I.cliSession?.name,refreshCredential:A,createdAt:_,expiresAt:I.cliSession?.expiresAt};return function(e){let n=e6(e.stateDir);t.mkdirSync(o.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:I.accessToken,expiresAt:I.expiresAt,session:S}}function e5(e){let n=e6(e.stateDir);if(!t.existsSync(n))return null;try{let e=JSON.parse(t.readFileSync(n,"utf8"));if(1!==e.version||!tl(e.id)||!tl(e.cloudBaseUrl)||!tl(e.refreshCredential)||!tl(e.createdAt))return null;return e}catch{return null}}function e6(e){return o.join(e,"auth","cli-session.json")}async function e7(e){let t=e5({stateDir:e.stateDir});return!t||ti(t.expiresAt,e.io?.now)?null:{accessToken:(await te({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:tr(e.env,t.cloudBaseUrl)}}async function te(e){let t=tr(e.env,e.session.cloudBaseUrl),n=await tn({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(tl(n.accessToken))return{accessToken:n.accessToken,expiresAt:n.expiresAt};if("revoked"===n.status||"revoked"===n.error)throw new h("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 h("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 tt(e){let t=e.now??Date.now,n=Math.min((e.expiresIn??600)*1e3,6e5),o=t()+n,r=Math.max(1e3,(e.interval??5)*1e3);for(;t()<o;){let t=await tn({baseUrl:e.cloudBaseUrl,pathName:"/api/control-plane/device-auth/poll",body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if("approved"===t.status||tl(t.accessToken))return t;if("slow_down"===t.status||"slow_down"===t.error)r+=1e3;else if("authorization_pending"!==t.status&&"authorization_pending"!==t.error)throw new h("UNAUTHORIZED","Device authorization was not approved.",{status:t.status,error:t.error});await tc(r)}throw new h("TIMEOUT","Device authorization expired before approval.")}async function tn(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 e3(n,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${n.status}).`,rejectedMessage:"Cloud auth endpoint rejected the request."})}function to(e,t){let n=tr(t);return new h("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 tr(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 h("INVALID_ARGS","Invalid AGENT_DEVICE_CLOUD_BASE_URL.",{cloudBaseUrl:n},e instanceof Error?e:void 0)}}async function ts(e,t){if(t?.openBrowser)return void await t.openBrowser(e);let n=process.platform;try{"darwin"===n?await U("open",[e],{allowFailure:!0,timeoutMs:5e3}):"win32"===n?await U("cmd",["/c","start","",e],{allowFailure:!0,timeoutMs:5e3}):await U("xdg-open",[e],{allowFailure:!0,timeoutMs:5e3})}catch{ta(t,`Open this URL on your machine:
+`);let y=await tf({cloudBaseUrl:l,deviceCode:c.deviceCode,expiresIn:c.expiresIn,interval:c.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),I=y.cliSession?.refreshCredential??y.cliSession?.refreshToken;if(!ty(y.accessToken)||!ty(I))throw new A("UNAUTHORIZED","Device authorization did not return CLI credentials.");let S=new Date(e.io?.now?.()??Date.now()).toISOString(),_={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:I,createdAt:S,expiresAt:y.cliSession?.expiresAt};return function(e){let n=tc(e.stateDir);t.mkdirSync(s.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:_}),{accessToken:y.accessToken,expiresAt:y.expiresAt,session:_}}function tl(e){let n=tc(e.stateDir);if(!t.existsSync(n))return null;try{let e=JSON.parse(t.readFileSync(n,"utf8"));if(1!==e.version||!ty(e.id)||!ty(e.cloudBaseUrl)||!ty(e.refreshCredential)||!ty(e.createdAt))return null;return e}catch{return null}}function tc(e){return s.join(e,"auth","cli-session.json")}async function td(e){let t=tl({stateDir:e.stateDir});return!t||tv(t.expiresAt,e.io?.now)?null:{accessToken:(await tu({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:tg(e.env,t.cloudBaseUrl)}}async function tu(e){let t=tg(e.env,e.session.cloudBaseUrl),n=await tm({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(ty(n.accessToken))return{accessToken:n.accessToken,expiresAt:n.expiresAt};if("revoked"===n.status||"revoked"===n.error)throw new A("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 A("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 tf(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 tm({baseUrl:e.cloudBaseUrl,pathName:"/api/control-plane/device-auth/poll",body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if("approved"===t.status||ty(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 A("UNAUTHORIZED","Device authorization was not approved.",{status:t.status,error:t.error});await tI(o)}throw new A("TIMEOUT","Device authorization expired before approval.")}async function tm(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 tr(n,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${n.status}).`,rejectedMessage:"Cloud auth endpoint rejected the request."})}function tp(e,t){let n=tg(t);return new A("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 tg(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 A("INVALID_ARGS","Invalid AGENT_DEVICE_CLOUD_BASE_URL.",{cloudBaseUrl:n},e instanceof Error?e:void 0)}}async function th(e,t){if(t?.openBrowser)return void await t.openBrowser(e);let n=process.platform;try{"darwin"===n?await B("open",[e],{allowFailure:!0,timeoutMs:5e3}):"win32"===n?await B("cmd",["/c","start","",e],{allowFailure:!0,timeoutMs:5e3}):await B("xdg-open",[e],{allowFailure:!0,timeoutMs:5e3})}catch{tw(t,`Open this URL on your machine:
 ${e}
-`)}}function ta(e,t){(e?.stderr??process.stderr).write(t)}function ti(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function tl(e){return"string"==typeof e&&e.trim().length>0}async function tc(e){await new Promise(t=>setTimeout(t,e))}async function td(e){let s=await e4({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{env:e.env,fetch:e.fetchImpl}}),a=await tu({cloudBaseUrl:s.cloudBaseUrl,accessToken:s.accessToken,fetchImpl:e.fetchImpl}),i=function(e){try{return r(e)}catch(n){let t=p(n);throw new h("COMMAND_FAILED","Cloud connection profile returned invalid remote config.",{generatedConfigPath:e.configPath,cause:t.message},t)}}({configPath:function(e){var r;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=o.join(e.stateDir,"remote-connections","generated");t.mkdirSync(a,{recursive:!0,mode:448});let i=o.join(a,`cloud-${(r=s,n.createHash("sha256").update(JSON.stringify(r)).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:a}),cwd:e.cwd,env:e.env});return{flags:{...eK(i.profile),...e.flags,remoteConfig:i.resolvedPath,daemonAuthToken:s.accessToken},remoteConfigPath:i.resolvedPath}}async function tu(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 o=await e3(n,{invalidJsonMessage:`Cloud connection profile endpoint returned invalid JSON (${n.status}).`,rejectedMessage:"Cloud connection profile endpoint rejected the request."});if(!o||"object"!=typeof o||Array.isArray(o))throw new h("COMMAND_FAILED","Cloud connection profile response is invalid.");let r=o.connection;if(!r||"object"!=typeof r)throw new h("COMMAND_FAILED","Cloud connection profile response is missing profile.");if(void 0!==r.remoteConfigProfile){var s=r.remoteConfigProfile;if(!s||"object"!=typeof s||Array.isArray(s))throw new h("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is invalid.");if(0===Object.keys(s).length)throw new h("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is empty.");return s}throw new h("COMMAND_FAILED","Cloud connection profile did not include remoteConfigProfile.")}function tf(e,t,n){var o;if(e.json)return void T({success:!0,data:t});let r=n?.();r&&(o=r,process.stdout.write(o.endsWith("\n")?o:`${o}
-`))}let tm=async({flags:e,client:t})=>{var o,s,a,i;let l=N(e.stateDir).baseDir,c=e.remoteConfig?function(e){if(!e.remoteConfig)throw new h("INVALID_ARGS","connect requires --remote-config <path>.");let t=r({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env});return{flags:e,remoteConfigPath:t.resolvedPath}}(e):await td({flags:e,stateDir:l,cwd:process.cwd(),env:process.env}),d=c.flags,u=d.tenant,f=d.runId;if(!u)throw new h("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!f)throw new h("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!d.daemonBaseUrl)throw new h("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let m=d.session?null:eO({stateDir:l}),p=d.session??m?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${n.randomBytes(3).toString("hex")}`;if(!eE({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${n.randomBytes(2).toString("hex")}`}(l),g=ex(c.remoteConfigPath),w=eL(d),v=m?.session===p?m:eE({stateDir:l,session:p});if(v&&(o=v,s={flags:d,session:p,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:g,desiredLeaseBackend:eY(d),daemon:w},o.remoteConfigPath!==s.remoteConfigPath||o.remoteConfigHash!==s.remoteConfigHash||o.session!==s.session||o.tenant!==s.flags.tenant||o.runId!==s.flags.runId||void 0!==s.desiredLeaseBackend&&o.leaseBackend!==s.desiredLeaseBackend||void 0!==s.flags.platform&&o.platform!==s.flags.platform||void 0!==s.flags.target&&o.target!==s.flags.target||(a=o.daemon,i=s.daemon,(a?.baseUrl??void 0)!==(i?.baseUrl??void 0)||(a?.transport??void 0)!==(i?.transport??void 0)||(a?.serverMode??void 0)!==(i?.serverMode??void 0)))&&!d.force)throw new h("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:p,remoteConfig:v.remoteConfigPath});let y=new Date().toISOString(),I={version:1,session:p,remoteConfigPath:c.remoteConfigPath,remoteConfigHash:g,daemon:w,tenant:u,runId:f,leaseId:v&&!d.force?v.leaseId:void 0,leaseBackend:v&&!d.force?v.leaseBackend:eY(d),platform:d.platform??(v&&!d.force?v.platform:void 0),target:d.target??(v&&!d.force?v.target:void 0),runtime:v&&!d.force?v.runtime:void 0,metro:v&&!d.force?v.metro:void 0,connectedAt:v&&!d.force?v.connectedAt:y,updatedAt:y};eP({stateDir:l,state:I}),v&&d.force&&(await eJ(v.metro),await ez({stateDir:l,state:v}),await eZ(t,v));let A=tv(I),_=function(e,t){if(!t.runtime&&(eX(e)||tI(t.remoteConfigPath)))return ty(t.remoteConfigPath)}(d,I);return tf(d,tA(I,_),()=>[`Connected remote session "${p}" tenant "${u}" run "${f}" ${I.leaseId?`lease ${I.leaseId}`:"lease pending"}`,A?.message,_?.message].filter(e=>!!e).join("\n")),!0},tp=async({flags:e,client:t})=>{let{session:n,stateDir:o,state:r}=th(e);if(!r)return tw(e,n),!0;let s=r.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await eJ(r.metro),await ez({stateDir:o,state:r});let a=!1;if(r.leaseId)try{a=(await t.leases.release({tenant:r.tenant,runId:r.runId,leaseId:r.leaseId})).released}catch{}return eT({stateDir:o,session:s}),tf(e,{connected:!1,session:s,released:a},()=>`Disconnected remote session "${s}".`),!0},tg=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new h("INVALID_ARGS","connection accepts only: status");let{session:n,state:o}=th(t);if(!o)return tw(t,n),!0;let r=tv(o),s=function(e){if(!e.runtime&&tI(e.remoteConfigPath))return ty(e.remoteConfigPath)}(o);return tf(t,tA(o,s),()=>[`Connected remote session "${o.session}".`,`tenant=${o.tenant} runId=${o.runId} leaseId=${o.leaseId??"pending"} backend=${o.leaseBackend??"pending"}`,`remoteConfig=${o.remoteConfigPath}`,o.runtime?"metro=prepared":"metro=not-prepared",r?.message,s?.message].filter(e=>!!e).join("\n")),!0};function th(e){let t=e.session??"default",n=N(e.stateDir).baseDir;return{session:t,stateDir:n,state:eE({stateDir:n,session:t})??(e.session?null:eO({stateDir:n}))}}function tw(e,t){tf(e,{connected:!1,session:t},()=>`No remote connection for "${t}".`)}function tv(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 ty(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 tI(e){try{let t=r({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 o=tv(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},...o?{leasePreparation:o}:{},...t?{runtimePreparation:t}:{},connectedAt:e.connectedAt,updatedAt:e.updatedAt}}let t_=async({positionals:e,flags:n})=>{let o=e[0]??"status",r=N(n.stateDir).baseDir;if("status"===o){var s;let e,t=(e=e5({stateDir:(s={stateDir:r}).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:ti(e.expiresAt,s.now)}:{authenticated:!1,source:"none"};return tf(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"===o){let e=await e9({stateDir:r,flags:n,commandLabel:"agent-device auth login"});return tf(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"===o){let e,o=(e=e6({stateDir:r}.stateDir),!!t.existsSync(e)&&(t.rmSync(e,{force:!0}),!0));return tf(n,{authenticated:!1,removed:o},()=>o?"Removed stored cloud CLI session.":"No stored cloud CLI session."),!0}throw new h("INVALID_ARGS","auth accepts only: status, login, logout")},tS=new Set(["id","text","label"]),tk=new Set(["enabled","selected"]),tD={open:function(e){var t,n,o;let r,s,a,[i,l]=e.positionals;if(!i)return{kind:"unsupported",message:"open requires an app id or URL"};if(tT(i))return{kind:"commands",commands:[{openLink:i}]};let c=(t=e,n=i,(a=(o=t,r=o.flags?.launchArgs,s={},o.flags?.relaunch===!0&&(s.stopApp=!0),o.flags?.clearAppState===!0&&(s.clearState=!0),Array.isArray(r)&&r.length>0&&(s.launchArguments=r),Object.keys(s).length>0?s:void 0))?{launchApp:{appId:n,...a}}:"launchApp");return l&&tT(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:tC,press:tC,longpress:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"longpress requires a target"};let o=tR(t,n);return o?{kind:"commands",commands:[{longPressOn:o}],warnings:(function(e){let[t,n,o]=e.positionals,r=tx(t)&&tx(n)?o:n;return r&&tx(r)?[Number(r)]:[]})(e).map(tN)}:{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 o=tR(t);return o?{kind:"commands",commands:[{tapOn:o},{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 o=0!==(t=n).length&&[...t].every(e=>"\b"===e)?t.length:null;return null!==o?{kind:"commands",commands:[{eraseText:o}]}:{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(tx(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:tP(e,17e3)}}]};let o=tU(t);return o?{kind:"commands",commands:[{extendedWaitUntil:{visible:o,timeout:tP(e,17e3)}}]}:{kind:"unsupported",message:"wait selector is not Maestro-compatible"}},find:function(e){let[t,n,o]=e.positionals;return"text"===t&&n&&o?"exists"===o?{kind:"commands",commands:[{assertVisible:n}]}:"missing"===o||"not-exists"===o?{kind:"commands",commands:[{assertNotVisible:n}]}:{kind:"unsupported",message:`find text assertion "${o}" 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 o,r=function(e){let[t,n,o,r,s]=e.positionals;if(tx(t)&&tx(n)&&tx(o)&&tx(r))return{start:O(t,n),end:O(o,r),...s&&tx(s)?{duration:Number(s)}:{}}}(e);if(!r)return{kind:"unsupported",message:"only coordinate swipe exports to Maestro"};let s=(t=e,Number.isInteger(o=t.flags?.count??1)&&o>=1?o: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:r}))}}};function tC(e){var t,n,o,r,s;let a,i,[l,c]=e.positionals;if(!l)return{kind:"unsupported",message:`${e.command} requires a target`};let d=tR(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:(o=t,i={},"number"==typeof o.flags?.count&&o.flags.count>1&&(i.repeat=o.flags.count),"number"==typeof o.flags?.intervalMs&&o.flags.intervalMs>0&&(i.delay=o.flags.intervalMs),i)};return u.ok?e.flags?.doubleTap===!0?{kind:"commands",commands:[{doubleTapOn:d}],warnings:tb(e,"doubleTapOn")}:"number"==typeof e.flags?.holdMs?{kind:"commands",commands:[{longPressOn:d}],warnings:[tN(e.flags.holdMs),...tb(e,"longPressOn")]}:{kind:"commands",commands:[(r=d,0===Object.keys(s=u.options).length?{tapOn:r}:"string"==typeof r?{tapOn:{text:r,...s}}:r&&"object"==typeof r&&!Array.isArray(r)?{tapOn:{...r,...s}}:{tapOn:r})]}:{kind:"unsupported",message:u.message}}function tN(e){return`long-press duration exports as Maestro longPressOn; Maestro uses its default long-press duration instead of ${e}ms`}function tb(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 tR(e,t){return tx(e)&&tx(t)?{point:O(e,t)}:e.startsWith("@")?null:tU(e)}function tU(e){let t;try{t=x(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&&tS.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 r of e.terms){var n,o;if(n=t,o=r,tS.has(o.key)?"string"!=typeof o.value||!!n.id||!!n.text||!!n.label||(n[o.key]=o.value,!!0):!tk.has(o.key)||"boolean"!=typeof o.value||(n[o.key]=o.value,!!0))return null}return Object.keys(t).length>0?t:null}(t.selectors[0])}function tE(e,t,n,o){for(let r of t??[])e.warnings.push({line:o,action:tL(n),message:r})}function tP(e,t){let n=e.positionals.at(-1);return n&&tx(n)?Number(n):t}function tL(e){return[e.command,...e.positionals??[]].join(" ").trim()}function tT(e){return/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(e)}function tx(e){return void 0!==e&&Number.isFinite(Number(e))}let tB=async e=>{let{positionals:t}=e;return"export"!==t[0]?function({positionals:e,flags:t}){if(e.length>1)throw new h("INVALID_ARGS","replay accepts exactly one input path: replay <path>");if(void 0!==t.replayExportFormat||void 0!==t.out)throw new h("INVALID_ARGS","replay --format/--out are only supported with replay export.");return!1}(e):await tM(e)};async function tM({positionals:e,flags:n}){let r;var s,a=e,i=n;if(a.length>2)throw new h("INVALID_ARGS","replay export accepts exactly one input path: replay export <file.ad>");if(i.replayUpdate)throw new h("INVALID_ARGS","replay export does not support --update.");if(i.replayMaestro)throw new h("INVALID_ARGS","replay export reads .ad files; omit --maestro.");if(i.replayEnv?.length)throw new h("INVALID_ARGS","replay export does not evaluate --env substitutions.");let l=i.replayExportFormat??"maestro";if("maestro"!==l)throw new h("INVALID_ARGS",`Unsupported replay export format: ${l}`);let c=e[1];if(!c)throw new h("INVALID_ARGS","replay export requires an input path.");let d=V(c),u=function(e,t={}){var n,o,r,s;let a={config:(n=t.metadata,n?.env&&Object.keys(n.env).length>0?{env:n.env}:{}),warnings:[],unsupported:[]},i=[];for(let[n,r]of e.entries()){let e=t.actionLines?.[n]??n+1,s=(o=r,tD[o.command]?.(o)??{kind:"unsupported",message:`${o.command} has no Maestro equivalent`});switch(s.kind){case"commands":i.push(...s.commands),tE(a,s.warnings,r,e);break;case"config":(function(e,t,n,o){if(!e.config.appId){e.config.appId=t;return}e.config.appId!==t&&e.unsupported.push({line:o,action:tL(n),message:`multiple app ids cannot be represented in one Maestro config (${e.config.appId} vs ${t})`})})(a,s.appId,r,e),i.push(...s.commands),tE(a,s.warnings,r,e);break;case"unsupported":a.unsupported.push({line:e,action:tL(r),message:s.message})}}if(a.unsupported.length>0)throw new h("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:(r=a.config,s=i,B(Object.keys(r).length>0?[r,s]:[s])),warnings:a.warnings}}((r=M(s=t.readFileSync(d,"utf8"))).actions,{actionLines:r.actionLines,metadata:$(s)}),f="string"==typeof n.out?V(n.out):void 0;for(let e of(f&&(t.mkdirSync(o.dirname(f),{recursive:!0}),t.writeFileSync(f,u.yaml)),u.warnings))process.stderr.write(`Warning: line ${e.line}: ${e.message}
-`);return tf(n,{format:n.replayExportFormat??"maestro",sourcePath:d,...f?{path:f}:{yaml:u.yaml},warnings:u.warnings},()=>f??u.yaml),!0}let tO={...Q,...z,...j,...q,...ee,...K,...eo,...ea,...W,...et,...Y,...en,...es,...X};async function t$(e){return(await tV(e)).result}async function tV(e){var t,n,o;let r=(t=e.command,n=e.positionals,o=e.flags,tO[t](n,o)),s=await el(e.client,e.command,r);return{result:s,cliOutput:ei({name:e.command,input:r,result:s})}}let tG={connect:tm,disconnect:tp,connection:tg,auth:t_,replay:tB,screenshot:async({positionals:e,flags:t,client:n})=>{let o=await t$({client:n,command:"screenshot",positionals:e,flags:t});return tf(t,{path:o.path,...o.overlayRefs?{overlayRefs:o.overlayRefs}:{}},()=>o.overlayRefs?`Annotated ${o.overlayRefs.length} refs onto ${o.path}`:o.path),!0},diff:async({positionals:e,flags:t,client:n})=>{var o;if("snapshot"===e[0]){let o=await t$({client:n,command:"diff",positionals:e,flags:t});return tf(t,o,()=>E(o)),!0}if("screenshot"!==e[0])return!1;let r=t.baseline;if(!r||"string"!=typeof r)throw new h("INVALID_ARGS","diff screenshot requires --baseline <path>");let s=V(r),a="string"==typeof t.out?V(t.out):void 0,i=e[1];if(e.length>2)throw new h("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let l=eu({backend:(o=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 r=await o.capture.screenshot({path:t,session:e.session,overlayRefs:n?.overlayRefs,fullscreen:n?.fullscreen,stabilize:n?.stabilize,surface:n?.surface});return{path:r.path,...r.overlayRefs?{overlayRefs:r.overlayRefs}:{}}}}),artifacts:ec(),sessions:{get:e=>({name:e}),set:()=>{}},policy:ed()}),c=await l.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:s},current:i?{kind:"path",path:V(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 tf(t,c,()=>P(c)),!0}};async function tj(e){let t={...e.flags},n=tG[e.command];return!!(n&&await n({...e,flags:t}))||!!c(e.command)&&await tK({...e,command:e.command,flags:t})}async function tK(e){let{runGenericClientBackedCommand:t}=await import("./generic.js");return await t(e)}function tF(e,t,n){return n||(e.push(t),"")}async function tH(e,t,n){let{flags:o}=t,r=function(e){var t;if(!e?.metroProxyBaseUrl||"android-instance"!==(t=e.leaseBackend)&&"ios-instance"!==t)return null;let n=[],o={serverBaseUrl:tF(n,"metroProxyBaseUrl",e.metroProxyBaseUrl),bearerToken:tF(n,"metroBearerToken",e.metroBearerToken),tenantId:tF(n,"tenant",e.tenant),runId:tF(n,"runId",e.runId),leaseId:tF(n,"leaseId",e.leaseId)};if(n.length>0)throw new h("INVALID_ARGS",`react-devtools remote bridge requires ${n.join(", ")}.`,{missing:n});return o}(o);if(!r)return n();let s=t.stateDir??process.cwd(),a=t.session??o?.session??"default",i=o?.remoteConfig??`${r.tenantId}:${r.runId}:${r.leaseId}`;if("stop"===e[0])try{return await n()}finally{await eU({projectRoot:t.cwd??process.cwd(),stateDir:s,profileKey:i,consumerKey:a})}return await eR({projectRoot:t.cwd??process.cwd(),stateDir:s,serverBaseUrl:r.serverBaseUrl,bearerToken:r.bearerToken,bridgeScope:{tenantId:r.tenantId,runId:r.runId,leaseId:r.leaseId},session:a,profileKey:i,consumerKey:a,env:t.env??process.env}),await n()}async function tq(e,t={}){let n=t.cwd??process.cwd(),o=t.env??process.env,r=await tH(e,t,async()=>(await R("npm",["exec","--yes","--package","agent-react-devtools@0.4.0","--","agent-react-devtools",...e],{cwd:n,env:o,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode);var s,a=t.flags;return 0!==r&&"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"),r}function tW(e,t={}){let n=tJ(t),o={...e};return n.defaultPlatform&&void 0===o.platform&&(o.platform=n.defaultPlatform),o}function tJ(e){var t,n,o,r;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 h("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,o=a,r=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 h("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}(o.AGENT_DEVICE_SESSION_LOCK))||(n?.sessionLocked===!0||r?"reject":void 0))}}let tz={sendToDaemon:ep},tZ=new Set(["launchUrl","kind","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),tY=new Set(["connect","connection","close","disconnect","metro","session"]);async function tX(e,n=tz){let a=_(),l=ef(),c=function(e){try{let t=eS(e);return tQ(t.command??"",t.providedFlags)}catch{return e.includes("--debug")||e.includes("-v")||e.includes("--verbose")}}(e),d=e.includes("--json"),u=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 S({session:u,requestId:a,command:e[0],debug:c},async()=>{var u,m,y,I,A,_,S,b,R,U,E,P,x,B,M,O,$;let j,K,H,q,W,J,z;try{let n,s,a,l,c,d,p,g;u={cwd:process.cwd(),env:process.env},n=eS(e),s=u?.env??process.env,a=u?.cwd??process.cwd(),I=n.command,l=null!==I&&(m={remoteConfig:n.flags.remoteConfig,cwd:a,env:s}).remoteConfig?{...eK(r({configPath:m.remoteConfig,cwd:m.cwd,env:m.env}).profile),remoteConfig:m.remoteConfig}:{},p=eh((c=(y={command:n.command,cwd:a,cliFlags:n.flags,env:s}).env??process.env,d=eh({},function(e){let n={};for(let o of e)eh(n,function(e,n){let o,r;if(!t.existsSync(e)){if(n)throw new h("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{o=t.readFileSync(e,"utf8")}catch(t){throw new h("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{r=JSON.parse(o)}catch(t){throw new h("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!r||"object"!=typeof r||Array.isArray(r))throw new h("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let n={};for(let[o,r]of Object.entries(e)){if("installSource"===o){n.installSource=F(r,t);continue}let e=eI.get(o);if(!e)throw new h("INVALID_ARGS",`Unknown config key "${o}" in ${t}.`);if(!e.config.enabled)throw new h("INVALID_ARGS",`Unsupported config key "${o}" in ${t}.`);n[o]=i(e_(e),r,t,o)}return n}(r,`config file ${e}`)}(o.path,o.required));return n}((A=y.cwd,_=y.cliFlags.config,S=c,(g=_??S.AGENT_DEVICE_CONFIG)?[{path:(b=g,R=A,U=S,V(b,{cwd:R,env:U})),required:!0}]:[{path:(E=S,o.join(G("~",{env:E}),".agent-device","config.json")),required:!1},{path:o.resolve(A,"agent-device.json"),required:!1}]))),eh(d,function(e,t){var n,o,r;let s={};for(let a of ey.filter(e=>e.config.enabled&&e.supportsCommand(t))){if("installSource"===a.key)continue;let t=a.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(s[a.key]=(n=t.value,o=`environment variable ${t.name}`,r=t.name,i(e_(a),n,o,r)))}return s}(c,y.command))),l),j={...function(e,t){let n=t?.strictFlags??!0,o=[...e.warnings],r=eh({json:!1,help:!1,version:!1},t?.defaultFlags??{});eh(r,e.flags);let s=e.providedFlags.filter(t=>!eA(t.key,e.command));if(s.length>0){var a,i;let t=s.map(e=>e.token),l=(a=e.command,i=t,a?1===i.length?`Flag ${i[0]} is not supported for command ${a}.`:`Flags ${i.join(", ")} are not supported for command ${a}.`:1===i.length?`Flag ${i[0]} requires a command that supports it.`:`Flags ${i.join(", ")} require a command that supports them.`);if(n)throw new h("INVALID_ARGS",l);for(let e of(o.push(l),s))delete r[e.key]}for(let t of Object.keys(r))void 0!==r[t]&&(eA(t,e.command)||delete r[t]);if(function(e){if("back"===e.command&&!(new Set(e.providedFlags.filter(e=>"backMode"===e.key).map(e=>e.token)).size<=1))throw new h("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),f(e.command,r),"batch"===e.command&&1!=+!!r.steps+ +!!r.stepsFile)throw new h("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return function(e){if(e.flags.help)return e;if("snapshot"===e.command&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:"diff",positionals:["snapshot",...e.positionals],flags:n,warnings:e.warnings}}return e}({command:e.command,positionals:e.positionals,flags:r,warnings:o})}(n,{strictFlags:u?.strictFlags,defaultFlags:p}),providedFlags:n.providedFlags}}catch(t){C({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=g(t,{diagnosticId:k().diagnosticId,logPath:D({force:!0})??void 0});d?T({success:!1,error:e}):L(e,{showDetails:c}),process.exit(1);return}for(let e of j.warnings)process.stderr.write(`Warning: ${e}
-`);j.flags.version&&(process.stdout.write(`${l}
-`),process.exit(0));let Z="help"===j.command,Y=j.flags.help;if(Z||Y){Z&&j.positionals.length>1&&(L(new h("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=Z?j.positionals[0]:j.command;e||(process.stdout.write(`${v()}
-`),process.exit(0));let t=w(eN(e));t&&(process.stdout.write(t),process.exit(0)),L(new h("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${v()}
-`),process.exit(1)}j.command||(process.stdout.write(`${v()}
-`),process.exit(1));let{command:X,positionals:Q}=j,ee=tQ(X,j.providedFlags),et=new Set(j.providedFlags.map(e=>e.key));try{H=(K=tJ({policyOverrides:j.flags,configuredPlatform:j.flags.platform,configuredSession:j.flags.session})).lockPolicy?{...j.flags}:tW(j.flags,{policyOverrides:j.flags,configuredPlatform:j.flags.platform,configuredSession:j.flags.session}),q=N(H.stateDir),W=H.session??"default",P={command:X,explicitFlagKeys:et,stateDir:q.baseDir,session:W,remoteConfig:H.remoteConfig,hasResolvedSession:void 0!==H.session},z=(J="connect"===P.command||"connection"===P.command?null:function(e){let t=e.validateRemoteConfigHash??!0,n=e.remoteConfig?s({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,o=eE(e)??(e.allowActiveFallback?eO({stateDir:e.stateDir}):null);if(!o||n&&o.remoteConfigPath!==n)return null;if(t&&ex(o.remoteConfigPath)!==o.remoteConfigHash)throw new h("INVALID_ARGS","Active remote connection config changed. Run agent-device connect --force to refresh it.",{remoteConfig:o.remoteConfigPath});let a=function(e,t){try{return r({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(!1===t.validateRemoteConfigHash)return{};throw e}}(o,e);return{runtime:o.runtime,flags:{...a,remoteConfig:o.remoteConfigPath,daemonBaseUrl:o.daemon?.baseUrl??a.daemonBaseUrl,daemonTransport:o.daemon?.transport??a.daemonTransport,daemonServerMode:o.daemon?.serverMode??a.daemonServerMode,tenant:o.tenant,sessionIsolation:"tenant",runId:o.runId,leaseId:o.leaseId,leaseBackend:o.leaseBackend,session:o.session,platform:o.platform??a.platform,target:o.target??a.target}}}({stateDir:P.stateDir,session:P.session,remoteConfig:P.remoteConfig,cwd:process.cwd(),env:process.env,allowActiveFallback:!P.explicitFlagKeys.has("session")&&(!P.remoteConfig||"disconnect"===P.command||!P.hasResolvedSession),validateRemoteConfigHash:"disconnect"!==P.command}))?function(e,t,n){let o={...e};for(let[e,r]of Object.entries(t))void 0!==r&&(n.has(e)||(o[e]=r));return o}(H,J.flags,et):H}catch(t){let e=g(p(t),{diagnosticId:k().diagnosticId,logPath:D({force:!0})??void 0});j.flags.json?T({success:!1,error:e}):L(e,{showDetails:ee}),process.exit(1);return}let en=null;try{let e;if("react-devtools"===X){let e=await tq(Q,{flags:z,stateDir:q.baseDir,session:z.session??W,cwd:process.cwd(),env:process.env});process.exit(e);return}eg({command:X,currentVersion:l,stateDir:q.baseDir,flags:z});let o=J?.runtime,r=(e,t)=>({session:e.session,requestId:a,stateDir:e.stateDir,daemonBaseUrl:e.daemonBaseUrl,daemonAuthToken:e.daemonAuthToken,daemonTransport:e.daemonTransport,daemonServerMode:e.daemonServerMode,tenant:e.tenant,sessionIsolation:e.sessionIsolation,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,runtime:t,lockPolicy:K.lockPolicy,lockPlatform:K.defaultPlatform,cwd:process.cwd(),debug:ee});if("batch"===X){if(Q.length>0)throw new h("INVALID_ARGS","batch does not accept positional arguments.");e=function(e){let n,o,r,s="";if(e.steps)s=e.steps;else if(e.stepsFile)try{s=t.readFileSync(e.stepsFile,"utf8")}catch(n){let t=n instanceof Error?n.message:String(n);throw new h("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}var a,i=s;try{r=JSON.parse(i)}catch{throw new h("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(r)||0===r.length)throw new h("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return a=r,n=!1,o=a.map((e,t)=>{var o,r,s,a,i,l;let c;if(o=e,null!==o&&"object"==typeof o&&!Array.isArray(o)&&"input"in o&&!("positionals"in o)&&!("flags"in o))return e;let d=function(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new h("INVALID_ARGS",`Invalid batch step ${t}.`);var n=e,o=t;let r=Object.keys(n).filter(e=>!["command","positionals","flags","runtime"].includes(e));if(r.length>0)throw new h("INVALID_ARGS",`Batch step ${o} has unknown legacy field(s): ${r.join(", ")}.`);let s=function(e,t){let n="string"==typeof e?e.trim().toLowerCase():"";if(!n)throw new h("INVALID_ARGS",`Batch step ${t} requires command.`);if(er(n))return n;throw new h("INVALID_ARGS",`Batch step ${t} command is not available through command batch: ${String(e)}`)}(e.command,t),a=function(e,t){if(void 0!==e){if(!Array.isArray(e)||e.some(e=>"string"!=typeof e))throw new h("INVALID_ARGS",`Batch step ${t} positionals must contain only strings.`);return e}}(e.positionals,t),i=function(e,t){if(void 0!==e){if(!e||"object"!=typeof e||Array.isArray(e))throw new h("INVALID_ARGS",`Batch step ${t} flags must be an object.`);return e}}(e.flags,t);return{command:s,...void 0===a?{}:{positionals:a},...void 0===i?{}:{flags:i},...void 0===e.runtime?{}:{runtime:e.runtime}}}(e,t+1);return n=!0,c=(s=(r=d).command,a=r.positionals??[],l=r.flags,i={json:!1,help:!1,version:!1,...l},tO[s](a,i)),{command:r.command,input:c,...void 0===r.runtime?{}:{runtime:r.runtime}}}),n&&process.stderr.write('Warning: batch steps using positionals/flags are deprecated and will be removed in the next major version. Use {"command":"...","input":{...}} steps instead.\n'),o}(H)}if(x=X,"auth"!==x&&"connection"!==x&&(z=(await e8({command:X,flags:z,stateDir:q.baseDir,env:process.env})).flags),z.remoteConfig&&(B=X,!tY.has(B))){let t=em(r(z,o),{transport:n.sendToDaemon}),s=await eq({command:X,flags:z,client:t,runtime:o,batchSteps:e,forceRuntimePrepare:function(e){for(let t of tZ)if(e.has(t))return!0;return!1}(et)});z=s.flags,o=s.runtime}M={command:X,flags:z,runtime:o,explicitFlagKeys:et,hadConnectionDefaults:!!J},!("open"===M.command&&!M.runtime&&!M.flags.bundleUrl&&!M.flags.metroHost&&!M.flags.metroPort&&!M.flags.remoteConfig&&!M.hadConnectionDefaults&&((O=M.explicitFlagKeys).has("daemonBaseUrl")||O.has("daemonTransport")||O.has("tenant")||O.has("sessionIsolation")||O.has("runId")||O.has("leaseId")||O.has("leaseBackend")))||process.stderr.write("Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.\n");let s=z.daemonBaseUrl;en=!ee||z.json||s?null:function(e){try{let n=t.existsSync(e)?t.statSync(e).size:0,o=!1,r=setInterval(()=>{if(!o&&t.existsSync(e))try{let o=t.statSync(e);if(o.size<n&&(n=0),o.size<=n)return;let r=t.openSync(e,"r");try{let e=Buffer.alloc(o.size-n);t.readSync(r,e,0,e.length,n),n=o.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{t.closeSync(r)}}catch{}},200);return()=>{o=!0,clearInterval(r)}}catch{return null}}(q.logPath);let i=em(r(z,o),{transport:function(e){let{command:t,flags:n,transport:o}=e;return"test"!==t||n.json?o:async e=>await o({...e,meta:{...e.meta,requestProgress:"replay-test"}})}({command:X,flags:z,transport:n.sendToDaemon})});if("batch"===X){if(!e)throw new h("INVALID_ARGS","batch requires --steps or --steps-file.");let t=e.map((e,t)=>({...e,input:K.lockPolicy&&void 0===H.platform?{...e.input}:tW(e.input,{policyOverrides:z,configuredPlatform:z.platform,configuredSession:z.session,inheritedPlatform:z.platform})}));if(await tj({command:X,positionals:Q,flags:{...z,batchSteps:t},client:i,debug:ee}))return}else if("runtime"===X)throw new h("INVALID_ARGS","runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.");else if(await tj({command:X,positionals:Q,flags:z,client:i,debug:ee}))return;throw new h("INVALID_ARGS",`Unknown command: ${X}`)}catch(o){let e=p(o),n=g(e,{diagnosticId:k().diagnosticId,logPath:D({force:!0})??void 0});if("close"===X&&"COMMAND_FAILED"===($=e).code&&($.details?.kind==="daemon_startup_failed"||$.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof $.details?.infoPath||"string"==typeof $.details?.lockPath))){z.json&&T({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(z.json)T({success:!1,error:n});else if(L(n,{showDetails:ee}),ee)try{let e=q.logPath;if(t.existsSync(e)){let n=t.readFileSync(e,"utf8").split("\n"),o=n.slice(Math.max(0,n.length-200)).join("\n");o.trim().length>0&&process.stderr.write(`
+`)}}function tw(e,t){(e?.stderr??process.stderr).write(t)}function tv(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function ty(e){return"string"==typeof e&&e.trim().length>0}async function tI(e){await new Promise(t=>setTimeout(t,e))}async function tA(e){let r=await ta({stateDir:e.stateDir,flags:e.flags,env:e.env,io:{env:e.env,fetch:e.fetchImpl}}),o=await tS({cloudBaseUrl:r.cloudBaseUrl,accessToken:r.accessToken,fetchImpl:e.fetchImpl}),a=function(e){try{return c(e)}catch(n){let t=y(n);throw new A("COMMAND_FAILED","Cloud connection profile returned invalid remote config.",{generatedConfigPath:e.configPath,cause:t.message},t)}}({configPath:function(e){var r;let o=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=s.join(e.stateDir,"remote-connections","generated");t.mkdirSync(a,{recursive:!0,mode:448});let i=s.join(a,`cloud-${(r=o,n.createHash("sha256").update(JSON.stringify(r)).digest("hex").slice(0,16))}.json`);t.writeFileSync(i,`${JSON.stringify(o,null,2)}
+`,{mode:384});try{t.chmodSync(i,384)}catch{}return i}({stateDir:e.stateDir,profile:o}),cwd:e.cwd,env:e.env});return{flags:{...e0(a.profile),...e.flags,remoteConfig:a.resolvedPath,daemonAuthToken:r.accessToken},remoteConfigPath:a.resolvedPath}}async function tS(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 tr(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 A("COMMAND_FAILED","Cloud connection profile response is invalid.");let o=r.connection;if(!o||"object"!=typeof o)throw new A("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 A("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is invalid.");if(0===Object.keys(s).length)throw new A("COMMAND_FAILED","Cloud connection profile remoteConfigProfile is empty.");return s}throw new A("COMMAND_FAILED","Cloud connection profile did not include remoteConfigProfile.")}function t_(e,t,n){var r;if(e.json)return void V({success:!0,data:t});let o=n?.();o&&(r=o,process.stdout.write(r.endsWith("\n")?r:`${r}
+`))}let tk=async({flags:e,client:t})=>{var r,o,s,a;let i=T(e.stateDir).baseDir,l=e.remoteConfig?function(e){if(!e.remoteConfig)throw new A("INVALID_ARGS","connect requires --remote-config <path>.");let t=c({configPath:e.remoteConfig,cwd:process.cwd(),env:process.env});return{flags:e,remoteConfigPath:t.resolvedPath}}(e):await tA({flags:e,stateDir:i,cwd:process.cwd(),env:process.env}),d=l.flags,u=d.tenant,f=d.runId;if(!u)throw new A("INVALID_ARGS","connect requires tenant in remote config or via --tenant <id>.");if(!f)throw new A("INVALID_ARGS","connect requires runId in remote config or via --run-id <id>.");if(!d.daemonBaseUrl)throw new A("INVALID_ARGS","connect requires daemonBaseUrl in remote config, config, env, or --daemon-base-url.");let m=d.session?null:ez({stateDir:i}),p=d.session??m?.session??function(e){for(let t=0;t<8;t+=1){let t=`adc-${n.randomBytes(3).toString("hex")}`;if(!ej({stateDir:e,session:t}))return t}return`adc-${Date.now().toString(36)}-${n.randomBytes(2).toString("hex")}`}(i),g=eq(l.remoteConfigPath),h=eH(d),w=m?.session===p?m:ej({stateDir:i,session:p});if(w&&(r=w,o={flags:d,session:p,remoteConfigPath:l.remoteConfigPath,remoteConfigHash:g,desiredLeaseBackend:e6(d),daemon:h},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 A("INVALID_ARGS","A different remote connection is already active for this session. Re-run connect with --force to replace it.",{session:p,remoteConfig:w.remoteConfigPath});let v=new Date().toISOString(),y={version:1,session:p,remoteConfigPath:l.remoteConfigPath,remoteConfigHash:g,daemon:h,tenant:u,runId:f,leaseId:w&&!d.force?w.leaseId:void 0,leaseBackend:w&&!d.force?w.leaseBackend:e6(d),platform:d.platform??(w&&!d.force?w.platform:void 0),target:d.target??(w&&!d.force?w.target:void 0),runtime:w&&!d.force?w.runtime:void 0,metro:w&&!d.force?w.metro:void 0,connectedAt:w&&!d.force?w.connectedAt:v,updatedAt:v};eK({stateDir:i,state:y}),w&&d.force&&(await e4(w.metro),await e5({stateDir:i,state:w}),await e7(t,w));let I=tR(y),S=function(e,t){if(!t.runtime&&(e9(e)||tE(t.remoteConfigPath)))return tU(t.remoteConfigPath)}(d,y);return t_(d,tx(y,S),()=>[`Connected remote session "${p}" tenant "${u}" run "${f}" ${y.leaseId?`lease ${y.leaseId}`:"lease pending"}`,I?.message,S?.message].filter(e=>!!e).join("\n")),!0},tD=async({flags:e,client:t})=>{let{session:n,stateDir:r,state:o}=tN(e);if(!o)return tb(e,n),!0;let s=o.session;try{await t.sessions.close({shutdown:e.shutdown})}catch{}await e4(o.metro),await e5({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 eF({stateDir:r,session:s}),t_(e,{connected:!1,session:s,released:a},()=>`Disconnected remote session "${s}".`),!0},tC=async({positionals:e,flags:t})=>{if("status"!==e[0])throw new A("INVALID_ARGS","connection accepts only: status");let{session:n,state:r}=tN(t);if(!r)return tb(t,n),!0;let o=tR(r),s=function(e){if(!e.runtime&&tE(e.remoteConfigPath))return tU(e.remoteConfigPath)}(r);return t_(t,tx(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 tN(e){let t=e.session??"default",n=T(e.stateDir).baseDir;return{session:t,stateDir:n,state:ej({stateDir:n,session:t})??(e.session?null:ez({stateDir:n}))}}function tb(e,t){t_(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 tU(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 tE(e){try{let t=c({configPath:e,cwd:process.cwd(),env:process.env}).profile;return!!(t.metroPublicBaseUrl||t.metroProxyBaseUrl||t.metroProjectRoot||t.metroKind)}catch{return!1}}function tx(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 tT=async({positionals:e,flags:n})=>{let r=e[0]??"status",o=T(n.stateDir).baseDir;if("status"===r){var s;let e,t=(e=tl({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:tv(e.expiresAt,s.now)}:{authenticated:!1,source:"none"};return t_(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 ti({stateDir:o,flags:n,commandLabel:"agent-device auth login"});return t_(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=tc({stateDir:o}.stateDir),!!t.existsSync(e)&&(t.rmSync(e,{force:!0}),!0));return t_(n,{authenticated:!1,removed:r},()=>r?"Removed stored cloud CLI session.":"No stored cloud CLI session."),!0}throw new A("INVALID_ARGS","auth accepts only: status, login, logout")},tP="/agent-device/",tL=["content-type","x-artifact-type","x-artifact-filename"],tB=["content-type","content-disposition","x-request-id"];async function t$(e,t,n){var r,o,s,a,i,l,c;let d,u,f,m="/agent-device"===(d=new URL(e.url??"/","http://127.0.0.1").pathname)?"/":d.startsWith(tP)?`/${d.slice(tP.length)}`:d;if("GET"===e.method&&"/health"===m)return void await tM(t,n);if(r=m,o=e.method,"/rpc"===r||"/upload"===r?"POST"!==o:!r.startsWith("/artifacts/")||"GET"!==o){t.statusCode=404,t.end("Not found");return}("/rpc"===m&&(f=(await tK(e,n.maxRpcBodyBytes)).toString("utf8")),s=e,a=n.clientToken,(u=function(e,t){let n="string"==typeof e.headers.authorization?e.headers.authorization:"";if(n.toLowerCase().startsWith("bearer "))return n.slice(7);let r=e.headers["x-agent-device-token"];if("string"==typeof r)return r;if(t){let e=function(e){try{let t=JSON.parse(e);return"string"==typeof t.params?.token?t.params.token:""}catch{return""}}(t);if(e)return e}return""}(s,f)).length>0&&H(u,a))?await tV({req:e,res:t,route:m,options:n,rpcBody:f}):(i=t,l=m,c=function(e){if(!e)return null;try{return JSON.parse(e).id??null}catch{return null}}(f),(i.statusCode=401,i.setHeader("content-type","application/json"),"/rpc"===l)?i.end(JSON.stringify({jsonrpc:"2.0",id:c,error:{code:-32001,message:"Invalid proxy token",data:I(new A("UNAUTHORIZED","Invalid proxy token"))}})):i.end(JSON.stringify({ok:!1,error:"Invalid proxy token",code:"UNAUTHORIZED"})))}async function tM(e,t){let n=await tO(t);e.statusCode=200,e.setHeader("content-type","application/json"),e.end(JSON.stringify(x("agent-device-proxy",{upstream:n})))}async function tO(e){let t=new URL("health",`${e.upstreamBaseUrl}/`),n=await e.fetchImpl(t,{method:"GET",headers:tj({headers:{}},e.upstreamToken,"/health"),signal:AbortSignal.timeout(e.upstreamTimeoutMs)}),r=await n.text();try{return r?JSON.parse(r):{ok:n.ok,status:n.status}}catch{return{ok:n.ok,status:n.status}}}async function tV(e){var t,n,r;let s,a,c,{req:d,res:u,route:f,options:m,rpcBody:p}=e,g=(t=m.upstreamBaseUrl,n=f,r=d.url??"/",s=new URL(n.replace(/^\//,""),`${t}/`),(a=r.indexOf("?"))>=0&&(s.search=r.slice(a)),s),h=d.method??"GET",w=tj(d,m.upstreamToken,f),v=function(e,t,n,r){if("GET"!==e.method&&"HEAD"!==e.method){var o,s;let a;return"/rpc"===t?(o=n??"",s=r,(a=JSON.parse(o)).params={...a.params??{},token:s},JSON.stringify(a)):e}}(d,f,p,m.upstreamToken),y=await m.fetchImpl(g,{method:h,headers:w,signal:AbortSignal.timeout(m.upstreamTimeoutMs),...v?{body:v,duplex:"half"}:{}});for(let e of(u.statusCode=y.status,tB)){let t=y.headers.get(e);t&&u.setHeader(e,t)}(u.hasHeader("x-request-id")||u.setHeader("x-request-id","string"==typeof(c=d.headers["x-request-id"])&&c.trim()?c.trim().slice(0,128):o()),y.body)?await l(i.fromWeb(y.body),u):u.end()}function tG(e,t){let n=e.trim();if(!n)throw new A("INVALID_ARGS",`Proxy ${t} is required.`);return n}function tj(e,t,n){let r=new Headers;for(let t of tL){let n=e.headers[t];"string"==typeof n&&n.trim()&&r.set(t,n)}return"/rpc"!==n||r.has("content-type")||r.set("content-type","application/json"),r.set("authorization",`Bearer ${t}`),r.set("x-agent-device-token",t),r}async function tK(e,t){let n=[],r=0;for await(let o of e){let e=Buffer.isBuffer(o)?o:Buffer.from(o);if((r+=e.length)>t)throw new A("INVALID_ARGS","Proxy request body is too large.");n.push(e)}return Buffer.concat(n)}let tH=async({positionals:e,flags:t})=>{if(e.length>0)throw new A("INVALID_ARGS","proxy does not accept positional arguments.");let n=await tF(t);return t_(t,n,()=>{var e;return e=n,`agent-device proxy listening on ${e.proxyBaseUrl}
+daemon base URL: ${e.agentDeviceBaseUrl}
+daemon auth token: ${e.token}
+treat the daemon auth token as a secret; anyone with it can control the proxied daemon
+upstream local daemon: ${e.upstreamBaseUrl}
+state dir: ${e.stateDir}
+
+Remote client example:
+agent-device devices --daemon-base-url ${e.agentDeviceBaseUrl} --daemon-auth-token ${e.token}`}),await new Promise(()=>{}),!0};async function tF(e){var t,n,o,s,i,l;let c,d=z({session:"default",command:"proxy",positionals:[],flags:{stateDir:e.stateDir,daemonBaseUrl:"",daemonTransport:"http",daemonServerMode:"http"}}),u=await q(d),f=function(e){if(!e)throw new A("COMMAND_FAILED","Local daemon HTTP endpoint is unavailable.",{hint:"Retry after cleaning daemon state, or run proxy with a fresh --state-dir."});return`http://127.0.0.1:${e}`}(u.info.httpPort),m=(t=e,t.daemonAuthToken?.trim()||r(32).toString("hex")),p=(c={upstreamBaseUrl:function(e,t){try{let t=new URL(e);if("http:"!==t.protocol&&"https:"!==t.protocol)throw Error("unsupported protocol");return t.toString().replace(/\/+$/,"")}catch(n){throw new A("INVALID_ARGS",`Invalid ${t}`,{[t]:e},n)}}((n={upstreamBaseUrl:f,upstreamToken:u.info.token,clientToken:m}).upstreamBaseUrl,"upstreamBaseUrl"),upstreamToken:tG(n.upstreamToken,"upstreamToken"),clientToken:tG(n.clientToken,"clientToken"),maxRpcBodyBytes:n.maxRpcBodyBytes??1048576,upstreamTimeoutMs:n.upstreamTimeoutMs??3e5,fetchImpl:n.fetchImpl??fetch},a.createServer((e,t)=>{t$(e,t,c).catch(e=>{!function(e,t){if(e.headersSent)return e.destroy(t instanceof Error?t:void 0);let n=I(t);e.statusCode="INVALID_ARGS"===n.code?400:500,e.setHeader("content-type","application/json"),e.end(JSON.stringify({ok:!1,error:n.message,code:n.code}))}(t,e)})})),g=e.proxyHost?.trim()||"127.0.0.1",h=e.proxyPort??0;await (o=p,s=g,i=h,new Promise((e,t)=>{o.once("error",t),o.listen(i,s,()=>{o.off("error",t),e()})}));let w=p.address();if(!w||"string"==typeof w)throw new A("COMMAND_FAILED","Proxy did not bind to a TCP address.");let v=`http://${(l=w.address).includes(":")&&!l.startsWith("[")?`[${l}]`:l}:${w.port}`;return{proxyBaseUrl:v,agentDeviceBaseUrl:`${v}/agent-device`,token:m,upstreamBaseUrl:f,stateDir:d.paths.baseDir}}let tq=new Set(["id","text","label"]),tJ=new Set(["enabled","selected"]),tW={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(t8(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&&t8(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:tz,press:tz,longpress:function(e){let[t,n]=e.positionals;if(!t)return{kind:"unsupported",message:"longpress requires a target"};let r=tX(t,n);return r?{kind:"commands",commands:[{longPressOn:r}],warnings:(function(e){let[t,n,r]=e.positionals,o=t2(t)&&t2(n)?r:n;return o&&t2(o)?[Number(o)]:[]})(e).map(tZ)}:{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=tX(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(t2(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:t1(e,17e3)}}]};let r=tQ(t);return r?{kind:"commands",commands:[{extendedWaitUntil:{visible:r,timeout:t1(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(t2(t)&&t2(n)&&t2(r)&&t2(o))return{start:Q(t,n),end:Q(r,o),...s&&t2(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 tz(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=tX(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:tY(e,"doubleTapOn")}:"number"==typeof e.flags?.holdMs?{kind:"commands",commands:[{longPressOn:d}],warnings:[tZ(e.flags.holdMs),...tY(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 tZ(e){return`long-press duration exports as Maestro longPressOn; Maestro uses its default long-press duration instead of ${e}ms`}function tY(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 tX(e,t){return t2(e)&&t2(t)?{point:Q(e,t)}:e.startsWith("@")?null:tQ(e)}function tQ(e){let t;try{t=Z(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&&tq.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,tq.has(r.key)?"string"!=typeof r.value||!!n.id||!!n.text||!!n.label||(n[r.key]=r.value,!!0):!tJ.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 t0(e,t,n,r){for(let o of t??[])e.warnings.push({line:r,action:t3(n),message:o})}function t1(e,t){let n=e.positionals.at(-1);return n&&t2(n)?Number(n):t}function t3(e){return[e.command,...e.positionals??[]].join(" ").trim()}function t8(e){return/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(e)}function t2(e){return void 0!==e&&Number.isFinite(Number(e))}let t4=async e=>{let{positionals:t}=e;return"export"!==t[0]?function({positionals:e,flags:t}){if(e.length>1)throw new A("INVALID_ARGS","replay accepts exactly one input path: replay <path>");if(void 0!==t.replayExportFormat||void 0!==t.out)throw new A("INVALID_ARGS","replay --format/--out are only supported with replay export.");return!1}(e):await t5(e)};async function t5({positionals:e,flags:n}){let r;var o,a=e,i=n;if(a.length>2)throw new A("INVALID_ARGS","replay export accepts exactly one input path: replay export <file.ad>");if(i.replayUpdate)throw new A("INVALID_ARGS","replay export does not support --update.");if(i.replayMaestro)throw new A("INVALID_ARGS","replay export reads .ad files; omit --maestro.");if(i.replayEnv?.length)throw new A("INVALID_ARGS","replay export does not evaluate --env substitutions.");let l=i.replayExportFormat??"maestro";if("maestro"!==l)throw new A("INVALID_ARGS",`Unsupported replay export format: ${l}`);let c=e[1];if(!c)throw new A("INVALID_ARGS","replay export requires an input path.");let d=et(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,tW[r.command]?.(r)??{kind:"unsupported",message:`${r.command} has no Maestro equivalent`});switch(s.kind){case"commands":i.push(...s.commands),t0(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:t3(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),t0(a,s.warnings,o,e);break;case"unsupported":a.unsupported.push({line:e,action:t3(o),message:s.message})}}if(a.unsupported.length>0)throw new A("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,Y(Object.keys(o).length>0?[o,s]:[s])),warnings:a.warnings}}((r=X(o=t.readFileSync(d,"utf8"))).actions,{actionLines:r.actionLines,metadata:ee(o)}),f="string"==typeof n.out?et(n.out):void 0;for(let e of(f&&(t.mkdirSync(s.dirname(f),{recursive:!0}),t.writeFileSync(f,u.yaml)),u.warnings))process.stderr.write(`Warning: line ${e.line}: ${e.message}
+`);return t_(n,{format:n.replayExportFormat??"maestro",sourcePath:d,...f?{path:f}:{yaml:u.yaml},warnings:u.warnings},()=>f??u.yaml),!0}let t7={...ep,...ed,...er,...ei,...eg,...eo,...ev,...eA,...el,...eh,...ef,...ew,...eI,...em};async function t6(e){return(await t9(e)).result}async function t9(e){var t,n,r;let o=(t=e.command,n=e.positionals,r=e.flags,t7[t](n,r)),s=await e_(e.client,e.command,o);return{result:s,cliOutput:eS({name:e.command,input:o,result:s})}}let ne={connect:tk,disconnect:tD,connection:tC,auth:tT,proxy:tH,replay:t4,screenshot:async({positionals:e,flags:t,client:n})=>{let r=await t6({client:n,command:"screenshot",positionals:e,flags:t});return t_(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 t6({client:n,command:"diff",positionals:e,flags:t});return t_(t,r,()=>$(r)),!0}if("screenshot"!==e[0])return!1;let o=t.baseline;if(!o||"string"!=typeof o)throw new A("INVALID_ARGS","diff screenshot requires --baseline <path>");let s=et(o),a="string"==typeof t.out?et(t.out):void 0,i=e[1];if(e.length>2)throw new A("INVALID_ARGS","diff screenshot accepts at most one current screenshot path");let l=F({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:ek(),sessions:{get:e=>({name:e}),set:()=>{}},policy:j()}),c=await l.capture.diffScreenshot({session:t.session,baseline:{kind:"path",path:s},current:i?{kind:"path",path:et(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 t_(t,c,()=>M(c)),!0}};async function nt(e){let t={...e.flags},n=ne[e.command];return!!(n&&await n({...e,flags:t}))||!!p(e.command)&&await nn({...e,command:e.command,flags:t})}async function nn(e){let{runGenericClientBackedCommand:t}=await import("./generic.js");return await t(e)}function nr(e,t,n){return n||(e.push(t),"")}async function no(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:nr(n,"metroProxyBaseUrl",e.metroProxyBaseUrl),bearerToken:nr(n,"metroBearerToken",e.metroBearerToken),tenantId:nr(n,"tenant",e.tenant),runId:nr(n,"runId",e.runId),leaseId:nr(n,"leaseId",e.leaseId)};if(n.length>0)throw new A("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 eV({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 ns(e,t={}){let n=t.cwd??process.cwd(),r=t.env??process.env,o=await no(e,t,async()=>(await L("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}async function na(e,t){var n,r,o,s,a,i,l;switch(e[0]){case"setup":{t.flags.json||process.stdout.write("Setting up managed agent-browser backend (downloads if needed)...\n");let e=await G({stateDir:t.stateDir});return n=t.flags.json,r=e,n?V({success:!0,data:{status:ni(r)}}):process.stdout.write(`Managed web backend installed.
+agent-browser available at: ${r.binaryPath}
+`),0}case"doctor":{let e,n=await K({stateDir:t.stateDir});return o=t.flags.json,s=0===n.exitCode?"Web backend is healthy.":"Web backend doctor reported issues.",a=n,o?V({success:!0,data:"object"==typeof(l=e=(i=a).status)&&null!==l&&"socketDir"in l&&"installDir"in l&&"binaryPath"in l?{...i,status:ni(e)}:i}):process.stdout.write(`${s}
+`),n.exitCode}default:throw new A("INVALID_ARGS","web requires setup or doctor")}}function ni(e){let{socketDir:t,...n}=e;return n}function nl(e,t={}){let n=nc(t),r={...e};return n.defaultPlatform&&void 0===r.platform&&(r.platform=n.defaultPlatform),r}function nc(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 A("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 A("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}(r.AGENT_DEVICE_SESSION_LOCK))||(n?.sessionLocked===!0||o?"reject":void 0))}}let nd={sendToDaemon:J},nu=new Set(["launchUrl","kind","metroBearerToken","metroKind","metroListenHost","metroNoInstallDeps","metroNoReuseExisting","metroPreparePort","metroProbeTimeoutMs","metroProjectRoot","metroProxyBaseUrl","metroPublicBaseUrl","metroRuntimeFile","metroStartupTimeoutMs","metroStatusHost"]),nf=new Set(["connect","connection","close","disconnect","metro","proxy","session"]);async function nm(e,n=nd){let r=N(),o=eD(),a=function(e){try{let t=eP(e);return np(t.command??"",t.providedFlags)}catch{return e.includes("--debug")||e.includes("-v")||e.includes("--verbose")}}(e),i=e.includes("--json"),l=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 b({session:l,requestId:r,command:e[0],debug:a},async()=>{var l,u,m,p,g,h,v,k,D,C,N,b,x,P,L,B,$;let M,G,j,K,H,F,q;try{let n,r,o,a,i,d,y,I;l={cwd:process.cwd(),env:process.env},n=eP(e),r=l?.env??process.env,o=l?.cwd??process.cwd(),p=n.command,a=null!==p&&(u={remoteConfig:n.flags.remoteConfig,cwd:o,env:r}).remoteConfig?{...e0(c({configPath:u.remoteConfig,cwd:u.cwd,env:u.env}).profile),remoteConfig:u.remoteConfig}:{},y=eN((i=(m={command:n.command,cwd:o,cliFlags:n.flags,env:r}).env??process.env,d=eN({},function(e){let n={};for(let r of e)eN(n,function(e,n){let r,o;if(!t.existsSync(e)){if(n)throw new A("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{r=t.readFileSync(e,"utf8")}catch(t){throw new A("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 A("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 A("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=es(o,t);continue}let e=eE.get(r);if(!e)throw new A("INVALID_ARGS",`Unknown config key "${r}" in ${t}.`);if(!e.config.enabled)throw new A("INVALID_ARGS",`Unsupported config key "${r}" in ${t}.`);n[r]=f(eT(e),o,t,r)}return n}(o,`config file ${e}`)}(r.path,r.required));return n}((g=m.cwd,h=m.cliFlags.config,v=i,(I=h??v.AGENT_DEVICE_CONFIG)?[{path:(k=I,D=g,C=v,et(k,{cwd:D,env:C})),required:!0}]:[{path:(N=v,s.join(en("~",{env:N}),".agent-device","config.json")),required:!1},{path:s.resolve(g,"agent-device.json"),required:!1}]))),eN(d,function(e,t){var n,r,o;let s={};for(let a of eU.filter(e=>e.config.enabled&&e.supportsCommand(t))){if("installSource"===a.key)continue;let t=a.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(s[a.key]=(n=t.value,r=`environment variable ${t.name}`,o=t.name,f(eT(a),n,r,o)))}return s}(i,m.command))),a),M={...function(e,t){let n=t?.strictFlags??!0,r=[...e.warnings],o=eN({json:!1,help:!1,version:!1},t?.defaultFlags??{});eN(o,e.flags);let s=e.providedFlags.filter(t=>!ex(t.key,e.command));if(s.length>0){var a,i;let t=s.map(e=>e.token),l=(a=e.command,i=t,a?1===i.length?`Flag ${i[0]} is not supported for command ${a}.`:`Flags ${i.join(", ")} are not supported for command ${a}.`:1===i.length?`Flag ${i[0]} requires a command that supports it.`:`Flags ${i.join(", ")} require a command that supports them.`);if(n)throw new A("INVALID_ARGS",l);for(let e of(r.push(l),s))delete o[e.key]}for(let t of Object.keys(o))void 0!==o[t]&&(ex(t,e.command)||delete o[t]);if(function(e){if("back"===e.command&&!(new Set(e.providedFlags.filter(e=>"backMode"===e.key).map(e=>e.token)).size<=1))throw new A("INVALID_ARGS","back accepts only one explicit mode flag: use either --in-app or --system.")}(e),w(e.command,o),"batch"===e.command&&1!=+!!o.steps+ +!!o.stepsFile)throw new A("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return function(e){if(e.flags.help)return e;if("snapshot"===e.command&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:"diff",positionals:["snapshot",...e.positionals],flags:n,warnings:e.warnings}}return e}({command:e.command,positionals:e.positionals,flags:o,warnings:r})}(n,{strictFlags:l?.strictFlags,defaultFlags:y}),providedFlags:n.providedFlags}}catch(t){E({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=I(t,{diagnosticId:R().diagnosticId,logPath:U({force:!0})??void 0});i?V({success:!1,error:e}):O(e,{showDetails:a}),process.exit(1);return}for(let e of M.warnings)process.stderr.write(`Warning: ${e}
+`);M.flags.version&&(process.stdout.write(`${o}
+`),process.exit(0));let J="help"===M.command,z=M.flags.help;if(J||z){J&&M.positionals.length>1&&(O(new A("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=J?M.positionals[0]:M.command;e||(process.stdout.write(`${_()}
+`),process.exit(0));let t=S(eM(e));t&&(process.stdout.write(t),process.exit(0)),O(new A("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${_()}
+`),process.exit(1)}M.command||(process.stdout.write(`${_()}
+`),process.exit(1));let{command:Z,positionals:Y}=M,X=np(Z,M.providedFlags),Q=new Set(M.providedFlags.map(e=>e.key));try{j=(G=nc({policyOverrides:M.flags,configuredPlatform:M.flags.platform,configuredSession:M.flags.session})).lockPolicy?{...M.flags}:nl(M.flags,{policyOverrides:M.flags,configuredPlatform:M.flags.platform,configuredSession:M.flags.session}),K=T(j.stateDir),H=j.session??"default",b={command:Z,explicitFlagKeys:Q,stateDir:K.baseDir,session:H,remoteConfig:j.remoteConfig,hasResolvedSession:void 0!==j.session},q=(F="connect"===b.command||"connection"===b.command||"proxy"===b.command?null:function(e){let t=e.validateRemoteConfigHash??!0,n=e.remoteConfig?d({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,r=ej(e)??(e.allowActiveFallback?ez({stateDir:e.stateDir}):null);if(!r||n&&r.remoteConfigPath!==n)return null;if(t&&eq(r.remoteConfigPath)!==r.remoteConfigHash)throw new A("INVALID_ARGS","Active remote connection config changed. Run agent-device connect --force to refresh it.",{remoteConfig:r.remoteConfigPath});let o=function(e,t){try{return c({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(!1===t.validateRemoteConfigHash)return{};throw e}}(r,e);return{runtime:r.runtime,flags:{...o,remoteConfig:r.remoteConfigPath,daemonBaseUrl:r.daemon?.baseUrl??o.daemonBaseUrl,daemonTransport:r.daemon?.transport??o.daemonTransport,daemonServerMode:r.daemon?.serverMode??o.daemonServerMode,tenant:r.tenant,sessionIsolation:"tenant",runId:r.runId,leaseId:r.leaseId,leaseBackend:r.leaseBackend,session:r.session,platform:r.platform??o.platform,target:r.target??o.target}}}({stateDir:b.stateDir,session:b.session,remoteConfig:b.remoteConfig,cwd:process.cwd(),env:process.env,allowActiveFallback:!b.explicitFlagKeys.has("session")&&(!b.remoteConfig||"disconnect"===b.command||!b.hasResolvedSession),validateRemoteConfigHash:"disconnect"!==b.command}))?function(e,t,n){let r={...e};for(let[e,o]of Object.entries(t))void 0!==o&&(n.has(e)||(r[e]=o));return r}(j,F.flags,Q):j}catch(t){let e=I(y(t),{diagnosticId:R().diagnosticId,logPath:U({force:!0})??void 0});M.flags.json?V({success:!1,error:e}):O(e,{showDetails:X}),process.exit(1);return}let ee=null;try{let e;if("react-devtools"===Z){let e=await ns(Y,{flags:q,stateDir:K.baseDir,session:q.session??H,cwd:process.cwd(),env:process.env});process.exit(e);return}if("web"===Z){let e=await na(Y,{flags:q,stateDir:K.baseDir});process.exit(e);return}eC({command:Z,currentVersion:o,stateDir:K.baseDir,flags:q});let s=F?.runtime,a=(e,t)=>({session:e.session,requestId:r,stateDir:e.stateDir,daemonBaseUrl:e.daemonBaseUrl,daemonAuthToken:e.daemonAuthToken,daemonTransport:e.daemonTransport,daemonServerMode:e.daemonServerMode,tenant:e.tenant,sessionIsolation:e.sessionIsolation,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,runtime:t,lockPolicy:G.lockPolicy,lockPlatform:G.defaultPlatform,cwd:process.cwd(),debug:X});if("batch"===Z){if(Y.length>0)throw new A("INVALID_ARGS","batch does not accept positional arguments.");e=function(e){let n,r,o,s="";if(e.steps)s=e.steps;else if(e.stepsFile)try{s=t.readFileSync(e.stepsFile,"utf8")}catch(n){let t=n instanceof Error?n.message:String(n);throw new A("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}var a,i=s;try{o=JSON.parse(i)}catch{throw new A("INVALID_ARGS","Batch steps must be valid JSON.")}if(!Array.isArray(o)||0===o.length)throw new A("INVALID_ARGS","Batch steps must be a non-empty JSON array.");return a=o,n=!1,r=a.map((e,t)=>{var r,o,s,a,i,l;let c;if(r=e,null!==r&&"object"==typeof r&&!Array.isArray(r)&&"input"in r&&!("positionals"in r)&&!("flags"in r))return e;let d=function(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new A("INVALID_ARGS",`Invalid batch step ${t}.`);var n=e,r=t;let o=Object.keys(n).filter(e=>!["command","positionals","flags","runtime"].includes(e));if(o.length>0)throw new A("INVALID_ARGS",`Batch step ${r} has unknown legacy field(s): ${o.join(", ")}.`);let s=function(e,t){let n="string"==typeof e?e.trim().toLowerCase():"";if(!n)throw new A("INVALID_ARGS",`Batch step ${t} requires command.`);if(ey(n))return n;throw new A("INVALID_ARGS",`Batch step ${t} command is not available through command batch: ${String(e)}`)}(e.command,t),a=function(e,t){if(void 0!==e){if(!Array.isArray(e)||e.some(e=>"string"!=typeof e))throw new A("INVALID_ARGS",`Batch step ${t} positionals must contain only strings.`);return e}}(e.positionals,t),i=function(e,t){if(void 0!==e){if(!e||"object"!=typeof e||Array.isArray(e))throw new A("INVALID_ARGS",`Batch step ${t} flags must be an object.`);return e}}(e.flags,t);return{command:s,...void 0===a?{}:{positionals:a},...void 0===i?{}:{flags:i},...void 0===e.runtime?{}:{runtime:e.runtime}}}(e,t+1);return n=!0,c=(s=(o=d).command,a=o.positionals??[],l=o.flags,i={json:!1,help:!1,version:!1,...l},t7[s](a,i)),{command:o.command,input:c,...void 0===o.runtime?{}:{runtime:o.runtime}}}),n&&process.stderr.write('Warning: batch steps using positionals/flags are deprecated and will be removed in the next major version. Use {"command":"...","input":{...}} steps instead.\n'),r}(j)}if(x=Z,"auth"!==x&&"connection"!==x&&"proxy"!==x&&(q=(await to({command:Z,flags:q,stateDir:K.baseDir,env:process.env})).flags),q.remoteConfig&&(P=Z,!nf.has(P))){let t=W(a(q,s),{transport:n.sendToDaemon}),r=await e8({command:Z,flags:q,client:t,runtime:s,batchSteps:e,forceRuntimePrepare:function(e){for(let t of nu)if(e.has(t))return!0;return!1}(Q)});q=r.flags,s=r.runtime}L={command:Z,flags:q,runtime:s,explicitFlagKeys:Q,hadConnectionDefaults:!!F},!("open"===L.command&&!L.runtime&&!L.flags.bundleUrl&&!L.flags.metroHost&&!L.flags.metroPort&&!L.flags.remoteConfig&&!L.hadConnectionDefaults&&((B=L.explicitFlagKeys).has("daemonBaseUrl")||B.has("daemonTransport")||B.has("tenant")||B.has("sessionIsolation")||B.has("runId")||B.has("leaseId")||B.has("leaseBackend")))||process.stderr.write("Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.\n");let i=q.daemonBaseUrl;ee=!X||q.json||i?null:function(e){try{let n=t.existsSync(e)?t.statSync(e).size:0,r=!1,o=setInterval(()=>{if(!r&&t.existsSync(e))try{let r=t.statSync(e);if(r.size<n&&(n=0),r.size<=n)return;let o=t.openSync(e,"r");try{let e=Buffer.alloc(r.size-n);t.readSync(o,e,0,e.length,n),n=r.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{t.closeSync(o)}}catch{}},200);return()=>{r=!0,clearInterval(o)}}catch{return null}}(K.logPath);let l=W(a(q,s),{transport:function(e){let{command:t,flags:n,transport:r}=e;return"test"!==t||n.json?r:async e=>await r({...e,meta:{...e.meta,requestProgress:"replay-test"}})}({command:Z,flags:q,transport:n.sendToDaemon})});if("batch"===Z){if(!e)throw new A("INVALID_ARGS","batch requires --steps or --steps-file.");let t=e.map((e,t)=>({...e,input:G.lockPolicy&&void 0===j.platform?{...e.input}:nl(e.input,{policyOverrides:q,configuredPlatform:q.platform,configuredSession:q.session,inheritedPlatform:q.platform})}));if(await nt({command:Z,positionals:Y,flags:{...q,batchSteps:t},client:l,debug:X}))return}else if("runtime"===Z)throw new A("INVALID_ARGS","runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.");else if(await nt({command:Z,positionals:Y,flags:q,client:l,debug:X}))return;throw new A("INVALID_ARGS",`Unknown command: ${Z}`)}catch(r){let e=y(r),n=I(e,{diagnosticId:R().diagnosticId,logPath:U({force:!0})??void 0});if("close"===Z&&"COMMAND_FAILED"===($=e).code&&($.details?.kind==="daemon_startup_failed"||$.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof $.details?.infoPath||"string"==typeof $.details?.lockPath))){q.json&&V({success:!0,data:{closed:"session",source:"no-daemon"}});return}if(q.json)V({success:!1,error:n});else if(O(n,{showDetails:X}),X)try{let e=K.logPath;if(t.existsSync(e)){let n=t.readFileSync(e,"utf8").split("\n"),r=n.slice(Math.max(0,n.length-200)).join("\n");r.trim().length>0&&process.stderr.write(`
 [daemon log]
-${o}
-`)}}catch{}en&&en(),process.exit(1)}finally{en&&en()}})}function tQ(e,t){return t.some(t=>"verbose"===t.key&&("--debug"===t.token||"-v"===t.token||"test"!==e))}e(process.argv[1]??"").href===import.meta.url&&tX(process.argv.slice(2)).catch(e=>{L(g(p(e)),{showDetails:!0}),process.exit(1)});export{tX as runCli,tV as runCliCommandWithOutput,tf as writeCommandOutput};
+${r}
+`)}}catch{}ee&&ee(),process.exit(1)}finally{ee&&ee()}})}function np(e,t){return t.some(t=>"verbose"===t.key&&("--debug"===t.token||"-v"===t.token||"test"!==e))}e(process.argv[1]??"").href===import.meta.url&&nm(process.argv.slice(2)).catch(e=>{O(I(y(e)),{showDetails:!0}),process.exit(1)});export{nm as runCli,t9 as runCliCommandWithOutput,t_ as writeCommandOutput};

package/dist/src/contracts.d.ts

@@ -223,7 +223,7 @@ export declare function normalizeError(err: unknown, context?: {
     logPath?: string;
 }): NormalizedError;
 
-declare const PLATFORM_SELECTORS: readonly ["ios", "macos", "android", "linux", "apple"];
+declare const PLATFORM_SELECTORS: readonly ["ios", "macos", "android", "linux", "web", "apple"];
 
 declare type PlatformSelector = (typeof PLATFORM_SELECTORS)[number];
 

package/dist/src/index.d.ts

@@ -968,9 +968,9 @@ export declare type PinchOptions = DeviceCommandBaseOptions & {
 
 declare type Platform = (typeof PLATFORMS)[number];
 
-declare const PLATFORM_SELECTORS: readonly ["ios", "macos", "android", "linux", "apple"];
+declare const PLATFORM_SELECTORS: readonly ["ios", "macos", "android", "linux", "web", "apple"];
 
-declare const PLATFORMS: readonly ['ios', 'macos', 'android', 'linux'];
+declare const PLATFORMS: readonly ['ios', 'macos', 'android', 'linux', 'web'];
 
 declare type PlatformSelector = (typeof PLATFORM_SELECTORS)[number];
 
@@ -1045,13 +1045,16 @@ declare type ReactNativeCommandOptions = DeviceCommandBaseOptions & {
     action: 'dismiss-overlay';
 };
 
-declare type RecordingQuality = 5 | 6 | 7 | 8 | 9 | 10;
+declare const RECORDING_EXPORT_QUALITIES: readonly ['medium', 'high'];
+
+declare type RecordingExportQuality = (typeof RECORDING_EXPORT_QUALITIES)[number];
 
 export declare type RecordOptions = AgentDeviceRequestOverrides & {
     action: 'start' | 'stop';
     path?: string;
     fps?: number;
-    quality?: RecordingQuality;
+    maxSize?: number;
+    quality?: RecordingExportQuality;
     hideTouches?: boolean;
 };
 

package/dist/src/interaction.js

@@ -1 +1 @@
-import{__webpack_require__ as e}from"./rslib-runtime.js";import{createDaemonRuntimeSessionStore as t,setSessionSnapshot as r,dispatchCommand as a,ensureAndroidBlockingSystemDialogReady as n,isCommandSupportedOnDevice as s,errorResponse as o,recoverAndroidBlockingSystemDialog as i,getActiveAndroidSnapshotFreshness as l}from"./9722.js";import{createAgentDevice as c}from"./5299.js";import{asAppError as u,normalizeError as f,AppError as d}from"./733.js";import{dispatchGetViaRuntime as p,isAndroidEscapeError as g,createDaemonRuntimePolicy as m,assertAndroidPressStayedInApp as S,dispatchIsViaRuntime as k,isDirectIosSelectorFallbackError as y,refSnapshotFlagGuardResponse as _,readSimpleIosSelectorTarget as h}from"./selector-runtime.js";import{buttonTag as w,resolveClickButton as b,readFillTargetFromPositionals as v,getClickButtonValidationError as x,successText as N}from"./9873.js";import{interaction_snapshot_captureSnapshotForSession as F,readSnapshotNodesReferenceFrame as P,resolveDirectTouchReferenceFrameSafely as R,buildTouchVisualizationResult as M,finalizeTouchInteraction as O}from"./8184.js";import{emitDiagnostic as I}from"./432.js";import{PUBLIC_COMMANDS as C}from"./2133.js";var A={};function E(e,t){return"macos"!==e.device.platform||"desktop"!==e.surface&&"menubar"!==e.surface||"menubar"===e.surface&&("click"===t||"press"===t)?null:o("UNSUPPORTED_OPERATION",`${t} is not supported on macOS ${e.surface} sessions yet. Open an app session to act, or use the ${e.surface} surface to inspect.`)}function q(e){let n=e.sessionStore.get(e.sessionName);if(!n)throw new d("SESSION_NOT_FOUND","No active session. Run open first.");return c({backend:function(e){let{req:t,session:r}=e;return{platform:r.device.platform,captureSnapshot:async(a,n)=>({snapshot:await e.captureSnapshotForSession(r,t.flags,e.sessionStore,e.contextFromFlags,{interactiveOnly:n?.interactiveOnly===!0})}),tap:async(n,s)=>U(await a(r.device,"press",[String(s.x),String(s.y)],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),fill:async(n,s,o)=>U(await a(r.device,"fill",[String(s.x),String(s.y),o],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),longPress:async(n,s,o)=>U(await a(r.device,"longpress",[String(s.x),String(s.y),...o?.durationMs===void 0?[]:[String(o.durationMs)]],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),typeText:async(n,s)=>U(await a(r.device,"type",[s],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath)))}}({...e,session:n}),...m("interaction commands",{plural:!0}),sessions:t({sessionName:e.sessionName,getSession:()=>n,recordOptions:{includeSnapshot:!0},setRecord:t=>{t.snapshot&&(r(n,t.snapshot),e.sessionStore.set(e.sessionName,n))}})})}function U(e){return e&&"object"==typeof e?e:void 0}function D(e){if(e.length<2)return null;let t=Number(e[0]),r=Number(e[1]);return Number.isFinite(t)&&Number.isFinite(r)?{x:t,y:r}:null}function T(e,t){let r=D(e);if(r)return{ok:!0,target:{kind:"point",x:r.x,y:r.y}};let a=e[0]??"";if(a.startsWith("@"))return{ok:!0,target:{kind:"ref",ref:a,fallbackLabel:e.slice(1).join(" ").trim()}};let n=e.join(" ").trim();return n?{ok:!0,target:{kind:"selector",selector:n}}:{ok:!1,response:o("INVALID_ARGS",`${t} requires @ref, selector expression, or x y coordinates`)}}function H(e){return"ref"===e.kind?{ref:K(e.target?.kind==="ref"?e.target.ref:void 0),refLabel:e.refLabel,selectorChain:e.selectorChain}:"selector"===e.kind?{selector:e.target?.kind==="selector"?e.target.selector:void 0,selectorChain:e.selectorChain,refLabel:e.refLabel}:{}}function K(e){return e?.startsWith("@")?e.slice(1):e}async function L(e){switch(e.req.command){case"press":return await j(e,"press");case"click":return await j(e,"click");case"longpress":return await j(e,"longpress");case"fill":return await V(e);default:return null}}async function j(e,t){let r,{req:a,sessionName:n,sessionStore:i}=e,l=i.get(n);if(!l)return o("SESSION_NOT_FOUND","No active session. Run open first.");let c="click"===t?"click":t,u="longpress"===t?"longpress":"press",f=E(l,c);if(f)return f;if(!s(u,l.device))return o("UNSUPPORTED_OPERATION",`${u} is not supported on this device`);let d=b(a.flags),p=w(d);if("longpress"!==t&&"primary"!==d){let e=x({commandLabel:c,platform:l.device.platform,button:d,count:a.flags?.count,intervalMs:a.flags?.intervalMs,holdMs:a.flags?.holdMs,jitterPx:a.flags?.jitterPx,doubleTap:a.flags?.doubleTap});if(e)return o(e.code,e.message,e.details)}let g="longpress"===t?function(e){var t,r,a;let n,s=D(e);if(s){return{ok:!0,target:{kind:"point",x:s.x,y:s.y},...void 0===(t=e[2])?{}:{durationMs:Number(t)}}}let o=(n=(r=e).at(-1),r.length>1&&void 0!==(a=n)&&""!==a.trim()&&Number.isFinite(Number(a))?{targetPositionals:r.slice(0,-1),duration:{durationMs:Number(n)}}:{targetPositionals:r,duration:{}}),i=T(o.targetPositionals,"longpress");return i.ok?{ok:!0,target:i.target,...o.duration}:i}(a.positionals??[]):T(a.positionals??[],c);if(!g.ok)return g.response;if("ref"===g.target.kind){let n=e.refSnapshotFlagGuardResponse("longpress"===t?"longpress":"press",a.flags);if(n)return n;r=await z(e,l)}let m=function(e){var t;let{session:r,commandLabel:a,target:n,flags:s}=e;if("click"!==a||"selector"!==n.kind||(t=s,t?.count!==void 0||t?.intervalMs!==void 0||t?.holdMs!==void 0||t?.jitterPx!==void 0||t?.doubleTap!==void 0||t?.clickButton!==void 0&&"primary"!==t.clickButton))return null;let o=h({session:r,selectorExpression:n.selector});return o?{...o,...s?.maestro?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{}}:null}({session:l,commandLabel:c,target:g.target,flags:a.flags});if(m){let t=await W(e,l,m);if(t)return t}let k="longpress"===t?g.durationMs:void 0;return await Y(e,{androidFreshnessBaseline:r,run:async e=>await B({runtime:e,command:t,target:g.target,sessionName:n,requestId:a.meta?.requestId,clickButton:d,flags:a.flags,durationMs:k}),afterRun:async e=>{var t;await S(l,(t=g.target,"point"===t.kind?"coordinate tap":"ref"===e.kind&&e.target?.kind==="ref"?e.target.ref:"selector"===e.kind&&e.target?.kind==="selector"?e.target.selector:"target"))},buildPayloads:async r=>{var a;let n="durationMs"in(a=r)?a.durationMs:void 0,s=await G({params:e,session:l,result:r,extra:"longpress"===t?{...void 0!==n?{durationMs:n}:{},gesture:"longpress"}:p});return{result:s,responseData:s}}})}async function B(e){let{runtime:t,command:r,target:a,sessionName:n,requestId:s,flags:o}=e;if("longpress"===r)return await t.interactions.longPress(a,{session:n,requestId:s,durationMs:e.durationMs});let i={session:n,requestId:s,button:e.clickButton,count:o?.count,intervalMs:o?.intervalMs,holdMs:o?.holdMs,jitterPx:o?.jitterPx,doubleTap:o?.doubleTap};return"click"===r?await t.interactions.click(a,i):await t.interactions.press(a,i)}async function G(e){let{params:t,session:r,result:a,extra:n}=e,s="point"===a.kind?await R({session:r,flags:t.req.flags,sessionStore:t.sessionStore,contextFromFlags:t.contextFromFlags,captureSnapshotForSession:t.captureSnapshotForSession}):P(r.snapshot?.nodes??[]);return M({data:a.backendResult,fallbackX:a.point.x,fallbackY:a.point.y,referenceFrame:s,extra:{...H(a),...n}})}async function W(e,t,r){return await $({params:e,session:t,selector:r,command:"press",positionals:[],extra:{selector:r.raw},fallbackPhase:"ios_direct_selector_tap_fallback"})}async function $(e){let{params:t,session:r,selector:n,command:s,positionals:o,extra:i,fallbackPhase:l}=e,c=Date.now();try{var u,d;let e,l,f=await a(r.device,s,o,t.req.flags?.out,{...t.contextFromFlags(t.req.flags,r.appBundleId,r.trace?.outPath),directElementSelector:n,surface:r.surface})??{},p=Date.now(),g=(u=f,e="number"==typeof u.x?u.x:void 0,l="number"==typeof u.y?u.y:void 0,void 0!==e&&void 0!==l?{x:e,y:l}:{x:0,y:0}),m=M({data:f,fallbackX:g.x,fallbackY:g.y,referenceFrame:(d=f,"number"==typeof d.referenceWidth&&"number"==typeof d.referenceHeight?{referenceWidth:d.referenceWidth,referenceHeight:d.referenceHeight}:void 0),extra:{...i,...function(e,t){if(!e.allowNonHittableCoordinateFallback)return{};let r="tapped via non-hittable coordinate fallback"===t.message;return{maestroNonHittableCoordinateFallbackAllowed:!0,maestroNonHittableCoordinateFallbackUsed:r,...r?{maestroFallbackReason:"non-hittable-coordinate"}:{}}}(n,f)}});return O({session:r,sessionStore:t.sessionStore,command:t.req.command,positionals:t.req.positionals??[],retryPositionals:J(g),flags:t.req.flags,result:m,responseData:m,actionStartedAt:c,actionFinishedAt:p})}catch(e){if(!y(e))return{ok:!1,error:f(e)};return I({level:"debug",phase:l,data:{selector:n.raw,error:e instanceof Error?e.message:String(e)}}),null}}async function V(e){let{req:t,sessionName:r,sessionStore:a}=e,n=a.get(r);if(n){let e=E(n,"fill");if(e)return e}if(n&&!s("fill",n.device))return o("UNSUPPORTED_OPERATION","fill is not supported on this device");if(!n)return o("SESSION_NOT_FOUND","No active session. Run open first.");let i=function(e){let t=e[0]??"";if(t.startsWith("@")){var r;let a=v(e).text;return a?{ok:!0,target:{kind:"ref",ref:t,fallbackLabel:(r=e).length>=3&&r[1]?.trim()||""},text:a}:{ok:!1,response:o("INVALID_ARGS","fill requires text after ref")}}let a=D(e);if(a){let t=e.slice(2).join(" ");return t?{ok:!0,target:{kind:"point",x:a.x,y:a.y},text:t}:{ok:!1,response:o("INVALID_ARGS","fill requires text after coordinates")}}let n=v(e);return"selector"!==n.kind?{ok:!1,response:o("INVALID_ARGS","fill requires x y text, @ref text, or selector text")}:n.text.trim()?{ok:!0,target:{kind:"selector",selector:n.target.selector},text:n.text}:{ok:!1,response:o("INVALID_ARGS","fill requires text after selector")}}(t.positionals??[]);if(!i.ok)return i.response;if("ref"===i.target.kind){let r=e.refSnapshotFlagGuardResponse("fill",t.flags);if(r)return r;await z(e,n)}let l=function(e){let{session:t,target:r,flags:a}=e;if("selector"!==r.kind)return null;let n=h({session:t,selectorExpression:r.selector});return n?{...n,...a?.maestro?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{}}:null}({session:n,target:i.target,flags:t.flags});if(l){let t=await X(e,n,l,i.text);if(t)return t}return await Y(e,{run:async e=>await e.interactions.fill(i.target,i.text,{session:r,requestId:t.meta?.requestId,delayMs:t.flags?.delayMs}),buildPayloads:e=>{let t="point"===e.kind?void 0:P(n.snapshot?.nodes??[]),r=M({data:e.backendResult,fallbackX:e.point.x,fallbackY:e.point.y,referenceFrame:t,extra:{...H(e),text:i.text}});e.warning&&(r.warning=e.warning);let a="ref"===e.kind?{...e.backendResult??{ref:K(e.target?.kind==="ref"?e.target.ref:void 0),x:e.point.x,y:e.point.y}}:r;return e.warning&&(a.warning=e.warning),{result:r,responseData:a}}})}async function X(e,t,r,a){return await $({params:e,session:t,selector:r,command:"fill",positionals:[a],extra:{selector:r.raw,text:a},fallbackPhase:"ios_direct_selector_fill_fallback"})}async function Y(e,t){let r=e.sessionStore.get(e.sessionName);if(!r)return o("SESSION_NOT_FOUND","No active session. Run open first.");let a=q(e),s=Date.now();try{let o=await n({session:r,command:e.req.command,phase:"before-command"}),i=await t.run(a);await t.afterRun?.(i),await n({session:r,command:e.req.command,phase:"after-command"});let l=Date.now(),{result:c,responseData:u}=await t.buildPayloads(i);return"recovered"===o.status&&(c.warning=o.warning,u.warning=o.warning),O({session:r,sessionStore:e.sessionStore,command:e.req.command,positionals:e.req.positionals??[],retryPositionals:function(e,t){if("click"===e||"press"===e)return J(t.point)}(e.req.command,i),flags:e.req.flags,result:c,responseData:u,actionStartedAt:s,actionFinishedAt:l,androidFreshnessBaseline:t.androidFreshnessBaseline})}catch(t){let e=u(t);if(g(e))throw e;return{ok:!1,error:f(t)}}}async function z(e,t){if(!l(t))return;let r=t.snapshot?.comparisonSafe===!0?t.snapshot:void 0;try{await e.captureSnapshotForSession(t,e.req.flags,e.sessionStore,e.contextFromFlags,{interactiveOnly:!0,androidFreshnessMode:"ref-refresh"})}catch(t){I({level:"warn",phase:"android_ref_snapshot_refresh_failed",data:{command:e.req.command,error:t instanceof Error?t.message:String(t)}})}return r}function J(e){return[String(e.x),String(e.y)]}async function Q(e){let t=await L({...e,captureSnapshotForSession:F,refSnapshotFlagGuardResponse:_});if(t)return t;switch(e.req.command){case C.type:return await Z({...e,captureSnapshotForSession:F});case"get":return await p(e);case"is":return await k(e);default:return null}}async function Z(e){let{sessionName:t,sessionStore:r}=e,a=r.get(t);if(!a)return o("SESSION_NOT_FOUND","No active session. Run open first.");if(!s(C.type,a.device))return o("UNSUPPORTED_OPERATION","type is not supported on this device");let n=await ee(a);return n||await et(e,a)}async function ee(e){return"android"===e.device.platform&&e.recording&&"failed"===(await i({session:e})).status?o("COMMAND_FAILED","Android system dialog blocked the recording session"):null}async function et(e,t){let{req:r,sessionName:a,sessionStore:s}=e,o=(r.positionals??[]).join(" "),i=q(e),l=Date.now();try{let e=await n({session:t,command:r.command,phase:"before-command"}),c=await i.interactions.typeText(o,{session:a,requestId:r.meta?.requestId,delayMs:r.flags?.delayMs});await n({session:t,command:r.command,phase:"after-command"});let u=Date.now(),f={...c.backendResult??{},text:c.text,delayMs:c.delayMs,...N(c.message??`Typed ${Array.from(c.text).length} chars`)};return"recovered"===e.status&&(f.warning=e.warning),O({session:t,sessionStore:s,command:r.command,positionals:r.positionals??[],flags:r.flags,result:f,responseData:f,actionStartedAt:l,actionFinishedAt:u})}catch(e){return{ok:!1,error:f(e)}}}e.r(A),e.d(A,{handleInteractionCommands:()=>Q});export{A as interaction_namespaceObject};
+import{__webpack_require__ as e}from"./rslib-runtime.js";import{createDaemonRuntimeSessionStore as t,setSessionSnapshot as r,dispatchCommand as a,ensureAndroidBlockingSystemDialogReady as n,isCommandSupportedOnDevice as o,errorResponse as s,recoverAndroidBlockingSystemDialog as i,getActiveAndroidSnapshotFreshness as l}from"./9722.js";import{buttonTag as c,resolveClickButton as f,readFillTargetFromPositionals as u,getClickButtonValidationError as d,successText as p}from"./9873.js";import{createAgentDevice as g}from"./2577.js";import{asAppError as m,normalizeError as k,AppError as S}from"./733.js";import{dispatchGetViaRuntime as _,isAndroidEscapeError as y,createDaemonRuntimePolicy as w,assertAndroidPressStayedInApp as h,dispatchIsViaRuntime as b,isDirectIosSelectorFallbackError as v,refSnapshotFlagGuardResponse as N,readSimpleIosSelectorTarget as x}from"./selector-runtime.js";import{resolveWebProvider as F}from"./provider.js";import{interaction_snapshot_captureSnapshotForSession as R,readSnapshotNodesReferenceFrame as P,resolveDirectTouchReferenceFrameSafely as M,buildTouchVisualizationResult as O,finalizeTouchInteraction as C}from"./8184.js";import{emitDiagnostic as I}from"./432.js";import{PUBLIC_COMMANDS as A}from"./2133.js";var E={};function q(e,t){return"macos"!==e.device.platform||"desktop"!==e.surface&&"menubar"!==e.surface||"menubar"===e.surface&&("click"===t||"press"===t)?null:s("UNSUPPORTED_OPERATION",`${t} is not supported on macOS ${e.surface} sessions yet. Open an app session to act, or use the ${e.surface} surface to inspect.`)}function U(e){if(e.length<2)return null;let t=Number(e[0]),r=Number(e[1]);return Number.isFinite(t)&&Number.isFinite(r)?{x:t,y:r}:null}function T(e,t){let r=U(e);if(r)return{ok:!0,target:{kind:"point",x:r.x,y:r.y}};let a=e[0]??"";if(a.startsWith("@"))return{ok:!0,target:{kind:"ref",ref:a,fallbackLabel:e.slice(1).join(" ").trim()}};let n=e.join(" ").trim();return n?{ok:!0,target:{kind:"selector",selector:n}}:{ok:!1,response:s("INVALID_ARGS",`${t} requires @ref, selector expression, or x y coordinates`)}}function D(e){return"ref"===e.kind?{ref:H(e.target?.kind==="ref"?e.target.ref:void 0),refLabel:e.refLabel,selectorChain:e.selectorChain}:"selector"===e.kind?{selector:e.target?.kind==="selector"?e.target.selector:void 0,selectorChain:e.selectorChain,refLabel:e.refLabel}:{}}function H(e){return e?.startsWith("@")?e.slice(1):e}function K(e){let n=e.sessionStore.get(e.sessionName);if(!n)throw new S("SESSION_NOT_FOUND","No active session. Run open first.");return g({backend:function(e){let{req:t,session:r}=e,n=function(e){if("web"!==e.device.platform)return;let t=F();return t.clickRef||t.fillRef?t:void 0}(r);return{platform:r.device.platform,captureSnapshot:async(a,n)=>({snapshot:await e.captureSnapshotForSession(r,t.flags,e.sessionStore,e.contextFromFlags,{interactiveOnly:n?.interactiveOnly===!0,includeRects:n?.includeRects===!0})}),tap:async(n,o)=>L(await a(r.device,"press",[String(o.x),String(o.y)],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),tapTarget:n?.clickRef?async(e,t)=>(await n.clickRef?.(t.ref),{ref:H(t.ref)}):void 0,fill:async(n,o,s)=>L(await a(r.device,"fill",[String(o.x),String(o.y),s],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),fillTarget:n?.fillRef?async(e,t,r,a)=>(await n.fillRef?.(t.ref,r,a),{ref:H(t.ref),text:r,delayMs:a?.delayMs??0}):void 0,longPress:async(n,o,s)=>L(await a(r.device,"longpress",[String(o.x),String(o.y),...s?.durationMs===void 0?[]:[String(s.durationMs)]],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath))),typeText:async(n,o)=>L(await a(r.device,"type",[o],t.flags?.out,e.contextFromFlags(t.flags,r.appBundleId,r.trace?.outPath)))}}({...e,session:n}),...w("interaction commands",{plural:!0}),sessions:t({sessionName:e.sessionName,getSession:()=>n,recordOptions:{includeSnapshot:!0},setRecord:t=>{t.snapshot&&(r(n,t.snapshot),e.sessionStore.set(e.sessionName,n))}})})}function L(e){return e&&"object"==typeof e?e:void 0}async function j(e){switch(e.req.command){case"press":return await B(e,"press");case"click":return await B(e,"click");case"longpress":return await B(e,"longpress");case"fill":return await X(e);default:return null}}async function B(e,t){let r,{req:a,sessionName:n,sessionStore:i}=e,l=i.get(n);if(!l)return s("SESSION_NOT_FOUND","No active session. Run open first.");let u="click"===t?"click":t,p="longpress"===t?"longpress":"press",g=q(l,u);if(g)return g;if(!o(p,l.device))return s("UNSUPPORTED_OPERATION",`${p} is not supported on this device`);let m=f(a.flags),k=c(m);if("longpress"!==t&&"primary"!==m){let e=d({commandLabel:u,platform:l.device.platform,button:m,count:a.flags?.count,intervalMs:a.flags?.intervalMs,holdMs:a.flags?.holdMs,jitterPx:a.flags?.jitterPx,doubleTap:a.flags?.doubleTap});if(e)return s(e.code,e.message,e.details)}let S="longpress"===t?function(e){var t,r,a;let n,o=U(e);if(o){return{ok:!0,target:{kind:"point",x:o.x,y:o.y},...void 0===(t=e[2])?{}:{durationMs:Number(t)}}}let s=(n=(r=e).at(-1),r.length>1&&void 0!==(a=n)&&""!==a.trim()&&Number.isFinite(Number(a))?{targetPositionals:r.slice(0,-1),duration:{durationMs:Number(n)}}:{targetPositionals:r,duration:{}}),i=T(s.targetPositionals,"longpress");return i.ok?{ok:!0,target:i.target,...s.duration}:i}(a.positionals??[]):T(a.positionals??[],u);if(!S.ok)return S.response;if("ref"===S.target.kind){let n=e.refSnapshotFlagGuardResponse("longpress"===t?"longpress":"press",a.flags);if(n)return n;r=await J(e,l)}let _=function(e){var t;let{session:r,commandLabel:a,target:n,flags:o}=e;if("click"!==a||"selector"!==n.kind||(t=o,t?.count!==void 0||t?.intervalMs!==void 0||t?.holdMs!==void 0||t?.jitterPx!==void 0||t?.doubleTap!==void 0||t?.clickButton!==void 0&&"primary"!==t.clickButton))return null;let s=x({session:r,selectorExpression:n.selector});return s?{...s,...o?.maestro?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{}}:null}({session:l,commandLabel:u,target:S.target,flags:a.flags});if(_){let t=await $(e,l,_);if(t)return t}let y="longpress"===t?S.durationMs:void 0;return await z(e,{androidFreshnessBaseline:r,run:async e=>await G({runtime:e,command:t,target:S.target,sessionName:n,requestId:a.meta?.requestId,clickButton:m,flags:a.flags,durationMs:y}),afterRun:async e=>{var t;await h(l,(t=S.target,"point"===t.kind?"coordinate tap":"ref"===e.kind&&e.target?.kind==="ref"?e.target.ref:"selector"===e.kind&&e.target?.kind==="selector"?e.target.selector:"target"))},buildPayloads:async r=>{var a;let n="durationMs"in(a=r)?a.durationMs:void 0,o=await W({params:e,session:l,result:r,extra:"longpress"===t?{...void 0!==n?{durationMs:n}:{},gesture:"longpress"}:k});return{result:o,responseData:o}}})}async function G(e){let{runtime:t,command:r,target:a,sessionName:n,requestId:o,flags:s}=e;if("longpress"===r)return await t.interactions.longPress(a,{session:n,requestId:o,durationMs:e.durationMs});let i={session:n,requestId:o,button:e.clickButton,count:s?.count,intervalMs:s?.intervalMs,holdMs:s?.holdMs,jitterPx:s?.jitterPx,doubleTap:s?.doubleTap};return"click"===r?await t.interactions.click(a,i):await t.interactions.press(a,i)}async function W(e){let{params:t,session:r,result:a,extra:n}=e,o="point"===a.kind?await M({session:r,flags:t.req.flags,sessionStore:t.sessionStore,contextFromFlags:t.contextFromFlags,captureSnapshotForSession:t.captureSnapshotForSession}):P(r.snapshot?.nodes??[]);return O({data:a.backendResult,fallbackX:a.point?.x,fallbackY:a.point?.y,referenceFrame:o,extra:{...D(a),...n}})}async function $(e,t,r){return await V({params:e,session:t,selector:r,command:"press",positionals:[],extra:{selector:r.raw},fallbackPhase:"ios_direct_selector_tap_fallback"})}async function V(e){let{params:t,session:r,selector:n,command:o,positionals:s,extra:i,fallbackPhase:l}=e,c=Date.now();try{var f,u;let e,l,d=await a(r.device,o,s,t.req.flags?.out,{...t.contextFromFlags(t.req.flags,r.appBundleId,r.trace?.outPath),directElementSelector:n,surface:r.surface})??{},p=Date.now(),g=(f=d,e="number"==typeof f.x?f.x:void 0,l="number"==typeof f.y?f.y:void 0,void 0!==e&&void 0!==l?{x:e,y:l}:{x:0,y:0}),m=O({data:d,fallbackX:g.x,fallbackY:g.y,referenceFrame:(u=d,"number"==typeof u.referenceWidth&&"number"==typeof u.referenceHeight?{referenceWidth:u.referenceWidth,referenceHeight:u.referenceHeight}:void 0),extra:{...i,...function(e,t){if(!e.allowNonHittableCoordinateFallback)return{};let r="tapped via non-hittable coordinate fallback"===t.message;return{maestroNonHittableCoordinateFallbackAllowed:!0,maestroNonHittableCoordinateFallbackUsed:r,...r?{maestroFallbackReason:"non-hittable-coordinate"}:{}}}(n,d)}});return C({session:r,sessionStore:t.sessionStore,command:t.req.command,positionals:t.req.positionals??[],retryPositionals:Q(g),flags:t.req.flags,result:m,responseData:m,actionStartedAt:c,actionFinishedAt:p})}catch(e){if(!v(e))return{ok:!1,error:k(e)};return I({level:"debug",phase:l,data:{selector:n.raw,error:e instanceof Error?e.message:String(e)}}),null}}async function X(e){let{req:t,sessionName:r,sessionStore:a}=e,n=a.get(r);if(n){let e=q(n,"fill");if(e)return e}if(n&&!o("fill",n.device))return s("UNSUPPORTED_OPERATION","fill is not supported on this device");if(!n)return s("SESSION_NOT_FOUND","No active session. Run open first.");let i=function(e){let t=e[0]??"";if(t.startsWith("@")){var r;let a=u(e).text;return a?{ok:!0,target:{kind:"ref",ref:t,fallbackLabel:(r=e).length>=3&&r[1]?.trim()||""},text:a}:{ok:!1,response:s("INVALID_ARGS","fill requires text after ref")}}let a=U(e);if(a){let t=e.slice(2).join(" ");return t?{ok:!0,target:{kind:"point",x:a.x,y:a.y},text:t}:{ok:!1,response:s("INVALID_ARGS","fill requires text after coordinates")}}let n=u(e);return"selector"!==n.kind?{ok:!1,response:s("INVALID_ARGS","fill requires x y text, @ref text, or selector text")}:n.text.trim()?{ok:!0,target:{kind:"selector",selector:n.target.selector},text:n.text}:{ok:!1,response:s("INVALID_ARGS","fill requires text after selector")}}(t.positionals??[]);if(!i.ok)return i.response;if("ref"===i.target.kind){let r=e.refSnapshotFlagGuardResponse("fill",t.flags);if(r)return r;await J(e,n)}let l=function(e){let{session:t,target:r,flags:a}=e;if("selector"!==r.kind)return null;let n=x({session:t,selectorExpression:r.selector});return n?{...n,...a?.maestro?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{}}:null}({session:n,target:i.target,flags:t.flags});if(l){let t=await Y(e,n,l,i.text);if(t)return t}return await z(e,{run:async e=>await e.interactions.fill(i.target,i.text,{session:r,requestId:t.meta?.requestId,delayMs:t.flags?.delayMs}),buildPayloads:e=>{let t="point"===e.kind?void 0:P(n.snapshot?.nodes??[]),r=O({data:e.backendResult,fallbackX:e.point?.x,fallbackY:e.point?.y,referenceFrame:t,extra:{...D(e),text:i.text}});e.warning&&(r.warning=e.warning);let a="ref"===e.kind?{...e.backendResult??{ref:H(e.target?.kind==="ref"?e.target.ref:void 0),...e.point?{x:e.point.x,y:e.point.y}:{}}}:r;return e.warning&&(a.warning=e.warning),{result:r,responseData:a}}})}async function Y(e,t,r,a){return await V({params:e,session:t,selector:r,command:"fill",positionals:[a],extra:{selector:r.raw,text:a},fallbackPhase:"ios_direct_selector_fill_fallback"})}async function z(e,t){let r=e.sessionStore.get(e.sessionName);if(!r)return s("SESSION_NOT_FOUND","No active session. Run open first.");let a=K(e),o=Date.now();try{let s=await n({session:r,command:e.req.command,phase:"before-command"}),i=await t.run(a);await t.afterRun?.(i),await n({session:r,command:e.req.command,phase:"after-command"});let l=Date.now(),{result:c,responseData:f}=await t.buildPayloads(i);return"recovered"===s.status&&(c.warning=s.warning,f.warning=s.warning),C({session:r,sessionStore:e.sessionStore,command:e.req.command,positionals:e.req.positionals??[],retryPositionals:function(e,t){if(("ref"!==t.kind||t.node)&&("click"===e||"press"===e)&&t.point)return Q(t.point)}(e.req.command,i),flags:e.req.flags,result:c,responseData:f,actionStartedAt:o,actionFinishedAt:l,androidFreshnessBaseline:t.androidFreshnessBaseline})}catch(t){let e=m(t);if(y(e))throw e;return{ok:!1,error:k(t)}}}async function J(e,t){if(!l(t))return;let r=t.snapshot?.comparisonSafe===!0?t.snapshot:void 0;try{await e.captureSnapshotForSession(t,e.req.flags,e.sessionStore,e.contextFromFlags,{interactiveOnly:!0,androidFreshnessMode:"ref-refresh"})}catch(t){I({level:"warn",phase:"android_ref_snapshot_refresh_failed",data:{command:e.req.command,error:t instanceof Error?t.message:String(t)}})}return r}function Q(e){return[String(e.x),String(e.y)]}async function Z(e){let t=await j({...e,captureSnapshotForSession:R,refSnapshotFlagGuardResponse:N});if(t)return t;switch(e.req.command){case A.type:return await ee({...e,captureSnapshotForSession:R});case"get":return await _(e);case"is":return await b(e);default:return null}}async function ee(e){let{sessionName:t,sessionStore:r}=e,a=r.get(t);if(!a)return s("SESSION_NOT_FOUND","No active session. Run open first.");if(!o(A.type,a.device))return s("UNSUPPORTED_OPERATION","type is not supported on this device");let n=await et(a);return n||await er(e,a)}async function et(e){return"android"===e.device.platform&&e.recording&&"failed"===(await i({session:e})).status?s("COMMAND_FAILED","Android system dialog blocked the recording session"):null}async function er(e,t){let{req:r,sessionName:a,sessionStore:o}=e,s=(r.positionals??[]).join(" "),i=K(e),l=Date.now();try{let e=await n({session:t,command:r.command,phase:"before-command"}),c=await i.interactions.typeText(s,{session:a,requestId:r.meta?.requestId,delayMs:r.flags?.delayMs});await n({session:t,command:r.command,phase:"after-command"});let f=Date.now(),u={...c.backendResult??{},text:c.text,delayMs:c.delayMs,...p(c.message??`Typed ${Array.from(c.text).length} chars`)};return"recovered"===e.status&&(u.warning=e.warning),C({session:t,sessionStore:o,command:r.command,positionals:r.positionals??[],flags:r.flags,result:u,responseData:u,actionStartedAt:l,actionFinishedAt:f})}catch(e){return{ok:!1,error:k(e)}}}e.r(E),e.d(E,{handleInteractionCommands:()=>Z});export{E as interaction_namespaceObject};

package/dist/src/internal/bin.js

@@ -1,5 +1,5 @@
 var e,t,r,s;let n,o=process.argv.slice(2);function c(e){return"--help"===e||"-h"===e}function i(e){import("../cli.js").then(({runCli:t})=>t(e)).catch(p)}function p(e){process.stderr.write(`${e instanceof Error?e.message:String(e)}
-`),process.exit(1)}1===(t=e=o).length&&("--version"===(r=t[0])||"-V"===r)&&(process.stdout.write(`0.17.6
+`),process.exit(1)}1===(t=e=o).length&&("--version"===(r=t[0])||"-V"===r)&&(process.stdout.write(`0.17.8
 `),1)||0===e.length&&(import("../cli-help.js").then(({buildUsageText:e})=>{process.stdout.write(`${e()}
 `),process.exit(1)}).catch(p),1)||void 0!==(n=function(e){var t,r,s,n;switch(e.length){case 1:return"help"===(t=e[0])||c(t)?null:void 0;case 2:return r=e[0],s=e[1],"help"===r?s:(n=r,c(s)?n:void 0);default:return}}(s=e))&&(import("../cli-help.js").then(({buildCommandUsageText:e,buildUsageText:t})=>{var r;if(null===n)return void process.stdout.write(`${t()}
 `);let o=e("long-press"===(r=n)?"longpress":"metrics"===r?"perf":r);o?process.stdout.write(o):i(s)}).catch(p),1)||("mcp"!==o[0]||o.includes("--help")||o.includes("-h")?i(o):import("../server.js").then(({runAgentDeviceMcpServer:e})=>e()).catch(p));export{};

package/dist/src/provider.js

@@ -0,0 +1 @@
+import{createScopedProvider as r,createAgentBrowserWebProvider as e}from"./9722.js";let o=r(e());function t(r){return o.resolve(r)}async function n(r,e){return await o.run(r,e)}export{t as resolveWebProvider,n as withWebProvider};