stim 1.15.0 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stim",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "Stim: fast, isolated React Native environments for coding agents",
   "keywords": [
     "agent",
@@ -48,9 +48,9 @@
   },
   "dependencies": {
     "@expo/fingerprint": "^0.20.10",
-    "@stim-cli/cache": "^1.15.0",
-    "@stim-cli/core": "^1.15.0",
-    "@stim-cli/metro": "^1.15.0",
+    "@stim-cli/cache": "^1.17.0",
+    "@stim-cli/core": "^1.17.0",
+    "@stim-cli/metro": "^1.17.0",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
     "cross-spawn": "^7.0.6",
@@ -58,7 +58,7 @@
     "ws": "^8.21.3"
   },
   "devDependencies": {
-    "@stim-cli/expo-build-cache": "1.15.0",
+    "@stim-cli/expo-build-cache": "1.17.0",
     "@types/cross-spawn": "^6.0.6",
     "@types/which": "^3.0.4",
     "@types/ws": "^8.18.1",

package/dist/device-capacity-DMuKC7nx.mjs

@@ -1,136 +0,0 @@
-import { H as projectDeviceSlots, _ as loadConfig, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
-import { O as listAdbDevices } from "./android-Db2eEMaf.mjs";
-import { _ as parseRuntimeVersion, c as iosRuntimeMatches, u as listAllIosSims } from "./ios-3CtCRhwr.mjs";
-//#region src/engine/device-capacity.ts
-function liveOwnedDeviceCount({ sims = [], adbEmulators = [], config = null } = {}) {
-	let count = 0;
-	for (const sim of sims) if (sim?.state === "Booted" && sim.name?.startsWith("stim-")) count++;
-	const livePorts = new Set(adbEmulators.map((e) => e.consolePort));
-	for (const proj of Object.values(config?.projects || {})) for (const { platforms } of projectDeviceSlots(proj)) {
-		const android = platforms.android;
-		if (android?.owned && android.avdName && typeof android.consolePort === "number" && livePorts.has(android.consolePort)) count++;
-	}
-	return count;
-}
-function workspaceHasLiveDevice({ platform, project, slot = "default", sims = [], adbEmulators = [] } = {}) {
-	if (!platform) return false;
-	const record = deviceSlotPlatforms(project, slot)?.[platform];
-	if (!record) return false;
-	if (platform === "ios") return sims.some((s) => s.udid === record.deviceUdid && s.state === "Booted");
-	return typeof record.consolePort === "number" && adbEmulators.some((e) => e.consolePort === record.consolePort);
-}
-function deviceCapacityRefusal({ platform, project, slot = "default", max, sims = [], adb = null, config = null } = {}) {
-	if (!max || max <= 0) return null;
-	const adbEmulators = adb?.emulators || [];
-	if (workspaceHasLiveDevice({
-		platform,
-		project,
-		slot,
-		sims,
-		adbEmulators
-	})) return null;
-	const count = liveOwnedDeviceCount({
-		sims,
-		adbEmulators,
-		config
-	});
-	if (count < max) return null;
-	return {
-		code: "STIM_AT_CAPACITY",
-		message: `${count} Stim device(s) are already booted and concurrency.maxDevices is ${max}, so booting another would exceed the cap.`,
-		remedy: "stop an environment (stim stop) or raise concurrency.maxDevices"
-	};
-}
-function checkDeviceCapacity({ platform, project, slot = "default", max, sims = listAllIosSims, adb = listAdbDevices, config = loadConfig } = {}) {
-	if (!max || max <= 0) return null;
-	let simList = [];
-	let adbRes = {
-		emulators: [],
-		physical: [],
-		unhealthy: []
-	};
-	try {
-		simList = typeof sims === "function" ? sims() || [] : sims || [];
-	} catch {}
-	try {
-		adbRes = typeof adb === "function" ? adb() || adbRes : adb || adbRes;
-	} catch {}
-	let cfg = null;
-	try {
-		cfg = typeof config === "function" ? config() : config ?? null;
-	} catch {}
-	return deviceCapacityRefusal({
-		platform,
-		project,
-		slot,
-		max,
-		sims: simList,
-		adb: adbRes,
-		config: cfg
-	});
-}
-function deviceTypeMismatch(recordedTypeId, requestedName, deviceTypes) {
-	if (!requestedName || !recordedTypeId) return null;
-	const wanted = (deviceTypes || []).find((d) => d.name === requestedName);
-	if (!wanted) return null;
-	if (wanted.identifier === recordedTypeId) return null;
-	const recorded = (deviceTypes || []).find((d) => d.identifier === recordedTypeId);
-	return `this project's sim is ${recorded ? recorded.name : recordedTypeId}, but --device-type asked for ${requestedName}`;
-}
-function runtimeMismatch(recordedRuntimeId, requested, runtimes) {
-	if (!requested || !recordedRuntimeId) return null;
-	const wanted = runtimes.find((r) => iosRuntimeMatches(r, requested));
-	if (!wanted || wanted.identifier === recordedRuntimeId) return null;
-	return `this project's sim runs iOS ${parseRuntimeVersion(recordedRuntimeId)}, but --runtime asked for ${requested}`;
-}
-function installedNames(names) {
-	const unique = [...new Set(names.filter((n) => typeof n === "string" && n !== ""))];
-	return unique.length > 0 ? unique.join(", ") : "none";
-}
-/** Appends which settings layer supplied an unresolved device selector, so the user knows where to fix it. */
-function layerNote(refusal, key, flag, origin) {
-	if (flag !== void 0 && flag !== null) return refusal;
-	if (!origin) return refusal;
-	return {
-		message: `${refusal.message} ${key} is set at the ${origin} layer.`,
-		remedy: `${refusal.remedy} Fix it with \`stim settings set ${key} <value> --scope ${origin}\` or \`stim settings unset ${key} --scope ${origin}\`.`
-	};
-}
-function unknownIosRuntimeRefusal(requested, runtimes) {
-	if (!requested) return null;
-	if ((runtimes || []).some((r) => iosRuntimeMatches(r, requested))) return null;
-	return {
-		message: `No installed simulator runtime matches "${requested}". Installed runtimes: ${installedNames((runtimes || []).map((r) => r.version))}.`,
-		remedy: "Pass `--runtime` (or set ios.runtime) a version printed above (\"26.5\") or a runtime's full name (\"iOS 26.5\"); nothing else matches. Install more runtimes through Xcode."
-	};
-}
-function creatableIosDeviceTypeNames(runtimes, runtime) {
-	return (runtime ? (runtimes || []).filter((r) => iosRuntimeMatches(r, runtime)) : runtimes || []).flatMap((r) => (r.supportedDeviceTypes || []).map((d) => d.name));
-}
-function unknownIosDeviceTypeRefusal(requested, runtimes, runtime) {
-	if (!requested) return null;
-	const creatable = creatableIosDeviceTypeNames(runtimes, runtime);
-	if (creatable.includes(requested)) return null;
-	return {
-		message: `No device type named "${requested}" can be created on ${runtime ? `runtime ${runtime}` : "any installed simulator runtime"}. ${runtime ? `Device types runtime ${runtime} supports` : "Device types the installed runtimes support"}: ${installedNames(creatable)}.`,
-		remedy: "Pass `--device-type` (or set ios.deviceType) one of the names printed above, exactly as `xcrun simctl list devicetypes` spells it. `xcrun simctl list devicetypes` also lists watchOS, tvOS and visionOS models, which no iOS runtime can create. Install more models through Xcode."
-	};
-}
-function unknownAndroidSystemImageRefusal(requested, images) {
-	if (!requested) return null;
-	if ((images || []).some((i) => i.pkg === requested)) return null;
-	return {
-		message: `No installed Android system image is named "${requested}". Installed system images: ${installedNames((images || []).map((i) => i.pkg))}.`,
-		remedy: "Pass `--system-image` (or set android.systemImage) to one of the package ids printed above. Install more with `sdkmanager \"system-images;android-36;google_apis;arm64-v8a\"`."
-	};
-}
-function unknownAndroidDeviceProfileRefusal(requested, profiles) {
-	if (!requested) return null;
-	if (profiles.includes(requested)) return null;
-	return {
-		message: `No Android hardware profile is named "${requested}". Profiles avdmanager offers: ${installedNames(profiles)}.`,
-		remedy: "Pass `--device-profile` (or set android.deviceProfile) to one of the ids printed above, exactly as `avdmanager list device -c` spells it, e.g. \"pixel_fold\" or \"pixel_tablet\"."
-	};
-}
-//#endregion
-export { runtimeMismatch as a, unknownIosDeviceTypeRefusal as c, liveOwnedDeviceCount as i, unknownIosRuntimeRefusal as l, deviceTypeMismatch as n, unknownAndroidDeviceProfileRefusal as o, layerNote as r, unknownAndroidSystemImageRefusal as s, checkDeviceCapacity as t };

package/dist/hosted-macos-DwowNU7W.mjs

@@ -1,447 +0,0 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
-import { C as workspaceLogsDir } from "./workspace-state-CL2V2Ons.mjs";
-import { l as phaseLine } from "./command-output-CliHHn7a.mjs";
-import { t as macosDir } from "./state-BxCgeTQu.mjs";
-import { t as BuildConnection, v as parseMachine$1, y as pinnedEndpoint$1 } from "./client-C2IS36Qf.mjs";
-import { t as configuredMachines } from "./machines-CYtOCqcj.mjs";
-import { createHash, randomUUID } from "node:crypto";
-import { lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { LOG_ROTATE_BYTES, withDirLock } from "@stim-cli/core";
-import { HOSTED_APP_CHUNK_BYTES, hostedMacosAppSlot, hostedMacosBundleId, isJsonObject, parseHostedAgentGrant, parseHostedLogsCursor, parseHostedMacosDevice, readDeviceHostMachines, validHostedAppArguments } from "@stim-cli/core/state";
-//#region src/device-host/agent-connection.ts
-function canonical(path) {
-	try {
-		return realpathSync(path);
-	} catch {
-		return null;
-	}
-}
-function report(message) {
-	process.stderr.write(`${phaseLine("device", message.replace(/\s+/g, " "))}\n`);
-}
-function closeAgentConnection(remoteConfig) {
-	const exec = getExecutor();
-	const deadline = Date.now() + 3e4;
-	const run = (args) => {
-		const remaining = deadline - Date.now();
-		if (remaining <= 0) throw new Error("agent-device cleanup timed out");
-		const result = JSON.parse(exec.runFile("agent-device", [...args, "--json"], {
-			timeoutMs: Math.min(1e4, remaining),
-			killSignal: "SIGKILL"
-		}));
-		if (result?.success !== true) throw new Error("agent-device did not confirm the command");
-		return result.data;
-	};
-	try {
-		if (!exec.findExecutable("agent-device")) return;
-		const status = run(["connection", "status"]);
-		if (status?.connected !== true || typeof status.session !== "string" || typeof status.remoteConfig !== "string") return;
-		const config = canonical(remoteConfig);
-		if (config === null || canonical(status.remoteConfig) !== config) return;
-		const failures = [];
-		for (const args of [[
-			"close",
-			"--remote-config",
-			remoteConfig,
-			"--session",
-			status.session
-		], [
-			"disconnect",
-			"--session",
-			status.session
-		]]) try {
-			run(args);
-		} catch (error) {
-			failures.push(error.message);
-		}
-		report(failures.length ? `could not clean up agent-device connection for ${status.session}: ${failures.join("; ")}` : `closed agent-device connection for ${status.session}`);
-	} catch (error) {
-		report(`could not clean up agent-device connection: ${error.message}`);
-	}
-}
-//#endregion
-//#region src/device-host/hosted-logs.ts
-const MAX_PAGES = 64;
-const cursorFile = (root) => join(macosDir(root), "host-logs-cursor.json");
-const hostLogFile = (root) => join(workspaceLogsDir(root), "macos-host.ndjson");
-function readCursor(root, session) {
-	try {
-		const stored = JSON.parse(readFileSync(cursorFile(root), "utf8"));
-		if (isJsonObject(stored) && stored.session === session) return parseHostedLogsCursor(stored.cursor) ?? void 0;
-	} catch {}
-}
-const sameCursor = (a, b) => JSON.stringify(Object.entries(a ?? {}).toSorted()) === JSON.stringify(Object.entries(b ?? {}).toSorted());
-function commitPage(root, session, before, records, cursor) {
-	if (!records.length && sameCursor(before, cursor)) return;
-	const directory = macosDir(root);
-	withDirLock(join(directory, "host-logs.lock"), () => {
-		if (!sameCursor(readCursor(root, session), before)) return;
-		if (records.length) {
-			const writer = createNdjsonWriter(hostLogFile(root), { maxBytes: LOG_ROTATE_BYTES });
-			try {
-				for (const record of records) writer.write(record);
-			} finally {
-				writer.close();
-			}
-		}
-		const temporary = `${cursorFile(root)}.${process.pid}.tmp`;
-		try {
-			writeFileSync(temporary, JSON.stringify({
-				session,
-				cursor
-			}), { mode: 384 });
-			renameSync(temporary, cursorFile(root));
-		} finally {
-			rmSync(temporary, { force: true });
-		}
-	}, { ensureParent: () => mkdirSync(directory, { recursive: true }) });
-}
-async function pullHostedMacosLogs(root, placement, host) {
-	for (let page = 0; page < MAX_PAGES; page++) {
-		const before = readCursor(root, placement.session);
-		const reply = await host.connection.request("device-host.logs.query", {
-			session: placement.session,
-			...before ? { cursor: before } : {}
-		});
-		if ("error" in reply) throw Object.assign(/* @__PURE__ */ new Error(`${host.machine} refused device-host.logs.query: ${reply.error.message}`), { code: reply.error.code });
-		const result = reply.result;
-		const cursor = isJsonObject(result) ? parseHostedLogsCursor(result.cursor) : null;
-		if (!isJsonObject(result) || !cursor || !Array.isArray(result.records) || !result.records.every(isJsonObject) || typeof result.more !== "boolean") throw new Error(`${host.machine} answered device-host.logs.query with an unexpected result.`);
-		commitPage(root, placement.session, before, result.records, cursor);
-		if (!result.more || sameCursor(cursor, before)) return;
-	}
-}
-//#endregion
-//#region src/device-host/hosted-macos.ts
-const CONNECT_TIMEOUT_MS = 1e4;
-const POLL_MS = 500;
-const SESSION_TIMEOUT_MS = 12e4;
-const INSTALL_TIMEOUT_MS = 3e5;
-const HANDOFF_TIMEOUT_MS = 3e5;
-const sleep = (ms) => new Promise((done) => setTimeout(done, ms));
-const sha256 = (content) => createHash("sha256").update(content).digest("hex");
-function hostingCredential(machine) {
-	const configured = configuredMachines();
-	if (configured === null) throw new Error("hosting.machines is invalid. Run stim guide settings and correct it.");
-	if (!configured.includes(machine)) throw Object.assign(/* @__PURE__ */ new Error(`${machine} is not in hosting.machines. Add it with stim settings set hosting.machines, then run stim doctor --fix to ask it for hosting access.`), { code: "STIM_BAD_ARG" });
-	let credentials;
-	try {
-		credentials = readDeviceHostMachines();
-	} catch {
-		throw new Error("The hosting credentials are unreadable. Run stim doctor.");
-	}
-	const credential = credentials.find((each) => each.machine === machine);
-	if (!credential) throw new Error(`This Mac has not asked ${machine} for hosting access. Run stim doctor --fix.`);
-	if (credential.state !== "approved") throw new Error(`${machine} has not confirmed hosting access for this Mac. A person on ${machine} approves it with stim-server devices grant ${credential.deviceId} --device-host; then run stim doctor.`);
-	return credential;
-}
-/** Connects only to the pinned node of an approved hosting machine, and only when it grants `device-host`. */
-async function connectHost(machine, timeoutMs = CONNECT_TIMEOUT_MS) {
-	const credential = hostingCredential(machine);
-	const target = pinnedEndpoint$1(credential);
-	if (typeof target === "string") throw new Error(`Stim does not connect to ${machine}: ${target}.`);
-	const opened = await BuildConnection.open(target, credential.deviceToken, timeoutMs, "device-host");
-	if (!(opened instanceof BuildConnection)) throw new Error(opened.refused ? `${machine} refused this Mac: ${opened.failure}. Run stim doctor.` : `${machine} is unreachable: ${opened.failure}. Check stim-server and its tailnet serve route on ${machine}.`);
-	return {
-		machine,
-		credential,
-		connection: opened
-	};
-}
-async function call(host, method, params, timeoutMs) {
-	const reply = await host.connection.request(method, params, timeoutMs);
-	if ("error" in reply) throw Object.assign(/* @__PURE__ */ new Error(`${host.machine} refused ${method}: ${reply.error.message}`), { code: reply.error.code });
-	if (!isJsonObject(reply.result)) throw new Error(`${host.machine} answered ${method} without a result.`);
-	return reply.result;
-}
-function hostedSession(host, value) {
-	if (typeof value.id !== "string" || typeof value.state !== "string" || value.platform !== "macos") throw new Error(`${host.machine} answered with a session that is not a hosted macOS session.`);
-	return {
-		id: value.id,
-		state: value.state,
-		device: value.device,
-		...hostedMacosAppSlot(value.appSlot) ? { appSlot: value.appSlot } : {},
-		...typeof value.notice === "string" ? { notice: value.notice } : {}
-	};
-}
-const heldNoLonger = (error) => error instanceof Error && "code" in error && error.code === "unknown-session";
-async function attach(host, session, timeoutMs) {
-	return hostedSession(host, await call(host, "device-host.attach", { session }, timeoutMs));
-}
-const probeCache = /* @__PURE__ */ new Map();
-function probeHostedMacos(placement, { timeoutMs = 3e3, ttlMs = 1e4 } = {}) {
-	const key = JSON.stringify([placement.machine, placement.session]);
-	const cached = probeCache.get(key);
-	if (ttlMs > 0 && cached && cached.expiresAt > Date.now()) return cached.promise;
-	const promise = probeSession(placement, timeoutMs);
-	if (ttlMs > 0) {
-		const entry = {
-			expiresAt: Infinity,
-			promise
-		};
-		probeCache.delete(key);
-		probeCache.set(key, entry);
-		if (probeCache.size > 64) probeCache.delete(probeCache.keys().next().value);
-		promise.then((result) => {
-			entry.expiresAt = Date.now() + ttlMs;
-			return result;
-		});
-	}
-	return promise;
-}
-async function probeSession(placement, timeoutMs) {
-	let host;
-	try {
-		host = await connectHost(placement.machine, timeoutMs);
-		const session = await attach(host, placement.session, timeoutMs);
-		if (session.state === "ready" || session.state === "stopped") return { state: session.state };
-		return {
-			state: "unknown",
-			notice: session.state === "unknown" ? session.notice : `The hosted session ${session.id} on ${host.machine} is ${session.state}.${session.notice ? ` ${session.notice}` : ""}`
-		};
-	} catch (error) {
-		if (heldNoLonger(error)) return { state: "stopped" };
-		return {
-			state: "unreachable",
-			reason: error instanceof Error ? error.message : String(error)
-		};
-	} finally {
-		host?.connection.close();
-	}
-}
-async function settle(host, session, passing, timeoutMs) {
-	const deadline = Date.now() + timeoutMs;
-	while (passing.includes(session.state)) {
-		if (Date.now() > deadline) throw new Error(`The hosted session ${session.id} on ${host.machine} stayed ${session.state}.`);
-		await sleep(POLL_MS);
-		session = await attach(host, session.id);
-	}
-	return session;
-}
-function unknownSession(host, session) {
-	return /* @__PURE__ */ new Error(`The hosted session ${session.id} on ${host.machine} is in an unknown state${session.notice ? `: ${session.notice}` : ""}. Run stim stop to reconcile it.`);
-}
-function bundleManifest(bundle) {
-	const files = [];
-	const content = /* @__PURE__ */ new Map();
-	const walk = (dir, prefix) => {
-		for (const name of readdirSync(dir)) {
-			const absolute = join(dir, name);
-			const path = prefix ? `${prefix}/${name}` : name;
-			const stat = lstatSync(absolute);
-			let read;
-			let kind;
-			if (stat.isDirectory()) {
-				walk(absolute, path);
-				continue;
-			} else if (stat.isSymbolicLink()) {
-				read = () => Buffer.from(readlinkSync(absolute));
-				kind = "link";
-			} else if (stat.isFile()) {
-				read = () => readFileSync(absolute);
-				kind = stat.mode & 73 ? "exec" : "file";
-			} else continue;
-			const bytes = read();
-			const digest = sha256(bytes);
-			files.push({
-				path,
-				kind,
-				size: bytes.length,
-				sha256: digest
-			});
-			content.set(digest, read);
-		}
-	};
-	walk(bundle, "");
-	files.sort((a, b) => a.path.localeCompare(b.path));
-	return {
-		files,
-		content
-	};
-}
-async function upload(host, ids, missing, content) {
-	if (!Array.isArray(missing)) throw new Error(`${host.machine} answered device-host.app.offer without missing content.`);
-	for (const entry of missing) {
-		const read = isJsonObject(entry) && typeof entry.sha256 === "string" ? content.get(entry.sha256) : void 0;
-		if (!read || !isJsonObject(entry) || typeof entry.offset !== "number") throw new Error(`${host.machine} asked for content this app does not have.`);
-		const bytes = read();
-		let offset = entry.offset;
-		do {
-			const data = bytes.subarray(offset, offset + HOSTED_APP_CHUNK_BYTES).toString("base64");
-			const next = (await call(host, "device-host.app.chunk", {
-				...ids,
-				sha256: entry.sha256,
-				offset,
-				data
-			})).offset;
-			if (typeof next !== "number" || next <= offset && next !== bytes.length) throw new Error(`${host.machine} did not accept app content at byte ${offset}.`);
-			offset = next;
-		} while (offset < bytes.length);
-	}
-}
-const agentRemoteConfig = (root) => join(macosDir(root), "agent-device-remote.json");
-function agentAccess(root, credential, grant, note) {
-	const parsed = grant === void 0 ? null : parseHostedAgentGrant(grant);
-	if (grant !== void 0 && !parsed) note(`${credential.machine} offered agent control this Stim does not support.`);
-	const file = agentRemoteConfig(root);
-	if (!parsed || parsed.driver === "none") {
-		rmSync(file, { force: true });
-		return {
-			driver: "none",
-			setting: "hosting.agentDriver"
-		};
-	}
-	const port = parseMachine$1(credential.machine)?.port ?? 443;
-	const config = {
-		daemonBaseUrl: `https://${credential.dnsName}${port === 443 ? "" : `:${port}`}${parsed.path}`,
-		daemonAuthToken: parsed.token,
-		tenant: parsed.lease.tenant,
-		sessionIsolation: "tenant",
-		runId: parsed.lease.runId,
-		leaseId: parsed.scope,
-		leaseBackend: "macos-app",
-		leaseProvider: "proxy",
-		clientId: parsed.lease.clientId,
-		deviceKey: parsed.lease.deviceKey,
-		platform: "macos"
-	};
-	mkdirSync(macosDir(root), { recursive: true });
-	const tmp = `${file}.${process.pid}.tmp`;
-	try {
-		writeFileSync(tmp, `${JSON.stringify(config, null, 2)}\n`, { mode: 384 });
-		renameSync(tmp, file);
-	} finally {
-		rmSync(tmp, { force: true });
-	}
-	return {
-		driver: "agent-device",
-		remoteConfig: file,
-		command: `agent-device <command> --remote-config ${file}`
-	};
-}
-/**
-* Places a staged `.app` on `host`: reuses the recorded session when the host still holds it ready, else reserves one,
-* then delivers the bundle as a new app attempt, launches it and waits for the host to report it installed. `reserved`
-* records the placement as soon as a session exists, so `stim stop` can find it even if delivery fails.
-*/
-async function placeHostedMacos(host, { root, bundle, bundleId, handoff, arguments: requestedArguments, recorded, reserved, note }) {
-	let session = null;
-	if (recorded) {
-		try {
-			session = await settle(host, await attach(host, recorded.session), ["preparing", "stopping"], SESSION_TIMEOUT_MS);
-		} catch (error) {
-			if (!heldNoLonger(error)) throw error;
-		}
-		if (session?.state === "unknown") throw unknownSession(host, session);
-		if (session?.state === "stopped") session = null;
-	}
-	if (!session) {
-		note(`Reserving a macOS session on ${host.machine}`);
-		session = hostedSession(host, await call(host, "device-host.reserve", {
-			workspace: root,
-			slot: "default",
-			attempt: randomUUID(),
-			platform: "macos"
-		}));
-	}
-	const appSlot = session.appSlot;
-	if (appSlot === void 0) throw new Error(`${host.machine} reserved a session without a macOS app slot.`);
-	const appAttempt = randomUUID();
-	const placement = {
-		machine: host.machine,
-		session: session.id,
-		appSlot,
-		appAttempt,
-		bundleId: hostedMacosBundleId(bundleId, appSlot),
-		agent: {
-			driver: "none",
-			setting: "hosting.agentDriver"
-		}
-	};
-	reserved(placement);
-	session = await settle(host, session, ["preparing"], SESSION_TIMEOUT_MS);
-	if (session.state === "unknown") throw unknownSession(host, session);
-	if (session.state !== "ready") throw new Error(`The hosted session ${session.id} on ${host.machine} is ${session.state}.`);
-	const device = parseHostedMacosDevice(session.device);
-	if (!device || device.appSlot !== appSlot) throw new Error(`${host.machine} reported a ready session without its reserved macOS app slot.`);
-	const { files, content } = bundleManifest(bundle);
-	const manifest = Buffer.from(JSON.stringify(files));
-	content.set(sha256(manifest), () => manifest);
-	const ids = {
-		session: session.id,
-		attempt: appAttempt
-	};
-	const offer = {
-		...ids,
-		bundleId,
-		mode: "release",
-		...requestedArguments.length ? { arguments: requestedArguments } : {},
-		manifest: {
-			sha256: sha256(manifest),
-			size: manifest.length
-		}
-	};
-	note(`Delivering ${files.length} files to ${host.machine} (macOS ${device.macosVersion}, ${device.architecture})`);
-	await upload(host, ids, (await call(host, "device-host.app.offer", offer)).missing, content);
-	let missing = (await call(host, "device-host.app.offer", offer)).missing;
-	if (handoff && handoff.nodeId === host.credential.nodeId && Array.isArray(missing) && missing.length) {
-		try {
-			const taken = await call(host, "device-host.app.handoff", {
-				...ids,
-				build: {
-					handoff: handoff.token,
-					sha256: handoff.sha256
-				}
-			}, HANDOFF_TIMEOUT_MS);
-			if (taken.files) note(`${host.machine} took ${String(taken.files)} files from the build it ran`);
-		} catch (error) {
-			note(`${error instanceof Error ? error.message : String(error)}; uploading the app instead`);
-		}
-		missing = (await call(host, "device-host.app.offer", offer)).missing;
-	}
-	await upload(host, ids, missing, content);
-	note(`Launching on ${host.machine}`);
-	let delivery = await call(host, "device-host.app.launch", ids);
-	const deadline = Date.now() + INSTALL_TIMEOUT_MS;
-	while (delivery.state !== "installed") {
-		if (delivery.state === "unknown") throw new Error(`${host.machine} could not install or launch the app${typeof delivery.notice === "string" ? `: ${delivery.notice}` : ""}.`);
-		if (Date.now() > deadline) throw new Error(`${host.machine} did not finish installing the app.`);
-		await sleep(POLL_MS);
-		delivery = await call(host, "device-host.app.attach", ids);
-	}
-	const appliedArguments = validHostedAppArguments(delivery.arguments) ? delivery.arguments : [];
-	if (JSON.stringify(appliedArguments) !== JSON.stringify(requestedArguments)) note(`${host.machine} did not apply macos.arguments. Update stim-server on that host.`);
-	if (typeof delivery.notice === "string") note(delivery.notice);
-	return {
-		placement: {
-			...placement,
-			agent: agentAccess(root, host.credential, delivery.agent, note)
-		},
-		launched: delivery.launched === true ? true : "unverified",
-		arguments: appliedArguments
-	};
-}
-/** Stops a recorded hosted session and waits until the host confirms it stopped; anything else is a failure. */
-async function stopHostedMacos(root, placement) {
-	if (placement.agent.driver === "agent-device") closeAgentConnection(placement.agent.remoteConfig);
-	const host = await connectHost(placement.machine);
-	try {
-		try {
-			let session = hostedSession(host, await call(host, "device-host.stop", { session: placement.session }));
-			session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS);
-			if (session.state !== "stopped") throw unknownSession(host, session);
-			await pullHostedMacosLogs(root, placement, host).catch((error) => {
-				process.stderr.write(`${phaseLine("device", `Could not copy the final logs from ${host.machine}: ${error.message}`)}\n`);
-			});
-		} catch (error) {
-			if (!heldNoLonger(error)) throw error;
-		}
-	} finally {
-		host.connection.close();
-	}
-	rmSync(agentRemoteConfig(root), { force: true });
-}
-//#endregion
-export { pullHostedMacosLogs as a, stopHostedMacos as i, placeHostedMacos as n, probeHostedMacos as r, connectHost as t };