doc-detective 4.27.0 → 4.28.0

package/dist/index.cjs

@@ -632440,6 +632440,8 @@ function readInstalledRecord(ctx = {}) {
     };
     if (isPlainObject(parsed?.android))
       record.android = parsed.android;
+    if (isPlainObject(parsed?.ios))
+      record.ios = parsed.ios;
     if (isPlainObject(parsed?.tools))
       record.tools = parsed.tools;
     return record;
@@ -634500,12 +634502,12 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
   }
   if (!force && existing && isStillFresh(existing.latestCheckedAt, now)) {
     if (existing.latestKnownVersion === existing.installedVersion) {
-      const path28 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-      return { path: path28, version: existing.installedVersion, outdated: false };
+      const path29 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+      return { path: path29, version: existing.installedVersion, outdated: false };
     }
-    const path27 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+    const path28 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
     logger(`${name} ${existing.installedVersion} installed in ${cacheDir}; "${BROWSER_CHANNELS[name]}" channel is now ${existing.latestKnownVersion}. Run \`doc-detective install browsers ${name} --force\` to update.`, "warn");
-    return { path: path27, version: existing.installedVersion, outdated: true };
+    return { path: path28, version: existing.installedVersion, outdated: true };
   }
   let latest;
   try {
@@ -634513,8 +634515,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
   } catch (err) {
     logger(`Channel resolution for ${name} skipped: ${String(err)}`, "debug");
     if (existing) {
-      const path27 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-      return { path: path27, version: existing.installedVersion, outdated: false };
+      const path28 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+      return { path: path28, version: existing.installedVersion, outdated: false };
     }
     throw err;
   }
@@ -634525,8 +634527,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
       latestCheckedAt: now.toISOString()
     };
     writeInstalledRecord(record, ctx);
-    const path27 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-    return { path: path27, version: latest, outdated: false };
+    const path28 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+    return { path: path28, version: latest, outdated: false };
   }
   if (!force && existing) {
     record.browsers[name] = {
@@ -634536,8 +634538,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     };
     writeInstalledRecord(record, ctx);
     logger(`${name} ${existing.installedVersion} installed in ${cacheDir}; "${BROWSER_CHANNELS[name]}" channel is now ${latest}. Run \`doc-detective install browsers ${name} --force\` to update.`, "warn");
-    const path27 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-    return { path: path27, version: existing.installedVersion, outdated: true };
+    const path28 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+    return { path: path28, version: existing.installedVersion, outdated: true };
   }
   logger(`Installing ${name} ${latest} into ${cacheDir}`, "info");
   await browsersModule.install({
@@ -634545,9 +634547,9 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     buildId: latest,
     cacheDir
   });
