agent-device 0.21.23 → 0.21.24

package/dist/src/provider-webdriver.js

@@ -1,2 +1 @@
-import{H as e,P as t}from"./sdk-contracts.js";import{o as n,w as r}from"./sdk-device.js";import{$t as i}from"./sdk-batch.js";import{d as a}from"./scroll-gesture.js";import{c as o,l as s}from"./sdk-remote-config.js";import"./device.js";import{c,l}from"./device-rotation.js";import{l as u}from"./exec.js";import"./command.js";import{a as ee}from"./version.js";import{n as d,r as f,t as p}from"./capabilities.js";import{t as te}from"./webdriver-source.js";import{i as ne,n as m,o as re,r as ie,t as h}from"./providers.js";import ae from"node:fs";import g from"node:path";import oe,{readFile as se,stat as ce}from"node:fs/promises";import{setTimeout as le}from"node:timers/promises";function ue(e,t){let n=e?.bundleId??t?.appIdentifierHint,r=e?.packageName??t?.packageNameHint;return{bundleId:n,packageName:r,appName:e?.appName,launchTarget:fe(e?.launchTarget,n,r)}}function de(e){return e===`ios`?`xctest`:`android`}function fe(...e){return e.find(e=>e!==void 0)}function pe(e){let t=async(t,n,r,i,a)=>{let o=e.findSessionForDevice(t);if(!o)return;let s=await he(e,o,t,n,r.uploadPath,i,a);return await o.client.installApp(s?.appReference??r.appPath,a),ue(s,i)},n=async(e,n,r,i,a)=>await t(e,n,{appPath:r,uploadPath:r},i,a);return Object.freeze({fact:t=>me(e.findSessionForDevice(t)),installApp:n,installInstallablePath:async(e,t,r,i)=>await n(e,``,t,r,i),deployApp:async(e,t,r)=>ge(await n(e,t.app,t.appPath,{relaunch:t.replaceExisting,appIdentifierHint:t.app,packageNameHint:t.app},r),t.app),deployMaterializedApp:async(e,n,r)=>ge(await t(e,``,{appPath:n.artifact.installablePath,uploadPath:n.artifact.uploadPath??n.artifact.installablePath},{appIdentifierHint:n.artifact.bundleId,packageNameHint:n.artifact.packageName},r))})}function me(e){return e?p(e.capabilities,`install`)?Object.freeze({available:!0}):Object.freeze({available:!1,reason:`owner-capability-missing`,hint:f(e.capabilities,`install`)}):Object.freeze({available:!1,reason:`owner-capability-missing`,hint:`The WebDriver provider session is no longer active for this device.`})}async function he(e,n,i,a,o,s,c){if(!p(n.capabilities,`install`))throw new t(`UNSUPPORTED_OPERATION`,f(n.capabilities,`install`),{provider:e.provider,deviceId:i.id,platform:r(i)});let l=n.prepared.uploadApp??e.uploadApp;if(l)return await l({provider:e.provider,lease:n.lease,device:i,app:a,appPath:o,options:s,signal:c})}function ge(e,n){if(!e)throw new t(`UNSUPPORTED_OPERATION`,`The WebDriver provider session no longer supports app deployment.`);return{...e.bundleId?{bundleId:e.bundleId}:{},...e.packageName?{packageName:e.packageName}:{},...e.appName?{appName:e.appName}:{},...e.launchTarget??n?{launchTarget:e.launchTarget??n}:{}}}function _e(e){return{provider:e.provider,providerSessionId:e.providerSessionId,status:e.artifacts.length>0?`ready`:`pending`,cloudArtifacts:e.artifacts,...e.artifacts.length>0?{}:{message:e.pendingMessage}}}function ve(e){return{provider:e.provider,providerSessionId:e.providerSessionId,status:`unavailable`,cloudArtifacts:[],message:e.error instanceof Error?e.error.message:String(e.error)}}function _(e,t,n,r,i,a){let o=n[r],s=typeof o==`string`?o.trim():``;if(s.length!==0)return{provider:e,providerSessionId:t,kind:i,name:a,url:s,availability:`ready`}}function v(e){return{"x-agent-device-client":`agent-device-cli`,"x-agent-device-version":e}}async function ye(n,r){try{await r()}catch(r){n instanceof t&&(n.details={...n.details,cleanupError:e(r)})}}function be(e,t){return typeof e==`function`?e(t):e}function y(e){return`Basic ${Buffer.from(`${e.username}:${e.accessKey}`).toString(`base64`)}`}function xe(e){let t=0;for(;t<e.length&&e.charCodeAt(t)===47;)t+=1;return t===0?e:e.slice(t)}function Se(e){let t=e.length-1;for(;t>=0&&e.charCodeAt(t)===47;)--t;return t===e.length-1?e:e.slice(0,t+1)}function Ce(e,t){let n=new URL(e);return n.pathname=`${Se(n.pathname)}/${t}`,n}function we(e){if(e.pathname.endsWith(`/`))return e;let t=new URL(e);return t.pathname=`${t.pathname}/`,t}async function Te(e,n,r){if(!(await ce(e).catch(()=>void 0))?.isFile())throw new t(`INVALID_ARGS`,`${r.service} can only upload a regular app file: ${e}`,{provider:r.provider,appPath:e,hint:`Use an existing .ipa, .apk, or .aab file, or a .zip of the iOS simulator .app bundle.`});let i=new FormData;return i.set(n,new Blob([await se(e)]),g.basename(e)),i}async function Ee(e,n,r){let i=await fetch(n.endpoint,{method:`POST`,headers:{...v(n.clientVersion),Authorization:y(n.auth)},body:e,signal:r}),a=await x(i),o=n.readAppReference(a)?.trim();if(!i.ok||!o)throw new t(`COMMAND_FAILED`,`${n.service} app upload failed.`,{status:i.status,response:a});return o}function De(e){return async({appPath:t,options:n,signal:r})=>({appReference:await e(t,r),bundleId:n?.appIdentifierHint,packageName:n?.packageNameHint,launchTarget:n?.appIdentifierHint??n?.packageNameHint})}async function Oe(e){let{app:n}=e,r=e.parseReference(n);if(r!==void 0)return r;if(/^https?:\/\//i.test(n))return n;let i=g.resolve(e.cwd??process.cwd(),n);if(!ae.existsSync(i))throw new t(`INVALID_ARGS`,`${e.service} --provider-app must be ${e.referenceLabel}, URL, or existing local app path.`,{providerApp:n});return await e.uploadFile(i,e.signal)}const b=15e3;async function ke(e,n){let{service:r,unauthorizedHint:i,networkHint:a}=n.hints,o=`Retry connect or check the ${r} service status.`;try{let a=await fetch(e,{headers:{...v(n.clientVersion),Authorization:y(n.auth)},signal:AbortSignal.timeout(b)});if(!a.ok){let e=a.status===401||a.status===403;throw new t(e?`UNAUTHORIZED`:`COMMAND_FAILED`,`${r} rejected connection verification.`,{status:a.status,hint:e?i:o})}let s=await x(a);if(s===void 0)throw new t(`COMMAND_FAILED`,`${r} connection verification answer was not JSON.`,{status:a.status,hint:o});return s}catch(e){throw e instanceof t?e:new t(`COMMAND_FAILED`,`${r} connection verification failed.`,{hint:a},e)}}async function Ae(e,n){let r,i;try{r=await fetch(e,{headers:{...v(n.clientVersion),Authorization:y(n.auth)},signal:AbortSignal.timeout(b)}),i=await x(r)}catch(e){throw new t(`COMMAND_FAILED`,`${n.service} session details lookup failed.`,{hint:`Check network access to the ${n.service} API, then retry.`},e)}let a=i&&typeof i==`object`&&!Array.isArray(i)?i:void 0;if(!r.ok||!a)throw new t(`COMMAND_FAILED`,`${n.service} session details lookup failed.`,{status:r.status,response:i});return a}async function x(e){let t=await e.text();if(t.length!==0)try{return JSON.parse(t)}catch{return}}function je(e,t){let n=e=>e.replace(/(?:\.0)+$/,``);return n(e)===n(t)}function Me(e,n){let r=o.find(e=>e===n);if(r)return r;throw new t(`INVALID_ARGS`,`Invalid ${e.flag} value: ${n}.`,{hint:`Use ${o.join(`|`)}.`,flag:e.flag,capability:e.capability})}const S=`webdriver_request_timeout`;function C(e){return e instanceof t&&e.details?.reason===S}function w(e){return{dispatched:e}}const T=`webdriver_connect_refused`,E=`webdriver_request_interrupted`,Ne=new Set([`ECONNREFUSED`,`ENOTFOUND`,`EAI_AGAIN`,`EHOSTUNREACH`,`ENETUNREACH`,`UND_ERR_CONNECT_TIMEOUT`]);function Pe(e){return e instanceof t&&e.details?.reason===T}const Fe=new Set([`GET`,`HEAD`]),Ie=Object.freeze({});var Le=class{endpoint;headers;requestPolicy;constructor(e){this.endpoint=we(new URL(e.endpoint)),this.headers={...v(e.clientVersion),...e.auth?{Authorization:y(e.auth)}:{},...e.headers},this.requestPolicy={timeoutMs:e.requestPolicy?.timeoutMs??3e4,retryAttempts:e.requestPolicy?.retryAttempts??1,retryDelayMs:e.requestPolicy?.retryDelayMs??250}}async requestValue(e,t,n,r){return(await this.request(e,t,n,r)).value}async request(e,t,n,r){let i=r?.idempotent??Fe.has(e);return await this.requestWithRetries(e,t,n,{retryAttempts:r?.retryAttempts??(i?this.requestPolicy.retryAttempts:0),timeoutMs:r?.timeoutMs??this.requestPolicy.timeoutMs,signal:r?.signal})}async requestWithRetries(e,t,n,r){let i;for(let a=0;a<=r.retryAttempts;a+=1)try{return await this.requestOnce(e,t,n,r.timeoutMs,r.signal)}catch(e){if(i=e,!ze(e,a,r.retryAttempts,r.signal))throw e;await le(this.requestPolicy.retryDelayMs,void 0,{signal:r.signal})}throw i}async requestOnce(e,t,n,r,i){let{ok:a,status:o,text:s}=await this.fetchWebDriver(e,t,n,r,i),c=s?Ve(s):{};if(a)return{status:o,value:Be(c)};let l=He(o,c);throw N(l)&&M(k,{method:e,path:t,status:o,code:j(c)??null}),l}async fetchWebDriver(e,t,n,r,i){let a=new URL(xe(t),this.endpoint),o=n===void 0&&e===`POST`?Ie:n,s=AbortSignal.timeout(r),c=i?AbortSignal.any([i,s]):s,l={method:e,path:t,timeoutMs:r,timeoutSignal:s,requestSignal:i},u;try{u=await fetch(a,{method:e,headers:{Accept:`application/json`,...o===void 0?{}:{"Content-Type":`application/json`},...this.headers},body:o===void 0?void 0:JSON.stringify(o),signal:c})}catch(e){throw D(e,l,`request`)}try{return{ok:u.ok,status:u.status,text:await u.text()}}catch(e){throw D(e,l,`response`)}}};function D(e,t,n){let{method:r,path:i,timeoutMs:a,timeoutSignal:o,requestSignal:s}=t;return s?.aborted?e:o.aborted?Ke(r,i,a,e):n===`request`&&Re(e)?qe(r,i,e):n===`response`||e instanceof TypeError?Je(r,i,e):e}function Re(e){let t=O(e,0);return t.length>0&&t.every(e=>Ne.has(e))}function O(e,t){if(t>4||!e||typeof e!=`object`)return[];let{code:n,cause:r}=e,i=e instanceof AggregateError?e.errors:[];return[...typeof n==`string`?[n]:[],...O(r,t+1),...i.flatMap(e=>O(e,t+1))]}function ze(e,t,n,r){return!r?.aborted&&Ye(e)&&t<n}function Be(e){if(!e||typeof e!=`object`)return e;let t=e;return`value`in t?t.value:e}function Ve(e){try{return JSON.parse(e)}catch(n){throw new t(`COMMAND_FAILED`,`WebDriver response was not valid JSON.`,{text:e},n)}}function He(e,n){let r=n&&typeof n==`object`&&`value`in n?n.value:n,i=r&&typeof r==`object`&&typeof r.message==`string`?r.message:`WebDriver request failed with HTTP ${e}.`;return Ge(e,n)?new t(`COMMAND_FAILED`,i,{...A(),status:e,response:n}):new t(`COMMAND_FAILED`,i,{status:e,response:n,...e>=500?w(`unknown`):{}})}const k=`webdriver_route_unsupported`;function A(){return{reason:k,...w(`no`)}}const Ue=new Set([`unknown command`,`unknown method`]),We=new Set([404,405,501]);function Ge(e,t){let n=j(t);return n===void 0?We.has(e):Ue.has(n.toLowerCase())}function j(e){let t=e&&typeof e==`object`&&`value`in e?e.value:void 0,n=t&&typeof t==`object`?t.error:void 0;return typeof n==`string`?n:void 0}function M(e,t){import(`./diagnostics2.js`).then(e=>e.t).then(({emitDiagnostic:n})=>n({level:`debug`,phase:e,data:t})).catch(()=>void 0)}function N(e){return e instanceof t&&e.details?.reason===k}function Ke(e,n,r,i){return new t(`COMMAND_FAILED`,`WebDriver ${e} ${n} timed out after ${r}ms.`,{reason:S,method:e,path:n,timeoutMs:r,...w(`unknown`)},i instanceof Error?i:void 0)}function qe(e,n,r){return new t(`COMMAND_FAILED`,`WebDriver ${e} ${n} could not reach the driver.`,{reason:T,method:e,path:n,...w(`no`)},r instanceof Error?r:void 0)}function Je(e,n,r){return new t(`COMMAND_FAILED`,`WebDriver ${e} ${n} lost its connection to the driver.`,{reason:E,method:e,path:n,...w(`unknown`)},r instanceof Error?r:void 0)}function Ye(e){if(C(e)||Pe(e)||e instanceof t&&e.details?.reason===E)return!0;if(e instanceof t){let t=e.details?.status;return typeof t==`number`&&t>=500}return!1}var Xe=class{transport;sessionCreateTimeoutMs;sessionId;constructor(e){this.transport=new Le(e),this.sessionCreateTimeoutMs=e.requestPolicy?.sessionCreateTimeoutMs??18e4}async createSession(e,t){let n=Qe(await this.requestValue(`POST`,`/session`,{capabilities:Ze(e)},{timeoutMs:et(this.sessionCreateTimeoutMs,t?.deadline)}));return this.sessionId=n.sessionId,n}async deleteSession(){let e=this.requireSessionId();await this.requestValue(`DELETE`,`/session/${e}`),this.sessionId=void 0}async installApp(e,t){await this.sessionRequest(`POST`,`/appium/device/install_app`,{appPath:e},{signal:t})}async activateApp(e){await this.appRouteWithSibling(`/appium/device/activate_app`,`mobile: activateApp`,e)}async terminateApp(e){await this.appRouteWithSibling(`/appium/device/terminate_app`,`mobile: terminateApp`,e)}async appRouteWithSibling(e,t,n){try{await this.sessionRequest(`POST`,e,{appId:n})}catch(r){if(!N(r))throw r;let{status:i}=await this.transport.request(`POST`,`/session/${this.requireSessionId()}/execute/sync`,{script:t,args:[{appId:n,bundleId:n}]});M(`webdriver_route_fallback`,{from:e,to:t,status:i})}}async performActions(e){await this.sessionRequest(`POST`,`/actions`,{actions:e})}async releaseActions(){await this.sessionRequest(`DELETE`,`/actions`)}async sendKeys(e){await this.sessionRequest(`POST`,`/keys`,{value:Array.from(e)})}async hideKeyboard(){await this.sessionRequest(`POST`,`/appium/device/hide_keyboard`)}async isKeyboardShown(e){let t;try{t=await this.sessionRequest(`GET`,`/appium/device/is_keyboard_shown`,void 0,{retryAttempts:0,...e===void 0?{}:{timeoutMs:e}})}catch(e){if(N(e))return`unsupported`;throw e}return typeof t==`boolean`?t:`unsupported`}async activeElement(e){let t=e===void 0?void 0:Date.now()+e,n;try{n=$e(await this.sessionRequest(`GET`,`/element/active`,void 0,I(t)))}catch(e){if(N(e))return`unsupported`;if(R(e))return`none`;throw e}if(n===void 0)return`unsupported`;try{let e=await this.sessionRequest(`GET`,`/element/${encodeURIComponent(n)}/rect`,void 0,I(t));return{id:n,rect:P(e)}}catch(e){if(N(e))return`unsupported`;if(R(e))return`none`;throw e}}async back(){await this.sessionRequest(`POST`,`/back`)}async setRotation(e){await this.sessionRequest(`POST`,`/rotation`,{x:0,y:0,z:e})}async setOrientation(e){await this.sessionRequest(`POST`,`/orientation`,{orientation:e})}async source(e){let n=await this.sessionRequest(`GET`,`/source`,void 0,e);if(typeof n!=`string`)throw new t(`COMMAND_FAILED`,`WebDriver source response was not a string`,{valueType:typeof n});return n}async screenshot(e){let n=await this.sessionRequest(`GET`,`/screenshot`);if(typeof n!=`string`)throw new t(`COMMAND_FAILED`,`WebDriver screenshot response was not base64 text`,{valueType:typeof n});await oe.writeFile(e,Buffer.from(n,`base64`))}async windowRect(){return P(await this.sessionRequest(`GET`,`/window/rect`))}async executeScript(e,t=[]){return await this.sessionRequest(`POST`,`/execute/sync`,{script:e,args:t})}async executeReadScript(e,t=[]){return await this.sessionRequest(`POST`,`/execute/sync`,{script:e,args:t},{idempotent:!0})}async sessionRequest(e,t,n,r){let i=this.requireSessionId();return await this.requestValue(e,`/session/${i}${t}`,n,r)}requireSessionId(){if(!this.sessionId)throw new t(`SESSION_NOT_FOUND`,`WebDriver session has not been created yet.`);return this.sessionId}async requestValue(e,t,n,r){return await this.transport.requestValue(e,t,n,r)}};function P(e){if(!e||typeof e!=`object`)throw new t(`COMMAND_FAILED`,`WebDriver window rect response was empty.`);let n=e,r={x:F(n,`x`),y:F(n,`y`),width:F(n,`width`),height:F(n,`height`)};if(r.x===void 0||r.y===void 0||r.width===void 0||r.height===void 0)throw new t(`COMMAND_FAILED`,`WebDriver window rect response was invalid.`,{response:n});return r}function F(e,t){let n=e[t];return typeof n==`number`&&Number.isFinite(n)?n:void 0}function Ze(e){return`alwaysMatch`in e||`firstMatch`in e?e:{alwaysMatch:e}}function Qe(e){if(!e||typeof e!=`object`)throw new t(`COMMAND_FAILED`,`WebDriver create-session response was empty.`);let n=e,r=typeof n.sessionId==`string`?n.sessionId:typeof n.session_id==`string`?n.session_id:void 0;if(!r)throw new t(`COMMAND_FAILED`,`WebDriver create-session response missed sessionId.`,{response:n});return{sessionId:r,capabilities:n.capabilities&&typeof n.capabilities==`object`?n.capabilities:{}}}function $e(e){if(!e||typeof e!=`object`)return;let t=e,n=t[`element-6066-11e4-a52e-4f735466cecf`]??t.ELEMENT;return typeof n==`string`&&n.length>0?n:void 0}function I(e){return e===void 0?{retryAttempts:0}:{retryAttempts:0,timeoutMs:L(e)}}function et(e,t){return t===void 0?e:Math.min(e,L(t))}function L(e){return Math.max(0,e-Date.now())}function R(e){return e instanceof t&&tt(e).toLowerCase()===`no such element`}function tt(e){let t=e.details?.response,n=t&&typeof t==`object`?t.value:void 0,r=n&&typeof n==`object`?n.error:void 0;return typeof r==`string`?r:``}function z(e,t){return{type:`pointer`,id:e,parameters:{pointerType:`touch`},actions:t}}async function nt(e){return it(te(e,`android`).nodes)}function rt(e){return it(te(e).nodes)}function it(e){let t=e.flatMap(e=>at(e)&&ot(e.rect)?[e.rect]:[]).sort((e,t)=>t.width*t.height-e.width*e.height)[0];return t?{x:t.x,y:t.y,width:t.width,height:t.height}:void 0}function at(e){let t=e.type?.toLowerCase()??``;return e.visibleToUser!==!1&&(t.includes(`scrollview`)||t.includes(`listview`)||t.includes(`recyclerview`))}function ot(e){return!!e&&e.width>=50&&e.height>=50}async function st(e,n,r){let i=[];for(let t of n===`android`?[`rotation`,`orientation`]:[`orientation`,`rotation`])try{await ct(e,t,r);return}catch(e){if(!N(e))throw e;i.push({transport:t,error:e instanceof Error?e.message:String(e)})}throw new t(`COMMAND_FAILED`,`Could not set device orientation to ${r} on the hosted WebDriver session.`,{...A(),hint:`The provider driver rejected both orientation endpoints. Set the orientation as a session capability instead, for example connect --provider-device-orientation portrait.`,rotation:r,attempts:i})}async function ct(e,t,n){if(t===`rotation`){await e.setRotation(l(n));return}await e.setOrientation(c(n))}const B=1500;function lt(e){return new Promise(t=>setTimeout(t,e))}function V(e,n,r){return new t(`COMMAND_FAILED`,`fill tapped (${e}, ${n}) but ${r}`,{reason:`text_entry_focus_not_observed`,x:e,y:n,hint:`The tap most likely missed the field. Re-check the target with snapshot -i and fill the element it reports, rather than retrying the same coordinates.`})}function ut(e,n){return new t(`COMMAND_FAILED`,`fill tapped (${e}, ${n}) but this driver reports neither the focused element nor keyboard state, so the text was not sent`,{reason:`text_entry_focus_unobservable`,x:e,y:n,hint:`This provider cannot confirm a field took focus. Use press <target> followed by type <text> to enter it anyway, accepting that nothing witnesses which field receives the keys.`})}function dt(e,t,n){return t>=e.x&&t<=e.x+e.width&&n>=e.y&&n<=e.y+e.height}function ft(e){return new pt(e.client,e.backend,e.capabilities,e.targetId)}var pt=class{client;backend;capabilities;targetId;constructor(e,t,n,r){this.client=e,this.backend=t,this.capabilities=n,this.targetId=r}async open(e,t){if(t?.url){await this.client.executeScript(`mobile: deepLink`,[{url:t.url,package:e}]);return}let n=t?.appBundleId??e;n&&await this.client.activateApp(n)}async openDevice(){await this.client.executeScript(`mobile: activateApp`,[{}])}async close(e){e&&await this.client.terminateApp(e)}async tap(e,t){return this.requireSupport(`tap`),await this.pointerGesture(`tap`,[{type:`pointerMove`,duration:0,x:e,y:t},{type:`pointerDown`,button:0},{type:`pointerUp`,button:0}]),{backend:`webdriver`,x:e,y:t}}async doubleTap(e,t){return this.requireSupport(`doubleTap`),await this.pointerGesture(`doubleTap`,[{type:`pointerMove`,duration:0,x:e,y:t},{type:`pointerDown`,button:0},{type:`pointerUp`,button:0},{type:`pause`,duration:80},{type:`pointerDown`,button:0},{type:`pointerUp`,button:0}]),{backend:`webdriver`,x:e,y:t}}async swipe(e,t,n,r,i=400){return this.requireSupport(`swipe`),await this.pointerGesture(`swipe`,[{type:`pointerMove`,duration:0,x:e,y:t},{type:`pointerDown`,button:0},{type:`pointerMove`,duration:i,x:n,y:r},{type:`pointerUp`,button:0}]),{backend:`webdriver`,x1:e,y1:t,x2:n,y2:r,durationMs:i}}async longPress(e,t,n=600){return this.requireSupport(`longPress`),await this.pointerGesture(`longPress`,[{type:`pointerMove`,duration:0,x:e,y:t},{type:`pointerDown`,button:0},{type:`pause`,duration:n},{type:`pointerUp`,button:0}]),{backend:`webdriver`,x:e,y:t,durationMs:n}}async focus(e,t){return await this.tap(e,t)}async type(e){this.requireSupport(`type`),await this.client.sendKeys(e)}async fill(e,n,r,i){if(this.requireSupport(`fill`),r.length===0)throw new t(`UNSUPPORTED_OPERATION`,`fill with empty text (clear field) is not supported on the webdriver backend`,{hint:`Use a visible clear/reset control in the app, or fill the field with the intended replacement text directly.`});let a=await this.readTextEntryState();await this.tap(e,n);let o=await this.awaitTextEntryReadiness(a,e,n);return await this.type(r),{backend:`webdriver`,x:e,y:n,text:r,textEntryReadiness:o}}async scroll(e,t){this.requireSupport(`scroll`);let n=t?.durationMs??350;await this.client.hideKeyboard().catch(()=>void 0);let r=await this.scrollGestureFrame(),i=a({direction:e,amount:t?.amount,pixels:t?.pixels,referenceWidth:r.width,referenceHeight:r.height}),o={...i,x1:i.x1+r.x,y1:i.y1+r.y,x2:i.x2+r.x,y2:i.y2+r.y};return await this.swipe(o.x1,o.y1,o.x2,o.y2,n),{backend:`webdriver`,...o,distance:i.pixels,durationMs:n}}async gestureViewport(){return await this.scrollGestureFrame()}async performGesture(e){return this.requireSupport(ht(e)),await this.client.performActions(e.pointers.map(e=>z(`gesture-pointer-${e.pointerId}`,mt(e.samples)))),await this.client.releaseActions().catch(()=>void 0),{backend:`webdriver-w3c-actions`}}async screenshot(e,t){this.requireSupport(`screenshot`),await this.client.screenshot(e)}async snapshot(e){return this.requireSupport(`snapshot`),await this.captureSource(e?.signal)}async captureSource(e){let t=await this.readSource(e);if(this.backend===`xctest`){let{acquireWebDriverIosSnapshot:e}=await import(`./webdriver-ios-snapshot.js`);return e(t,this.targetId)}let{parseWebDriverSourceFacts:n}=await import(`./webdriver-source.js`).then(e=>e.n);return{backend:`android`,producer:`appium-source`,nodes:n(t,`android`).nodes}}async readSource(e){try{return await this.client.source(e===void 0?{}:{signal:e})}catch(e){throw C(e)?gt(e):e}}async back(e){this.requireSupport(`back`),await this.client.back()}async home(){this.requireSupport(`home`),await this.client.executeScript(`mobile: pressButton`,[{name:`home`}])}async setOrientation(e){this.requireSupport(`orientation`),await st(this.client,this.backend,e)}async appSwitcher(){this.requireSupport(`appSwitcher`),await this.client.executeScript(`mobile: pressButton`,[{name:`appSwitch`}])}async tvRemote(e,t){this.unsupported(`tvRemote`)}async keyboardStatus(){return this.requireSupport(`keyboard`),{kind:`ime-probe`,visible:await this.keyboardVisible()}}async keyboardDismiss(){this.requireSupport(`keyboard`);let e=await this.keyboardVisibility();if(e===!1)return this.dismissResult({wasVisible:e,visible:!1,dismissed:!1});await this.client.hideKeyboard();let t=await this.keyboardVisibilityAfterMutation();return this.dismissResult({...e===void 0?{}:{wasVisible:e},...t===void 0?{}:{visible:t,dismissed:e===!0&&!t}})}dismissResult(e){return this.backend===`android`?{kind:`ime-probe`,...e}:{kind:`mechanism`,mechanism:`appium-hide-keyboard`,...e}}async keyboardEnter(){if(this.requireSupport(`keyboard`),this.backend===`android`)return await this.client.executeScript(`mobile: pressKey`,[{keycode:66}]),{kind:`android-acknowledged`};let e=await this.keyboardVisibility();await this.client.sendKeys(`
-`);let t=await this.keyboardVisibilityAfterMutation();return{kind:`visibility-echo`,...e===void 0?{}:{wasVisible:e},...t===void 0?{}:{visible:t}}}async keyboardVisibilityAfterMutation(){try{return await this.keyboardVisibility()}catch{return}}async keyboardVisibility(){let e=await this.client.isKeyboardShown(B);return e===`unsupported`?void 0:e}async keyboardVisible(){let e=await this.keyboardVisibility();if(e===void 0)throw new t(`UNSUPPORTED_OPERATION`,`This driver does not implement the keyboard visibility route.`,{provider:this.capabilities.provider,platform:this.capabilities.platform,operation:`keyboard`});return e}async readClipboard(){this.requireSupport(`clipboard.read`);let e=await this.client.executeReadScript(`mobile: getClipboard`,[{}]);return typeof e==`string`?e:``}async writeClipboard(e){this.requireSupport(`clipboard.write`),await this.client.executeScript(`mobile: setClipboard`,[{content:e}])}async setSetting(e,t,n,r){this.unsupported(`settings`)}async awaitTextEntryReadiness(e,t,n){let r=e.keyboard,i=Date.now()+2e3,a=e.focusedElementId,o=await this.pollWithinBudget(i,async e=>{let r=await this.client.activeElement(e);return r===`unsupported`?`abandon`:r===`none`?`retry`:r.id!==a||dt(r.rect,t,n)?`satisfied`:`retry`});if(o===`satisfied`)return`focused-element`;if(o===`expired`)throw V(t,n,`nothing there took text-entry focus, so the text was not sent`);if(r===`unsupported`)throw ut(t,n);if(r)throw V(t,n,`the keyboard was already up and this driver cannot report which field holds focus, so the text was not sent`);if(await this.pollWithinBudget(i,async e=>await this.client.isKeyboardShown(e)===!0?`satisfied`:`retry`)===`satisfied`)return`keyboard-shown`;throw V(t,n,`no keyboard appeared, so the text was not sent`)}async readTextEntryState(){let[e,t]=await Promise.all([this.client.isKeyboardShown(B),this.client.activeElement(B)]);return{keyboard:e,focusedElementId:t===`none`||t===`unsupported`?void 0:t.id}}async pollWithinBudget(e,t){let n=!1,r;for(;;){let i=e-Date.now();if(i<=0)break;try{let e=await t(Math.min(B,i));if(n=!0,e!==`retry`)return e}catch(e){r=e}let a=e-Date.now();if(a<=0)break;await lt(Math.min(100,a))}if(!n&&r!==void 0)throw r;return`expired`}async pointerGesture(e,t){await this.client.performActions([z(e,t)]),await this.client.releaseActions().catch(()=>void 0)}async scrollGestureFrame(){return await this.client.source().then(e=>this.backend===`xctest`?rt(e):nt(e)).catch(()=>void 0)||await this.client.windowRect()}requireSupport(e){p(this.capabilities,e)||this.unsupported(e)}unsupported(e){throw new t(`UNSUPPORTED_OPERATION`,f(this.capabilities,e),{provider:this.capabilities.provider,platform:this.capabilities.platform,operation:e})}};function mt(e){let n=e[0];if(!n)throw new t(`INVALID_ARGS`,`WebDriver gesture pointer requires samples`);let r=[{type:`pointerMove`,duration:0,x:n.point.x,y:n.point.y},{type:`pointerDown`,button:0}];for(let t=1;t<e.length;t+=1){let n=e[t-1],i=e[t];r.push({type:`pointerMove`,duration:i.offsetMs-n.offsetMs,x:i.point.x,y:i.point.y})}return r.push({type:`pointerUp`,button:0}),r}function ht(e){if(e.topology===`single`)return`swipe`;switch(e.intent){case`pan`:case`transform`:return`transformGesture`;case`pinch`:return`pinch`;case`rotate`:return`rotateGesture`}}function gt(e){return new t(`COMMAND_FAILED`,`The cloud driver did not finish reading the screen in its budget.`,{...e.details,hint:`A screen that never goes idle (looping video, live ticker, continuous animation) gives the driver no moment to read the UI tree. This read has the transport's own budget and does not grow with --timeout; take a screenshot, or drive the screen from refs an earlier snapshot already captured.`},e)}var _t=class{sessionsByLeaseId=new Map;ownedDeviceIds=new Set;releasedProviderSessionIdsByLeaseId=new Map;options;constructor(e){this.options=e}ownsDevice(e){return this.ownedDeviceIds.has(e.id)}findSessionForDevice(e){return[...this.sessionsByLeaseId.values()].find(t=>t.device.id===e.id)}findSessionForLease(e){return this.sessionsByLeaseId.get(e)}getInteractor(e){return this.findSessionForDevice(e)?.interactor}heartbeat(e){if(e.leaseProvider===this.options.provider&&this.sessionsByLeaseId.has(e.leaseId))return{provider:this.options.provider}}async allocate(e,t){if(e.leaseProvider!==this.options.provider)return;let{rejectRefusedProviderProfileFields:n}=await import(`./provider-profile-fields.js`).then(e=>e.t);if(n(t?.flags,this.options.profileFields),this.sessionsByLeaseId.has(e.leaseId))return this.heartbeat(e);let r=await this.prepareSession(e,t),i=new Xe({clientVersion:this.options.clientVersion,endpoint:r.endpoint,auth:r.auth,headers:r.headers,requestPolicy:this.options.requestPolicy}),a=await this.createSessionWithPreparedCleanup(i,r,e,t),o=this.deviceForLease(e,r),s=r.providerSessionId??a.sessionId,c=d({provider:this.options.provider,platform:r.platform,overrides:this.options.capabilityOverrides});return this.sessionsByLeaseId.set(e.leaseId,Object.freeze({lease:e,device:o,client:i,prepared:r,capabilities:c,webDriverSessionId:a.sessionId,providerSessionId:s,interactor:ft({client:i,backend:de(r.platform),capabilities:c,targetId:o.id})})),this.ownedDeviceIds.add(o.id),{provider:this.options.provider,deviceId:o.id,sessionId:a.sessionId,providerSessionId:s,capabilities:c,...r.providerData}}async release(e){if(e.leaseProvider!==this.options.provider)return;let t=this.sessionsByLeaseId.get(e.leaseId);if(!t)return;this.sessionsByLeaseId.delete(e.leaseId),this.releasedProviderSessionIdsByLeaseId.set(e.leaseId,t.providerSessionId);let n=await this.closeSession(t),r=await this.safeListArtifacts(t);return{provider:this.options.provider,providerSessionId:t.providerSessionId,...n.cleanup,...n.warnings.length>0?{warnings:n.warnings}:{},...r?{cloudArtifacts:r}:{}}}async listCloudArtifacts(e){if(e.provider!==this.options.provider)return;let t=this.sessionsByLeaseId.get(e.leaseId??``);return t?await this.listActiveCloudArtifacts(t,e.providerSessionId):await this.listReleasedCloudArtifacts(e)}async listActiveCloudArtifacts(e,t){if(!(t&&t!==e.providerSessionId))return await this.safeListArtifacts(e)}async listReleasedCloudArtifacts(e){let t=this.releasedProviderSessionIdsByLeaseId.get(e.leaseId??``);if(!(!t||!this.options.listArtifacts)&&!(e.providerSessionId&&e.providerSessionId!==t))return await this.options.listArtifacts({provider:this.options.provider,providerSessionId:t})}async shutdown(){await Promise.allSettled([...this.sessionsByLeaseId.values()].map(async e=>await this.closeSession(e))),this.sessionsByLeaseId.clear(),this.ownedDeviceIds.clear()}async createSessionWithPreparedCleanup(e,t,n,r){try{return await e.createSession(t.webdriverCapabilities,{deadline:r?.deadline})}catch(e){let r=C(e)?vt(e,this.options.provider,n,t):e;throw await ye(r,()=>t.cleanup?.()),r}}async prepareSession(e,t){let n=this.baseSessionForLease(e);return this.options.prepareSession?await this.options.prepareSession({lease:e,req:t,base:n}):n}baseSessionForLease(e){let t=typeof this.options.webdriverCapabilities==`function`?this.options.webdriverCapabilities(e):this.options.webdriverCapabilities??{};return{provider:this.options.provider,endpoint:this.options.endpoint,platform:this.options.platform,deviceName:this.options.deviceName,auth:this.options.auth,headers:this.options.headers,webdriverCapabilities:H(this.options.platform,this.options.deviceName,t)}}deviceForLease(e,t){return{...n(t.platform),...t.platform===`ios`?{appleOs:`ios`}:{},id:t.deviceId??this.options.deviceId?.(e)??`${this.options.provider}:${t.platform}:${e.leaseId}`,name:t.deviceName,kind:`device`,target:`mobile`,booted:!0}}async closeSession(t){let n=[],r;try{await t.client.deleteSession()}catch(t){n.push({code:`WEBDRIVER_SESSION_DELETE_FAILED`,message:e(t)})}try{r=await t.prepared.cleanup?.()}catch(t){n.push({code:`PROVIDER_CLEANUP_FAILED`,message:e(t)})}return{cleanup:r,warnings:n}}async safeListArtifacts(e){let t=e.prepared.listArtifacts??this.options.listArtifacts;if(t)try{return await t({provider:this.options.provider,lease:e.lease,device:e.device,webDriverSessionId:e.webDriverSessionId,providerSessionId:e.providerSessionId})}catch(t){return ve({provider:this.options.provider,providerSessionId:e.providerSessionId,error:t})}}};function H(e,t,n={}){return{platformName:e===`ios`?`iOS`:`Android`,"appium:deviceName":t,...n}}function vt(e,n,r,i){let a=e.details?.timeoutMs;return new t(`COMMAND_FAILED`,`${n} did not create the WebDriver session within ${String(a)}ms.`,{reason:`provider_session_create_timeout`,provider:n,leaseId:r.leaseId,runId:r.runId,timeoutMs:a,...i.providerSessionId?{providerSessionId:i.providerSessionId}:{},hint:`${n} may still finish creating the session after agent-device stopped waiting, and that session would keep billing until the provider reaps it. Before retrying, check ${n} for a running session created for lease ${r.leaseId} (run ${r.runId}) and stop it.`},e)}function yt(e){return new bt(e)}var bt=class{provider;owner;leaseLifecycle;cloudArtifacts;deviceInventoryProvider;capabilities;platformRuntimeModule;sessions;deployment;constructor(e){this.provider=e.provider,this.owner=i(e.provider,e.platform),this.capabilities=d({provider:e.provider,platform:e.platform,overrides:e.capabilityOverrides}),this.sessions=new _t(e),this.deployment=pe({provider:e.provider,uploadApp:e.uploadApp,findSessionForDevice:e=>this.sessions.findSessionForDevice(e)}),this.platformRuntimeModule=Object.freeze({owner:this.owner,loadRuntime:async e=>await this.loadRuntime(e)}),this.leaseLifecycle={allocate:async(e,t)=>await this.sessions.allocate(e,t),heartbeat:async e=>this.sessions.heartbeat(e),release:async e=>await this.sessions.release(e)},this.cloudArtifacts={listCloudArtifacts:async e=>await this.sessions.listCloudArtifacts(e)},this.deviceInventoryProvider=async e=>{if(e.leaseProvider!==this.provider)return null;if(!e.leaseId)return[];let t=this.sessions.findSessionForLease(e.leaseId);return t?[t.device]:[]}}async loadRuntime(e){let{createWebDriverPlatformRuntimeOwner:t}=await import(`./platform-runtime2.js`);return t({host:e,owner:this.owner,ownsDevice:e=>this.ownsDevice(e),isSessionActive:e=>this.sessions.findSessionForDevice(e)!==void 0,deployment:this.deployment,capabilities:this.capabilities,snapshotAvailable:this.capabilities.operations.snapshot.support!==`unsupported`,screenshotAvailable:this.capabilities.operations.screenshot.support!==`unsupported`,getInteractor:e=>this.getInteractor(e)})}ownsDevice(e){return this.sessions.ownsDevice(e)}getInteractor(e){return this.sessions.getInteractor(e)}async installApp(e,t,n,r){return await this.deployment.installApp(e,t,n,r)}async installInstallablePath(e,t,n){return await this.deployment.installInstallablePath(e,t,n)}async shutdown(){await this.sessions.shutdown()}};async function xt(e,t,n){return t?_e({provider:e,providerSessionId:t,artifacts:(await Promise.all([n.listArtifacts(t,`FILE`),n.listArtifacts(t,`LOG`)])).flat().flatMap(n=>Ct(e,t,n)),pendingMessage:`AWS Device Farm artifacts are not ready yet.`}):void 0}function St(e){if(!e||typeof e!=`object`)return[];let t=e.artifacts;return Array.isArray(t)?t:[]}function Ct(e,t,n){let r=n.url;return typeof r!=`string`||r.length===0?[]:[{provider:e,providerSessionId:t,kind:wt(n.type),name:n.name??n.type??`AWS Device Farm artifact`,url:r,providerArtifactId:n.arn,extension:n.extension,availability:`ready`,metadata:{awsType:n.type,...n.metadata?{awsMetadata:n.metadata}:{}}}]}function wt(e){switch(e){case`VIDEO`:return`video`;case`APPIUM_SERVER_OUTPUT`:return`appium-log`;case`DEVICE_LOG`:return`device-log`;case`MESSAGE_LOG`:case`UNKNOWN`:return`automation-log`;default:return`raw`}}const Tt={install:{support:`unsupported`,note:`Pass appArn when creating the remote access session; local artifact upload/install is not implemented.`},portReverse:{support:`unsupported`,note:`AWS Device Farm remote access does not expose agent-device port reverse.`},artifacts:{support:`supported`,note:`AWS Device Farm remote access exposes provider-hosted video, Appium logs, and device logs after session completion.`}};function U(e){let t=Nt(e);return{createRemoteAccessSession:async e=>W(await t(`create-remote-access-session`,[`--project-arn`,e.projectArn,`--device-arn`,e.deviceArn,`--name`,e.name,...e.appArn?[`--app-arn`,e.appArn]:[],...e.interactionMode?[`--interaction-mode`,e.interactionMode]:[],...e.configuration?[`--configuration`,JSON.stringify(e.configuration)]:[]])),getRemoteAccessSession:async e=>W(await t(`get-remote-access-session`,[`--arn`,e])),stopRemoteAccessSession:async e=>W(await t(`stop-remote-access-session`,[`--arn`,e])),listArtifacts:async(e,n)=>St(await t(`list-artifacts`,[`--arn`,e,`--type`,n]))}}function Et(e){return async({lease:n,req:r,base:i})=>{let a=await e.client.createRemoteAccessSession({projectArn:e.projectArn,deviceArn:e.deviceArn,appArn:e.appArn,name:be(e.sessionName,n)??`agent-device-${n.leaseId}`,interactionMode:e.interactionMode,configuration:e.configuration}),o,s;try{if(o=await kt(a.arn,e,r),s=Dt(o),!s)throw new t(`COMMAND_FAILED`,`AWS Device Farm did not expose a WebDriver endpoint.`,{sessionArn:o.arn,status:o.status})}catch(t){throw await ye(t,()=>e.client.stopRemoteAccessSession(a.arn)),t}let c=o.device?.name??e.deviceName,l=typeof e.webdriverCapabilities==`function`?e.webdriverCapabilities(n):e.webdriverCapabilities??{},u=e.platform===`android`?{"appium:autoLaunch":!1}:{};return{...i,endpoint:s,platform:e.platform,deviceName:c,webdriverCapabilities:H(e.platform,c,{...u,...l}),cleanup:async()=>(await e.client.stopRemoteAccessSession(o.arn),{awsDeviceFarmSessionArn:o.arn}),providerSessionId:o.arn,providerData:{awsDeviceFarmSessionArn:o.arn}}}}function Dt(e){let t=e.endpoints&&typeof e.endpoints==`object`?Object.values(e.endpoints):[],n=[e.remoteDriverEndpoint,e.endpoint,...t,e.remoteDebugUrl,e.remoteRecordAppUrl].filter(e=>typeof e==`string`&&e.length>0).find(e=>!/^wss?:\/\//i.test(e));return n?Ot(n):void 0}function Ot(e){return/^https?:\/\//i.test(e)?e:`http://${e}`}async function kt(e,n,r){let i=n.pollIntervalMs??5e3,a=Date.now(),o=r?.deadline??a+(n.startupTimeoutMs??12e4),s=r?.signal,c=await n.client.getRemoteAccessSession(e);for(;Date.now()<o;){if(s?.throwIfAborted(),c.status===`RUNNING`)return c;jt(c),await le(i,void 0,{signal:s}).catch(()=>s?.throwIfAborted()),c=await n.client.getRemoteAccessSession(e)}throw new t(`COMMAND_FAILED`,`Timed out waiting for AWS Device Farm remote access.`,{sessionArn:e,status:c.status,result:c.result,timeoutMs:o-a})}const At=new Set([`ERRORED`,`STOPPED`,`COMPLETED`]);function jt(e){if(!(!e.status||!At.has(e.status)))throw new t(`COMMAND_FAILED`,`AWS Device Farm remote access session did not start.`,{sessionArn:e.arn,status:e.status,result:e.result})}async function Mt(e,n,r){let i=await e(n,r);try{return JSON.parse(i.stdout)}catch(e){throw new t(`COMMAND_FAILED`,`AWS Device Farm returned invalid JSON.`,void 0,e)}}function Nt(e){let t=e.region?[`--region`,e.region]:[],n=e.awsCommand??`aws`;return async(r,i)=>await Mt(e.runHostCommand,n,[`devicefarm`,r,...t,...i,`--output`,`json`])}function W(e){if(!e||typeof e!=`object`)throw new t(`COMMAND_FAILED`,`AWS Device Farm response was not an object.`,{response:e});let n=e.remoteAccessSession;if(!n||typeof n!=`object`)throw new t(`COMMAND_FAILED`,`AWS Device Farm response missed remoteAccessSession.`,{response:e});return n}const Pt={install:{support:`partial`,note:`Local app artifacts are uploaded to BrowserStack App Automate, then installed with Appium.`},portReverse:{support:`unsupported`,note:`Use BrowserStack Local for network tunneling; agent-device port reverse is not available.`},artifacts:{support:`supported`,note:`BrowserStack session details expose provider-hosted video, Appium logs, device logs, and dashboard links.`}};async function Ft(e,t,n){return t?_e({provider:e,providerSessionId:t,artifacts:Ht(e,t,await Vt(t,n)),pendingMessage:`BrowserStack artifacts are not ready yet.`}):void 0}async function It(e,t,n){return n?.throwIfAborted(),await Ee(await Te(e,`file`,{provider:m.browserStack,service:`BrowserStack`}),{service:`BrowserStack`,endpoint:t.endpoint??`https://api-cloud.browserstack.com/app-automate/upload`,clientVersion:t.clientVersion,auth:t,readAppReference:Ut},n)}function Lt(e){return De(async(t,n)=>await It(t,e,n))}function G(e){let n=ie(e);if(n===void 0||ne(n))return n;throw new t(`INVALID_ARGS`,`BrowserStack --provider-app ${e} is not a bs:// app id.`,{providerApp:e,hint:`Pass <bs://app-id-or-local-path>.`})}async function Rt(e,t){return await Oe({service:`BrowserStack`,app:e,cwd:t.cwd,referenceLabel:`a bs:// app id`,parseReference:G,uploadFile:async(e,n)=>await It(e,t,n),signal:t.signal})}function zt(e){let{"bstack:options":t,...n}=e.configured??{};return{"appium:deviceName":e.deviceName,"appium:platformVersion":e.osVersion,...e.app?{"appium:app":e.app}:{},...n,"bstack:options":{...e.projectName?{projectName:e.projectName}:{},buildName:e.buildName,sessionName:e.sessionName,...e.deviceFeatures??{},...Bt(t)}}}function Bt(e){return e&&typeof e==`object`&&!Array.isArray(e)?e:{}}async function Vt(e,t){let n=await Ae(Ce(t.endpoint??`https://api-cloud.browserstack.com/app-automate/sessions`,`${e}.json`),{clientVersion:t.clientVersion,auth:t,service:`BrowserStack`});return Bt(n.automation_session??n)}function Ht(e,t,n){return[_(e,t,n,`video_url`,`video`,`Session video`),_(e,t,n,`appium_logs_url`,`appium-log`,`Appium logs`),_(e,t,n,`device_logs_url`,`device-log`,`Device logs`),_(e,t,n,`browser_url`,`provider-session`,`BrowserStack dashboard`),_(e,t,n,`public_url`,`provider-session`,`Public session link`)].filter(e=>e!==void 0)}function Ut(e){if(!e||typeof e!=`object`)return;let t=e.app_url;return typeof t==`string`?t:void 0}const Wt=[{field:`providerDeviceOrientation`,capability:`deviceOrientation`,type:`enum`,enumValues:o},{field:`providerGeoLocation`,capability:`geoLocation`,type:`string`},{field:`providerTimezone`,capability:`timezone`,type:`string`},{field:`providerAppiumVersion`,capability:`appiumVersion`,type:`string`},{field:`providerLanguage`,capability:`language`,type:`string`},{field:`providerLocale`,capability:`locale`,type:`string`},{field:`providerNetworkProfile`,capability:`networkProfile`,type:`string`},{field:`providerCustomNetwork`,capability:`customNetwork`,type:`string`},{field:`providerNoResignApp`,capability:`resignApp`,type:`negated-boolean`,platform:`ios`}].map(e=>({...e,flag:s[e.field]}));function Gt(e,t){Yt(e);let n={};for(let r of Wt){let i=e[r.field];i!==void 0&&i!==!1&&i!==``&&(Jt(r,t),n[r.capability]=r.type!==`negated-boolean`&&i)}return n}function Kt(e){let t={};for(let n of Wt){let r=e?.[n.field];if(n.type===`negated-boolean`){r===!0&&(t.providerNoResignApp=!0);continue}typeof r==`string`&&r.length!==0&&qt(t,n,r)}return t}function qt(e,t,n){if(t.field===`providerDeviceOrientation`){e.providerDeviceOrientation=Me(t,n);return}t.field!==`providerNoResignApp`&&(e[t.field]=n)}function Jt(e,n){if(!(!e.platform||e.platform===n))throw new t(`INVALID_ARGS`,`${e.flag} applies to ${e.platform} sessions only, but the session platform is ${n}.`,{hint:`Drop ${e.flag} or connect with --platform ${e.platform}.`,flag:e.flag,capability:e.capability,platform:n})}function Yt(e){if(!(!e.providerNetworkProfile||!e.providerCustomNetwork))throw new t(`INVALID_ARGS`,`BrowserStack accepts either a named network profile or a custom network shape, not both.`,{hint:`Pass only one of --provider-network-profile or --provider-custom-network.`,networkProfile:e.providerNetworkProfile,customNetwork:e.providerCustomNetwork})}function K(e){return/^arn:[^:]+:devicefarm:([^:]+):/.exec(e)?.[1]}async function Xt(e,n){let r=Nt({runHostCommand:n,region:e.region}),[i,a,o]=await Promise.all([r(`get-project`,[`--arn`,e.projectArn]),r(`get-device`,[`--arn`,e.deviceArn]),e.appArn?r(`get-upload`,[`--arn`,e.appArn]):void 0]),s=q(i,`project`),c=q(a,`device`),l=Qt(c.platform);if(l!==e.platform)throw new t(`INVALID_ARGS`,`AWS Device Farm device "${J(c.name)??e.deviceArn}" is ${l}, not ${e.platform}.`);let u=e.appArn?Zt(q(o,`upload`),e):{status:`missing`,message:`No app upload is attached; AWS Device Farm does not support install after allocation. Reconnect with --aws-app-arn <arn>.`};return{provider:`aws-device-farm`,service:`AWS Device Farm`,verificationMessage:e.appArn?`Credentials, project, device, and app upload verified.`:`Credentials, project, and device verified.`,project:{name:J(s.name),reference:e.projectArn},device:{status:`verified`,name:J(c.name)??e.deviceArn,reference:e.deviceArn,platform:l,osVersion:J(c.os),availability:J(c.availability)},app:u}}function Zt(e,n){let r=J(e.status);if(r!==`SUCCEEDED`)throw new t(`COMMAND_FAILED`,`AWS Device Farm app upload is not ready (${r??`unknown status`}).`,{status:r,hint:`Wait for the upload to succeed or reconnect with a different --aws-app-arn.`});let i=n.platform===`android`?`ANDROID_APP`:`IOS_APP`,a=J(e.type);if(a!==i)throw new t(`INVALID_ARGS`,`AWS Device Farm app upload type is ${a??`unknown`}, expected ${i}.`);return{status:`verified`,name:J(e.name),reference:n.appArn}}function q(e,n){if(!e||typeof e!=`object`)throw new t(`COMMAND_FAILED`,`AWS Device Farm ${n} response was not an object.`);let r=e[n];if(!r||typeof r!=`object`||Array.isArray(r))throw new t(`COMMAND_FAILED`,`AWS Device Farm response missed ${n}.`);return r}function Qt(e){if(e===`ANDROID`)return`android`;if(e===`IOS`)return`ios`;throw new t(`UNSUPPORTED_PLATFORM`,`AWS Device Farm device platform is ${String(e)}.`)}function J(e){return typeof e==`string`&&e.length>0?e:void 0}async function $t(e,n){let r=en(e.app),i={username:e.username,accessKey:e.accessKey},a=rn(await nn(e.devicesEndpoint??`https://api-cloud.browserstack.com/app-automate/devices.json`,i,n)).find(t=>t.device===e.deviceName&&t.os.toLowerCase()===e.platform&&je(t.osVersion,e.osVersion));if(!a)throw new t(`INVALID_ARGS`,`BrowserStack device "${e.deviceName}" with ${e.platform} ${e.osVersion} is not available.`,{hint:`Choose an exact device and OS version from the BrowserStack App Automate device list.`});let o=await tn(r,e,i,n);return{provider:`browserstack`,service:`BrowserStack`,verificationMessage:o.status===`verified`?`Credentials, device, and uploaded app verified.`:`Credentials and device access verified; app availability is checked when the session is created.`,device:{status:`verified`,name:a.device,platform:e.platform,osVersion:a.osVersion},app:o}}function en(e){return G(e)??e}async function tn(e,t,n,r){if(ne(e)){let i=an(await nn(t.appsEndpoint??`https://api-cloud.browserstack.com/app-automate/recent_apps?limit=100`,n,r)).find(t=>t.reference===e);return i?{status:`verified`,...i}:{status:`configured`,reference:e,message:`App reference was not found in the 100 most recent uploads; BrowserStack validates it when creating the session.`}}return/^https?:\/\//i.test(e)?{status:`configured`,reference:e,message:`Public app URL configured; BrowserStack validates it when creating the session.`}:{status:`configured`,name:g.basename(e),reference:e,message:`Local app artifact is ready and will be uploaded when creating the session.`}}async function nn(e,t,n){return await ke(e,{clientVersion:n,auth:t,hints:{service:`BrowserStack`,unauthorizedHint:`Check BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY.`,networkHint:`Check network access to api-cloud.browserstack.com and retry connect.`}})}function rn(e){if(!Array.isArray(e))throw new t(`COMMAND_FAILED`,`BrowserStack device verification response was not a list.`);return e.flatMap(e=>{let t=Y(e),n=t?.os_version;return t&&typeof t.device==`string`&&typeof t.os==`string`&&(typeof n==`string`||typeof n==`number`)?[{device:t.device,os:t.os,osVersion:String(n)}]:[]})}function an(e){let n=Y(e);if(n&&Object.keys(n).length===0)return[];if(!Array.isArray(e))throw new t(`COMMAND_FAILED`,`BrowserStack app verification response was not a list.`);return e.flatMap(e=>{let t=Y(e);return!t||typeof t.app_url!=`string`?[]:[{reference:t.app_url,...typeof t.app_name==`string`?{name:t.app_name}:{},...typeof t.app_version==`string`?{version:t.app_version}:{}}]})}function Y(e){return e&&typeof e==`object`&&!Array.isArray(e)?e:void 0}async function on(e,t){return e.provider===`browserstack`?await $t(e,t.clientVersion):await Xt(e,t.runHostCommand)}const sn={provider:m.browserStack,label:`BrowserStack`,fields:{providerApp:`consumed`,providerOsVersion:`consumed`,providerProject:`consumed`,providerBuild:`consumed`,providerSessionName:`consumed`,providerDeviceOrientation:`consumed`,providerGeoLocation:`consumed`,providerTimezone:`consumed`,providerAppiumVersion:`consumed`,providerLanguage:`consumed`,providerLocale:`consumed`,providerNetworkProfile:`consumed`,providerCustomNetwork:`consumed`,providerNoResignApp:`consumed`,awsProjectArn:`refused`,awsDeviceArn:`refused`,awsAppArn:`refused`,awsRegion:`refused`,awsInteractionMode:`refused`}},cn={provider:m.awsDeviceFarm,label:`AWS Device Farm`,fields:{providerApp:`refused`,providerOsVersion:`refused`,providerProject:`refused`,providerBuild:`refused`,providerSessionName:`consumed`,providerDeviceOrientation:`refused`,providerGeoLocation:`refused`,providerTimezone:`refused`,providerAppiumVersion:`refused`,providerLanguage:`refused`,providerLocale:`refused`,providerNetworkProfile:`refused`,providerCustomNetwork:`refused`,providerNoResignApp:`refused`,awsProjectArn:`consumed`,awsDeviceArn:`consumed`,awsAppArn:`consumed`,awsRegion:`consumed`,awsInteractionMode:`consumed`}},ln={[m.browserStack]:sn,[m.awsDeviceFarm]:cn};function un(e){return[{provider:m.browserStack,profileFields:sn,createRuntime:(t,n)=>yt({clientVersion:e.clientVersion,provider:m.browserStack,profileFields:n,platform:`android`,deviceName:`BrowserStack device`,endpoint:t.BROWSERSTACK_WEBDRIVER_ENDPOINT??`https://hub-cloud.browserstack.com/wd/hub/`,capabilityOverrides:Pt,listArtifacts:async({provider:n,providerSessionId:r})=>{let{username:i,accessKey:a}=$(t,`BrowserStack artifact lookup`);return await Ft(n,r,{clientVersion:e.clientVersion,username:i,accessKey:a,endpoint:t.BROWSERSTACK_SESSION_DETAILS_ENDPOINT})},prepareSession:async({req:n,lease:r,base:i})=>{let a=X(n,`BrowserStack`),{username:o,accessKey:s}=$(t,`BrowserStack`),c=dn(a,`BrowserStack`),l=Z(a,`device`,`BrowserStack requires --device <name>.`),u=Z(a,`providerOsVersion`,`BrowserStack requires --provider-os-version <version>.`),ee=await Rt(Z(a,`providerApp`,`BrowserStack requires --provider-app <bs://app-id-or-local-path>.`),{clientVersion:e.clientVersion,username:o,accessKey:s,endpoint:t.BROWSERSTACK_APP_UPLOAD_ENDPOINT,cwd:a.cwd,signal:a.signal});return{...i,platform:c,deviceName:l,auth:{username:o,accessKey:s},uploadApp:Lt({clientVersion:e.clientVersion,username:o,accessKey:s,endpoint:t.BROWSERSTACK_APP_UPLOAD_ENDPOINT??`https://api-cloud.browserstack.com/app-automate/upload`}),webdriverCapabilities:zt({deviceName:l,osVersion:u,app:ee,projectName:Q(a,`providerProject`),buildName:Q(a,`providerBuild`)??r.runId,sessionName:Q(a,`providerSessionName`)??r.leaseId,deviceFeatures:Gt(Kt(a.flags),c),configured:H(c,l)})}}}),listArtifactsFromEnv:async(t,n)=>{let{username:r,accessKey:i}=$(n,`BrowserStack artifact lookup`);return await Ft(m.browserStack,t,{clientVersion:e.clientVersion,username:r,accessKey:i,endpoint:n.BROWSERSTACK_SESSION_DETAILS_ENDPOINT})}},{provider:m.awsDeviceFarm,profileFields:cn,createRuntime:(t,n)=>yt({clientVersion:e.clientVersion,provider:m.awsDeviceFarm,profileFields:n,endpoint:`http://127.0.0.1/`,platform:`android`,deviceName:`AWS Device Farm device`,capabilityOverrides:Tt,listArtifacts:async({provider:n,providerSessionId:r})=>await xt(n,r,U({runHostCommand:e.runHostCommand,region:t.AWS_REGION??t.AWS_DEFAULT_REGION??K(r??``)})),prepareSession:async({req:n,lease:r,base:i})=>{let a=X(n,`AWS Device Farm`),o=dn(a,`AWS Device Farm`);return await Et({client:U({runHostCommand:e.runHostCommand,region:Q(a,`awsRegion`)??t.AWS_REGION??t.AWS_DEFAULT_REGION}),projectArn:fn(a,t,`awsProjectArn`,`AGENT_DEVICE_AWS_DEVICE_FARM_PROJECT_ARN`,`AWS_DEVICE_FARM_PROJECT_ARN`),deviceArn:fn(a,t,`awsDeviceArn`,`AGENT_DEVICE_AWS_DEVICE_FARM_DEVICE_ARN`,`AWS_DEVICE_FARM_DEVICE_ARN`),appArn:Q(a,`awsAppArn`)??t.AGENT_DEVICE_AWS_DEVICE_FARM_APP_ARN??t.AWS_DEVICE_FARM_APP_ARN,platform:o,deviceName:Q(a,`device`)??`AWS Device Farm device`,sessionName:Q(a,`providerSessionName`)??r.leaseId,interactionMode:pn(a)})({lease:r,req:n,base:i})}}),listArtifactsFromEnv:async(t,n)=>{let r=U({runHostCommand:e.runHostCommand,region:n.AWS_REGION??n.AWS_DEFAULT_REGION??K(t)});return await xt(m.awsDeviceFarm,t,r)}}]}function X(e,n){if(e)return e;throw new t(`INVALID_ARGS`,`${n} lease allocation requires provider profile flags on the request.`)}function dn(e,n){let r=e.flags?.platform;if(r===`android`||r===`ios`)return r;throw new t(`INVALID_ARGS`,`${n} requires --platform ios|android.`)}function Z(e,n,r){let i=Q(e,n);if(i)return i;throw new t(`INVALID_ARGS`,r)}function Q(e,t){let n=e.flags?.[t];return typeof n==`string`&&n.length>0?n:void 0}function fn(e,n,r,i,a){let o=Q(e,r)??n[i]??n[a];if(o)return o;throw new t(`INVALID_ARGS`,`AWS Device Farm requires --${mn(String(r))} or ${a}.`)}function pn(e){let t=Q(e,`awsInteractionMode`);if(t===`INTERACTIVE`||t===`NO_VIDEO`||t===`VIDEO_ONLY`)return t}function mn(e){return e.replaceAll(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function $(e,n){let{username:r,accessKey:i}=re(e);if(r&&i)return{username:r,accessKey:i};let a=r?h.accessKey:h.username;throw new t(`INVALID_ARGS`,`${n} requires ${a} in the environment.`)}function hn(e){let t=un(e);return{providerIds:t.map(e=>e.provider),createDefaultRuntimes:(e=process.env)=>t.map(t=>t.createRuntime(e,t.profileFields)),listArtifactsFromEnv:async(e,n)=>{if(e.providerSessionId)return await t.find(t=>t.provider===e.provider)?.listArtifactsFromEnv(e.providerSessionId,n)},verifyConnection:async t=>await on(t,e)}}const gn=hn({clientVersion:ee(),runHostCommand:async(e,t)=>({stdout:(await u(e,[...t],{maxBuffer:10485760,timeoutMs:3e4})).stdout})});export{G as a,K as i,ln as n,$ as r,gn as t};
+import{l as e}from"./exec.js";import"./command.js";import{a as t}from"./version.js";import{i as n}from"./runtime-deployment.js";import{_ as r,g as i,l as a,m as o,t as s}from"./runtime2.js";import{_ as c,a as l,b as u,d,f,g as p,h as m,i as h,l as g,o as _,p as v,r as y,s as b,u as x,v as S,y as C}from"./browserstack.js";import{i as w,n as T}from"./providers.js";import{n as E,t as D}from"./browserstack-device-features.js";const O=T.awsDeviceFarm,k=`AWS Device Farm`,A={declaration:w(O),create:j};function j(e){let{env:t,runHostCommand:n}=e,o=e=>v({runHostCommand:n,region:e}),s={provider:O,profileFields:f,endpoint:`http://127.0.0.1/`,platform:`android`,deviceName:`AWS Device Farm device`,capabilityOverrides:d,listArtifacts:async({provider:e,providerSessionId:n})=>await u(e,n,o(S(t,`awsRegion`)??c(n??``))),prepareSession:async({req:e,lease:n,base:s})=>{let c=i(e,k),l=r(c,k),u=e=>C(a(c,e),t,e,k);return await m({client:o(a(c,`awsRegion`)??S(t,`awsRegion`)),projectArn:u(`awsProjectArn`),deviceArn:u(`awsDeviceArn`),appArn:a(c,`awsAppArn`)??S(t,`awsAppArn`),platform:l,deviceName:a(c,`device`)??`AWS Device Farm device`,sessionName:a(c,`providerSessionName`)??n.leaseId,interactionMode:p(c)})({lease:n,req:e,base:s})}},l=async()=>(await import(`./aws-device-farm-connection.js`)).createAwsDeviceFarmConnection(e);return{webDriver:s,connection:{resolve:async e=>(await l()).resolve(e),verify:async e=>await(await l()).verify(e)}}}const M=T.browserStack,N=`BrowserStack`,P={declaration:w(M),create:F};function F(e){let{env:t,clientVersion:s}=e,c={provider:M,profileFields:h,platform:`android`,deviceName:`BrowserStack device`,endpoint:t.BROWSERSTACK_WEBDRIVER_ENDPOINT??`https://hub-cloud.browserstack.com/wd/hub/`,capabilityOverrides:y,listArtifacts:async({provider:e,providerSessionId:n})=>await b(e,n,{clientVersion:s,...g(t,`BrowserStack artifact lookup`),endpoint:t.BROWSERSTACK_SESSION_DETAILS_ENDPOINT}),prepareSession:async({req:e,lease:c,base:u})=>{let d=i(e,N),f=g(t,N),p=r(d,N),m=o(d,`device`,`BrowserStack requires --device <name>.`),h=o(d,`providerOsVersion`,`BrowserStack requires --provider-os-version <version>.`),v={clientVersion:s,...f,endpoint:t.BROWSERSTACK_APP_UPLOAD_ENDPOINT??`https://api-cloud.browserstack.com/app-automate/upload`},y=await x(o(d,`providerApp`,`BrowserStack requires --provider-app <bs://app-id-or-local-path>.`),{...v,cwd:d.cwd,signal:d.signal});return{...u,platform:p,deviceName:m,auth:f,uploadApp:_(v),webdriverCapabilities:l({deviceName:m,osVersion:h,app:y,projectName:a(d,`providerProject`),buildName:a(d,`providerBuild`)??c.runId,sessionName:a(d,`providerSessionName`)??c.leaseId,deviceFeatures:D(E(d.flags),p),configured:n(p,m)})}}},u=async()=>(await import(`./browserstack-connection.js`)).createBrowserStackConnection(e);return{webDriver:c,connection:{resolve:async e=>(await u()).resolve(e),verify:async e=>await(await u()).verify(e)}}}const I=Object.freeze([P,A]);function L(e){return I.find(t=>t.declaration.provider===e)}function R(e){return I.map(t=>s({...t.create(e).webDriver,clientVersion:e.clientVersion}))}const z=I.map(e=>e.declaration.provider);function B(n){return{env:n,clientVersion:t(),runHostCommand:async(t,n)=>({stdout:(await e(t,[...n],{maxBuffer:10485760,timeoutMs:3e4})).stdout})}}function V(e){return R(B(e))}function H(e,t){return L(e)?.create(B(t)).connection}export{H as n,V as r,z as t};

package/dist/src/providers.js

@@ -1 +1 @@
-const e={browserStack:`browserstack`,awsDeviceFarm:`aws-device-farm`},t=new Set(Object.values(e));function n(e){return e!==void 0&&t.has(e)}const r={username:`BROWSERSTACK_USERNAME`,accessKey:`BROWSERSTACK_ACCESS_KEY`};function i(e){return{username:e[r.username]||void 0,accessKey:e[r.accessKey]||void 0}}const a=`bs://`;function o(e){if(e.slice(0,5).toLowerCase()===a)return`${a}${e.slice(5)}`}function s(e){return/^bs:\/\/[\w.-]+$/.test(e)}export{n as a,s as i,e as n,i as o,o as r,r as t};
+const e={browserStack:`browserstack`,awsDeviceFarm:`aws-device-farm`},t={username:`BROWSERSTACK_USERNAME`,accessKey:`BROWSERSTACK_ACCESS_KEY`},n={leaseKind:`direct-device-provider`,requiresAppAttachment:!1,requiresRemoteDaemon:!1,supportsArtifacts:!0,supportsDeferredAppSelection:!1,supportsDirectPortReverse:!1,usesCloudWebDriverLease:!0},r=Object.freeze([{provider:e.browserStack,connection:n,credentialVariables:Object.values(t)},{provider:e.awsDeviceFarm,connection:{...n,requiresAppAttachment:!0}}]);function i(e){return r.find(t=>t.provider===e)}function a(e,t){if(e.slice(0,t.length).toLowerCase()===t)return`${t}${e.slice(t.length)}`}function o(e){return a(e,`bs://`)}function s(e){return/^bs:\/\/[\w.-]+$/.test(e)}export{s as a,i,e as n,o as r,t};

package/dist/src/react-devtools.js

@@ -0,0 +1,2 @@
+import{P as e}from"./sdk-contracts.js";import{p as t}from"./exec.js";import"./command.js";import{t as n}from"./remote-bridge.js";import{a as r,i,n as a}from"./provider-policy.js";function o(e){return[`exec`,`--yes`,`--package`,`agent-react-devtools@0.5.0`,`--`,`agent-react-devtools`,...e]}function s(e){return e===`ios-instance`}function c(e){return e[0]===`wait`&&e.includes(`--connected`)}function l(e,t,n){n===0||!c(e)||!s(t?.leaseBackend)||process.stderr.write([`Hint: Remote iOS React DevTools connects during JavaScript startup.`,"If the app was already open before `agent-device react-devtools start`, relaunch it with `agent-device open <bundle-id> --platform ios --relaunch`, then retry `agent-device react-devtools wait --connected`.",``].join(`
+`))}function u(e,t,n){return n||(e.push(t),``)}function d(t){if(!t?.metroProxyBaseUrl||!n(t.leaseBackend))return null;let r=[],i={serverBaseUrl:u(r,`metroProxyBaseUrl`,t.metroProxyBaseUrl),bearerToken:u(r,`metroBearerToken`,t.metroBearerToken),tenantId:u(r,`tenant`,t.tenant),runId:u(r,`runId`,t.runId),leaseId:u(r,`leaseId`,t.leaseId)};if(r.length>0)throw new e(`INVALID_ARGS`,`react-devtools remote bridge requires ${r.join(`, `)}.`,{missing:r});return i}async function f(e,t,n){let{flags:a}=t,o=d(a);if(!o)return n();let s=t.stateDir??process.cwd(),c=t.session??a?.session??`default`,l=a?.remoteConfig??`${o.tenantId}:${o.runId}:${o.leaseId}`;if(e[0]===`stop`)try{return await n()}finally{await r({projectRoot:t.cwd??process.cwd(),stateDir:s,profileKey:l,consumerKey:c})}return await i({projectRoot:t.cwd??process.cwd(),stateDir:s,serverBaseUrl:o.serverBaseUrl,bearerToken:o.bearerToken,bridgeScope:{tenantId:o.tenantId,runId:o.runId,leaseId:o.leaseId},session:c,profileKey:l,consumerKey:c,env:t.env??process.env}),await n()}function p(e,t){if(e[0]!==`start`)return!1;let{flags:n}=t;return n?a(n.leaseProvider,t.env).supportsDirectPortReverse&&n.leaseBackend===`android-instance`&&n.metroProxyBaseUrl===void 0&&t.configureDirectPortReverse!==void 0:!1}async function m(e,n={}){let r=n.cwd??process.cwd(),i=n.env??process.env,a=await f(e,n,async()=>(p(e,n)&&await n.configureDirectPortReverse?.(),(await t(`npm`,o(e),{cwd:r,env:i,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode));return l(e,n.flags,a),a}export{m as runReactDevtoolsCommand};

package/dist/src/react-native.js

@@ -1 +1 @@
-import{J as e,f as t,s as n}from"./sdk-contracts.js";import{A as r}from"./sdk-batch-runner.js";import{n as i}from"./catalog.js";import{r as a}from"./success-text.js";import{t as o}from"./overlay.js";import{A as s}from"./session-snapshot.js";import{n as c}from"./touch-reference-frame.js";import{s as l}from"./quality-warnings.js";import{o as u,u as d}from"./interaction-ref-policy.js";import{captureSnapshotForSession as f}from"./interaction.js";import{n as p,t as m}from"./touch-runtime2.js";async function h(r){r=d(r);let{req:a,sessionStore:s}=r;if(a.command!==i.reactNative)return null;let c=g(a.positionals??[]);if(!c.ok)return c.response;let u=r.sessionRef?s.requireCurrent(r.sessionRef):void 0;if(!u)return t();let m=await p({device:u.device,command:`press`,requiresCapture:!1,inspectFacts:r.inspectFacts,bindDevice:r.bindDevice,unavailableResponse:e=>n(`UNSUPPORTED_OPERATION`,`react-native dismiss-overlay is not supported on this device`,void 0,e.hint?{hint:e.hint}:void 0)});if(!m.ok)return m.response;try{let e=await f(r.sessionRef,a.flags,s,r.contextFromFlags,{interactiveOnly:!0});if(l(e.snapshotQuality))return v(e.snapshotQuality);let t=o(e.nodes),n=t.primaryAction;return n?await y(r,u,e,n,m.runtime):_(t.detected)}catch(t){return{ok:!1,error:e(t)}}}function g(e){return e.length===1&&e[0]===`dismiss-overlay`?{ok:!0}:{ok:!1,response:n(`INVALID_ARGS`,`react-native supports only: dismiss-overlay`)}}function _(e){return e?n(`COMMAND_FAILED`,`React Native overlay detected, but no safe dismiss target was found`,{hint:`Use screenshot --overlay-refs for visual evidence and report the overlay instead of pressing the warning body.`}):{ok:!0,data:{action:`dismiss-overlay`,detected:!1,dismissed:!1,...a(`No React Native overlay detected`)}}}function v(e){return n(`COMMAND_FAILED`,`React Native overlay state could not be determined because the accessibility tree is unreadable`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth; if an overlay is visible, report it or navigate with coordinates, then retry snapshot or dismiss-overlay on a readable screen.`})}async function y(e,t,i,o,l){let{req:d,sessionStore:f}=e,p=e.contextFromFlags(d.flags,t.appBundleId,t.trace?.outPath),h=m(l,p).tapPoint;if(!h)return n(`UNSUPPORTED_OPERATION`,`react-native dismiss-overlay is not supported on this device`);let g=Date.now();s(t);let _=await h(o.point),v=Date.now(),y=await b(e),S=r({...c(i.nodes),..._,action:`dismiss-overlay`,overlayAction:o.action,x:o.point.x,y:o.point.y,ref:o.ref,label:o.label,warning:o.warning,dismissed:!0,verified:y.verified,verificationRequired:!y.verified,verificationWarning:y.verificationWarning,nextCommand:y.nextCommand,...a(x(y))});return u({ref:e.sessionRef,sessionStore:f,command:d.command,positionals:d.positionals??[],flags:d.flags,result:S,responseData:S,actionStartedAt:g,actionFinishedAt:v})}async function b(e){let{req:t,sessionStore:n}=e,r=await f(e.sessionRef,t.flags,n,e.contextFromFlags,{interactiveOnly:!0});return l(r.snapshotQuality)?{verified:!1,verificationWarning:`React Native overlay dismissal could not be verified because the post-dismiss accessibility tree is unreadable. Use screenshot as visual truth.`,nextCommand:`agent-device screenshot`}:o(r.nodes).detected?{verified:!1,verificationWarning:`React Native overlay is still detected after dismissal. Use screenshot --overlay-refs for visual evidence and report the overlay instead of pressing the warning body.`,nextCommand:`agent-device screenshot --overlay-refs`}:{verified:!0}}function x(e){return e.verified?`React Native overlay dismiss action sent and verified gone`:`React Native overlay dismiss action sent, but verification still detects an overlay`}export{h as handleReactNativeCommands};
+import{J as e,f as t,s as n}from"./sdk-contracts.js";import{A as r}from"./sdk-batch-runner.js";import{n as i}from"./catalog.js";import{r as a}from"./success-text.js";import{t as o}from"./overlay.js";import{j as s}from"./session-snapshot.js";import{s as c}from"./quality-warnings.js";import{et as l}from"./internal/daemon.js";import{o as u,u as d}from"./interaction-ref-policy.js";import{captureSnapshotForSession as f}from"./interaction.js";import{n as p,t as m}from"./touch-runtime2.js";async function h(r){r=d(r);let{req:a,sessionStore:s}=r;if(a.command!==i.reactNative)return null;let l=g(a.positionals??[]);if(!l.ok)return l.response;let u=r.sessionRef?s.requireCurrent(r.sessionRef):void 0;if(!u)return t();let m=await p({device:u.device,command:`press`,requiresCapture:!1,inspectFacts:r.inspectFacts,bindDevice:r.bindDevice,unavailableResponse:e=>n(`UNSUPPORTED_OPERATION`,`react-native dismiss-overlay is not supported on this device`,void 0,e.hint?{hint:e.hint}:void 0)});if(!m.ok)return m.response;try{let e=await f(r.sessionRef,a.flags,s,r.contextFromFlags,{interactiveOnly:!0});if(c(e.snapshotQuality))return v(e.snapshotQuality);let t=o(e.nodes),n=t.primaryAction;return n?await y(r,u,e,n,m.runtime):_(t.detected)}catch(t){return{ok:!1,error:e(t)}}}function g(e){return e.length===1&&e[0]===`dismiss-overlay`?{ok:!0}:{ok:!1,response:n(`INVALID_ARGS`,`react-native supports only: dismiss-overlay`)}}function _(e){return e?n(`COMMAND_FAILED`,`React Native overlay detected, but no safe dismiss target was found`,{hint:`Use screenshot --overlay-refs for visual evidence and report the overlay instead of pressing the warning body.`}):{ok:!0,data:{action:`dismiss-overlay`,detected:!1,dismissed:!1,...a(`No React Native overlay detected`)}}}function v(e){return n(`COMMAND_FAILED`,`React Native overlay state could not be determined because the accessibility tree is unreadable`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth; if an overlay is visible, report it or navigate with coordinates, then retry snapshot or dismiss-overlay on a readable screen.`})}async function y(e,t,i,o,c){let{req:d,sessionStore:f}=e,p=e.contextFromFlags(d.flags,t.appBundleId,t.trace?.outPath),h=m(c,p).tapPoint;if(!h)return n(`UNSUPPORTED_OPERATION`,`react-native dismiss-overlay is not supported on this device`);let g=Date.now();s(t);let _=await h(o.point),v=Date.now(),y=await b(e),S=r({...l(i.nodes),..._,action:`dismiss-overlay`,overlayAction:o.action,x:o.point.x,y:o.point.y,ref:o.ref,label:o.label,warning:o.warning,dismissed:!0,verified:y.verified,verificationRequired:!y.verified,verificationWarning:y.verificationWarning,nextCommand:y.nextCommand,...a(x(y))});return u({ref:e.sessionRef,sessionStore:f,command:d.command,positionals:d.positionals??[],flags:d.flags,result:S,responseData:S,actionStartedAt:g,actionFinishedAt:v})}async function b(e){let{req:t,sessionStore:n}=e,r=await f(e.sessionRef,t.flags,n,e.contextFromFlags,{interactiveOnly:!0});return c(r.snapshotQuality)?{verified:!1,verificationWarning:`React Native overlay dismissal could not be verified because the post-dismiss accessibility tree is unreadable. Use screenshot as visual truth.`,nextCommand:`agent-device screenshot`}:o(r.nodes).detected?{verified:!1,verificationWarning:`React Native overlay is still detected after dismissal. Use screenshot --overlay-refs for visual evidence and report the overlay instead of pressing the warning body.`,nextCommand:`agent-device screenshot --overlay-refs`}:{verified:!0}}function x(e){return e.verified?`React Native overlay dismiss action sent and verified gone`:`React Native overlay dismiss action sent, but verification still detects an overlay`}export{h as handleReactNativeCommands};

package/dist/src/record-runtime.js

@@ -1 +1 @@
-import{J as e,P as t}from"./sdk-contracts.js";import{l as n}from"./capture.js";import{v as r}from"./sdk-batch-runner.js";import{r as i}from"./diagnostics.js";import"./diagnostics2.js";import{P as a,j as o}from"./sdk-device.js";import{D as s,O as c,k as l}from"./sdk-batch.js";import{i as u,n as d}from"./recording-export-quality.js";import{n as f,r as p}from"./recording-scope.js";import{f as m,n as h}from"./dispatch-resolve.js";import{i as g}from"./output-path.js";import{i as _,n as v}from"./recording-stop-observation.js";import"./screen-recording-admission-ledger.js";import{a as y,t as b}from"./session-routing.js";import{r as x,s as S}from"./durable-capture-resource.js";import{a as C,c as w,i as ee,o as T,s as E,t as D}from"./screen-recording-resource-recovery.js";import{n as O}from"./request-runtime-binding.js";import{t as k}from"./telemetry.js";import A from"node:fs";import j from"node:path";const M=[`clientOutPath`,`telemetryPath`,`warning`,`overlayWarning`];function N(e){let{resourcePath:t,record:n}=F(e);if(n.status!==`decoded`)return{kind:`none`};if(I(e,n.envelope),n.envelope.lifecycle!==`completed`)return{kind:`open`,resourcePath:t};let r=L(n.envelope.metadata);return r===void 0?(i({level:`warn`,phase:`screen_recording_completed_manifest_unreplayable`,data:{resourcePath:t}}),{kind:`none`}):A.existsSync(r.outPath)?{kind:`completed`,completion:r}:{kind:`none`}}function P(e){let{record:t}=F(e);return t.status===`decoded`&&t.envelope.lifecycle===`completed`}function F(e){let t=w.resourcePath(e.sessionStore,e.sessionName);return{resourcePath:t,record:w.store.read(t)}}function I(e,n){if(n.sessionId!==e.sessionName)throw new t(`COMMAND_FAILED`,`Screen recording recovery record does not belong to the requested session`,{reason:`runtime-contract-invalid`});if(!a(n.device,o(e.device)))throw new t(`COMMAND_FAILED`,`Screen recording recovery device does not match the selected device`,{reason:`runtime-contract-invalid`})}function L(e){let t=e?.[ee];if(!(!r(t)||!R(t)||!z(t)||!B(t)))return t}function R(e){return V(e.outPath)&&V(e.backend)&&U(e.startedAt)&&U(e.completedAt)&&(e.capturedDurationMs===void 0||U(e.capturedDurationMs))&&f(e.scope)&&typeof e.showTouches==`boolean`&&typeof e.recordOnlySession==`boolean`}function z(e){return M.every(t=>H(e[t]))&&G(e.activeSessionApp)&&q(e.chunks)}function B(e){return(e.stopObservation===void 0||v(e.stopObservation))&&(e.nativePathDisposition===void 0||_(e.nativePathDisposition))}function V(e){return typeof e==`string`&&e.length>0}function H(e){return e===void 0||V(e)}function U(e){return typeof e==`number`&&Number.isFinite(e)}function W(e){return!r(e)||!V(e.bundleId)?!1:H(e.name)}function G(e){return e===void 0||W(e)}function K(e){return Array.isArray(e)&&e.every(e=>r(e)&&Number.isFinite(e.index)&&V(e.path)&&H(e.clientOutPath))}function q(e){return e===void 0||K(e)}function te(e){let r=n(`record`,e.flags);if(r)throw new t(`INVALID_ARGS`,r);let i=e.flags?.fps;if(i!==void 0&&(!Number.isInteger(i)||i<1||i>120))throw new t(`INVALID_ARGS`,`fps must be an integer between 1 and 120`);let a=u(e.flags?.quality);if(e.flags?.quality!==void 0&&a===void 0)throw new t(`INVALID_ARGS`,`quality must be one of: ${d.join(`, `)} (legacy numeric values 5-10 are accepted)`);return{scope:J(e.flags?.recordingScope),...i===void 0?{}:{fps:i},...a===void 0?{}:{exportQuality:a},showTouches:e.flags?.hideTouches!==!0,hideTouchesRequested:e.flags?.hideTouches===!0}}function J(e){if(e===void 0)return`app`;if(e===`app`||e===`device`||e===`system`)return e;throw new t(`INVALID_ARGS`,`record scope must be app, device, or system`)}function Y(e){return{ok:!1,error:{code:`INVALID_ARGS`,message:b(e)?`record start with app scope and an explicit session requires an active app session; run open <app> first, or use --scope device to record the full screen`:`record start defaults to app scope and requires an active app session; run open <app> first, or use --scope device to record the full screen`}}}function X(e,t,n){return{ok:!0,data:{recording:`started`,outPath:e.clientOutPath??n,sessionStateDir:t,recordingBackend:e.backend,recordingScope:e.scope,recordOnlySession:e.recordOnlySession,activeSessionApp:e.activeSessionApp,showTouches:e.showTouches}}}function Z(e){return{action:`start`,...e.clientOutPath?{requestedFileName:j.basename(e.clientOutPath)}:{},showTouches:e.showTouches}}function Q(e){return{ok:!1,error:{code:`UNSUPPORTED_OPERATION`,message:`record is not supported on this device`,hint:e.hint??`Select an Apple, Android, physical HarmonyOS, or web target that supports screen recording.`,details:{reason:e.reason}}}}function ne(e){let t=[re(e)];if(e.chunks&&e.chunks.length>1&&t.push(...e.chunks.slice(1).map(e=>({field:`chunkPath`,artifactType:`screen-recording-chunk`,path:e.path,localPath:e.clientOutPath,fileName:j.basename(e.clientOutPath??e.path)}))),e.telemetryPath){let n=e.clientOutPath?k(e.clientOutPath):void 0;t.push({field:`telemetryPath`,artifactType:`screen-recording-telemetry`,path:e.telemetryPath,localPath:n,fileName:j.basename(e.telemetryPath)})}return{ok:!0,data:{recording:`stopped`,outPath:e.outPath,telemetryPath:e.telemetryPath,artifacts:t,recordingBackend:e.backend,recordingScope:e.scope,recordOnlySession:e.recordOnlySession,activeSessionApp:e.activeSessionApp,durationMs:Math.max(0,e.completedAt-e.startedAt),...e.capturedDurationMs===void 0?{}:{capturedDurationMs:e.capturedDurationMs},...e.stopObservation===void 0?{}:{recorder:e.stopObservation.recorder},...e.nativePathDisposition===void 0?{}:{nativePathDisposition:e.nativePathDisposition},showTouches:e.showTouches,warning:e.warning,overlayWarning:e.overlayWarning,chunks:e.chunks?.map(e=>({index:e.index,path:e.clientOutPath??e.path}))}}}function re(e){return{field:`outPath`,artifactType:`screen-recording`,path:e.outPath,localPath:e.clientOutPath,fileName:j.basename(e.clientOutPath??e.outPath)}}async function $(t){try{return await ie(t)}catch(t){return{ok:!1,error:e(t)}}}async function ie(e){let{req:t,sessionName:n,sessionStore:r}=e,i=r.lookup(n),a=i?.session,{plan:o,scope:s}=ae(t,a);if(o.kind===`start`&&!p(s)&&!a)return Y(t);let c=await oe(e,i),{session:l}=c;return o.kind===`start`?await se(e,l,c.ref,te(t),o.use,c.needsReadiness):await de(e,l,c.ref,o.kind,c.needsReadiness)}function ae(e,t){let n=J(e.flags?.recordingScope);return{scope:n,plan:s({action:e.positionals?.[0],scope:n,hasLiveHandle:t?.screenRecording!==void 0})}}async function oe(e,t){let n=t?.session.device??await h(e.req.flags??{});return await e.retainDeviceExecutionLock(n.id),t?{session:e.sessionStore.requireCurrent(t),ref:t,needsReadiness:!1}:{session:me(e,n),needsReadiness:!0}}async function se(e,t,n,r,i,a){if(t.screenRecording)return{ok:!1,error:{code:`INVALID_ARGS`,message:`recording already in progress`}};let o=n?void 0:x(e.sessionStore,e.sessionName,t),s=n?S(e.sessionStore,n):o.binding;s.assertAdoptable();let l=await e.bindDevice(t.device,c);a&&await O(l);let u=l.facts.screenRecordingStart;if(!u.available)return Q(u);let d=await e.bindDevice(t.device,i),{fence:f,outputPaths:p}=ce(e,t);s.assertAdoptable();let h=await d.operations.screenRecordingStart(le(e,t,r,f,p.outputPath));await C({admissionLedger:e.admissionLedger,binding:s,device:t.device,owner:d.owner,fence:f,...h,throwIfCanceled:e.throwIfCanceled});let g=n??o.requireRef(),_=s.read();if(!_)throw TypeError(`Screen recording adoption did not publish a live handle`);let v=_.handle.inspect();return m(e.sessionStore,g,e.req,e.req.command,Z(v)),X(v,e.sessionStore.ensureSessionDir(e.sessionName),p.requestedPath)}function ce(e,t){let n=w.resourcePath(e.sessionStore,e.sessionName);return{fence:w.createNextFence({admissionLedger:e.admissionLedger,resourcePath:n,device:t.device}),outputPaths:g({requestedPath:e.req.positionals?.[1],platform:t.device.platform,cwd:e.req.meta?.cwd})}}function le(e,t,n,r,i){return{sessionId:e.sessionName,outputPath:i,clientOutputPath:e.req.meta?.clientArtifactPaths?.outPath,scope:n.scope,showTouches:n.showTouches,hideTouchesRequested:n.hideTouchesRequested,recordOnlySession:t.recordOnlySession===!0,activeSessionApp:ue(t),exportQuality:n.exportQuality,fps:n.fps,fence:r}}function ue(e){if(e.appBundleId)return{bundleId:e.appBundleId,...e.appName?{name:e.appName}:{}}}async function de(e,t,n,r,i){let a;try{a=r===`stop-live`?{completion:await T({intent:`capture`,binding:S(e.sessionStore,n)}),recordsSessionAction:!0}:await pe(e,t,i)}catch(r){throw fe(e,t,n),r}let o=a.completion,s=ne(o);return a.recordsSessionAction&&m(e.sessionStore,n,e.req,e.req.command,{action:`stop`,outPath:o.outPath,...o.clientOutPath?{requestedFileName:j.basename(o.clientOutPath)}:{},showTouches:o.showTouches}),t.recordOnlySession&&n&&e.sessionStore.retire(n),s}function fe(e,t,n){!t.recordOnlySession||!n||P(e)&&e.sessionStore.retire(n)}async function pe(e,n,r){let i=N({sessionName:e.sessionName,sessionStore:e.sessionStore,device:n.device});if(i.kind===`completed`)return{completion:i.completion,recordsSessionAction:!1};if(i.kind===`none`)throw new t(`INVALID_ARGS`,`no active recording`);return{completion:await E({resourcePath:i.resourcePath,scope:e.requestScope,acquireControl:async(t,i)=>{let a=await e.bindExactDevice(n.device,t.owner,t.fence,l,i);return r&&await O(a),D({runtime:a,dispose:async()=>{}})}}),recordsSessionAction:!0}}function me(e,t){return{name:e.sessionName,sessionScope:y(e.req),device:t,createdAt:Date.now(),recordOnlySession:!0,actions:[]}}export{$ as t};
+import{J as e,P as t}from"./sdk-contracts.js";import{l as n}from"./capture.js";import{v as r}from"./sdk-batch-runner.js";import{r as i}from"./diagnostics.js";import"./diagnostics2.js";import{I as a,N as o}from"./sdk-device.js";import{D as s,O as c,k as l}from"./sdk-batch.js";import{i as u,n as d}from"./recording-export-quality.js";import{n as f,r as p}from"./recording-scope.js";import{f as m,n as h}from"./dispatch-resolve.js";import{i as g}from"./output-path.js";import{i as _,n as v}from"./recording-stop-observation.js";import{r as y,s as b}from"./durable-capture-resource.js";import{a as x,c as S,i as C,o as w,s as T,t as E}from"./screen-recording-resource-recovery.js";import{n as D}from"./request-runtime-binding.js";import{K as O,U as ee}from"./internal/daemon.js";import{t as k}from"./telemetry.js";import A from"node:fs";import j from"node:path";const M=[`clientOutPath`,`telemetryPath`,`warning`,`overlayWarning`];function N(e){let{resourcePath:t,record:n}=F(e);if(n.status!==`decoded`)return{kind:`none`};if(I(e,n.envelope),n.envelope.lifecycle!==`completed`)return{kind:`open`,resourcePath:t};let r=L(n.envelope.metadata);return r===void 0?(i({level:`warn`,phase:`screen_recording_completed_manifest_unreplayable`,data:{resourcePath:t}}),{kind:`none`}):A.existsSync(r.outPath)?{kind:`completed`,completion:r}:{kind:`none`}}function P(e){let{record:t}=F(e);return t.status===`decoded`&&t.envelope.lifecycle===`completed`}function F(e){let t=S.resourcePath(e.sessionStore,e.sessionName);return{resourcePath:t,record:S.store.read(t)}}function I(e,n){if(n.sessionId!==e.sessionName)throw new t(`COMMAND_FAILED`,`Screen recording recovery record does not belong to the requested session`,{reason:`runtime-contract-invalid`});if(!a(n.device,o(e.device)))throw new t(`COMMAND_FAILED`,`Screen recording recovery device does not match the selected device`,{reason:`runtime-contract-invalid`})}function L(e){let t=e?.[C];if(!(!r(t)||!R(t)||!z(t)||!B(t)))return t}function R(e){return V(e.outPath)&&V(e.backend)&&U(e.startedAt)&&U(e.completedAt)&&(e.capturedDurationMs===void 0||U(e.capturedDurationMs))&&f(e.scope)&&typeof e.showTouches==`boolean`&&typeof e.recordOnlySession==`boolean`}function z(e){return M.every(t=>H(e[t]))&&G(e.activeSessionApp)&&q(e.chunks)}function B(e){return(e.stopObservation===void 0||v(e.stopObservation))&&(e.nativePathDisposition===void 0||_(e.nativePathDisposition))}function V(e){return typeof e==`string`&&e.length>0}function H(e){return e===void 0||V(e)}function U(e){return typeof e==`number`&&Number.isFinite(e)}function W(e){return!r(e)||!V(e.bundleId)?!1:H(e.name)}function G(e){return e===void 0||W(e)}function K(e){return Array.isArray(e)&&e.every(e=>r(e)&&Number.isFinite(e.index)&&V(e.path)&&H(e.clientOutPath))}function q(e){return e===void 0||K(e)}function te(e){let r=n(`record`,e.flags);if(r)throw new t(`INVALID_ARGS`,r);let i=e.flags?.fps;if(i!==void 0&&(!Number.isInteger(i)||i<1||i>120))throw new t(`INVALID_ARGS`,`fps must be an integer between 1 and 120`);let a=u(e.flags?.quality);if(e.flags?.quality!==void 0&&a===void 0)throw new t(`INVALID_ARGS`,`quality must be one of: ${d.join(`, `)} (legacy numeric values 5-10 are accepted)`);return{scope:J(e.flags?.recordingScope),...i===void 0?{}:{fps:i},...a===void 0?{}:{exportQuality:a},showTouches:e.flags?.hideTouches!==!0,hideTouchesRequested:e.flags?.hideTouches===!0}}function J(e){if(e===void 0)return`app`;if(e===`app`||e===`device`||e===`system`)return e;throw new t(`INVALID_ARGS`,`record scope must be app, device, or system`)}function Y(e){return{ok:!1,error:{code:`INVALID_ARGS`,message:ee(e)?`record start with app scope and an explicit session requires an active app session; run open <app> first, or use --scope device to record the full screen`:`record start defaults to app scope and requires an active app session; run open <app> first, or use --scope device to record the full screen`}}}function X(e,t,n){return{ok:!0,data:{recording:`started`,outPath:e.clientOutPath??n,sessionStateDir:t,recordingBackend:e.backend,recordingScope:e.scope,recordOnlySession:e.recordOnlySession,activeSessionApp:e.activeSessionApp,showTouches:e.showTouches}}}function Z(e){return{action:`start`,...e.clientOutPath?{requestedFileName:j.basename(e.clientOutPath)}:{},showTouches:e.showTouches}}function Q(e){return{ok:!1,error:{code:`UNSUPPORTED_OPERATION`,message:`record is not supported on this device`,hint:e.hint??`Select an Apple, Android, physical HarmonyOS, or web target that supports screen recording.`,details:{reason:e.reason}}}}function ne(e){let t=[re(e)];if(e.chunks&&e.chunks.length>1&&t.push(...e.chunks.slice(1).map(e=>({field:`chunkPath`,artifactType:`screen-recording-chunk`,path:e.path,localPath:e.clientOutPath,fileName:j.basename(e.clientOutPath??e.path)}))),e.telemetryPath){let n=e.clientOutPath?k(e.clientOutPath):void 0;t.push({field:`telemetryPath`,artifactType:`screen-recording-telemetry`,path:e.telemetryPath,localPath:n,fileName:j.basename(e.telemetryPath)})}return{ok:!0,data:{recording:`stopped`,outPath:e.outPath,telemetryPath:e.telemetryPath,artifacts:t,recordingBackend:e.backend,recordingScope:e.scope,recordOnlySession:e.recordOnlySession,activeSessionApp:e.activeSessionApp,durationMs:Math.max(0,e.completedAt-e.startedAt),...e.capturedDurationMs===void 0?{}:{capturedDurationMs:e.capturedDurationMs},...e.stopObservation===void 0?{}:{recorder:e.stopObservation.recorder},...e.nativePathDisposition===void 0?{}:{nativePathDisposition:e.nativePathDisposition},showTouches:e.showTouches,warning:e.warning,overlayWarning:e.overlayWarning,chunks:e.chunks?.map(e=>({index:e.index,path:e.clientOutPath??e.path}))}}}function re(e){return{field:`outPath`,artifactType:`screen-recording`,path:e.outPath,localPath:e.clientOutPath,fileName:j.basename(e.clientOutPath??e.outPath)}}async function $(t){try{return await ie(t)}catch(t){return{ok:!1,error:e(t)}}}async function ie(e){let{req:t,sessionName:n,sessionStore:r}=e,i=r.lookup(n),a=i?.session,{plan:o,scope:s}=ae(t,a);if(o.kind===`start`&&!p(s)&&!a)return Y(t);let c=await oe(e,i),{session:l}=c;return o.kind===`start`?await se(e,l,c.ref,te(t),o.use,c.needsReadiness):await de(e,l,c.ref,o.kind,c.needsReadiness)}function ae(e,t){let n=J(e.flags?.recordingScope);return{scope:n,plan:s({action:e.positionals?.[0],scope:n,hasLiveHandle:t?.screenRecording!==void 0})}}async function oe(e,t){let n=t?.session.device??await h(e.req.flags??{});return await e.retainDeviceExecutionLock(n.id),t?{session:e.sessionStore.requireCurrent(t),ref:t,needsReadiness:!1}:{session:me(e,n),needsReadiness:!0}}async function se(e,t,n,r,i,a){if(t.screenRecording)return{ok:!1,error:{code:`INVALID_ARGS`,message:`recording already in progress`}};let o=n?void 0:y(e.sessionStore,e.sessionName,t),s=n?b(e.sessionStore,n):o.binding;s.assertAdoptable();let l=await e.bindDevice(t.device,c);a&&await D(l);let u=l.facts.screenRecordingStart;if(!u.available)return Q(u);let d=await e.bindDevice(t.device,i),{fence:f,outputPaths:p}=ce(e,t);s.assertAdoptable();let h=await d.operations.screenRecordingStart(le(e,t,r,f,p.outputPath));await x({admissionLedger:e.admissionLedger,binding:s,device:t.device,owner:d.owner,fence:f,...h,throwIfCanceled:e.throwIfCanceled});let g=n??o.requireRef(),_=s.read();if(!_)throw TypeError(`Screen recording adoption did not publish a live handle`);let v=_.handle.inspect();return m(e.sessionStore,g,e.req,e.req.command,Z(v)),X(v,e.sessionStore.ensureSessionDir(e.sessionName),p.requestedPath)}function ce(e,t){let n=S.resourcePath(e.sessionStore,e.sessionName);return{fence:S.createNextFence({admissionLedger:e.admissionLedger,resourcePath:n,device:t.device}),outputPaths:g({requestedPath:e.req.positionals?.[1],platform:t.device.platform,cwd:e.req.meta?.cwd})}}function le(e,t,n,r,i){return{sessionId:e.sessionName,outputPath:i,clientOutputPath:e.req.meta?.clientArtifactPaths?.outPath,scope:n.scope,showTouches:n.showTouches,hideTouchesRequested:n.hideTouchesRequested,recordOnlySession:t.recordOnlySession===!0,activeSessionApp:ue(t),exportQuality:n.exportQuality,fps:n.fps,fence:r}}function ue(e){if(e.appBundleId)return{bundleId:e.appBundleId,...e.appName?{name:e.appName}:{}}}async function de(e,t,n,r,i){let a;try{a=r===`stop-live`?{completion:await w({intent:`capture`,binding:b(e.sessionStore,n)}),recordsSessionAction:!0}:await pe(e,t,i)}catch(r){throw fe(e,t,n),r}let o=a.completion,s=ne(o);return a.recordsSessionAction&&m(e.sessionStore,n,e.req,e.req.command,{action:`stop`,outPath:o.outPath,...o.clientOutPath?{requestedFileName:j.basename(o.clientOutPath)}:{},showTouches:o.showTouches}),t.recordOnlySession&&n&&e.sessionStore.retire(n),s}function fe(e,t,n){!t.recordOnlySession||!n||P(e)&&e.sessionStore.retire(n)}async function pe(e,n,r){let i=N({sessionName:e.sessionName,sessionStore:e.sessionStore,device:n.device});if(i.kind===`completed`)return{completion:i.completion,recordsSessionAction:!1};if(i.kind===`none`)throw new t(`INVALID_ARGS`,`no active recording`);return{completion:await T({resourcePath:i.resourcePath,scope:e.requestScope,acquireControl:async(t,i)=>{let a=await e.bindExactDevice(n.device,t.owner,t.fence,l,i);return r&&await D(a),E({runtime:a,dispose:async()=>{}})}}),recordsSessionAction:!0}}function me(e,t){return{name:e.sessionName,sessionScope:O(e.req),device:t,createdAt:Date.now(),recordOnlySession:!0,actions:[]}}export{$ as t};

package/dist/src/record-trace.js

@@ -1 +1 @@
-import{s as e}from"./sdk-contracts.js";import{f as t}from"./dispatch-resolve.js";import{t as n}from"./session-paths.js";import"./screen-recording-admission-ledger.js";import{t as r}from"./record-runtime.js";import i from"node:fs";import a from"node:path";function o(t){let n=(t.req.positionals?.[0]??``).toLowerCase();if(n!==`start`&&n!==`stop`)return e(`INVALID_ARGS`,`trace requires start|stop`);let r=t.sessionStore.lookup(t.sessionName);return r?n===`start`?s(t.req,t.sessionStore,r):c(t.req,t.sessionStore,r):e(`SESSION_NOT_FOUND`,`No active session`)}function s(r,o,s){let c=o.requireCurrent(s);if(c.trace)return e(`INVALID_ARGS`,`trace already in progress`);let l=n(r.positionals?.[1]??o.defaultTracePath(c));return i.mkdirSync(a.dirname(l),{recursive:!0}),i.appendFileSync(l,``),c.trace={outPath:l,startedAt:Date.now()},t(o,s,r,r.command,{action:`start`,outPath:l}),{ok:!0,data:{trace:`started`,outPath:l}}}function c(n,r,i){let o=r.requireCurrent(i);if(!o.trace)return e(`INVALID_ARGS`,`no active trace`);let s=l(o.trace.outPath,n.positionals?.[1]);o.trace=void 0,t(r,i,n,n.command,{action:`stop`,outPath:s});let c=n.meta?.clientArtifactPaths?.outPath??s;return{ok:!0,data:{trace:`stopped`,outPath:s,artifacts:[{field:`outPath`,artifactType:`trace-log`,path:s,localPath:c,fileName:a.basename(c)}]}}}function l(e,t){if(!t)return e;let r=n(t);return i.mkdirSync(a.dirname(r),{recursive:!0}),i.existsSync(e)?i.renameSync(e,r):i.appendFileSync(r,``),r}async function u(e){let{req:t,sessionName:n,sessionStore:i}=e,a=t.command;return a===`record`?r({req:t,sessionName:n,sessionStore:i,bindDevice:e.bindDevice,bindExactDevice:e.bindExactDevice,admissionLedger:e.admissionLedger,requestScope:e.requestScope,retainDeviceExecutionLock:e.retainDeviceExecutionLock,throwIfCanceled:e.throwIfCanceled}):a===`trace`?o({req:t,sessionName:n,sessionStore:i}):null}export{u as handleRecordTraceCommands};
+import{s as e}from"./sdk-contracts.js";import{f as t}from"./dispatch-resolve.js";import{t as n}from"./session-paths.js";import"./internal/daemon.js";import{t as r}from"./record-runtime.js";import i from"node:fs";import a from"node:path";function o(t){let n=(t.req.positionals?.[0]??``).toLowerCase();if(n!==`start`&&n!==`stop`)return e(`INVALID_ARGS`,`trace requires start|stop`);let r=t.sessionStore.lookup(t.sessionName);return r?n===`start`?s(t.req,t.sessionStore,r):c(t.req,t.sessionStore,r):e(`SESSION_NOT_FOUND`,`No active session`)}function s(r,o,s){let c=o.requireCurrent(s);if(c.trace)return e(`INVALID_ARGS`,`trace already in progress`);let l=n(r.positionals?.[1]??o.defaultTracePath(c));return i.mkdirSync(a.dirname(l),{recursive:!0}),i.appendFileSync(l,``),c.trace={outPath:l,startedAt:Date.now()},t(o,s,r,r.command,{action:`start`,outPath:l}),{ok:!0,data:{trace:`started`,outPath:l}}}function c(n,r,i){let o=r.requireCurrent(i);if(!o.trace)return e(`INVALID_ARGS`,`no active trace`);let s=l(o.trace.outPath,n.positionals?.[1]);o.trace=void 0,t(r,i,n,n.command,{action:`stop`,outPath:s});let c=n.meta?.clientArtifactPaths?.outPath??s;return{ok:!0,data:{trace:`stopped`,outPath:s,artifacts:[{field:`outPath`,artifactType:`trace-log`,path:s,localPath:c,fileName:a.basename(c)}]}}}function l(e,t){if(!t)return e;let r=n(t);return i.mkdirSync(a.dirname(r),{recursive:!0}),i.existsSync(e)?i.renameSync(e,r):i.appendFileSync(r,``),r}async function u(e){let{req:t,sessionName:n,sessionStore:i}=e,a=t.command;return a===`record`?r({req:t,sessionName:n,sessionStore:i,bindDevice:e.bindDevice,bindExactDevice:e.bindExactDevice,admissionLedger:e.admissionLedger,requestScope:e.requestScope,retainDeviceExecutionLock:e.retainDeviceExecutionLock,throwIfCanceled:e.throwIfCanceled}):a===`trace`?o({req:t,sessionName:n,sessionStore:i}):null}export{u as handleRecordTraceCommands};

package/dist/src/recording.js

@@ -1,3 +1,3 @@
-import{P as e}from"./sdk-contracts.js";import{n as t}from"./path-resolution.js";import"./file.js";import{t as n}from"./shared.js";const r=async({positionals:r,flags:o})=>{if(r[0]!==`contact-sheet`)return!1;if(r.length>2)throw new e(`INVALID_ARGS`,`record contact-sheet accepts one recording path: record contact-sheet <video.mp4> [--out <sheet.png>]`);let s=t(i(r[1])),c=typeof o.out==`string`?t(o.out):void 0,[{createAgentDevice:l,localCommandPolicy:u},{createLocalArtifactAdapter:d}]=await Promise.all([import(`./runtime10.js`),import(`./sdk-io.js`).then(e=>e.n)]),f=await l({backend:{platform:`ios`},artifacts:d(),sessions:{get:e=>({name:e}),set:()=>{}},policy:u()}).recording.contactSheet({video:{kind:`path`,path:s},...c?{out:{kind:`path`,path:c}}:{}});return await n(o,f,()=>a(f)),!0};function i(t){if(t)return t;throw new e(`INVALID_ARGS`,`record contact-sheet requires a recording path: record contact-sheet <video.mp4>`)}function a(e){let t=(e.durationMs/1e3).toFixed(e.durationMs%1e3==0?0:1),n=[e.path,`${e.cells.length} cells over ${t}s (${e.sampledFrameCount} sample times, ${e.decodedFrameCount} frames decoded)`];return e.warning?[...n,e.warning].join(`
+import{P as e}from"./sdk-contracts.js";import{n as t}from"./path-resolution.js";import"./file.js";import{t as n}from"./shared.js";const r=async({positionals:r,flags:o})=>{if(r[0]!==`contact-sheet`)return!1;if(r.length>2)throw new e(`INVALID_ARGS`,`record contact-sheet accepts one recording path: record contact-sheet <video.mp4> [--out <sheet.png>]`);let s=t(i(r[1])),c=typeof o.out==`string`?t(o.out):void 0,[{createAgentDevice:l,localCommandPolicy:u},{createLocalArtifactAdapter:d}]=await Promise.all([import(`./runtime11.js`),import(`./sdk-io.js`).then(e=>e.n)]),f=await l({backend:{platform:`ios`},artifacts:d(),sessions:{get:e=>({name:e}),set:()=>{}},policy:u()}).recording.contactSheet({video:{kind:`path`,path:s},...c?{out:{kind:`path`,path:c}}:{}});return await n(o,f,()=>a(f)),!0};function i(t){if(t)return t;throw new e(`INVALID_ARGS`,`record contact-sheet requires a recording path: record contact-sheet <video.mp4>`)}function a(e){let t=(e.durationMs/1e3).toFixed(e.durationMs%1e3==0?0:1),n=[e.path,`${e.cells.length} cells over ${t}s (${e.sampledFrameCount} sample times, ${e.decodedFrameCount} frames decoded)`];return e.warning?[...n,e.warning].join(`
 `):n.join(`
 `)}export{r as recordingCommand};