stim 1.36.0 → 1.38.0

package/dist/{hosted-logs-CClIktQM.mjs → hosted-logs-BpQSRDRU.mjs}

@@ -1,11 +1,11 @@
-import { t as getExecutor } from "./exec-CGuDzt40.mjs";
-import { E as workspaceDir, k as workspaceLogsDir$1 } from "./workspace-state-BhwAJBgA.mjs";
-import { l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { W as parseMachine$1, dt as deviceSlotFileKey, vt as validateDeviceSlot } from "./config-BA3TgoIP.mjs";
-import { n as macosDir } from "./state-B4B5P4LU.mjs";
-import { n as androidLogGroups, r as isAndroidCrashText } from "./android-5wkcMFDG.mjs";
+import { t as getExecutor } from "./exec-L37dbiIb.mjs";
+import { E as workspaceDir, k as workspaceLogsDir$1 } from "./workspace-state-CHEN_xzy.mjs";
+import { l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { W as parseMachine$1, dt as deviceSlotFileKey, vt as validateDeviceSlot } from "./config-CNmN-ndb.mjs";
+import { n as macosDir } from "./state-45P8Kd6Z.mjs";
+import { n as androidLogGroups, r as isAndroidCrashText } from "./android-DGLG_VQ3.mjs";
 import { c as readNdjsonGenerations$1, i as createNdjsonWriter } from "./ndjson-CrjIsGzw.mjs";
-import { l as call } from "./hosted-client-DMOOu8vD.mjs";
+import { l as call } from "./hosted-client-B_h_bTlz.mjs";
 import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { LOG_ROTATE_BYTES, ambientWrite, withDirLockAsync } from "@stim-cli/core";
@@ -39,6 +39,9 @@ function agentClientFiles() {
 }
 //#endregion
 //#region src/device-host/hosted-agent.ts
+function hostedAgentLine(agent, machine) {
+	return "command" in agent ? agent.command : `Agent control is unavailable on ${machine}. On that machine, check \`hosting.agentDriver\` (\`agent-device\` enables it) and the installed agent-device version.`;
+}
 /** Removes every driver's client file beside `file`, the placement's agent-device config path. */
 async function removeAgentAccess(file, keep) {
 	for (const name of agentClientFiles()) {
@@ -54,15 +57,19 @@ async function removeAgentAccess(file, keep) {
 async function agentAccess(file, credential, grant, note, platform = "macos", relay = `Agent control of apps hosted on ${credential.machine} over the local network is relayed only for hosted iOS and Android Debug runs.`) {
 	const machine = parseMachine$1(credential.machine);
 	const local = machine?.transport === "local";
+	const parsed = grant === void 0 ? null : parseHostedAgentGrant(grant);
+	if (parsed?.driver === "none") note(hostedAgentLine({
+		driver: "none",
+		setting: "hosting.agentDriver"
+	}, credential.machine));
 	if (local && typeof relay === "string") {
-		if (grant !== void 0) note(relay);
+		if (grant !== void 0 && parsed?.driver !== "none") note(relay);
 		await removeAgentAccess(file);
 		return {
 			driver: "none",
 			setting: "hosting.agentDriver"
 		};
 	}
-	const parsed = grant === void 0 ? null : parseHostedAgentGrant(grant);
 	const issued = parsed && "token" in parsed ? parsed : null;
 	const loaded = issued ? await agentDriverClient(issued.driver) : null;
 	if (grant !== void 0 && !parsed || loaded && "unavailable" in loaded) note(`${credential.machine} offered agent control this Stim does not support.`);
@@ -244,4 +251,4 @@ function readHostedNativeLogs(root, platform, slot) {
 	}));
 }
 //#endregion
-export { agentAccess as a, closeAgentConnection as i, pullHostedNativeLogs as n, removeAgentAccess as o, readHostedNativeLogs as r, pullHostedMacosLogs as t };
+export { agentAccess as a, closeAgentConnection as i, pullHostedNativeLogs as n, hostedAgentLine as o, readHostedNativeLogs as r, removeAgentAccess as s, pullHostedMacosLogs as t };

package/dist/{hosted-logs-sync-B7XCeqVm.mjs → hosted-logs-sync-D3L1hDpM.mjs}

@@ -1,8 +1,8 @@
-import { l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { n as pullHostedNativeLogs, r as readHostedNativeLogs, t as pullHostedMacosLogs } from "./hosted-logs-CClIktQM.mjs";
-import { u as connectHost } from "./hosted-client-DMOOu8vD.mjs";
-import { n as readHostedIos, t as readHostedAndroid } from "./ios-state-Avwz2cbZ.mjs";
-import "./hosted-macos-D4sDJIbB.mjs";
+import { l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { n as pullHostedNativeLogs, r as readHostedNativeLogs, t as pullHostedMacosLogs } from "./hosted-logs-BpQSRDRU.mjs";
+import { u as connectHost } from "./hosted-client-B_h_bTlz.mjs";
+import { n as readHostedIos, t as readHostedAndroid } from "./ios-state-tzD0s7pt.mjs";
+import "./hosted-macos-GK4O1s7x.mjs";
 import { watch } from "node:fs";
 import { dirname, relative, resolve, sep } from "node:path";
 import { ambientWrite, configDir } from "@stim-cli/core";

package/dist/{hosted-macos-D4sDJIbB.mjs → hosted-macos-GK4O1s7x.mjs}

@@ -1,9 +1,9 @@
-import { l as cancellableSleep } from "./exec-CGuDzt40.mjs";
-import { l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { a as agentAccess, i as closeAgentConnection, o as removeAgentAccess, t as pullHostedMacosLogs } from "./hosted-logs-CClIktQM.mjs";
-import { n as macosDir } from "./state-B4B5P4LU.mjs";
-import { _t as runCancellationSignal } from "./toolchain-DCnWAxQL.mjs";
-import { _ as sha256, a as RESERVE_TIMEOUT_MS, b as upload, c as bundleManifest, d as heldNoLonger, g as settle, i as PREPARE_TIMEOUT_MS, l as call, n as INSTALL_TIMEOUT_MS, o as SESSION_TIMEOUT_MS, p as hostedSession, s as attach, u as connectHost, v as stoppedSession, y as unknownSession } from "./hosted-client-DMOOu8vD.mjs";
+import { l as cancellableSleep } from "./exec-L37dbiIb.mjs";
+import { l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { a as agentAccess, i as closeAgentConnection, s as removeAgentAccess, t as pullHostedMacosLogs } from "./hosted-logs-BpQSRDRU.mjs";
+import { n as macosDir } from "./state-45P8Kd6Z.mjs";
+import { mt as runCancellationSignal } from "./toolchain-CZvtCZ-m.mjs";
+import { _ as sha256, a as RESERVE_TIMEOUT_MS, b as upload, c as bundleManifest, d as heldNoLonger, g as settle, i as PREPARE_TIMEOUT_MS, l as call, n as INSTALL_TIMEOUT_MS, o as SESSION_TIMEOUT_MS, p as hostedSession, s as attach, u as connectHost, v as stoppedSession, y as unknownSession } from "./hosted-client-B_h_bTlz.mjs";
 import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { ambientContext, ambientWrite } from "@stim-cli/core";

package/dist/{hosted-native-BiiUG_Q6.mjs → hosted-native-B6ur_0OJ.mjs}

@@ -1,11 +1,11 @@
-import { l as cancellableSleep, w as withDrainingCancellation } from "./exec-CGuDzt40.mjs";
-import { E as workspaceDir, l as withWorkspaceStateLockAsync, r as readWorkspaceState$1 } from "./workspace-state-BhwAJBgA.mjs";
-import { l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { a as agentAccess, i as closeAgentConnection, n as pullHostedNativeLogs, o as removeAgentAccess } from "./hosted-logs-CClIktQM.mjs";
-import { _t as runCancellationSignal } from "./toolchain-DCnWAxQL.mjs";
-import { _ as sha256, a as RESERVE_TIMEOUT_MS, b as upload, c as bundleManifest, d as heldNoLonger, g as settle, h as requireHostedAppMode, i as PREPARE_TIMEOUT_MS, l as call, n as INSTALL_TIMEOUT_MS, o as SESSION_TIMEOUT_MS, p as hostedSession, r as OFFER_TIMEOUT_MS, s as attach, t as IMAGE_INSTALL_TIMEOUT_MS, u as connectHost, v as stoppedSession, y as unknownSession } from "./hosted-client-DMOOu8vD.mjs";
-import { a as requestHostedMetro, n as closeHostedMetro, o as requireHostedMetro, r as hostedAgentPort } from "./metro-request-O8Q-JvBg.mjs";
-import { s as writeHostedNative } from "./ios-state-Avwz2cbZ.mjs";
+import { l as cancellableSleep, w as withDrainingCancellation } from "./exec-L37dbiIb.mjs";
+import { E as workspaceDir, l as withWorkspaceStateLockAsync, r as readWorkspaceState$1 } from "./workspace-state-CHEN_xzy.mjs";
+import { l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { a as agentAccess, i as closeAgentConnection, n as pullHostedNativeLogs, s as removeAgentAccess } from "./hosted-logs-BpQSRDRU.mjs";
+import { mt as runCancellationSignal } from "./toolchain-CZvtCZ-m.mjs";
+import { _ as sha256, a as RESERVE_TIMEOUT_MS, b as upload, c as bundleManifest, d as heldNoLonger, g as settle, h as requireHostedAppMode, i as PREPARE_TIMEOUT_MS, l as call, n as INSTALL_TIMEOUT_MS, o as SESSION_TIMEOUT_MS, p as hostedSession, r as OFFER_TIMEOUT_MS, s as attach, t as IMAGE_INSTALL_TIMEOUT_MS, u as connectHost, v as stoppedSession, y as unknownSession } from "./hosted-client-B_h_bTlz.mjs";
+import { a as requestHostedMetro, n as closeHostedMetro, o as requireHostedMetro, r as hostedAgentPort } from "./metro-request-BWCl3Zco.mjs";
+import { s as writeHostedNative } from "./ios-state-tzD0s7pt.mjs";
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{ios-Qam0bT9n.mjs → ios-2Qr4_Zu2.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CGuDzt40.mjs";
+import { t as getExecutor } from "./exec-L37dbiIb.mjs";
 //#region src/collector/ios.ts
 const MESSAGE_TYPE_LEVEL = {
 	Debug: "debug",

package/dist/{ios-BZuhvLGr.mjs → ios-Bi0bQiZ_.mjs}

@@ -1,9 +1,9 @@
-import { h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-T3cDctRE.mjs";
-import { Q as pickDevClientScheme, et as schemesFromInfoPlist } from "./toolchain-DCnWAxQL.mjs";
-import { f as podAction, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, s as iosConfigurationSetting, t as appNameFromPath, u as isReleaseConfiguration, v as resolveRuntime } from "./support-BJbXovoO.mjs";
-import { n as ensureWorkspaceStorageSafely } from "./native-runtime-C3_NkUlW.mjs";
-import { t as devClientScheme } from "./dev-client-MO_DjTZr.mjs";
-import { c as writeLastBuild, i as iosFacts, n as cacheDescription, o as lastBuildRecord } from "./ios-project-Cz0S1Sz-.mjs";
-import { d as replaceCollector, u as collectorEntry } from "./dependencies-LH-7k1Vr.mjs";
-import { n as registerIos, r as runIosOperation, t as iosCommand } from "./ios-BhpUWyN7.mjs";
+import { h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-DsjhOzJ3.mjs";
+import { Y as pickDevClientScheme, Z as schemesFromInfoPlist } from "./toolchain-CZvtCZ-m.mjs";
+import { f as podAction, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, s as iosConfigurationSetting, t as appNameFromPath, u as isReleaseConfiguration, v as resolveRuntime } from "./support-BeVRaMWT.mjs";
+import { n as ensureWorkspaceStorageSafely } from "./native-runtime-BfvvAJLd.mjs";
+import { t as devClientScheme } from "./dev-client-DL5UtVdx.mjs";
+import { c as writeLastBuild, i as iosFacts, n as cacheDescription, o as lastBuildRecord } from "./ios-project-Bsm-eqwv.mjs";
+import { n as registerIos, r as runIosOperation, t as iosCommand } from "./ios-M7nRVb33.mjs";
+import { d as replaceCollector, u as collectorEntry } from "./dependencies-oku1ZLep.mjs";
 export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveRuntime, runIosOperation, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };

package/dist/{ios-BhfpRfNf.mjs → ios-DQEzde6f.mjs}

@@ -1,10 +1,10 @@
-import { f as WorkspaceProcessCleanupError, l as cancellableSleep, n as isTimeoutError, t as getExecutor } from "./exec-CGuDzt40.mjs";
+import { f as WorkspaceProcessCleanupError, l as cancellableSleep, n as isTimeoutError, t as getExecutor } from "./exec-L37dbiIb.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { it as formatBytes, v as loadConfig$1 } from "./config-BA3TgoIP.mjs";
-import { n as runOperationFileQuiet, t as runOperationFile } from "./operation-exec-DKlBcKAL.mjs";
-import { i as stimDesktopInstalledAsync, n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-D0P_bzmd.mjs";
-import { Ot as recordCreatedDeviceAsync, Tt as forgetCreatedDeviceAsync, pt as isStimOwnedSim } from "./android-SJx1V3R3.mjs";
-import { n as signedTailFor } from "./apk-signed-tail-eZyXIrnc.mjs";
+import { it as formatBytes, v as loadConfig$1 } from "./config-CNmN-ndb.mjs";
+import { n as runOperationFileQuiet, t as runOperationFile } from "./operation-exec-DNynwpqO.mjs";
+import { i as stimDesktopInstalledAsync, n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-DWGAfaud.mjs";
+import { Ot as recordCreatedDeviceAsync, Tt as forgetCreatedDeviceAsync, pt as isStimOwnedSim } from "./android-27_JgJ1T.mjs";
+import { n as signedTailFor } from "./apk-signed-tail-DHMkXs4s.mjs";
 import { createHash } from "node:crypto";
 import { closeSync, existsSync, lstatSync, mkdtempSync, openSync, readSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir, totalmem } from "node:os";
@@ -932,7 +932,7 @@ async function resolveIosCreation({ deviceType, runtime } = {}) {
 		deviceType,
 		runtime
 	});
-	if (!pick) throw new Error("No matching simulator device type / runtime is installed. Install one via Xcode, or pass --device-type / --runtime.");
+	if (!pick) throw new Error(runtime && /^(?:iOS )?\d+\.\d+(?:\.\d+)?$/.test(runtime) && !runtimes.some((item) => iosRuntimeMatches(item, runtime)) ? `No installed simulator runtime matches "${runtime}". Retry with --runtime "${runtime}" --install-runtime on this named Mac, or run \`xcodebuild -downloadPlatform iOS -buildVersion ${runtime.replace(/^iOS /, "")} -architectureVariant ${process.arch === "arm64" ? "arm64" : "universal"}\` on it. Xcode Settings > Components lists available versions.` : "No matching simulator device type / runtime is installed. Install one via Xcode, or pass --device-type / --runtime.");
 	return {
 		deviceTypeId: pick.deviceTypeId,
 		runtimeId: pick.runtimeId,
@@ -1013,6 +1013,16 @@ const CLEARED_CONTAINER_DIRS = [
 ];
 async function clearIosAppData(udid, bundleId, { defaultsPlist = null } = {}) {
 	const exec = getExecutor();
+	try {
+		await exec.runFileAsync("xcrun", [
+			"simctl",
+			"terminate",
+			udid,
+			bundleId
+		], SIMCTL_OPTIONS);
+	} catch (error) {
+		if (!/found nothing to terminate/.test(error instanceof Error ? error.message : String(error))) throw error;
+	}
 	if (defaultsPlist) await exec.runFileAsync("xcrun", [
 		"simctl",
 		"spawn",
@@ -1166,9 +1176,12 @@ const LIST_RUNTIMES_OPTIONS = {
 function listIosRuntimes() {
 	return parseIosRuntimes(getExecutor().runFile("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
 }
-async function listIosRuntimesAsync({ signal, snapshot } = {}) {
-	if (snapshot?.runtimes) return snapshot.runtimes({ signal });
-	return parseIosRuntimes(await getExecutor().runFileAsync("xcrun", LIST_RUNTIMES_ARGS, {
+async function listIosRuntimesAsync({ signal, snapshot, operation } = {}) {
+	if (snapshot?.runtimes) return snapshot.runtimes({
+		signal,
+		operation
+	});
+	return parseIosRuntimes(await runOperationFile(operation, getExecutor(), "xcrun", LIST_RUNTIMES_ARGS, {
 		...LIST_RUNTIMES_OPTIONS,
 		signal
 	}));

package/dist/{ios-BhpUWyN7.mjs → ios-M7nRVb33.mjs}

@@ -1,37 +1,77 @@
-import { a as recordWorkspaceUseAsync, k as workspaceLogsDir$1 } from "./workspace-state-BhwAJBgA.mjs";
-import { _ as stepTimer, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { dt as deviceSlotFileKey, ht as parseDeviceSlotOption, vt as validateDeviceSlot } from "./config-BA3TgoIP.mjs";
-import { B as publicUrlSetting, C as iosSigningIdentitySettingError, F as metroWarmupUrlSetting, N as metroPortSetting, S as iosSigningIdentitySetting, T as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, ot as tunnelModeSetting, v as iosLanHostSetting, w as iosSigningIdentitySha1Setting, y as iosLanHostSettingError, z as projectSettingsContextAsync } from "./settings-Bap-qjnp.mjs";
-import { t as NO_PROJECT_REFUSAL } from "./project-Clk1JAWL.mjs";
-import { bt as parkedMaxSetting, mt as POOL_SETTING_REMEDY } from "./android-SJx1V3R3.mjs";
-import { Hn as exitAfterFlush, Wn as runProcessOperation, dr as ownedSessionName, qt as binOnPath, yn as DEFAULT_METRO_PORT } from "./device-capacity-CpAVcKgq.mjs";
-import { $ as tapBuildLog, H as NO_BUILD_PROGRESS, Q as startBuildProgress, Z as runFailureRecord, et as thrownRunFailureRecord, lt as statsProjectKey$1, rt as createRunRecorder } from "./workspaces-Dh5N70qW.mjs";
-import { A as COMPILATION_CACHE_NOT_RUN, _t as runCancellationSignal, gt as runCancellation, lt as cancelledFailure, vt as withNativeBuildRun } from "./toolchain-DCnWAxQL.mjs";
-import { i as createIosSimSnapshot } from "./ios-BhfpRfNf.mjs";
+import { a as recordWorkspaceUseAsync, k as workspaceLogsDir$1 } from "./workspace-state-CHEN_xzy.mjs";
+import { _ as stepTimer, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { dt as deviceSlotFileKey, ht as parseDeviceSlotOption, vt as validateDeviceSlot } from "./config-CNmN-ndb.mjs";
+import { B as publicUrlSetting, C as iosSigningIdentitySettingError, F as metroWarmupUrlSetting, N as metroPortSetting, S as iosSigningIdentitySetting, T as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, it as settingValueAt, ot as tunnelModeSetting, v as iosLanHostSetting, w as iosSigningIdentitySha1Setting, y as iosLanHostSettingError, z as projectSettingsContextAsync } from "./settings-Cz8kQJzr.mjs";
+import { t as NO_PROJECT_REFUSAL } from "./project-DIo71tGq.mjs";
+import { bt as parkedMaxSetting, mt as POOL_SETTING_REMEDY } from "./android-27_JgJ1T.mjs";
+import { Gn as exitAfterFlush, Sn as DEFAULT_METRO_PORT, Xt as binOnPath, mr as ownedSessionName, qn as runProcessOperation } from "./device-capacity-D_IlxZRL.mjs";
+import { $ as startBuildProgress, Q as runFailureRecord, U as NO_BUILD_PROGRESS, et as tapBuildLog, it as createRunRecorder, tt as thrownRunFailureRecord, ut as statsProjectKey$1 } from "./workspaces-BgAYIccE.mjs";
+import { D as COMPILATION_CACHE_NOT_RUN, ht as withNativeBuildRun, mt as runCancellationSignal, ot as cancelledFailure, pt as runCancellation } from "./toolchain-CZvtCZ-m.mjs";
+import { i as createIosSimSnapshot } from "./ios-DQEzde6f.mjs";
 import { d as optimizationBuildProfile, l as artifactCachePolicy } from "./errors-DHm_U5gv.mjs";
-import { C as setRemoteLogSink, d as simulatorRuntime } from "./client-KSWIeQLA.mjs";
-import { N as parseBuildMachineOption, W as leaseExpiryText, X as waitFlagConflict, _ as resolveIosWait, a as deviceModelRefusal, b as resolveSimulatorAppFlag, c as iosProjectPathError, d as ownedSimFailure, g as resolveIosBuildSetup, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, r as createIosDeviceWaitRun, u as isReleaseConfiguration, v as resolveRuntime, x as simulatorBuildArch, y as resolveSchemeSelection } from "./support-BJbXovoO.mjs";
-import { i as hostedMetroSettings } from "./metro-request-O8Q-JvBg.mjs";
-import { i as writeDevicePlacementAsync } from "./ios-state-Avwz2cbZ.mjs";
-import { t as devClientPortBusy } from "./hosted-native-BiiUG_Q6.mjs";
-import { i as restoreLightenedDependencies, n as printLightenedFailure } from "./lightened-B6TnpHMX.mjs";
-import { r as isEasBuildFailure } from "./eas-build-Xf5Jd6LR.mjs";
-import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds } from "./ios-device-vhYL1N--.mjs";
-import { i as launchOutcomeRecord, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-C3_NkUlW.mjs";
-import { t as lookupRecordedBuild } from "./recorded-build-BuGL_fnm.mjs";
-import "./dev-client-MO_DjTZr.mjs";
-import { t as didSetUpDevice } from "./device-BZWt_aPJ.mjs";
+import { C as setRemoteLogSink, d as simulatorRuntime } from "./client-qwmHFSga.mjs";
+import { N as parseBuildMachineOption, W as leaseExpiryText, X as waitFlagConflict, _ as resolveIosWait, a as deviceModelRefusal, b as resolveSimulatorAppFlag, c as iosProjectPathError, d as ownedSimFailure, g as resolveIosBuildSetup, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, r as createIosDeviceWaitRun, u as isReleaseConfiguration, v as resolveRuntime, x as simulatorBuildArch, y as resolveSchemeSelection } from "./support-BeVRaMWT.mjs";
+import { i as hostedMetroSettings } from "./metro-request-BWCl3Zco.mjs";
+import { i as writeDevicePlacementAsync } from "./ios-state-tzD0s7pt.mjs";
+import { t as devClientPortBusy } from "./hosted-native-B6ur_0OJ.mjs";
+import { i as restoreLightenedDependencies, n as printLightenedFailure } from "./lightened-KHWHmzGs.mjs";
+import { r as isEasBuildFailure } from "./eas-build-4rg9WpEg.mjs";
+import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds } from "./ios-device-BLm1BZB4.mjs";
+import { i as launchOutcomeRecord, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-BfvvAJLd.mjs";
+import { t as lookupRecordedBuild } from "./recorded-build-B4prJjSD.mjs";
+import "./dev-client-DL5UtVdx.mjs";
+import { t as didSetUpDevice } from "./device-yfuJ-v4s.mjs";
 import { t as unsupportedPlan } from "./project-plan-BPwbLwQu.mjs";
-import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-CeIooJqn.mjs";
-import { a as iosLedgerDevice, c as writeLastBuild, o as lastBuildRecord, s as reportIosResult } from "./ios-project-Cz0S1Sz-.mjs";
-import { n as acquireIosArtifactOrRecorded } from "./artifact-ubNdxo_K.mjs";
-import { a as hostedIosSelectors, i as hostedIosMetroNote, n as connectIosTarget, o as iosPlacementBudget, r as deviceRemoteConflict, s as selectIosPlacement, t as connectIosBackend } from "./remote-WK_swZEw.mjs";
-import { i as lanOriginUrlFor, l as verifyIosMetroRun, n as chooseLanAddress, o as finishIosRun, t as DEFAULT_DEPS } from "./dependencies-LH-7k1Vr.mjs";
+import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-DWajg5l_.mjs";
+import { a as iosLedgerDevice, c as writeLastBuild, o as lastBuildRecord, s as reportIosResult } from "./ios-project-Bsm-eqwv.mjs";
+import { n as acquireIosArtifactOrRecorded } from "./artifact-sGoFVK1q.mjs";
+import { a as hostedIosSelectors, c as selectIosTarget, i as hostedIosMetroNote, n as connectIosTarget, o as iosPlacementBudget, r as deviceRemoteConflict, s as selectIosPlacement, t as connectIosBackend } from "./remote-NOM82XE0.mjs";
+import { i as lanOriginUrlFor, l as verifyIosMetroRun, n as chooseLanAddress, o as finishIosRun, t as DEFAULT_DEPS } from "./dependencies-oku1ZLep.mjs";
 import { join } from "node:path";
 import { workspaceId } from "@stim-cli/core";
 import { hostedIosStatus, parseMachine } from "@stim-cli/core/state";
 import chalk from "chalk";
 import { InvalidArgumentError } from "commander";
+//#region src/commands/ios/runtime.ts
+async function installRequestedIosRuntime(args) {
+	const { targetRefusal, opts, settings, physical, runtime, d, progress, note, context } = args;
+	if (targetRefusal) return targetRefusal;
+	if (opts.installRuntime === true || !physical && runtime !== null && settingValueAt(settings, "ios.autoInstallRuntime") === true) {
+		const selected = selectIosTarget(args);
+		if ("failure" in selected) return selected.failure;
+		if (physical || selected.backend || selected.placement || selected.machine === "auto" || !runtime) return {
+			code: "STIM_BAD_ARG",
+			message: "Installing an iOS runtime requires an explicit runtime and a local or named Mac simulator target.",
+			remedy: "Pass --runtime <version> --install-runtime with --remote local or --remote <mac>; automatic placement, eas, proxy and physical phones do not install runtimes."
+		};
+		const recordedRuntime = selected.recorded?.device?.runtime;
+		if (recordedRuntime && recordedRuntime.replace(/^iOS /, "") !== runtime.replace(/^iOS /, "")) return {
+			code: "STIM_BAD_ARG",
+			message: `This workspace already records iOS ${recordedRuntime.replace(/^iOS /, "")} on ${selected.machine}; run stim stop first before installing another runtime.`,
+			remedy: "Run stim stop, then retry with the requested runtime."
+		};
+		const installSignal = runCancellationSignal(context) ?? context.signal;
+		progress.step("install");
+		if (selected.machine) progress.place({
+			host: selected.machine,
+			phase: "runtime-install"
+		});
+		try {
+			const installed = selected.machine ? await d.installHostedIosRuntime(selected.machine, runtime, note, installSignal) : await d.ensureIosRuntime({
+				requested: runtime,
+				signal: installSignal,
+				operation: context,
+				note
+			});
+			if (!installed.ok) return installed;
+		} finally {
+			progress.place(null);
+			progress.step("prepare");
+		}
+	}
+	return null;
+}
+//#endregion
 //#region src/commands/ios/hosted.ts
 async function finishHostedIosRun({ target, operation, d, artifact, root, slot, release, appMode, isExpo, metroCheck, metroPort, logsDir, fail, note, phase, enterPhase, enterActivity, selectors, projectBundleId, logWriter, ...report }) {
 	const bundleId = artifact.bundleId ?? (await d.readBundleId(artifact.path) || await projectBundleId());
@@ -197,6 +237,7 @@ async function finishHostedIosRun({ target, operation, d, artifact, root, slot,
 function runOnlyFlag(opts) {
 	if (isPhysicalDeviceRequest(opts.device)) return "--device";
 	if (opts.remote) return "--remote";
+	if (opts.installRuntime) return "--install-runtime";
 	if (opts.wait !== void 0) return opts.wait === false ? "--no-wait" : "--wait";
 	if (opts.simulatorApp !== void 0) return "--simulator-app";
 	if (opts.metroCheck === false) return "--no-metro-check";
@@ -238,7 +279,7 @@ function iosCommand(program) {
 	registerIos(program);
 }
 function registerIos(program, deps = {}) {
-	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator. React Native and Expo Debug runs start the dev server when it is not running.").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", parseDeviceSlotOption).option("--remote-build <value>", "Build on local, auto, remote (remote machines first), remote-only (never here), or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").option("--scheme <name>", "Shared Xcode app scheme to build; overrides automatic scheme selection, not the app URL scheme").option("--no-metro-check", "Skip the \"is this workspace's dev server running?\" check: do not start it, and build anyway").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--configuration <name>", "Xcode configuration to build (e.g. Release). A non-Debug configuration embeds the JS bundle and skips Metro entirely. Overrides the ios.configuration setting. Default: Debug").option("--device-type <name>", "Simulator model to create this workspace's owned sim as, exactly as `xcrun simctl list devicetypes` names it (e.g. \"iPad Pro 13-inch (M5)\"). Overrides the ios.deviceType setting for this invocation. A model no installed runtime can create refuses with STIM_BAD_ARG and prints the models they do offer.").option("--runtime <version>", "Simulator runtime to create this workspace's owned sim on, as a version (\"18.5\") or a runtime's full name (\"iOS 18.5\"); nothing else matches. Overrides the ios.runtime setting for this invocation. An unknown version refuses with STIM_BAD_ARG and prints the installed runtimes.").option("--simulator-app <app>", "Open the owned simulator in xcode, siniulator, or stim-desktop for this run, overriding the machine iosSimulatorApp setting. Also opens an already running simulator; local simulators only.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. The phone can be cabled or paired over Wi-Fi. With no UDID, the first cabled device this workspace can lease is used, waiting for one that is busy; a Wi-Fi device is used only when no cabled one is connected and ready. In Debug the app is wired to this workspace's Metro over the LAN. Stim never creates, boots, or deletes a physical device.").option("--remote <target>", "Run on eas, proxy, or an approved Mac in remote.machines; named Macs never fall back locally. auto places on an approved Mac when this machine is full or busy. remote tries remote.machines in order first and runs here only when none takes it. remote-only never runs here. local runs here, whatever ios.remote says.", (value) => {
+	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator. React Native and Expo Debug runs start the dev server when it is not running.").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", parseDeviceSlotOption).option("--remote-build <value>", "Build on local, auto, remote (remote machines first), remote-only (never here), or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").option("--scheme <name>", "Shared Xcode app scheme to build; overrides automatic scheme selection, not the app URL scheme").option("--no-metro-check", "Skip the \"is this workspace's dev server running?\" check: do not start it, and build anyway").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--configuration <name>", "Xcode configuration to build (e.g. Release). A non-Debug configuration embeds the JS bundle and skips Metro entirely. Overrides the ios.configuration setting. Default: Debug").option("--device-type <name>", "Simulator model to create this workspace's owned sim as, exactly as `xcrun simctl list devicetypes` names it (e.g. \"iPad Pro 13-inch (M5)\"). Overrides the ios.deviceType setting for this invocation. A model no installed runtime can create refuses with STIM_BAD_ARG and prints the models they do offer.").option("--runtime <version>", "Simulator runtime to create this workspace's owned sim on, as a version (\"18.5\") or a runtime's full name (\"iOS 18.5\"); nothing else matches. Overrides the ios.runtime setting for this invocation. An unknown version refuses with STIM_BAD_ARG and prints the installed runtimes.").option("--install-runtime", "Install the explicitly requested missing iOS runtime with Xcode on the local or named approved Mac (about 8-10 GB; shared by all workspaces)").option("--simulator-app <app>", "Open the owned simulator in xcode, siniulator, or stim-desktop for this run, overriding the machine iosSimulatorApp setting. Also opens an already running simulator; local simulators only.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. The phone can be cabled or paired over Wi-Fi. With no UDID, the first cabled device this workspace can lease is used, waiting for one that is busy; a Wi-Fi device is used only when no cabled one is connected and ready. In Debug the app is wired to this workspace's Metro over the LAN. Stim never creates, boots, or deletes a physical device.").option("--remote <target>", "Run on eas, proxy, or an approved Mac in remote.machines; named Macs never fall back locally. auto places on an approved Mac when this machine is full or busy. remote tries remote.machines in order first and runs here only when none takes it. remote-only never runs here. local runs here, whatever ios.remote says.", (value) => {
 		if (parseMachine(value)) return value.trim();
 		throw new InvalidArgumentError("expected eas, proxy, local, auto, remote, remote-only, or a remote Mac name");
 	}).option("--wait <seconds>", "How long to wait for another workspace to release the phone it leases, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once). Without --device, wait for an owned-device slot (default 600 seconds; --no-wait refuses immediately).").option("--no-wait", "Install on a phone another workspace leases instead of waiting: this run takes no lease and, when both workspaces build the same app id, the install terminates the holder's running app. Without --device, refuse a full device cap or existing slot queue immediately.").action(async (opts) => {
@@ -312,13 +353,13 @@ function iosProjectTargetRefusal(project, { physical, easProfile, placement, rec
 	};
 	return null;
 }
-function iosArtifactTargetInputs({ udid, physical, remote, hosted, simulatorArch, lanAddress, metroPort, settings }) {
+function iosArtifactTargetInputs({ udid, physical, remote, hosted, simulatorArch, configuration, lanAddress, metroPort, settings }) {
 	return {
 		target: {
 			udid,
 			destination: remote || hosted ? "generic/platform=iOS Simulator" : null,
 			sdk: physical ? "iphoneos" : "iphonesimulator",
-			arch: remote || hosted ? simulatorArch : null,
+			arch: remote || hosted || isReleaseConfiguration(configuration) ? simulatorArch : null,
 			keyArch: simulatorArch,
 			offloadRuntime: () => hosted?.choice.runtimeId ?? (remote ? null : simulatorRuntime(udid)),
 			hostedArchitecture: hosted?.choice.architecture,
@@ -642,10 +683,25 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 		scheme: buildScheme,
 		configuration: builtConfiguration
 	});
-	const capabilityRefusal = iosProjectTargetRefusal(integration, {
+	const capabilityRefusal = await installRequestedIosRuntime({
+		targetRefusal: iosProjectTargetRefusal(integration, {
+			physical,
+			easProfile: opts.easProfile,
+			recordedRefusal: recordedLookup.refusal
+		}),
+		root,
+		slot,
+		release,
+		appMode,
+		metroCheck,
+		opts,
+		settings,
 		physical,
-		easProfile: opts.easProfile,
-		recordedRefusal: recordedLookup.refusal
+		runtime,
+		d,
+		progress,
+		note,
+		context
 	});
 	if (capabilityRefusal) return fail(capabilityRefusal);
 	const simSnapshot = createIosSimSnapshot();
@@ -1087,8 +1143,7 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 			const simulatorArch = simulatorBuildArch({
 				physical,
 				remoteArch,
-				hostArch: d.hostSimulatorArch(),
-				configuration
+				hostArch: d.hostSimulatorArch()
 			});
 			const acquiredArtifact = unlessCancelled(context, await acquireIosArtifactOrRecorded(recordedLookup.build, {
 				context,
@@ -1110,6 +1165,7 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 						remote: Boolean(remoteDevice),
 						hosted: hostedTarget,
 						simulatorArch,
+						configuration,
 						lanAddress,
 						metroPort,
 						settings
@@ -1177,7 +1233,10 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 				startedAt,
 				closeWriter: () => writer?.close(),
 				devicePlacement,
-				recordRun,
+				recordRun: (outcome) => recordRun({
+					...outcome,
+					remoteDevice: true
+				}),
 				reclaimed,
 				devServer,
 				fail,
@@ -1251,6 +1310,7 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 					lanAddress,
 					lanOriginUrl,
 					remoteDevice,
+					cleanAppState: Boolean(opts.cleanAppState),
 					bootPromise,
 					bootDuration: () => bootDuration,
 					bootPending: () => bootPending,
@@ -1265,7 +1325,10 @@ async function runIos(context, projectRoot, opts = {}, overrides = {}, progress
 					lease: leaseHandle,
 					releaseLease,
 					devicePlacement,
-					recordRun,
+					recordRun: (outcome) => recordRun({
+						...outcome,
+						remoteDevice: Boolean(remoteDevice)
+					}),
 					reclaimed,
 					devServer,
 					enterPhase: progress.step,

package/dist/{ios-device-vhYL1N--.mjs → ios-device-BLm1BZB4.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-CGuDzt40.mjs";
-import { bn as INSTALL_ERROR, wn as appProcessFromPid } from "./device-capacity-CpAVcKgq.mjs";
-import { n as TOOL_ERROR_PREFIX } from "./ios-device-DLdEDWJj.mjs";
+import { t as getExecutor } from "./exec-L37dbiIb.mjs";
+import { Cn as INSTALL_ERROR, Dn as appProcessFromPid } from "./device-capacity-D_IlxZRL.mjs";
+import { n as TOOL_ERROR_PREFIX } from "./ios-device-ygijU78G.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";

package/dist/{ios-device-DLdEDWJj.mjs → ios-device-ygijU78G.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CGuDzt40.mjs";
+import { t as getExecutor } from "./exec-L37dbiIb.mjs";
 //#region src/collector/ios-device.ts
 const CONSOLE_ENV = { OS_ACTIVITY_DT_MODE: "enable" };
 const DEV_MENU_LAUNCH_ARGS = [

package/dist/{ios-project-Cz0S1Sz-.mjs → ios-project-Bsm-eqwv.mjs}

@@ -1,10 +1,10 @@
-import { w as workspaceAgentDeviceDir } from "./workspace-state-BhwAJBgA.mjs";
-import { i as formatDuration, l as phaseLine } from "./command-output-T3cDctRE.mjs";
-import { a as workspaceLinkLine } from "./stim-desktop-D0P_bzmd.mjs";
-import { Kn as UPLOAD_TIMEOUT_MS, Xn as isEasAuthFailureText, Yn as easAuthNote, qn as cacheLevel } from "./device-capacity-CpAVcKgq.mjs";
-import { X as recordFinishedBuild } from "./workspaces-Dh5N70qW.mjs";
-import { A as COMPILATION_CACHE_NOT_RUN, F as compilationCacheActivityLine } from "./toolchain-DCnWAxQL.mjs";
-import { i as deviceLabel } from "./support-BJbXovoO.mjs";
+import { w as workspaceAgentDeviceDir } from "./workspace-state-CHEN_xzy.mjs";
+import { i as formatDuration, l as phaseLine } from "./command-output-DsjhOzJ3.mjs";
+import { a as workspaceLinkLine } from "./stim-desktop-DWGAfaud.mjs";
+import { $n as isEasAuthFailureText, Qn as easAuthNote, Xn as cacheLevel, Yn as UPLOAD_TIMEOUT_MS } from "./device-capacity-D_IlxZRL.mjs";
+import { Z as recordFinishedBuild } from "./workspaces-BgAYIccE.mjs";
+import { D as COMPILATION_CACHE_NOT_RUN, M as compilationCacheActivityLine } from "./toolchain-CZvtCZ-m.mjs";
+import { i as deviceLabel } from "./support-BeVRaMWT.mjs";
 import { buildDiagnostics } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/commands/ios/result.ts

package/dist/ios-runtime-DLiKoOkd.mjs

@@ -0,0 +1,150 @@
+import { D as ownership_claim_exports, T as process_identity_exports, l as cancellableSleep, t as getExecutor } from "./exec-L37dbiIb.mjs";
+import { n as stripAnsi, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
+import { u as getConcurrencyLimits } from "./config-CNmN-ndb.mjs";
+import { t as runOperationFile } from "./operation-exec-DNynwpqO.mjs";
+import { Ct as acquireBuildSlot, Et as releaseBuildSlot } from "./workspaces-BgAYIccE.mjs";
+import { h as listIosRuntimesAsync, l as iosRuntimeMatches } from "./ios-DQEzde6f.mjs";
+import { existsSync, statfsSync } from "node:fs";
+import { join } from "node:path";
+import { configDir } from "@stim-cli/core";
+//#region src/devices/ios-runtime.ts
+const INSTALL_TIMEOUT_MS = 18e5;
+const REQUIRED_FREE_BYTES = 20 * 1024 ** 3;
+const RUNTIME_VERSION = /^(?:iOS )?(\d+\.\d+(?:\.\d+)?)$/;
+const refuse = (message, remedy) => ({
+	ok: false,
+	code: "STIM_NO_DEVICE",
+	message,
+	remedy
+});
+/** Installs only an explicit missing iOS version; runtimes remain shared Xcode components, never Stim-owned devices. */
+async function ensureIosRuntime({ requested, signal, operation, workerProcessGroup, note }) {
+	const version = RUNTIME_VERSION.exec(requested)?.[1];
+	if (!version) return {
+		ok: false,
+		code: "STIM_BAD_ARG",
+		message: "Runtime installation needs an exact iOS version, such as 26.5 or iOS 26.5.",
+		remedy: "Pass --runtime <major.minor[.patch]>."
+	};
+	const installed = async () => (await listIosRuntimesAsync({
+		signal,
+		operation
+	})).some((runtime) => iosRuntimeMatches(runtime, requested));
+	if (await installed()) return { ok: true };
+	if (process.platform !== "darwin") return refuse("iOS runtimes can be installed only on a Mac.", "Use --remote <mac> with an approved Mac.");
+	const manual = `xcodebuild -downloadPlatform iOS -buildVersion ${version} -architectureVariant ${process.arch === "arm64" ? "arm64" : "universal"}`;
+	const root = join(configDir(), "ios-runtime-install");
+	let held;
+	let waited = false;
+	while (!held) {
+		signal?.throwIfAborted();
+		try {
+			const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
+				root,
+				mode: "exclusive",
+				label: "iOS runtime install",
+				details: { runtime: version }
+			});
+			held = attempt.acquired;
+			if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
+		} catch (error) {
+			const failure = (0, ownership_claim_exports.claimFailure)(error, null);
+			if (failure) return {
+				ok: false,
+				...failure
+			};
+			throw error;
+		}
+		if (!held) {
+			if (!waited) note("Waiting for another Stim iOS runtime installation on this Mac.");
+			waited = true;
+			await cancellableSleep(2e3, {
+				signal,
+				what: "iOS runtime installation"
+			});
+		}
+	}
+	const claim = held;
+	let unresolved = false;
+	let workerChild = false;
+	let slot;
+	try {
+		if (await installed()) return { ok: true };
+		const volume = existsSync("/Library/Developer/CoreSimulator") ? "/Library/Developer/CoreSimulator" : "/Library";
+		let free;
+		try {
+			const disk = statfsSync(volume);
+			free = disk.bavail * disk.bsize;
+		} catch (error) {
+			return refuse(`Cannot establish free disk space on ${volume}: ${error instanceof Error ? error.message : String(error)}`, "Check free space on the Mac before installing the runtime through Xcode.");
+		}
+		if (free < REQUIRED_FREE_BYTES) return refuse(`${(free / 1024 ** 3).toFixed(1)} GB free on ${volume}; installing iOS ${version} requires at least 20 GB for download and unpacking.`, "Free space on that volume, then retry. Stim does not delete shared runtimes.");
+		slot = await acquireBuildSlot({
+			max: getConcurrencyLimits().maxBuilds,
+			signal,
+			out: note
+		});
+		note(`Installing iOS ${version} with Xcode (typically 8-10 GB; actual size varies). This runtime is shared by every workspace on this Mac.`);
+		const reader = createLineReader((line) => {
+			if (line.trim()) note(stripAnsi(line).replace(/\r/g, "\n").slice(-1e3));
+		});
+		const heartbeat = setInterval(() => note(`Still installing iOS ${version}; Xcode downloads can take several minutes.`), 3e4);
+		heartbeat.unref();
+		try {
+			(0, ownership_claim_exports.markClaimChildPending)(held);
+			if (slot?.claim) (0, ownership_claim_exports.markClaimChildPending)(slot.claim);
+			await runOperationFile(operation, getExecutor(), "xcodebuild", [
+				"-downloadPlatform",
+				"iOS",
+				"-buildVersion",
+				version,
+				"-architectureVariant",
+				process.arch === "arm64" ? "arm64" : "universal"
+			], {
+				timeoutMs: INSTALL_TIMEOUT_MS,
+				signal,
+				containProcessTree: true,
+				onSpawn: (child) => {
+					if (child.pid === void 0) return;
+					if (workerProcessGroup) {
+						workerChild = true;
+						(0, ownership_claim_exports.setClaimChild)(claim, claim.owner);
+						if (slot?.claim) (0, ownership_claim_exports.setClaimChild)(slot.claim, claim.owner);
+					} else {
+						const captured = (0, process_identity_exports.captureProcessIdentity)(child.pid);
+						if (!captured.ok) throw new Error(`Cannot record the Xcode runtime installer: ${captured.reason}`);
+						const identity = {
+							pid: child.pid,
+							processToken: captured.token
+						};
+						(0, ownership_claim_exports.setClaimChild)(claim, identity);
+						if (slot?.claim) (0, ownership_claim_exports.setClaimChild)(slot.claim, identity);
+					}
+					child.stdout?.on("data", (chunk) => reader.push(String(chunk).replace(/\r/g, "\n")));
+					child.stderr?.on("data", (chunk) => reader.push(String(chunk).replace(/\r/g, "\n")));
+				}
+			});
+		} catch (error) {
+			if (error instanceof Error && "reportCleanup" in error) {
+				unresolved = true;
+				throw error;
+			}
+			signal?.throwIfAborted();
+			return refuse(`Xcode could not install iOS ${version}: ${(error instanceof Error ? error.message : String(error)).slice(-4e3)}`, `Run \`${manual}\` on the simulator Mac for the full error. Xcode Settings > Components lists versions supported by its selected Xcode; update Xcode if the requested runtime is unsupported.`);
+		} finally {
+			clearInterval(heartbeat);
+			reader.flush();
+			if (!unresolved && !workerChild) (0, ownership_claim_exports.clearClaimChild)(held);
+		}
+		if (!await installed()) return refuse(`Xcode finished but iOS ${version} is not available in simctl.`, `Run \`xcrun simctl list runtimes\` and \`${manual}\` on the simulator Mac to inspect the installation.`);
+		note(`iOS ${version} is installed. Remove shared runtimes manually in Xcode Settings > Components when no workspace needs them.`);
+		return { ok: true };
+	} finally {
+		if (!unresolved && !workerChild) {
+			releaseBuildSlot(slot);
+			(0, ownership_claim_exports.releaseClaim)(held);
+		}
+	}
+}
+//#endregion
+export { ensureIosRuntime as t };