@swmansion/argent 0.31.2-next.10 → 0.31.2-next.12

package/dist/cli-cmds.mjs

@@ -10456,6 +10456,8 @@ var FAILURE_CODES = {
   TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
   TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
   TOOL_DEPENDENCY_MISSING: "TOOL_DEPENDENCY_MISSING",
+  // Xcode's simctl or devicectl wrapper would start its component install and wait for a password.
+  TOOL_XCODE_FIRST_LAUNCH_PENDING: "TOOL_XCODE_FIRST_LAUNCH_PENDING",
   TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
   TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
   TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",
@@ -35807,7 +35809,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.31.2-next.10";
+    return "0.31.2-next.12";
   }
   return "0.0.0";
 }

package/dist/client.js

@@ -9029,6 +9029,8 @@ var FAILURE_CODES = {
   TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
   TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
   TOOL_DEPENDENCY_MISSING: "TOOL_DEPENDENCY_MISSING",
+  // Xcode's simctl or devicectl wrapper would start its component install and wait for a password.
+  TOOL_XCODE_FIRST_LAUNCH_PENDING: "TOOL_XCODE_FIRST_LAUNCH_PENDING",
   TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
   TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
   TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",

package/dist/installer.mjs

@@ -15793,6 +15793,8 @@ var FAILURE_CODES = {
   TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
   TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
   TOOL_DEPENDENCY_MISSING: "TOOL_DEPENDENCY_MISSING",
+  // Xcode's simctl or devicectl wrapper would start its component install and wait for a password.
+  TOOL_XCODE_FIRST_LAUNCH_PENDING: "TOOL_XCODE_FIRST_LAUNCH_PENDING",
   TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
   TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
   TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",
@@ -16932,7 +16934,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.31.2-next.10";
+    return "0.31.2-next.12";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -25739,6 +25739,8 @@ var FAILURE_CODES = {
   TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
   TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
   TOOL_DEPENDENCY_MISSING: "TOOL_DEPENDENCY_MISSING",
+  // Xcode's simctl or devicectl wrapper would start its component install and wait for a password.
+  TOOL_XCODE_FIRST_LAUNCH_PENDING: "TOOL_XCODE_FIRST_LAUNCH_PENDING",
   TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
   TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
   TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",

package/dist/tool-server.cjs

@@ -1499,6 +1499,8 @@ var init_failure_codes = __esm({
       TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
       TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
       TOOL_DEPENDENCY_MISSING: "TOOL_DEPENDENCY_MISSING",
+      // Xcode's simctl or devicectl wrapper would start its component install and wait for a password.
+      TOOL_XCODE_FIRST_LAUNCH_PENDING: "TOOL_XCODE_FIRST_LAUNCH_PENDING",
       TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
       TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
       TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",
@@ -79279,7 +79281,7 @@ function resolveHomeDir2() {
   return trimmed ? raw : os3.homedir();
 }
 function providersDirectory() {
-  return path12.join(resolveHomeDir2(), ".argent", "providers");
+  return path13.join(resolveHomeDir2(), ".argent", "providers");
 }
 function discoveryDisabled() {
   const raw = process.env[DISABLE_ENV];
@@ -79294,7 +79296,7 @@ function warnOnce(key2, message) {
 function readProviderFile(file2) {
   let raw;
   try {
-    raw = fs12.readFileSync(file2, "utf8");
+    raw = fs13.readFileSync(file2, "utf8");
   } catch {
     return void 0;
   }
@@ -79344,7 +79346,7 @@ function discoverProviders() {
 function descriptorFiles() {
   const directory = providersDirectory();
   try {
-    return fs12.readdirSync(directory).filter((name) => name.endsWith(".json")).sort().map((name) => path12.join(directory, name));
+    return fs13.readdirSync(directory).filter((name) => name.endsWith(".json")).sort().map((name) => path13.join(directory, name));
   } catch {
     return [];
   }
@@ -79405,13 +79407,13 @@ function readProviderDevices(record2, classify) {
   }
   return out;
 }
-var fs12, os3, path12, DISABLE_ENV, OVERRIDE_ENV, warnedOnce;
+var fs13, os3, path13, DISABLE_ENV, OVERRIDE_ENV, warnedOnce;
 var init_read = __esm({
   "../device-providers/src/read.ts"() {
     "use strict";
-    fs12 = __toESM(require("node:fs"));
+    fs13 = __toESM(require("node:fs"));
     os3 = __toESM(require("node:os"));
-    path12 = __toESM(require("node:path"));
+    path13 = __toESM(require("node:path"));
     init_contract();
     DISABLE_ENV = "ARGENT_DISABLE_DEVICE_PROVIDERS";
     OVERRIDE_ENV = "ARGENT_DEVICE_PROVIDERS";
@@ -83945,7 +83947,7 @@ async function adbShellInput(serial, shellCommand, input2, options = {}) {
   const adbPath = await resolveAdbOrThrow();
   const argv = adbArgv(["-s", serial, "shell", shellCommand]);
   return new Promise((resolve17, reject) => {
-    const child = (0, import_node_child_process15.execFile)(
+    const child = (0, import_node_child_process16.execFile)(
       adbPath,
       argv,
       {
@@ -84257,11 +84259,11 @@ async function hasDefaultBootSnapshot(avdName) {
     return false;
   }
 }
-var import_node_child_process15, import_node_util13, import_node_os5, import_node_path9, import_ini, execFileAsync13, emulatorFlagSupportCache, ADB_KILL_SIGNAL, ADB_DEVICE_STATES, ADB_DEVICES_TIMEOUT_MS, ENRICH_TIMEOUT_MS, androidRuntimeKindCache, TERMINAL_ADB_ERROR_PATTERNS, AVD_NAME_PATTERN;
+var import_node_child_process16, import_node_util13, import_node_os5, import_node_path9, import_ini, execFileAsync13, emulatorFlagSupportCache, ADB_KILL_SIGNAL, ADB_DEVICE_STATES, ADB_DEVICES_TIMEOUT_MS, ENRICH_TIMEOUT_MS, androidRuntimeKindCache, TERMINAL_ADB_ERROR_PATTERNS, AVD_NAME_PATTERN;
 var init_adb = __esm({
   "../tool-server/src/utils/adb.ts"() {
     "use strict";
-    import_node_child_process15 = require("node:child_process");
+    import_node_child_process16 = require("node:child_process");
     import_node_util13 = require("node:util");
     import_node_os5 = require("node:os");
     import_node_path9 = require("node:path");
@@ -84270,7 +84272,7 @@ var init_adb = __esm({
     init_android_binary();
     init_subprocess_error();
     init_external_devices();
-    execFileAsync13 = (0, import_node_util13.promisify)(import_node_child_process15.execFile);
+    execFileAsync13 = (0, import_node_util13.promisify)(import_node_child_process16.execFile);
     emulatorFlagSupportCache = /* @__PURE__ */ new Map();
     ADB_KILL_SIGNAL = "SIGKILL";
     ADB_DEVICE_STATES = /* @__PURE__ */ new Set([
@@ -101148,7 +101150,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.31.2-next.10";
+    return "0.31.2-next.12";
   }
   return "0.0.0";
 }
@@ -102013,7 +102015,6 @@ function createIdleTimer(timeoutMs, onIdle) {
 }
 
 // ../tool-server/src/utils/check-deps.ts
-init_src2();
 init_android_binary();
 
 // ../tool-server/src/utils/vega-cli.ts
@@ -102633,6 +102634,135 @@ async function hdcFileRecv(connectKey, remotePath, localPath, timeoutMs = DEFAUL
 
 // ../tool-server/src/utils/check-deps.ts
 init_command_on_path();
+
+// ../tool-server/src/utils/dependency-errors.ts
+init_src2();
+
+// ../tool-server/src/utils/xcode-first-launch.ts
+var fs11 = __toESM(require("node:fs"));
+var path11 = __toESM(require("node:path"));
+var import_node_child_process7 = require("node:child_process");
+var WRAPPER_DEVICES = {
+  simctl: "local iOS simulators",
+  devicectl: "physical iPhones"
+};
+var BUNDLED_DEVELOPER_DIR = path11.join("/Contents", "Developer");
+function shellWord(word) {
+  return /^[\w@%+=:,./-]+$/.test(word) ? word : `'${word.replaceAll("'", `'\\''`)}'`;
+}
+function activeXcode() {
+  const developerDir2 = activeDeveloperDir();
+  const xcode = developerDir2?.endsWith(BUNDLED_DEVELOPER_DIR) ? developerDir2.slice(0, -BUNDLED_DEVELOPER_DIR.length) : developerDir2;
+  const xcodebuild = developerDir2 ? shellWord(path11.join(developerDir2, "usr", "bin", "xcodebuild")) : "xcodebuild";
+  return { xcode, xcodebuild };
+}
+function xcodeInstallInstruction() {
+  const { xcode, xcodebuild } = activeXcode();
+  return `open ${xcode ? `the Xcode at ${xcode}` : "Xcode"} once, or run \`sudo ${xcodebuild} -runFirstLaunch\``;
+}
+function xcodeFirstLaunchHint(wrappers) {
+  const { xcode, xcodebuild } = activeXcode();
+  const names = wrappers.map((wrapper) => `\`${wrapper}\``);
+  const commands = wrappers.map((wrapper) => `\`xcrun ${wrapper}\``);
+  return (xcode ? `The Xcode at ${xcode}` : "Xcode") + ` has not finished installing its system components since it was installed or updated. Until it has, Xcode's ${names.join(" and ")} ${wrappers.length === 1 ? "waits" : "wait"} for an administrator password on every call, so \`list-devices\` does not show ${wrappers.map((wrapper) => WRAPPER_DEVICES[wrapper]).join(" or ")}. Tools that need ${names.join(" or ")} fail until then. Ask the user to open ${xcode ? "that Xcode" : "Xcode"} once and let it install the components, or to run \`sudo ${xcodebuild} -runFirstLaunch\`, then retry. Do not run that command${commands.length === 1 ? " or " : ", "}${commands.join(" or ")} yourself.`;
+}
+var XCODE_LOCATIONS = {
+  /** What `xcode-select -s` writes. */
+  selectLink: "/var/db/xcode_select_link",
+  /** What `xcode-select -p` answers without the link. */
+  defaultDeveloperDir: "/Applications/Xcode.app/Contents/Developer"
+};
+var locations = XCODE_LOCATIONS;
+function activeDeveloperDir() {
+  let dir = process.env.DEVELOPER_DIR || null;
+  if (!dir) {
+    try {
+      dir = fs11.readlinkSync(locations.selectLink);
+    } catch {
+      dir = fs11.existsSync(locations.defaultDeveloperDir) ? locations.defaultDeveloperDir : null;
+    }
+  }
+  if (!dir) return null;
+  const bundled = [
+    path11.resolve(dir, "Contents", "Developer"),
+    path11.resolve(dir, "Xcode.app", "Contents", "Developer")
+  ].find(isDirectory);
+  return bundled ?? path11.resolve(dir);
+}
+function isDirectory(file2) {
+  try {
+    return fs11.statSync(file2).isDirectory();
+  } catch {
+    return false;
+  }
+}
+var INSTALL_CALL = /^[ \t]*"\$\{DEVELOPER_DIR\}\/usr\/bin\/xcodebuild" -runFirstLaunch\b/m;
+var OLDER_RULE = /version_is_older "\$\{CURRENT_VERSION\}" "\$\{EXPECTED_VERSION\}"/;
+var DIFFERENT_RULE = /\[\[ "\$\{EXPECTED_VERSION\}" != "\$\{CURRENT_VERSION\}" \]\]/;
+function parseWrapper(file2) {
+  let text;
+  try {
+    text = fs11.readFileSync(file2, "utf8");
+  } catch {
+    return null;
+  }
+  const expected = /^EXPECTED_VERSION="([^"$]+)"$/m.exec(text)?.[1];
+  const plistPath = /Print :CFBundleVersion" "(\/[^"$]+)"/.exec(text)?.[1];
+  const rule = OLDER_RULE.test(text) ? "older" : DIFFERENT_RULE.test(text) ? "different" : null;
+  if (!expected || !plistPath || !rule || !INSTALL_CALL.test(text)) return null;
+  return { expected, plistPath, rule };
+}
+function readBundleVersion(plistPath) {
+  let data;
+  try {
+    data = fs11.readFileSync(plistPath);
+  } catch (err) {
+    return err.code === "ENOENT" ? "missing" : null;
+  }
+  if (data.toString("latin1", 0, 6) === "bplist") return readBinaryPlistVersion(plistPath);
+  const text = data.toString("utf8");
+  return /<key>CFBundleVersion<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1] ?? null;
+}
+var PLUTIL_TIMEOUT_MS = 1e3;
+function readBinaryPlistVersion(plistPath) {
+  try {
+    const version3 = (0, import_node_child_process7.execFileSync)(
+      "/usr/bin/plutil",
+      ["-extract", "CFBundleVersion", "raw", "-o", "-", plistPath],
+      {
+        encoding: "utf8",
+        timeout: PLUTIL_TIMEOUT_MS,
+        killSignal: "SIGKILL",
+        stdio: ["ignore", "pipe", "ignore"]
+      }
+    );
+    return version3.trim() || null;
+  } catch {
+    return null;
+  }
+}
+function isOlder(a, b) {
+  if (![a, b].every((version3) => /^\d+(\.\d+)*$/.test(version3))) return false;
+  const x = a.split(".").map(Number);
+  const y = b.split(".").map(Number);
+  for (let i = 0; i < Math.max(x.length, y.length); i++) {
+    const d = (x[i] ?? 0) - (y[i] ?? 0);
+    if (d !== 0) return d < 0;
+  }
+  return false;
+}
+function xcodeFirstLaunchPending(wrapper) {
+  if (process.platform !== "darwin") return false;
+  const devDir = activeDeveloperDir();
+  if (!devDir) return false;
+  const check3 = parseWrapper(path11.join(devDir, "usr", "bin", wrapper));
+  if (!check3) return false;
+  const installed = readBundleVersion(check3.plistPath);
+  if (installed === null) return false;
+  return installed === "missing" ? check3.rule === "different" : isOlder(installed, check3.expected);
+}
+
+// ../tool-server/src/utils/dependency-errors.ts
 var DependencyMissingError = class extends Error {
   missing;
   constructor(missing, message) {
@@ -102647,6 +102777,23 @@ var DependencyMissingError = class extends Error {
     });
   }
 };
+var XcodeFirstLaunchPendingError = class extends DependencyMissingError {
+  constructor(wrapper) {
+    super(["xcrun"], xcodeFirstLaunchHint([wrapper]));
+    this.name = "XcodeFirstLaunchPendingError";
+    withFailureSignal(this, {
+      error_code: FAILURE_CODES.TOOL_XCODE_FIRST_LAUNCH_PENDING,
+      failure_stage: "xcode_first_launch_check",
+      failure_area: "tool_server",
+      error_kind: "dependency_missing"
+    });
+  }
+};
+function assertXcodeFirstLaunchDone(wrapper) {
+  if (xcodeFirstLaunchPending(wrapper)) throw new XcodeFirstLaunchPendingError(wrapper);
+}
+
+// ../tool-server/src/utils/check-deps.ts
 var CACHE_TTL_MS2 = 6e4;
 var cache3 = /* @__PURE__ */ new Map();
 var INSTALL_HINTS = {
@@ -102916,10 +103063,10 @@ function buildScreenRecordingNote(recordings2, nowMs) {
 }
 
 // ../tool-server/src/utils/ios-device/team-detect.ts
-var import_node_child_process7 = require("node:child_process");
+var import_node_child_process8 = require("node:child_process");
 var import_node_util6 = require("node:util");
 var import_node_crypto5 = require("node:crypto");
-var execFileAsync6 = (0, import_node_util6.promisify)(import_node_child_process7.execFile);
+var execFileAsync6 = (0, import_node_util6.promisify)(import_node_child_process8.execFile);
 var SIGNING_CERT_COMMON_NAMES = ["Apple Development", "iPhone Developer"];
 var SECURITY_TIMEOUT_MS = 15e3;
 async function listCertificatePem(commonName) {
@@ -103064,14 +103211,14 @@ var import_express = __toESM(require_express2());
 init_src();
 
 // ../tool-server/src/blueprints/simulator-server.ts
-var import_node_child_process14 = require("node:child_process");
+var import_node_child_process15 = require("node:child_process");
 var readline = __toESM(require("node:readline"));
 init_src2();
 init_src();
 
 // ../tool-server/src/blueprints/ax-service.ts
 var net = __toESM(require("node:net"));
-var fs16 = __toESM(require("node:fs"));
+var fs17 = __toESM(require("node:fs"));
 
 // ../tool-server/src/utils/ndjson-socket.ts
 init_src2();
@@ -103220,10 +103367,10 @@ init_src2();
 init_external_devices();
 
 // ../tool-server/src/utils/ios-host.ts
-var import_node_child_process12 = require("node:child_process");
+var import_node_child_process13 = require("node:child_process");
 var import_node_events = require("node:events");
-var fs15 = __toESM(require("node:fs"));
-var path15 = __toESM(require("node:path"));
+var fs16 = __toESM(require("node:fs"));
+var path16 = __toESM(require("node:path"));
 var import_node_util11 = require("node:util");
 
 // ../tool-server/src/utils/simctl-config.ts
@@ -103231,13 +103378,13 @@ var SIMCTL_SPAWN_TIMEOUT_MS = 1e4;
 var SIMCTL_KILL_SIGNAL = "SIGKILL";
 
 // ../tool-server/src/utils/ios-device-sets.ts
-var fs13 = __toESM(require("node:fs"));
-var import_node_child_process8 = require("node:child_process");
+var fs14 = __toESM(require("node:fs"));
+var import_node_child_process9 = require("node:child_process");
 var import_node_util7 = require("node:util");
 init_src2();
 init_src();
 init_external_devices();
-var execFileAsync7 = (0, import_node_util7.promisify)(import_node_child_process8.execFile);
+var execFileAsync7 = (0, import_node_util7.promisify)(import_node_child_process9.execFile);
 var deviceSetByUdid = /* @__PURE__ */ new Map();
 function configuredAdditionalDeviceSets() {
   try {
@@ -103250,7 +103397,7 @@ function rememberDeviceSet(udid, deviceSet) {
   deviceSetByUdid.set(udid, deviceSet);
 }
 async function setContainsUdid(deviceSet, udid) {
-  if (deviceSet && !fs13.existsSync(deviceSet)) return false;
+  if (deviceSet && !fs14.existsSync(deviceSet)) return false;
   try {
     const { stdout } = await execFileAsync7(
       "xcrun",
@@ -103288,6 +103435,7 @@ function externalDeviceSet(udid) {
   return claim2 ? claim2.deviceSet ?? null : void 0;
 }
 function simctlPrefix(deviceSet) {
+  assertXcodeFirstLaunchDone("simctl");
   return deviceSet ? ["simctl", "--set", deviceSet] : ["simctl"];
 }
 async function simctlArgsForUdid(udid, args, options) {
@@ -103331,15 +103479,15 @@ function nativeArgs(udid, args) {
 }
 
 // ../tool-server/src/utils/ios-devices.ts
-var fs14 = __toESM(require("node:fs"));
-var path13 = __toESM(require("node:path"));
-var import_node_child_process9 = require("node:child_process");
+var fs15 = __toESM(require("node:fs"));
+var path14 = __toESM(require("node:path"));
+var import_node_child_process10 = require("node:child_process");
 var import_node_util8 = require("node:util");
 init_external_devices();
 init_device_info();
-var execFileAsync8 = (0, import_node_util8.promisify)(import_node_child_process9.execFile);
+var execFileAsync8 = (0, import_node_util8.promisify)(import_node_child_process10.execFile);
 async function listDeviceSetSimulators(deviceSet) {
-  if (deviceSet && !fs14.existsSync(deviceSet)) return [];
+  if (deviceSet && !fs15.existsSync(deviceSet)) return [];
   try {
     const { stdout } = await execFileAsync8(
       "xcrun",
@@ -103374,7 +103522,8 @@ async function listDeviceSetSimulators(deviceSet) {
       })
     );
     return out;
-  } catch {
+  } catch (err) {
+    if (err instanceof XcodeFirstLaunchPendingError) throw err;
     return [];
   }
 }
@@ -103420,10 +103569,11 @@ var deviceTypeBundlePaths = null;
 var foldableCache = /* @__PURE__ */ new Map();
 async function listDeviceTypeBundlePaths() {
   try {
-    const { stdout } = await execFileAsync8("xcrun", ["simctl", "list", "devicetypes", "--json"], {
-      timeout: 1e4,
-      killSignal: SIMCTL_KILL_SIGNAL
-    });
+    const { stdout } = await execFileAsync8(
+      "xcrun",
+      [...simctlPrefix(null), "list", "devicetypes", "--json"],
+      { timeout: 1e4, killSignal: SIMCTL_KILL_SIGNAL }
+    );
     const data = JSON.parse(stdout);
     const out = /* @__PURE__ */ new Map();
     for (const t of data.devicetypes ?? []) {
@@ -103445,8 +103595,8 @@ async function deviceTypeBundlePath(identifier) {
   return paths.get(identifier);
 }
 async function countIntegratedDisplays(bundlePath) {
-  const plist = path13.join(bundlePath, "Contents", "Resources", "capabilities.plist");
-  if (!fs14.existsSync(plist)) return 0;
+  const plist = path14.join(bundlePath, "Contents", "Resources", "capabilities.plist");
+  if (!fs15.existsSync(plist)) return 0;
   try {
     const { stdout } = await execFileAsync8(
       "plutil",
@@ -103482,10 +103632,10 @@ async function isFoldableSimulator(udid) {
 // ../tool-server/src/utils/ax-prefs.ts
 var fsAsync = __toESM(require("node:fs/promises"));
 var os4 = __toESM(require("node:os"));
-var path14 = __toESM(require("node:path"));
-var import_node_child_process10 = require("node:child_process");
+var path15 = __toESM(require("node:path"));
+var import_node_child_process11 = require("node:child_process");
 var import_node_util9 = require("node:util");
-var execFileAsync9 = (0, import_node_util9.promisify)(import_node_child_process10.execFile);
+var execFileAsync9 = (0, import_node_util9.promisify)(import_node_child_process11.execFile);
 async function ensureAutomationEnabled(udid) {
   await execFileAsync9(
     "xcrun",
@@ -103535,12 +103685,12 @@ async function isEntitlementBypassActive(udid) {
   }
 }
 async function accessibilityPlistPath(udid) {
-  const deviceSet = await deviceSetForUdid(udid) ?? path14.join(os4.homedir(), "Library/Developer/CoreSimulator/Devices");
-  return path14.join(deviceSet, udid, "data/Library/Preferences/com.apple.Accessibility.plist");
+  const deviceSet = await deviceSetForUdid(udid) ?? path15.join(os4.homedir(), "Library/Developer/CoreSimulator/Devices");
+  return path15.join(deviceSet, udid, "data/Library/Preferences/com.apple.Accessibility.plist");
 }
 async function setAccessibilityPrefsPreBoot(udid) {
   const plistPath = await accessibilityPlistPath(udid);
-  await fsAsync.mkdir(path14.dirname(plistPath), { recursive: true });
+  await fsAsync.mkdir(path15.dirname(plistPath), { recursive: true });
   const exists3 = await fsAsync.access(plistPath).then(() => true).catch(() => false);
   if (!exists3) {
     await execFileAsync9("plutil", ["-create", "binary1", plistPath]);
@@ -103556,10 +103706,10 @@ async function setAccessibilityPrefsPreBoot(udid) {
 }
 
 // ../tool-server/src/utils/sim-remote.ts
-var import_node_child_process11 = require("node:child_process");
+var import_node_child_process12 = require("node:child_process");
 var import_node_util10 = require("node:util");
 init_device_info();
-var execFileAsync10 = (0, import_node_util10.promisify)(import_node_child_process11.execFile);
+var execFileAsync10 = (0, import_node_util10.promisify)(import_node_child_process12.execFile);
 var DEFAULT_TIMEOUT_MS2 = 3e4;
 async function run(args, options) {
   try {
@@ -103733,7 +103883,7 @@ async function moqInfo(udid) {
 }
 
 // ../tool-server/src/utils/ios-host.ts
-var execFileAsync11 = (0, import_node_util11.promisify)(import_node_child_process12.execFile);
+var execFileAsync11 = (0, import_node_util11.promisify)(import_node_child_process13.execFile);
 var ARGENT_BOOTSTRAP_DYLIB_BASENAMES = /* @__PURE__ */ new Set(["libArgentInjectionBootstrap.dylib"]);
 var RECOGNISED_BOOTSTRAP_DYLIB_BASENAMES = /* @__PURE__ */ new Set([
   ...ARGENT_BOOTSTRAP_DYLIB_BASENAMES,
@@ -103759,13 +103909,13 @@ function shouldPreserveDyldInsertLibrariesEntry(entry, bootstrapPath) {
   if (entry === bootstrapPath) {
     return false;
   }
-  if (ARGENT_BOOTSTRAP_DYLIB_BASENAMES.has(path15.basename(entry))) {
+  if (ARGENT_BOOTSTRAP_DYLIB_BASENAMES.has(path16.basename(entry))) {
     return false;
   }
   if (entry.startsWith("@")) {
     return true;
   }
-  return fs15.existsSync(entry);
+  return fs16.existsSync(entry);
 }
 function preservedDyldInsertLibraries(currentValue, bootstrapPath) {
   return splitDyldInsertLibraries(currentValue).filter(
@@ -103964,7 +104114,7 @@ function spawnAxDaemonLocal(udid, endpoint) {
   }
   const endpointArgs = endpoint.transport === "tcp" ? ["--port", String(endpoint.port)] : ["--socket", endpoint.socketPath];
   const axTarget = simctlTargetForUdidSync(udid, { granted: "ax-service" });
-  const proc = (0, import_node_child_process12.execFile)(
+  const proc = (0, import_node_child_process13.execFile)(
     "xcrun",
     [
       ...axTarget.prefix,
@@ -104081,7 +104231,7 @@ function startListener(endpoint, onConnection) {
   return new Promise((resolve17, reject) => {
     if (endpoint.transport === "unix") {
       try {
-        fs16.unlinkSync(endpoint.socketPath);
+        fs17.unlinkSync(endpoint.socketPath);
       } catch {
       }
     }
@@ -104315,7 +104465,7 @@ var axServiceBlueprint = {
       server.close();
       if (endpoint.transport === "unix") {
         try {
-          fs16.unlinkSync(endpoint.socketPath);
+          fs17.unlinkSync(endpoint.socketPath);
         } catch {
         }
       }
@@ -104480,7 +104630,7 @@ var axServiceBlueprint = {
         server.close();
         if (endpoint.transport === "unix") {
           try {
-            fs16.unlinkSync(endpoint.socketPath);
+            fs17.unlinkSync(endpoint.socketPath);
           } catch {
           }
         }
@@ -105252,11 +105402,11 @@ __export(path_exports, {
   encode: () => encode3,
   from: () => from,
   hasPrefix: () => hasPrefix,
-  join: () => join16,
+  join: () => join17,
   normalizeRelative: () => normalizeRelative,
   parts: () => parts,
   relative: () => relative,
-  resolve: () => resolve6,
+  resolve: () => resolve7,
   stripPrefix: () => stripPrefix,
   tryResolve: () => tryResolve
 });
@@ -105302,7 +105452,7 @@ function stripPrefix(prefix, path58) {
   }
   return path58.slice(prefix.length + 1);
 }
-function join16(path58, other) {
+function join17(path58, other) {
   if (path58 === "") {
     return other;
   } else if (other === "") {
@@ -105319,7 +105469,7 @@ function normalizeRelative(rel) {
   const normalized = raw.filter((s) => s !== "" && s !== ".").join("/");
   return normalized === "" && raw.includes(".") ? "." : normalized;
 }
-function resolve6(base, rel) {
+function resolve7(base, rel) {
   if (rel === "")
     return base;
   const segments = base === "" ? [] : base.split("/");
@@ -114069,7 +114219,7 @@ var Publisher = class {
       }
       const advertise2 = async (suffix) => {
         if (legacy) {
-          return await this.#advertise(join16(prefix, suffix), requests, refused);
+          return await this.#advertise(join17(prefix, suffix), requests, refused);
         }
         await stream.writer.u53(SubscribeNamespaceEntry.id);
         await new SubscribeNamespaceEntry({ suffix, cluster: this.#advert }).encode(stream.writer, version3);
@@ -114077,7 +114227,7 @@ var Publisher = class {
       };
       const withdraw = async (suffix) => {
         if (legacy) {
-          await this.#withdraw(join16(prefix, suffix), requests);
+          await this.#withdraw(join17(prefix, suffix), requests);
         } else {
           await stream.writer.u53(SubscribeNamespaceEntryDone.id);
           await new SubscribeNamespaceEntryDone({ suffix }).encode(stream.writer, version3);
@@ -114103,7 +114253,7 @@ var Publisher = class {
             continue;
           updated.set(suffix, producer);
         }
-        const live = new Set([...updated.keys()].map((suffix) => join16(prefix, suffix)));
+        const live = new Set([...updated.keys()].map((suffix) => join17(prefix, suffix)));
         for (const path58 of [...refused.keys()]) {
           if (!live.has(path58))
             refused.delete(path58);
@@ -114118,13 +114268,13 @@ var Publisher = class {
         for (const [suffix, producer] of updated) {
           if (active.get(suffix) === producer)
             continue;
-          if (this.#offerable(join16(prefix, suffix), refused)) {
+          if (this.#offerable(join17(prefix, suffix), refused)) {
             if (await advertise2(suffix))
               held.set(suffix, producer);
           }
         }
         active = held;
-        const outstanding = [...updated].some(([suffix, producer]) => active.get(suffix) !== producer && this.#pending(join16(prefix, suffix), refused));
+        const outstanding = [...updated].some(([suffix, producer]) => active.get(suffix) !== producer && this.#pending(join17(prefix, suffix), refused));
         retry = outstanding ? Math.min(retry ? retry * 2 : RETRY_BASE, RETRY_MAX) : 0;
         const next = await (retry ? Promise.race([changed, stream.reader.closed, retryAfter(retry).then(() => broadcasts)]) : Promise.race([changed, stream.reader.closed]));
         dispose();
@@ -114770,7 +114920,7 @@ var Subscriber2 = class {
               const entry = await SubscribeNamespaceEntry.decode(stream.reader, version3, negotiated(this.#cluster));
               if (released)
                 break;
-              const path58 = join16(prefix, entry.suffix);
+              const path58 = join17(prefix, entry.suffix);
               if (this.#reflected(entry.cluster)) {
                 console.debug(`dropping reflected namespace: broadcast=${path58}`);
                 if (live.delete(path58))
@@ -114785,7 +114935,7 @@ var Subscriber2 = class {
               const entry = await SubscribeNamespaceEntryDone.decode(stream.reader, version3);
               if (released)
                 break;
-              const path58 = join16(prefix, entry.suffix);
+              const path58 = join17(prefix, entry.suffix);
               if (live.delete(path58)) {
                 this.#detachAnnounce(path58);
               }
@@ -117580,7 +117730,7 @@ var Subscriber3 = class {
         case Version2.DRAFT_02: {
           const init2 = await AnnounceInit.decode(stream.reader, this.version);
           for (const suffix of init2.suffixes) {
-            const path58 = join16(prefix, suffix);
+            const path58 = join17(prefix, suffix);
             if (advertised.has(suffix)) {
               throw new ProtocolViolation(`duplicate announce for ${path58}`);
             }
@@ -117639,7 +117789,7 @@ var Subscriber3 = class {
             break;
           }
         }
-        const path58 = join16(prefix, suffix);
+        const path58 = join17(prefix, suffix);
         const duplicateIsRestart = restartSupported(this.version) && !hasAnnounceId(this.version);
         if (announce.status === "active" && !duplicateIsRestart && advertised.has(suffix)) {
           throw new ProtocolViolation(`duplicate announce for ${path58}`);
@@ -122630,11 +122780,11 @@ function captureOnDemandDropped(deviceId, endpoint) {
 }
 
 // ../tool-server/src/utils/foldable.ts
-var import_node_child_process13 = require("node:child_process");
-var fs17 = __toESM(require("node:fs"));
+var import_node_child_process14 = require("node:child_process");
+var fs18 = __toESM(require("node:fs"));
 var import_node_util12 = require("node:util");
 init_external_devices();
-var execFileAsync12 = (0, import_node_util12.promisify)(import_node_child_process13.execFile);
+var execFileAsync12 = (0, import_node_util12.promisify)(import_node_child_process14.execFile);
 var MAIN_SCREEN_ID = 1;
 var AX_LIVE_PANEL_TIMEOUT_MS = 2e3;
 var DEVICECTL_TIMEOUT_MS = 5e3;
@@ -122710,7 +122860,13 @@ async function readCoreDeviceDisplays(udid) {
   const args = ["device", "info", "displays", "--device", nativeUdid, "--json-output", "-"];
   const dir = await developerDir();
   const env = dir ? { ...process.env, DEVELOPER_DIR: dir } : process.env;
-  const [bin, argv] = fs17.existsSync(DEVICECTL_BIN) ? [DEVICECTL_BIN, args] : ["xcrun", ["devicectl", ...args]];
+  const [bin, argv] = fs18.existsSync(DEVICECTL_BIN) ? [DEVICECTL_BIN, args] : ["xcrun", ["devicectl", ...args]];
+  if (bin === "xcrun" && xcodeFirstLaunchPending("devicectl")) {
+    return {
+      displays: null,
+      reason: "Xcode has not finished installing its components, so devicectl would wait for an administrator password"
+    };
+  }
   let stdout;
   try {
     ({ stdout } = await execFileAsync12(bin, argv, {
@@ -122847,7 +123003,11 @@ function postureForSize(size, panels) {
   return panel.screenId === MAIN_SCREEN_ID ? "the cover panel (closed)" : "the inner panel (half-open or open)";
 }
 async function foldablePostureHint(udid, expected, actual) {
-  if (!await isFoldableSimulator(udid)) return void 0;
+  const foldable = await isFoldableSimulator(udid).catch((err) => {
+    if (err instanceof XcodeFirstLaunchPendingError) return false;
+    throw err;
+  });
+  if (!foldable) return void 0;
   const panels = (await readCoreDeviceDisplays(udid)).displays?.panels;
   const base = "This simulator is foldable: a baseline belongs to the posture that produced it, and the cover and inner panels differ in size, so a capture in another posture can never match.";
   if (!panels) return `${base} Take the baseline in the posture under test.`;
@@ -122858,8 +123018,8 @@ async function foldablePostureHint(udid, expected, actual) {
 }
 
 // ../tool-server/src/utils/simulator-client.ts
-var fs18 = __toESM(require("node:fs/promises"));
-var path16 = __toESM(require("node:path"));
+var fs19 = __toESM(require("node:fs/promises"));
+var path17 = __toESM(require("node:path"));
 var os5 = __toESM(require("node:os"));
 var import_node_crypto6 = require("node:crypto");
 var import_node_url = require("node:url");
@@ -123340,11 +123500,11 @@ function routeViaTransport(transport, cmd) {
   }
 }
 function createMoqTransport(moq, options) {
-  const screenshotDir = path16.join(os5.tmpdir(), "argent-remote-screenshots");
+  const screenshotDir = path17.join(os5.tmpdir(), "argent-remote-screenshots");
   const writeScreenshotToDisk = async (bytes) => {
-    await fs18.mkdir(screenshotDir, { recursive: true });
-    const file2 = path16.join(screenshotDir, `${(0, import_node_crypto6.randomUUID)()}.png`);
-    await fs18.writeFile(file2, bytes);
+    await fs19.mkdir(screenshotDir, { recursive: true });
+    const file2 = path17.join(screenshotDir, `${(0, import_node_crypto6.randomUUID)()}.png`);
+    await fs19.writeFile(file2, bytes);
     return { url: (0, import_node_url.pathToFileURL)(file2).toString(), path: file2 };
   };
   return {
@@ -123510,7 +123670,7 @@ async function spawnSimulatorServerProcess(udid, subcommand) {
     if (sdkRoot)
       process.stderr.write(`[sim ${udid.slice(0, 8)}] android.sdkRoot \u2192 ANDROID_HOME=${sdkRoot}
 `);
-    const proc = (0, import_node_child_process14.spawn)(BINARY_PATH, args, {
+    const proc = (0, import_node_child_process15.spawn)(BINARY_PATH, args, {
       cwd: RUN_DIR,
       stdio: ["pipe", "pipe", "pipe"],
       ...sdkRoot ? { env: { ...process.env, ANDROID_HOME: sdkRoot } } : {}
@@ -123786,11 +123946,11 @@ function classifyDeviceForTelemetry(deviceId) {
 }
 
 // ../tool-server/src/utils/device-shutdown.ts
-var import_node_child_process16 = require("node:child_process");
+var import_node_child_process17 = require("node:child_process");
 var import_node_util14 = require("node:util");
 init_device_info();
 init_android_binary();
-var execFileAsync14 = (0, import_node_util14.promisify)(import_node_child_process16.execFile);
+var execFileAsync14 = (0, import_node_util14.promisify)(import_node_child_process17.execFile);
 var SHUTDOWN_EXEC_OPTIONS = { timeout: 3e4, killSignal: "SIGKILL" };
 async function shutdownOwnedDevice(id) {
   let platform;
@@ -123800,11 +123960,7 @@ async function shutdownOwnedDevice(id) {
     return;
   }
   if (platform === "ios") {
-    await execFileAsync14(
-      "xcrun",
-      await simctlArgsForUdid(id, ["shutdown", id]),
-      SHUTDOWN_EXEC_OPTIONS
-    ).catch(() => {
+    await simctlArgsForUdid(id, ["shutdown", id]).then((args) => execFileAsync14("xcrun", args, SHUTDOWN_EXEC_OPTIONS)).catch(() => {
     });
   } else if (platform === "android") {
     const adb = await resolveAndroidBinary("adb") ?? "adb";
@@ -123944,11 +124100,11 @@ function adbCommandPrefix(env) {
 }
 
 // ../tool-server/src/utils/ios-device/devicectl.ts
-var import_node_child_process17 = require("node:child_process");
+var import_node_child_process18 = require("node:child_process");
 var import_node_util15 = require("node:util");
-var fs19 = __toESM(require("node:fs/promises"));
+var fs20 = __toESM(require("node:fs/promises"));
 var os6 = __toESM(require("node:os"));
-var path17 = __toESM(require("node:path"));
+var path18 = __toESM(require("node:path"));
 var import_node_crypto7 = require("node:crypto");
 init_src2();
 
@@ -124208,7 +124364,7 @@ function invalidXmlError(detail) {
 }
 
 // ../tool-server/src/utils/ios-device/devicectl.ts
-var execFileAsync15 = (0, import_node_util15.promisify)(import_node_child_process17.execFile);
+var execFileAsync15 = (0, import_node_util15.promisify)(import_node_child_process18.execFile);
 var DEVICECTL_TIMEOUT_MS2 = 2e4;
 var DEVICECTL_INSTALL_TIMEOUT_MS = 12e4;
 var DEVICECTL_LIST_TIMEOUT_MS = 8e3;
@@ -124248,11 +124404,12 @@ function resolveDevicectlHint(output2, bundleId) {
   return "Ensure the device is unlocked, trusted, and visible in Xcode > Devices, then retry.";
 }
 async function runDevicectl(args, action, opts = {}) {
+  assertXcodeFirstLaunchDone("devicectl");
   const timeoutMs = opts.timeoutMs ?? DEVICECTL_TIMEOUT_MS2;
   let jsonPath = null;
   const argv = ["devicectl", ...args];
   if (opts.json) {
-    jsonPath = path17.join(os6.tmpdir(), `argent-devicectl-${process.pid}-${(0, import_node_crypto7.randomUUID)()}.json`);
+    jsonPath = path18.join(os6.tmpdir(), `argent-devicectl-${process.pid}-${(0, import_node_crypto7.randomUUID)()}.json`);
     argv.push("--json-output", jsonPath);
   }
   try {
@@ -124264,7 +124421,7 @@ async function runDevicectl(args, action, opts = {}) {
     let json2 = null;
     if (jsonPath) {
       try {
-        json2 = JSON.parse(await fs19.readFile(jsonPath, "utf8"));
+        json2 = JSON.parse(await fs20.readFile(jsonPath, "utf8"));
       } catch {
         json2 = null;
       }
@@ -124276,7 +124433,7 @@ async function runDevicectl(args, action, opts = {}) {
     let errorJson = null;
     if (jsonPath) {
       try {
-        errorJson = JSON.parse(await fs19.readFile(jsonPath, "utf8"));
+        errorJson = JSON.parse(await fs20.readFile(jsonPath, "utf8"));
       } catch {
         errorJson = null;
       }
@@ -124295,7 +124452,7 @@ async function runDevicectl(args, action, opts = {}) {
       }
     );
   } finally {
-    if (jsonPath) await fs19.rm(jsonPath, { force: true }).catch(() => {
+    if (jsonPath) await fs20.rm(jsonPath, { force: true }).catch(() => {
     });
   }
 }
@@ -124433,124 +124590,6 @@ async function ensureDeviceReady(udid) {
   readyMemo.set(udid, Date.now());
 }
 
-// ../tool-server/src/utils/xcode-first-launch.ts
-var fs20 = __toESM(require("node:fs"));
-var path18 = __toESM(require("node:path"));
-var import_node_child_process18 = require("node:child_process");
-var BUNDLED_DEVELOPER_DIR = path18.join("/Contents", "Developer");
-function shellWord(word) {
-  return /^[\w@%+=:,./-]+$/.test(word) ? word : `'${word.replaceAll("'", `'\\''`)}'`;
-}
-function activeXcode() {
-  const developerDir2 = activeDeveloperDir();
-  const xcode = developerDir2?.endsWith(BUNDLED_DEVELOPER_DIR) ? developerDir2.slice(0, -BUNDLED_DEVELOPER_DIR.length) : developerDir2;
-  const xcodebuild = developerDir2 ? shellWord(path18.join(developerDir2, "usr", "bin", "xcodebuild")) : "xcodebuild";
-  return { xcode, xcodebuild };
-}
-function xcodeInstallInstruction() {
-  const { xcode, xcodebuild } = activeXcode();
-  return `open ${xcode ? `the Xcode at ${xcode}` : "Xcode"} once, or run \`sudo ${xcodebuild} -runFirstLaunch\``;
-}
-function xcodeFirstLaunchHint() {
-  const { xcode, xcodebuild } = activeXcode();
-  return (xcode ? `The Xcode at ${xcode}` : "Xcode") + ` has not finished installing its system components since it was installed or updated. Until it has, Xcode's \`simctl\` waits for an administrator password on every call, so \`list-devices\` does not show local iOS simulators. Ask the user to open ${xcode ? "that Xcode" : "Xcode"} once and let it install the components, or to run \`sudo ${xcodebuild} -runFirstLaunch\`, then retry. Do not run that command or \`xcrun simctl\` yourself.`;
-}
-var XCODE_LOCATIONS = {
-  /** What `xcode-select -s` writes. */
-  selectLink: "/var/db/xcode_select_link",
-  /** What `xcode-select -p` answers without the link. */
-  defaultDeveloperDir: "/Applications/Xcode.app/Contents/Developer"
-};
-var locations = XCODE_LOCATIONS;
-function activeDeveloperDir() {
-  let dir = process.env.DEVELOPER_DIR || null;
-  if (!dir) {
-    try {
-      dir = fs20.readlinkSync(locations.selectLink);
-    } catch {
-      dir = fs20.existsSync(locations.defaultDeveloperDir) ? locations.defaultDeveloperDir : null;
-    }
-  }
-  if (!dir) return null;
-  const bundled = [
-    path18.resolve(dir, "Contents", "Developer"),
-    path18.resolve(dir, "Xcode.app", "Contents", "Developer")
-  ].find(isDirectory);
-  return bundled ?? path18.resolve(dir);
-}
-function isDirectory(file2) {
-  try {
-    return fs20.statSync(file2).isDirectory();
-  } catch {
-    return false;
-  }
-}
-var INSTALL_CALL = /^[ \t]*"\$\{DEVELOPER_DIR\}\/usr\/bin\/xcodebuild" -runFirstLaunch\b/m;
-var OLDER_RULE = /version_is_older "\$\{CURRENT_VERSION\}" "\$\{EXPECTED_VERSION\}"/;
-var DIFFERENT_RULE = /\[\[ "\$\{EXPECTED_VERSION\}" != "\$\{CURRENT_VERSION\}" \]\]/;
-function parseWrapper(file2) {
-  let text;
-  try {
-    text = fs20.readFileSync(file2, "utf8");
-  } catch {
-    return null;
-  }
-  const expected = /^EXPECTED_VERSION="([^"$]+)"$/m.exec(text)?.[1];
-  const plistPath = /Print :CFBundleVersion" "(\/[^"$]+)"/.exec(text)?.[1];
-  const rule = OLDER_RULE.test(text) ? "older" : DIFFERENT_RULE.test(text) ? "different" : null;
-  if (!expected || !plistPath || !rule || !INSTALL_CALL.test(text)) return null;
-  return { expected, plistPath, rule };
-}
-function readBundleVersion(plistPath) {
-  let data;
-  try {
-    data = fs20.readFileSync(plistPath);
-  } catch (err) {
-    return err.code === "ENOENT" ? "missing" : null;
-  }
-  if (data.toString("latin1", 0, 6) === "bplist") return readBinaryPlistVersion(plistPath);
-  const text = data.toString("utf8");
-  return /<key>CFBundleVersion<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1] ?? null;
-}
-var PLUTIL_TIMEOUT_MS = 1e3;
-function readBinaryPlistVersion(plistPath) {
-  try {
-    const version3 = (0, import_node_child_process18.execFileSync)(
-      "/usr/bin/plutil",
-      ["-extract", "CFBundleVersion", "raw", "-o", "-", plistPath],
-      {
-        encoding: "utf8",
-        timeout: PLUTIL_TIMEOUT_MS,
-        killSignal: "SIGKILL",
-        stdio: ["ignore", "pipe", "ignore"]
-      }
-    );
-    return version3.trim() || null;
-  } catch {
-    return null;
-  }
-}
-function isOlder(a, b) {
-  if (![a, b].every((version3) => /^\d+(\.\d+)*$/.test(version3))) return false;
-  const x = a.split(".").map(Number);
-  const y = b.split(".").map(Number);
-  for (let i = 0; i < Math.max(x.length, y.length); i++) {
-    const d = (x[i] ?? 0) - (y[i] ?? 0);
-    if (d !== 0) return d < 0;
-  }
-  return false;
-}
-function xcodeFirstLaunchPending() {
-  if (process.platform !== "darwin") return false;
-  const devDir = activeDeveloperDir();
-  if (!devDir) return false;
-  const check3 = parseWrapper(path18.join(devDir, "usr", "bin", "simctl"));
-  if (!check3) return false;
-  const installed = readBundleVersion(check3.plistPath);
-  if (installed === null) return false;
-  return installed === "missing" ? check3.rule === "different" : isOlder(installed, check3.expected);
-}
-
 // ../tool-server/src/tools/devices/list-devices.ts
 init_device_info();
 
@@ -126629,7 +126668,7 @@ Booted/ready devices are listed first. Platforms whose CLI is unavailable are si
   services: () => ({}),
   async execute(_services, _params) {
     const harmonyEnabled = isHarmonyEnabled();
-    const simctlWouldStartInstall = xcodeFirstLaunchPending();
+    const xcodeInstallPending = ["simctl", "devicectl"].filter(xcodeFirstLaunchPending);
     const [
       ios,
       iosPhysical,
@@ -126642,7 +126681,7 @@ Booted/ready devices are listed first. Platforms whose CLI is unavailable are si
       harmonyTargets,
       external
     ] = await Promise.all([
-      simctlWouldStartInstall ? [] : withDeadline(listIosSimulators(), [], "ios"),
+      xcodeInstallPending.includes("simctl") ? [] : withDeadline(listIosSimulators(), [], "ios"),
       withDeadline(
         listIosPhysicalDevices().catch(() => []),
         [],
@@ -126763,7 +126802,7 @@ Booted/ready devices are listed first. Platforms whose CLI is unavailable are si
     );
     const adbPrefix = adbCommandPrefix(process.env);
     const hints = [
-      ...simctlWouldStartInstall ? [xcodeFirstLaunchHint()] : [],
+      ...xcodeInstallPending.length > 0 ? [xcodeFirstLaunchHint(xcodeInstallPending)] : [],
       ...external.length > 0 ? [EXTERNAL_DEVICES_HINT] : [],
       ...adbPrefix ? [adbServerHint(adbPrefix)] : []
     ];
@@ -127249,6 +127288,9 @@ var VariantProposalStore = class {
 };
 var variantProposalStore = new VariantProposalStore();
 
+// ../tool-server/src/tools/describe/platforms/ios/index.ts
+init_src2();
+
 // ../tool-server/src/blueprints/native-devtools.ts
 var net3 = __toESM(require("node:net"));
 var fs24 = __toESM(require("node:fs"));
@@ -127325,7 +127367,11 @@ async function precheckNativeDevtools(api, udid, bundleId) {
   if (existing?.givenUp) return buildInitFailedResult(udid, existing);
   try {
     await api.ensureEnvReady();
-  } catch {
+  } catch (err) {
+    if (err instanceof XcodeFirstLaunchPendingError) {
+      if (bundleId !== void 0 && api.isConnected(bundleId)) return null;
+      throw err;
+    }
     const failure2 = api.getInitFailure();
     if (failure2) return buildInitFailedResult(udid, failure2);
     return buildInitFailedResult(udid, {
@@ -127335,7 +127381,8 @@ async function precheckNativeDevtools(api, udid, bundleId) {
     });
   }
   if (bundleId === void 0) return null;
-  const state3 = await api.appConnectionState(bundleId).catch(() => {
+  const state3 = await api.appConnectionState(bundleId).catch((err) => {
+    if (err instanceof XcodeFirstLaunchPendingError) throw err;
     const failure2 = api.getInitFailure();
     return failure2 ? buildInitFailedResult(udid, failure2) : "indeterminate";
   });
@@ -127458,6 +127505,7 @@ var nativeDevtoolsBlueprint = {
     const activatedBundleIds = /* @__PURE__ */ new Set();
     const events = new TypedEventEmitter();
     const noteInitFailure = (err) => {
+      if (err instanceof XcodeFirstLaunchPendingError) return;
       const lastError = err instanceof Error ? err.message : String(err);
       const attempts = (initFailure?.attempts ?? 0) + 1;
       const givenUp = attempts >= MAX_NATIVE_DEVTOOLS_INIT_ATTEMPTS;
@@ -128142,6 +128190,7 @@ async function describeIos(registry2, device, params, options = {}) {
     axApi = await registry2.resolveService(axRef.urn, axRef.options);
     degraded = axApi.degraded;
   } catch (err) {
+    if (isFirstLaunchRefusal(err)) throw err;
     resolverHint = tcpArtifactHint(err);
     degraded = resolverHint === void 0;
   }
@@ -128180,7 +128229,10 @@ async function describeIos(registry2, device, params, options = {}) {
   }
   try {
     const target = await resolveNativeTargetApp(nativeApi, params.bundleId);
-    const state3 = await nativeApi.appConnectionState(target.bundleId).catch(() => "indeterminate");
+    const state3 = await nativeApi.appConnectionState(target.bundleId).catch((err) => {
+      if (isFirstLaunchRefusal(err)) throw err;
+      return "indeterminate";
+    });
     if (state3 !== "connected") {
       const diagnosis = buildAppStateMessage(target.bundleId, state3);
       const merged = hint ? `${hint} ${diagnosis}` : diagnosis;
@@ -128200,6 +128252,9 @@ async function describeIos(registry2, device, params, options = {}) {
     return { tree, source: "ax-service", hint: unexplainedHint(hint, errMsg(err), params) };
   }
 }
+function isFirstLaunchRefusal(err) {
+  return getFailureSignal(err)?.error_code === FAILURE_CODES.TOOL_XCODE_FIRST_LAUNCH_PENDING;
+}
 function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -133948,8 +134003,7 @@ async function sendJson(socketPath, command, timeoutMs) {
     throw new Error(`tv-control got non-JSON reply to "${command}": ${raw.slice(0, 200)}`);
   }
 }
-function spawnAxDaemon(udid, socketPath) {
-  const axTarget = simctlTargetForUdidSync(udid, { granted: "ax-service" });
+function spawnAxDaemon(udid, socketPath, axTarget) {
   const proc = (0, import_node_child_process27.execFile)(
     "xcrun",
     [
@@ -134059,7 +134113,8 @@ var tvControlBlueprint = {
     const hidSock = hidSocketPath(udid);
     let disposed = false;
     await ensureAutomationEnabled(udid);
-    let axProc = spawnAxDaemon(udid, axSock);
+    const axTarget = () => simctlTargetForUdidSync(udid, { granted: "ax-service" });
+    let axProc = spawnAxDaemon(udid, axSock, axTarget());
     const hidProc = spawnHidDaemon(udid, hidSock);
     let axExited = false;
     const onAxExit = (_code) => {
@@ -134105,6 +134160,7 @@ var tvControlBlueprint = {
     }
     let axRespawn = null;
     async function spawnFreshAx() {
+      const target = axTarget();
       if (axProc && !axProc.killed) {
         axProc.removeListener("exit", onAxExit);
         axProc.removeListener("error", onAxError);
@@ -134115,10 +134171,10 @@ var tvControlBlueprint = {
         fs33.unlinkSync(axSock);
       } catch {
       }
-      axProc = spawnAxDaemon(udid, axSock);
-      axProc.on("exit", onAxExit);
-      axProc.on("error", onAxError);
       try {
+        axProc = spawnAxDaemon(udid, axSock, target);
+        axProc.on("exit", onAxExit);
+        axProc.on("error", onAxError);
         await waitForSocket(axSock, axProc, 15e3);
       } catch (err) {
         axExited = true;
@@ -136216,7 +136272,7 @@ var zodSchema2 = external_exports.object({
   bundleId: external_exports.string().describe("Bundle ID of the app to check (e.g. com.example.MyApp)")
 });
 function envSetupReading(api, connected) {
-  return api.isEnvSetup() && (connected || api.getInitFailure() === null);
+  return connected || api.isEnvSetup() && api.getInitFailure() === null;
 }
 var nativeDevtoolsStatusTool = {
   id: "native-devtools-status",
@@ -136266,6 +136322,7 @@ Fails if the simulator server is not running for the given UDID.`,
       try {
         appRunning2 = await api.isAppRunning(params.bundleId);
       } catch (err) {
+        if (err instanceof XcodeFirstLaunchPendingError) throw err;
         const failure2 = api.getInitFailure();
         if (failure2) return buildInitFailedResult(params.udid, failure2);
         throw err;
@@ -136279,9 +136336,20 @@ Fails if the simulator server is not running for the given UDID.`,
         injectable: false
       };
     }
-    const blocked = await precheckNativeDevtools(api, params.udid);
+    let blocked;
+    try {
+      blocked = await precheckNativeDevtools(api, params.udid);
+    } catch (err) {
+      if (!(err instanceof XcodeFirstLaunchPendingError) || !api.isConnected(params.bundleId)) {
+        throw err;
+      }
+      blocked = null;
+    }
     if (blocked) return blocked;
-    const measured = await api.appConnectionState(params.bundleId).catch(() => "indeterminate");
+    const measured = await api.appConnectionState(params.bundleId).catch((err) => {
+      if (err instanceof XcodeFirstLaunchPendingError) throw err;
+      return "indeterminate";
+    });
     const connected = measured === "connected";
     let appRunning;
     let state3 = measured;
@@ -141785,6 +141853,7 @@ function makeIosImpl(registry2) {
           ])
         );
       } catch (err) {
+        if (err instanceof XcodeFirstLaunchPendingError) throw err;
         throw new FailureError(
           `Failed to launch iOS app ${params.bundleId} on ${params.udid}.`,
           {
@@ -142286,6 +142355,7 @@ function makeIosImpl2(registry2) {
           await simctlArgsForUdid(udid, ["launch", udid, bundleId, ...params.launchArgs ?? []])
         );
       } catch (err) {
+        if (err instanceof XcodeFirstLaunchPendingError) throw err;
         throw new FailureError(
           `Failed to restart iOS app ${bundleId} on ${udid}.`,
           {
@@ -143079,6 +143149,7 @@ function buildIosHandler(backend) {
         await backend.run(udid, SIMCTL_ACTION[action], service, bundleId);
         applied.push(service);
       } catch (err) {
+        if (err instanceof XcodeFirstLaunchPendingError) throw err;
         if (!isPrimary) continue;
         const detail = err instanceof Error ? err.message : String(err);
         const shutdownHint = /current state:\s*shutdown/i.test(detail) ? " The simulator must be booted first \u2014 use boot-device." : "";
@@ -143331,6 +143402,7 @@ var iosImpl3 = {
         await simctlArgsForUdid(params.udid, ["openurl", params.udid, params.url])
       );
     } catch (err) {
+      if (err instanceof XcodeFirstLaunchPendingError) throw err;
       throw new FailureError(
         `Failed to open URL on iOS simulator ${params.udid}.`,
         {
@@ -147702,6 +147774,7 @@ init_adb();
 init_capability();
 
 // ../tool-server/src/utils/poll-describe-tree.ts
+init_src2();
 async function pollDescribeTree(args) {
   const { fetchTree, timeoutMs, pollIntervalMs, signal, onSample } = args;
   const start2 = Date.now();
@@ -147733,6 +147806,9 @@ async function pollDescribeTree(args) {
       break;
     }
     if (settled.type === "error") {
+      if (getFailureSignal(settled.cause)?.error_code === FAILURE_CODES.TOOL_XCODE_FIRST_LAUNCH_PENDING) {
+        throw settled.cause;
+      }
       lastError = settled.error;
     } else {
       lastData = settled.value;
@@ -156064,7 +156140,7 @@ Returns an error message string if the requestId is not found: use view-network-
   },
   async execute(services, params) {
     if (ANDROID_NATIVE_REQUEST_ID.test(params.requestId)) {
-      return androidNativeRequestDetails(params.requestId, params.includeBody);
+      return androidNativeRequestDetails(params.requestId, params.includeBody, params.device_id);
     }
     const device = resolveDevice(params.device_id);
     if (device.platform === "chromium") {
@@ -156171,11 +156247,13 @@ ${body.slice(0, MAX_BODY_SIZE)}...`;
     return details;
   }
 };
-async function androidNativeRequestDetails(requestId, includeBody) {
+function androidNativeNotFound(requestId, deviceId) {
+  const { platform } = resolveDevice(deviceId);
+  return platform === "chromium" || platform === "vega" ? `Request ${requestId} not found. An android- ID comes from an Android device. Use view-network-logs to list this device's requests.` : `Request ${requestId} not found. Use native-network-logs to list the requests the Android native layer recorded.`;
+}
+async function androidNativeRequestDetails(requestId, includeBody, deviceId) {
   const found = findAndroidNativeRecord(requestId);
-  if (!found) {
-    return `Request ${requestId} not found. Use native-network-logs to list the requests the Android native layer recorded.`;
-  }
+  if (!found) return androidNativeNotFound(requestId, deviceId);
   const { inspector, record: record2 } = found;
   const { wireHeaders } = record2.request;
   const bodyHeaders = record2.redirects?.[0]?.requestHeaders ?? wireHeaders ?? {};
@@ -157876,7 +157954,7 @@ async function androidSerials() {
   }
 }
 async function bootedSimulators() {
-  const simulators = await listIosSimulators();
+  const simulators = await listIosSimulators().catch(() => []);
   return simulators.filter((s) => s.state === "Booted").map((s) => s.udid);
 }
 async function logcatHolds(serial, marker) {
@@ -162826,6 +162904,7 @@ function enumerateRunningUserApps(udid) {
       }
     );
   } catch (err) {
+    if (err instanceof XcodeFirstLaunchPendingError) throw err;
     const msg = err instanceof Error ? err.message : String(err);
     throw new FailureError(
       `Failed to enumerate running processes on simulator ${udid} within ${DETECT_RUNNING_APP_TIMEOUT_MS} ms. Verify the simulator is booted and responsive, then retry. Underlying error: ${msg}`,
@@ -162906,7 +162985,8 @@ function resolveExplicitApp(udid, name) {
   let runningUserApps;
   try {
     runningUserApps = enumerateRunningUserApps(udid);
-  } catch {
+  } catch (err) {
+    if (err instanceof XcodeFirstLaunchPendingError) throw err;
     return { executable: name, pid: null };
   }
   const matched = runningUserApps.find(
@@ -162936,6 +163016,7 @@ function getInstalledApps(udid) {
       maxBuffer: DEFAULT_EXEC_MAX_BUFFER
     });
   } catch (err) {
+    if (err instanceof XcodeFirstLaunchPendingError) throw err;
     const msg = err instanceof Error ? err.message : String(err);
     throw new FailureError(
       `Failed to list installed apps on simulator ${udid} within ${DETECT_RUNNING_APP_TIMEOUT_MS} ms. Verify the simulator is booted and responsive, then retry. Underlying error: ${msg}`,
@@ -181574,7 +181655,7 @@ function startSimulatorWatcher(registry2) {
   let ticksToSkip = 0;
   let firstLaunchReported = false;
   function simctlWouldStartInstall() {
-    if (!xcodeFirstLaunchPending()) {
+    if (!xcodeFirstLaunchPending("simctl")) {
       firstLaunchReported = false;
       return false;
     }
@@ -181661,8 +181742,7 @@ function startSimulatorWatcher(registry2) {
     );
     for (const [udid, service] of trackedServices) {
       if (!booted.has(udid)) continue;
-      const failure2 = service.getInitFailure();
-      if (failure2 && !failure2.givenUp) {
+      if (!service.isEnvSetup() && !service.getInitFailure()?.givenUp) {
         pendingAttempts.push(service.ensureEnvReady().catch(() => {
         }));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.31.2-next.10",
+  "version": "0.31.2-next.12",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",