stim 1.14.0 → 1.16.0

package/dist/{ios-P1f5nm2n.mjs → ios-aq3QoGI3.mjs}

@@ -1,39 +1,52 @@
-import { A as ownership_claim_exports, G as validateDeviceSlot, H as parseDeviceSlotOption, R as deviceSlotFileKey, T as upsertProject, p as getProject, u as getConcurrencyLimits, z as deviceSlotKey } from "./config-lvc7d3C2.mjs";
-import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
-import { M as workspaceLogsDir, a as pidExists, b as writeWorkspaceState, c as resolveProjectMetro, g as recordWorkspaceUse, h as readWorkspaceState$1, k as workspaceDir, l as signalProcessTree } from "./metro-CcEo8Fl8.mjs";
-import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BVrHsYZG.mjs";
-import { a as findProjectRoot, n as appProjectProblem, r as detectIsExpo, t as NO_PROJECT_REFUSAL } from "./project-CWlvEaeN.mjs";
-import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-DHqvsbqC.mjs";
-import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-DVcpw6eE.mjs";
-import { A as providerDownloadPath, D as fingerprintProject, E as fingerprintDiffRecord, L as untrackedMissLine, M as refingerprintAfterMutation, N as resolveBuild, O as inputsChangedDuringBuild, P as storeBuild, R as untrackedNativeFiles, S as configInputsChanged, T as filesystemBuildCapability, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as providerUploadOutcome, k as prepareProviderDownloadDir, m as acquireBuildLock, v as waitForSharedBuild, x as changedDuringBuildLine } from "./device-lease-5c3WrVRm.mjs";
-import { ct as parkedMaxSetting, rt as POOL_SETTING_REMEDY } from "./android-d6rGq1pA.mjs";
-import { A as resolveCacheProviderConfig, B as detectProviders, E as publicUrlSetting, G as resolveOptimizations, H as artifactCachePolicy, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, W as optimizationBuildProfile, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS } from "./settings-D61iNOsB.mjs";
-import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-BwDPrnYQ.mjs";
-import { c as recordFinishedBuild, l as startBuildProgress, n as NO_BUILD_PROGRESS } from "./build-progress-DxKpwnaS.mjs";
-import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-DlqBDKqY.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-DyYDF5ww.mjs";
-import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-CcR6o6lI.mjs";
-import { F as ownedSessionName, S as withNativeBuildRun, a as ensureMetroReachable, l as remoteIosDeps, m as cancelledFailure, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, x as runCancellation, z as gateMetroOrigin } from "./device-remote-D87zEzaq.mjs";
-import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp, y as restartedAppNote } from "./app-install-BpgSgkJj.mjs";
-import { c as readMetroRecords, f as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unattributedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, p as verifyReleaseLaunch, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING, u as unverifiedLaunchLines } from "./launch-verify-Deg4tB3Z.mjs";
-import { f as easDeviceBuildRemedy, h as resolveEasDevelopmentBuild, l as unknownIosDeviceTypeRefusal, m as planEasDevelopmentBuild, p as isEasBuildFailure, r as checkDeviceCapacity, u as unknownIosRuntimeRefusal } from "./simslim-DrDN4WuV.mjs";
-import { f as spawnEntry, h as detectBundleId, s as startDevServer } from "./start-s4RXp1wy.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-BiyDyPP-.mjs";
-import { C as clearIosAdoptionPending, S as IosDeviceMismatchError, _ as staleNativeDirRefusal, a as refusePlan, c as skippedMissReason, d as schemesFromInfoPlist, g as runPrebuild, h as recordPrebuild, i as printPlan, l as devClientScheme, m as planPrebuild, n as planFlagRefusal, o as explainBuildMiss, p as swapJsBundle, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as pickDevClientScheme, v as ensureBooted, w as warmMetro, y as ensureOwnedDevice } from "./build-plan-Dcr-3ie0.mjs";
-import { t as budgetGate } from "./budget-CGDkhvv_.mjs";
-import { a as sleep, i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-DjBHRg5m.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-CX1Z8Tca.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-Cp5KvK9x.mjs";
-import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-D5t8EiMf.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-C5HzcwCW.mjs";
-import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-DGglU3E_.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-D9IcKqXS.mjs";
+import { t as getExecutor } from "./exec-CaErVv7t.mjs";
+import { E as upsertProject, L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, p as getProject, u as getConcurrencyLimits, v as recordIosSchemeApprovals, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
+import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
+import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-DnJMdEY-.mjs";
+import { B as settingsLayers, E as parseIosRemote, G as detectProviders, H as unknownSettingKeys, J as artifactCachePolicy, L as settingOriginScope, M as remoteIosSetting, N as resolveCacheProviderConfig, P as resolveSettings, R as settingShapeErrors, S as metroPortSetting, Tt as removeTemporaryEntry, V as tunnelModeSetting, X as optimizationBuildProfile, Z as resolveOptimizations, _ as iosSigningIdentitySha1Setting, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, g as iosSigningIdentitySettingError, gt as repoRoot, h as iosSigningIdentitySetting, it as gitCommonDir, k as publicUrlSetting, m as iosLanHostSettingError, p as iosLanHostSetting, v as iosSigningIdentitySha1SettingError, w as metroWarmupUrlSetting, wt as makeTemporaryDirectory } from "./settings-oTSkkNrM.mjs";
+import { n as appProjectProblem, o as findProjectRoot$1, r as detectIsExpo, t as NO_PROJECT_REFUSAL } from "./project-Du91Ilvc.mjs";
+import { l as resolveProjectMetro, o as pidExists, u as signalProcessTree } from "./metro-BeK1ZPz1.mjs";
+import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-B8-aJ1_5.mjs";
+import { t as budgetGate } from "./budget-DjrURfQn.mjs";
+import { A as providerDownloadPath, D as fingerprintProject, E as fingerprintDiffRecord, L as untrackedMissLine, M as refingerprintAfterMutation, N as resolveBuild, O as inputsChangedDuringBuild, P as storeBuild, R as untrackedNativeFiles, S as configInputsChanged, T as filesystemBuildCapability, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as providerUploadOutcome, k as prepareProviderDownloadDir, m as acquireBuildLock, v as waitForSharedBuild, x as changedDuringBuildLine } from "./device-lease-D-hLqx1b.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-rUk77xqh.mjs";
+import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-DcW6vOd_.mjs";
+import { S as statsProjectKey$1, _ as tapBuildLog, g as startBuildProgress, h as recordFinishedBuild, l as NO_BUILD_PROGRESS, v as createRunRecorder, x as recordRunStats, y as readRunEstimates } from "./idle-DYVymG92.mjs";
+import { ft as parkedMaxSetting, ot as POOL_SETTING_REMEDY } from "./android-B_NumVyQ.mjs";
+import { p as listIosRuntimes, r as clearIosAppData, u as listAllIosSims } from "./ios-BaInn3sW.mjs";
+import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Cnz8CPnl.mjs";
+import { r as createNdjsonWriter } from "./ndjson-PclOIwVY.mjs";
+import { S as bundlerPin, _ as readBundleId, c as COMPILATION_CACHE_NOT_RUN, d as buildIos, g as readBundleExecutable, h as discoverXcodeProject, p as compilationCacheActivityLine, r as iosToolchain, v as resolveScheme } from "./toolchain-DkUflduf.mjs";
+import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, i as closeOffload, l as remotePhaseText, m as resolveBuildPlacement, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement, u as simulatorRuntime } from "./client-BTY686R6.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-DiA16AsN.mjs";
+import { C as pickDevClientScheme, S as restartedAppNote, T as schemesFromInfoPlist, _ as installIosApp, a as IOS_DEV_MENU_OFF_DEFAULTS_PLIST, d as devClientUrl, l as clearOtherUserApps, r as DEFAULT_METRO_PORT, v as iosAppProcess, x as launchIosApp } from "./app-install-CKWdbXIX.mjs";
+import { t as checkDeviceCapacity } from "./device-capacity-BHwxNBlu.mjs";
+import { n as devClientTakesDevMenuParams, t as devClientScheme } from "./dev-client-CroAIjjj.mjs";
+import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-urbmfXig.mjs";
+import { i as staleNativeDirRefusal, n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-D2fsca_Z.mjs";
+import { c as readMetroRecords, f as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unattributedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, p as verifyReleaseLaunch, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING, u as unverifiedLaunchLines } from "./launch-verify-2DBRizjo.mjs";
+import { a as acquireRunLease, c as lostRefusal, d as runLease, f as waitFlagConflict, o as leaseExpiryText, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnSignal } from "./device-lease-run-CqjShqWW.mjs";
+import { n as clearIosAdoptionPending } from "./device-ios-BadmeL2V.mjs";
+import { _ as simulatorBuildArch, a as deviceShortName, c as isReleaseConfiguration, d as printDiagnostics, f as resolveConfiguration, g as resolveSimulatorAppFlag, h as resolveRuntime, i as deviceModelRefusal, l as ownedSimFailure, m as resolveIosWait, n as buildLogFile, o as iosConfigurationSetting, p as resolveDeviceType, r as deviceLabel, s as iosProviderRunOptions, t as appNameFromPath, u as podAction, v as xcodeFailureReport } from "./support-D4aYJniO.mjs";
+import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-C8-V13XN.mjs";
+import { O as readRemoteSimulatorArch, a as ensureMetroReachable, k as gateMetroOrigin, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName } from "./device-remote-D5WVWqOq.mjs";
+import { d as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-NaBrRFtQ.mjs";
+import { a as isEasBuildFailure, i as easDeviceBuildRemedy, o as planEasDevelopmentBuild, s as resolveEasDevelopmentBuild } from "./simslim-B8-7AoTI.mjs";
+import { c as startDevServer, h as detectBundleId } from "./start-ClDfwXa4.mjs";
+import { a as refusePlan, c as skippedMissReason, f as swapJsBundle, h as ensureOwnedDevice, i as printPlan, m as ensureBooted, n as planFlagRefusal, o as explainBuildMiss, p as didSetUpDevice, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, v as warmMetro } from "./build-plan-DjeSb2Xl.mjs";
+import { a as sleep, i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-DBzRnEKS.mjs";
+import { t as selectFromPool } from "./device-pool-CUaEWMMm.mjs";
+import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-B8VrHxn1.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B9L4Ae0x.mjs";
+import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, i as iosDeviceProcess, l as listIosDevices, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, p as verifyIosDeviceReleaseLaunch, r as iosDeviceBounds, t as awaitIosDeviceLaunch, u as localNetworkPending } from "./ios-device-FfCN_C8p.mjs";
+import { n as writeHostedIos, t as readHostedIos } from "./ios-state-DS5UpYTH.mjs";
+import { n as prepareHostedIos, t as placeHostedIos } from "./hosted-ios-CIWelIqf.mjs";
+import { X509Certificate } from "node:crypto";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
-import { InvalidArgumentError } from "commander";
-import { buildDiagnostics } from "@stim-cli/core/state";
 import { basename, join } from "node:path";
-import { X509Certificate } from "node:crypto";
+import { hostSimulatorArch } from "@stim-cli/core";
+import { InvalidArgumentError } from "commander";
+import { buildDiagnostics, hostedIosStatus, isJsonObject, machineCapacity, parseMachine } from "@stim-cli/core/state";
 import { networkInterfaces, tmpdir } from "node:os";
 import chalk from "chalk";
 import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
@@ -111,149 +124,9 @@ function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirec
 		appPath: copy
 	};
 }
-function buildLogFile(root) {
-	return join(workspaceLogsDir(root), `build-ios.ndjson`);
-}
-const MAX_PRINTED_DIAGNOSTICS = 6;
-function deviceLabel(device, udid) {
-	const name = device?.deviceName || device?.name || null;
-	return name ? `${name} (${shortUdid(udid)})` : shortUdid(udid);
-}
-function deviceShortName(device, udid) {
-	return device?.deviceName || device?.name || shortUdid(udid);
-}
-function appNameFromPath(appPath) {
-	if (typeof appPath !== "string" || appPath.trim() === "") return null;
-	const name = basename(appPath).replace(/\.app$/i, "");
-	return name === "" ? null : name;
-}
-function iosConfigurationSetting(settings) {
-	const ios = settings?.["ios"];
-	if (!ios || typeof ios !== "object" || Array.isArray(ios)) return null;
-	const raw = ios["configuration"];
-	return typeof raw === "string" && raw.trim() !== "" ? raw.trim() : null;
-}
-function resolveConfiguration(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosConfigurationSetting(settings);
-}
-function iosStringSetting(settings, key) {
-	const ios = settings?.["ios"];
-	if (!ios || typeof ios !== "object" || Array.isArray(ios)) return null;
-	const raw = ios[key];
-	return typeof raw === "string" && raw.trim() !== "" ? raw.trim() : null;
-}
-function resolveDeviceType(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosStringSetting(settings, "deviceType");
-}
-function resolveRuntime(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosStringSetting(settings, "runtime");
-}
-function resolveSimulatorAppFlag(flag, physical, remoteBackend) {
-	if (flag === void 0) return {};
-	let simulatorApp;
-	try {
-		simulatorApp = parseIosSimulatorApp(flag, "--simulator-app");
-	} catch (error) {
-		return { refusal: {
-			code: "STIM_BAD_ARG",
-			message: error.message
-		} };
-	}
-	if (physical || remoteBackend) return { refusal: {
-		code: "STIM_BAD_ARG",
-		message: "--simulator-app only applies to a local owned iOS simulator.",
-		remedy: "Drop --simulator-app when using a physical or remote device."
-	} };
-	return { simulatorApp };
-}
-function deviceModelRefusal({ slot, deviceTypeFlag, runtimeFlag, deviceType, runtime, physical, remoteBackend, listRuntimes }) {
-	if (slot && slot !== "default" && remoteBackend) return {
-		code: "STIM_BAD_ARG",
-		message: "Named slots currently support local simulators and physical devices.",
-		remedy: "Use the default slot for a remote session."
-	};
-	if (typeof deviceTypeFlag === "string" && deviceTypeFlag.trim() === "") return {
-		code: "STIM_BAD_ARG",
-		message: "--device-type was given an empty name.",
-		remedy: "Pass `--device-type <name>` with a model `xcrun simctl list devicetypes` names, e.g. \"iPad Pro 13-inch (M5)\"."
-	};
-	if (typeof runtimeFlag === "string" && runtimeFlag.trim() === "") return {
-		code: "STIM_BAD_ARG",
-		message: "--runtime was given an empty version.",
-		remedy: "Pass `--runtime <version>` with a runtime `xcrun simctl list runtimes` reports, e.g. \"18.5\"."
-	};
-	if (remoteBackend) {
-		const given = [deviceTypeFlag && "--device-type", runtimeFlag && "--runtime"].filter(Boolean).join(" and ");
-		if (given) return {
-			code: "STIM_BAD_ARG",
-			message: `${given} ${given.includes(" and ") ? "apply" : "applies"} only to a local owned iOS simulator; the ${remoteBackend} remote backend chooses its own device.`,
-			remedy: `Drop ${given} for a remote run. For a local owned simulator, drop --remote and unset ios.remote with \`stim settings unset ios.remote --scope <workspace|repo|committed>\`.`
-		};
-		return null;
-	}
-	if (physical) return null;
-	if (!deviceType && !runtime) return null;
-	let runtimes;
-	try {
-		runtimes = listRuntimes();
-	} catch (error) {
-		return {
-			code: "STIM_NO_DEVICE",
-			message: `Could not read the installed simulator runtimes: ${error?.message || error}`,
-			remedy: "Run `stim doctor` to check the simulator toolchain, then try again."
-		};
-	}
-	const refusal = unknownIosRuntimeRefusal(runtime, runtimes) ?? unknownIosDeviceTypeRefusal(deviceType, runtimes, runtime);
-	return refusal ? {
-		code: "STIM_BAD_ARG",
-		message: refusal.message,
-		remedy: refusal.remedy
-	} : null;
-}
-function ownedSimFailure(error) {
-	return {
-		code: "STIM_NO_DEVICE",
-		message: `Could not ensure an owned iOS simulator: ${error?.message || error}`,
-		remedy: error instanceof IosDeviceMismatchError ? error.remedy : "Run `stim doctor` to check the simulator toolchain, then try again."
-	};
-}
-function isReleaseConfiguration(configuration) {
-	return typeof configuration === "string" && configuration.trim() !== "" && configuration.trim().toLowerCase() !== "debug";
-}
-function podAction(podState, verdict) {
-	if (verdict?.stale) return {
-		install: true,
-		reason: verdict.reason
-	};
-	if (verdict?.noPods && podState?.hasPodfile) return {
-		install: true,
-		reason: "ios/Podfile exists but no pods are installed"
-	};
-	return { install: false };
-}
-function xcodeFailureReport(result, logPath) {
-	const diagnostics = result.diagnostics;
-	const code = result.exitCode;
-	const how = code === null ? "" : ` (exit code ${code})`;
-	return {
-		message: diagnostics.length ? `\`xcodebuild\` failed${how} with ${diagnostics.length} diagnostic${diagnostics.length === 1 ? "" : "s"}.` : `\`xcodebuild\` failed${how} with no recognizable diagnostic.`,
-		remedy: diagnostics.find((d) => d?.remedy)?.remedy || `See ${logPath} for the transcript.`
-	};
-}
-function printDiagnostics(note, result) {
-	const diagnostics = result.diagnostics;
-	const shown = diagnostics.slice(0, MAX_PRINTED_DIAGNOSTICS);
-	for (const diagnostic of shown) note(chalk.red(phaseLine("error", describeDiagnostic(diagnostic))));
-	const hidden = diagnostics.length - shown.length + result.truncated;
-	if (hidden > 0) note(chalk.dim(phaseLine("error", `... and ${hidden} more diagnostic${hidden === 1 ? "" : "s"} in the log`)));
-	if (diagnostics.length === 0) {
-		note(chalk.red(phaseLine("error", "xcodebuild failed with no recognizable diagnostic; last lines:")));
-		for (const line of result.tail.slice(-5)) note(chalk.dim(phaseLine("", line)));
-	}
-}
 //#endregion
 //#region src/commands/ios/result.ts
-function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null }) {
+function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
 	const record = {
 		platform: "ios",
 		fingerprint,
@@ -268,12 +141,16 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 		configuration
 	};
 	if (errorCode) record.errorCode = errorCode;
+	record.buildMachine = buildMachine;
+	if (builtOn) record.builtOn = builtOn;
+	if (offloadedTo) record.offloadedTo = offloadedTo;
+	if (offloadFallback) record.offloadFallback = offloadFallback;
 	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
 	const recorded = status === "failed" ? buildDiagnostics(diagnostics) : [];
 	if (recorded.length) record.diagnostics = recorded;
 	return record;
 }
