agent-device 0.17.6 → 0.17.8

package/dist/src/record-trace-recording.js

@@ -1,4 +1,4 @@
-let e,t,r,i;import a from"node:fs";import o from"node:path";import{createHash as n}from"node:crypto";import s from"node:os";import{fileURLToPath as c}from"node:url";import{AppError as d}from"./733.js";import{runCmd as l}from"./8875.js";import{runXcrun as u,SessionStore as m,runIosRunnerCommand as f,isCommandSupportedOnDevice as p,errorResponse as h,acquireProcessLock as w,ensureDeviceReady as g,resolvePublicSessionName as y,resolveImplicitSessionScope as _,resolveTargetDevice as v,IOS_RUNNER_CONTAINER_BUNDLE_IDS as P}from"./9722.js";import{readProcessStartTime as S}from"./5628.js";import{sleep as A}from"./5560.js";import{withDiagnosticTimer as M,emitDiagnostic as b}from"./432.js";import{androidDeviceForSerial as C,runAndroidAdb as I}from"./3340.js";import{pullAndroidAdbFile as x}from"./2954.js";import{resolveRecordingProvider as D}from"./recording-provider.js";function $(e=process.env){let t=E(),r=o.join(t,"home"),i=o.join(t,"module-cache");return a.mkdirSync(r,{recursive:!0}),a.mkdirSync(i,{recursive:!0}),{...e,HOME:r,CLANG_MODULE_CACHE_PATH:i}}async function R(e){let t=a.statSync(e.sourcePath),r=a.readFileSync(e.sourcePath),i=L(e.cacheName??o.basename(e.sourcePath,o.extname(e.sourcePath))),n=T(["2",process.platform,process.arch,o.resolve(e.sourcePath),t.size,r]),s=o.join(E(),"bin",`${i}-${n}`);return await N({sourcePath:e.sourcePath,executablePath:s,timeoutMs:e.timeoutMs}),s}async function k(e){let t=L(e.cacheName),r=T(["2",process.platform,process.arch,e.source]),i=o.join(E(),"sources",`${t}-${r}.swift`),a=o.join(E(),"bin",`${t}-${r}`);return await N({sourcePath:i,executablePath:a,sourceText:e.source,timeoutMs:e.timeoutMs}),a}function E(){let e=process.env.AGENT_DEVICE_SWIFT_CACHE_DIR?.trim();return e?o.resolve(e):o.join(s.tmpdir(),"agent-device-swift-cache")}async function N(e){if(O(e.executablePath))return;let t=o.dirname(e.executablePath);a.mkdirSync(t,{recursive:!0});let r=`${e.executablePath}.lock`,i=await F(r,e.executablePath,e.timeoutMs??12e4);if(!i)return;let n=a.mkdtempSync(o.join(t,`.${o.basename(e.executablePath)}.${process.pid}.`)),s=o.join(n,o.basename(e.executablePath));try{if(O(e.executablePath))return;void 0===e.sourceText||a.existsSync(e.sourcePath)||(a.mkdirSync(o.dirname(e.sourcePath),{recursive:!0}),a.writeFileSync(e.sourcePath,e.sourceText)),await l("xcrun",["swiftc",e.sourcePath,"-o",s],{timeoutMs:e.timeoutMs??12e4,env:$()}),a.renameSync(s,e.executablePath)}finally{a.rmSync(n,{recursive:!0,force:!0}),await i()}}async function F(e,t,r){if(O(t))return null;try{return await w({lockDirPath:e,owner:{pid:process.pid,startTime:S(process.pid),acquiredAtMs:Date.now()},timeoutMs:r,pollMs:25,ownerGraceMs:r,description:`Swift cache lock: ${e} (${r}ms)`})}catch(t){if(t instanceof d&&t.message.startsWith("Timed out waiting for Swift cache lock:"))throw new d("COMMAND_FAILED",t.message,{...t.details,lockDir:e,timeoutMs:r,hint:`Another agent-device process may still be compiling this Swift helper. Retry shortly; if no agent-device process is active, remove "${e}" and retry.`});throw t}}function O(e){try{return a.accessSync(e,a.constants.X_OK),a.statSync(e).isFile()}catch{return!1}}function L(e){return e.replaceAll(/[^A-Za-z0-9._-]/g,"-").replaceAll(/^-+|-+$/g,"")||"swift-helper"}function T(e){let t=n("sha256");for(let r of e)t.update(Buffer.isBuffer(r)?r:String(r)),t.update("\0");return t.digest("hex").slice(0,16)}let U=`
+let e,t,r,i;import a from"node:fs";import o from"node:path";import{createHash as n}from"node:crypto";import s from"node:os";import{fileURLToPath as c}from"node:url";import{AppError as d}from"./733.js";import{runCmd as l}from"./8875.js";import{acquireProcessLock as u}from"./2577.js";import{readProcessStartTime as m}from"./5628.js";import{sleep as f}from"./5560.js";import{withDiagnosticTimer as h,emitDiagnostic as p}from"./432.js";import{androidDeviceForSerial as w,runAndroidAdb as g}from"./3340.js";import{pullAndroidAdbFile as y}from"./2954.js";import{runXcrun as _,SessionStore as v,runIosRunnerCommand as P,errorResponse as S,isCommandSupportedOnDevice as A,ensureDeviceReady as M,resolvePublicSessionName as C,resolveImplicitSessionScope as b,resolveTargetDevice as x,IOS_RUNNER_CONTAINER_BUNDLE_IDS as I}from"./9722.js";import{resolveRecordingProvider as D}from"./recording-provider.js";import{recordingQualityInputToExportQuality as $,RECORDING_EXPORT_QUALITIES as R}from"./9873.js";function N(e=process.env){let t=F(),r=o.join(t,"home"),i=o.join(t,"module-cache");return a.mkdirSync(r,{recursive:!0}),a.mkdirSync(i,{recursive:!0}),{...e,HOME:r,CLANG_MODULE_CACHE_PATH:i}}async function k(e){let t=a.statSync(e.sourcePath),r=a.readFileSync(e.sourcePath),i=z(e.cacheName??o.basename(e.sourcePath,o.extname(e.sourcePath))),n=U(["2",process.platform,process.arch,o.resolve(e.sourcePath),t.size,r]),s=o.join(F(),"bin",`${i}-${n}`);return await O({sourcePath:e.sourcePath,executablePath:s,timeoutMs:e.timeoutMs}),s}async function E(e){let t=z(e.cacheName),r=U(["2",process.platform,process.arch,e.source]),i=o.join(F(),"sources",`${t}-${r}.swift`),a=o.join(F(),"bin",`${t}-${r}`);return await O({sourcePath:i,executablePath:a,sourceText:e.source,timeoutMs:e.timeoutMs}),a}function F(){let e=process.env.AGENT_DEVICE_SWIFT_CACHE_DIR?.trim();return e?o.resolve(e):o.join(s.tmpdir(),"agent-device-swift-cache")}async function O(e){if(T(e.executablePath))return;let t=o.dirname(e.executablePath);a.mkdirSync(t,{recursive:!0});let r=`${e.executablePath}.lock`,i=await L(r,e.executablePath,e.timeoutMs??12e4);if(!i)return;let n=a.mkdtempSync(o.join(t,`.${o.basename(e.executablePath)}.${process.pid}.`)),s=o.join(n,o.basename(e.executablePath));try{if(T(e.executablePath))return;void 0===e.sourceText||a.existsSync(e.sourcePath)||(a.mkdirSync(o.dirname(e.sourcePath),{recursive:!0}),a.writeFileSync(e.sourcePath,e.sourceText)),await l("xcrun",["swiftc",e.sourcePath,"-o",s],{timeoutMs:e.timeoutMs??12e4,env:N()}),a.renameSync(s,e.executablePath)}finally{a.rmSync(n,{recursive:!0,force:!0}),await i()}}async function L(e,t,r){if(T(t))return null;try{return await u({lockDirPath:e,owner:{pid:process.pid,startTime:m(process.pid),acquiredAtMs:Date.now()},timeoutMs:r,pollMs:25,ownerGraceMs:r,description:`Swift cache lock: ${e} (${r}ms)`})}catch(t){if(t instanceof d&&t.message.startsWith("Timed out waiting for Swift cache lock:"))throw new d("COMMAND_FAILED",t.message,{...t.details,lockDir:e,timeoutMs:r,hint:`Another agent-device process may still be compiling this Swift helper. Retry shortly; if no agent-device process is active, remove "${e}" and retry.`});throw t}}function T(e){try{return a.accessSync(e,a.constants.X_OK),a.statSync(e).isFile()}catch{return!1}}function z(e){return e.replaceAll(/[^A-Za-z0-9._-]/g,"-").replaceAll(/^-+|-+$/g,"")||"swift-helper"}function U(e){let t=n("sha256");for(let r of e)t.update(Buffer.isBuffer(r)?r:String(r)),t.update("\0");return t.digest("hex").slice(0,16)}let K=`
 import Foundation
 import AVFoundation
 
