doc-detective 4.27.0 → 4.29.0

package/dist/index.cjs

@@ -383844,6 +383844,71 @@ var init_schemas = __esm({
                 }
               ]
             }
+          },
+          warm: {
+            type: "object",
+            description: "Results of the run's inline warm phase \u2014 the always-on, best-effort provisioning pass (dependency installs, device boots, session probes) performed between test resolution and test execution. A failed task never gates the run; the per-context paths retry or skip with their normal semantics. Absent when the run ended before the phase (for example, when no specs matched). System-populated.",
+            readOnly: true,
+            additionalProperties: false,
+            required: [
+              "durationMs",
+              "tasks"
+            ],
+            properties: {
+              durationMs: {
+                type: "number",
+                description: "Wall-clock duration of the warm phase in milliseconds. Tasks overlap, so this is less than the sum of the per-task durations."
+              },
+              tasks: {
+                type: "array",
+                description: "One entry per executed warm task.",
+                items: {
+                  type: "object",
+                  additionalProperties: false,
+                  required: [
+                    "name",
+                    "kind",
+                    "outcome",
+                    "durationMs"
+                  ],
+                  properties: {
+                    name: {
+                      type: "string",
+                      description: "Task identity, e.g. `browser-install:chrome` or `device-boot:android:<default>:<latest>`."
+                    },
+                    kind: {
+                      type: "string",
+                      enum: [
+                        "driver-install",
+                        "browser-install",
+                        "device-boot",
+                        "wda-check",
+                        "session-probe",
+                        "chromedriver-prefetch"
+                      ],
+                      description: "What the task pre-pays: a native app driver install, a browser install, a simulator/emulator boot, the managed WebDriverAgent availability check, the concurrent-run driver session probe, or the android mobile-web chromedriver download."
+                    },
+                    outcome: {
+                      type: "string",
+                      enum: [
+                        "warmed",
+                        "skipped",
+                        "failed"
+                      ],
+                      description: "`warmed` \u2014 the work was performed (for device boots, the boot was initiated); `skipped` \u2014 nothing to do or the environment isn't ready (the consuming context handles it as usual); `failed` \u2014 the attempt failed (logged as a warning; never fails the run)."
+                    },
+                    durationMs: {
+                      type: "number",
+                      description: "Wall-clock duration of this task in milliseconds."
+                    },
+                    note: {
+                      type: "string",
+                      description: "Human-readable detail about the outcome."
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         required: [
@@ -383865,7 +383930,26 @@ var init_schemas = __esm({
                   }
                 ]
               }
-            ]
+            ],
+            warm: {
+              durationMs: 4211,
+              tasks: [
+                {
+                  name: "browser-install:chrome",
+                  kind: "browser-install",
+                  outcome: "skipped",
+                  durationMs: 2,
+                  note: "'chrome' is already available"
+                },
+                {
+                  name: "session-probe",
+                  kind: "session-probe",
+                  outcome: "warmed",
+                  durationMs: 4205,
+                  note: "1 combination ok"
+                }
+              ]
+            }
           },
           {
             specs: [
@@ -632440,6 +632524,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;
@@ -633975,21 +634061,23 @@ async function loadEnvs(envsFile) {
     return { status: "FAIL", description: "Invalid file." };
   }
 }
+function logLevelEnabled(config, level) {
+  if (config.logLevel === "error" && level === "error")
+    return true;
+  if (config.logLevel === "warning" && (level === "error" || level === "warning"))
+    return true;
+  if (config.logLevel === "info" && (level === "error" || level === "warning" || level === "info"))
+    return true;
+  if (config.logLevel === "debug" && (level === "error" || level === "warning" || level === "info" || level === "debug"))
+    return true;
+  return false;
+}
 async function log(config, level, message) {
   if (message === void 0) {
     message = config;
     config = {};
   }
-  let logLevelMatch = false;
-  if (config.logLevel === "error" && level === "error") {
-    logLevelMatch = true;
-  } else if (config.logLevel === "warning" && (level === "error" || level === "warning")) {
-    logLevelMatch = true;
-  } else if (config.logLevel === "info" && (level === "error" || level === "warning" || level === "info")) {
-    logLevelMatch = true;
-  } else if (config.logLevel === "debug" && (level === "error" || level === "warning" || level === "info" || level === "debug")) {
-    logLevelMatch = true;
-  }
+  const logLevelMatch = logLevelEnabled(config, level);
   if (logLevelMatch) {
     if (typeof message === "string") {
       let logMessage = `(${level.toUpperCase()}) ${message}`;
@@ -634074,8 +634162,7 @@ function replaceEnvs(stringOrObject) {
       stringOrObject[key] = replaceEnvs(stringOrObject[key]);
     });
   } else if (typeof stringOrObject === "string") {
-    const variableRegex = new RegExp(/\$[a-zA-Z0-9_]+(?![a-zA-Z0-9_$])/, "g");
-    const matches = stringOrObject.match(variableRegex);
+    const matches = stringOrObject.match(ENV_VAR_REGEX);
     if (!matches)
       return stringOrObject;
     matches.forEach((match) => {
@@ -634319,7 +634406,7 @@ function llevenshteinDistance(s, t) {
   }
   return arr[t.length][s.length];
 }
-var import_node_fs7, import_node_os2, import_node_path5, import_node_crypto2, import_promises, import_node_net, import_axios, import_node_child_process4, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, TRANSIENT_SESSION_ERROR, SESSION_TIMEOUT_ABORT, TRANSIENT_PROCESS_INIT_EXIT_CODES, SETTLE_CEILING_MAX_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS, posixBashProbe;
+var import_node_fs7, import_node_os2, import_node_path5, import_node_crypto2, import_promises, import_node_net, import_axios, import_node_child_process4, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, TRANSIENT_SESSION_ERROR, SESSION_TIMEOUT_ABORT, TRANSIENT_PROCESS_INIT_EXIT_CODES, SETTLE_CEILING_MAX_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS, ENV_VAR_REGEX, posixBashProbe;
 var init_utils = __esm({
   "dist/core/utils.js"() {
     "use strict";
@@ -634361,6 +634448,7 @@ var init_utils = __esm({
       maxBodyLength: 50 * 1024 * 1024,
       maxRedirects: 5
     };
+    ENV_VAR_REGEX = /\$[a-zA-Z0-9_]+(?![a-zA-Z0-9_$])/g;
   }
 });
 
@@ -634500,12 +634588,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 +634601,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 +634613,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 +634624,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 +634633,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 +634644,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 +634669,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 +635115,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 +635126,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 +635149,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: {} }
   };
@@ -636494,17 +636582,24 @@ function detectFileTypeFromContent(content) {
 }
 
 // dist/common/src/detectTests.js
+var compiledRegExpCache = /* @__PURE__ */ new Map();
 function safeRegExp(pattern, flags) {
   if (typeof pattern !== "string" || pattern.length === 0)
     return null;
   if (pattern.length > 1500)
     return null;
-  const sanitized = Array.from(pattern, (c) => String.fromCharCode(c.charCodeAt(0))).join("");
+  const cacheKey = pattern + " " + flags;
+  const cached = compiledRegExpCache.get(cacheKey);
+  if (cached !== void 0)
+    return cached;
+  let compiled;
   try {
-    return new RegExp(sanitized, flags);
+    compiled = new RegExp(pattern, flags);
   } catch {
-    return null;
+    compiled = null;
   }
+  compiledRegExpCache.set(cacheKey, compiled);
+  return compiled;
 }
 var HASH_EXCLUDED_KEYS = /* @__PURE__ */ new Set([
   "location",
@@ -638217,12 +638312,16 @@ function generateSpecId(filePath) {
   const normalizedPath = relativePath.split(import_node_path11.default.sep).join("/").replace(/^\.\//, "").replace(/[^a-zA-Z0-9._\-\/]/g, "_");
   return normalizedPath;
 }
-async function isValidSourceFile({ config, files, source }) {
-  log(config, "debug", `validation: ${source}`);
-  let allowedExtensions = ["json", "yaml", "yml"];
-  config.fileTypes.forEach((fileType) => {
-    allowedExtensions = allowedExtensions.concat(fileType.extensions);
+function buildAllowedExtensions(config) {
+  const allowed = /* @__PURE__ */ new Set(["json", "yaml", "yml"]);
+  (config.fileTypes || []).forEach((fileType) => {
+    fileType.extensions.forEach((ext) => allowed.add(ext));
   });
+  return allowed;
+}
+async function isValidSourceFile({ config, files, source, allowedExtensions }) {
+  log(config, "debug", `validation: ${source}`);
+  const allowed = allowedExtensions;
   if (files.indexOf(source) >= 0)
     return false;
   if (import_node_path11.default.extname(source) === ".json" || import_node_path11.default.extname(source) === ".yaml" || import_node_path11.default.extname(source) === ".yml") {
@@ -638269,7 +638368,7 @@ async function isValidSourceFile({ config, files, source }) {
     }
   }
   const extension = import_node_path11.default.extname(source).substring(1);
-  if (!allowedExtensions.includes(extension)) {
+  if (!allowed.has(extension)) {
     log(config, "debug", `${source} extension isn't specified in a \`config.fileTypes\` object. Skipping.`);
     return false;
   }
@@ -638321,6 +638420,7 @@ async function qualifyFiles({ config }) {
     return [];
   }
   const ignoredDitaMaps = [];
+  const allowedExtensions = buildAllowedExtensions(config);
   if (!config._herettoPathMapping) {
     config._herettoPathMapping = {};
   }
@@ -638388,8 +638488,9 @@ async function qualifyFiles({ config }) {
     let isFile = false;
     let isDir = false;
     try {
-      isFile = import_node_fs13.default.statSync(source).isFile();
-      isDir = import_node_fs13.default.statSync(source).isDirectory();
+      const stat = import_node_fs13.default.statSync(source);
+      isFile = stat.isFile();
+      isDir = stat.isDirectory();
     } catch {
       log(config, "warning", `Cannot access path: ${source}. Skipping.`);
       continue;
@@ -638404,7 +638505,7 @@ async function qualifyFiles({ config }) {
       continue;
     }
     const resolved = import_node_path11.default.resolve(source);
-    if (isFile && await isValidSourceFile({ config, files, source: resolved })) {
+    if (isFile && await isValidSourceFile({ config, files, allowedExtensions, source: resolved })) {
       files.push(resolved);
       if (!phaseByFile.has(resolved))
         phaseByFile.set(resolved, phase);
@@ -638417,9 +638518,10 @@ async function qualifyFiles({ config }) {
           const content = import_node_path11.default.resolve(dir + "/" + object);
           if (content.includes("node_modules"))
             continue;
-          const isFile2 = import_node_fs13.default.statSync(content).isFile();
-          const isDir2 = import_node_fs13.default.statSync(content).isDirectory();
-          if (isFile2 && await isValidSourceFile({ config, files, source: content })) {
+          const stat = import_node_fs13.default.statSync(content);
+          const isFile2 = stat.isFile();
+          const isDir2 = stat.isDirectory();
+          if (isFile2 && await isValidSourceFile({ config, files, allowedExtensions, source: content })) {
             const resolved2 = import_node_path11.default.resolve(content);
             files.push(resolved2);
             if (!phaseByFile.has(resolved2))
@@ -638783,12 +638885,14 @@ function resolveContexts({ contexts, test, config }) {
   if (resolvedContexts.length === 0) {
     resolvedContexts.push({});
   }
-  log(config, "debug", `Resolved contexts for test ${test.testId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `Resolved contexts for test ${test.testId}:
 ${JSON.stringify(resolvedContexts, null, 2)}`);
   return resolvedContexts;
 }
 async function fetchOpenApiDocuments({ config, documentArray }) {
-  log(config, "debug", `Fetching OpenAPI documents:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `Fetching OpenAPI documents:
 ${JSON.stringify(documentArray, null, 2)}`);
   const openApiDocuments = [];
   if (config?.integrations?.openApi?.length > 0)
@@ -638809,7 +638913,8 @@ ${JSON.stringify(documentArray, null, 2)}`);
       openApiDocuments.push(definition);
     }
   }
-  log(config, "debug", `Fetched OpenAPI documents:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `Fetched OpenAPI documents:
 ${JSON.stringify(openApiDocuments, null, 2)}`);
   return openApiDocuments;
 }
@@ -638829,7 +638934,8 @@ async function resolveContext({ config, test, context, usedContextIds, openApi }
   context.contextId = context.contextId ? uniqueId(context.contextId, usedContextIds) : deriveContextId({ context, usedIds: usedContextIds });
   const contextId = context.contextId;
   usedContextIds.add(contextId);
-  log(config, "debug", `RESOLVING CONTEXT ID ${contextId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVING CONTEXT ID ${contextId}:
 ${JSON.stringify(context, null, 2)}`);
   const resolvedContext = {
     ...context,
@@ -638842,13 +638948,15 @@ ${JSON.stringify(context, null, 2)}`);
     steps: [...test.steps],
     contextId
   };
-  log(config, "debug", `RESOLVED CONTEXT ${contextId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVED CONTEXT ${contextId}:
 ${JSON.stringify(resolvedContext, null, 2)}`);
   return resolvedContext;
 }
 async function resolveTest({ config, spec, test }) {
   const testId = test.testId || `${spec.specId}~${contentHash(test)}`;
-  log(config, "debug", `RESOLVING TEST ID ${testId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVING TEST ID ${testId}:
 ${JSON.stringify(test, null, 2)}`);
   const resolvedTest = {
     ...test,
@@ -638878,13 +638986,15 @@ ${JSON.stringify(test, null, 2)}`);
     });
     resolvedTest.contexts.push(resolvedContext);
   }
-  log(config, "debug", `RESOLVED TEST ${testId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVED TEST ${testId}:
 ${JSON.stringify(resolvedTest, null, 2)}`);
   return resolvedTest;
 }
 async function resolveSpec({ config, spec }) {
   const specId = spec.specId || (spec.contentPath ? generateSpecId(spec.contentPath) : import_node_crypto5.default.randomUUID());
-  log(config, "debug", `RESOLVING SPEC ID ${specId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVING SPEC ID ${specId}:
 ${JSON.stringify(spec, null, 2)}`);
   const resolvedSpec = {
     ...spec,
@@ -638904,12 +639014,14 @@ ${JSON.stringify(spec, null, 2)}`);
     });
     resolvedSpec.tests.push(resolvedTest);
   }
-  log(config, "debug", `RESOLVED SPEC ${specId}:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVED SPEC ${specId}:
 ${JSON.stringify(resolvedSpec, null, 2)}`);
   return resolvedSpec;
 }
 async function resolveTests({ config, detectedTests }) {
-  log(config, "debug", `RESOLVING DETECTED TEST SPECS:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVING DETECTED TEST SPECS:
 ${JSON.stringify(detectedTests, null, 2)}`);
   const resolvedTests = {
     resolvedTestsId: import_node_crypto5.default.randomUUID(),
@@ -638921,7 +639033,8 @@ ${JSON.stringify(detectedTests, null, 2)}`);
     const resolvedSpec = await resolveSpec({ config, spec });
     resolvedTests.specs.push(resolvedSpec);
   }
-  log(config, "debug", `RESOLVED TEST SPECS:
+  if (logLevelEnabled(config, "debug"))
+    log(config, "debug", `RESOLVED TEST SPECS:
 ${JSON.stringify(resolvedTests, null, 2)}`);
   return resolvedTests;
 }
@@ -638931,7 +639044,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 +639757,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 +640305,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 +640359,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 +640465,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 +640510,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 +640525,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 +640548,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 +640661,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 +640696,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 +640736,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 +640852,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 +640887,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 +640907,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 +640930,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 +640951,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 });
   }
 }
 
@@ -640978,6 +641195,13 @@ async function teardownDeviceRegistry(registry, kill4) {
   for (const entry of registry.values()) {
     if (!entry.bootedByUs)
       continue;
+    if (entry.ready) {
+      try {
+        await entry.ready;
+      } catch {
+        continue;
+      }
+    }
     try {
       await kill4(entry);
     } catch {
@@ -640987,7 +641211,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 +641255,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 +641272,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 +641312,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 +641960,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 +642003,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 +642073,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 +642100,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 +642391,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 +642411,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 +642577,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 +643052,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 +643134,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 +643273,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 +643301,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 +643447,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 +643476,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 +643494,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 +643511,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 +643523,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 +643795,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 +643816,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 +643855,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)
@@ -643673,6 +643895,7 @@ function containsOperators(expression, allowOperators = false) {
   }
   return false;
 }
+var compiledEvaluatorCache = /* @__PURE__ */ new Map();
 async function evaluateExpression(expression, context) {
   try {
     expression = preprocessExpression(expression);
@@ -643746,7 +643969,13 @@ async function evaluateExpression(expression, context) {
         }
       })
     };
-    const evaluator = new Function(...Object.keys(evalContext), `return ${expression};`);
+    const argNames = Object.keys(evalContext);
+    const cacheKey = `${argNames.join(",")}\0${expression}`;
+    let evaluator = compiledEvaluatorCache.get(cacheKey);
+    if (!evaluator) {
+      evaluator = new Function(...argNames, `return ${expression};`);
+      compiledEvaluatorCache.set(cacheKey, evaluator);
+    }
     return evaluator(...Object.values(evalContext));
   } catch (error) {
     log(`Error evaluating expression '${expression}': ${error.message}`, "error");
@@ -645317,8 +645546,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 +645660,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 +645682,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 +646035,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 +646187,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 +646223,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 +646242,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 +646254,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 +646356,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 +646412,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 +646420,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 +646433,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 +646446,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 +646464,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 +646492,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 +646511,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 +646536,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 +646555,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 +646627,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 +646635,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 +646734,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 +646880,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 +646914,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 +646953,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 +647151,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 +647186,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 +647195,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 +647204,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 +647223,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 +647263,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 +647281,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 +647330,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 +647346,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 +647377,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 +647395,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 +647408,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 +647433,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 +647606,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 +647637,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 +647953,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 +647976,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 +647995,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 +648186,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 +648212,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 +648319,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 +648348,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 +648362,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 +648511,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 +648764,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"
@@ -648568,6 +648797,10 @@ function mobileBrowserConfigError(browser) {
   }
   return null;
 }
+var CHROMEDRIVER_AUTODOWNLOAD_ARGS = [
+  "--allow-insecure",
+  "uiautomator2:chromedriver_autodownload"
+];
 function mobileBrowserGate({ platform, browser, hasBrowserStep, hasAppStep }) {
   if (!hasBrowserStep)
     return { action: "proceed", browserName: null };
@@ -648592,7 +648825,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 +648843,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,18 +648857,225 @@ 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;
 }
 
+// dist/core/warmPhase.js
+init_utils();
+var WARM_POOL_LIMIT = 4;
+var RUNTIME_INSTALL_RESOURCE = "runtime-install";
+function deviceIdentity(platform, desc) {
+  if (desc?.name)
+    return `${platform}:name:${desc.name}`;
+  return `${platform}:default:${desc?.deviceType ?? "<any>"}:${desc?.osVersion ?? "<latest>"}`;
+}
+function deviceResourceTag(platform, desc) {
+  return `warm-device:${deviceIdentity(platform, desc)}`;
+}
+function wrapInitiationEffects(deps, keys, signal) {
+  const wrapped = { ...deps };
+  for (const key of keys) {
+    const original = deps[key];
+    if (typeof original !== "function")
+      continue;
+    wrapped[key] = (...args) => {
+      const result = original(...args);
+      signal();
+      return result;
+    };
+  }
+  return wrapped;
+}
+function planWarmTasks({ sizingJobs, runnerDetails, limit, hasAppiumPool, deps }) {
+  const hostPlatform = runnerDetails?.environment?.platform;
+  const tasks = [];
+  const seen = /* @__PURE__ */ new Set();
+  const addTask = (task) => {
+    if (seen.has(task.name))
+      return;
+    seen.add(task.name);
+    tasks.push(task);
+  };
+  let probeEligible = false;
+  let defaultBrowser;
+  const getDefaultBrowser2 = () => defaultBrowser ??= deps.getDefaultBrowser({ runnerDetails });
+  const bootPlannedFor = /* @__PURE__ */ new Set();
+  for (const job of sizingJobs ?? []) {
+    const context = job?.context;
+    if (!context)
+      continue;
+    if (deps.contextRequirementsSkipMessage({ context }))
+      continue;
+    const effPlatform = context.platform || hostPlatform;
+    const mobileTarget = deps.isMobileTargetPlatform(effPlatform);
+    if (mobileTarget) {
+      if (mobileTarget === "ios" && hostPlatform !== "mac")
+        continue;
+      const hasAppStep = deps.isAppDriverRequired({ test: context });
+      const gate = deps.mobileBrowserGate({
+        platform: mobileTarget,
+        browser: context.browser,
+        hasBrowserStep: deps.isBrowserRequired({ test: context }),
+        hasAppStep
+      });
+      if (gate.action !== "proceed")
+        continue;
+      const isMobileWeb = typeof gate.browserName === "string";
+      if (!isMobileWeb && !hasAppStep)
+        continue;
+      const driverPackage = deps.appDriverPlatforms[mobileTarget]?.driverPackage;
+      if (driverPackage) {
+        addTask({
+          name: `driver-install:${driverPackage}`,
+          kind: "driver-install",
+          exclusiveResources: [RUNTIME_INSTALL_RESOURCE],
+          payload: { driverPackage, platform: mobileTarget }
+        });
+      }
+      for (const stepDevice of deps.collectDeviceDescriptors(context)) {
+        const desc = deps.normalizeDeviceDescriptor({
+          contextDevice: context.device,
+          stepDevice,
+          platform: mobileTarget
+        });
+        const identity = deviceIdentity(mobileTarget, desc);
+        const tag = deviceResourceTag(mobileTarget, desc);
+        if (!bootPlannedFor.has(mobileTarget)) {
+          bootPlannedFor.add(mobileTarget);
+          addTask({
+            name: `device-boot:${identity}`,
+            kind: "device-boot",
+            exclusiveResources: [tag],
+            payload: { platform: mobileTarget, desc }
+          });
+        }
+        if (mobileTarget === "android" && isMobileWeb) {
+          addTask({
+            name: `chromedriver-prefetch:${identity}`,
+            kind: "chromedriver-prefetch",
+            exclusiveResources: [tag],
+            payload: { platform: mobileTarget, desc }
+          });
+        }
+      }
+      if (mobileTarget === "ios") {
+        addTask({
+          name: "wda-check",
+          kind: "wda-check",
+          // Read-only (plus the last-used stamp) — contends with nothing.
+          exclusiveResources: [],
+          payload: {}
+        });
+      }
+      continue;
+    }
+    if (deps.isBrowserRequired({ test: context })) {
+      const effBrowser = context.browser ?? getDefaultBrowser2();
+      const browserName = effBrowser?.name;
+      if (browserName && effPlatform === hostPlatform) {
+        probeEligible = true;
+        if (deps.requiredBrowserAssets(browserName).length > 0) {
+          addTask({
+            name: `browser-install:${browserName.toLowerCase()}`,
+            kind: "browser-install",
+            exclusiveResources: [RUNTIME_INSTALL_RESOURCE],
+            payload: { browserName }
+          });
+        }
+      }
+    }
+    if ((effPlatform === "windows" || effPlatform === "mac") && effPlatform === hostPlatform && deps.isAppDriverRequired({ test: context })) {
+      const driverPackage = deps.appDriverPlatforms[effPlatform]?.driverPackage;
+      if (driverPackage) {
+        addTask({
+          name: `driver-install:${driverPackage}`,
+          kind: "driver-install",
+          exclusiveResources: [RUNTIME_INSTALL_RESOURCE],
+          payload: { driverPackage, platform: effPlatform }
+        });
+      }
+    }
+  }
+  if (limit > 1 && hasAppiumPool && probeEligible) {
+    addTask({
+      name: "session-probe",
+      kind: "session-probe",
+      // Its install half mutates the shared caches, exactly like the
+      // dedicated install tasks (usually a memo hit by the time it runs).
+      exclusiveResources: [RUNTIME_INSTALL_RESOURCE],
+      payload: {}
+    });
+  }
+  return tasks;
+}
+async function executeWarmTasks({ tasks, registry, runTask, log: log3, now = Date.now }) {
+  const results = [];
+  const start = now();
+  await runResourceAware(tasks, WARM_POOL_LIMIT, registry, async (task) => {
+    const taskStart = now();
+    try {
+      const { outcome, note } = await runTask(task);
+      results.push({
+        name: task.name,
+        kind: task.kind,
+        outcome,
+        durationMs: now() - taskStart,
+        ...note ? { note } : {}
+      });
+      if (outcome === "failed") {
+        log3("warning", `Warm task '${task.name}' failed (continuing)${note ? `: ${note}` : "."}`);
+      } else {
+        log3("debug", `Warm task '${task.name}': ${outcome}${note ? ` (${note})` : ""}.`);
+      }
+    } catch (error) {
+      const note = error?.message ?? String(error);
+      results.push({
+        name: task.name,
+        kind: task.kind,
+        outcome: "failed",
+        durationMs: now() - taskStart,
+        note
+      });
+      log3("warning", `Warm task '${task.name}' failed (continuing): ${note}`);
+    }
+  });
+  return { durationMs: now() - start, tasks: results };
+}
+function raceBootInitiation({ startAcquire, onError }) {
+  let initiatedResolve;
+  const initiated = new Promise((resolve) => {
+    initiatedResolve = resolve;
+  });
+  const acquired = (async () => {
+    try {
+      const result = await startAcquire(() => initiatedResolve());
+      if (result && typeof result === "object" && "skip" in result) {
+        return { outcome: "skipped", note: result.skip };
+      }
+      return { outcome: "warmed", note: "device ready" };
+    } catch (error) {
+      onError(error);
+      return {
+        outcome: "failed",
+        note: error?.message ?? String(error)
+      };
+    }
+  })();
+  return Promise.race([
+    initiated.then(() => ({
+      outcome: "warmed",
+      note: "boot initiated"
+    })),
+    acquired
+  ]);
+}
+
 // dist/core/tests.js
 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 {
@@ -648900,6 +649340,13 @@ async function teardownSimulatorRegistry(registry, shutdown) {
   for (const entry of registry.values()) {
     if (!entry.bootedByUs)
       continue;
+    if (entry.ready) {
+      try {
+        await entry.ready;
+      } catch {
+        continue;
+      }
+    }
     try {
       await shutdown(entry);
     } catch {
@@ -648909,7 +649356,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 +649413,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 +649489,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 +649508,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 +649516,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 +649684,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 +649838,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) => {
@@ -649436,6 +649883,20 @@ function combinationKey(context) {
 function warmUpDecision(prev) {
   return prev === "failed" ? "skip" : "attempt";
 }
+function buildWarmPlanDeps() {
+  return {
+    isBrowserRequired,
+    isAppDriverRequired,
+    isMobileTargetPlatform,
+    getDefaultBrowser,
+    requiredBrowserAssets,
+    collectDeviceDescriptors,
+    normalizeDeviceDescriptor,
+    mobileBrowserGate,
+    contextRequirementsSkipMessage,
+    appDriverPlatforms: APP_DRIVER_PLATFORMS
+  };
+}
 function getDriverCapabilities({ runnerDetails, name, options }) {
   let capabilities = {};
   let args = [];
@@ -650015,7 +650476,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,
@@ -650045,7 +650506,12 @@ async function runSpecs({ resolvedTests }) {
         skipped: 0
       }
     },
-    specs: []
+    specs: [],
+    // Inline warm phase results (docs/design/warm-phase.md). Present on the
+    // skeleton so a run that plans nothing (or whose planning fails —
+    // best-effort) still reports the structural empty block; the phase
+    // overwrites it with real task results below.
+    warm: { durationMs: 0, tasks: [] }
   };
   let limit = resolveConcurrentRunners(config);
   log(config, "info", "Running test specs.");
@@ -650200,6 +650666,7 @@ async function runSpecs({ resolvedTests }) {
     const serverCount = Math.min(limit, browserPoolJobCount);
     log(config, "debug", `Starting ${serverCount} Appium server(s).`);
     try {
+      const readinessWaits = [];
       for (let i = 0; i < serverCount; i++) {
         let display;
         if (useXvfbDisplays) {
@@ -650207,7 +650674,16 @@ async function runSpecs({ resolvedTests }) {
           xvfbProcesses.push(await startXvfb(display));
           log(config, "debug", `Started Xvfb on ${display} for recording.`);
         }
-        appiumServers.push(await startAppiumServer(appiumEntry, config, display));
+        const server = await spawnAppiumServer(appiumEntry, config, display);
+        appiumServers.push(server);
+        const wait2 = appiumIsReady(server.port);
+        wait2.catch(() => {
+        });
+        readinessWaits.push(wait2);
+      }
+      await Promise.all(readinessWaits);
+      for (const server of appiumServers) {
+        log(config, "debug", `Appium is ready on port ${server.port}.`);
       }
     } catch (error) {
       await Promise.all(appiumServers.map((server) => {
@@ -650230,6 +650706,7 @@ async function runSpecs({ resolvedTests }) {
   const processRegistry = /* @__PURE__ */ new Map();
   const deviceRegistry = createDeviceRegistry();
   const simulatorRegistry = createSimulatorRegistry();
+  const resourceRegistry = createResourceRegistry();
   const killAllRegistered = async () => {
     const entries = [...processRegistry.entries()];
     processRegistry.clear();
@@ -650241,7 +650718,7 @@ async function runSpecs({ resolvedTests }) {
       }
       if (entry?.tempPath) {
         try {
-          import_node_fs28.default.unlinkSync(entry.tempPath);
+          import_node_fs29.default.unlinkSync(entry.tempPath);
         } catch {
         }
       }
@@ -650266,15 +650743,35 @@ async function runSpecs({ resolvedTests }) {
   process.on("SIGINT", onSignal);
   process.on("SIGTERM", onSignal);
   try {
-    if (limit > 1 && appiumPool) {
-      await warmUpContexts({
-        jobs: sizingJobs,
-        config,
+    try {
+      const warmTasks = planWarmTasks({
+        sizingJobs,
         runnerDetails,
-        appiumPool,
-        installAttempts,
-        warmUpResults
+        limit,
+        hasAppiumPool: !!appiumPool,
+        deps: buildWarmPlanDeps()
       });
+      if (warmTasks.length > 0) {
+        log(config, "debug", `Warm phase: ${warmTasks.length} task(s).`);
+        report.warm = await executeWarmTasks({
+          tasks: warmTasks,
+          registry: resourceRegistry,
+          runTask: buildWarmTaskRunner({
+            config,
+            runnerDetails,
+            sizingJobs,
+            appiumPool,
+            installAttempts,
+            warmUpResults,
+            deviceRegistry,
+            simulatorRegistry,
+            resourceRegistry
+          }),
+          log: (level, message) => log(config, level, message)
+        });
+      }
+    } catch (error) {
+      log(config, "warning", `Warm phase skipped (planning failed; the run proceeds with on-demand provisioning): ${error?.message ?? error}`);
     }
     const runJob = async (job) => {
       try {
@@ -650326,7 +650823,6 @@ async function runSpecs({ resolvedTests }) {
       const phase = PHASES.includes(entry.spec?._phase) ? entry.spec._phase : "main";
       routedByPhase[phase].push(entry);
     }
-    const resourceRegistry = createResourceRegistry();
     for (const phase of PHASES) {
       if (limit > 1) {
         await runResourceAware(jobsByPhase[phase], limit, resourceRegistry, runJob);
@@ -650640,27 +651136,17 @@ async function warmUpContexts({ jobs, config, runnerDetails, appiumPool, install
       platform
     });
     if (!supported && context.platform === platform && Array.isArray(context?.steps) && requiredBrowserAssets(context.browser?.name).length > 0) {
-      const firstAttempt = !installAttempts.has((context.browser?.name ?? "<none>").toLowerCase());
-      const outcome = await ensureContextBrowserInstalled({
+      await warmBrowserInstall({
         browserName: context.browser?.name,
         config,
-        installAttempts,
-        deps: {
-          ensureBrowser: (asset, options) => ensureBrowserInstalled(asset, options),
-          log
-        },
-        // Repair a present-but-broken driver, not just install-if-missing.
-        repair: true
+        runnerDetails,
+        installAttempts
+      });
+      supported = isSupportedContext({
+        context,
+        apps: runnerDetails.availableApps,
+        platform
       });
-      if (firstAttempt && (outcome === "installed" || outcome === "failed")) {
-        clearAppCache(config);
-        runnerDetails.availableApps = await getAvailableApps({ config });
-        supported = isSupportedContext({
-          context,
-          apps: runnerDetails.availableApps,
-          platform
-        });
-      }
     }
     if (!supported)
       continue;
@@ -650702,6 +651188,292 @@ async function warmUpContexts({ jobs, config, runnerDetails, appiumPool, install
     }
   }
 }
+async function warmBrowserInstall({ browserName, config, runnerDetails, installAttempts, deps = {} }) {
+  const appName = normalizeBrowserName(browserName);
+  if (runnerDetails.availableApps?.find((app) => app.name === appName)) {
+    return {
+      outcome: "skipped",
+      note: `'${browserName}' is already available`
+    };
+  }
+  const firstAttempt = !installAttempts.has((browserName ?? "<none>").toLowerCase());
+  const outcome = await ensureContextBrowserInstalled({
+    browserName,
+    config,
+    installAttempts,
+    deps: {
+      ensureBrowser: deps.ensureBrowser ?? ((asset, options) => ensureBrowserInstalled(asset, options)),
+      log
+    },
+    // Repair a present-but-broken driver, not just install-if-missing.
+    repair: true
+  });
+  if (firstAttempt && (outcome === "installed" || outcome === "failed")) {
+    (deps.clearAppCache ?? clearAppCache)(config);
+    runnerDetails.availableApps = await (deps.getAvailableApps ?? getAvailableApps)({ config });
+  }
+  if (outcome === "installed")
+    return { outcome: "warmed" };
+  if (outcome === "failed") {
+    return { outcome: "failed", note: `couldn't install '${browserName}'` };
+  }
+  return {
+    outcome: "skipped",
+    note: `'${browserName}' has no installable assets`
+  };
+}
+async function resolveAndroidWarmEnv(config) {
+  try {
+    const abi = hostAbi();
+    const sdk = detectAndroidSdk({ cacheDir: config?.cacheDir });
+    if (!sdk?.emulator)
+      return null;
+    const deviceDeps = buildAcquireDeviceDeps(sdk, abi, (m) => log(config, "debug", m));
+    const running = await deviceDeps.listRunning();
+    const capable = running.length > 0 || await checkEmulatorAcceleration(sdk.emulator);
+    if (!capable)
+      return null;
+    return { sdkRoot: sdk.sdkRoot, deviceDeps };
+  } catch {
+    return null;
+  }
+}
+async function probeIosToolchainWarm() {
+  if (process.platform !== "darwin")
+    return probeIosToolchain();
+  const runAsync = (command, args, timeout) => new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    try {
+      const child = (0, import_node_child_process15.spawn)(command, args, { windowsHide: true, timeout });
+      child.stdout?.on("data", (d) => stdout += String(d));
+      child.stderr?.on("data", (d) => stderr += String(d));
+      child.on("error", () => resolve({ status: null, stdout, stderr }));
+      child.on("close", (status) => resolve({ status, stdout, stderr }));
+    } catch {
+      resolve({ status: null, stdout, stderr });
+    }
+  });
+  const [xcodeSelect, simctl] = await Promise.all([
+    runAsync("xcode-select", ["-p"], 15e3),
+    // Same generous ceiling as the sync probe's xcrun spawn: the first cold
+    // simctl call launches CoreSimulatorService.
+    runAsync("xcrun", ["simctl", "list", "devices", "available"], 12e4)
+  ]);
+  return probeIosToolchain({
+    run: (command) => command === "xcrun" ? simctl : xcodeSelect
+  });
+}
+function buildWarmTaskRunner({ config, runnerDetails, sizingJobs, appiumPool, installAttempts, warmUpResults, deviceRegistry, simulatorRegistry, resourceRegistry }) {
+  let androidEnv;
+  const getAndroidEnv = () => androidEnv ??= resolveAndroidWarmEnv(config);
+  let iosToolchain;
+  const getIosToolchain = () => iosToolchain ??= probeIosToolchainWarm();
+  const acquireLease = async (names) => {
+    while (!resourceRegistry.tryAcquire(names)) {
+      await resourceRegistry.waitForFree();
+    }
+    let released = false;
+    return () => {
+      if (released)
+        return;
+      released = true;
+      resourceRegistry.release(names);
+    };
+  };
+  const withRuntimeInstallLock = async (fn) => {
+    const release = await acquireLease([RUNTIME_INSTALL_RESOURCE]);
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  };
+  let androidPreflight;
+  const getAndroidPreflight = () => androidPreflight ??= withRuntimeInstallLock(() => appSurfacePreflight({ config, platform: "android" }));
+  return async (task) => {
+    switch (task.kind) {
+      case "browser-install":
+        return warmBrowserInstall({
+          browserName: task.payload.browserName,
+          config,
+          runnerDetails,
+          installAttempts
+        });
+      case "driver-install": {
+        if (task.payload.platform === "android") {
+          const env = await getAndroidEnv();
+          if (!env) {
+            return {
+              outcome: "skipped",
+              note: "Android toolchain not ready; the driver install stays with the consuming context"
+            };
+          }
+        }
+        if (task.payload.platform === "ios") {
+          const toolchain = await getIosToolchain();
+          if (!toolchain.ok) {
+            return { outcome: "skipped", note: toolchain.reason };
+          }
+        }
+        const { ensureRuntimeInstalled: ensureRuntimeInstalled2 } = await Promise.resolve().then(() => (init_loader(), loader_exports));
+        await ensureRuntimeInstalled2([task.payload.driverPackage], {
+          ctx: { cacheDir: config?.cacheDir },
+          deps: { logger: (m) => log(config, "debug", m) }
+        });
+        return { outcome: "warmed" };
+      }
+      case "device-boot": {
+        const desc = task.payload.desc;
+        const onError = (error) => log(config, "warning", `Warm boot of '${task.name}' failed (a consuming context will retry): ${error?.message ?? String(error)}`);
+        if (task.payload.platform === "android") {
+          const env = await getAndroidEnv();
+          if (!env) {
+            return {
+              outcome: "skipped",
+              note: "Android toolchain not ready; device setup stays with the consuming context"
+            };
+          }
+          const releaseEmulatorLease = await acquireLease([
+            "android-emulator"
+          ]);
+          return raceBootInitiation({
+            onError,
+            startAcquire: (signalInitiated) => {
+              const acquiring = acquireDevice({
+                desc,
+                registry: deviceRegistry,
+                sdkRoot: env.sdkRoot,
+                deps: wrapInitiationEffects(env.deviceDeps, ["createAvd", "boot"], signalInitiated)
+              });
+              acquiring.then(() => releaseEmulatorLease(), () => releaseEmulatorLease());
+              return acquiring;
+            }
+          });
+        }
+        const toolchain = await getIosToolchain();
+        if (!toolchain.ok) {
+          return { outcome: "skipped", note: toolchain.reason };
+        }
+        const simDeps = buildAcquireSimulatorDeps((m) => log(config, "debug", m));
+        return raceBootInitiation({
+          onError,
+          startAcquire: (signalInitiated) => acquireSimulator({
+            desc,
+            registry: simulatorRegistry,
+            deps: wrapInitiationEffects(simDeps, ["create", "boot"], signalInitiated)
+          })
+        });
+      }
+      case "wda-check": {
+        const hit = locateManagedWda({ ctx: { cacheDir: config?.cacheDir } });
+        if (hit) {
+          return {
+            outcome: "warmed",
+            note: `prebuilt WebDriverAgent available (${hit.key})`
+          };
+        }
+        return {
+          outcome: "skipped",
+          note: "no prebuilt WebDriverAgent for the current toolchain \u2014 `doc-detective install ios` prebuilds it"
+        };
+      }
+      case "session-probe": {
+        if (!appiumPool) {
+          return { outcome: "skipped", note: "no browser Appium pool" };
+        }
+        await warmUpContexts({
+          jobs: sizingJobs,
+          config,
+          runnerDetails,
+          appiumPool,
+          installAttempts,
+          warmUpResults
+        });
+        const ok = [...warmUpResults.values()].filter((v) => v === "ok").length;
+        const failed = warmUpResults.size - ok;
+        return {
+          outcome: "warmed",
+          note: `${ok} combination${ok === 1 ? "" : "s"} ok${failed ? `, ${failed} failed` : ""}`
+        };
+      }
+      case "chromedriver-prefetch":
+        return prefetchMobileChromedriver({
+          config,
+          desc: task.payload.desc,
+          deviceRegistry,
+          getAndroidEnv,
+          deps: {
+            // The cache-mutating half (driver install + Appium co-homing)
+            // runs once per run under the manual runtime-install lease, so
+            // the prefetch task itself only holds its device tag while it
+            // awaits readiness and runs the throwaway session.
+            appSurfacePreflight: () => getAndroidPreflight(),
+            acquireEmulatorLease: () => acquireLease(["android-emulator"])
+          }
+        });
+    }
+  };
+}
+async function prefetchMobileChromedriver({ config, desc, deviceRegistry, getAndroidEnv, deps = {} }) {
+  const preflight = deps.appSurfacePreflight ?? appSurfacePreflight;
+  const acquire = deps.acquireDevice ?? acquireDevice;
+  const startServer = deps.startAppiumServer ?? startAppiumServer;
+  const startDriver = deps.driverStart ?? driverStart;
+  const kill4 = deps.killTree ?? killTree;
+  const env = await getAndroidEnv();
+  if (!env) {
+    return {
+      outcome: "skipped",
+      note: "Android toolchain not ready; the first mobile-web session downloads chromedriver as needed"
+    };
+  }
+  const pre = await preflight({ config, platform: "android" });
+  if (!pre.ok)
+    return { outcome: "skipped", note: pre.reason };
+  const releaseLease = deps.acquireEmulatorLease ? await deps.acquireEmulatorLease() : void 0;
+  let acquired;
+  try {
+    acquired = await acquire({
+      desc,
+      registry: deviceRegistry,
+      sdkRoot: env.sdkRoot,
+      deps: env.deviceDeps
+    });
+  } finally {
+    releaseLease?.();
+  }
+  if ("skip" in acquired)
+    return { outcome: "skipped", note: acquired.skip };
+  let server;
+  let driver;
+  try {
+    server = await startServer(pre.appiumEntry, config, void 0, {
+      APPIUM_HOME: pre.appiumHome,
+      ANDROID_HOME: env.sdkRoot,
+      ANDROID_SDK_ROOT: env.sdkRoot
+    }, CHROMEDRIVER_AUTODOWNLOAD_ARGS);
+    driver = await startDriver(buildMobileBrowserCapabilities({
+      platform: "android",
+      udid: acquired.entry.udid,
+      cacheDir: getCacheDir({ cacheDir: config?.cacheDir })
+    }), server.port, 2, { cacheDir: config?.cacheDir });
+    return {
+      outcome: "warmed",
+      note: `chromedriver ready for device '${acquired.entry.name}'`
+    };
+  } finally {
+    if (driver) {
+      try {
+        await driver.deleteSession();
+      } catch {
+      }
+    }
+    if (server) {
+      await kill4(server.process?.pid);
+    }
+  }
+}
 function specIsRouted(spec) {
   if (!spec || !Array.isArray(spec.tests))
     return false;
@@ -650818,7 +651590,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 +651619,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 +651628,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 +651641,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;
@@ -651049,7 +651821,8 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
     contextReport.resultDescription = errorMessage;
     return contextReport;
   }
-  clog("debug", `CONTEXT:
+  if (logLevelEnabled(config, "debug"))
+    clog("debug", `CONTEXT:
 ${JSON.stringify(context, null, 2)}`);
   let driver;
   let appiumPort;
@@ -651068,7 +651841,7 @@ ${JSON.stringify(context, null, 2)}`);
         env.ANDROID_HOME = appSession.androidSdkRoot;
         env.ANDROID_SDK_ROOT = appSession.androidSdkRoot;
       }
-      const extraArgs = mobileTarget === "android" ? ["--allow-insecure", "uiautomator2:chromedriver_autodownload"] : [];
+      const extraArgs = mobileTarget === "android" ? CHROMEDRIVER_AUTODOWNLOAD_ARGS : [];
       let acquired;
       try {
         const server = await startAppiumServer(appSession.appiumEntry, config, void 0, env, extraArgs);
@@ -651361,7 +652134,8 @@ ${JSON.stringify(context, null, 2)}`);
         stepExecutionFailed = true;
         break;
       }
-      clog("debug", `STEP:
+      if (logLevelEnabled(config, "debug"))
+        clog("debug", `STEP:
 ${JSON.stringify(step, null, 2)}`);
       if (step.unsafe && runnerDetails.allowUnsafeSteps === false) {
         clog("warning", `Skipping unsafe step: ${step.description} in test ${test.testId} context ${context.contextId}`);
@@ -651427,7 +652201,8 @@ ${JSON.stringify(step, null, 2)}`);
           processRegistry,
           appSession
         });
-        clog("debug", `RESULT: ${r.status}
+        if (logLevelEnabled(config, "debug"))
+          clog("debug", `RESULT: ${r.status}
 ${JSON.stringify(r, null, 2)}`);
         r.result = r.status;
         r.resultDescription = r.description;
@@ -651824,7 +652599,7 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
   }
   return actionResult;
 }
-async function startAppiumServer(appiumEntry, config, display, extraEnv, extraArgs) {
+async function spawnAppiumServer(appiumEntry, config, display, extraEnv, extraArgs) {
   const port = await findFreePort();
   log(config, "debug", `Starting Appium on port ${port}`);
   const env = display || extraEnv ? {
@@ -651832,9 +652607,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) => {
@@ -651844,31 +652619,41 @@ async function startAppiumServer(appiumEntry, config, display, extraEnv, extraAr
   });
   proc.stderr.on("data", () => {
   });
+  return { port, process: proc, display };
+}
+async function startAppiumServer(appiumEntry, config, display, extraEnv, extraArgs) {
+  const server = await spawnAppiumServer(appiumEntry, config, display, extraEnv, extraArgs);
   try {
-    await appiumIsReady(port);
+    await appiumIsReady(server.port);
   } catch (error) {
-    await killTree(proc?.pid);
+    await killTree(server.process?.pid);
     throw error;
   }
-  log(config, "debug", `Appium is ready on port ${port}.`);
-  return { port, process: proc, display };
+  log(config, "debug", `Appium is ready on port ${server.port}.`);
+  return server;
 }
-async function appiumIsReady(port, timeoutMs = 12e4) {
-  let isReady = false;
+var STATUS_PROBE_TIMEOUT_MS = 1e4;
+async function appiumIsReady(port, timeoutMs = 12e4, deps = {}) {
+  const probe = deps.probe ?? (async (p) => {
+    try {
+      const resp = await import_axios6.default.get(`http://127.0.0.1:${p}/status`, {
+        timeout: STATUS_PROBE_TIMEOUT_MS
+      });
+      return resp.status === 200;
+    } catch {
+      return false;
+    }
+  });
+  const sleep4 = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   const start = Date.now();
-  while (!isReady) {
+  while (true) {
+    if (await probe(port))
+      return true;
     if (Date.now() - start > timeoutMs) {
       throw new Error(`Appium server on port ${port} failed to start within ${timeoutMs / 1e3} seconds`);
     }
-    await new Promise((resolve) => setTimeout(resolve, 1e3));
-    try {
-      let resp = await import_axios6.default.get(`http://127.0.0.1:${port}/status`);
-      if (resp.status === 200)
-        isReady = true;
-    } catch {
-    }
+    await sleep4(250);
   }
-  return isReady;
 }
 async function driverStart(capabilities, port, maxAttempts = 4, ctx = {}) {
   const wdio = await loadHeavyDep("webdriverio", { ctx });
@@ -651980,9 +652765,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)}`);
@@ -652058,6 +652843,8 @@ function telemetryNotice(config) {
     log(config, "info", "Doc Detective collects basic anonymous telemetry to understand product issues and usage. To disable telemetry, set 'telemetry.send' to 'false' in your .doc-detective.json config file.");
   }
 }
+var TELEMETRY_FLUSH_TIMEOUT_MS = 2e3;
+var pendingTelemetryFlush = null;
 function sendTelemetry(config, command, results) {
   if (config?.telemetry?.send === false)
     return;
@@ -652098,7 +652885,7 @@ function sendTelemetry(config, command, results) {
   const event = { distinctId, event: command, properties: telemetryData };
   const client = new import_posthog_node.PostHog("phc_rjV0MH3nsAd45zFISLgaKAdAXbgDeXt2mOBV2EBHomB", { host: "https://app.posthog.com" });
   client.capture(event);
-  client.shutdown();
+  pendingTelemetryFlush = Promise.resolve(client.shutdown(TELEMETRY_FLUSH_TIMEOUT_MS)).then(() => void 0).catch(() => void 0);
 }
 
 // dist/core/index.js