-function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease, devServer = null }) {
+function iosFacts({ root, slot, udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease, devServer = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
 	return {
 		platform: "ios",
 		...slot && slot !== "default" ? { slot } : {},
@@ -287,6 +164,10 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 		cacheKey,
 		cacheHit: cacheLevel(cacheHit),
 		cacheSkipped: Boolean(cacheSkipped),
+		buildMachine,
+		...builtOn ? { builtOn } : {},
+		...offloadedTo ? { offloadedTo } : {},
+		...offloadFallback ? { offloadFallback } : {},
 		compilationCache,
 		waitedForBuild: waitedForBuild ? {
 			pid: waitedForBuild.pid ?? null,
@@ -298,6 +179,7 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 		launched: launched === "unverified" || launched === "bundling" ? launched : Boolean(launched),
 		metroPort,
 		logs: { dir: logsDir },
+		...root ? { agentDevice: { stateDir: workspaceAgentDeviceDir(root) } } : {},
 		durationMs,
 		...webPreviewUrl ? { webPreviewUrl } : {},
 		...lease === void 0 ? {} : { lease },
@@ -327,13 +209,14 @@ async function finishIosUpload(uploadPending, remote, phase, note) {
 	}
 	return false;
 }
-function reportIosResult({ slot, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, missReason, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null }) {
+function reportIosResult({ host, slot, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, missReason, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null, links }) {
 	const durationMs = elapsed();
 	recordRun({
 		failed: false,
 		cacheHit,
 		waited: waitedForBuild,
-		durationMs
+		durationMs,
+		offloadedTo
 	});
 	writeLastBuild(root, lastBuildRecord({
 		fingerprint: storeHash,
@@ -346,10 +229,15 @@ function reportIosResult({ slot, root, json, release, configuration, buildScheme
 		bundleId,
 		startedAt,
 		status: "ok",
-		configuration: configuration ?? "Debug"
+		configuration: configuration ?? "Debug",
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
 	}));
 	closeWriter();
 	const facts = iosFacts({
+		root,
 		slot,
 		udid,
 		deviceName: device?.deviceName ?? null,
@@ -372,35 +260,43 @@ function reportIosResult({ slot, root, json, release, configuration, buildScheme
 		launched: launchState,
 		webPreviewUrl,
 		lease,
-		devServer
+		devServer,
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
 	});
-	if (json) console.log(JSON.stringify(reclaimed.length ? {
+	if (host) facts.host = host;
+	if (json) console.log(JSON.stringify({
 		...facts,
-		reclaimed
-	} : facts));
+		...links ? { links } : {},
+		...reclaimed.length ? { reclaimed } : {}
+	}));
 	else {
-		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${deviceLabel(device, udid)}, ` + (release ? `${configuration} (embedded JS, no Metro)` : `Metro port ${metroPort}`) + ` (${cacheDescription(cacheHit, providerName)}, ${formatDuration(durationMs)})`;
+		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${host ? `${device.deviceName} (iOS ${device.runtime?.replace(/^iOS /, "")}) on ${host.machine}` : deviceLabel(device, udid)}, ` + (release ? `${configuration} (embedded JS, no Metro)` : `Metro port ${metroPort}`) + ` (${cacheDescription(cacheHit, providerName, offloadedTo)}, ${formatDuration(durationMs)})`;
 		const outcome = launchWarning ? chalk.yellow(`${summary} -- ${launchWarning}`) : launchState === "unverified" ? chalk.yellow(`${summary} -- launch UNVERIFIED`) : launchState === "bundling" ? chalk.green(`${summary} -- bundle requested, still building`) : chalk.green(summary);
 		const deviceName = device?.deviceName ?? device?.name ?? udid;
-		const cacheResult = useBuildCache ? cacheDescription(cacheHit, providerName) : "bypassed; built";
+		const cacheResult = useBuildCache ? cacheDescription(cacheHit, providerName, offloadedTo) : `bypassed; ${cacheDescription(false, null, offloadedTo)}`;
 		const metroResult = release ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}${devServer ? ` (started: ${devServer.reason})` : ""}`;
 		console.log([
 			outcome,
-			phaseLine("device", `${deviceName} (${udid})`),
+			phaseLine("device", host ? `${deviceName} (iOS ${device.runtime?.replace(/^iOS /, "")}) on ${host.machine}` : `${deviceName} (${udid})`),
 			phaseLine("app", bundleId),
 			phaseLine("metro", metroResult),
 			phaseLine("cache", cacheResult),
 			...compilationCache.status === "not-run" ? [phaseLine("compilation cache", compilationCacheActivityLine(compilationCache))] : [],
-			phaseLine("logs", logsDir)
+			phaseLine("logs", logsDir),
+			phaseLine("agent-device", `AGENT_DEVICE_STATE_DIR=${workspaceAgentDeviceDir(root)}`)
 		].join("\n"));
 		if (facts.webPreviewUrl) console.error(chalk.dim(`Watch this device: ${facts.webPreviewUrl}`));
+		if (links) console.error(chalk.dim(workspaceLinkLine(links)));
 	}
 	return facts;
 }
-function cacheDescription(cacheHit, providerName = null) {
+function cacheDescription(cacheHit, providerName = null, offloadedTo = null) {
 	if (cacheHit === "remote") return `from ${providerName || "the remote cache"}`;
 	if (cacheHit === "local") return "from cache";
-	return "built";
+	return offloadedTo ? `built on ${offloadedTo}` : "built";
 }
 //#endregion
 //#region src/commands/ios/artifact.ts
@@ -414,15 +310,17 @@ var ArtifactRefusal = class extends Error {
 		this.failure = failure;
 	}
 };
-async function acquireIosArtifact({ root, logFile, udid, remoteDestination, device, configuration, buildScheme, buildProfile, isExpo, optimizations, cache, easBuild, easProfile, maxBuilds, progress }, d) {
-	const { phase, note, logWriter, estimates, stats, step } = progress;
+async function acquireIosArtifact({ root, logFile, udid, remoteDestination, hostedDestination, simulatorArch, device, configuration, buildScheme, buildProfile, buildMachine = "auto", isExpo, optimizations, cache, easBuild, easProfile, maxBuilds, progress }, d) {
+	const { phase, note, logWriter, estimates, stats, step, miss, hit: lateHit, place, waitingOn } = progress;
 	const physical = device !== null;
 	const keyOptions = {
 		scheme: buildScheme,
 		...configuration ? { configuration } : {},
 		isSimulator: !physical,
+		...simulatorArch ? { arch: simulatorArch } : {},
 		...buildProfile ? { buildProfile } : {}
 	};
+	const providerRunOptions = iosProviderRunOptions(configuration, simulatorArch);
 	const lanAddress = device?.lanAddress ?? null;
 	const metroPort = device?.metroPort ?? null;
 	const release = isReleaseConfiguration(configuration);
@@ -476,6 +374,23 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 	let appPath = null;
 	let bundleId = null;
 	let cacheHit = false;
+	let offloadedTo = null;
+	let handoff = null;
+	let offloadFallback = null;
+	let fallbackMachine = null;
+	let hereReason = "no build machine is paired";
+	let slotWaitMs;
+	let builtOn;
+	const fallBack = (reason, line = reason) => {
+		if (namedBuildMachine(buildMachine)) throw new OffloadRefusal(buildMachine, reason);
+		offloadFallback = reason;
+		buildFailure = {
+			...buildFailure,
+			offloadFallback: reason
+		};
+		phase("build", `${line} -> building here`);
+	};
+	const openOffload = { choice: null };
 	let remote = null;
 	let abandonedRemote = false;
 	let uploadPending = null;
@@ -599,7 +514,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				platform: "ios",
 				projectRoot: root,
 				fingerprintHash: fingerprint,
-				runOptions: configuration ? { configuration } : null
+				runOptions: providerRunOptions
 			});
 			if (hit?.appPath) {
 				let stored = null;
@@ -640,6 +555,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				step("wait");
 				phase("build", text);
 			},
+			waitingOn,
 			warn: (text) => note(chalk.yellow(phaseLine("build", text))),
 			out: note
 		});
@@ -752,32 +668,48 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			}
 		}
 	}
-	function explainMiss(rekeyedBy) {
-		if (swapFellBack) missReason = skippedMissReason("the cached app could not be reused, so this run built it fresh");
-		else if (!useBuildCache) missReason = skippedMissReason(cache.disabledByFlag ? "cache reuse turned off by --no-build-cache" : "cache reuse off in config");
-		else {
-			const current = {
-				hash: storeHash ?? fingerprint,
-				sources: storeSources
-			};
-			const explained = explainBuildMiss({
-				root,
-				platform: "ios",
-				current,
-				rekeyedBy,
-				baselineDeps: { readState: d.readWorkspaceState }
-			});
-			missReason = explained.reason;
-			if (explained.previousHash && explained.changedNames.length) logWriter().write(fingerprintDiffRecord({
+	function reasonForMiss(rekeyedBy) {
+		if (swapFellBack) return {
+			reason: skippedMissReason("the cached app could not be reused, so this run built it fresh"),
+			diff: null
+		};
+		if (!useBuildCache) return {
+			reason: skippedMissReason(cache.disabledByFlag ? "cache reuse turned off by --no-build-cache" : "cache reuse off in config"),
+			diff: null
+		};
+		const current = {
+			hash: storeHash ?? fingerprint,
+			sources: storeSources
+		};
+		const explained = explainBuildMiss({
+			root,
+			platform: "ios",
+			current,
+			rekeyedBy,
+			baselineDeps: { readState: d.readWorkspaceState }
+		});
+		return {
+			reason: explained.reason,
+			diff: explained.previousHash && explained.changedNames.length ? fingerprintDiffRecord({
 				changed: explained.changedNames,
 				previousHash: explained.previousHash,
 				hash: current.hash
-			}));
-		}
+			}) : null
+		};
+	}
+	function reportPendingRecheck(prebuild) {
+		const pods = d.readPodState(root);
+		if ((prebuild === "generate" || prebuild === "regenerate" || podAction(pods, d.podsAreStale(pods.lockText, pods.manifestText)).install) && useBuildCache) miss(reasonForMiss([]).reason, true);
+	}
+	function explainMiss(rekeyedBy) {
+		const explained = reasonForMiss(rekeyedBy);
+		missReason = explained.reason;
+		if (explained.diff) logWriter().write(explained.diff);
 		buildFailure = {
 			...buildFailure,
 			missReason
 		};
+		miss(missReason);
 		phase("cache", `miss: ${missReason.summary}`);
 		if (missReason.kind === "no-baseline") {
 			const untracked = untrackedMissLine(d.untrackedNativeFiles({ projectRoot: root }));
@@ -821,31 +753,199 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			note(chalk.dim(phaseLine("fingerprint", `${shortHash(beforeBuildHash)} -> ${shortHash(storeHash)} (after xcodebuild)`)));
 		}
 	}
+	async function takeBuildSlot() {
+		if (!maxBuilds) return;
+		try {
+			buildSlot = await d.acquireBuildSlot({
+				max: maxBuilds,
+				root,
+				logFile,
+				out: note
+			});
+			slotWaitMs = buildSlot.slotWaitMs;
+		} catch (e) {
+			const refusal = (0, ownership_claim_exports.claimFailure)(e, "stim ios");
+			if (refusal) fail({
+				code: refusal.code,
+				message: refusal.message,
+				remedy: refusal.remedy,
+				build: buildFailure
+			});
+			note(chalk.yellow(phaseLine("build", `could not take a build slot: ${e?.message || e}; building anyway`)));
+		}
+	}
+	/** Whether this build should leave this Mac, before any machine is asked; null builds here. */
+	function placeBuild() {
+		const { mode, machines } = buildPlacementCandidates(buildMachine);
+		if (machines.length === 0 && !namedBuildMachine(buildMachine) && buildMachine !== "local") return null;
+		const runtime = physical || release ? null : hostedDestination?.runtime ?? (remoteDestination ? null : simulatorRuntime(udid));
+		const unsupported = physical ? "device builds build here" : remoteDestination && !hostedDestination ? "--remote builds build here" : release ? `${configuration} builds build here` : !cachePolicy.write ? "the build cache is off" : !runtime ? `the runtime of simulator ${udid} is unknown` : null;
+		const here = machineCapacity();
+		const placement = offloadPlacement({
+			mode,
+			machines: machines.length,
+			here,
+			unsupported,
+			selected: buildMachine
+		});
+		if (!placement.offload) {
+			hereReason = placement.reason;
+			if (mode !== "off") phase("build", `placement: here (${placement.reason})`);
+			return null;
+		}
+		return {
+			mode,
+			here,
+			reason: placement.reason,
+			runtime,
+			machines
+		};
+	}
+	/** Asks the paired machines once the post-mutation key is known; null builds here. */
+	async function chooseMachine(candidate) {
+		const choice = await chooseBuildMachine({
+			projectRoot: root,
+			target: {
+				platform: "ios",
+				local: {
+					...iosToolchain(),
+					...hostedDestination ? { arch: hostedDestination.architecture === "x86_64" ? "x64" : "arm64" } : {}
+				},
+				runtime: candidate.runtime,
+				cocoapodsPinned: bundlerPin(root) !== null
+			},
+			mode: candidate.mode,
+			here: candidate.here,
+			note: (line) => note(chalk.dim(phaseLine("build", `offload: ${line}`))),
+			machines: candidate.machines,
+			selected: buildMachine
+		});
+		if (typeof choice === "string") {
+			const only = candidate.machines.length === 1 ? candidate.machines[0].machine : null;
+			if (only && choice.startsWith(`${only}: `)) fallbackMachine = only;
+			fallBack(choice);
+			return null;
+		}
+		openOffload.choice = choice;
+		phase("build", `placement: ${choice.machine} (${candidate.reason}${placementLoad(choice)})`);
+		return choice;
+	}
+	/** Builds on the chosen machine and stores the app under the post-mutation key; false builds here instead unless a machine was named. */
+	async function compileElsewhere({ choice, candidate }) {
+		const runtime = candidate.runtime;
+		if (!storeKey || !storeHash) {
+			if (namedBuildMachine(buildMachine)) fallBack("the build fingerprint or cache key is unavailable");
+			return false;
+		}
+		const stagingDir = join(workspaceDir(root), "offload", "ios");
+		const outcome = await offloadBuild({
+			choice,
+			expectedFingerprint: storeHash,
+			request: {
+				platform: "ios",
+				runtime,
+				configuration,
+				scheme: buildScheme ?? null,
+				isExpo,
+				optimizations
+			},
+			stagingDir,
+			onPhase: (name, msg) => phase(name, remotePhaseText(name, msg, choice.machine)),
+			onEnter: (name) => {
+				if (name === "compile" || name === "build" || name === "prebuild" || name === "pods") {
+					builtOn = choice.machine;
+					buildFailure = {
+						...buildFailure,
+						builtOn
+					};
+				}
+				place({
+					host: choice.machine,
+					phase: name
+				});
+				step(name === "prebuild" || name === "pods" ? name : "compile");
+			},
+			onRecord: (record) => logWriter().write({
+				...record,
+				offloadedTo: choice.machine
+			}),
+			note: (line) => phase("build", line)
+		});
+		place(null);
+		let stored = null;
+		let reason = outcome.ok ? null : outcome.reason;
+		if (outcome.ok) {
+			const settled = await refingerprintAfterMutation({
+				projectRoot: root,
+				platform: "ios",
+				previousHash: storeHash,
+				fingerprint: d.fingerprintProject
+			});
+			if (!settled || settled.moved) reason = "the checkout here changed while it built";
+			else try {
+				stored = d.storeBuild("ios", storeKey, outcome.artifactPath, {
+					sources: storeSources,
+					overwrite: !useBuildCache
+				});
+			} catch (e) {
+				reason = `could not store the app: ${e?.message || e}`;
+			}
+		}
+		try {
+			rmSync(stagingDir, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+		step("compile");
+		const prepared = stored ? await installableCachedApp(stored) : null;
+		if (!outcome.ok || !prepared) {
+			const why = reason ?? "the stored app is not installable";
+			fallbackMachine = choice.machine;
+			fallBack(`${choice.machine}: ${why}`, `offload failed: ${why}`);
+			logWriter().write({
+				src: "build",
+				level: "warn",
+				event: "offload_failed",
+				msg: reason,
+				machine: choice.machine
+			});
+			return false;
+		}
+		const { timings } = outcome;
+		appPath = prepared;
+		builtOn = outcome.machine;
+		offloadedTo = outcome.machine;
+		handoff = outcome.handoff ?? null;
+		stats.setPlacement({
+			decision: "offloaded",
+			machine: outcome.machine,
+			reason: `${candidate.reason}${placementLoad(choice)}`,
+			buildMs: timings.totalMs
+		});
+		phase("build", `built on ${outcome.machine} in ${formatDuration(timings.totalMs)}: offer ${formatDuration(timings.offerMs)}, sync ${formatDuration(timings.syncMs)}, build ${formatDuration(timings.workerMs)}, fetch ${formatDuration(timings.fetchMs)}`);
+		compilationCache = outcome.compilationCache;
+		phase("cache", `compilation cache on ${outcome.machine} ${compilationCacheActivityLine(compilationCache)}`);
+		logWriter().write({
+			src: "build",
+			level: "info",
+			event: "offload_done",
+			msg: `built on ${outcome.machine}`,
+			timings
+		});
+		return true;
+	}
 	async function buildArtifact() {
 		buildFailure = {
 			fingerprint,
 			cacheKey,
 			cacheHit,
-			cacheSkipped: !useBuildCache
+			cacheSkipped: !useBuildCache,
+			buildMachine
 		};
 		if (!appPath) {
-			if (maxBuilds) try {
-				buildSlot = await d.acquireBuildSlot({
-					max: maxBuilds,
-					root,
-					logFile,
-					out: note
-				});
-			} catch (e) {
-				const refusal = (0, ownership_claim_exports.claimFailure)(e, "stim ios");
-				if (refusal) fail({
-					code: refusal.code,
-					message: refusal.message,
-					remedy: refusal.remedy,
-					build: buildFailure
-				});
-				note(chalk.yellow(phaseLine("build", `could not take a build slot: ${e?.message || e}; building anyway`)));
-			}
+			const offload = placeBuild();
+			if (!offload) await takeBuildSlot();
 			const mutatingSteps = [];
 			const rekeyedBy = [];
 			const prebuild = d.planPrebuild(root, "ios", {
@@ -857,6 +957,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				...staleNativeDirRefusal("ios"),
 				build: buildFailure
 			});
+			reportPendingRecheck(prebuild);
 			if (prebuild === "generate" || prebuild === "regenerate") {
 				step("prebuild");
 				recordPrebuild(root, "ios", null);
@@ -887,7 +988,8 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				});
 			}
 			const podState = d.readPodState(root);
-			const action = podAction(podState, d.podsAreStale(podState.lockText, podState.manifestText));
+			const verdict = d.podsAreStale(podState.lockText, podState.manifestText);
+			const action = podAction(podState, verdict);
 			if (action.install) {
 				step("pods");
 				const result = await d.runPodInstall(root, logWriter(), { estimateMs: estimates().podsMs });
@@ -943,6 +1045,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 						if (prepared) {
 							appPath = prepared;
 							cacheHit = "local";
+							lateHit();
 							phase("cache", `hit ${shortHash(storeHash)} (post-${mutatingSteps.join("/")} key)`);
 							if (releasedWait) {
 								waitedForBuild = releasedWait.facts;
@@ -952,15 +1055,42 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					}
 				}
 			}
-			if (!appPath) {
+			if (offload && !appPath) {
 				explainMiss(rekeyedBy);
 				step("compile");
+				if (!storeKey) fallBack("no cache key to store the app under", "offload failed: no cache key to store the app under");
+				const choice = storeKey ? await chooseMachine(offload) : null;
+				if (!choice || !await compileElsewhere({
+					choice,
+					candidate: offload
+				})) await takeBuildSlot();
+			}
+			if (!appPath) {
+				if (!offload) explainMiss(rekeyedBy);
+				step("compile");
+				if (offload) stats.setPlacement({
+					decision: "fell-back",
+					slotWaitMs,
+					reason: offloadFallback ?? "offload failed",
+					...fallbackMachine ? { machine: fallbackMachine } : {}
+				});
+				else stats.setPlacement({
+					decision: "here",
+					reason: hereReason,
+					slotWaitMs
+				});
+				builtOn = "here";
+				buildFailure = {
+					...buildFailure,
+					builtOn
+				};
 				phase("build", `compiling ${configuration || "Debug"} with xcodebuild`);
 				const result = await d.buildIos({
 					root,
 					scheme: buildScheme,
 					udid,
 					destination: remoteDestination ? GENERIC_SIM_DESTINATION : null,
+					arch: remoteDestination ? simulatorArch : null,
 					...physical ? { sdk: IPHONEOS_SDK } : {},
 					logWriter: logWriter(),
 					...configuration ? { configuration } : {},
@@ -1023,7 +1153,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					projectRoot: root,
 					fingerprintHash: storeHash,
 					buildPath: appPath,
-					runOptions: configuration ? { configuration } : null
+					runOptions: providerRunOptions
 				});
 			}
 		}
@@ -1033,11 +1163,15 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		await resolveInitialFingerprint();
 		if (!easBuild) {
 			remote = await resolveRemoteArtifact();
+			if (!appPath) miss(reasonForMiss([]).reason);
 			await awaitSharedBuild();
 			await prepareCachedArtifact();
+			if (appPath) lateHit();
+			else if (swapFellBack) miss(reasonForMiss([]).reason);
 			await buildArtifact();
 		}
 		const artifact = {
+			handoff,
 			path: appPath,
 			bundleId,
 			cache: {
@@ -1047,6 +1181,10 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				} : null,
 				hit: cacheHit,
 				providerName: remote?.name ?? providerName,
+				buildMachine,
+				...builtOn ? { builtOn } : {},
+				offloadedTo,
+				offloadFallback: offloadedTo ? null : offloadFallback,
 				readEnabled: useBuildCache,
 				missReason: cacheHit ? null : missReason,
 				waitedForBuild,
@@ -1054,6 +1192,8 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			},
 			failureFields: {
 				...buildFailure,
+				buildMachine,
+				...builtOn ? { builtOn } : {},
 				fingerprint: storeHash,
 				cacheKey: storeKey,
 				cacheHit,
@@ -1076,6 +1216,23 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			artifact
 		};
 	} catch (error) {
+		if (error instanceof OffloadRefusal) {
+			const refusal = error;
+			return {
+				ok: false,
+				failure: {
+					code: refusal.code,
+					message: refusal.message,
+					remedy: refusal.remedy,
+					build: {
+						...buildFailure,
+						buildMachine,
+						...builtOn ? { builtOn } : {}
+					}
+				},
+				compilationCache
+			};
+		}
 		if (error instanceof ArtifactRefusal) return {
 			ok: false,
 			failure: error.failure,
@@ -1083,12 +1240,248 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		};
 		throw error;
 	} finally {
+		if (openOffload.choice) closeOffload(openOffload.choice);
 		releaseLock();
 		releaseSlot();
 		if (!transferred) releaseArtifact();
 	}
 }
 //#endregion
+//#region src/commands/ios/remote.ts
+function resolveIosRemote({ opts, settings, physical, recorded }) {
+	const target = opts.remote !== void 0 ? parseIosRemote(opts.remote) : remoteIosSetting(settings);
+	if (target?.kind === "machine" && target.machine === "auto") return { failure: {
+		code: "STIM_BAD_ARG",
+		message: "stim ios --remote auto is not available yet: automatic placement has not shipped. Name a hosting Mac from hosting.machines."
+	} };
+	if (physical && target?.kind === "machine") return { failure: {
+		code: "STIM_BAD_ARG",
+		message: "--device builds for a phone connected to this machine, and --remote installs on a remote one.",
+		remedy: "Pass only one of --device and --remote; unset ios.remote for a local phone."
+	} };
+	const machine = target?.kind === "machine" ? target.machine : null;
+	if (recorded && recorded.machine !== machine) return { failure: {
+		code: "STIM_BAD_ARG",
+		message: `This workspace's iOS simulator runs on ${recorded.machine}; run stim stop first.`
+	} };
+	return {
+		machine,
+		backend: !physical && target?.kind === "backend" ? target.backend : null,
+		recorded
+	};
+}
+function selectIosTarget({ root, slot, opts, settings, physical, release, metroCheck, d }) {
+	let recorded;
+	try {
+		recorded = d.readHostedIos(root, slot)[slot];
+	} catch (error) {
+		return { failure: {
+			code: "STIM_HOSTING_REFUSED",
+			message: error.message,
+			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
+		} };
+	}
+	const selection = resolveIosRemote({
+		opts,
+		settings,
+		physical,
+		recorded
+	});
+	if ("failure" in selection) return selection;
+	const localIos = selection.machine ? deviceSlotPlatforms(d.getProject(root), slot)?.ios : void 0;
+	if (selection.machine && localIos?.owned && localIos.deviceUdid) {
+		let localRunning = true;
+		try {
+			localRunning = d.listAllIosSims({ timeoutMs: 5e3 }).some((sim) => sim.udid === localIos.deviceUdid && sim.state !== "Shutdown");
+		} catch {}
+		if (localRunning) return { failure: {
+			code: "STIM_BAD_ARG",
+			message: `This workspace's iOS simulator for slot ${slot} runs on this Mac; run stim stop first.`
+		} };
+	}
+	if (selection.machine && !release && !metroCheck) return { failure: {
+		code: "STIM_BAD_ARG",
+		message: "Hosted Debug runs require the local Metro supervisor; --no-metro-check cannot be used.",
+		remedy: "Run stim stop; stim start, then retry without --no-metro-check."
+	} };
+	return selection;
+}
+function hostedIosSelectors(deviceType, runtime) {
+	return {
+		...deviceType ? { deviceType } : {},
+		...runtime ? { runtime } : {}
+	};
+}
+async function connectIosTarget(selection, selectors, d) {
+	if (!selection.machine) return { target: null };
+	try {
+		return { target: await d.prepareHostedIos(selection.machine, selectors, selection.recorded) };
+	} catch (error) {
+		return { failure: {
+			code: error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "STIM_HOSTING_REFUSED",
+			message: error instanceof Error ? error.message : String(error),
+			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
+		} };
+	}
+}
+function hostedIosBuildTarget(target) {
+	return target ? { hostedDestination: {
+		runtime: target.choice.runtimeId,
+		architecture: target.choice.architecture
+	} } : {};
+}
+async function iosPlacementBudget(d, root, note, hosted) {
+	return hosted ? {
+		reclaimed: [],
+		refusal: null
+	} : d.budgetGate({
+		root,
+		note
+	});
+}
+function hostedIosMetroNote(hosted, settings, note) {
+	if (hosted && settings.iosSimulatorApp !== void 0) note(chalk.dim(phaseLine("device", "iosSimulatorApp is ignored on a hosting Mac; the simulator boots headless.")));
+	if (hosted && (publicUrlSetting(settings) || tunnelModeSetting(settings))) note(chalk.dim(phaseLine("metro", "metro.publicUrl and metro.tunnel are ignored on a hosting Mac; Metro uses the private tailnet bridge.")));
+}
+async function connectIosBackend(root, backend, deviceType, d) {
+	if (!backend) return {
+		remote: null,
+		arch: null
+	};
+	const resolved = await d.resolveRemoteContext({
+		root,
+		backend,
+		easBin: d.resolveEasCliBin(root)?.file ?? null,
+		deviceType: deviceType?.trim() || null
+	});
+	if ("failed" in resolved) return { failure: {
+		code: resolved.code ?? "STIM_NO_REMOTE_SESSION",
+		message: resolved.failed,
+		remedy: resolved.remedy
+	} };
+	return {
+		remote: d.remoteIosDeps(resolved.ctx),
+		arch: await d.readRemoteSimulatorArch(resolved.ctx.existingDaemon)
+	};
+}
+function iosMetroSettings(settings, hosted) {
+	return hosted ? {
+		...settings,
+		ios: {
+			...isJsonObject(settings.ios) ? settings.ios : {},
+			remote: void 0
+		},
+		android: {
+			...isJsonObject(settings.android) ? settings.android : {},
+			remote: void 0
+		},
+		metro: {
+			...isJsonObject(settings.metro) ? settings.metro : {},
+			tunnel: void 0,
+			publicUrl: void 0,
+			ngrokUrl: void 0
+		}
+	} : settings;
+}
+//#endregion
+//#region src/commands/ios/hosted.ts
+async function finishHostedIosRun({ target, d, artifact, root, slot, release, isExpo, metroCheck, metroPort, logsDir, fail, note, selectors, ...report }) {
+	const bundleId = artifact.bundleId ?? (d.readBundleId(artifact.path) || d.detectBundleId(root));
+	if (!bundleId) return fail({
+		code: "STIM_INSTALL_FAILED",
+		message: "The built app has no bundle identifier."
+	});
+	const launchedAt = d.now();
+	let run;
+	try {
+		run = await d.placeHostedIos(target, {
+			root,
+			slot,
+			bundle: artifact.path,
+			handoff: artifact.handoff,
+			bundleId,
+			selectors,
+			release,
+			...!release && isExpo ? { devClientScheme: d.devClientScheme(root, artifact.path) ?? void 0 } : {},
+			reserved: (placement) => d.writeHostedIos(root, slot, placement),
+			note
+		});
+	} catch (error) {
+		return fail({
+			code: error.code ?? "STIM_HOSTING_REFUSED",
+			message: error.message,
+			remedy: error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? error.remedy : `Retry stim ios --remote ${target.host.machine}, or run stim stop to reconcile any recorded placement.`
+		});
+	}
+	d.writeHostedIos(root, slot, run.placement);
+	d.writeWorkspaceLaunch(root, "ios", {
+		appId: bundleId,
+		deviceId: run.placement.session,
+		metroPort,
+		release,
+		launchedAt: new Date(launchedAt).toISOString()
+	}, slot);
+	let launched = run.launched;
+	if (!release && metroCheck) {
+		const evidence = await d.verifyLaunch({
+			requireBundleResponse: true,
+			platform: "ios",
+			logsDir,
+			since: launchedAt,
+			metroPort,
+			mode: isExpo ? MODE_EXPO : MODE_BARE,
+			slot: launchSlotScope(root, slot),
+			platformShared: siblingPlatformSlots(root, "ios", slot).length > 0
+		});
+		if (evidence.fatal) return fail({
+			code: "STIM_LAUNCH_FAILED",
+			message: "Metro could not deliver the hosted app bundle.",
+			remedy: "Run stim logs --errors and fix the bundle error."
+		});
+		launched = evidence.verified ? true : evidence.requested ? "bundling" : "unverified";
+	}
+	if (launched === "unverified") note(`Launch on ${target.host.machine} is unverified; check the hosted app, then retry stim ios --remote ${target.host.machine}.`);
+	const cache = artifact.cache;
+	const device = run.placement.device;
+	const uploadsAbandoned = await artifact.completeUploads();
+	return {
+		facts: reportIosResult({
+			...report,
+			root,
+			slot,
+			release,
+			metroCheck,
+			metroPort,
+			logsDir,
+			device: {
+				deviceName: device.deviceType,
+				deviceType: device.deviceType,
+				runtime: device.runtime
+			},
+			udid: "",
+			host: hostedIosStatus(run.placement),
+			appPath: artifact.path,
+			bundleId,
+			installSkipped: false,
+			storeHash: cache.identity?.fingerprint ?? null,
+			storeKey: cache.identity?.key ?? null,
+			cacheHit: cache.hit,
+			missReason: cache.missReason,
+			compilationCache: cache.compilation,
+			useBuildCache: cache.readEnabled,
+			waitedForBuild: cache.waitedForBuild,
+			launchState: launched,
+			providerName: cache.providerName,
+			buildMachine: cache.buildMachine,
+			builtOn: cache.builtOn,
+			offloadedTo: cache.offloadedTo,
+			offloadFallback: cache.offloadFallback,
+			webPreviewUrl: null
+		}),
+		uploadsAbandoned
+	};
+}
+//#endregion
 //#region src/engine/ios-profile.ts
 const TAG = /<(\/?)\s*([A-Za-z0-9_]+)(?:\s[^>]*?)?(\/?)>/g;
 const ENTITIES = {
@@ -1587,7 +1980,7 @@ function hostLanCandidates(interfaces = networkInterfaces) {
 //#endregion
 //#region src/commands/ios/collector.ts
 function collectorLogFile(root, slot) {
-	return join(workspaceLogsDir(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
+	return join(workspaceLogsDir$1(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
 }
 function collectorEntry() {
 	return spawnEntry("collector-run");
@@ -1648,7 +2041,7 @@ async function replaceCollector({ root, slot = "default", udid, bundleId, appNam
 	if (payloadUrl) args.push("--payload-url", payloadUrl);
 	let stdio = "ignore";
 	try {
-		mkdirSync(workspaceLogsDir(root), { recursive: true });
+		mkdirSync(workspaceLogsDir$1(root), { recursive: true });
 		const fd = openSync(collectorLogFile(root, slot), "a");
 		stdio = [
 			"ignore",
@@ -1680,23 +2073,34 @@ async function replaceCollector({ root, slot = "default", udid, bundleId, appNam
 //#endregion
 //#region src/commands/ios/dependencies.ts
 const DEFAULT_DEPS = {
+	prepareHostedIos,
+	placeHostedIos,
+	readHostedIos,
+	writeHostedIos,
 	resolveEasDevelopmentBuild,
-	findProjectRoot,
+	findProjectRoot: findProjectRoot$1,
 	resolveSettings,
+	settingsLayers,
+	settingOriginScope,
 	gitCommonDir,
 	repoRoot,
 	detectBundleId,
 	detectIsExpo,
 	devClientScheme,
+	devClientTakesDevMenuParams,
 	getProject,
 	upsertProject,
+	recordIosSchemeApprovals,
 	checkDeviceCapacity,
 	budgetGate,
 	ensureOwnedDevice,
 	listIosRuntimes,
+	listAllIosSims,
 	ensureBooted,
 	resolveRemoteContext,
 	remoteIosDeps,
+	readRemoteSimulatorArch,
+	hostSimulatorArch,
 	ensureMetroReachable,
 	ensureRemoteBootOwned,
 	detectProviders,
@@ -1748,6 +2152,7 @@ const DEFAULT_DEPS = {
 	swapJsBundle,
 	installIosApp,
 	clearOtherUserApps,
+	clearIosAppData,
 	clearIosAdoptionPending,
 	launchIosApp,
 	verifyLaunch,
@@ -1922,7 +2327,7 @@ function reportUnverified({ verification, siblings, slot, phase, note, metroPort
 		waitedMs: verification.waitedMs,
 		bundleId,
 		udid,
-		devClientUrl: scheme ? devClientUrl(scheme, metroPort ?? 8081, lanAddress ?? void 0) : null,
+		devClientUrl: scheme ? launched?.url ?? devClientUrl(scheme, metroPort ?? 8081, lanAddress ?? void 0) : null,
 		mode: isExpo ? MODE_EXPO : MODE_BARE,
 		remote: remoteDevice,
 		physical,
@@ -1949,20 +2354,30 @@ function installsOverWifi(d, udid, selectedWireless, note) {
 	if (wireless) note(phaseLine("device", `${current?.name ?? udid} is paired over Wi-Fi, so the install and launch go over the network and take longer than over a cable`));
 	return wireless;
 }
-function cleanAdoptedIosApps({ d, root, slot, udid, bundleId, phase, note }) {
+function cleanAdoptedIosApps({ d, udid, bundleId, devClient, phase, note }) {
 	const swept = d.clearOtherUserApps({
 		udid,
 		keep: bundleId
 	});
 	if (swept.removed.length) phase("install", `removed ${swept.removed.join(", ")}, left by the previous workspace`);
 	if (swept.listed && swept.failed.length === 0) {
-		d.clearIosAdoptionPending(root, slot);
+		if (swept.kept && bundleId) {
+			try {
+				d.clearIosAppData(udid, bundleId, { defaultsPlist: devClient ? IOS_DEV_MENU_OFF_DEFAULTS_PLIST : null });
+			} catch (error) {
+				return `Could not clear the data ${bundleId} kept from the previous workspace: ${String(error?.message || error)}`;
+			}
+			phase("install", `cleared ${bundleId} data left by the previous workspace`);
+		}
 		return null;
 	}
 	if (!swept.listed) return "Could not list apps left by the previous workspace.";
 	for (const failure of swept.failed) note(chalk.yellow(phaseLine("install", `could not remove ${failure}, left by the previous workspace`)));
 	return `Could not remove ${swept.failed.join(", ")}, left by the previous workspace.`;
 }
+function installMayBeProven(adopting, parkedCacheKey, storeKey) {
+	return !adopting || !parkedCacheKey || parkedCacheKey === storeKey;
+}
 function resolveRunBundleId(d, root, appPath, bundleId) {
 	if (!appPath || bundleId) return bundleId;
 	return d.readBundleId(appPath) || d.detectBundleId(root);
@@ -1995,7 +2410,7 @@ function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
 }
 async function finishIosRun({ artifact, d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, wireless, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, fail, phase, note, logWriter, elapsed, startedAt, closeWriter, lease, releaseLease, recordRun, reclaimed, devServer, enterPhase }) {
 	const { path: appPath, bundleId: initialBundleId, failureFields: buildFailure, cache } = artifact;
-	const { hit: cacheHit, providerName, readEnabled: useBuildCache, missReason, waitedForBuild, compilation: compilationCache } = cache;
+	const { hit: cacheHit, providerName, buildMachine, builtOn, offloadedTo, offloadFallback, readEnabled: useBuildCache, missReason, waitedForBuild, compilation: compilationCache } = cache;
 	const storeHash = cache.identity?.fingerprint ?? null;
 	const storeKey = cache.identity?.key ?? null;
 	const runCommand = nativeRunCommand("ios", slot, {
@@ -2033,7 +2448,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		}
 	});
 	if (bundleId) d.upsertProject(root, { bundleId });
-	enterPhase("install");
+	enterPhase("device");
 	const booted = await bootPromise;
 	if (!booted?.ok) return fail({
 		code: booted?.code || "STIM_NO_DEVICE",
@@ -2043,6 +2458,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 	const deviceOutcome = physical ? "connected" : `${device?.adopted ? "adopted" : "booted"} ${bootDuration()}`;
 	phase("device", `${deviceLabel(device, udid)} ${deviceOutcome}`);
 	const scheme = release ? void 0 : d.devClientScheme(root, appPath);
+	const devMenuParams = d.devClientTakesDevMenuParams(root);
 	const appName = appNameFromPath(appPath);
 	const appExecutable = readRunExecutable(d, appPath, note);
 	const dropSwapDir = artifact.release;
@@ -2058,6 +2474,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			root,
 			note
 		});
+		enterPhase("install");
 		const installTimer = stepTimer(d.now);
 		const installed = d.installIosDeviceApp({
 			udid,
@@ -2160,9 +2577,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		if (adopting) {
 			const cleanupFailure = cleanAdoptedIosApps({
 				d,
-				root,
 				udid,
 				bundleId,
+				devClient: Boolean(scheme),
 				phase,
 				note
 			});
@@ -2177,13 +2594,15 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 				}
 			});
 		}
+		enterPhase("install");
 		const installTimer = stepTimer(d.now);
 		const installed = d.installIosApp({
 			udid,
 			appPath,
 			bundleId,
 			devClientScheme: scheme,
-			proveInstalled: !adopting || device?.parkedCacheKey === storeKey
+			schemeApprovals: device.schemeApprovals,
+			proveInstalled: installMayBeProven(adopting, device?.parkedCacheKey, storeKey)
 		}, { now: d.now });
 		if (installed?.failed) return fail({
 			code: installed.code || "STIM_INSTALL_FAILED",
@@ -2195,10 +2614,12 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 				bundleId
 			}
 		});
+		if (adopting) d.clearIosAdoptionPending(root, slot);
 		installSkipped = Boolean(installed?.skipped);
 		const artifactDuration = installed?.artifactDurationMs === void 0 ? installTimer() : `(${formatDuration(installed.artifactDurationMs)})`;
 		phase("install", installSkipped ? `unchanged (${deviceShortName(device, udid)} already has this build) ${artifactDuration}` : `${basename(appPath)} -> ${deviceLabel(device, udid)} ${artifactDuration}`);
 		if (!remoteDevice && installed?.devClientPreparationDurationMs !== void 0) phase("install", `dev client prepared (${formatDuration(installed.devClientPreparationDurationMs)})`);
+		if (installed.schemeApprovals) d.recordIosSchemeApprovals(root, udid, installed.schemeApprovals, slot);
 		dropSwapDir();
 		if (!remoteDevice) await d.replaceCollector({
 			root,
@@ -2230,6 +2651,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			bundleId,
 			metroPort,
 			devClientScheme: scheme,
+			devMenuParams,
 			consolePaths: simulatorConsolePaths({
 				deviceId: udid,
 				appId: bundleId,
@@ -2360,12 +2782,20 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			launchState,
 			launchWarning,
 			providerName,
+			buildMachine,
+			builtOn,
+			offloadedTo,
+			offloadFallback,
 			closeWriter,
 			webPreviewUrl: remoteDevice?.webPreviewUrl() ?? null,
 			lease: physical ? leaseFacts : void 0,
 			recordRun,
 			reclaimed,
-			devServer
+			devServer,
+			links: workspaceLinks(root, {
+				platform: "ios",
+				slot
+			})
 		}),
 		uploadsAbandoned
 	};
@@ -2424,21 +2854,26 @@ async function planIos(opts, d, schemeRefusal) {
 		platform: "ios",
 		slot,
 		root,
-		projectKey: statsProjectKey({
+		projectKey: statsProjectKey$1({
 			root,
 			commonDir: settingsContext.gitCommonDir,
 			repoRoot: settingsContext.repoRoot
 		})
 	};
 	const isExpo = d.detectIsExpo(root);
+	const settingsLayersForOrigin = d.settingsLayers(settingsContext);
+	const iosRemote = remoteIosSetting(settings);
 	const modelRefusal = deviceModelRefusal({
 		slot,
 		deviceTypeFlag: opts.deviceType,
 		runtimeFlag: opts.runtime,
 		deviceType: resolveDeviceType(opts.deviceType, settings),
 		runtime: resolveRuntime(opts.runtime, settings),
+		deviceTypeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.deviceType"),
+		runtimeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.runtime"),
 		physical: false,
-		remoteBackend: remoteIosSetting(settings),
+		remoteBackend: iosRemote?.kind === "backend" ? iosRemote.backend : null,
+		hosted: iosRemote?.kind === "machine",
 		listRuntimes: d.listIosRuntimes
 	});
 	if (modelRefusal) return refuse(modelRefusal);
@@ -2463,6 +2898,12 @@ async function planIos(opts, d, schemeRefusal) {
 			refusal: eas.missing
 		}), json);
 	}
+	const remoteBackend = remoteIosSetting(settings);
+	if (remoteBackend) return refuse({
+		code: "STIM_BAD_ARG",
+		message: `ios.remote routes this workspace's runs to a ${remoteBackend.kind === "backend" ? remoteBackend.backend : remoteBackend.machine} device, whose architecture --plan cannot read without a session.`,
+		remedy: "Run `stim ios` to build for the remote device, or unset ios.remote to plan the owned simulator."
+	});
 	const refusal = schemeRefusal(root, opts.scheme, isExpo);
 	if (refusal) return refuse({
 		code: refusal.code,
@@ -2483,10 +2924,17 @@ async function planIos(opts, d, schemeRefusal) {
 		message: `Could not fingerprint ${root}: @expo/fingerprint produced no hash for it.`,
 		remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry."
 	});
+	const arch = simulatorBuildArch({
+		physical: false,
+		remoteArch: null,
+		hostArch: d.hostSimulatorArch(),
+		configuration
+	});
 	const cacheKey = buildCacheKey("ios", fingerprint.hash, {
 		scheme: opts.scheme,
 		...configuration ? { configuration } : {},
 		isSimulator: true,
+		...arch ? { arch } : {},
 		...buildProfile ? { buildProfile } : {}
 	});
 	const plan = await planCachedBuild({
@@ -2497,7 +2945,7 @@ async function planIos(opts, d, schemeRefusal) {
 		cacheKey,
 		cachePolicy,
 		providerConfig: d.resolveCacheProviderConfig(settingsContext),
-		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: configuration ? { configuration } : null } : null
+		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: iosProviderRunOptions(configuration, arch) } : null
 	}, {
 		loadCacheProvider: d.loadCacheProvider,
 		loadProjectProvider: d.loadProjectProvider,
@@ -2520,9 +2968,9 @@ 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, wired to the reserved Metro port. A Debug run starts 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("--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 <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
-		if (REMOTE_DEVICE_BACKENDS.includes(value)) return value;
-		throw new InvalidArgumentError(`expected one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}`);
+	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator, wired to the reserved Metro port. A Debug run starts 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("--build-machine <value>", "Build on auto, local, 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 hosting.machines; named Macs never fall back locally. auto is not available yet.", (value) => {
+		if (parseMachine(value)) return value.trim();
+		throw new InvalidArgumentError("expected eas, proxy, auto, or a hosting 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). Only with --device.").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. Only with --device.").action(async (opts) => {
 		if (opts.plan) {
 			const d = {
@@ -2583,8 +3031,34 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	if (project.error) return project.error;
 	return d.resolveScheme(project, { scheme }).error ?? null;
 }
+function resolveIosBuildSetup(flag, settings) {
+	const placement = resolveBuildPlacement(flag);
+	if (placement.failure) return {
+		ok: false,
+		failure: {
+			...placement.failure,
+			setup: true
+		}
+	};
+	try {
+		return {
+			ok: true,
+			buildMachine: placement.selected,
+			optimizations: resolveOptimizations(settings)
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			failure: {
+				code: "STIM_BAD_ARG",
+				message: error.message,
+				remedy: SETTING_SHAPE_REMEDY
+			}
+		};
+	}
+}
 function iosSlotLogFile(root, slot) {
-	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
+	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir$1(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
 }
 function iosSlotDeps(d, slot) {
 	if (slot !== "default") {
@@ -2675,10 +3149,16 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		process.exitCode = 1;
 		return null;
 	}
-	const logsDir = workspaceLogsDir(root);
+	const logsDir = workspaceLogsDir$1(root);
 	const logFile = iosSlotLogFile(root, slot);
 	let writer = null;
-	const logWriter = () => writer ||= d.createWriter(logFile, { truncate: true });
+	const logWriter = () => writer ||= tapBuildLog(d.createWriter(logFile, {
+		truncate: true,
+		fields: {
+			platform: "ios",
+			slot
+		}
+	}), progress);
 	let leaseHandle = null;
 	let stopLeaseSignals = null;
 	const releaseLease = () => {
@@ -2698,13 +3178,15 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		write: (statsRun, at) => d.recordStats(statsRun, at),
 		now: () => d.now(),
 		note: (line) => note(chalk.dim(line)),
-		phases: () => progress.durations()
+		phases: () => progress.durations(),
+		deviceSetup: () => progress.deviceSetupKnown()
 	});
 	const recordRun = stats.record;
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
 	let reclaimed = [];
+	let buildMachine = "auto";
 	let builtConfiguration = null;
-	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease }) => {
+	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease, setup = false }) => {
 		({code, message, remedy, lines} = cancelledFailure("ios", {
 			code,
 			message
@@ -2720,6 +3202,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		if (remedy) note(chalk.dim(phaseLine("remedy", remedy)));
 		if (logPath) note(chalk.dim(phaseLine("log", logPath)));
 		if (build) writeLastBuild(root, lastBuildRecord({
+			buildMachine,
 			...build,
 			configuration: builtConfiguration,
 			startedAt,
@@ -2728,7 +3211,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			durationMs: elapsed()
 		}));
 		note(chalk.red(phaseLine("failed", code)));
-		recordRun({
+		if (!setup) recordRun({
 			failed: true,
 			durationMs: elapsed()
 		});
@@ -2750,12 +3233,13 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		gitCommonDir: d.gitCommonDir(root),
 		repoRoot: settingsRepoRoot
 	};
-	const projectKey = statsProjectKey({
+	const projectKey = statsProjectKey$1({
 		root,
 		commonDir: settingsContext.gitCommonDir,
 		repoRoot: settingsRepoRoot
 	});
 	stats.setProject(projectKey);
+	progress.estimate(projectKey);
 	let estimatesRead = null;
 	const estimates = () => estimatesRead ??= d.readEstimates({
 		projectKey,
@@ -2769,16 +3253,10 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		lines: moreShapeErrors,
 		remedy: SETTING_SHAPE_REMEDY
 	});
-	let optimizations;
-	try {
-		optimizations = resolveOptimizations(settings);
-	} catch (error) {
-		return fail({
-			code: "STIM_BAD_ARG",
-			message: error.message,
-			remedy: SETTING_SHAPE_REMEDY
-		});
-	}
+	const setup = resolveIosBuildSetup(opts.buildMachine, settings);
+	if (!setup.ok) return fail(setup.failure);
+	buildMachine = setup.buildMachine;
+	const { optimizations } = setup;
 	const buildProfile = optimizationBuildProfile("ios", optimizations);
 	const cacheProviderConfig = d.resolveCacheProviderConfig(settingsContext);
 	for (const key of unknownSettingKeys(settings)) note(phaseLine("setting", chalk.yellow(`Warning: setting "${key}" is not read by Stim and will be ignored.`)));
@@ -2819,63 +3297,55 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		message: "--device builds for a phone connected to this machine, and --remote installs on a remote one.",
 		remedy: "Pass only one of --device and --remote."
 	});
-	const noWait = opts.wait === false;
-	const waitFlagged = opts.wait !== void 0;
-	if (opts.waitConflict) return fail({
-		code: "STIM_BAD_ARG",
-		message: "--wait and --no-wait ask for opposite things.",
-		remedy: "Pass `--wait <seconds>` to wait for the lease, or `--no-wait` to install without one."
-	});
-	if (waitFlagged && !physical) return fail({
-		code: "STIM_BAD_ARG",
-		message: "--wait and --no-wait only apply to a `--device` run.",
-		remedy: "This workspace owns its simulator, so nothing contends for it. Drop the flag, or pass `--device`."
-	});
-	const waitParsed = parseDeviceWait(noWait ? void 0 : opts.wait);
-	if ("error" in waitParsed) return fail({
-		code: "STIM_BAD_ARG",
-		message: waitParsed.error,
-		remedy: "Pass a whole number of seconds, e.g. --wait 90. `--wait 0` refuses a leased device at once."
-	});
-	const waitSeconds = waitParsed.seconds;
+	const wait = resolveIosWait(opts, physical);
+	if ("failure" in wait) return fail(wait.failure);
+	const { waitSeconds, noWait } = wait;
 	const isExpo = d.detectIsExpo(root);
 	const schemeRefusal = explicitSchemeRefusal(root, buildScheme, isExpo, d);
 	if (schemeRefusal) return fail(schemeRefusal);
-	const remoteBackend = physical ? null : opts.remote ?? remoteIosSetting(settings);
-	const viewer = resolveSimulatorAppFlag(opts.simulatorApp, physical, remoteBackend);
+	const remoteSelection = selectIosTarget({
+		root,
+		slot,
+		opts,
+		settings,
+		physical,
+		release,
+		metroCheck,
+		d
+	});
+	if ("failure" in remoteSelection) return fail(remoteSelection.failure);
+	const { machine: hostedMachine, backend: remoteBackend } = remoteSelection;
+	const viewer = resolveSimulatorAppFlag(opts.simulatorApp, physical, hostedMachine ?? remoteBackend);
 	if ("refusal" in viewer) return fail(viewer.refusal);
 	const { simulatorApp } = viewer;
+	const settingsLayersForOrigin = d.settingsLayers(settingsContext);
 	const modelRefusal = deviceModelRefusal({
 		slot,
 		deviceTypeFlag: opts.deviceType,
 		runtimeFlag: opts.runtime,
 		deviceType,
 		runtime,
+		deviceTypeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.deviceType"),
+		runtimeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.runtime"),
 		physical,
 		remoteBackend,
+		hosted: Boolean(hostedMachine),
 		listRuntimes: d.listIosRuntimes
 	});
 	if (modelRefusal) return fail(modelRefusal);
-	const budget = await d.budgetGate({
-		root,
-		note
-	});
-	reclaimed = budget.reclaimed;
-	if (budget.refusal) return fail(budget.refusal);
-	let remoteDevice = null;
-	if (remoteBackend) {
-		const resolved = await d.resolveRemoteContext({
-			root,
-			backend: remoteBackend,
-			easBin: d.resolveEasCliBin(root)?.file ?? null
-		});
-		if ("failed" in resolved) return fail({
-			code: resolved.code ?? "STIM_NO_REMOTE_SESSION",
-			message: resolved.failed,
-			remedy: resolved.remedy
-		});
-		remoteDevice = d.remoteIosDeps(resolved.ctx);
-		d = {
+	const selectors = hostedIosSelectors(deviceType, runtime);
+	const connected = await connectIosTarget(remoteSelection, selectors, d);
+	if ("failure" in connected) return fail(connected.failure);
+	const hostedTarget = connected.target;
+	try {
+		const budget = await iosPlacementBudget(d, root, note, Boolean(hostedTarget));
+		reclaimed = budget.reclaimed;
+		if (budget.refusal) return fail(budget.refusal);
+		const backendConnection = await connectIosBackend(root, remoteBackend, opts.deviceType, d);
+		if ("failure" in backendConnection) return fail(backendConnection.failure);
+		const remoteDevice = backendConnection.remote;
+		const remoteArch = hostedTarget ? hostedTarget.choice.architecture : backendConnection.arch;
+		if (remoteDevice) d = {
 			...d,
 			checkDeviceCapacity: remoteDevice.checkDeviceCapacity,
 			ensureOwnedDevice: remoteDevice.ensureOwnedDevice,
@@ -2883,376 +3353,432 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			installIosApp: remoteDevice.installIosApp,
 			launchIosApp: remoteDevice.launchIosApp
 		};
-	}
-	const easBuild = await d.resolveEasDevelopmentBuild({
-		root,
-		platform: "ios",
-		profile: opts.easProfile,
-		note,
-		isExpo,
-		physical,
-		selectors: [opts.scheme, opts.configuration],
-		buildCache: opts.buildCache
-	});
-	if (isEasBuildFailure(easBuild)) return fail(easBuild);
-	const registerProject = () => d.upsertProject(root, {
-		bundleId: d.detectBundleId(root) ?? void 0,
-		isExpo
-	});
-	if (remoteBackend !== "eas") registerProject();
-	const proj = d.getProject(root);
-	const limits = d.getConcurrencyLimits();
-	let physicalDevice = null;
-	let wireless = false;
-	if (physical && typeof deviceFlag !== "string") {
-		const pooled = await d.selectFromPool({
+		const easBuild = await d.resolveEasDevelopmentBuild({
 			root,
 			platform: "ios",
-			idLabel: "udid",
-			list: () => iosPoolCandidates(d.listIosDevices()).map((entry) => ({
-				id: entry.udid,
-				name: entry.name,
-				fallback: isWirelessIosDevice(entry)
-			})),
-			noCandidates: () => {
-				const resolved = iosPoolNoCandidatesRefusal(d.listIosDevices());
-				return {
-					message: resolved.error,
-					remedy: resolved.remedy
-				};
-			},
-			waitSeconds,
-			noWait,
-			now: d.now,
-			warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
-		});
-		if (pooled.status === "refused") return fail({
-			code: pooled.refusal.code,
-			message: pooled.refusal.message,
-			remedy: pooled.refusal.remedy,
-			...pooled.refusal.lease === null ? {} : { lease: pooled.refusal.lease }
-		});
-		physicalDevice = {
-			udid: pooled.candidate.id,
-			name: pooled.candidate.name ?? pooled.candidate.id
-		};
-		wireless = pooled.candidate.fallback === true;
-	} else if (physical) {
-		const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, d.listIosDevices());
-		if (!resolved.udid) return fail({
-			code: "STIM_NO_DEVICE",
-			message: resolved.error,
-			remedy: resolved.remedy
+			profile: opts.easProfile,
+			note,
+			isExpo,
+			physical,
+			selectors: [opts.scheme, opts.configuration],
+			buildCache: opts.buildCache
 		});
-		physicalDevice = {
-			udid: resolved.udid,
-			name: resolved.name ?? resolved.udid
-		};
-		wireless = resolved.wireless === true;
-	}
-	if (!physical) {
-		const capacity = d.checkDeviceCapacity({
-			platform: "ios",
-			project: proj,
-			max: limits.maxDevices
+		if (isEasBuildFailure(easBuild)) return fail(easBuild);
+		const registerProject = () => d.upsertProject(root, {
+			bundleId: d.detectBundleId(root) ?? void 0,
+			isExpo
 		});
-		if (capacity) return fail(capacity);
-	}
-	let metroPort = proj?.metroPort ?? null;
-	let lanAddress = null;
-	let lanOriginUrl = null;
-	let devServer = null;
-	if (!await resolveMetroPort()) return null;
-	let device;
-	if (physicalDevice) device = {
-		deviceUdid: physicalDevice.udid,
-		deviceName: physicalDevice.name,
-		owned: false
-	};
-	else {
-		const prepare = stepClock(d.now);
-		try {
-			device = await d.ensureOwnedDevice({
+		if (remoteBackend !== "eas") registerProject();
+		const proj = d.getProject(root);
+		const limits = d.getConcurrencyLimits();
+		let physicalDevice = null;
+		let wireless = false;
+		if (physical && typeof deviceFlag !== "string") {
+			const pooled = await d.selectFromPool({
+				root,
 				platform: "ios",
-				project: proj,
-				projectPath: root,
-				settingsRoot: root,
-				settings,
-				flags: {
-					deviceType,
-					runtime,
-					runtimeFlag: resolveRuntime(opts.runtime, null),
-					simulatorApp
+				idLabel: "udid",
+				list: () => iosPoolCandidates(d.listIosDevices()).map((entry) => ({
+					id: entry.udid,
+					name: entry.name,
+					fallback: isWirelessIosDevice(entry)
+				})),
+				noCandidates: () => {
+					const resolved = iosPoolNoCandidatesRefusal(d.listIosDevices());
+					return {
+						message: resolved.error,
+						remedy: resolved.remedy
+					};
 				},
-				note,
-				out: note
+				waitSeconds,
+				noWait,
+				now: d.now,
+				warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
 			});
-		} catch (e) {
-			return fail(ownedSimFailure(e));
+			if (pooled.status === "refused") return fail({
+				code: pooled.refusal.code,
+				message: pooled.refusal.message,
+				remedy: pooled.refusal.remedy,
+				...pooled.refusal.lease === null ? {} : { lease: pooled.refusal.lease }
+			});
+			physicalDevice = {
+				udid: pooled.candidate.id,
+				name: pooled.candidate.name ?? pooled.candidate.id
+			};
+			wireless = pooled.candidate.fallback === true;
+		} else if (physical) {
+			const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, d.listIosDevices());
+			if (!resolved.udid) return fail({
+				code: "STIM_NO_DEVICE",
+				message: resolved.error,
+				remedy: resolved.remedy
+			});
+			physicalDevice = {
+				udid: resolved.udid,
+				name: resolved.name ?? resolved.udid
+			};
+			wireless = resolved.wireless === true;
 		}
-		const prepareMs = prepare();
-		if (device.created || prepareMs >= 2e3) phase("device", `${deviceLabel(device, device.deviceUdid)} ${device.created ? "created" : "prepared"} (${formatDuration(prepareMs)})`);
-	}
-	let bootDuration = "";
-	let bootPromise;
-	let udid = "";
-	async function resolveMetroPort() {
-		if (release) {
-			metroPort = null;
-			phase("metro", `skipped (${configuration}: the JS bundle is embedded, no dev server is used)`);
-		} else if (metroCheck) {
-			const gate = await ensureDevServer({
-				root,
+		if (!physical && !hostedTarget) {
+			const capacity = d.checkDeviceCapacity({
+				platform: "ios",
+				project: proj,
+				max: limits.maxDevices
+			});
+			if (capacity) return fail(capacity);
+		}
+		let metroPort = proj?.metroPort ?? null;
+		let lanAddress = null;
+		let lanOriginUrl = null;
+		let devServer = null;
+		if (!await resolveMetroPort()) return null;
+		let device;
+		if (physicalDevice) device = {
+			deviceUdid: physicalDevice.udid,
+			deviceName: physicalDevice.name,
+			owned: false
+		};
+		else if (hostedTarget) device = {
+			owned: false,
+			deviceName: hostedTarget.choice.deviceType,
+			runtime: hostedTarget.choice.runtime
+		};
+		else {
+			const prepare = stepClock(d.now);
+			try {
+				device = await d.ensureOwnedDevice({
+					platform: "ios",
+					project: proj,
+					projectPath: root,
+					settingsRoot: root,
+					settings,
+					flags: {
+						deviceType,
+						runtime,
+						runtimeFlag: resolveRuntime(opts.runtime, null),
+						simulatorApp
+					},
+					note,
+					out: note
+				});
+			} catch (e) {
+				return fail(ownedSimFailure(e));
+			}
+			progress.deviceSetup(didSetUpDevice(device, Boolean(remoteDevice)));
+			const prepareMs = prepare();
+			if (device.created || prepareMs >= 2e3) phase("device", `${deviceLabel(device, device.deviceUdid)} ${device.created ? "created" : "prepared"} (${formatDuration(prepareMs)})`);
+		}
+		let bootDuration = "";
+		let bootPromise;
+		let udid = "";
+		async function resolveMetroPort() {
+			if (release) {
+				metroPort = null;
+				phase("metro", `skipped (${configuration}: the JS bundle is embedded, no dev server is used)`);
+			} else if (metroCheck) {
+				const gate = await ensureDevServer({
+					root,
+					port: metroPort,
+					settings: iosMetroSettings(settings, Boolean(hostedTarget)),
+					remote: Boolean(remoteDevice),
+					note,
+					resolve: d.resolveProjectMetro,
+					start: d.startDevServer,
+					readState: d.readWorkspaceState
+				});
+				reclaimed = [...reclaimed, ...gate.reclaimed];
+				if (!gate.ok) {
+					fail({
+						code: gate.code,
+						message: gate.message,
+						remedy: gate.remedy,
+						lines: gate.lines
+					});
+					return false;
+				}
+				metroPort = gate.port;
+				devServer = gate.devServer;
+			} else {
+				const pin = metroPortSetting(root);
+				if (pin.error) {
+					fail({
+						code: "STIM_BAD_ARG",
+						message: pin.error,
+						remedy: SETTING_SHAPE_REMEDY
+					});
+					return false;
+				}
+				if (pin.port === null && !metroPort) note(chalk.yellow(`No Metro port is reserved for this workspace; wiring the app to ${DEFAULT_METRO_PORT}.`));
+				metroPort = pin.port ?? metroPort ?? 8081;
+			}
+			hostedIosMetroNote(Boolean(hostedTarget), settings, note);
+			if (physical && metroPort !== null && !await resolveLanOrigin()) return false;
+			if (remoteDevice && metroPort !== null) {
+				const reachable = await d.ensureMetroReachable({
+					ctx: remoteDevice.ctx,
+					metroPort,
+					isExpo,
+					tunnelMode: tunnelModeSetting(settings) ?? void 0,
+					publicUrl: publicUrlSetting(settings),
+					available: d.detectProviders(binOnPath, tunnelModeSetting(settings) ?? "auto")
+				});
+				if ("failed" in reachable) {
+					fail({
+						code: reachable.code ?? "STIM_NO_REMOTE_SESSION",
+						message: reachable.failed,
+						remedy: reachable.remedy
+					});
+					return false;
+				}
+			}
+			if (!release && metroCheck && optimizations.metroWarmup) d.warmMetro({
 				port: metroPort,
-				settings,
-				remote: Boolean(remoteDevice),
-				note,
-				resolve: d.resolveProjectMetro,
-				start: d.startDevServer,
-				readState: d.readWorkspaceState
+				platform: "ios",
+				isExpo,
+				appId: proj?.bundleId,
+				bundleUrl: metroWarmupUrlSetting(settings, "ios")
+			});
+			return true;
+		}
+		async function resolveLanOrigin() {
+			const port = metroPort;
+			const chosen = chooseLanAddress({
+				pinned: iosLanHostSetting(settings),
+				candidates: d.hostLanCandidates()
 			});
-			reclaimed = [...reclaimed, ...gate.reclaimed];
-			if (!gate.ok) {
+			if (!chosen) {
 				fail({
-					code: gate.code,
-					message: gate.message,
-					remedy: gate.remedy,
-					lines: gate.lines
+					code: "STIM_NO_LAN_ADDRESS",
+					message: "A Debug run on a phone needs an address the phone can reach, and this Mac has no non-internal IPv4 interface.",
+					remedy: "The phone reaches Metro over the network you share, because USB carries no reverse forward. Join a Wi-Fi or Ethernet network, or connect this Mac by cable, then run the command again."
 				});
 				return false;
 			}
-			metroPort = gate.port;
-			devServer = gate.devServer;
-		} else if (!metroPort) {
-			metroPort = DEFAULT_METRO_PORT;
-			note(chalk.yellow(`No Metro port is reserved for this workspace; wiring the app to ${metroPort}.`));
-		}
-		if (physical && metroPort !== null && !await resolveLanOrigin()) return false;
-		if (remoteDevice && metroPort !== null) {
-			const reachable = await d.ensureMetroReachable({
-				ctx: remoteDevice.ctx,
-				metroPort,
+			lanAddress = chosen.address;
+			lanOriginUrl = lanOriginUrlFor(chosen.address, port);
+			const source = chosen.pinned ? "ios.lanHost" : `${chosen.interfaceName ?? "interface"}${chosen.candidates > 1 ? ` of ${chosen.candidates} candidates` : ""}`;
+			phase("lan", `${lanOriginUrl} (${source})`);
+			if (publicUrlSetting(settings) || tunnelModeSetting(settings)) note(chalk.dim(phaseLine("lan", "metro.publicUrl and metro.tunnel are ignored on --device: neither channel to a phone carries a URL, only a host and a port. They still apply to --remote.")));
+			if (!metroCheck) return true;
+			const reachable = await d.ensureLanReachable({
+				origin: lanOriginUrl,
+				metroPort: port,
+				root,
 				isExpo,
-				tunnelMode: tunnelModeSetting(settings) ?? void 0,
-				publicUrl: publicUrlSetting(settings),
-				available: d.detectProviders(binOnPath)
+				logsDir
 			});
 			if ("failed" in reachable) {
 				fail({
-					code: reachable.code ?? "STIM_NO_REMOTE_SESSION",
+					code: "STIM_LAN_METRO_UNREACHABLE",
 					message: reachable.failed,
 					remedy: reachable.remedy
 				});
 				return false;
 			}
+			phase("lan", `gated: ${lanOriginUrl} answered as this workspace's Metro`);
+			return true;
 		}
-		if (!release && metroCheck && optimizations.metroWarmup) d.warmMetro({
-			port: metroPort,
-			platform: "ios",
-			isExpo,
-			appId: proj?.bundleId,
-			bundleUrl: metroWarmupUrlSetting(settings, "ios")
-		});
-		return true;
-	}
-	async function resolveLanOrigin() {
-		const port = metroPort;
-		const chosen = chooseLanAddress({
-			pinned: iosLanHostSetting(settings),
-			candidates: d.hostLanCandidates()
-		});
-		if (!chosen) {
-			fail({
-				code: "STIM_NO_LAN_ADDRESS",
-				message: "A Debug run on a phone needs an address the phone can reach, and this Mac has no non-internal IPv4 interface.",
-				remedy: "The phone reaches Metro over the network you share, because USB carries no reverse forward. Join a Wi-Fi or Ethernet network, or connect this Mac by cable, then run the command again."
-			});
-			return false;
-		}
-		lanAddress = chosen.address;
-		lanOriginUrl = lanOriginUrlFor(chosen.address, port);
-		const source = chosen.pinned ? "ios.lanHost" : `${chosen.interfaceName ?? "interface"}${chosen.candidates > 1 ? ` of ${chosen.candidates} candidates` : ""}`;
-		phase("lan", `${lanOriginUrl} (${source})`);
-		if (publicUrlSetting(settings) || tunnelModeSetting(settings)) note(chalk.dim(phaseLine("lan", "metro.publicUrl and metro.tunnel are ignored on --device: neither channel to a phone carries a URL, only a host and a port. They still apply to --remote.")));
-		if (!metroCheck) return true;
-		const reachable = await d.ensureLanReachable({
-			origin: lanOriginUrl,
-			metroPort: port,
-			root,
-			isExpo,
-			logsDir
-		});
-		if ("failed" in reachable) {
-			fail({
-				code: "STIM_LAN_METRO_UNREACHABLE",
-				message: reachable.failed,
-				remedy: reachable.remedy
-			});
-			return false;
-		}
-		phase("lan", `gated: ${lanOriginUrl} answered as this workspace's Metro`);
-		return true;
-	}
-	let artifact = null;
-	try {
-		const boot = () => physicalDevice ? Promise.resolve({
-			ok: true,
-			udid: physicalDevice.udid
-		}) : Promise.resolve(d.ensureBooted({
-			platform: "ios",
-			device,
-			simulatorApp,
-			out: note
-		})).catch((e) => ({
-			ok: false,
-			reason: String(e?.message || e)
-		}));
-		const startBoot = () => {
-			const bootTimer = stepTimer(d.now);
-			bootPromise = (remoteDevice?.ctx.backend === "eas" ? d.ensureRemoteBootOwned({
-				root,
-				platform: "ios",
-				sessionName: ownedSessionName(remoteDevice.ctx.label),
-				startedAt: new Date(d.now()).toISOString(),
-				boot,
-				createdSessionId: remoteDevice.createdSessionId,
-				abandonCreatedSession: remoteDevice.abandonCreatedSession,
-				webPreviewUrl: remoteDevice.webPreviewUrl,
-				writeState: d.writeWorkspaceState,
-				register: registerProject,
-				notice: (line) => note(chalk.dim(phaseLine("lock", line)))
-			}) : boot()).then((result) => {
-				bootDuration = bootTimer();
-				return result;
-			});
-			return bootPromise.then((result) => result?.udid ?? "");
-		};
-		const localBoot = remoteDevice ? null : startBoot();
-		udid = device.deviceUdid ?? await localBoot ?? "";
-		const acquiredArtifact = unlessCancelled(await acquireIosArtifact({
-			root,
-			logFile,
-			udid,
-			configuration,
-			buildScheme,
-			buildProfile,
-			isExpo,
-			remoteDestination: Boolean(remoteDevice),
-			device: physical ? {
-				lanAddress,
-				metroPort,
-				signingName: iosSigningIdentitySetting(settings),
-				signingSha1: iosSigningIdentitySha1Setting(settings)
-			} : null,
-			optimizations: optimizations.ios,
-			cache: {
-				policy: cachePolicy,
-				providerConfig: cacheProviderConfig,
-				disabledByFlag: opts.buildCache === false
-			},
-			easBuild,
-			easProfile: opts.easProfile,
-			maxBuilds: limits.maxBuilds,
-			progress: {
-				phase,
-				note,
-				logWriter,
-				estimates,
-				stats,
-				step: progress.step
-			}
-		}, d));
-		if (!acquiredArtifact.ok) {
-			compilationCache = acquiredArtifact.compilationCache;
-			return fail(acquiredArtifact.failure);
-		}
-		artifact = acquiredArtifact.artifact;
-		compilationCache = artifact.cache.compilation;
-		if (!localBoot) {
-			progress.step("install");
-			udid = await startBoot();
-		}
-		if (physicalDevice) {
-			const acquired = await d.acquireRunLease({
-				root,
+		let artifact = null;
+		try {
+			const boot = () => physicalDevice ? Promise.resolve({
+				ok: true,
+				udid: physicalDevice.udid
+			}) : Promise.resolve(d.ensureBooted({
 				platform: "ios",
-				id: physicalDevice.udid,
-				deviceName: physicalDevice.name,
-				idLabel: "udid",
-				waitSeconds,
-				noWait,
-				installBoundMs: iosDeviceBounds(wireless).installMs,
-				appId: artifact.bundleId ?? proj?.bundleId ?? null,
-				holderAppId: (holder) => d.getProject(holder)?.bundleId ?? null,
-				now: d.now,
-				warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
-			});
-			if (acquired.status === "refused") return fail({
-				code: acquired.refusal.code,
-				message: acquired.refusal.message,
-				remedy: acquired.refusal.remedy,
-				lease: acquired.refusal.lease
-			});
-			leaseHandle = d.runLease({
+				device,
+				simulatorApp,
+				out: note
+			})).catch((e) => ({
+				ok: false,
+				reason: String(e?.message || e)
+			}));
+			const startBoot = () => {
+				const bootTimer = stepTimer(d.now);
+				bootPromise = (remoteDevice?.ctx.backend === "eas" ? d.ensureRemoteBootOwned({
+					root,
+					platform: "ios",
+					sessionName: ownedSessionName(remoteDevice.ctx.label),
+					startedAt: new Date(d.now()).toISOString(),
+					deviceType: remoteDevice.ctx.deviceType ?? null,
+					boot,
+					createdSessionId: remoteDevice.createdSessionId,
+					abandonCreatedSession: remoteDevice.abandonCreatedSession,
+					webPreviewUrl: remoteDevice.webPreviewUrl,
+					writeState: d.writeWorkspaceState,
+					register: registerProject,
+					notice: (line) => note(chalk.dim(phaseLine("lock", line)))
+				}) : boot()).then((result) => {
+					bootDuration = bootTimer();
+					return result;
+				});
+				return bootPromise.then((result) => result?.udid ?? "");
+			};
+			const localBoot = remoteDevice || hostedTarget ? null : startBoot();
+			udid = device.deviceUdid ?? await localBoot ?? "";
+			const acquiredArtifact = unlessCancelled(await acquireIosArtifact({
 				root,
-				platform: "ios",
-				kind: acquired.status === "leased" ? acquired.kind : null,
-				expiresAt: acquired.status === "leased" ? acquired.expiresAt : null
-			});
-			if (acquired.status === "leased") {
-				stopLeaseSignals = d.releaseLeaseOnSignal(releaseLease);
-				phase("lease", `${acquired.kind} lease on ${physicalDevice.udid} until ${leaseExpiryText(acquired.expiresAt, d.now())}`);
+				logFile,
+				udid,
+				configuration,
+				buildScheme,
+				buildProfile,
+				buildMachine,
+				isExpo,
+				remoteDestination: Boolean(remoteDevice || hostedTarget),
+				...hostedIosBuildTarget(hostedTarget),
+				simulatorArch: simulatorBuildArch({
+					physical,
+					remoteArch,
+					hostArch: d.hostSimulatorArch(),
+					configuration
+				}),
+				device: physical ? {
+					lanAddress,
+					metroPort,
+					signingName: iosSigningIdentitySetting(settings),
+					signingSha1: iosSigningIdentitySha1Setting(settings)
+				} : null,
+				optimizations: optimizations.ios,
+				cache: {
+					policy: cachePolicy,
+					providerConfig: cacheProviderConfig,
+					disabledByFlag: opts.buildCache === false
+				},
+				easBuild,
+				easProfile: opts.easProfile,
+				maxBuilds: limits.maxBuilds,
+				progress: {
+					phase,
+					note,
+					logWriter,
+					estimates,
+					stats,
+					step: progress.step,
+					miss: progress.miss,
+					hit: progress.hit,
+					place: progress.place,
+					waitingOn: progress.waitingOn
+				}
+			}, d));
+			if (!acquiredArtifact.ok) {
+				compilationCache = acquiredArtifact.compilationCache;
+				return fail(acquiredArtifact.failure);
 			}
-		}
-		try {
-			return await finishIosRun({
+			artifact = acquiredArtifact.artifact;
+			compilationCache = artifact.cache.compilation;
+			if (hostedTarget) return await finishHostedIosRun({
+				target: hostedTarget,
+				root,
 				slot,
 				d,
-				root,
-				json,
-				release,
+				artifact,
 				configuration,
 				buildScheme,
+				release,
 				isExpo,
 				metroCheck,
 				metroPort,
 				logsDir,
-				logFile,
-				device,
-				udid,
-				physical,
-				wireless,
-				lanAddress,
-				lanOriginUrl,
-				remoteDevice,
-				bootPromise,
-				bootDuration: () => bootDuration,
-				artifact,
-				fail,
-				phase,
-				note,
-				logWriter,
+				json,
 				elapsed,
 				startedAt,
-				closeWriter: () => writer?.close?.(),
-				lease: leaseHandle,
-				releaseLease,
+				closeWriter: () => writer?.close(),
 				recordRun,
 				reclaimed,
 				devServer,
-				enterPhase: progress.step
+				fail,
+				note,
+				selectors
+			});
+			if (!localBoot) {
+				progress.step("device");
+				udid = await startBoot();
+			}
+			if (physicalDevice) {
+				progress.step("device");
+				const acquired = await d.acquireRunLease({
+					root,
+					platform: "ios",
+					id: physicalDevice.udid,
+					deviceName: physicalDevice.name,
+					idLabel: "udid",
+					waitSeconds,
+					noWait,
+					installBoundMs: iosDeviceBounds(wireless).installMs,
+					appId: artifact.bundleId ?? proj?.bundleId ?? null,
+					holderAppId: (holder) => d.getProject(holder)?.bundleId ?? null,
+					now: d.now,
+					warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
+				});
+				if (acquired.status === "refused") return fail({
+					code: acquired.refusal.code,
+					message: acquired.refusal.message,
+					remedy: acquired.refusal.remedy,
+					lease: acquired.refusal.lease
+				});
+				leaseHandle = d.runLease({
+					root,
+					platform: "ios",
+					kind: acquired.status === "leased" ? acquired.kind : null,
+					expiresAt: acquired.status === "leased" ? acquired.expiresAt : null
+				});
+				if (acquired.status === "leased") {
+					stopLeaseSignals = d.releaseLeaseOnSignal(releaseLease);
+					phase("lease", `${acquired.kind} lease on ${physicalDevice.udid} until ${leaseExpiryText(acquired.expiresAt, d.now())}`);
+				}
+			}
+			try {
+				return await finishIosRun({
+					slot,
+					d,
+					root,
+					json,
+					release,
+					configuration,
+					buildScheme,
+					isExpo,
+					metroCheck,
+					metroPort,
+					logsDir,
+					logFile,
+					device,
+					udid,
+					physical,
+					wireless,
+					lanAddress,
+					lanOriginUrl,
+					remoteDevice,
+					bootPromise,
+					bootDuration: () => bootDuration,
+					artifact,
+					fail,
+					phase,
+					note,
+					logWriter,
+					elapsed,
+					startedAt,
+					closeWriter: () => writer?.close?.(),
+					lease: leaseHandle,
+					releaseLease,
+					recordRun,
+					reclaimed,
+					devServer,
+					enterPhase: progress.step
+				});
+			} finally {
+				releaseLease();
+			}
+		} catch (error) {
+			recordRun({
+				failed: true,
+				durationMs: elapsed()
 			});
+			throw error;
 		} finally {
-			releaseLease();
+			artifact?.release();
 		}
-	} catch (error) {
-		recordRun({
-			failed: true,
-			durationMs: elapsed()
-		});
-		throw error;
 	} finally {
-		artifact?.release();
+		hostedTarget?.host.connection.close();
 	}
 }
 //#endregion