-  let path26 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-  if (name === "chromedriver" && isAllowedDriverPath(path26)) {
-    let verify = await verifyDriverBinary(name, path26, { exec: deps.verifyExec });
+  let path27 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+  if (name === "chromedriver" && isAllowedDriverPath(path27)) {
+    let verify = await verifyDriverBinary(name, path27, { exec: deps.verifyExec });
     if (!verify.ok) {
       logger(`Installed ${name} ${latest} failed validation (${verify.error}); reinstalling once.`, "warn");
       try {
@@ -634556,11 +634558,11 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
         logger(`Failed to prune broken ${name} ${latest}: ${String(err)}`, "debug");
       }
       await browsersModule.install({ browser: name, buildId: latest, cacheDir });
-      path26 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-      verify = await verifyDriverBinary(name, path26, { exec: deps.verifyExec });
+      path27 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+      verify = await verifyDriverBinary(name, path27, { exec: deps.verifyExec });
     }
     if (!verify.ok) {
-      throw new Error(`${name} ${latest} is present but non-functional after a reinstall (${verify.error}). It may be a partial or corrupt download; delete ${path26} or reinstall.`);
+      throw new Error(`${name} ${latest} is present but non-functional after a reinstall (${verify.error}). It may be a partial or corrupt download; delete ${path27} or reinstall.`);
     }
   }
   if (existing && existing.installedVersion !== latest) {
@@ -634581,7 +634583,7 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     latestCheckedAt: now.toISOString()
   };
   writeInstalledRecord(record, ctx);
-  return { path: path26, version: latest, outdated: false };
+  return { path: path27, version: latest, outdated: false };
 }
 async function locateExecutable(browsersModule, name, buildId, cacheDir, platform) {
   if (typeof browsersModule.computeExecutablePath === "function") {
@@ -635027,10 +635029,10 @@ async function getOperation(definition = {}, operationId = "", responseCode = ""
   if (!operationId) {
     throw new Error("OperationId is required.");
   }
-  for (const path26 in definition.paths) {
-    for (const method in definition.paths[path26]) {
-      if (definition.paths[path26][method].operationId === operationId) {
-        const operation = definition.paths[path26][method];
+  for (const path27 in definition.paths) {
+    for (const method in definition.paths[path27]) {
+      if (definition.paths[path27][method].operationId === operationId) {
+        const operation = definition.paths[path27][method];
         if (!server) {
           if (definition.servers && definition.servers.length > 0) {
             server = definition.servers[0].url;
@@ -635038,9 +635040,9 @@ async function getOperation(definition = {}, operationId = "", responseCode = ""
             throw new Error("No server URL provided and no servers defined in the OpenAPI definition.");
           }
         }
-        const example = await compileExample(operation, server + path26, responseCode, exampleKey);
+        const example = await compileExample(operation, server + path27, responseCode, exampleKey);
         const schemas2 = getSchemas(operation, responseCode);
-        return { path: path26, method, definition: operation, schemas: schemas2, example };
+        return { path: path27, method, definition: operation, schemas: schemas2, example };
       }
     }
   }
@@ -635061,15 +635063,15 @@ function getSchemas(definition = {}, responseCode = "") {
   schemas2.response = definition.responses[responseCode].content[Object.keys(definition.responses[responseCode].content)[0]].schema;
   return schemas2;
 }
-async function compileExample(operation = {}, path26 = "", responseCode = "", exampleKey = "") {
+async function compileExample(operation = {}, path27 = "", responseCode = "", exampleKey = "") {
   if (!operation) {
     throw new Error("Operation is required.");
   }
-  if (!path26) {
+  if (!path27) {
     throw new Error("Path is required.");
   }
   let example = {
-    url: path26,
+    url: path27,
     request: { parameters: {}, headers: {}, body: {} },
     response: { headers: {}, body: {} }
   };
@@ -638931,7 +638933,7 @@ init_utils();
 
 // dist/core/tests.js
 var import_tree_kill3 = __toESM(require("tree-kill"), 1);
-var import_node_fs28 = __toESM(require("node:fs"), 1);
+var import_node_fs29 = __toESM(require("node:fs"), 1);
 init_loader();
 init_browsers();
 init_browserStepKeys();
@@ -639644,12 +639646,116 @@ async function resolveCloseTargets(driver, ref, opts = {}) {
 }
 
 // dist/core/tests/appSurface.js
-var import_node_fs16 = __toESM(require("node:fs"), 1);
-var import_node_path13 = __toESM(require("node:path"), 1);
-var import_node_child_process9 = require("node:child_process");
+var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_child_process10 = require("node:child_process");
 init_loader();
 init_appium();
 init_cacheDir();
+
+// dist/runtime/wdaProducts.js
+var import_node_child_process7 = require("node:child_process");
+var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_path12 = __toESM(require("node:path"), 1);
+init_cacheDir();
+init_loader();
+function parseXcodebuildVersion(output) {
+  const text = String(output ?? "");
+  const version = /^\s*Xcode\s+(\S+)/m.exec(text)?.[1];
+  const build = /^\s*Build version\s+(\S+)/m.exec(text)?.[1];
+  if (!version || !build)
+    return null;
+  return { version, build };
+}
+function getWdaRoot(ctx = {}) {
+  return import_node_path12.default.join(getCacheDir(ctx), "ios", "wda");
+}
+function sanitizeKeySegment(value) {
+  return (value || "unknown").trim().replace(/[^A-Za-z0-9._-]+/g, "-") || "unknown";
+}
+function computeWdaKey(xcode, driverVersion) {
+  return `xcode-${sanitizeKeySegment(xcode.version)}-${sanitizeKeySegment(xcode.build)}-driver-${sanitizeKeySegment(driverVersion)}`;
+}
+var RUNNER_APP_RELATIVE = import_node_path12.default.join("DerivedData", "Build", "Products", "Debug-iphonesimulator", "WebDriverAgentRunner-Runner.app");
+var PRODUCTS_MARKER = "products.json";
+var LAST_USED_STAMP = "last-used";
+function readProductsMarker(keyDir, fs28) {
+  try {
+    const parsed = JSON.parse(String(fs28.readFileSync(import_node_path12.default.join(keyDir, PRODUCTS_MARKER))));
+    if (typeof parsed?.key !== "string" || typeof parsed?.driverVersion !== "string") {
+      return null;
+    }
+    if (!fs28.existsSync(import_node_path12.default.join(keyDir, RUNNER_APP_RELATIVE)))
+      return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function touchLastUsed(keyDir, fs28, now) {
+  try {
+    fs28.writeFileSync(import_node_path12.default.join(keyDir, LAST_USED_STAMP), String(now()));
+  } catch {
+  }
+}
+var MIN_PREBUILT_WDA_DRIVER_MAJOR = 10;
+var cachedXcodeProbe;
+function probeXcodeVersionCached() {
+  if (cachedXcodeProbe === void 0) {
+    try {
+      const result = (0, import_node_child_process7.spawnSync)("xcodebuild", ["-version"], {
+        encoding: "utf8",
+        windowsHide: true,
+        timeout: 15e3
+      });
+      cachedXcodeProbe = result.status === 0 ? parseXcodebuildVersion(result.stdout) : null;
+    } catch {
+      cachedXcodeProbe = null;
+    }
+  }
+  return cachedXcodeProbe;
+}
+function locateManagedWda(options = {}) {
+  const { ctx = {}, fs: fs28 = import_node_fs14.default, platform = process.platform, probeXcode = probeXcodeVersionCached, resolveDriverVersion = resolveHeavyDepVersion, now = Date.now } = options;
+  try {
+    if (platform !== "darwin")
+      return null;
+    const driverVersion = resolveDriverVersion("appium-xcuitest-driver", ctx);
+    if (!driverVersion)
+      return null;
+    const driverMajor = Number.parseInt(driverVersion, 10);
+    if (!Number.isFinite(driverMajor) || driverMajor < MIN_PREBUILT_WDA_DRIVER_MAJOR) {
+      return null;
+    }
+    const xcode = probeXcode();
+    if (!xcode)
+      return null;
+    const wdaRoot = import_node_path12.default.normalize(options.wdaRootDir ?? getWdaRoot(ctx));
+    const key = computeWdaKey(xcode, driverVersion);
+    const keyDir = import_node_path12.default.join(wdaRoot, key);
+    const marker = readProductsMarker(keyDir, fs28);
+    if (!marker || marker.key !== key)
+      return null;
+    touchLastUsed(keyDir, fs28, now);
+    return { key, derivedDataPath: import_node_path12.default.join(keyDir, "DerivedData") };
+  } catch {
+    return null;
+  }
+}
+function applyManagedWdaCapabilities(capabilities, locateWda) {
+  const derivedDataPath = process.env.DOC_DETECTIVE_IOS_WDA_DERIVED_DATA_PATH;
+  if (derivedDataPath && derivedDataPath.trim()) {
+    capabilities["appium:derivedDataPath"] = derivedDataPath.trim();
+    return;
+  }
+  const managed = locateWda?.();
+  if (managed) {
+    capabilities["appium:derivedDataPath"] = managed.derivedDataPath;
+    capabilities["appium:usePrebuiltWDA"] = true;
+  }
+}
+
+// dist/core/tests/appSurface.js
 init_utils();
 
 // dist/core/tests/appWindows.js
@@ -640088,17 +640194,17 @@ async function closeAppWindow({ entry, selector }) {
 }
 
 // dist/core/tests/androidEmulator.js
-var import_node_child_process8 = require("node:child_process");
+var import_node_child_process9 = require("node:child_process");
 
 // dist/runtime/androidInstaller.js
-var import_node_fs15 = __toESM(require("node:fs"), 1);
+var import_node_fs16 = __toESM(require("node:fs"), 1);
 var import_node_os6 = __toESM(require("node:os"), 1);
-var import_node_path12 = __toESM(require("node:path"), 1);
-var import_node_child_process7 = require("node:child_process");
+var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_child_process8 = require("node:child_process");
 init_cacheDir();
 
 // dist/runtime/androidSdk.js
-var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_fs15 = __toESM(require("node:fs"), 1);
 init_cacheDir();
 function trimTrailingSeparators(s) {
   let end = s.length;
@@ -640142,7 +640248,7 @@ function usable(tools) {
 }
 function detectAndroidSdk(ctx = {}, deps = {}) {
   const env = deps.env ?? process.env;
-  const existsSync2 = deps.existsSync ?? import_node_fs14.default.existsSync;
+  const existsSync2 = deps.existsSync ?? import_node_fs15.default.existsSync;
   const platform = deps.platform ?? process.platform;
   const cacheRoot = safeCacheDir(ctx);
   const cacheAndroidSdk = deps.cacheAndroidSdk ?? (cacheRoot ? joinFor(platform, cacheRoot, "android-sdk") : void 0);
@@ -640248,11 +640354,11 @@ function resolveJavaHome(extractDir, entries, platform = process.platform) {
   const top = entries.find((e) => /jdk|jre/i.test(e));
   if (!top)
     return null;
-  const base = import_node_path12.default.join(extractDir, top);
-  return platform === "darwin" ? import_node_path12.default.join(base, "Contents", "Home") : base;
+  const base = import_node_path13.default.join(extractDir, top);
+  return platform === "darwin" ? import_node_path13.default.join(base, "Contents", "Home") : base;
 }
 function javaBinPath(javaHome, platform = process.platform) {
-  return import_node_path12.default.join(javaHome, "bin", platform === "win32" ? "java.exe" : "java");
+  return import_node_path13.default.join(javaHome, "bin", platform === "win32" ? "java.exe" : "java");
 }
 function cmdlineToolsUrl(platform) {
   const token = platform === "win32" ? "win" : platform === "darwin" ? "mac" : "linux";
@@ -640293,9 +640399,9 @@ function pickSystemImage(images, { osVersion, abi }) {
   return candidates.length > 0 ? candidates[0].pkg : null;
 }
 function listInstalledSystemImages(sdkRoot, deps = {}) {
-  const existsSync2 = deps.existsSync ?? import_node_fs15.default.existsSync;
-  const readdirSync = deps.readdirSync ?? ((p) => import_node_fs15.default.readdirSync(p));
-  const base = import_node_path12.default.join(sdkRoot, "system-images");
+  const existsSync2 = deps.existsSync ?? import_node_fs16.default.existsSync;
+  const readdirSync = deps.readdirSync ?? ((p) => import_node_fs16.default.readdirSync(p));
+  const base = import_node_path13.default.join(sdkRoot, "system-images");
   if (!existsSync2(base))
     return [];
   const out = [];
@@ -640308,14 +640414,14 @@ function listInstalledSystemImages(sdkRoot, deps = {}) {
   for (const api of apis) {
     let tags = [];
     try {
-      tags = readdirSync(import_node_path12.default.join(base, api));
+      tags = readdirSync(import_node_path13.default.join(base, api));
     } catch {
       continue;
     }
     for (const tag of tags) {
       let abis = [];
       try {
-        abis = readdirSync(import_node_path12.default.join(base, api, tag));
+        abis = readdirSync(import_node_path13.default.join(base, api, tag));
       } catch {
         continue;
       }
@@ -640331,22 +640437,22 @@ function systemImageDir(sdkRoot, pkg) {
   const parts = pkg.split(";");
   if (parts.length !== 4 || parts[0] !== "system-images")
     return null;
-  const base = import_node_path12.default.join(sdkRoot, "system-images");
-  const dir = import_node_path12.default.join(base, parts[1], parts[2], parts[3]);
-  const rel = import_node_path12.default.relative(base, dir);
-  if (rel === "" || rel.startsWith("..") || import_node_path12.default.isAbsolute(rel))
+  const base = import_node_path13.default.join(sdkRoot, "system-images");
+  const dir = import_node_path13.default.join(base, parts[1], parts[2], parts[3]);
+  const rel = import_node_path13.default.relative(base, dir);
+  if (rel === "" || rel.startsWith("..") || import_node_path13.default.isAbsolute(rel))
     return null;
   return dir;
 }
 function isSystemImageComplete(sdkRoot, pkg, deps = {}) {
-  const existsSync2 = deps.existsSync ?? import_node_fs15.default.existsSync;
+  const existsSync2 = deps.existsSync ?? import_node_fs16.default.existsSync;
   const dir = systemImageDir(sdkRoot, pkg);
   if (!dir)
     return false;
-  return SYSTEM_IMAGE_MARKERS.every((marker) => existsSync2(import_node_path12.default.join(dir, marker)));
+  return SYSTEM_IMAGE_MARKERS.every((marker) => existsSync2(import_node_path13.default.join(dir, marker)));
 }
 function wipeSystemImage(sdkRoot, pkg, deps = {}) {
-  const rmSync = deps.rmSync ?? import_node_fs15.default.rmSync;
+  const rmSync = deps.rmSync ?? import_node_fs16.default.rmSync;
   const dir = systemImageDir(sdkRoot, pkg);
   if (!dir)
     return;
@@ -640444,7 +640550,7 @@ async function runSdkInstallWithRetry(run2, command, args, opts = {}, deps = {})
 }
 function applyJavaEnv(javaHome, platform) {
   process.env.JAVA_HOME = javaHome;
-  const bin = import_node_path12.default.join(javaHome, "bin");
+  const bin = import_node_path13.default.join(javaHome, "bin");
   const sep = platform === "win32" ? ";" : ":";
   if (!(process.env.PATH ?? "").split(sep).includes(bin)) {
     process.env.PATH = `${bin}${sep}${process.env.PATH ?? ""}`;
@@ -640479,7 +640585,7 @@ async function installAndroid({ yes = false, force = false, dryRun = false, osVe
   const abi = hostAbi(deps.arch);
   const detect = deps.detect ?? detectAndroidSdk;
   const fsDeps = deps.fs ?? {};
-  const cacheSdkRoot = import_node_path12.default.join(getCacheDir(ctx), "android-sdk");
+  const cacheSdkRoot = import_node_path13.default.join(getCacheDir(ctx), "android-sdk");
   const detected = detect(ctx, {});
   const installedImages = detected ? listInstalledSystemImages(detected.sdkRoot, fsDeps) : [];
   const needAvailable = pickSystemImage(installedImages, { osVersion, abi }) === null;
@@ -640519,7 +640625,7 @@ async function installAndroid({ yes = false, force = false, dryRun = false, osVe
     logger("Android SDK licenses: https://developer.android.com/studio/terms", "info");
     return [{ kind: "android", assetId: "confirmation", action: "declined" }];
   }
-  const cacheJreRoot = import_node_path12.default.join(getCacheDir(ctx), "jre");
+  const cacheJreRoot = import_node_path13.default.join(getCacheDir(ctx), "jre");
   const java = await ensureJava({
     javaPresent: deps.javaPresent ?? realJavaPresent,
     cacheJreRoot,
@@ -640635,7 +640741,7 @@ function actionAssetId(a) {
 }
 function toolPath(sdkRoot, tool, platform) {
   const suffix = platform === "win32" ? ".bat" : "";
-  return import_node_path12.default.join(sdkRoot, "cmdline-tools", "latest", "bin", tool + suffix);
+  return import_node_path13.default.join(sdkRoot, "cmdline-tools", "latest", "bin", tool + suffix);
 }
 var SAFE_SHELL_TOKEN = /^[A-Za-z0-9 ._:;=\\/@+~()-]*$/;
 function winShellCommand(command, args) {
@@ -640670,16 +640776,16 @@ function nowIso() {
 }
 function realJavaPresent() {
   try {
-    const res = (0, import_node_child_process7.spawnSync)("java", ["-version"], { stdio: "ignore" });
+    const res = (0, import_node_child_process8.spawnSync)("java", ["-version"], { stdio: "ignore" });
     return res.status === 0;
   } catch {
     return false;
   }
 }
 function androidAvdHome() {
-  const home = import_node_path12.default.join(import_node_os6.default.homedir(), ".android", "avd");
+  const home = import_node_path13.default.join(import_node_os6.default.homedir(), ".android", "avd");
   try {
-    import_node_fs15.default.mkdirSync(home, { recursive: true });
+    import_node_fs16.default.mkdirSync(home, { recursive: true });
   } catch {
   }
   return home;
@@ -640690,12 +640796,12 @@ async function realRun(command, args, opts = {}) {
     ANDROID_AVD_HOME: androidAvdHome()
   };
   const useShell = process.platform === "win32" && /\.(bat|cmd)$/i.test(command);
-  const child = useShell ? (0, import_node_child_process7.spawn)(winShellCommand(command, args), {
+  const child = useShell ? (0, import_node_child_process8.spawn)(winShellCommand(command, args), {
     cwd: opts.cwd,
     stdio: ["pipe", "pipe", "pipe"],
     shell: true,
     env
-  }) : (0, import_node_child_process7.spawn)(command, args, {
+  }) : (0, import_node_child_process8.spawn)(command, args, {
     cwd: opts.cwd,
     stdio: ["pipe", "pipe", "pipe"],
     env
@@ -640713,20 +640819,20 @@ async function realRun(command, args, opts = {}) {
   });
 }
 function realDetectCachedJavaHome(cacheJreRoot) {
-  if (!import_node_fs15.default.existsSync(cacheJreRoot))
+  if (!import_node_fs16.default.existsSync(cacheJreRoot))
     return null;
-  const entries = import_node_fs15.default.readdirSync(cacheJreRoot);
+  const entries = import_node_fs16.default.readdirSync(cacheJreRoot);
   const home = resolveJavaHome(cacheJreRoot, entries, process.platform);
-  return home && import_node_fs15.default.existsSync(javaBinPath(home)) ? home : null;
+  return home && import_node_fs16.default.existsSync(javaBinPath(home)) ? home : null;
 }
 async function realBootstrapJava(cacheJreRoot) {
   const url = jreDownloadUrl();
-  const tmpDir = import_node_fs15.default.mkdtempSync(import_node_path12.default.join(import_node_os6.default.tmpdir(), "dd-jre-"));
+  const tmpDir = import_node_fs16.default.mkdtempSync(import_node_path13.default.join(import_node_os6.default.tmpdir(), "dd-jre-"));
   try {
-    const archive = import_node_path12.default.join(tmpDir, jreArchiveFilename());
+    const archive = import_node_path13.default.join(tmpDir, jreArchiveFilename());
     await downloadFile(url, archive);
-    import_node_fs15.default.rmSync(cacheJreRoot, { recursive: true, force: true });
-    import_node_fs15.default.mkdirSync(cacheJreRoot, { recursive: true });
+    import_node_fs16.default.rmSync(cacheJreRoot, { recursive: true, force: true });
+    import_node_fs16.default.mkdirSync(cacheJreRoot, { recursive: true });
     await extractZip(archive, cacheJreRoot);
     const home = realDetectCachedJavaHome(cacheJreRoot);
     if (!home) {
@@ -640734,31 +640840,31 @@ async function realBootstrapJava(cacheJreRoot) {
     }
     return home;
   } finally {
-    import_node_fs15.default.rmSync(tmpDir, { recursive: true, force: true });
+    import_node_fs16.default.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 async function realBootstrap(url, destSdkRoot) {
-  const tmpDir = import_node_fs15.default.mkdtempSync(import_node_path12.default.join(import_node_os6.default.tmpdir(), "dd-android-cli-"));
+  const tmpDir = import_node_fs16.default.mkdtempSync(import_node_path13.default.join(import_node_os6.default.tmpdir(), "dd-android-cli-"));
   try {
-    const zipPath = import_node_path12.default.join(tmpDir, "cmdline-tools.zip");
+    const zipPath = import_node_path13.default.join(tmpDir, "cmdline-tools.zip");
     await downloadFile(url, zipPath);
-    const extractDir = import_node_path12.default.join(tmpDir, "extracted");
-    import_node_fs15.default.mkdirSync(extractDir, { recursive: true });
+    const extractDir = import_node_path13.default.join(tmpDir, "extracted");
+    import_node_fs16.default.mkdirSync(extractDir, { recursive: true });
     await extractZip(zipPath, extractDir);
-    const inner = import_node_path12.default.join(extractDir, "cmdline-tools");
-    if (!import_node_fs15.default.existsSync(inner)) {
+    const inner = import_node_path13.default.join(extractDir, "cmdline-tools");
+    if (!import_node_fs16.default.existsSync(inner)) {
       throw new Error("unexpected command-line tools archive layout (no top-level cmdline-tools/)");
     }
-    const dest = import_node_path12.default.join(destSdkRoot, "cmdline-tools", "latest");
-    import_node_fs15.default.mkdirSync(import_node_path12.default.dirname(dest), { recursive: true });
-    import_node_fs15.default.rmSync(dest, { recursive: true, force: true });
+    const dest = import_node_path13.default.join(destSdkRoot, "cmdline-tools", "latest");
+    import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(dest), { recursive: true });
+    import_node_fs16.default.rmSync(dest, { recursive: true, force: true });
     try {
-      import_node_fs15.default.renameSync(inner, dest);
+      import_node_fs16.default.renameSync(inner, dest);
     } catch {
-      import_node_fs15.default.cpSync(inner, dest, { recursive: true });
+      import_node_fs16.default.cpSync(inner, dest, { recursive: true });
     }
   } finally {
-    import_node_fs15.default.rmSync(tmpDir, { recursive: true, force: true });
+    import_node_fs16.default.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 
@@ -640987,7 +641093,7 @@ async function teardownDeviceRegistry(registry, kill4) {
 }
 function runTool(command, args, timeout = 3e4, env) {
   return new Promise((resolve) => {
-    (0, import_node_child_process8.execFile)(command, args, { timeout, env }, (error, stdout) => {
+    (0, import_node_child_process9.execFile)(command, args, { timeout, env }, (error, stdout) => {
       resolve({ code: error?.code ?? 0, stdout: String(stdout ?? "") });
     });
   });
@@ -641031,11 +641137,11 @@ async function realCreateAvd(avdmanagerPath, { name, systemImage, device }, env)
     "--force"
   ];
   await new Promise((resolve, reject) => {
-    const child = useShell ? (0, import_node_child_process8.spawn)(winShellCommand(avdmanagerPath, args), {
+    const child = useShell ? (0, import_node_child_process9.spawn)(winShellCommand(avdmanagerPath, args), {
       stdio: ["pipe", "ignore", "pipe"],
       shell: true,
       env
-    }) : (0, import_node_child_process8.spawn)(avdmanagerPath, args, { stdio: ["pipe", "ignore", "pipe"], env });
+    }) : (0, import_node_child_process9.spawn)(avdmanagerPath, args, { stdio: ["pipe", "ignore", "pipe"], env });
     let err = "";
     child.stderr?.on("data", (d) => err += d.toString());
     child.on("error", reject);
@@ -641048,7 +641154,7 @@ async function realBootEmulator(emulatorPath, adbPath, desc, port, env, timeout
   const udid = udidForPort(port);
   const bootDesc = { ...desc, headless: effectiveHeadless(desc) };
   const bootArgs = emulatorBootArgs(bootDesc, port);
-  const child = (0, import_node_child_process8.spawn)(emulatorPath, bootArgs, {
+  const child = (0, import_node_child_process9.spawn)(emulatorPath, bootArgs, {
     detached: false,
     stdio: ["ignore", "pipe", "pipe"],
     env
@@ -641088,7 +641194,7 @@ function buildAcquireDeviceDeps(sdk, abi, log3) {
   const emulator = sdk.emulator ?? "emulator";
   const avdmanager = sdk.avdmanager ?? "avdmanager";
   const javaPresent = () => {
-    const { status } = (0, import_node_child_process8.spawnSync)("java", ["-version"], { stdio: "ignore" });
+    const { status } = (0, import_node_child_process9.spawnSync)("java", ["-version"], { stdio: "ignore" });
     return status === 0;
   };
   const env = {
@@ -641736,7 +641842,7 @@ var APP_DRIVER_PLATFORMS = {
       if (extras?.udid)
         capabilities["appium:udid"] = extras.udid;
       if (descriptor.install) {
-        capabilities["appium:app"] = import_node_path13.default.resolve(descriptor.install);
+        capabilities["appium:app"] = import_node_path14.default.resolve(descriptor.install);
       }
       if (descriptor.activity) {
         capabilities["appium:appActivity"] = descriptor.activity;
@@ -641779,20 +641885,17 @@ var APP_DRIVER_PLATFORMS = {
       if (classifyAppIdentifier(appId) === "id") {
         capabilities["appium:bundleId"] = appId;
       } else {
-        capabilities["appium:app"] = import_node_path13.default.resolve(appId);
+        capabilities["appium:app"] = import_node_path14.default.resolve(appId);
       }
       if (descriptor.install) {
-        capabilities["appium:app"] = import_node_path13.default.resolve(descriptor.install);
+        capabilities["appium:app"] = import_node_path14.default.resolve(descriptor.install);
       }
       if (extras?.udid)
         capabilities["appium:udid"] = extras.udid;
       const timeout = descriptor.timeout ?? 6e4;
       capabilities["appium:wdaLaunchTimeout"] = Math.max(timeout, 12e4);
       capabilities["appium:wdaConnectionTimeout"] = Math.max(timeout, 12e4);
-      const derivedDataPath = process.env.DOC_DETECTIVE_IOS_WDA_DERIVED_DATA_PATH;
-      if (derivedDataPath && derivedDataPath.trim()) {
-        capabilities["appium:derivedDataPath"] = derivedDataPath.trim();
-      }
+      applyManagedWdaCapabilities(capabilities, extras?.locateWda);
       return capabilities;
     },
     unsupportedFields: [
@@ -641852,18 +641955,18 @@ function resolveAppSurfaceRef(surface, appSession) {
   return null;
 }
 function invalidateStaleAppiumManifest(home, driverPackage) {
-  const cacheDir = import_node_path13.default.join(home, "node_modules", ".cache", "appium");
+  const cacheDir = import_node_path14.default.join(home, "node_modules", ".cache", "appium");
   try {
-    const manifest = import_node_fs16.default.readFileSync(import_node_path13.default.join(cacheDir, "extensions.yaml"), "utf8");
+    const manifest = import_node_fs17.default.readFileSync(import_node_path14.default.join(cacheDir, "extensions.yaml"), "utf8");
     if (!manifest.includes(driverPackage)) {
-      import_node_fs16.default.rmSync(cacheDir, { recursive: true, force: true });
+      import_node_fs17.default.rmSync(cacheDir, { recursive: true, force: true });
     }
   } catch {
   }
 }
 async function probeMacAccessibility() {
   return await new Promise((resolve) => {
-    (0, import_node_child_process9.execFile)("osascript", [
+    (0, import_node_child_process10.execFile)("osascript", [
       "-l",
       "JavaScript",
       "-e",
@@ -641879,7 +641982,7 @@ async function probeMacAccessibility() {
 function probeIosToolchain(deps = {}) {
   const platform = deps.platform ?? process.platform;
   const run2 = deps.run ?? ((command, args) => {
-    const result = (0, import_node_child_process9.spawnSync)(command, args, {
+    const result = (0, import_node_child_process10.spawnSync)(command, args, {
       encoding: "utf8",
       windowsHide: true,
       // xcrun/simctl gets 2 minutes for the cold CoreSimulator warm-up;
@@ -642170,7 +642273,8 @@ async function startAppSurface({ config, step, appSession, platform, serverDeps
     const deviceSession = sessions.get(deviceName);
     if (!deviceSession) {
       const capabilities = platformDriver.buildCapabilities(descriptor, appId, {
-        udid: acquired.entry.udid
+        udid: acquired.entry.udid,
+        locateWda: serverDeps.locateWda ?? (() => locateManagedWda({ ctx: { cacheDir: config?.cacheDir } }))
       });
       Object.assign(capabilities, descriptor.driverOptions ?? {});
       try {
@@ -642189,7 +642293,7 @@ async function startAppSurface({ config, step, appSession, platform, serverDeps
       driver = deviceSession.driver;
       try {
         if (descriptor.install)
-          await driver.installApp(import_node_path13.default.resolve(descriptor.install));
+          await driver.installApp(import_node_path14.default.resolve(descriptor.install));
         if (descriptor.activity) {
           await driver.execute("mobile: startActivity", {
             appPackage: appId,
@@ -642355,7 +642459,7 @@ function defaultForceKill(pid) {
 function queryWindowsProcessTable() {
   return new Promise((resolve, reject) => {
     const script = 'Get-CimInstance Win32_Process | ForEach-Object { "$($_.ProcessId),$($_.ParentProcessId)" }';
-    (0, import_node_child_process9.execFile)("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { windowsHide: true, timeout: 1e4, maxBuffer: 16 * 1024 * 1024 }, (error, stdout) => {
+    (0, import_node_child_process10.execFile)("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { windowsHide: true, timeout: 1e4, maxBuffer: 16 * 1024 * 1024 }, (error, stdout) => {
       if (error)
         return reject(error);
       const rows = [];
@@ -642830,10 +642934,10 @@ init_validate();
 init_loader();
 
 // dist/core/tests/ffmpegRecorder.js
-var import_node_child_process10 = require("node:child_process");
+var import_node_child_process11 = require("node:child_process");
 var import_node_os7 = __toESM(require("node:os"), 1);
-var import_node_path14 = __toESM(require("node:path"), 1);
-var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_fs18 = __toESM(require("node:fs"), 1);
 var import_node_crypto6 = __toESM(require("node:crypto"), 1);
 init_loader();
 init_utils();
@@ -642912,7 +643016,7 @@ function browserCaptureTitle(contextId) {
   return `RECORD_ME_${safeContextId(contextId)}`;
 }
 function browserDownloadDir(contextId) {
-  return import_node_path14.default.join(import_node_os7.default.tmpdir(), "doc-detective", "recordings", safeContextId(contextId));
+  return import_node_path15.default.join(import_node_os7.default.tmpdir(), "doc-detective", "recordings", safeContextId(contextId));
 }
 function engineFields(record) {
   const engine = record && typeof record === "object" ? record.engine : void 0;
@@ -643051,11 +643155,11 @@ async function resolveCropGeometry({ driver, target }) {
   return null;
 }
 function ffmpegPathEnv(ffmpegPath, baseEnv = process.env) {
-  const dir = import_node_path14.default.dirname(ffmpegPath);
+  const dir = import_node_path15.default.dirname(ffmpegPath);
   const pathKey = Object.keys(baseEnv).find((k) => k.toUpperCase() === "PATH") ?? "PATH";
   const existing = baseEnv[pathKey];
   return {
-    [pathKey]: existing ? `${dir}${import_node_path14.default.delimiter}${existing}` : dir
+    [pathKey]: existing ? `${dir}${import_node_path15.default.delimiter}${existing}` : dir
   };
 }
 function parseCaptureFrameSize(stderr) {
@@ -643079,7 +643183,7 @@ async function detectDisplayPointSize() {
   if (process.platform !== "darwin")
     return null;
   return await new Promise((resolve) => {
-    (0, import_node_child_process10.execFile)("osascript", [
+    (0, import_node_child_process11.execFile)("osascript", [
       "-l",
       "JavaScript",
       "-e",
@@ -643225,7 +643329,7 @@ async function detectMacScreenIndex(ffmpegPath) {
       resolve(v);
     };
     try {
-      proc = (0, import_node_child_process10.spawn)(ffmpegPath, ["-f", "avfoundation", "-list_devices", "true", "-i", ""], { stdio: ["ignore", "ignore", "pipe"] });
+      proc = (0, import_node_child_process11.spawn)(ffmpegPath, ["-f", "avfoundation", "-list_devices", "true", "-i", ""], { stdio: ["ignore", "ignore", "pipe"] });
       proc.stderr?.on("data", (d) => {
         out += d.toString();
       });
@@ -643254,7 +643358,7 @@ async function detectX11ScreenSize(display) {
     };
     try {
       const env = display ? { ...process.env, DISPLAY: display } : process.env;
-      proc = (0, import_node_child_process10.spawn)("xdpyinfo", [], { env, stdio: ["ignore", "pipe", "ignore"] });
+      proc = (0, import_node_child_process11.spawn)("xdpyinfo", [], { env, stdio: ["ignore", "pipe", "ignore"] });
       proc.stdout?.on("data", (d) => {
         out += d.toString();
       });
@@ -643272,7 +643376,7 @@ async function detectX11ScreenSize(display) {
 async function checkSystemBinary(name) {
   return new Promise((resolve) => {
     try {
-      const proc = (0, import_node_child_process10.spawn)(name, ["-help"], { stdio: "ignore" });
+      const proc = (0, import_node_child_process11.spawn)(name, ["-help"], { stdio: "ignore" });
       proc.on("error", () => resolve(false));
       proc.on("close", () => resolve(true));
     } catch {
@@ -643289,7 +643393,7 @@ async function startXvfb(display, opts = {}) {
   const w = opts.width ?? defW;
   const h = opts.height ?? defH;
   const startMs = Date.now();
-  const proc = (0, import_node_child_process10.spawn)("Xvfb", [display, "-screen", "0", `${w}x${h}x24`, "-nolisten", "tcp"], { stdio: "ignore" });
+  const proc = (0, import_node_child_process11.spawn)("Xvfb", [display, "-screen", "0", `${w}x${h}x24`, "-nolisten", "tcp"], { stdio: "ignore" });
   let spawnErr = null;
   proc.on("error", (e) => {
     spawnErr = e;
@@ -643301,7 +643405,7 @@ async function startXvfb(display, opts = {}) {
     if (proc.exitCode !== null)
       throw new Error(`Xvfb exited early on ${display} (code ${proc.exitCode})`);
     try {
-      if (import_node_fs17.default.statSync(lock).mtimeMs >= startMs)
+      if (import_node_fs18.default.statSync(lock).mtimeMs >= startMs)
         return proc;
     } catch {
     }
@@ -643573,11 +643677,11 @@ function hasUnresolvedMetaReference(expression, context) {
   }
   return false;
 }
-function getMetaValue(path26, context) {
+function getMetaValue(path27, context) {
   if (!context) {
     return void 0;
   }
-  const [basePath, jsonPointer] = path26.split("#");
+  const [basePath, jsonPointer] = path27.split("#");
   const resolvedPath = resolvePathTemplateVariables(basePath, context);
   let value = getNestedProperty(context, resolvedPath);
   if (jsonPointer && value) {
@@ -643594,9 +643698,9 @@ function getMetaValue(path26, context) {
   }
   return value;
 }
-function resolvePathTemplateVariables(path26, context) {
+function resolvePathTemplateVariables(path27, context) {
   const templateRegex = /\{\{(\w+)\}\}/g;
-  return path26.replace(templateRegex, (match, varName) => {
+  return path27.replace(templateRegex, (match, varName) => {
     if (context && context.id && varName === "id") {
       return context.id;
     }
@@ -643633,10 +643737,10 @@ async function resolveEmbeddedExpressions(str, context) {
   parts.push(str.slice(lastIdx));
   return parts.join("");
 }
-function getNestedProperty(obj, path26) {
-  if (!obj || !path26)
+function getNestedProperty(obj, path27) {
+  if (!obj || !path27)
     return void 0;
-  const parts = path26.split(".");
+  const parts = path27.split(".");
   let current = obj;
   for (const part of parts) {
     if (current === null || current === void 0)
@@ -645317,8 +645421,8 @@ async function startBackgroundProcessSurface({ config, descriptor, processRegist
 }
 
 // dist/core/tests/runShell.js
-var import_node_fs18 = __toESM(require("node:fs"), 1);
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_path16 = __toESM(require("node:path"), 1);
 async function runShell({ config, step, driver, processRegistry }) {
   const result = {
     status: "PASS",
@@ -645431,19 +645535,19 @@ async function runShell({ config, step, driver, processRegistry }) {
     descriptions.push(stdioMatched ? `Found expected output (${step.runShell.stdio}) in stdio.` : isRegex ? `Couldn't find expected output (${step.runShell.stdio}) in actual output (stdout or stderr).` : `Couldn't find expected output (${step.runShell.stdio}) in stdio (stdout or stderr).`);
   }
   if (step.runShell.path) {
-    const dir = import_node_path15.default.dirname(step.runShell.path);
-    if (!import_node_fs18.default.existsSync(dir)) {
-      import_node_fs18.default.mkdirSync(dir, { recursive: true });
+    const dir = import_node_path16.default.dirname(step.runShell.path);
+    if (!import_node_fs19.default.existsSync(dir)) {
+      import_node_fs19.default.mkdirSync(dir, { recursive: true });
     }
     let filePath = step.runShell.path;
     log(config, "debug", `Saving stdio to file: ${filePath}`);
-    if (!import_node_fs18.default.existsSync(filePath)) {
-      import_node_fs18.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+    if (!import_node_fs19.default.existsSync(filePath)) {
+      import_node_fs19.default.writeFileSync(filePath, result.outputs.stdio.stdout);
     } else {
       if (step.runShell.overwrite == "false") {
         descriptions.push(`Didn't save output. File already exists.`);
       }
-      const existingFile = import_node_fs18.default.readFileSync(filePath, "utf8");
+      const existingFile = import_node_fs19.default.readFileSync(filePath, "utf8");
       const fractionalDiff = calculateFractionalDifference(existingFile, result.outputs.stdio.stdout);
       log(config, "debug", `Fractional difference: ${fractionalDiff}`);
       result.outputs.variation = fractionalDiff;
@@ -645453,13 +645557,13 @@ async function runShell({ config, step, driver, processRegistry }) {
       });
       if (fractionalDiff > step.runShell.maxVariation) {
         if (step.runShell.overwrite == "aboveVariation") {
-          import_node_fs18.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+          import_node_fs19.default.writeFileSync(filePath, result.outputs.stdio.stdout);
           descriptions.push(`Saved output to file.`);
         }
         descriptions.push(`The difference between the existing output and the new output (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.runShell.maxVariation}).`);
       } else {
         if (step.runShell.overwrite == "true") {
-          import_node_fs18.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+          import_node_fs19.default.writeFileSync(filePath, result.outputs.stdio.stdout);
           descriptions.push(`Saved output to file.`);
         }
         descriptions.push(`Saved-file variation (${fractionalDiff.toFixed(2)}) is within the max accepted variation (${step.runShell.maxVariation}).`);
@@ -645806,8 +645910,8 @@ async function swipeSurface({ config, step, driver, appSession }) {
 // dist/core/tests/saveScreenshot.js
 init_validate();
 init_utils();
-var import_node_path16 = __toESM(require("node:path"), 1);
-var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
+var import_node_fs20 = __toESM(require("node:fs"), 1);
 init_loader();
 var _pngjs = null;
 var _sharp = null;
@@ -645958,7 +646062,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
   if (typeof step.screenshot.path === "undefined") {
     step.screenshot.path = `${step.stepId}.png`;
     if (step.screenshot.directory) {
-      step.screenshot.path = import_node_path16.default.resolve(step.screenshot.directory, step.screenshot.path);
+      step.screenshot.path = import_node_path17.default.resolve(step.screenshot.directory, step.screenshot.path);
     }
   }
   step.screenshot = {
@@ -645994,17 +646098,17 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     } catch {
       urlPathname = originalUrlPath;
     }
-    const rawBase = import_node_path16.default.basename(urlPathname.split("?")[0].split("#")[0].replace(/\\/g, "/"));
+    const rawBase = import_node_path17.default.basename(urlPathname.split("?")[0].split("#")[0].replace(/\\/g, "/"));
     const safeBase = sanitizeFilesystemName(rawBase, `${step.stepId}.png`);
-    dir = import_node_path16.default.join(process.cwd(), "doc-detective-runs", getOrInitRunTimestamp(config));
-    if (!import_node_fs19.default.existsSync(dir)) {
-      import_node_fs19.default.mkdirSync(dir, { recursive: true });
+    dir = import_node_path17.default.join(process.cwd(), "doc-detective-runs", getOrInitRunTimestamp(config));
+    if (!import_node_fs20.default.existsSync(dir)) {
+      import_node_fs20.default.mkdirSync(dir, { recursive: true });
     }
     const captureId = `${step.stepId || "screenshot"}_${Date.now()}`;
-    filePath = import_node_path16.default.join(dir, `${captureId}_${safeBase}`);
-    const resolvedDir = import_node_path16.default.resolve(dir);
-    const resolvedFile = import_node_path16.default.resolve(filePath);
-    if (!resolvedFile.startsWith(resolvedDir + import_node_path16.default.sep)) {
+    filePath = import_node_path17.default.join(dir, `${captureId}_${safeBase}`);
+    const resolvedDir = import_node_path17.default.resolve(dir);
+    const resolvedFile = import_node_path17.default.resolve(filePath);
+    if (!resolvedFile.startsWith(resolvedDir + import_node_path17.default.sep)) {
       result.status = "FAIL";
       result.description = `Refusing to write screenshot outside run folder: ${resolvedFile}`;
       return result;
@@ -646013,11 +646117,11 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       log(config, "debug", `Screenshot path is a URL (${redactedUrl}); overwrite is ignored, running comparison only.`);
     }
   } else {
-    dir = import_node_path16.default.dirname(step.screenshot.path);
-    if (!import_node_fs19.default.existsSync(dir)) {
-      import_node_fs19.default.mkdirSync(dir, { recursive: true });
+    dir = import_node_path17.default.dirname(step.screenshot.path);
+    if (!import_node_fs20.default.existsSync(dir)) {
+      import_node_fs20.default.mkdirSync(dir, { recursive: true });
     }
-    if (import_node_fs19.default.existsSync(filePath)) {
+    if (import_node_fs20.default.existsSync(filePath)) {
       if (step.screenshot.overwrite == "false") {
         result.status = "SKIPPED";
         result.description = `File already exists: ${filePath}`;
@@ -646025,7 +646129,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         return result;
       } else {
         existFilePath = filePath;
-        filePath = import_node_path16.default.join(dir, `${step.stepId}_${Date.now()}.png`);
+        filePath = import_node_path17.default.join(dir, `${step.stepId}_${Date.now()}.png`);
       }
     }
   }
@@ -646127,8 +646231,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
   } catch (error) {
     result.status = "FAIL";
     result.description = `Couldn't save screenshot. ${error}`;
-    if (existFilePath && filePath !== existFilePath && import_node_fs19.default.existsSync(filePath)) {
-      import_node_fs19.default.unlinkSync(filePath);
+    if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
+      import_node_fs20.default.unlinkSync(filePath);
     }
     return result;
   } finally {
@@ -646183,7 +646287,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     rect.width = clamped.width;
     rect.height = clamped.height;
     log(config, "debug", { padded_rect: rect });
-    const croppedPath = import_node_path16.default.join(dir, `cropped_${step.stepId || Date.now()}.png`);
+    const croppedPath = import_node_path17.default.join(dir, `cropped_${step.stepId || Date.now()}.png`);
     try {
       await sharp(filePath).extract({
         left: rect.x,
@@ -646191,12 +646295,12 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         width: rect.width,
         height: rect.height
       }).toFile(croppedPath);
-      import_node_fs19.default.renameSync(croppedPath, filePath);
+      import_node_fs20.default.renameSync(croppedPath, filePath);
     } catch (error) {
       result.status = "FAIL";
       result.description = `Couldn't crop image. ${error}`;
-      if (existFilePath && filePath !== existFilePath && import_node_fs19.default.existsSync(filePath)) {
-        import_node_fs19.default.unlinkSync(filePath);
+      if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
+        import_node_fs20.default.unlinkSync(filePath);
       }
       return result;
     }
@@ -646204,7 +646308,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
   if (existFilePath) {
     if (step.screenshot.overwrite == "true" && !isUrlPath) {
       result.description += ` Overwrote existing file.`;
-      import_node_fs19.default.renameSync(filePath, existFilePath);
+      import_node_fs20.default.renameSync(filePath, existFilePath);
       result.outputs.screenshotPath = existFilePath;
       result.outputs.changed = true;
       if (step.screenshot.sourceIntegration) {
@@ -646217,13 +646321,13 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       let img1;
       let img2;
       try {
-        img1 = PNG.sync.read(import_node_fs19.default.readFileSync(existFilePath));
-        img2 = PNG.sync.read(import_node_fs19.default.readFileSync(filePath));
+        img1 = PNG.sync.read(import_node_fs20.default.readFileSync(existFilePath));
+        img2 = PNG.sync.read(import_node_fs20.default.readFileSync(filePath));
       } catch (error) {
         result.status = "FAIL";
         result.description = isUrlPath ? `Couldn't decode PNG for comparison. The URL reference (${redactedUrl}) may not be a valid PNG. ${error}` : `Couldn't decode PNG for comparison. ${error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs19.default.existsSync(filePath)) {
-          import_node_fs19.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
+          import_node_fs20.default.unlinkSync(filePath);
         }
         return result;
       }
@@ -646235,8 +646339,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (!aspectRatioMatch) {
         result.description = `Couldn't compare images. Images have different aspect ratios.`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs19.default.existsSync(filePath)) {
-          import_node_fs19.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
+          import_node_fs20.default.unlinkSync(filePath);
         }
         return await evaluateApplicable();
       }
@@ -646263,8 +646367,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       } catch (error) {
         result.status = "FAIL";
         result.description = `Couldn't load screenshot comparison dependency (pixelmatch). ${error?.message ?? error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs19.default.existsSync(filePath)) {
-          import_node_fs19.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
+          import_node_fs20.default.unlinkSync(filePath);
         }
         return result;
       }
@@ -646282,7 +646386,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (fractionalDiff > step.screenshot.maxVariation) {
         if (step.screenshot.overwrite == "aboveVariation" && !isUrlPath) {
-          import_node_fs19.default.renameSync(filePath, existFilePath);
+          import_node_fs20.default.renameSync(filePath, existFilePath);
         }
         result.description += ` The difference between the existing screenshot and new screenshot (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.screenshot.maxVariation}).`;
         if (isUrlPath) {
@@ -646307,7 +646411,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
             result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
           }
           if (step.screenshot.overwrite != "true") {
-            import_node_fs19.default.unlinkSync(filePath);
+            import_node_fs20.default.unlinkSync(filePath);
           }
         }
       }
@@ -646326,10 +646430,10 @@ async function saveScreenshot({ config, step, driver, appSession }) {
 // dist/core/tests/startRecording.js
 init_validate();
 init_utils();
-var import_node_child_process11 = require("node:child_process");
+var import_node_child_process12 = require("node:child_process");
 var import_node_crypto7 = require("node:crypto");
-var import_node_path17 = __toESM(require("node:path"), 1);
-var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
 var import_node_os8 = __toESM(require("node:os"), 1);
 async function startRecording({ config, context, step, driver, recordingHost, appSession, deps = {} }) {
   let result = {
@@ -646398,7 +646502,7 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
   if (typeof step.record.path === "undefined") {
     step.record.path = `${step.stepId}.mp4`;
     if (step.record.directory) {
-      step.record.path = import_node_path17.default.resolve(step.record.directory, step.record.path);
+      step.record.path = import_node_path18.default.resolve(step.record.directory, step.record.path);
     }
   }
   step.record = {
@@ -646406,18 +646510,18 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
     overwrite: step.record.overwrite || "false"
   };
   let filePath = step.record.path;
-  const baseName = import_node_path17.default.basename(filePath, import_node_path17.default.extname(filePath));
-  const dir = import_node_path17.default.dirname(step.record.path);
-  if (!import_node_fs20.default.existsSync(dir)) {
-    import_node_fs20.default.mkdirSync(dir, { recursive: true });
+  const baseName = import_node_path18.default.basename(filePath, import_node_path18.default.extname(filePath));
+  const dir = import_node_path18.default.dirname(step.record.path);
+  if (!import_node_fs21.default.existsSync(dir)) {
+    import_node_fs21.default.mkdirSync(dir, { recursive: true });
   }
-  if (import_node_fs20.default.existsSync(filePath) && step.record.overwrite == "false") {
+  if (import_node_fs21.default.existsSync(filePath) && step.record.overwrite == "false") {
     result.status = "SKIPPED";
     result.description = `File already exists: ${filePath}`;
     return result;
   }
   const normalizeActiveTarget = (p) => {
-    const resolved = import_node_path17.default.resolve(p);
+    const resolved = import_node_path18.default.resolve(p);
     return process.platform === "win32" || process.platform === "darwin" ? resolved.toLowerCase() : resolved;
   };
   const normalizedTarget = normalizeActiveTarget(filePath);
@@ -646505,13 +646609,13 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
     }
     const captureTitle = browserCaptureTitle(context.contextId);
     const downloadDir = browserDownloadDir(context.contextId);
-    if (!import_node_fs20.default.existsSync(downloadDir)) {
-      import_node_fs20.default.mkdirSync(downloadDir, { recursive: true });
+    if (!import_node_fs21.default.existsSync(downloadDir)) {
+      import_node_fs21.default.mkdirSync(downloadDir, { recursive: true });
     }
-    const downloadPath = import_node_path17.default.join(downloadDir, `${baseName}.webm`);
-    if (import_node_fs20.default.existsSync(downloadPath)) {
+    const downloadPath = import_node_path18.default.join(downloadDir, `${baseName}.webm`);
+    if (import_node_fs21.default.existsSync(downloadPath)) {
       try {
-        import_node_fs20.default.unlinkSync(downloadPath);
+        import_node_fs21.default.unlinkSync(downloadPath);
       } catch {
       }
     }
@@ -646651,10 +646755,10 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
     } catch {
     }
   }
-  const tempDir = import_node_path17.default.join(import_node_os8.default.tmpdir(), "doc-detective", "recordings");
-  if (!import_node_fs20.default.existsSync(tempDir))
-    import_node_fs20.default.mkdirSync(tempDir, { recursive: true });
-  const tempPath = import_node_path17.default.join(tempDir, `${safeContextId(context.contextId)}-${baseName}-${(0, import_node_crypto7.randomUUID)().slice(0, 8)}.mkv`);
+  const tempDir = import_node_path18.default.join(import_node_os8.default.tmpdir(), "doc-detective", "recordings");
+  if (!import_node_fs21.default.existsSync(tempDir))
+    import_node_fs21.default.mkdirSync(tempDir, { recursive: true });
+  const tempPath = import_node_path18.default.join(tempDir, `${safeContextId(context.contextId)}-${baseName}-${(0, import_node_crypto7.randomUUID)().slice(0, 8)}.mkv`);
   let ffmpegPath;
   try {
     ffmpegPath = await (deps.getFfmpegPath ?? getFfmpegPath)({
@@ -646685,7 +646789,7 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
     screenSize
   });
   log(config, "debug", `ffmpeg recording: platform=${process.platform} target=${plan.target}${screenIndex !== void 0 ? ` screen=${screenIndex}` : ""}${context.__display ? ` display=${context.__display}` : ""} -> ${tempPath}`);
-  const proc = (deps.spawn ?? import_node_child_process11.spawn)(ffmpegPath, args, {
+  const proc = (deps.spawn ?? import_node_child_process12.spawn)(ffmpegPath, args, {
     stdio: ["pipe", "ignore", "pipe"]
   });
   let spawnError = null;
@@ -646724,10 +646828,10 @@ async function startRecording({ config, context, step, driver, recordingHost, ap
 // dist/core/tests/stopRecording.js
 init_validate();
 init_utils();
-var import_node_child_process12 = require("node:child_process");
+var import_node_child_process13 = require("node:child_process");
 var import_node_crypto8 = require("node:crypto");
-var import_node_path18 = __toESM(require("node:path"), 1);
-var import_node_fs21 = __toESM(require("node:fs"), 1);
+var import_node_path19 = __toESM(require("node:path"), 1);
+var import_node_fs22 = __toESM(require("node:fs"), 1);
 var import_node_os9 = __toESM(require("node:os"), 1);
 async function stopRecording({ config, step, driver, deps = {} }) {
   let result = {
@@ -646922,14 +647026,14 @@ async function stopRecording({ config, step, driver, deps = {} }) {
         dropHandle();
         return result;
       }
-      if (import_node_path18.default.extname(recording.targetPath) === ".mp4") {
-        import_node_fs21.default.writeFileSync(recording.targetPath, buffer);
+      if (import_node_path19.default.extname(recording.targetPath) === ".mp4") {
+        import_node_fs22.default.writeFileSync(recording.targetPath, buffer);
       } else {
-        const tempDir = import_node_path18.default.join(import_node_os9.default.tmpdir(), "doc-detective", "recordings");
-        if (!import_node_fs21.default.existsSync(tempDir))
-          import_node_fs21.default.mkdirSync(tempDir, { recursive: true });
-        const tempPath = import_node_path18.default.join(tempDir, `device-${(0, import_node_crypto8.randomUUID)().slice(0, 8)}.mp4`);
-        import_node_fs21.default.writeFileSync(tempPath, buffer);
+        const tempDir = import_node_path19.default.join(import_node_os9.default.tmpdir(), "doc-detective", "recordings");
+        if (!import_node_fs22.default.existsSync(tempDir))
+          import_node_fs22.default.mkdirSync(tempDir, { recursive: true });
+        const tempPath = import_node_path19.default.join(tempDir, `device-${(0, import_node_crypto8.randomUUID)().slice(0, 8)}.mp4`);
+        import_node_fs22.default.writeFileSync(tempPath, buffer);
         await transcode({
           config,
           sourcePath: tempPath,
@@ -646957,7 +647061,7 @@ async function transcode({ config, sourcePath, targetPath, deleteSource, crop })
     const cy = `max(0\\,min(${crop.y}\\,ih-${ch}))`;
     filters.push(`crop=w=${cw}:h=${ch}:x=${cx}:y=${cy}`);
   }
-  if (import_node_path18.default.extname(targetPath) === ".gif") {
+  if (import_node_path19.default.extname(targetPath) === ".gif") {
     filters.push("scale=iw:-1:flags=lanczos");
   }
   if (filters.length > 0) {
@@ -646966,7 +647070,7 @@ async function transcode({ config, sourcePath, targetPath, deleteSource, crop })
   ffmpegArgs.push(`${targetPath}`);
   const ffmpegPath = await getFfmpegPath({ cacheDir: config?.cacheDir });
   await new Promise((resolve, reject) => {
-    const child = (0, import_node_child_process12.spawn)(ffmpegPath, ffmpegArgs);
+    const child = (0, import_node_child_process13.spawn)(ffmpegPath, ffmpegArgs);
     let stderr = "";
     child.stderr?.on("data", (d) => {
       stderr = (stderr + d.toString()).slice(-2e3);
@@ -646975,7 +647079,7 @@ async function transcode({ config, sourcePath, targetPath, deleteSource, crop })
       if (code === 0) {
         if (deleteSource && sourcePath !== targetPath) {
           try {
-            import_node_fs21.default.unlinkSync(sourcePath);
+            import_node_fs22.default.unlinkSync(sourcePath);
           } catch {
           }
         }
@@ -646994,7 +647098,7 @@ async function waitForStableFile(filePath, maxSeconds) {
   for (let i = 0; i < deadline; i++) {
     let size = -1;
     try {
-      size = import_node_fs21.default.statSync(filePath).size;
+      size = import_node_fs22.default.statSync(filePath).size;
     } catch {
       size = -1;
     }
@@ -647034,8 +647138,8 @@ async function loadVariables({ step }) {
 // dist/core/tests/saveCookie.js
 init_validate();
 init_utils();
-var import_node_path19 = __toESM(require("node:path"), 1);
-var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_path20 = __toESM(require("node:path"), 1);
+var import_node_fs23 = __toESM(require("node:fs"), 1);
 async function saveCookie({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -647052,7 +647156,7 @@ async function saveCookie({ config, step, driver }) {
   let cookieName, filePath, directory, overwrite, domain, variable;
   if (typeof step.saveCookie === "string") {
     if (step.saveCookie.endsWith(".txt")) {
-      cookieName = import_node_path19.default.basename(step.saveCookie, ".txt");
+      cookieName = import_node_path20.default.basename(step.saveCookie, ".txt");
       filePath = step.saveCookie;
     } else {
       cookieName = step.saveCookie;
@@ -647101,15 +647205,15 @@ async function saveCookie({ config, step, driver }) {
     }
     if (filePath) {
       const outputDirectory = directory || config.output || process.cwd();
-      const fullPath = import_node_path19.default.resolve(outputDirectory, filePath);
-      if (import_node_fs22.default.existsSync(fullPath) && !(overwrite === true || overwrite === "true")) {
+      const fullPath = import_node_path20.default.resolve(outputDirectory, filePath);
+      if (import_node_fs23.default.existsSync(fullPath) && !(overwrite === true || overwrite === "true")) {
         result.status = "FAIL";
         result.description = `File '${fullPath}' already exists and overwrite is not enabled.`;
         return result;
       }
-      const dir = import_node_path19.default.dirname(fullPath);
-      if (!import_node_fs22.default.existsSync(dir)) {
-        import_node_fs22.default.mkdirSync(dir, { recursive: true });
+      const dir = import_node_path20.default.dirname(fullPath);
+      if (!import_node_fs23.default.existsSync(dir)) {
+        import_node_fs23.default.mkdirSync(dir, { recursive: true });
       }
       if (targetCookie) {
         const netscapeCookie = formatCookieForNetscape(targetCookie);
@@ -647117,11 +647221,11 @@ async function saveCookie({ config, step, driver }) {
 # This is a cookie file saved by Doc Detective
 ${netscapeCookie}
 `;
-        import_node_fs22.default.writeFileSync(fullPath, content, "utf8");
+        import_node_fs23.default.writeFileSync(fullPath, content, "utf8");
         result.description = `Saved cookie '${cookieName}' to '${fullPath}'.`;
         log(config, "debug", `Saved cookie '${cookieName}' to file: ${fullPath}`);
       } else {
-        import_node_fs22.default.writeFileSync(fullPath, "# No cookie data\n", "utf8");
+        import_node_fs23.default.writeFileSync(fullPath, "# No cookie data\n", "utf8");
         result.description = `Created empty cookie file at '${fullPath}'.`;
         log(config, "debug", `Created empty cookie file: ${fullPath}`);
       }
@@ -647148,8 +647252,8 @@ function formatCookieForNetscape(cookie) {
 // dist/core/tests/loadCookie.js
 init_validate();
 init_utils();
-var import_node_path20 = __toESM(require("node:path"), 1);
-var import_node_fs23 = __toESM(require("node:fs"), 1);
+var import_node_path21 = __toESM(require("node:path"), 1);
+var import_node_fs24 = __toESM(require("node:fs"), 1);
 async function loadCookie({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -647166,7 +647270,7 @@ async function loadCookie({ config, step, driver }) {
   let cookieName, filePath, directory, domain, variable;
   if (typeof step.loadCookie === "string") {
     if (step.loadCookie.endsWith(".txt")) {
-      cookieName = import_node_path20.default.basename(step.loadCookie, ".txt");
+      cookieName = import_node_path21.default.basename(step.loadCookie, ".txt");
       filePath = step.loadCookie;
     } else {
       cookieName = step.loadCookie;
@@ -647179,9 +647283,9 @@ async function loadCookie({ config, step, driver }) {
     domain = step.loadCookie.domain;
     variable = step.loadCookie.variable;
     if (filePath && !cookieName) {
-      const ext = import_node_path20.default.extname(filePath).toLowerCase();
+      const ext = import_node_path21.default.extname(filePath).toLowerCase();
       if (ext === ".txt") {
-        cookieName = import_node_path20.default.basename(filePath, ext);
+        cookieName = import_node_path21.default.basename(filePath, ext);
       }
     }
   }
@@ -647204,14 +647308,14 @@ async function loadCookie({ config, step, driver }) {
       }
     } else if (filePath) {
       const inputDirectory = directory || config.output || process.cwd();
-      const fullPath = import_node_path20.default.resolve(inputDirectory, filePath);
-      if (!import_node_fs23.default.existsSync(fullPath)) {
+      const fullPath = import_node_path21.default.resolve(inputDirectory, filePath);
+      if (!import_node_fs24.default.existsSync(fullPath)) {
         result.status = "FAIL";
         result.description = `Cookie file '${fullPath}' not found`;
         return result;
       }
       try {
-        const fileContent = import_node_fs23.default.readFileSync(fullPath, "utf8");
+        const fileContent = import_node_fs24.default.readFileSync(fullPath, "utf8");
         const cookies = parseNetscapeCookieFile(fileContent);
         if (cookies.length === 0) {
           result.status = "FAIL";
@@ -647377,8 +647481,8 @@ function isDomainCompatible(currentDomain, cookieDomain) {
 // dist/core/tests/httpRequest.js
 init_validate();
 var import_axios5 = __toESM(require("axios"), 1);
-var import_node_fs24 = __toESM(require("node:fs"), 1);
-var import_node_path21 = __toESM(require("node:path"), 1);
+var import_node_fs25 = __toESM(require("node:fs"), 1);
+var import_node_path22 = __toESM(require("node:path"), 1);
 var import_ajv2 = __toESM(require("ajv"), 1);
 init_openapi();
 init_utils();
@@ -647408,9 +647512,9 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
       delete step.httpRequest.openApi.definition;
     } else if (openApiDefinitions.length > 0) {
       findOperation: for (const openApiConfig of openApiDefinitions) {
-        for (const path26 in openApiConfig.definition.paths) {
-          for (const method in openApiConfig.definition.paths[path26]) {
-            if (openApiConfig.definition.paths[path26][method].operationId === step.httpRequest.openApi.operationId) {
+        for (const path27 in openApiConfig.definition.paths) {
+          for (const method in openApiConfig.definition.paths[path27]) {
+            if (openApiConfig.definition.paths[path27][method].operationId === step.httpRequest.openApi.operationId) {
               openApiDefinition = openApiConfig.definition;
               step.httpRequest.openApi = {
                 ...openApiConfig,
@@ -647724,20 +647828,20 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
     }
   }
   if (step.httpRequest.path) {
-    const dir = import_node_path21.default.dirname(step.httpRequest.path);
-    if (!import_node_fs24.default.existsSync(dir)) {
-      import_node_fs24.default.mkdirSync(dir, { recursive: true });
+    const dir = import_node_path22.default.dirname(step.httpRequest.path);
+    if (!import_node_fs25.default.existsSync(dir)) {
+      import_node_fs25.default.mkdirSync(dir, { recursive: true });
     }
     let filePath = step.httpRequest.path;
     log(config, "debug", `Saving output to file: ${filePath}`);
-    if (!import_node_fs24.default.existsSync(filePath)) {
-      await import_node_fs24.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
+    if (!import_node_fs25.default.existsSync(filePath)) {
+      await import_node_fs25.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
       descriptions.push(`Saved output to file.`);
     } else {
       if (step.httpRequest.overwrite == "false") {
         descriptions.push(`Didn't save output. File already exists.`);
       }
-      const existingFile = import_node_fs24.default.readFileSync(filePath, "utf8");
+      const existingFile = import_node_fs25.default.readFileSync(filePath, "utf8");
       const fractionalDiff = calculateFractionalDifference(existingFile, JSON.stringify(response.data, null, 2));
       log(config, "debug", `Fractional difference: ${fractionalDiff}`);
       result.outputs.variation = fractionalDiff;
@@ -647747,13 +647851,13 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
       });
       if (fractionalDiff > step.httpRequest.maxVariation) {
         if (step.httpRequest.overwrite == "aboveVariation") {
-          await import_node_fs24.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
+          await import_node_fs25.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
           descriptions.push(`Saved response to file.`);
         }
         descriptions.push(`The difference between the existing saved response and the new response (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.httpRequest.maxVariation}).`);
       } else {
         if (step.httpRequest.overwrite == "true") {
-          import_node_fs24.default.writeFileSync(filePath, JSON.stringify(response.data, null, 2));
+          import_node_fs25.default.writeFileSync(filePath, JSON.stringify(response.data, null, 2));
           descriptions.push(`Saved response to file.`);
         }
       }
@@ -647766,8 +647870,8 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
   result.description = descriptions.join(" ").trim();
   return result;
 }
-function fieldExistsAtPath(obj, path26) {
-  const segments = path26.match(/[^.[\]]+/g);
+function fieldExistsAtPath(obj, path27) {
+  const segments = path27.match(/[^.[\]]+/g);
   if (!segments) {
     return false;
   }
@@ -647957,8 +648061,8 @@ async function clickElement({ config, step, driver, appSession }) {
 // dist/core/tests/runCode.js
 init_validate();
 init_utils();
-var import_node_fs25 = __toESM(require("node:fs"), 1);
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_node_fs26 = __toESM(require("node:fs"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 var import_node_os10 = __toESM(require("node:os"), 1);
 function createTempScript(code, language) {
   let extension;
@@ -647983,9 +648087,9 @@ function createTempScript(code, language) {
       extension = "";
   }
   const tmpDir = import_node_os10.default.tmpdir();
-  const tmpFile = import_node_path22.default.join(tmpDir, `doc-detective-${Date.now()}${extension}`);
+  const tmpFile = import_node_path23.default.join(tmpDir, `doc-detective-${Date.now()}${extension}`);
   try {
-    import_node_fs25.default.writeFileSync(tmpFile, code);
+    import_node_fs26.default.writeFileSync(tmpFile, code);
   } catch (error) {
     throw new Error(`Failed to create temporary script: ${error.message}`);
   }
@@ -648090,7 +648194,7 @@ async function runCode({ config, step, driver, processRegistry }) {
     if (typeof step.runCode.stdio !== "undefined")
       runShellOptions.stdio = step.runCode.stdio;
     if (typeof step.runCode.path !== "undefined") {
-      runShellOptions.path = step.runCode.directory ? import_node_path22.default.join(step.runCode.directory, step.runCode.path) : step.runCode.path;
+      runShellOptions.path = step.runCode.directory ? import_node_path23.default.join(step.runCode.directory, step.runCode.path) : step.runCode.path;
     }
     if (step.runCode.background) {
       runShellOptions.background = step.runCode.background;
@@ -648119,7 +648223,7 @@ async function runCode({ config, step, driver, processRegistry }) {
   } finally {
     if (!deferTempCleanup) {
       try {
-        import_node_fs25.default.unlinkSync(scriptPath);
+        import_node_fs26.default.unlinkSync(scriptPath);
         log(config, "debug", `Removed temporary script: ${scriptPath}`);
       } catch (error) {
         log(config, "warning", `Failed to remove temporary script: ${scriptPath}`);
@@ -648133,7 +648237,7 @@ async function runCode({ config, step, driver, processRegistry }) {
 init_validate();
 init_utils();
 var import_tree_kill2 = __toESM(require("tree-kill"), 1);
-var import_node_fs26 = __toESM(require("node:fs"), 1);
+var import_node_fs27 = __toESM(require("node:fs"), 1);
 async function closeSurface({ config, step, driver, processRegistry, appSession }) {
   const result = {
     status: "PASS",
@@ -648282,7 +648386,7 @@ async function closeSurface({ config, step, driver, processRegistry, appSession
     }
     if (entry.tempPath) {
       try {
-        import_node_fs26.default.unlinkSync(entry.tempPath);
+        import_node_fs27.default.unlinkSync(entry.tempPath);
       } catch {
       }
     }
@@ -648535,7 +648639,7 @@ async function applyViewport(driver, viewport) {
 }
 
 // dist/core/tests/mobileBrowser.js
-var import_node_path23 = __toESM(require("node:path"), 1);
+var import_node_path24 = __toESM(require("node:path"), 1);
 var SUPPORTED_MOBILE_BROWSER = {
   android: "chrome",
   ios: "safari"
@@ -648592,7 +648696,7 @@ function mobileBrowserGate({ platform, browser, hasBrowserStep, hasAppStep }) {
   }
   return { action: "proceed", browserName };
 }
-function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout }) {
+function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout, locateWda = () => locateManagedWda({ ctx: { cacheDir } }) }) {
   if (platform === "android") {
     return {
       platformName: "Android",
@@ -648610,7 +648714,7 @@ function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout }) {
       // --allow-insecure=uiautomator2:chromedriver_autodownload. The
       // download lands in the Doc Detective cache so later runs reuse it.
       "appium:chromedriverAutodownload": true,
-      "appium:chromedriverExecutableDir": import_node_path23.default.join(cacheDir, MOBILE_CHROMEDRIVER_DIR)
+      "appium:chromedriverExecutableDir": import_node_path24.default.join(cacheDir, MOBILE_CHROMEDRIVER_DIR)
     };
   }
   const capabilities = {
@@ -648624,10 +648728,7 @@ function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout }) {
   const effectiveTimeout = timeout ?? 9e5;
   capabilities["appium:wdaLaunchTimeout"] = Math.max(effectiveTimeout, 12e4);
   capabilities["appium:wdaConnectionTimeout"] = Math.max(effectiveTimeout, 12e4);
-  const derivedDataPath = process.env.DOC_DETECTIVE_IOS_WDA_DERIVED_DATA_PATH;
-  if (derivedDataPath && derivedDataPath.trim()) {
-    capabilities["appium:derivedDataPath"] = derivedDataPath.trim();
-  }
+  applyManagedWdaCapabilities(capabilities, locateWda);
   return capabilities;
 }
 
@@ -648635,7 +648736,7 @@ function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout }) {
 init_cacheDir();
 
 // dist/core/tests/iosSimulator.js
-var import_node_child_process13 = require("node:child_process");
+var import_node_child_process14 = require("node:child_process");
 function parseSimctlDevices(text) {
   let data;
   try {
@@ -648909,7 +649010,7 @@ async function teardownSimulatorRegistry(registry, shutdown) {
 }
 function runSimctl(args, timeout = 6e4) {
   return new Promise((resolve) => {
-    (0, import_node_child_process13.execFile)("xcrun", ["simctl", ...args], { timeout, maxBuffer: 32 * 1024 * 1024 }, (error, stdout, stderr) => {
+    (0, import_node_child_process14.execFile)("xcrun", ["simctl", ...args], { timeout, maxBuffer: 32 * 1024 * 1024 }, (error, stdout, stderr) => {
       resolve({
         // A timeout or spawn error sets no numeric `code` (it's null) — treat
         // that as a failure, not success, so a hung `simctl` doesn't look like
@@ -648966,8 +649067,8 @@ function buildAcquireSimulatorDeps(log3) {
 // dist/core/tests/runBrowserScript.js
 init_validate();
 init_utils();
-var import_node_fs27 = __toESM(require("node:fs"), 1);
-var import_node_path24 = __toESM(require("node:path"), 1);
+var import_node_fs28 = __toESM(require("node:fs"), 1);
+var import_node_path25 = __toESM(require("node:path"), 1);
 async function runBrowserScript({ config, step, driver }) {
   const result = {
     status: "PASS",
@@ -649042,16 +649143,16 @@ async function runBrowserScript({ config, step, driver }) {
   }
   if (step.runBrowserScript.path) {
     try {
-      const dir = import_node_path24.default.dirname(step.runBrowserScript.path);
-      if (!import_node_fs27.default.existsSync(dir)) {
-        import_node_fs27.default.mkdirSync(dir, { recursive: true });
+      const dir = import_node_path25.default.dirname(step.runBrowserScript.path);
+      if (!import_node_fs28.default.existsSync(dir)) {
+        import_node_fs28.default.mkdirSync(dir, { recursive: true });
       }
       const filePath = step.runBrowserScript.path;
       log(config, "debug", `Saving script result to file: ${filePath}`);
-      if (!import_node_fs27.default.existsSync(filePath)) {
-        import_node_fs27.default.writeFileSync(filePath, serialized);
+      if (!import_node_fs28.default.existsSync(filePath)) {
+        import_node_fs28.default.writeFileSync(filePath, serialized);
       } else {
-        const existingFile = import_node_fs27.default.readFileSync(filePath, "utf8");
+        const existingFile = import_node_fs28.default.readFileSync(filePath, "utf8");
         const fractionalDiff = calculateFractionalDifference(existingFile, serialized);
         log(config, "debug", `Fractional difference: ${fractionalDiff}`);
         result.outputs.variation = fractionalDiff;
@@ -649061,7 +649162,7 @@ async function runBrowserScript({ config, step, driver }) {
         });
         if (fractionalDiff > step.runBrowserScript.maxVariation) {
           if (step.runBrowserScript.overwrite == "aboveVariation" || step.runBrowserScript.overwrite == "true") {
-            import_node_fs27.default.writeFileSync(filePath, serialized);
+            import_node_fs28.default.writeFileSync(filePath, serialized);
             descriptions.push(`Saved output to file.`);
           } else {
             descriptions.push(`Didn't overwrite the existing file.`);
@@ -649069,7 +649170,7 @@ async function runBrowserScript({ config, step, driver }) {
           descriptions.push(`The difference between the existing output and the new output (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.runBrowserScript.maxVariation}).`);
         } else {
           if (step.runBrowserScript.overwrite == "true") {
-            import_node_fs27.default.writeFileSync(filePath, serialized);
+            import_node_fs28.default.writeFileSync(filePath, serialized);
             descriptions.push(`Saved output to file.`);
           }
         }
@@ -649237,8 +649338,8 @@ async function dragAndDropElement({ config, step, driver }) {
 }
 
 // dist/core/tests.js
-var import_node_path25 = __toESM(require("node:path"), 1);
-var import_node_child_process14 = require("node:child_process");
+var import_node_path26 = __toESM(require("node:path"), 1);
+var import_node_child_process15 = require("node:child_process");
 var import_node_crypto9 = require("node:crypto");
 init_appium();
 init_config();
@@ -649391,7 +649492,7 @@ function getIntegrationConfig(config, sourceIntegration) {
 var import_node_http2 = __toESM(require("node:http"), 1);
 var import_node_https3 = __toESM(require("node:https"), 1);
 var import_node_url6 = require("node:url");
-var __dirname5 = import_node_path25.default.dirname((0, import_node_url6.fileURLToPath)(importMetaUrl));
+var __dirname5 = import_node_path26.default.dirname((0, import_node_url6.fileURLToPath)(importMetaUrl));
 var KNOWN_BROWSERS = ["firefox", "chrome", "safari", "webkit"];
 function killTree(pid, timeoutMs = 5e3) {
   return new Promise((resolve) => {
@@ -650015,7 +650116,7 @@ async function runSpecs({ resolvedTests }) {
   const runDir = getRunOutputDir(config, {
     create: runArchivesArtifacts(config, specs)
   });
-  const runId = import_node_path25.default.basename(runDir);
+  const runId = import_node_path26.default.basename(runDir);
   const report = {
     runId,
     runDir,
@@ -650241,7 +650342,7 @@ async function runSpecs({ resolvedTests }) {
       }
       if (entry?.tempPath) {
         try {
-          import_node_fs28.default.unlinkSync(entry.tempPath);
+          import_node_fs29.default.unlinkSync(entry.tempPath);
         } catch {
         }
       }
@@ -650818,7 +650919,7 @@ function buildAutoRecordStep({ config, spec, test, context }) {
     return null;
   const runDir = getRunOutputDir(config, { create: false });
   const contextSegment = capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context"));
-  const recordPath = import_node_path25.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizeFilesystemName(String(test.testId ?? ""), "test")), "contexts", contextSegment, "recordings", `${contextSegment}.mp4`);
+  const recordPath = import_node_path26.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizeFilesystemName(String(test.testId ?? ""), "test")), "contexts", contextSegment, "recordings", `${contextSegment}.mp4`);
   return {
     // Mobile-target contexts record the device screen through the app driver
     // (the internal device plan, resolved from the platform) — pinning ffmpeg
@@ -650847,7 +650948,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
     const action = BROWSER_STEP_KEYS.find((key) => typeof step[key] !== "undefined") || "step";
     const sanitizedTestId = sanitizeFilesystemName(String(test.testId ?? ""), "test");
     const runDir = getRunOutputDir(config);
-    const dir = import_node_path25.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizedTestId), "contexts", capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context")), "screenshots");
+    const dir = import_node_path26.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizedTestId), "contexts", capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context")), "screenshots");
     const stepIdString = sanitizeFilesystemName(String(step.stepId ?? ""), "step");
     const stepRef = capPathSegment(stepIdString.startsWith(`${sanitizedTestId}~`) ? stepIdString.slice(sanitizedTestId.length + 1) : stepIdString);
     const pad = Math.max(2, String(stepCount).length);
@@ -650856,7 +650957,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
       stepId: `${step.stepId}_auto`,
       description: "Automatic post-step screenshot",
       screenshot: {
-        path: import_node_path25.default.join(dir, fileName),
+        path: import_node_path26.default.join(dir, fileName),
         overwrite: "true"
       }
     };
@@ -650869,7 +650970,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
       log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${captureResult.description}`);
       return null;
     }
-    return import_node_path25.default.relative(runDir, screenshotStep.screenshot.path).split(import_node_path25.default.sep).join("/");
+    return import_node_path26.default.relative(runDir, screenshotStep.screenshot.path).split(import_node_path26.default.sep).join("/");
   } catch (error) {
     log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${error?.message ?? error}`);
     return null;
@@ -651832,9 +651933,9 @@ async function startAppiumServer(appiumEntry, config, display, extraEnv, extraAr
     ...display ? { DISPLAY: display } : {},
     ...extraEnv ?? {}
   } : process.env;
-  const proc = (0, import_node_child_process14.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port), ...extraArgs ?? []], {
+  const proc = (0, import_node_child_process15.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port), ...extraArgs ?? []], {
     windowsHide: true,
-    cwd: import_node_path25.default.join(__dirname5, "../.."),
+    cwd: import_node_path26.default.join(__dirname5, "../.."),
     env
   });
   proc.on("error", (err) => {
@@ -651980,9 +652081,9 @@ async function getRunner(options = {}) {
   if (!appiumEntry) {
     throw new Error("appium is not installed. Run `doc-detective install runtime appium` to install it.");
   }
-  const appium = (0, import_node_child_process14.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(appiumPort)], {
+  const appium = (0, import_node_child_process15.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(appiumPort)], {
     windowsHide: true,
-    cwd: import_node_path25.default.join(__dirname5, "../..")
+    cwd: import_node_path26.default.join(__dirname5, "../..")
   });
   appium.on("error", (err) => {
     log(config, "warning", `Appium process error: ${err?.stack ?? err?.message ?? String(err)}`);