@@ -22,5 +22,5 @@ Task {
 
 semaphore.wait()
 exit(exitCode)
-`.trim();async function z(e,t={}){let r,i=t.pollMs??150,o=t.attempts??12,n=0;for(let t=0;t<o;t+=1){let t=0;try{t=a.statSync(e).size}catch{t=0}if(t>0&&t===r){if((n+=1)>=2)return}else n=0;r=t,await A(i)}}async function q(e){try{let t=await K(),r=await l(t,[e],{allowFailure:!0,timeoutMs:1e4,env:$()});if(0===r.exitCode)return!0;if(V(r.stderr,r.stdout))return H(e);return!1}catch(r){var t;if((t=r)instanceof d&&("TOOL_MISSING"===t.code||V(String(t.details?.stderr??""),String(t.details?.stdout??""))))return H(e);throw r}}async function K(){e??=k({source:U,cacheName:"video-validator",timeoutMs:3e4});try{return await e}catch(t){throw e=void 0,t}}async function G(e,t={}){let r=t.pollMs??150,i=t.attempts??12;for(let t=0;t<i;t+=1){if(await q(e))return;await A(r)}}function V(e,t){let r=`${e}
-${t}`;return/\b(no such module ['"]AVFoundation['"]|unable to find utility ["']swiftc?["']|xcrun: error: unable to find utility ["']swiftc?["'])\b/i.test(r)}function H(e){try{let t=a.statSync(e);if(!t.isFile()||t.size<=0)return!1}catch{return!1}let t=function(e){try{let t=a.openSync(e,"r");try{let e=a.fstatSync(t).size,r=0,i=[];for(;r+8<=e&&i.length<16;){let e=Buffer.alloc(8);if(8>a.readSync(t,e,0,8,r))break;let o=e.readUInt32BE(0),n=e.toString("latin1",4,8);if(i.push(n),1===o){let e=Buffer.alloc(8);if(8>a.readSync(t,e,0,8,r+8))break;o=Number(e.readBigUInt64BE(0))}if(!Number.isFinite(o)||o<=0)break;r+=o}return i}finally{a.closeSync(t)}}catch{return[]}}(e);return t.includes("ftyp")&&t.includes("moov")}function j(e){let t=o.parse(e);return o.join(t.dir,`${t.name}.gesture-telemetry.json`)}function W(e){return[...e].sort((e,t)=>e.tMs-t.tMs)}function B(e){var t,r,i;let o,n,{recording:s,trimStartMs:c}=e,d=(o=j((t={videoPath:s.outPath,events:s.gestureEvents,trimStartMs:c}).videoPath),n={version:1,generatedAt:new Date().toISOString(),events:(r=t.events,(i=t.trimStartMs??0)>0?W(r.flatMap(e=>{let t=e.tMs-i,r="durationMs"in e?e.durationMs:void 0;return("number"==typeof r?t+r:t)<=0?[]:[{...e,tMs:Math.max(0,t)}]})):W(r))},a.writeFileSync(o,JSON.stringify(n,null,2)),o);return s.telemetryPath=d,d}function X(e){let t=o.dirname(c(import.meta.url)),r=[c(new URL(`./${e}`,import.meta.url)),o.resolve(t,`../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),o.resolve(t,`../../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),o.resolve(process.cwd(),`ios-runner/AgentDeviceRunner/RecordingScripts/${e}`)];for(let e of r)if(a.existsSync(e))return e;throw new d("COMMAND_FAILED",`Missing recording helper script: ${e}`,{hint:"Ensure ios-runner/AgentDeviceRunner/RecordingScripts is present in this checkout or bundled with the package.",scriptName:e,searchedPaths:r})}async function J(e){var t;let r,i,{videoPath:n,scriptPath:s,scriptArgs:c,commandDescription:u}=e;await z(n),await G(n);let m=(t=n,r=o.parse(t),i=`${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`,o.join(r.dir,`.${r.name}.agent-device-${i}${r.ext||".mp4"}`));try{let e=await R({sourcePath:s});await l(e,["--input",n,"--output",m,...c],{timeoutMs:12e4,env:$()}),await G(m),a.renameSync(m,n)}catch(t){let e=t instanceof d?t:new d("COMMAND_FAILED",String(t),void 0,t instanceof Error?t:void 0);throw new d("COMMAND_FAILED",u,{...e.details,videoPath:n,script:s},e)}finally{a.rmSync(m,{force:!0})}}async function Z(e){let{videoPath:t,trimStartMs:i}=e;i>0&&await J({videoPath:t,scriptPath:r??=X("recording-trim.swift"),scriptArgs:["--trim-start-ms",String(i)],commandDescription:"Failed to trim the start of the iOS recording"})}async function Q(e){let{videoPath:r,telemetryPath:i,targetLabel:a="recording"}=e;await J({videoPath:r,scriptPath:t??=X("recording-overlay.swift"),scriptArgs:["--events",i],commandDescription:`Failed to add touch overlays to the ${a}`})}async function Y(e){let{videoPath:t,quality:r,targetLabel:a="recording"}=e;await J({videoPath:t,scriptPath:i??=X("recording-resize.swift"),scriptArgs:["--quality",String(r)],commandDescription:`Failed to resize the ${a}`})}function ee(e){return e instanceof Error?e.message:String(e)}function et(e,t){return e.stderr.trim()||e.stdout.trim()||`${t} exited with code ${e.exitCode}`}function er(e,t,r=Date.now()){let i=Math.max(0,r-t.startedAt);return i>=1e3?{message:e,tooShort:!1}:{message:`${e}. Recording stopped after ${Math.round(i)}ms; wait at least 1000ms between record start and record stop so the recorder can finalize a playable MP4`,tooShort:!0}}async function ei(e){let{recording:t,deps:r,trimStartMs:i,targetLabel:a}=e,o=B({recording:t,trimStartMs:i});if(!t.showTouches)return void b({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"hide_touches"}});if(0===t.gestureEvents.length)return void b({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"no_gesture_events"}});let n=function(e=process.platform){if("darwin"!==e)return"touch overlay burn-in is only available on macOS hosts; returning raw video plus gesture telemetry"}();if(n){t.overlayWarning??=n;return}try{await M("record_stop_overlay_export",()=>r.overlayRecordingTouches({videoPath:t.outPath,telemetryPath:o,targetLabel:a}),{targetLabel:a,gestureEventCount:t.gestureEvents.length})}catch(e){t.overlayWarning??=`failed to overlay recording touches: ${ee(e)}`}}function ea(e,t){if(1===t)return e;let r=o.parse(e),i=r.ext||".mp4";return o.join(r.dir,`${r.name}.part-${String(t).padStart(3,"0")}${i}`)}function eo(e){return e.chunks??=[{index:1,path:e.outPath,remotePath:e.remotePath}],e.chunks}async function en(e){let{recording:t,startNextChunk:r,finishCurrentChunk:i}=e;if(t.stopping)return;let a=await i();if(a)throw Error(a);if(t.stopping)return;let n=eo(t),s=n.length+1,c=await r(o.posix.dirname(t.remotePath));t.remotePath=c.remotePath,t.remotePid=c.remotePid,n.push({index:s,path:ea(t.outPath,s),remotePath:c.remotePath}),t.warning??="Android adb screenrecord is capped at 180s, so this recording was split into multiple MP4 chunks."}async function es(e){let{recording:t,deps:r}=e;eo(t).length<=1?await ei({recording:t,deps:r,targetLabel:"Android recording"}):(B({recording:t}),t.showTouches&&t.gestureEvents.length>0&&(t.overlayWarning??="touch overlay burn-in is skipped for chunked Android recordings; returning raw chunks plus gesture telemetry"))}async function ec(e){for(let t of e.chunks){let r=await ed({deps:e.deps,deviceId:e.deviceId,remotePath:t.remotePath,outPath:t.path});if(r)return`failed to copy recording chunk ${t.index}: ${r}`}}async function ed(e){let t,{deps:r,deviceId:i,remotePath:o,outPath:n}=e;for(let e=0;e<2;e+=1){el(n);let s=C(i),c=await x(o,n,{allowFailure:!0,device:s});if(0!==c.exitCode)t=et(c,"adb pull");else{await r.waitForStableFile(n,{pollMs:250,attempts:20});let t=await r.isPlayableVideo(n);if(b({level:"debug",phase:"record_stop_android_pull_validation",data:{deviceId:i,remotePath:o,outPath:n,attempt:e+1,fileSize:function(e){try{return a.statSync(e).size}catch{return 0}}(n),playable:t}}),t)return;b({level:"warn",phase:"record_stop_android_invalid_video_retry",data:{deviceId:i,remotePath:o,outPath:n,attempt:e+1}})}e<1&&await A(750)}return t?`failed to copy recording from device: ${t}`:(el(n),"failed to copy recording from device: pulled file is not a playable MP4")}function el(e){try{a.rmSync(e,{force:!0})}catch{}}async function eu(e,t,r){return await I(C(e),t,r)}async function em(e,t){let r=await eu(e,["shell","ps","-o","pid=","-p",t],{allowFailure:!0});return 0===r.exitCode&&r.stdout.split(/\s+/).map(e=>e.trim()).includes(t)}async function ef(e,t){for(let r=0;r<40;r+=1){if(!await em(e,t))return!0;await A(250)}return!await em(e,t)}async function ep(e,t){let r,i=0;for(let a=0;a<20;a+=1){let a=await eu(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===a.exitCode?a.stdout.trim():"";if(o.length>0&&o===r){if((i+=1)>=4)return}else i=0;r=o,await A(250)}}async function eh(e,t,r){for(let i=0;i<8;i+=1){let a=await eu(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===a.exitCode?Number(a.stdout.trim()):NaN;if(Number.isFinite(o)&&o>0)return!0;if(!await em(e,r))break;if(i+1>=2)return!0;await A(250)}return!1}async function ew(e){let{deviceId:t,quality:r}=e;if(void 0===r||r>=10)return;let i=await eu(t,["shell","wm","size"],{allowFailure:!0}),a=i.stdout.match(/Override size:\s*(\d+)x(\d+)/)??i.stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(0!==i.exitCode||!a)throw Error(`failed to resolve Android screen size for recording quality: ${et(i,"adb shell wm size")}`);return{width:eg(Number(a[1]),r),height:eg(Number(a[2]),r)}}function eg(e,t){return Math.max(2,2*Math.round(e*t/10/2))}async function ey(e,t){await eu(e,["shell","rm","-f",t],{allowFailure:!0})}async function e_(e,t){let r=await eu(e,["shell","kill","-9",t],{allowFailure:!0});return b({level:"warn",phase:"record_stop_android_force_signal",data:{deviceId:e,remotePid:t,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),!(0!==r.exitCode&&await em(e,t))&&await ef(e,t)}async function ev(e){var t;let r,i,{device:a,recordingSize:o,preferredRemoteDir:n}=e,s="failed to start recording: Android screenrecord did not begin producing frames";for(let e of(t=Date.now(),r=`agent-device-recording-${t}.mp4`,i=["/sdcard","/data/local/tmp"],(n&&i.includes(n)?[n,...i.filter(e=>e!==n)]:i).map(e=>`${e}/${r}`))){let t=await eu(a.id,["shell",function(e,t){let r=["screenrecord"];return t&&r.push("--size",`${t.width}x${t.height}`),r.push(e),`${r.join(" ")} >/dev/null 2>&1 & echo $!`}(e,o)],{allowFailure:!0});if(0!==t.exitCode){s=`failed to start recording: ${et(t,"adb shell screenrecord")}`;continue}let r=t.stdout.split(/\r?\n/).map(e=>e.trim()).filter(e=>/^\d+$/.test(e)).at(-1);if(!r){s="failed to start recording: adb did not return a valid Android screenrecord pid",await ey(a.id,e);continue}if(b({level:"debug",phase:"record_start_android_started",data:{deviceId:a.id,remotePath:e,remotePid:r}}),await eh(a.id,e,r))return{remotePath:e,remotePid:r,startedAt:Date.now()};s="failed to start recording: Android screenrecord did not begin producing frames",await e_(a.id,r),await ey(a.id,e)}return{error:h("COMMAND_FAILED",s)}}async function eP(e){let t,{device:r,recordingBase:i}=e;try{t=await ew({deviceId:r.id,quality:i.quality})}catch(e){return h("COMMAND_FAILED",e instanceof Error?e.message:String(e))}let a=await ev({device:r,recordingSize:t});if("error"in a)return a.error;let o={platform:"android",remotePath:a.remotePath,remotePid:a.remotePid,chunks:[{index:1,path:i.outPath,remotePath:a.remotePath}],...i,startedAt:a.startedAt};return!function e(t){let{recording:r,startNextChunk:i,finishCurrentChunk:a}=t,o=setTimeout(()=>{r.rotationPromise=en({recording:r,startNextChunk:i,finishCurrentChunk:a}).catch(e=>{r.rotationFailedReason=e instanceof Error?e.message:String(e)}).finally(()=>{r.rotationPromise=void 0,r.stopping||r.rotationFailedReason||e({recording:r,startNextChunk:i,finishCurrentChunk:a})})},17e4);o.unref?.(),r.rotationTimer=o}({recording:o,finishCurrentChunk:async()=>await eS({device:r,recording:o,waitForRemoteFileStability:!1}),startNextChunk:async e=>{let i=await ev({device:r,recordingSize:t,preferredRemoteDir:e});if("error"in i)throw Error(i.error.ok?"failed to start next Android recording chunk":i.error.error.message);return i}}),o}async function eS(e){let{device:t,recording:r,waitForRemoteFileStability:i=!0}=e;await em(t.id,r.remotePid)||(r.warning??=function(e){if(!(Date.now()-e.startedAt<178e3))return"Android adb screenrecord stopped before record stop, likely after reaching the 180s platform limit. The MP4 may be truncated; final interactions after the limit are not in the video."}(r));let a=await eu(t.id,["shell","kill","-2",r.remotePid],{allowFailure:!0});if(b({level:"debug",phase:"record_stop_android_signal",data:{deviceId:t.id,remotePath:r.remotePath,remotePid:r.remotePid,exitCode:a.exitCode,stdout:a.stdout.trim(),stderr:a.stderr.trim()}}),0!==a.exitCode)return await eA(t.id,r.remotePid,a);let o=await eM(t.id,r.remotePid);if(o)return o;i&&await ep(t.id,r.remotePath)}async function eA(e,t,r){if(await em(e,t)&&!await e_(e,t))return`failed to stop recording: ${et(r,"adb shell kill")}`}async function eM(e,t){if(!await ef(e,t)&&!await e_(e,t))return`failed to stop recording: Android screenrecord pid ${t} did not exit`}async function eb(e){let t,{deps:r,device:i,recording:a,stopRequestedAt:o}=e;b({level:"debug",phase:"record_stop_android_enter",data:{deviceId:i.id,remotePath:a.remotePath,remotePid:a.remotePid}}),a.stopping=!0,a.rotationTimer&&(clearTimeout(a.rotationTimer),a.rotationTimer=void 0),await a.rotationPromise;let n=await eS({device:i,recording:a});if(a.rotationFailedReason&&!n&&(a.warning??=`Android recording chunk rotation failed: ${a.rotationFailedReason}`),!n){let e=await ec({deps:r,deviceId:i.id,chunks:eo(a)});if(e)return await s(),h("COMMAND_FAILED",eC(e,a,o));await es({recording:a,deps:r})}if(await s(),n)return h("COMMAND_FAILED",eC(n,a,o));if(t)return h("COMMAND_FAILED",t);return null;async function s(){for(let e of eo(a)){let r=await eu(i.id,["shell","rm","-f",e.remotePath],{allowFailure:!0});b({level:"debug",phase:"record_stop_android_cleanup",data:{deviceId:i.id,remotePath:e.remotePath,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),0===r.exitCode||n||(t=`failed to clean up remote recording: ${et(r,"adb shell rm")}`)}}}function eC(e,t,r){return er(e,t,r).message}function eI(e){let t=e.appBundleId?.trim();return t&&t.length>0?t:void 0}function ex(e,t,r){return{verbose:e.flags?.verbose,logPath:t,traceLogPath:r.trace?.outPath,requestId:e.meta?.requestId,iosXctestrunFile:e.flags?.iosXctestrunFile,iosXctestDerivedDataPath:e.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:e.flags?.iosXctestEnvDir}}async function eD(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o}=e,n=eI(r);try{await o.runIosRunnerCommand(i,{command:"recordStop",appBundleId:n},ex(t,a,r))}catch(e){b({level:"warn",phase:"record_stop_runner_failed",data:{platform:i.platform,kind:i.kind,deviceId:i.id,session:r.name,error:ee(e)}})}}async function e$(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o}=e,n=eI(r);if(n)try{let e=await o.runIosRunnerCommand(i,{command:"snapshot",appBundleId:n,interactiveOnly:!0,depth:1},ex(t,a,r)),s=Date.now();if("number"==typeof e.currentUptimeMs&&Number.isFinite(e.currentUptimeMs)&&e.currentUptimeMs>0)return b({level:"debug",phase:"record_start_gesture_clock_anchor",data:{source:"warm_snapshot"}}),{gestureClockOriginAtMs:s,gestureClockOriginUptimeMs:e.currentUptimeMs};return}catch(e){b({level:"warn",phase:"record_start_simulator_runner_warm_failed",data:{deviceId:i.id,session:r.name,appBundleId:n,error:ee(e)}});return}}async function eR(e){let t,r,{req:i,activeSession:a,sessionStore:o,device:n,logPath:s,deps:c,fpsFlag:d,recordingBase:l,appBundleId:u}=e,m=`agent-device-recording-${Date.now()}.mp4`,f=`tmp/${m}`,p=ex(i,s,a),w=async()=>c.runIosRunnerCommand(n,{command:"recordStart",outPath:m,fps:d,quality:l.quality,appBundleId:u},p);try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(i){var g,y;if(!ee(i).toLowerCase().includes("recording already in progress"))return h("COMMAND_FAILED",`failed to start recording: ${ee(i)}`);b({level:"warn",phase:"record_start_runner_desynced",data:{platform:n.platform,kind:n.kind,deviceId:n.id,session:a.name,error:ee(i)}});let e=(g=n.id,y=a.name,o.toArray().find(e=>e.name!==y&&"ios"===e.device.platform&&"device"===e.device.kind&&e.device.id===g&&e.recording?.platform==="ios-device-runner"));if(e)return h("COMMAND_FAILED",`failed to start recording: recording already in progress in session '${e.name}'`);try{await c.runIosRunnerCommand(n,{command:"recordStop",appBundleId:u},p)}catch{}try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(e){return h("COMMAND_FAILED",`failed to start recording: ${ee(e)}`)}}return{platform:"ios-device-runner",remotePath:f,runnerStartedAtUptimeMs:t,targetAppReadyUptimeMs:r,...l}}async function ek(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,fpsFlag:n,recordingBase:s,appBundleId:c}=e;try{await o.runIosRunnerCommand(i,{command:"recordStart",outPath:s.outPath,fps:n,quality:s.quality,appBundleId:c},ex(t,a,r))}catch(e){return h("COMMAND_FAILED",`failed to start recording: ${ee(e)}`)}return{platform:"macos-runner",...s}}async function eE(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,recording:n}=e;await eD({req:t,activeSession:r,device:i,logPath:a,deps:o});let s={stdout:"",stderr:"",exitCode:1};for(let e of P)if(0===(s=await o.runCmd("xcrun",["devicectl","device","copy","from","--device",i.id,"--source",n.remotePath,"--destination",n.outPath,"--domain-type","appDataContainer","--domain-identifier",e],{allowFailure:!0})).exitCode)break;if(0!==s.exitCode){let e=s.stderr.trim()||s.stdout.trim()||`devicectl exited with code ${s.exitCode}`;return h("COMMAND_FAILED",`failed to copy recording from device: ${e}`)}let c="number"!=typeof n.runnerStartedAtUptimeMs||"number"!=typeof n.targetAppReadyUptimeMs?0:Math.max(0,n.targetAppReadyUptimeMs-n.runnerStartedAtUptimeMs);return c>0&&await o.trimRecordingStart({videoPath:n.outPath,trimStartMs:c}),await ei({recording:n,deps:o,trimStartMs:c,targetLabel:"iOS recording"}),null}async function eN(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,recording:n}=e;return await eD({req:t,activeSession:r,device:i,logPath:a,deps:o}),await ei({recording:n,deps:o,targetLabel:"macOS recording"}),null}async function eF(e){let{deps:t,recording:r}=e;r.child.kill("SIGINT");let i=await eO(r.wait,5e3);return i||(await eL(t,r,"SIGINT"),(i=await eO(r.wait,2e3))||(r.child.kill("SIGTERM"),await eL(t,r,"SIGTERM"),i=await eO(r.wait,2e3)))?i:(r.child.kill("SIGKILL"),await eL(t,r,"SIGKILL"),await eO(r.wait,2e3))}async function eO(e,t){return await Promise.race([e,A(t).then(()=>null)])}async function eL(e,t,r){await eU(e,t,r)||await eT(e,t.outPath,r)}async function eT(e,t,r){let i,a=`simctl.*recordVideo.*${t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}`;try{i=await e.runCmd("pgrep",["-f",a],{allowFailure:!0})}catch(e){b({level:"warn",phase:"record_stop_ios_simulator_pgrep_failed",data:{outPath:t,signal:r,error:ee(e)}});return}let o=eq(eG(i.stdout)),n=eK(o,r);b({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_recorders",data:{outPath:t,signal:r,matchedPidCount:o.length,signaled:n,pgrepExitCode:i.exitCode}})}async function eU(e,t,r){let i=t.recorderPid??t.child.pid;if("number"!=typeof i||!Number.isInteger(i)||i<=0)return b({level:"debug",phase:"record_stop_ios_simulator_owned_recorder_unavailable",data:{outPath:t.outPath,signal:r,reason:"missing_recorder_pid"}}),!1;let a=await ez(e,i,t.outPath,r),o=eq([i,...a.pids]),n=eK(o,r);return b({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_owned_recorder",data:{outPath:t.outPath,signal:r,recorderPid:i,childPidCount:a.pids.length,matchedPidCount:o.length,signaled:n,pgrepExitCode:a.exitCode}}),n>0}async function ez(e,t,r,i){let a;try{a=await e.runCmd("pgrep",["-P",String(t)],{allowFailure:!0})}catch(e){return b({level:"warn",phase:"record_stop_ios_simulator_owned_pgrep_failed",data:{outPath:r,signal:i,parentPid:t,error:ee(e)}}),{pids:[]}}return{pids:eG(a.stdout),exitCode:a.exitCode}}function eq(e){return Array.from(new Set(e)).filter(e=>Number.isInteger(e)&&e>0&&e!==process.pid)}function eK(e,t){let r=0;for(let i of e)try{process.kill(i,t),r+=1}catch{}return r}function eG(e){return e.split(/\s+/).map(e=>Number(e)).filter(e=>Number.isInteger(e)&&e>0)}async function eV(e){"ios"!==e.platform||0!==e.gestureEvents.length&&await A(350)}async function eH(e){for(let t=0;t<2;t+=1){try{if(a.statSync(e).size>0)return Date.now()}catch{}if(t+1>=2)break;await A(250)}return Date.now()}async function ej(e){let t,r,{req:i,activeSession:a,device:o,logPath:n,deps:s,recordingBase:c,resolvedOut:d}=e,l=c.showTouches?await e$({req:i,activeSession:a,device:o,logPath:n,deps:s}):void 0,{child:u,wait:m}=s.startIosSimulatorRecording({device:o,outPath:d}),f=await eH(d);if(l)t=l.gestureClockOriginAtMs,r=l.gestureClockOriginUptimeMs;else if(c.showTouches)try{let e=Date.now(),c=await s.runIosRunnerCommand(o,{command:"uptime",appBundleId:eI(a)},ex(i,n,a)),d=Date.now();t=Math.round((e+d)/2),r="number"==typeof c.currentUptimeMs?c.currentUptimeMs:void 0}catch{}return{platform:"ios",child:u,wait:m,...c,recorderPid:u.pid,startedAt:f,gestureClockOriginAtMs:void 0===r?void 0:t,gestureClockOriginUptimeMs:r}}async function eW(e){let t,{req:r,sessionName:i,sessionStore:n,activeSession:s,device:c,logPath:d,deps:l}=e;if(s.recording)return h("INVALID_ARGS","recording already in progress");let u=r.flags?.fps,f=r.flags?.quality;if(void 0!==u&&(!Number.isInteger(u)||u<1||u>120))return h("INVALID_ARGS","fps must be an integer between 1 and 120");if(void 0!==f&&(!Number.isInteger(f)||f<5||f>10))return h("INVALID_ARGS","quality must be an integer between 5 and 10");if(!p("record",c))return h("UNSUPPORTED_OPERATION","record is not supported on this device");let w=r.positionals?.[1]??`./recording-${Date.now()}.mp4`,g=m.expandHome(w,r.meta?.cwd),y={outPath:g,clientOutPath:r.meta?.clientArtifactPaths?.outPath,startedAt:Date.now(),quality:r.flags?.quality,showTouches:r.flags?.hideTouches!==!0,gestureEvents:[]};if(a.mkdirSync(o.dirname(g),{recursive:!0}),a.rmSync(g,{force:!0}),"ios"===c.platform&&"device"===c.kind){let e=eI(s);if(!e)return h("INVALID_ARGS","record on physical iOS devices requires an active app session; run open <app> first");t=await eR({req:r,activeSession:s,sessionStore:n,device:c,logPath:d,deps:l,fpsFlag:u,recordingBase:y,appBundleId:e})}else if("macos"===c.platform){let e=eI(s);if(!e)return h("INVALID_ARGS","record on macOS requires an active app session; run open <app> first");t=await ek({req:r,activeSession:s,device:c,logPath:d,deps:l,fpsFlag:u,recordingBase:y,appBundleId:e})}else t="ios"===c.platform?await ej({req:r,activeSession:s,device:c,logPath:d,deps:l,recordingBase:y,resolvedOut:g}):await eP({device:c,recordingBase:y});if("ok"in t)return t;s.recording=t,n.set(i,s);let _=n.ensureSessionDir(i);return n.recordAction(s,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:{action:"start",showTouches:t.showTouches}}),{ok:!0,data:{recording:"started",outPath:t.clientOutPath??w,sessionStateDir:_,showTouches:t.showTouches}}}async function eB(e){let{deps:t,device:r,recording:i,stopRequestedAt:a}=e;if("android"===i.platform)return await eb({deps:t,device:r,recording:i,stopRequestedAt:a});await M("record_stop_tail_settle",()=>t.waitForRecordingTail(i),{platform:i.platform,gestureEventCount:i.gestureEvents.length});let o=await M("record_stop_ios_simulator_process",()=>eF({deps:t,recording:i}),{outPath:i.outPath});if(!o)return eX("failed to stop recording: simctl recordVideo did not exit after 5000ms and forced cleanup",i,a);if(0!==o.exitCode)return eX(`failed to stop recording: ${et(o,"simctl recordVideo")}`,i,a);if(await M("record_stop_video_stable",()=>t.waitForStableFile(i.outPath,{pollMs:150,attempts:12}),{outPath:i.outPath}),!await M("record_stop_video_playable_check",()=>t.isPlayableVideo(i.outPath),{outPath:i.outPath}))return eX(`failed to stop recording: ${i.outPath} was not finalized into a playable video`,i,a);if(void 0!==i.quality&&i.quality<10){let e=i.quality;try{await M("record_stop_resize",()=>t.resizeRecording({videoPath:i.outPath,quality:e,targetLabel:"iOS recording"}),{outPath:i.outPath,quality:e})}catch(e){i.overlayWarning=`failed to resize recording: ${ee(e)}`}}return await M("record_stop_finalize_overlay",()=>ei({recording:i,deps:t,targetLabel:"iOS recording"}),{outPath:i.outPath,showTouches:i.showTouches,gestureEventCount:i.gestureEvents.length}),null}function eX(e,t,r){let i=er(e,t,r);return function(e){try{a.rmSync(e,{force:!0})}catch{}}(t.outPath),h("COMMAND_FAILED",i.message)}async function eJ(e){var t;let r,i,{req:a,activeSession:n,device:s,logPath:c,deps:d}=e;if(!n.recording)return h("INVALID_ARGS","no active recording");let l=n.recording,u=Date.now(),m=l.invalidatedReason;n.recording=void 0;let f="ios-device-runner"===l.platform?await eE({req:a,activeSession:n,device:s,logPath:c,deps:d,recording:l}):"macos-runner"===l.platform?await eN({req:a,activeSession:n,device:s,logPath:c,deps:d,recording:l}):await eB({deps:d,device:s,recording:l,stopRequestedAt:u});if(f)return f;if(m&&"ios"===l.platform&&l.showTouches)l.overlayWarning??=`overlay unavailable: ${m}`;else if(m)return h("COMMAND_FAILED",m);return r="android"===(t=l).platform?t.chunks:void 0,i=[{field:"outPath",path:t.outPath,localPath:t.clientOutPath,fileName:o.basename(t.clientOutPath??t.outPath)}],r&&r.length>1&&i.push(...r.slice(1).map(e=>({field:"chunkPath",path:e.path,localPath:eZ(t,e.index),fileName:o.basename(eZ(t,e.index)??e.path)}))),t.telemetryPath&&i.push({field:"telemetryPath",path:t.telemetryPath,localPath:function(e){if(e.clientOutPath)return j(e.clientOutPath)}(t),fileName:o.basename(t.telemetryPath)}),{ok:!0,data:{recording:"stopped",outPath:t.outPath,telemetryPath:t.telemetryPath,artifacts:i,showTouches:t.showTouches,warning:t.warning,overlayWarning:t.overlayWarning,chunks:r?.map(e=>({index:e.index,path:eZ(t,e.index)??e.path}))}}}function eZ(e,t){if("android"===e.platform&&e.clientOutPath)return ea(e.clientOutPath,t)}function eQ(e,t,r,i={}){r.recordOnlySession&&(i.writeLog&&e.writeSessionLog(r),e.delete(t))}async function eY(e){let{req:t,sessionName:r,sessionStore:i,logPath:a}=e,o={runCmd:async(e,t,r)=>"xcrun"===e?await u(t,r):await l(e,t,r),startIosSimulatorRecording:e=>D().startIosSimulatorRecording(e),runIosRunnerCommand:f,waitForRecordingTail:eV,waitForStableFile:z,isPlayableVideo:q,trimRecordingStart:Z,resizeRecording:Y,overlayRecordingTouches:Q},n=i.get(r),s=n?.device??await v(t.flags??{});n||await g(s);let c=n??{name:y(t),sessionScope:_(t),device:s,createdAt:Date.now(),recordOnlySession:!0,actions:[]},d=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(d))return h("INVALID_ARGS","record requires start|stop");if("start"===d)return eW({req:t,sessionName:r,sessionStore:i,activeSession:c,device:s,logPath:a,deps:o});let m=await eJ({req:t,activeSession:c,device:s,logPath:a,deps:o});return m.ok?(i.recordAction(c,{command:t.command,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:m.data?.outPath,showTouches:m.data?.showTouches}}),eQ(i,r,c,{writeLog:!0})):eQ(i,r,c),m}export{eY as handleRecordCommand};
+`.trim();async function G(e,t={}){let r,i=t.pollMs??150,o=t.attempts??12,n=0;for(let t=0;t<o;t+=1){let t=0;try{t=a.statSync(e).size}catch{t=0}if(t>0&&t===r){if((n+=1)>=2)return}else n=0;r=t,await f(i)}}async function V(e){try{let t=await H(),r=await l(t,[e],{allowFailure:!0,timeoutMs:1e4,env:N()});if(0===r.exitCode)return!0;if(q(r.stderr,r.stdout))return W(e);return!1}catch(r){var t;if((t=r)instanceof d&&("TOOL_MISSING"===t.code||q(String(t.details?.stderr??""),String(t.details?.stdout??""))))return W(e);throw r}}async function H(){e??=E({source:K,cacheName:"video-validator",timeoutMs:3e4});try{return await e}catch(t){throw e=void 0,t}}async function j(e,t={}){let r=t.pollMs??150,i=t.attempts??12;for(let t=0;t<i;t+=1){if(await V(e))return;await f(r)}}function q(e,t){let r=`${e}
+${t}`;return/\b(no such module ['"]AVFoundation['"]|unable to find utility ["']swiftc?["']|xcrun: error: unable to find utility ["']swiftc?["'])\b/i.test(r)}function W(e){try{let t=a.statSync(e);if(!t.isFile()||t.size<=0)return!1}catch{return!1}let t=function(e){try{let t=a.openSync(e,"r");try{let e=a.fstatSync(t).size,r=0,i=[];for(;r+8<=e&&i.length<16;){let e=Buffer.alloc(8);if(8>a.readSync(t,e,0,8,r))break;let o=e.readUInt32BE(0),n=e.toString("latin1",4,8);if(i.push(n),1===o){let e=Buffer.alloc(8);if(8>a.readSync(t,e,0,8,r+8))break;o=Number(e.readBigUInt64BE(0))}if(!Number.isFinite(o)||o<=0)break;r+=o}return i}finally{a.closeSync(t)}}catch{return[]}}(e);return t.includes("ftyp")&&t.includes("moov")}function B(e){let t=o.parse(e);return o.join(t.dir,`${t.name}.gesture-telemetry.json`)}function X(e){return[...e].sort((e,t)=>e.tMs-t.tMs)}function Q(e){var t,r,i;let o,n,{recording:s,trimStartMs:c}=e,d=(o=B((t={videoPath:s.outPath,events:s.gestureEvents,trimStartMs:c}).videoPath),n={version:1,generatedAt:new Date().toISOString(),events:(r=t.events,(i=t.trimStartMs??0)>0?X(r.flatMap(e=>{let t=e.tMs-i,r="durationMs"in e?e.durationMs:void 0;return("number"==typeof r?t+r:t)<=0?[]:[{...e,tMs:Math.max(0,t)}]})):X(r))},a.writeFileSync(o,JSON.stringify(n,null,2)),o);return s.telemetryPath=d,d}function J(e){let t=o.dirname(c(import.meta.url)),r=[c(new URL(`./${e}`,import.meta.url)),o.resolve(t,`../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),o.resolve(t,`../../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),o.resolve(process.cwd(),`ios-runner/AgentDeviceRunner/RecordingScripts/${e}`)];for(let e of r)if(a.existsSync(e))return e;throw new d("COMMAND_FAILED",`Missing recording helper script: ${e}`,{hint:"Ensure ios-runner/AgentDeviceRunner/RecordingScripts is present in this checkout or bundled with the package.",scriptName:e,searchedPaths:r})}async function Z(e){var t;let r,i,{videoPath:n,scriptPath:s,scriptArgs:c,commandDescription:u}=e;await G(n),await j(n);let m=(t=n,r=o.parse(t),i=`${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`,o.join(r.dir,`.${r.name}.agent-device-${i}${r.ext||".mp4"}`));try{let e=await k({sourcePath:s});await l(e,["--input",n,"--output",m,...c],{timeoutMs:12e4,env:N()}),await j(m),a.renameSync(m,n)}catch(t){let e=t instanceof d?t:new d("COMMAND_FAILED",String(t),void 0,t instanceof Error?t:void 0);throw new d("COMMAND_FAILED",u,{...e.details,videoPath:n,script:s},e)}finally{a.rmSync(m,{force:!0})}}async function Y(e){let{videoPath:t,trimStartMs:i}=e;i>0&&await Z({videoPath:t,scriptPath:r??=J("recording-trim.swift"),scriptArgs:["--trim-start-ms",String(i)],commandDescription:"Failed to trim the start of the iOS recording"})}async function ee(e){let{videoPath:r,telemetryPath:i,exportQuality:a="medium",targetLabel:o="recording"}=e;await Z({videoPath:r,scriptPath:t??=J("recording-overlay.swift"),scriptArgs:["--events",i,"--quality",a],commandDescription:`Failed to add touch overlays to the ${o}`})}async function et(e){let{videoPath:t,maxSize:r,exportQuality:a="medium",targetLabel:o="recording"}=e;await Z({videoPath:t,scriptPath:i??=J("recording-resize.swift"),scriptArgs:["--max-size",String(r),"--quality",a],commandDescription:`Failed to resize the ${o}`})}function er(e){return e instanceof Error?e.message:String(e)}function ei(e,t){return e.stderr.trim()||e.stdout.trim()||`${t} exited with code ${e.exitCode}`}function ea(e,t,r=Date.now()){let i=Math.max(0,r-t.startedAt);return i>=1e3?{message:e,tooShort:!1}:{message:`${e}. Recording stopped after ${Math.round(i)}ms; wait at least 1000ms between record start and record stop so the recorder can finalize a playable MP4`,tooShort:!0}}async function eo(e){let{recording:t,deps:r,trimStartMs:i,targetLabel:a}=e,o=Q({recording:t,trimStartMs:i});if(!t.showTouches)return void p({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"hide_touches"}});if(0===t.gestureEvents.length)return void p({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"no_gesture_events"}});let n=function(e=process.platform){if("darwin"!==e)return"touch overlay burn-in is only available on macOS hosts; returning raw video plus gesture telemetry"}();if(n){t.overlayWarning??=n;return}try{await h("record_stop_overlay_export",()=>r.overlayRecordingTouches({videoPath:t.outPath,telemetryPath:o,exportQuality:t.exportQuality,targetLabel:a}),{targetLabel:a,gestureEventCount:t.gestureEvents.length})}catch(e){t.overlayWarning??=`failed to overlay recording touches: ${er(e)}`}}function en(e,t){if(1===t)return e;let r=o.parse(e),i=r.ext||".mp4";return o.join(r.dir,`${r.name}.part-${String(t).padStart(3,"0")}${i}`)}function es(e){return e.chunks??=[{index:1,path:e.outPath,remotePath:e.remotePath}],e.chunks}async function ec(e){let{recording:t,startNextChunk:r,finishCurrentChunk:i}=e;if(t.stopping)return;let a=await i();if(a)throw Error(a);if(t.stopping)return;let n=es(t),s=n.length+1,c=await r(o.posix.dirname(t.remotePath));t.remotePath=c.remotePath,t.remotePid=c.remotePid,n.push({index:s,path:en(t.outPath,s),remotePath:c.remotePath}),t.warning??="Android adb screenrecord is capped at 180s, so this recording was split into multiple MP4 chunks."}async function ed(e){let{recording:t,deps:r}=e;es(t).length<=1?await eo({recording:t,deps:r,targetLabel:"Android recording"}):(Q({recording:t}),t.showTouches&&t.gestureEvents.length>0&&(t.overlayWarning??="touch overlay burn-in is skipped for chunked Android recordings; returning raw chunks plus gesture telemetry"))}async function el(e){for(let t of e.chunks){let r=await eu({deps:e.deps,deviceId:e.deviceId,remotePath:t.remotePath,outPath:t.path});if(r)return`failed to copy recording chunk ${t.index}: ${r}`}}async function eu(e){let t,{deps:r,deviceId:i,remotePath:o,outPath:n}=e;for(let e=0;e<2;e+=1){em(n);let s=w(i),c=await y(o,n,{allowFailure:!0,device:s});if(0!==c.exitCode)t=ei(c,"adb pull");else{await r.waitForStableFile(n,{pollMs:250,attempts:20});let t=await r.isPlayableVideo(n);if(p({level:"debug",phase:"record_stop_android_pull_validation",data:{deviceId:i,remotePath:o,outPath:n,attempt:e+1,fileSize:function(e){try{return a.statSync(e).size}catch{return 0}}(n),playable:t}}),t)return;p({level:"warn",phase:"record_stop_android_invalid_video_retry",data:{deviceId:i,remotePath:o,outPath:n,attempt:e+1}})}e<1&&await f(750)}return t?`failed to copy recording from device: ${t}`:(em(n),"failed to copy recording from device: pulled file is not a playable MP4")}function em(e){try{a.rmSync(e,{force:!0})}catch{}}let ef={medium:8e6,high:2e7};async function eh(e,t,r){return await g(w(e),t,r)}async function ep(e,t){let r=await eh(e,["shell","ps","-o","pid=","-p",t],{allowFailure:!0});return 0===r.exitCode&&r.stdout.split(/\s+/).map(e=>e.trim()).includes(t)}async function ew(e,t){for(let r=0;r<40;r+=1){if(!await ep(e,t))return!0;await f(250)}return!await ep(e,t)}async function eg(e,t){let r,i=0;for(let a=0;a<20;a+=1){let a=await eh(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===a.exitCode?a.stdout.trim():"";if(o.length>0&&o===r){if((i+=1)>=4)return}else i=0;r=o,await f(250)}}async function ey(e,t,r){for(let i=0;i<8;i+=1){let a=await eh(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===a.exitCode?Number(a.stdout.trim()):NaN;if(Number.isFinite(o)&&o>0)return!0;if(!await ep(e,r))break;if(i+1>=2)return!0;await f(250)}return!1}async function e_(e){let{deviceId:t,maxSize:r}=e;if(void 0===r)return;let i=await eh(t,["shell","wm","size"],{allowFailure:!0}),a=i.stdout.match(/Override size:\s*(\d+)x(\d+)/)??i.stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(0!==i.exitCode||!a)throw Error(`failed to resolve Android screen size for recording max-size: ${ei(i,"adb shell wm size")}`);var o={width:Number(a[1]),height:Number(a[2]),maxSize:r};let n=Math.max(o.width,o.height);if(n<=o.maxSize)return{width:o.width,height:o.height};let s=o.maxSize/n;return{width:ev(o.width,s),height:ev(o.height,s)}}function ev(e,t){return Math.max(2,2*Math.round(e*t/2))}async function eP(e,t){await eh(e,["shell","rm","-f",t],{allowFailure:!0})}async function eS(e,t){let r=await eh(e,["shell","kill","-9",t],{allowFailure:!0});return p({level:"warn",phase:"record_stop_android_force_signal",data:{deviceId:e,remotePid:t,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),!(0!==r.exitCode&&await ep(e,t))&&await ew(e,t)}async function eA(e){var t;let r,i,{device:a,recordingSize:o,quality:n,preferredRemoteDir:s}=e,c="failed to start recording: Android screenrecord did not begin producing frames";for(let e of(t=Date.now(),r=`agent-device-recording-${t}.mp4`,i=["/sdcard","/data/local/tmp"],(s&&i.includes(s)?[s,...i.filter(e=>e!==s)]:i).map(e=>`${e}/${r}`))){let t=await eh(a.id,["shell",function(e,t,r){let i=["screenrecord"];return t&&i.push("--size",`${t.width}x${t.height}`),i.push("--bit-rate",String(ef[r])),i.push(e),`${i.join(" ")} >/dev/null 2>&1 & echo $!`}(e,o,n)],{allowFailure:!0});if(0!==t.exitCode){c=`failed to start recording: ${ei(t,"adb shell screenrecord")}`;continue}let r=t.stdout.split(/\r?\n/).map(e=>e.trim()).filter(e=>/^\d+$/.test(e)).at(-1);if(!r){c="failed to start recording: adb did not return a valid Android screenrecord pid",await eP(a.id,e);continue}if(p({level:"debug",phase:"record_start_android_started",data:{deviceId:a.id,remotePath:e,remotePid:r}}),await ey(a.id,e,r))return{remotePath:e,remotePid:r,startedAt:Date.now()};c="failed to start recording: Android screenrecord did not begin producing frames",await eS(a.id,r),await eP(a.id,e)}return{error:S("COMMAND_FAILED",c)}}async function eM(e){let t,{device:r,recordingBase:i}=e;try{t=await e_({deviceId:r.id,maxSize:i.maxSize})}catch(e){return S("COMMAND_FAILED",e instanceof Error?e.message:String(e))}let a=i.exportQuality??"medium",o=await eA({device:r,recordingSize:t,quality:a});if("error"in o)return o.error;let n={platform:"android",remotePath:o.remotePath,remotePid:o.remotePid,chunks:[{index:1,path:i.outPath,remotePath:o.remotePath}],...i,startedAt:o.startedAt};return!function e(t){let{recording:r,startNextChunk:i,finishCurrentChunk:a}=t,o=setTimeout(()=>{r.rotationPromise=ec({recording:r,startNextChunk:i,finishCurrentChunk:a}).catch(e=>{r.rotationFailedReason=e instanceof Error?e.message:String(e)}).finally(()=>{r.rotationPromise=void 0,r.stopping||r.rotationFailedReason||e({recording:r,startNextChunk:i,finishCurrentChunk:a})})},17e4);o.unref?.(),r.rotationTimer=o}({recording:n,finishCurrentChunk:async()=>await eC({device:r,recording:n,waitForRemoteFileStability:!1}),startNextChunk:async e=>{let i=await eA({device:r,recordingSize:t,quality:a,preferredRemoteDir:e});if("error"in i)throw Error(i.error.ok?"failed to start next Android recording chunk":i.error.error.message);return i}}),n}async function eC(e){let{device:t,recording:r,waitForRemoteFileStability:i=!0}=e;await ep(t.id,r.remotePid)||(r.warning??=function(e){if(!(Date.now()-e.startedAt<178e3))return"Android adb screenrecord stopped before record stop, likely after reaching the 180s platform limit. The MP4 may be truncated; final interactions after the limit are not in the video."}(r));let a=await eh(t.id,["shell","kill","-2",r.remotePid],{allowFailure:!0});if(p({level:"debug",phase:"record_stop_android_signal",data:{deviceId:t.id,remotePath:r.remotePath,remotePid:r.remotePid,exitCode:a.exitCode,stdout:a.stdout.trim(),stderr:a.stderr.trim()}}),0!==a.exitCode)return await eb(t.id,r.remotePid,a);let o=await ex(t.id,r.remotePid);if(o)return o;i&&await eg(t.id,r.remotePath)}async function eb(e,t,r){if(await ep(e,t)&&!await eS(e,t))return`failed to stop recording: ${ei(r,"adb shell kill")}`}async function ex(e,t){if(!await ew(e,t)&&!await eS(e,t))return`failed to stop recording: Android screenrecord pid ${t} did not exit`}async function eI(e){let t,{deps:r,device:i,recording:a,stopRequestedAt:o}=e;p({level:"debug",phase:"record_stop_android_enter",data:{deviceId:i.id,remotePath:a.remotePath,remotePid:a.remotePid}}),a.stopping=!0,a.rotationTimer&&(clearTimeout(a.rotationTimer),a.rotationTimer=void 0),await a.rotationPromise;let n=await eC({device:i,recording:a});if(a.rotationFailedReason&&!n&&(a.warning??=`Android recording chunk rotation failed: ${a.rotationFailedReason}`),!n){let e=await el({deps:r,deviceId:i.id,chunks:es(a)});if(e)return await s(),S("COMMAND_FAILED",eD(e,a,o));await ed({recording:a,deps:r})}if(await s(),n)return S("COMMAND_FAILED",eD(n,a,o));if(t)return S("COMMAND_FAILED",t);return null;async function s(){for(let e of es(a)){let r=await eh(i.id,["shell","rm","-f",e.remotePath],{allowFailure:!0});p({level:"debug",phase:"record_stop_android_cleanup",data:{deviceId:i.id,remotePath:e.remotePath,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),0===r.exitCode||n||(t=`failed to clean up remote recording: ${ei(r,"adb shell rm")}`)}}}function eD(e,t,r){return ea(e,t,r).message}function e$(e){let t=e.appBundleId?.trim();return t&&t.length>0?t:void 0}function eR(e,t,r){return{verbose:e.flags?.verbose,logPath:t,traceLogPath:r.trace?.outPath,requestId:e.meta?.requestId,iosXctestrunFile:e.flags?.iosXctestrunFile,iosXctestDerivedDataPath:e.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:e.flags?.iosXctestEnvDir}}async function eN(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o}=e,n=e$(r);try{await o.runIosRunnerCommand(i,{command:"recordStop",appBundleId:n},eR(t,a,r))}catch(e){p({level:"warn",phase:"record_stop_runner_failed",data:{platform:i.platform,kind:i.kind,deviceId:i.id,session:r.name,error:er(e)}})}}async function ek(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o}=e,n=e$(r);if(n)try{let e=await o.runIosRunnerCommand(i,{command:"snapshot",appBundleId:n,interactiveOnly:!0,depth:1},eR(t,a,r)),s=Date.now();if("number"==typeof e.currentUptimeMs&&Number.isFinite(e.currentUptimeMs)&&e.currentUptimeMs>0)return p({level:"debug",phase:"record_start_gesture_clock_anchor",data:{source:"warm_snapshot"}}),{gestureClockOriginAtMs:s,gestureClockOriginUptimeMs:e.currentUptimeMs};return}catch(e){p({level:"warn",phase:"record_start_simulator_runner_warm_failed",data:{deviceId:i.id,session:r.name,appBundleId:n,error:er(e)}});return}}async function eE(e){let t,r,{req:i,activeSession:a,sessionStore:o,device:n,logPath:s,deps:c,fpsFlag:d,recordingBase:l,appBundleId:u}=e,m=`agent-device-recording-${Date.now()}.mp4`,f=`tmp/${m}`,h=eR(i,s,a),w=async()=>c.runIosRunnerCommand(n,{command:"recordStart",outPath:m,fps:d,maxSize:l.maxSize,appBundleId:u},h);try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(i){var g,y;if(!er(i).toLowerCase().includes("recording already in progress"))return S("COMMAND_FAILED",`failed to start recording: ${er(i)}`);p({level:"warn",phase:"record_start_runner_desynced",data:{platform:n.platform,kind:n.kind,deviceId:n.id,session:a.name,error:er(i)}});let e=(g=n.id,y=a.name,o.toArray().find(e=>e.name!==y&&"ios"===e.device.platform&&"device"===e.device.kind&&e.device.id===g&&e.recording?.platform==="ios-device-runner"));if(e)return S("COMMAND_FAILED",`failed to start recording: recording already in progress in session '${e.name}'`);try{await c.runIosRunnerCommand(n,{command:"recordStop",appBundleId:u},h)}catch{}try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(e){return S("COMMAND_FAILED",`failed to start recording: ${er(e)}`)}}return{platform:"ios-device-runner",remotePath:f,runnerStartedAtUptimeMs:t,targetAppReadyUptimeMs:r,...l}}async function eF(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,fpsFlag:n,recordingBase:s,appBundleId:c}=e;try{await o.runIosRunnerCommand(i,{command:"recordStart",outPath:s.outPath,fps:n,maxSize:s.maxSize,appBundleId:c},eR(t,a,r))}catch(e){return S("COMMAND_FAILED",`failed to start recording: ${er(e)}`)}return{platform:"macos-runner",...s}}async function eO(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,recording:n}=e;await eN({req:t,activeSession:r,device:i,logPath:a,deps:o});let s={stdout:"",stderr:"",exitCode:1};for(let e of I)if(0===(s=await o.runCmd("xcrun",["devicectl","device","copy","from","--device",i.id,"--source",n.remotePath,"--destination",n.outPath,"--domain-type","appDataContainer","--domain-identifier",e],{allowFailure:!0})).exitCode)break;if(0!==s.exitCode){let e=s.stderr.trim()||s.stdout.trim()||`devicectl exited with code ${s.exitCode}`;return S("COMMAND_FAILED",`failed to copy recording from device: ${e}`)}let c="number"!=typeof n.runnerStartedAtUptimeMs||"number"!=typeof n.targetAppReadyUptimeMs?0:Math.max(0,n.targetAppReadyUptimeMs-n.runnerStartedAtUptimeMs);return c>0&&await o.trimRecordingStart({videoPath:n.outPath,trimStartMs:c}),await eo({recording:n,deps:o,trimStartMs:c,targetLabel:"iOS recording"}),null}async function eL(e){let{req:t,activeSession:r,device:i,logPath:a,deps:o,recording:n}=e;return await eN({req:t,activeSession:r,device:i,logPath:a,deps:o}),await eo({recording:n,deps:o,targetLabel:"macOS recording"}),null}async function eT(e){let{deps:t,recording:r}=e;r.child.kill("SIGINT");let i=await ez(r.wait,5e3);return i||(await eU(t,r,"SIGINT"),(i=await ez(r.wait,2e3))||(r.child.kill("SIGTERM"),await eU(t,r,"SIGTERM"),i=await ez(r.wait,2e3)))?i:(r.child.kill("SIGKILL"),await eU(t,r,"SIGKILL"),await ez(r.wait,2e3))}async function ez(e,t){return await Promise.race([e,f(t).then(()=>null)])}async function eU(e,t,r){await eG(e,t,r)||await eK(e,t.outPath,r)}async function eK(e,t,r){let i,a=`simctl.*recordVideo.*${t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}`;try{i=await e.runCmd("pgrep",["-f",a],{allowFailure:!0})}catch(e){p({level:"warn",phase:"record_stop_ios_simulator_pgrep_failed",data:{outPath:t,signal:r,error:er(e)}});return}let o=eH(eq(i.stdout)),n=ej(o,r);p({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_recorders",data:{outPath:t,signal:r,matchedPidCount:o.length,signaled:n,pgrepExitCode:i.exitCode}})}async function eG(e,t,r){let i=t.recorderPid??t.child.pid;if("number"!=typeof i||!Number.isInteger(i)||i<=0)return p({level:"debug",phase:"record_stop_ios_simulator_owned_recorder_unavailable",data:{outPath:t.outPath,signal:r,reason:"missing_recorder_pid"}}),!1;let a=await eV(e,i,t.outPath,r),o=eH([i,...a.pids]),n=ej(o,r);return p({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_owned_recorder",data:{outPath:t.outPath,signal:r,recorderPid:i,childPidCount:a.pids.length,matchedPidCount:o.length,signaled:n,pgrepExitCode:a.exitCode}}),n>0}async function eV(e,t,r,i){let a;try{a=await e.runCmd("pgrep",["-P",String(t)],{allowFailure:!0})}catch(e){return p({level:"warn",phase:"record_stop_ios_simulator_owned_pgrep_failed",data:{outPath:r,signal:i,parentPid:t,error:er(e)}}),{pids:[]}}return{pids:eq(a.stdout),exitCode:a.exitCode}}function eH(e){return Array.from(new Set(e)).filter(e=>Number.isInteger(e)&&e>0&&e!==process.pid)}function ej(e,t){let r=0;for(let i of e)try{process.kill(i,t),r+=1}catch{}return r}function eq(e){return e.split(/\s+/).map(e=>Number(e)).filter(e=>Number.isInteger(e)&&e>0)}async function eW(e){"ios"!==e.platform||0!==e.gestureEvents.length&&await f(350)}async function eB(e){for(let t=0;t<2;t+=1){try{if(a.statSync(e).size>0)return Date.now()}catch{}if(t+1>=2)break;await f(250)}return Date.now()}async function eX(e){let t,r,{req:i,activeSession:a,device:o,logPath:n,deps:s,recordingBase:c,resolvedOut:d}=e,l=c.showTouches?await ek({req:i,activeSession:a,device:o,logPath:n,deps:s}):void 0,{child:u,wait:m}=s.startIosSimulatorRecording({device:o,outPath:d}),f=await eB(d);if(l)t=l.gestureClockOriginAtMs,r=l.gestureClockOriginUptimeMs;else if(c.showTouches)try{let e=Date.now(),c=await s.runIosRunnerCommand(o,{command:"uptime",appBundleId:e$(a)},eR(i,n,a)),d=Date.now();t=Math.round((e+d)/2),r="number"==typeof c.currentUptimeMs?c.currentUptimeMs:void 0}catch{}return{platform:"ios",child:u,wait:m,...c,recorderPid:u.pid,startedAt:f,gestureClockOriginAtMs:void 0===r?void 0:t,gestureClockOriginUptimeMs:r}}async function eQ(e){let t,r,{req:i,sessionName:n,sessionStore:s,activeSession:c,device:d,logPath:l,deps:u}=e;if(c.recording)return S("INVALID_ARGS","recording already in progress");let m=i.flags?.fps,f=i.flags?.quality,h=i.flags?.screenshotMaxSize;if(void 0!==m&&(!Number.isInteger(m)||m<1||m>120))return S("INVALID_ARGS","fps must be an integer between 1 and 120");if(void 0!==f&&void 0===$(f))return S("INVALID_ARGS",`quality must be one of: ${R.join(", ")} (legacy numeric values 5-10 are accepted)`);if(void 0!==h&&(!Number.isInteger(h)||h<1))return S("INVALID_ARGS","max-size must be a positive integer");if(!A("record",d))return S("UNSUPPORTED_OPERATION","record is not supported on this device");let p=i.positionals?.[1]??`./recording-${Date.now()}.mp4`,w=v.expandHome(p,i.meta?.cwd),g=(r=$(i.flags?.quality),{outPath:w,clientOutPath:i.meta?.clientArtifactPaths?.outPath,startedAt:Date.now(),maxSize:i.flags?.screenshotMaxSize,exportQuality:r??"medium",showTouches:i.flags?.hideTouches!==!0,gestureEvents:[]});if(a.mkdirSync(o.dirname(w),{recursive:!0}),a.rmSync(w,{force:!0}),"ios"===d.platform&&"device"===d.kind){let e=e$(c);if(!e)return S("INVALID_ARGS","record on physical iOS devices requires an active app session; run open <app> first");t=await eE({req:i,activeSession:c,sessionStore:s,device:d,logPath:l,deps:u,fpsFlag:m,recordingBase:g,appBundleId:e})}else if("macos"===d.platform){let e=e$(c);if(!e)return S("INVALID_ARGS","record on macOS requires an active app session; run open <app> first");t=await eF({req:i,activeSession:c,device:d,logPath:l,deps:u,fpsFlag:m,recordingBase:g,appBundleId:e})}else t="ios"===d.platform?await eX({req:i,activeSession:c,device:d,logPath:l,deps:u,recordingBase:g,resolvedOut:w}):await eM({device:d,recordingBase:g});if("ok"in t)return t;c.recording=t,s.set(n,c);let y=s.ensureSessionDir(n);return s.recordAction(c,{command:i.command,positionals:i.positionals??[],flags:i.flags??{},result:{action:"start",showTouches:t.showTouches}}),{ok:!0,data:{recording:"started",outPath:t.clientOutPath??p,sessionStateDir:y,showTouches:t.showTouches}}}async function eJ(e){let{deps:t,device:r,recording:i,stopRequestedAt:a}=e;if("android"===i.platform)return await eI({deps:t,device:r,recording:i,stopRequestedAt:a});await h("record_stop_tail_settle",()=>t.waitForRecordingTail(i),{platform:i.platform,gestureEventCount:i.gestureEvents.length});let o=await h("record_stop_ios_simulator_process",()=>eT({deps:t,recording:i}),{outPath:i.outPath});if(!o)return eZ("failed to stop recording: simctl recordVideo did not exit after 5000ms and forced cleanup",i,a);if(0!==o.exitCode)return eZ(`failed to stop recording: ${ei(o,"simctl recordVideo")}`,i,a);if(await h("record_stop_video_stable",()=>t.waitForStableFile(i.outPath,{pollMs:150,attempts:12}),{outPath:i.outPath}),!await h("record_stop_video_playable_check",()=>t.isPlayableVideo(i.outPath),{outPath:i.outPath}))return eZ(`failed to stop recording: ${i.outPath} was not finalized into a playable video`,i,a);if(void 0!==i.maxSize)try{await h("record_stop_resize",()=>t.resizeRecording({videoPath:i.outPath,maxSize:i.maxSize,exportQuality:i.exportQuality,targetLabel:"iOS recording"}),{outPath:i.outPath,maxSize:i.maxSize})}catch(e){i.overlayWarning=`failed to resize recording: ${er(e)}`}return await h("record_stop_finalize_overlay",()=>eo({recording:i,deps:t,targetLabel:"iOS recording"}),{outPath:i.outPath,showTouches:i.showTouches,gestureEventCount:i.gestureEvents.length}),null}function eZ(e,t,r){let i=ea(e,t,r);return function(e){try{a.rmSync(e,{force:!0})}catch{}}(t.outPath),S("COMMAND_FAILED",i.message)}async function eY(e){var t;let r,i,{req:a,activeSession:n,device:s,logPath:c,deps:d}=e;if(!n.recording)return S("INVALID_ARGS","no active recording");let l=n.recording,u=Date.now(),m=l.invalidatedReason;n.recording=void 0;let f="ios-device-runner"===l.platform?await eO({req:a,activeSession:n,device:s,logPath:c,deps:d,recording:l}):"macos-runner"===l.platform?await eL({req:a,activeSession:n,device:s,logPath:c,deps:d,recording:l}):await eJ({deps:d,device:s,recording:l,stopRequestedAt:u});if(f)return f;if(m&&"ios"===l.platform&&l.showTouches)l.overlayWarning??=`overlay unavailable: ${m}`;else if(m)return S("COMMAND_FAILED",m);return r="android"===(t=l).platform?t.chunks:void 0,i=[{field:"outPath",path:t.outPath,localPath:t.clientOutPath,fileName:o.basename(t.clientOutPath??t.outPath)}],r&&r.length>1&&i.push(...r.slice(1).map(e=>({field:"chunkPath",path:e.path,localPath:e0(t,e.index),fileName:o.basename(e0(t,e.index)??e.path)}))),t.telemetryPath&&i.push({field:"telemetryPath",path:t.telemetryPath,localPath:function(e){if(e.clientOutPath)return B(e.clientOutPath)}(t),fileName:o.basename(t.telemetryPath)}),{ok:!0,data:{recording:"stopped",outPath:t.outPath,telemetryPath:t.telemetryPath,artifacts:i,showTouches:t.showTouches,warning:t.warning,overlayWarning:t.overlayWarning,chunks:r?.map(e=>({index:e.index,path:e0(t,e.index)??e.path}))}}}function e0(e,t){if("android"===e.platform&&e.clientOutPath)return en(e.clientOutPath,t)}function e1(e,t,r,i={}){r.recordOnlySession&&(i.writeLog&&e.writeSessionLog(r),e.delete(t))}async function e2(e){let{req:t,sessionName:r,sessionStore:i,logPath:a}=e,o={runCmd:async(e,t,r)=>"xcrun"===e?await _(t,r):await l(e,t,r),startIosSimulatorRecording:e=>D().startIosSimulatorRecording(e),runIosRunnerCommand:P,waitForRecordingTail:eW,waitForStableFile:G,isPlayableVideo:V,trimRecordingStart:Y,resizeRecording:et,overlayRecordingTouches:ee},n=i.get(r),s=n?.device??await x(t.flags??{});n||await M(s);let c=n??{name:C(t),sessionScope:b(t),device:s,createdAt:Date.now(),recordOnlySession:!0,actions:[]},d=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(d))return S("INVALID_ARGS","record requires start|stop");if("start"===d)return eQ({req:t,sessionName:r,sessionStore:i,activeSession:c,device:s,logPath:a,deps:o});let u=await eY({req:t,activeSession:c,device:s,logPath:a,deps:o});return u.ok?(i.recordAction(c,{command:t.command,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:u.data?.outPath,showTouches:u.data?.showTouches}}),e1(i,r,c,{writeLog:!0})):e1(i,r,c),u}export{e2 as handleRecordCommand};

package/dist/src/remote-config.d.ts

@@ -16,7 +16,7 @@ declare type LeaseBackend = (typeof LEASE_BACKENDS)[number];
 
 declare type MetroPrepareKind = 'auto' | 'react-native' | 'expo';
 
-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/selector-runtime.js

@@ -1 +1 @@
-import{createDaemonRuntimeSessionStore as e,setSessionSnapshot as t,captureSnapshot as r,dispatchCommand as s,runIosRunnerCommand as n,isCommandSupportedOnDevice as o,errorResponse as i,ensureDeviceReady as a,stopIosRunnerSession as l,resolveRunnerAppBundleId as u,getActiveAndroidSnapshotFreshness as c,resolveTargetDevice as d,context_contextFromFlags as f}from"./9722.js";import{closeIosApp as p}from"./apps.js";import{emitDiagnostic as m}from"./432.js";import{asAppError as g,normalizeError as h,AppError as y}from"./733.js";import{evaluateIsPredicate as w,isSupportedPredicate as _,localCommandPolicy as S,createAgentDevice as v}from"./5299.js";import{tryParseSelectorChain as x,extractNodeReadText as k,prefersValueForReadableText as I,findNodeByLabel as N,normalizeType as A,splitIsSelectorArgs as P}from"./9836.js";import{resolveRectCenter as R,isSparseSnapshotQualityVerdict as b,parseWaitPositionals as D}from"./9873.js";import{getAndroidAppState as E}from"./3340.js";import{buildSnapshotPresentationKey as q,isApplePlatform as C,snapshotPresentationOptionsFromFlags as M}from"./4291.js";import{parseFindArgs as O}from"./587.js";async function $(e,t,r){let s=e.get(t),n=s?.device??await d(r??{});return s||await a(n),{session:s,device:n}}async function L(e,t,r){let s=!e&&"ios"===t.platform;try{return await r()}finally{s&&(await l(t.id),await U(t))}}async function U(e){let t=u();await p(e,t).catch(r=>{m({level:"debug",phase:"ios_sessionless_runner_host_close_failed",data:{deviceId:e.id,bundleId:t,error:r instanceof Error?r.message:String(r)}})})}function K(e,t,r,s){t&&e.recordAction(t,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:s})}function F(e){let{session:t,sessionName:r,device:s,snapshot:n,appBundleId:o}=e;return t?{...t,snapshot:n,lastComparisonSafeSnapshot:n?.comparisonSafe===!0?n:t.lastComparisonSafeSnapshot}:{name:r,device:s,createdAt:Date.now(),appBundleId:o,snapshot:n,...n?.comparisonSafe===!0?{lastComparisonSafeSnapshot:n}:{},actions:[]}}function T(e,t={}){return{artifacts:function(e,t={}){let r=!0===t.plural?"do":"does";return{resolveInput:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not resolve input artifacts`)},reserveOutput:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not reserve output artifacts`)},createTempFile:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not create temporary files`)}}}(e,t),policy:S()}}async function G(e){let{device:t,node:r,flags:n,appBundleId:o,traceOutPath:i,surface:a,contextFromFlags:l}=e,u=k(r),c=R(r.rect);if(!c||"ios"===t.platform&&u&&!I(r.type??""))return u;try{let e=await s(t,"read",[String(c.x),String(c.y)],void 0,{...l(n,o,i),surface:a}),d=e&&"object"==typeof e?e:void 0,f="string"==typeof d?.text?d.text:"";if(f.trim())return f;return m({level:"warn",phase:"interaction_read_fallback",data:{reason:"empty_backend_text",nodeRef:r.ref,surface:a,platform:t.platform}}),u}catch(e){return m({level:"warn",phase:"interaction_read_fallback",data:{reason:"backend_read_failed",nodeRef:r.ref,surface:a,platform:t.platform,error:e instanceof Error?e.message:String(e)}}),u}}let V=[["snapshotDepth","--depth"],["snapshotScope","--scope"],["snapshotRaw","--raw"]];function B(e,t){let r=function(e){if(!e)return[];let t=[];for(let[r,s]of V)void 0!==e[r]&&t.push(s);return t}(t);return 0===r.length?null:i("INVALID_ARGS",`${e} @ref does not support ${r.join(", ")}.`)}async function X(e,t){let r=await j(e);if(r)throw new y("COMMAND_FAILED",`press ${t} left ${e.appBundleId} and foregrounded ${r.foregroundPackage}. The tap likely escaped the app.`,r)}async function j(e){var t;if("android"!==e.device.platform||!e.appBundleId)return null;let r=await E(e.device),s=r.package?.trim();return s&&s!==e.appBundleId&&("com.android.settings"===(t=s)||"com.android.systemui"===t||"com.google.android.permissioncontroller"===t||t.includes("launcher"))?{expectedPackage:e.appBundleId,foregroundPackage:s,activity:r.activity,hint:"com.google.android.permissioncontroller"===s?"Dismiss or allow the permission prompt, then retry the smoke assertion.":"Use screenshot as visual truth, then take a fresh snapshot -i before retrying."}:null}function H(e){return"COMMAND_FAILED"===e.code&&"string"==typeof e.details?.expectedPackage&&"string"==typeof e.details?.foregroundPackage}function W(e,t){let r=Array.isArray(e.selectorChain)?e.selectorChain:void 0,s=Y(e),n=s?.kind==="ref"?Z(s.ref):void 0,o=s?.kind==="selector"?s.selector:void 0,i={...n?{ref:n}:{},...o?{selector:o}:{},...r?{selectorChain:r}:{}};if("attrs"===t)return i;let a="string"==typeof e.text?e.text:"";return{...i,text:a,refLabel:function(e){let t=e.trim();if(!(!t||t.length>80||/[\r\n]/.test(t)))return t}(a)}}function z(e){let t=Y(e);return{...t?.kind==="ref"?{ref:Z(t.ref)}:{},...t?.kind==="selector"?{selector:t.selector}:{},..."string"==typeof e.text?{text:e.text}:{},...e.node&&"object"==typeof e.node?{node:e.node}:{}}}function Q(e){let{selectorChain:t,...r}=e;return r}function J(e,t,r,s){let n=e.get(t);n&&e.recordAction(n,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:s})}function Y(e){let t=e.target;return t&&"object"==typeof t?"ref"===t.kind&&"string"==typeof t.ref?{kind:"ref",ref:t.ref}:"selector"===t.kind&&"string"==typeof t.selector?{kind:"selector",selector:t.selector}:void 0:void 0}function Z(e){return e.startsWith("@")?e.slice(1):e}let ee=["application","window","tabbar","scrollbar","image"],et=new Set(["tab bar"]);async function er(e,t){var r;if(t.ok||(r=t.error.message,!/^wait timed out for (?:selector|text): /i.test(r)))return t;let s=await es(e).catch(()=>null);return s?i(t.error.code,`${t.error.message}. Current surface: ${s.summary}.`,{...t.error.details??{},currentSurface:s.details}):t}async function es(e){let t=[...(await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!0},logPath:e.logPath??""})).snapshot.nodes].sort(eo),s=en(t,6,{includeIdentifiers:!0});if(0===s.length)return null;let n=en(t.filter(e=>!el(e)),4,{includeIdentifiers:!1}),o=en(t.filter(eu),4,{includeIdentifiers:!0});return{summary:(n.length>0?n:s.slice(0,4)).join(", "),details:{labels:s,...o.length>0?{buttons:o}:{}}}}function en(e,t,r){let s=new Set,n=[];for(let o of e){let e=ea(o,r);if(!(!e||s.has(e))&&(s.add(e),n.push(e),n.length>=t))break}return n}function eo(e,t){var r,s;return ei(e)-ei(t)||(r=e,s=t,r.rect&&s.rect?r.rect.y-s.rect.y||r.rect.x-s.rect.x:r.rect?-1:s.rect?1:(r.depth??0)-(s.depth??0)||r.index-s.index)}function ei(e){let t=!!ea(e,{includeIdentifiers:!1});return 2*!!el(e)+ +!t}function ea(e,t){let r=(t.includeIdentifiers?[e.label,e.value,e.identifier]:[e.label,e.value]).map(e=>"string"==typeof e?e.trim():"").find(e=>e.length>0);return r?r.replace(/\s+/g," ").slice(0,80):""}function el(e){let t=A(`${e.type??""} ${e.role??""} ${e.subrole??""}`),r=`${e.label??""} ${e.value??""}`.trim().toLowerCase();return ee.some(e=>t.includes(e))||et.has(r)||r.endsWith(".fill")}function eu(e){return A(`${e.type??""} ${e.role??""} ${e.subrole??""}`).includes("button")}function ec(e){var t;let{session:r,selectorExpression:s}=e;if(!r||"ios"!==r.device.platform||r.postGestureStabilization)return null;let n=x(s);if(!n||1!==n.selectors.length)return null;let o=n.selectors[0];if(!o||1!==o.terms.length)return null;let i=o.terms[0];return i&&"string"==typeof i.value&&("id"===(t=i.key)||"label"===t||"text"===t||"value"===t)?{key:i.key,value:i.value,raw:o.raw}:null}function ed(e,t={}){let r=g(e);if("ELEMENT_NOT_FOUND"===r.code)return!0===t.allowElementNotFound;if("COMMAND_FAILED"!==r.code)return!1;let s=r.message.toLowerCase();return s.includes("fetch failed")||s.includes("timed out")||s.includes("timeout")||s.includes("runner did not accept connection")||s.includes("invalid runner response")}async function ef(e){var t;let{req:r}=e;if("find"!==r.command)return null;let s=r.positionals??[];if(0===s.length)return i("INVALID_ARGS","find requires a locator or text");let n=O(s);if(!n.query)return i("INVALID_ARGS","find requires a value");if(r.flags?.findFirst&&r.flags?.findLast)return i("INVALID_ARGS","find accepts only one of --first or --last");let o=n.action;if("exists"!==(t=o)&&"wait"!==t&&"get_text"!==t&&"get_attrs"!==t)return null;let a=await eI(e,{requireSession:!1,capability:"find"});return a.ok?await eP(async()=>{let t=await a.runtime.selectors.find({session:e.sessionName,requestId:r.meta?.requestId,locator:n.locator,query:n.query,action:o,timeoutMs:n.timeoutMs});return J(e.sessionStore,e.sessionName,r,function(e,t){if("exists"===t)return{found:!0};if("wait"===t)return{found:!0,waitedMs:e.waitedMs};let r="string"==typeof e.ref?e.ref:void 0;return"get_attrs"===t?{ref:r,action:"get attrs"}:{ref:r,action:"get text",text:"string"==typeof e.text?e.text:""}}(t,o)),"found"===t.kind?{found:!0,..."number"==typeof t.waitedMs?{waitedMs:t.waitedMs}:{}}:{..."string"==typeof t.ref?{ref:t.ref}:{},..."string"==typeof t.text?{text:t.text}:{},...t.node&&"object"==typeof t.node?{node:t.node}:{}}}):a.response}async function ep(e){let{req:t}=e;if("get"!==t.command)return null;let r=t.positionals?.[0];if("text"!==r&&"attrs"!==r)return i("INVALID_ARGS","get only supports text or attrs");let s=function(e){let t=e.positionals?.[1]??"";if(t.startsWith("@"))return{ok:!0,target:{kind:"ref",ref:t,fallbackLabel:e.positionals.length>2?e.positionals.slice(2).join(" ").trim():""}};let r=e.positionals?.slice(1).join(" ").trim()??"";return r?{ok:!0,target:{kind:"selector",selector:r}}:{ok:!1,response:i("INVALID_ARGS","get requires @ref or selector expression")}}(t);if(!s.ok)return s.response;if("ref"===s.target.kind){let e=B("get",t.flags);if(e)return e}if("selector"===s.target.kind){let t=await eh(e,r,s.target.selector);if(t)return t}let n=await eI(e,{requireSession:!0,capability:"get"});return n.ok?await eP(async()=>{let o=await n.runtime.selectors.get({session:e.sessionName,requestId:t.meta?.requestId,property:r,target:s.target});return J(e.sessionStore,e.sessionName,t,W(o,r)),z(o)}):n.response}async function em(e){let{req:t}=e;if("is"!==t.command)return null;let r=(t.positionals?.[0]??"").toLowerCase();if(!_(r))return i("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");let{split:s}=P(t.positionals??[]);if(!s)return i("INVALID_ARGS","is requires a selector expression");let n=s.rest.join(" ").trim();if("text"===r&&!n)return i("INVALID_ARGS","is text requires expected text value");if("text"!==r&&s.rest.length>0)return i("INVALID_ARGS",`is ${r} does not accept trailing values`);let o=await ey(e,r,s.selectorExpression,n);if(o)return o;let a=await eI(e,{requireSession:!0,capability:"is"});if(!a.ok)return a.response;let l=await eP(async()=>{let o=await a.runtime.selectors.is({session:e.sessionName,requestId:t.meta?.requestId,predicate:r,selector:s.selectorExpression,expectedText:n});return J(e.sessionStore,e.sessionName,t,o),Q(o)});return await eR(e,l,`is ${r}`)}async function eg(e){let{req:t,sessionName:r,sessionStore:s}=e,n=D(t.positionals??[]);if(!n)return i("INVALID_ARGS","wait requires a duration or text");let{session:a,device:l}=await $(s,r,t.flags);if("sleep"!==n.kind&&!o("wait",l))return i("UNSUPPORTED_OPERATION","wait is not supported on this device");if("selector"===n.kind){let t=await ew({...e,session:a,device:l,selectorExpression:n.selectorExpression,timeoutMs:n.timeoutMs});if(t)return t}let u=async()=>{let o=ek({...e,session:a,device:l}),i=await eP(async()=>{let e=await o.selectors.wait({session:r,requestId:t.meta?.requestId,target:function(e,t){if("sleep"===e.kind)return{kind:"sleep",durationMs:e.durationMs};if("selector"===e.kind)return{kind:"selector",selector:e.selectorExpression,timeoutMs:e.timeoutMs};if("ref"===e.kind){if(!t?.snapshot)throw new y("INVALID_ARGS","Ref wait requires an existing snapshot in session.");return{kind:"ref",ref:e.rawRef,timeoutMs:e.timeoutMs}}if(!e.text)throw new y("INVALID_ARGS","wait requires text");return{kind:"text",text:e.text,timeoutMs:e.timeoutMs}}(n,a)});return J(s,r,t,e),{waitedMs:e.waitedMs,..."string"==typeof e.text?{text:e.text}:{},..."string"==typeof e.selector?{selector:e.selector}:{}}}),u=await er({req:t,logPath:e.logPath,session:a,device:l},i);return await eR(e,u,"wait")};return"sleep"===n.kind?await u():await L(a,l,u)}async function eh(e,t,r){let s=e.sessionStore.get(e.sessionName),n=ec({session:s,selectorExpression:r});if(!s||!n||"text"===t&&"id"!==n.key)return null;let o=await ev(e,s,n);if(ex(o))return o.response;if(!o)return null;let i=function(e,t,r){if(!r.found||!r.node)return null;let s={target:{kind:"selector",selector:t},node:r.node,selectorChain:[t]};return"attrs"===e?{kind:"attrs",...s}:"string"!=typeof r.text?null:{kind:"text",...s,text:r.text}}(t,n.raw,o);return i?(J(e.sessionStore,e.sessionName,e.req,W(i,t)),{ok:!0,data:z(i)}):null}async function ey(e,t,r,s){var n,o,i,a,l;let u;if("hidden"===t)return null;let c=await e_(e,r);if(ex(c))return c.response;if(!c?.result.found||!c.result.node)return null;let d="exists"===t?{predicate:t,pass:!0,selector:c.selector.raw,matches:1,selectorChain:[c.selector.raw]}:(n=t,o=s,i=c.selector.raw,a=c.session,u=w({predicate:n,node:l=c.result.node,nodes:[l],expectedText:o,platform:a.device.platform}),{predicate:n,pass:u.pass,selector:i,..."text"===n?{text:u.actualText}:{},selectorChain:[i]});return d?(J(e.sessionStore,e.sessionName,e.req,d),{ok:!0,data:Q(d)}):null}async function ew(e){let t=ec({session:e.session,selectorExpression:e.selectorExpression});if(!e.session||!t)return null;let r=Date.now(),s=await ev(e,e.session,t);if(ex(s))return s.response;if(!s?.found)return null;let n={kind:"selector",selector:t.raw,waitedMs:Date.now()-r,selectorChain:[t.raw]};return J(e.sessionStore,e.sessionName,e.req,n),await er({req:e.req,logPath:e.logPath,session:e.session,device:e.device},{ok:!0,data:n})}async function e_(e,t){let r=e.sessionStore.get(e.sessionName),s=ec({session:r,selectorExpression:t});if(!r||!s)return null;let n=await ev(e,r,s);return ex(n)?n:n?{session:r,selector:s,result:n}:null}async function eS(e,t,r){let s=await n(t.device,{command:"querySelector",selectorKey:r.key,selectorValue:r.value,appBundleId:t.appBundleId},{verbose:!!e.req.flags?.verbose,logPath:e.logPath,traceLogPath:t.trace?.outPath,requestId:e.req.meta?.requestId,iosXctestrunFile:e.req.flags?.iosXctestrunFile,iosXctestDerivedDataPath:e.req.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:e.req.flags?.iosXctestEnvDir}),o=!0===s.found,i=function(e){let t=e.nodes;if(!Array.isArray(t))return;let r=t[0];if(r&&"object"==typeof r)return r}(s);return{found:o,..."string"==typeof s.text?{text:s.text}:{},...i?{node:i}:{}}}async function ev(e,t,r){try{return await eS(e,t,r)}catch(e){if(ed(e,{allowElementNotFound:!0}))return null;return{kind:"error",response:{ok:!1,error:h(e)}}}}function ex(e){return null!==e&&"kind"in e&&"error"===e.kind}function ek(s){return v({backend:function(e){let s,{req:n,session:o,device:i,logPath:a,sessionName:l,sessionStore:u}=e,d=0;return{platform:i.platform,captureSnapshot:async(e,f)=>{var p;let m,g={...n.flags,...(p=f,m={},p?.interactiveOnly!==void 0&&(m.snapshotInteractiveOnly=p.interactiveOnly),p?.scope!==void 0&&(m.snapshotScope=p.scope),p?.depth!==void 0&&(m.snapshotDepth=p.depth),p?.raw!==void 0&&(m.snapshotRaw=p.raw),m)},h=f?.scope??n.flags?.snapshotScope,y=Date.now(),w=q(M(g)),_="wait"===n.command||"find"===n.command;if(!_&&s&&y-d<750&&!c(o)&&!o?.postGestureStabilization)return s;if(!_&&o?.snapshot&&y-o.snapshot.createdAt<750&&o.snapshot.presentationKey===w&&!c(o)&&!o.postGestureStabilization)return d=o.snapshot.createdAt,s={snapshot:o.snapshot};let S=await r({device:i,session:o,flags:g,outPath:n.flags?.out,logPath:a??"",snapshotScope:h});return o&&!b(S.snapshot.snapshotQuality)&&(t(o,S.snapshot),u.set(l,o)),d=y,s={snapshot:S.snapshot}},readText:async(t,r)=>({text:await G({device:i,node:r,flags:n.flags,appBundleId:o?.appBundleId,traceOutPath:o?.trace?.outPath,surface:o?.surface,contextFromFlags:e.contextFromFlags??((e,t,r)=>f(a??"",e,t,r))})}),findText:async(t,r)=>({found:await eN(e,r)})}}(s),...T("selector commands",{plural:!0}),sessions:e({sessionName:s.sessionName,getSession:()=>s.session,recordOptions:{includeSnapshot:!0},setRecord:e=>{s.session&&e.snapshot&&(t(s.session,e.snapshot),s.sessionStore.set(s.sessionName,s.session))}})})}async function eI(e,t){let r=e.sessionStore.get(e.sessionName);if(!r&&t.requireSession)return{ok:!1,response:i("SESSION_NOT_FOUND","No active session. Run open first.")};let s=r?.device??await d(e.req.flags??{});return(r||await a(s),o(t.capability,s))?{ok:!0,runtime:ek({...e,session:r,device:s})}:{ok:!1,response:i("UNSUPPORTED_OPERATION",`${t.capability} is not supported on this device`)}}async function eN(e,t){let{device:r,session:s,req:o,logPath:i}=e;if("macos"===r.platform&&s?.surface&&"app"!==s.surface)return!!N((await eA(e)).nodes,t);if(C(r.platform)&&s?.appBundleId){let e=await n(r,{command:"findText",text:t,appBundleId:s?.appBundleId},{verbose:o.flags?.verbose,logPath:i,traceLogPath:s?.trace?.outPath,requestId:o.meta?.requestId,iosXctestrunFile:o.flags?.iosXctestrunFile,iosXctestDerivedDataPath:o.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:o.flags?.iosXctestEnvDir});return e?.found===!0}return!!N((await eA(e)).nodes,t)}async function eA(e){let s=await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!1},outPath:e.req.flags?.out,logPath:e.logPath??""});return e.session&&!b(s.snapshot.snapshotQuality)&&(t(e.session,s.snapshot),e.sessionStore.set(e.sessionName,e.session)),s.snapshot}async function eP(e){try{return{ok:!0,data:await e()}}catch(t){let e=g(t);return i(e.code,e.message,e.details)}}async function eR(e,t,r){var s;let n;if(t.ok)return t;let o=e.sessionStore.get(e.sessionName);if(!o)return t;try{n=await j(o)}catch{return t}return n?i(t.error.code,`${r} failed because ${"com.google.android.permissioncontroller"===(s=n).foregroundPackage?`Android permission dialog is blocking ${s.expectedPackage}`:`${s.foregroundPackage} is foreground instead of ${s.expectedPackage}`}.`,{...t.error.details??{},...n,blockedBy:"android_foreground_surface",originalMessage:t.error.message}):t}export{X as assertAndroidPressStayedInApp,F as buildSnapshotSession,T as createDaemonRuntimePolicy,ef as dispatchFindReadOnlyViaRuntime,ep as dispatchGetViaRuntime,em as dispatchIsViaRuntime,eg as dispatchWaitViaRuntime,H as isAndroidEscapeError,ed as isDirectIosSelectorFallbackError,ec as readSimpleIosSelectorTarget,G as readTextForNode,K as recordIfSession,B as refSnapshotFlagGuardResponse,$ as resolveSessionDevice,L as withSessionlessRunnerCleanup};
+import{createDaemonRuntimeSessionStore as e,setSessionSnapshot as t,captureSnapshot as r,dispatchCommand as s,runIosRunnerCommand as n,isCommandSupportedOnDevice as o,errorResponse as i,ensureDeviceReady as a,stopIosRunnerSession as l,resolveRunnerAppBundleId as u,getActiveAndroidSnapshotFreshness as c,resolveTargetDevice as d,context_contextFromFlags as f}from"./9722.js";import{closeIosApp as p}from"./apps.js";import{emitDiagnostic as m}from"./432.js";import{asAppError as g,normalizeError as h,AppError as y}from"./733.js";import{evaluateIsPredicate as w,isSupportedPredicate as _,localCommandPolicy as S,createAgentDevice as v}from"./2577.js";import{tryParseSelectorChain as x,extractNodeReadText as k,prefersValueForReadableText as I,findNodeByLabel as N,normalizeType as A,splitIsSelectorArgs as P}from"./9836.js";import{resolveRectCenter as R,isSparseSnapshotQualityVerdict as b,parseWaitPositionals as D}from"./9873.js";import{getAndroidAppState as E}from"./3340.js";import{isApplePlatform as q}from"./5910.js";import{parseFindArgs as C}from"./587.js";import{buildSnapshotPresentationKey as M,snapshotPresentationOptionsFromFlags as O}from"./4291.js";async function $(e,t,r){let s=e.get(t),n=s?.device??await d(r??{});return s||await a(n),{session:s,device:n}}async function L(e,t,r){let s=!e&&"ios"===t.platform;try{return await r()}finally{s&&(await l(t.id),await K(t))}}async function K(e){let t=u();await p(e,t).catch(r=>{m({level:"debug",phase:"ios_sessionless_runner_host_close_failed",data:{deviceId:e.id,bundleId:t,error:r instanceof Error?r.message:String(r)}})})}function U(e,t,r,s){t&&e.recordAction(t,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:s})}function F(e){let{session:t,sessionName:r,device:s,snapshot:n,appBundleId:o}=e;return t?{...t,snapshot:n,lastComparisonSafeSnapshot:n?.comparisonSafe===!0?n:t.lastComparisonSafeSnapshot}:{name:r,device:s,createdAt:Date.now(),appBundleId:o,snapshot:n,...n?.comparisonSafe===!0?{lastComparisonSafeSnapshot:n}:{},actions:[]}}function T(e,t={}){return{artifacts:function(e,t={}){let r=!0===t.plural?"do":"does";return{resolveInput:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not resolve input artifacts`)},reserveOutput:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not reserve output artifacts`)},createTempFile:async()=>{throw new y("UNSUPPORTED_OPERATION",`${e} ${r} not create temporary files`)}}}(e,t),policy:S()}}async function G(e){let{device:t,node:r,flags:n,appBundleId:o,traceOutPath:i,surface:a,contextFromFlags:l}=e,u=k(r),c=R(r.rect);if(!c||"ios"===t.platform&&u&&!I(r.type??""))return u;try{let e=await s(t,"read",[String(c.x),String(c.y)],void 0,{...l(n,o,i),surface:a}),d=e&&"object"==typeof e?e:void 0,f="string"==typeof d?.text?d.text:"";if(f.trim())return f;return m({level:"warn",phase:"interaction_read_fallback",data:{reason:"empty_backend_text",nodeRef:r.ref,surface:a,platform:t.platform}}),u}catch(e){return m({level:"warn",phase:"interaction_read_fallback",data:{reason:"backend_read_failed",nodeRef:r.ref,surface:a,platform:t.platform,error:e instanceof Error?e.message:String(e)}}),u}}let V=[["snapshotDepth","--depth"],["snapshotScope","--scope"],["snapshotRaw","--raw"]];function B(e,t){let r=function(e){if(!e)return[];let t=[];for(let[r,s]of V)void 0!==e[r]&&t.push(s);return t}(t);return 0===r.length?null:i("INVALID_ARGS",`${e} @ref does not support ${r.join(", ")}.`)}async function X(e,t){let r=await H(e);if(r)throw new y("COMMAND_FAILED",`press ${t} left ${e.appBundleId} and foregrounded ${r.foregroundPackage}. The tap likely escaped the app.`,r)}async function H(e){var t;if("android"!==e.device.platform||!e.appBundleId)return null;let r=await E(e.device),s=r.package?.trim();return s&&s!==e.appBundleId&&("com.android.settings"===(t=s)||"com.android.systemui"===t||"com.google.android.permissioncontroller"===t||t.includes("launcher"))?{expectedPackage:e.appBundleId,foregroundPackage:s,activity:r.activity,hint:"com.google.android.permissioncontroller"===s?"Dismiss or allow the permission prompt, then retry the smoke assertion.":"Use screenshot as visual truth, then take a fresh snapshot -i before retrying."}:null}function j(e){return"COMMAND_FAILED"===e.code&&"string"==typeof e.details?.expectedPackage&&"string"==typeof e.details?.foregroundPackage}function W(e,t){let r=Array.isArray(e.selectorChain)?e.selectorChain:void 0,s=Y(e),n=s?.kind==="ref"?Z(s.ref):void 0,o=s?.kind==="selector"?s.selector:void 0,i={...n?{ref:n}:{},...o?{selector:o}:{},...r?{selectorChain:r}:{}};if("attrs"===t)return i;let a="string"==typeof e.text?e.text:"";return{...i,text:a,refLabel:function(e){let t=e.trim();if(!(!t||t.length>80||/[\r\n]/.test(t)))return t}(a)}}function z(e){let t=Y(e);return{...t?.kind==="ref"?{ref:Z(t.ref)}:{},...t?.kind==="selector"?{selector:t.selector}:{},..."string"==typeof e.text?{text:e.text}:{},...e.node&&"object"==typeof e.node?{node:e.node}:{}}}function Q(e){let{selectorChain:t,...r}=e;return r}function J(e,t,r,s){let n=e.get(t);n&&e.recordAction(n,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:s})}function Y(e){let t=e.target;return t&&"object"==typeof t?"ref"===t.kind&&"string"==typeof t.ref?{kind:"ref",ref:t.ref}:"selector"===t.kind&&"string"==typeof t.selector?{kind:"selector",selector:t.selector}:void 0:void 0}function Z(e){return e.startsWith("@")?e.slice(1):e}let ee=["application","window","tabbar","scrollbar","image"],et=new Set(["tab bar"]);async function er(e,t){var r;if(t.ok||(r=t.error.message,!/^wait timed out for (?:selector|text): /i.test(r)))return t;let s=await es(e).catch(()=>null);return s?i(t.error.code,`${t.error.message}. Current surface: ${s.summary}.`,{...t.error.details??{},currentSurface:s.details}):t}async function es(e){let t=[...(await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!0},logPath:e.logPath??""})).snapshot.nodes].sort(eo),s=en(t,6,{includeIdentifiers:!0});if(0===s.length)return null;let n=en(t.filter(e=>!el(e)),4,{includeIdentifiers:!1}),o=en(t.filter(eu),4,{includeIdentifiers:!0});return{summary:(n.length>0?n:s.slice(0,4)).join(", "),details:{labels:s,...o.length>0?{buttons:o}:{}}}}function en(e,t,r){let s=new Set,n=[];for(let o of e){let e=ea(o,r);if(!(!e||s.has(e))&&(s.add(e),n.push(e),n.length>=t))break}return n}function eo(e,t){var r,s;return ei(e)-ei(t)||(r=e,s=t,r.rect&&s.rect?r.rect.y-s.rect.y||r.rect.x-s.rect.x:r.rect?-1:s.rect?1:(r.depth??0)-(s.depth??0)||r.index-s.index)}function ei(e){let t=!!ea(e,{includeIdentifiers:!1});return 2*!!el(e)+ +!t}function ea(e,t){let r=(t.includeIdentifiers?[e.label,e.value,e.identifier]:[e.label,e.value]).map(e=>"string"==typeof e?e.trim():"").find(e=>e.length>0);return r?r.replace(/\s+/g," ").slice(0,80):""}function el(e){let t=A(`${e.type??""} ${e.role??""} ${e.subrole??""}`),r=`${e.label??""} ${e.value??""}`.trim().toLowerCase();return ee.some(e=>t.includes(e))||et.has(r)||r.endsWith(".fill")}function eu(e){return A(`${e.type??""} ${e.role??""} ${e.subrole??""}`).includes("button")}function ec(e){var t;let{session:r,selectorExpression:s}=e;if(!r||"ios"!==r.device.platform||r.postGestureStabilization)return null;let n=x(s);if(!n||1!==n.selectors.length)return null;let o=n.selectors[0];if(!o||1!==o.terms.length)return null;let i=o.terms[0];return i&&"string"==typeof i.value&&("id"===(t=i.key)||"label"===t||"text"===t||"value"===t)?{key:i.key,value:i.value,raw:o.raw}:null}function ed(e,t={}){let r=g(e);if("ELEMENT_NOT_FOUND"===r.code)return!0===t.allowElementNotFound;if("COMMAND_FAILED"!==r.code)return!1;let s=r.message.toLowerCase();return s.includes("fetch failed")||s.includes("timed out")||s.includes("timeout")||s.includes("runner did not accept connection")||s.includes("invalid runner response")}async function ef(e){var t;let{req:r}=e;if("find"!==r.command)return null;let s=r.positionals??[];if(0===s.length)return i("INVALID_ARGS","find requires a locator or text");let n=C(s);if(!n.query)return i("INVALID_ARGS","find requires a value");if(r.flags?.findFirst&&r.flags?.findLast)return i("INVALID_ARGS","find accepts only one of --first or --last");let o=n.action;if("exists"!==(t=o)&&"wait"!==t&&"get_text"!==t&&"get_attrs"!==t)return null;let a=await eI(e,{requireSession:!1,capability:"find"});return a.ok?await eP(async()=>{let t=await a.runtime.selectors.find({session:e.sessionName,requestId:r.meta?.requestId,locator:n.locator,query:n.query,action:o,timeoutMs:n.timeoutMs});return J(e.sessionStore,e.sessionName,r,function(e,t){if("exists"===t)return{found:!0};if("wait"===t)return{found:!0,waitedMs:e.waitedMs};let r="string"==typeof e.ref?e.ref:void 0;return"get_attrs"===t?{ref:r,action:"get attrs"}:{ref:r,action:"get text",text:"string"==typeof e.text?e.text:""}}(t,o)),"found"===t.kind?{found:!0,..."number"==typeof t.waitedMs?{waitedMs:t.waitedMs}:{}}:{..."string"==typeof t.ref?{ref:t.ref}:{},..."string"==typeof t.text?{text:t.text}:{},...t.node&&"object"==typeof t.node?{node:t.node}:{}}}):a.response}async function ep(e){let{req:t}=e;if("get"!==t.command)return null;let r=t.positionals?.[0];if("text"!==r&&"attrs"!==r)return i("INVALID_ARGS","get only supports text or attrs");let s=function(e){let t=e.positionals?.[1]??"";if(t.startsWith("@"))return{ok:!0,target:{kind:"ref",ref:t,fallbackLabel:e.positionals.length>2?e.positionals.slice(2).join(" ").trim():""}};let r=e.positionals?.slice(1).join(" ").trim()??"";return r?{ok:!0,target:{kind:"selector",selector:r}}:{ok:!1,response:i("INVALID_ARGS","get requires @ref or selector expression")}}(t);if(!s.ok)return s.response;if("ref"===s.target.kind){let e=B("get",t.flags);if(e)return e}if("selector"===s.target.kind){let t=await eh(e,r,s.target.selector);if(t)return t}let n=await eI(e,{requireSession:!0,capability:"get"});return n.ok?await eP(async()=>{let o=await n.runtime.selectors.get({session:e.sessionName,requestId:t.meta?.requestId,property:r,target:s.target});return J(e.sessionStore,e.sessionName,t,W(o,r)),z(o)}):n.response}async function em(e){let{req:t}=e;if("is"!==t.command)return null;let r=(t.positionals?.[0]??"").toLowerCase();if(!_(r))return i("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");let{split:s}=P(t.positionals??[]);if(!s)return i("INVALID_ARGS","is requires a selector expression");let n=s.rest.join(" ").trim();if("text"===r&&!n)return i("INVALID_ARGS","is text requires expected text value");if("text"!==r&&s.rest.length>0)return i("INVALID_ARGS",`is ${r} does not accept trailing values`);let o=await ey(e,r,s.selectorExpression,n);if(o)return o;let a=await eI(e,{requireSession:!0,capability:"is"});if(!a.ok)return a.response;let l=await eP(async()=>{let o=await a.runtime.selectors.is({session:e.sessionName,requestId:t.meta?.requestId,predicate:r,selector:s.selectorExpression,expectedText:n});return J(e.sessionStore,e.sessionName,t,o),Q(o)});return await eR(e,l,`is ${r}`)}async function eg(e){let{req:t,sessionName:r,sessionStore:s}=e,n=D(t.positionals??[]);if(!n)return i("INVALID_ARGS","wait requires a duration or text");let{session:a,device:l}=await $(s,r,t.flags);if("sleep"!==n.kind&&!o("wait",l))return i("UNSUPPORTED_OPERATION","wait is not supported on this device");if("selector"===n.kind){let t=await ew({...e,session:a,device:l,selectorExpression:n.selectorExpression,timeoutMs:n.timeoutMs});if(t)return t}let u=async()=>{let o=ek({...e,session:a,device:l}),i=await eP(async()=>{let e=await o.selectors.wait({session:r,requestId:t.meta?.requestId,target:function(e,t){if("sleep"===e.kind)return{kind:"sleep",durationMs:e.durationMs};if("selector"===e.kind)return{kind:"selector",selector:e.selectorExpression,timeoutMs:e.timeoutMs};if("ref"===e.kind){if(!t?.snapshot)throw new y("INVALID_ARGS","Ref wait requires an existing snapshot in session.");return{kind:"ref",ref:e.rawRef,timeoutMs:e.timeoutMs}}if(!e.text)throw new y("INVALID_ARGS","wait requires text");return{kind:"text",text:e.text,timeoutMs:e.timeoutMs}}(n,a)});return J(s,r,t,e),{waitedMs:e.waitedMs,..."string"==typeof e.text?{text:e.text}:{},..."string"==typeof e.selector?{selector:e.selector}:{}}}),u=await er({req:t,logPath:e.logPath,session:a,device:l},i);return await eR(e,u,"wait")};return"sleep"===n.kind?await u():await L(a,l,u)}async function eh(e,t,r){let s=e.sessionStore.get(e.sessionName),n=ec({session:s,selectorExpression:r});if(!s||!n||"text"===t&&"id"!==n.key)return null;let o=await ev(e,s,n);if(ex(o))return o.response;if(!o)return null;let i=function(e,t,r){if(!r.found||!r.node)return null;let s={target:{kind:"selector",selector:t},node:r.node,selectorChain:[t]};return"attrs"===e?{kind:"attrs",...s}:"string"!=typeof r.text?null:{kind:"text",...s,text:r.text}}(t,n.raw,o);return i?(J(e.sessionStore,e.sessionName,e.req,W(i,t)),{ok:!0,data:z(i)}):null}async function ey(e,t,r,s){var n,o,i,a,l;let u;if("hidden"===t)return null;let c=await e_(e,r);if(ex(c))return c.response;if(!c?.result.found||!c.result.node)return null;let d="exists"===t?{predicate:t,pass:!0,selector:c.selector.raw,matches:1,selectorChain:[c.selector.raw]}:(n=t,o=s,i=c.selector.raw,a=c.session,u=w({predicate:n,node:l=c.result.node,nodes:[l],expectedText:o,platform:a.device.platform}),{predicate:n,pass:u.pass,selector:i,..."text"===n?{text:u.actualText}:{},selectorChain:[i]});return d?(J(e.sessionStore,e.sessionName,e.req,d),{ok:!0,data:Q(d)}):null}async function ew(e){let t=ec({session:e.session,selectorExpression:e.selectorExpression});if(!e.session||!t)return null;let r=Date.now(),s=await ev(e,e.session,t);if(ex(s))return s.response;if(!s?.found)return null;let n={kind:"selector",selector:t.raw,waitedMs:Date.now()-r,selectorChain:[t.raw]};return J(e.sessionStore,e.sessionName,e.req,n),await er({req:e.req,logPath:e.logPath,session:e.session,device:e.device},{ok:!0,data:n})}async function e_(e,t){let r=e.sessionStore.get(e.sessionName),s=ec({session:r,selectorExpression:t});if(!r||!s)return null;let n=await ev(e,r,s);return ex(n)?n:n?{session:r,selector:s,result:n}:null}async function eS(e,t,r){let s=await n(t.device,{command:"querySelector",selectorKey:r.key,selectorValue:r.value,appBundleId:t.appBundleId},{verbose:!!e.req.flags?.verbose,logPath:e.logPath,traceLogPath:t.trace?.outPath,requestId:e.req.meta?.requestId,iosXctestrunFile:e.req.flags?.iosXctestrunFile,iosXctestDerivedDataPath:e.req.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:e.req.flags?.iosXctestEnvDir}),o=!0===s.found,i=function(e){let t=e.nodes;if(!Array.isArray(t))return;let r=t[0];if(r&&"object"==typeof r)return r}(s);return{found:o,..."string"==typeof s.text?{text:s.text}:{},...i?{node:i}:{}}}async function ev(e,t,r){try{return await eS(e,t,r)}catch(e){if(ed(e,{allowElementNotFound:!0}))return null;return{kind:"error",response:{ok:!1,error:h(e)}}}}function ex(e){return null!==e&&"kind"in e&&"error"===e.kind}function ek(s){return v({backend:function(e){let s,{req:n,session:o,device:i,logPath:a,sessionName:l,sessionStore:u}=e,d=0;return{platform:i.platform,captureSnapshot:async(e,f)=>{var p;let m,g={...n.flags,...(p=f,m={},p?.interactiveOnly!==void 0&&(m.snapshotInteractiveOnly=p.interactiveOnly),p?.scope!==void 0&&(m.snapshotScope=p.scope),p?.depth!==void 0&&(m.snapshotDepth=p.depth),p?.raw!==void 0&&(m.snapshotRaw=p.raw),m)},h=f?.includeRects===!0,y=f?.scope??n.flags?.snapshotScope,w=Date.now(),_=M(O(g)),S="wait"===n.command||"find"===n.command||h&&"web"===i.platform;if(!S&&s&&w-d<750&&!c(o)&&!o?.postGestureStabilization)return s;if(!S&&o?.snapshot&&w-o.snapshot.createdAt<750&&o.snapshot.presentationKey===_&&!c(o)&&!o.postGestureStabilization)return d=o.snapshot.createdAt,s={snapshot:o.snapshot};let v=await r({device:i,session:o,flags:g,outPath:n.flags?.out,logPath:a??"",snapshotScope:y,includeRects:h});return o&&!b(v.snapshot.snapshotQuality)&&(t(o,v.snapshot),u.set(l,o)),d=w,s={snapshot:v.snapshot}},readText:async(t,r)=>({text:await G({device:i,node:r,flags:n.flags,appBundleId:o?.appBundleId,traceOutPath:o?.trace?.outPath,surface:o?.surface,contextFromFlags:e.contextFromFlags??((e,t,r)=>f(a??"",e,t,r))})}),findText:async(t,r)=>({found:await eN(e,r)})}}(s),...T("selector commands",{plural:!0}),sessions:e({sessionName:s.sessionName,getSession:()=>s.session,recordOptions:{includeSnapshot:!0},setRecord:e=>{s.session&&e.snapshot&&(t(s.session,e.snapshot),s.sessionStore.set(s.sessionName,s.session))}})})}async function eI(e,t){let r=e.sessionStore.get(e.sessionName);if(!r&&t.requireSession)return{ok:!1,response:i("SESSION_NOT_FOUND","No active session. Run open first.")};let s=r?.device??await d(e.req.flags??{});return(r||await a(s),o(t.capability,s))?{ok:!0,runtime:ek({...e,session:r,device:s})}:{ok:!1,response:i("UNSUPPORTED_OPERATION",`${t.capability} is not supported on this device`)}}async function eN(e,t){let{device:r,session:s,req:o,logPath:i}=e;if("macos"===r.platform&&s?.surface&&"app"!==s.surface)return!!N((await eA(e)).nodes,t);if(q(r.platform)&&s?.appBundleId){let e=await n(r,{command:"findText",text:t,appBundleId:s?.appBundleId},{verbose:o.flags?.verbose,logPath:i,traceLogPath:s?.trace?.outPath,requestId:o.meta?.requestId,iosXctestrunFile:o.flags?.iosXctestrunFile,iosXctestDerivedDataPath:o.flags?.iosXctestDerivedDataPath,iosXctestEnvDir:o.flags?.iosXctestEnvDir});return e?.found===!0}return!!N((await eA(e)).nodes,t)}async function eA(e){let s=await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!1},outPath:e.req.flags?.out,logPath:e.logPath??""});return e.session&&!b(s.snapshot.snapshotQuality)&&(t(e.session,s.snapshot),e.sessionStore.set(e.sessionName,e.session)),s.snapshot}async function eP(e){try{return{ok:!0,data:await e()}}catch(t){let e=g(t);return i(e.code,e.message,e.details)}}async function eR(e,t,r){var s;let n;if(t.ok)return t;let o=e.sessionStore.get(e.sessionName);if(!o)return t;try{n=await H(o)}catch{return t}return n?i(t.error.code,`${r} failed because ${"com.google.android.permissioncontroller"===(s=n).foregroundPackage?`Android permission dialog is blocking ${s.expectedPackage}`:`${s.foregroundPackage} is foreground instead of ${s.expectedPackage}`}.`,{...t.error.details??{},...n,blockedBy:"android_foreground_surface",originalMessage:t.error.message}):t}export{X as assertAndroidPressStayedInApp,F as buildSnapshotSession,T as createDaemonRuntimePolicy,ef as dispatchFindReadOnlyViaRuntime,ep as dispatchGetViaRuntime,em as dispatchIsViaRuntime,eg as dispatchWaitViaRuntime,j as isAndroidEscapeError,ed as isDirectIosSelectorFallbackError,ec as readSimpleIosSelectorTarget,G as readTextForNode,U as recordIfSession,B as refSnapshotFlagGuardResponse,$ as resolveSessionDevice,L as withSessionlessRunnerCleanup};

package/dist/src/selectors.d.ts

@@ -22,7 +22,7 @@ export declare function parseSelectorChain(expression: string): SelectorChain;
 
 declare type Platform = (typeof PLATFORMS)[number];
 
-declare const PLATFORMS: readonly ['ios', 'macos', 'android', 'linux'];
+declare const PLATFORMS: readonly ['ios', 'macos', 'android', 'linux', 'web'];
 
 declare type RawSnapshotNode = {
     index: number;
@@ -95,7 +95,7 @@ declare type SelectorTerm = {
     value: string | boolean;
 };
 
-declare type SnapshotBackend = 'xctest' | 'android' | 'macos-helper' | 'linux-atspi';
+declare type SnapshotBackend = 'xctest' | 'android' | 'macos-helper' | 'linux-atspi' | 'web';
 
 export declare type SnapshotNode = RawSnapshotNode & {
     ref: string;