stim 1.12.0 → 1.13.0

package/dist/{named-ports-Dn1o61D9.mjs → named-ports-n7tnJsI8.mjs}

@@ -1,13 +1,69 @@
-import { E as withConfigLock, O as process_identity_exports, S as saveConfig, _ as loadConfig, c as ensureConfig, d as getConfigDir, p as getProject } from "./config-0jCcMM0E.mjs";
+import { A as ownership_claim_exports, E as withConfigLock, O as process_identity_exports, S as saveConfig, _ as loadConfig, c as ensureConfig, d as getConfigDir, p as getProject } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { c as signalProcessTree, n as listeningPids, u as isPortFree } from "./metro-Dzo30hvJ.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BvvJTfo_.mjs";
+import { d as isPortFree, l as signalProcessTree, r as listeningPids } from "./metro-BPeY1YMh.mjs";
+import { n as declareSpawnsOn, o as stopDeclaringSpawnsOn } from "./spawn-claims-PT8aQpCa.mjs";
 import { realpathSync } from "node:fs";
+import { join } from "node:path";
+//#region src/engine/workspace-process-lock.ts
+const DEFAULT_WAIT_MS = 6e4;
+const POLL_MS = 25;
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function workspaceProcessLockError(err) {
+	const code = err?.code;
+	if (code === "STIM_LOCK_REFUSED") return "refused";
+	if (code === "STIM_LOCK_TIMEOUT") return "timeout";
+	return null;
+}
+function workspaceProcessLockPath(root, name, external) {
+	return external ? join(root, `${name}.lock`) : join(root, ".stim", `${name}.lock`);
+}
+async function withWorkspaceProcessLock(root, name, fn, { now = Date.now, sleep = defaultSleep, waitMs = DEFAULT_WAIT_MS, ownerPurpose, details = {}, onHeld, rejectOwnerPurposes = [], external = false, declareSpawns = false } = {}) {
+	const path = workspaceProcessLockPath(root, name, external);
+	const deadline = now() + waitMs;
+	for (;;) {
+		const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
+			root: path,
+			mode: "exclusive",
+			label: `${name} lock`,
+			details: ownerPurpose ? {
+				...details,
+				purpose: ownerPurpose
+			} : details
+		});
+		if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
+		if (attempt.acquired) {
+			if (declareSpawns) declareSpawnsOn(attempt.acquired);
+			try {
+				return await fn(attempt.acquired);
+			} finally {
+				stopDeclaringSpawnsOn(attempt.acquired);
+				(0, ownership_claim_exports.releaseClaim)(attempt.acquired);
+			}
+		}
+		const holder = attempt.held ?? attempt.waitingFor?.[0];
+		const purpose = holder?.details.purpose;
+		if (typeof purpose === "string" && rejectOwnerPurposes.includes(purpose)) {
+			const error = /* @__PURE__ */ new Error(`The ${name} lock at ${path} is held for ${purpose}.`);
+			error.code = "STIM_LOCK_REFUSED";
+			throw error;
+		}
+		if (holder && onHeld) await onHeld(holder);
+		if (now() >= deadline) {
+			const error = /* @__PURE__ */ new Error(`Timed out waiting for the ${name} lock at ${path}.`);
+			error.code = "STIM_LOCK_TIMEOUT";
+			throw error;
+		}
+		await sleep(POLL_MS);
+	}
+}
+//#endregion
 //#region src/named-ports.ts
 const FIRST_PORT = 8900;
 const LAST_PORT = 8999;
+const BROWSER_LABEL = "web-cdp";
 function validatePortLabel(label) {
 	if (label === "metro") throw new Error("metro is managed by stim start and stim stop; choose another label.");
+	if (label === BROWSER_LABEL) throw new Error(`${BROWSER_LABEL} is managed by stim web and stim stop; choose another label.`);
 	if (!/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/.test(label)) throw new Error("A port label must start with a letter and contain at most 64 letters, digits, underscores or hyphens.");
 }
 function portListeners(port, platform) {
@@ -51,8 +107,24 @@ function processCommand(pid, platform) {
 function withPortsLock(fn) {
 	return withWorkspaceProcessLock(getConfigDir(), "ports", fn, { external: true });
 }
-async function getNamedPort(projectPath, label, { isFree = async (port) => await isPortFree(port) && portListeners(port, process.platform).length === 0, log = console.error } = {}) {
+async function getNamedPort(projectPath, label, options = {}) {
 	validatePortLabel(label);
+	return allocateNamedPort(projectPath, label, options);
+}
+/** The loopback DevTools port of the workspace's owned Chrome, allocated like a named port under `web-cdp`. */
+function reserveBrowserPort(projectPath, options = {}) {
+	return allocateNamedPort(projectPath, BROWSER_LABEL, options);
+}
+function releaseBrowserPort(projectPath, port) {
+	return withPortsLock(async () => withConfigLock(() => {
+		const cfg = loadConfig();
+		const ports = cfg?.projects?.[projectPath]?.ports;
+		if (!cfg || ports?.[BROWSER_LABEL] !== port) return;
+		delete ports[BROWSER_LABEL];
+		saveConfig(cfg);
+	}));
+}
+async function allocateNamedPort(projectPath, label, { isFree = async (port) => await isPortFree(port) && portListeners(port, process.platform).length === 0, log = console.error }) {
 	const root = realpathSync(projectPath);
 	return withPortsLock(async () => {
 		const existing = getProject(root)?.ports;
@@ -121,7 +193,7 @@ async function clearNamedPorts(projectPath, { label, stop = false, dryRun = fals
 	if (label !== void 0) validatePortLabel(label);
 	await withPortsLock(async () => {
 		const ports = getProject(projectPath)?.ports ?? {};
-		const selected = Object.entries(ports).filter(([name]) => label === void 0 || name === label);
+		const selected = Object.entries(ports).filter(([name]) => name !== BROWSER_LABEL && (label === void 0 || name === label));
 		if (stop && selected.length > 0 && platform !== "win32" && !getExecutor().findExecutable("lsof")) throw new Error("Cannot stop named ports: lsof is not installed.");
 		const failures = [];
 		for (const [name, port] of selected) try {
@@ -149,4 +221,4 @@ async function clearNamedPorts(projectPath, { label, stop = false, dryRun = fals
 	});
 }
 //#endregion
-export { getNamedPort as n, clearNamedPorts as t };
+export { withWorkspaceProcessLock as a, reserveBrowserPort as i, getNamedPort as n, workspaceProcessLockError as o, releaseBrowserPort as r, workspaceProcessLockPath as s, clearNamedPorts as t };

package/dist/native-runtime-CiiFHt0e.mjs

@@ -0,0 +1,74 @@
+import { S as ensureWorkspaceStorage, c as resolveProjectMetro, h as readWorkspaceState$1 } from "./metro-BPeY1YMh.mjs";
+import { l as phaseLine } from "./command-output-BIL7rlX7.mjs";
+import { r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING } from "./launch-verify-CuJaBpEa.mjs";
+import { s as startDevServer } from "./start-BZhItkiL.mjs";
+import { readIdleStop } from "@stim-cli/core/state";
+import chalk from "chalk";
+//#region src/commands/native-runtime.ts
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function ensureDevServer({ root, port, settings, remote, note, resolve = resolveProjectMetro, start = startDevServer, readState = readWorkspaceState$1 }) {
+	const held = port === null ? null : (await resolve(port, root)).metro;
+	if (port !== null && held) return {
+		ok: true,
+		port,
+		pid: held.pid ?? null,
+		devServer: null,
+		reclaimed: []
+	};
+	const reason = readIdleStop(readState(root)) ? "stopped (idle)" : "not running";
+	note(chalk.dim(phaseLine("metro", `dev server ${reason}; starting it${remote ? " for a remote device" : ""}`)));
+	const result = await start({
+		root,
+		settings,
+		remote,
+		out: note,
+		note
+	});
+	if (!result.ok) return {
+		ok: false,
+		code: result.error.code,
+		message: `Could not start this workspace's dev server: ${result.error.message}`,
+		remedy: result.error.remedy,
+		lines: result.lines,
+		reclaimed: result.reclaimed
+	};
+	const { facts } = result;
+	return {
+		ok: true,
+		port: facts.port,
+		pid: facts.supervisorPid,
+		devServer: facts.alreadyRunning ? null : {
+			started: true,
+			reason
+		},
+		reclaimed: result.reclaimed
+	};
+}
+async function ensureWorkspaceStorageSafely(root, { note = (_line) => {} } = {}) {
+	try {
+		return ensureWorkspaceStorage(root);
+	} catch (err) {
+		note(chalk.dim(`Could not prepare this workspace's Stim state: ${err?.message || err}`));
+		throw err;
+	}
+}
+function launchOutcomeRecord({ launchState, release, bundleId, configuration, metroPort }) {
+	const unverified = launchState === LAUNCH_UNVERIFIED;
+	const bundling = launchState === LAUNCH_BUNDLING;
+	let msg;
+	if (release) msg = unverified ? `${bundleId} could not be verified as running after its ${configuration} launch` : `${bundleId} is running its embedded ${configuration} bundle`;
+	else if (unverified) msg = `no bundle request from ${bundleId} reached this workspace's Metro on port ${metroPort}`;
+	else if (bundling) msg = `${bundleId} requested a bundle from this workspace's Metro on port ${metroPort}; it was still being built when the launch check ended`;
+	else msg = `${bundleId} fetched a bundle from this workspace's Metro on port ${metroPort}`;
+	return {
+		src: "build",
+		level: unverified ? "warn" : "info",
+		event: unverified ? "launch_unverified" : bundling ? "launch_bundling" : "launch_verified",
+		msg
+	};
+}
+function isPhysicalDeviceRequest(flag) {
+	return flag !== null && flag !== void 0 && flag !== false;
+}
+//#endregion
+export { sleep as a, launchOutcomeRecord as i, ensureWorkspaceStorageSafely as n, isPhysicalDeviceRequest as r, ensureDevServer as t };

package/dist/{ownership-Dqnrjrio.mjs → ownership-Bz2kETAS.mjs}

@@ -1,5 +1,5 @@
 import { O as process_identity_exports } from "./config-0jCcMM0E.mjs";
-import { _ as withWorkspaceStateLock, i as pidExists, m as readWorkspaceState, y as writeWorkspaceState } from "./metro-Dzo30hvJ.mjs";
+import { a as pidExists, b as writeWorkspaceState, h as readWorkspaceState, v as withWorkspaceStateLock } from "./metro-BPeY1YMh.mjs";
 import { realpathSync } from "node:fs";
 //#region src/collector/state.ts
 function collectorRoot(root) {

package/dist/{ownership-B8d4kXBx.mjs → ownership-PUP4Dwai.mjs}

@@ -1,13 +1,15 @@
-import { A as ownership_claim_exports, B as deviceSlotPlatforms, E as withConfigLock, L as assignSlotDevice, O as process_identity_exports, S as saveConfig, U as projectDeviceSlots, W as removeSlotDevice, _ as loadConfig, c as ensureConfig, d as getConfigDir, f as getConfigPath, k as acquireAvdClaim } from "./config-0jCcMM0E.mjs";
+import { A as ownership_claim_exports, B as deviceSlotPlatforms, E as withConfigLock, O as process_identity_exports, U as projectDeviceSlots, _ as loadConfig, d as getConfigDir, k as acquireAvdClaim, p as getProject } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { c as signalProcessTree, i as pidExists } from "./metro-Dzo30hvJ.mjs";
-import { r as workspaceProcessLockPath, t as withWorkspaceProcessLock } from "./workspace-process-lock-BvvJTfo_.mjs";
+import { a as pidExists, k as workspaceDir, l as signalProcessTree } from "./metro-BPeY1YMh.mjs";
+import { a as withWorkspaceProcessLock, r as releaseBrowserPort, s as workspaceProcessLockPath } from "./named-ports-n7tnJsI8.mjs";
 import { t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-BWCj5Vh-.mjs";
-import { i as readAgentDeviceRecords } from "./activity-CCZJs__P.mjs";
-import { A as listOrphanedAvdDirectories, F as ownedAvdMatchesConfiguration, K as shutdownAndroidEmulator, P as ownedAvdDirectory, R as ownedAvdSystemImage, T as isStimOwnedAvdName, W as resolveOwnedAvdSerial, Y as waitForAndroidEmulatorShutdown, Z as wipeAvdUserData, d as assertOwnedAvdStopped, f as avdPathExists, m as avdStorageRoots, q as sleepSync, v as deleteAvd } from "./android-75Sk2rIR.mjs";
-import { S as resolveOwnedIosSim, a as deleteParkedIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, i as deleteIosSim, o as eraseIosSim, v as renameIosSim, w as shutdownIosSim } from "./ios-CZWOHTTc.mjs";
-import { closeSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, rmSync, unlinkSync } from "node:fs";
+import { l as phaseLine } from "./command-output-BIL7rlX7.mjs";
+import { a as readAgentDeviceRecords } from "./activity-DfVKZTEB.mjs";
+import { F as ownedAvdDirectory, I as ownedAvdMatchesConfiguration, Q as waitForAndroidEmulatorShutdown, X as sleepSync, Y as shutdownAndroidEmulator, b as deleteAvd, d as assertOwnedAvdStopped, et as wipeAvdUserData, g as avdStorageRoots, j as listOrphanedAvdDirectories, lt as readParked, m as avdPathExists, q as resolveOwnedAvdSerial, st as parkSim, tt as isStimOwnedAvd, ut as removeParkedAfter, z as ownedAvdSystemImage } from "./android-qx_31wJo.mjs";
+import { n as readCreatedDevices, r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-Cd558h31.mjs";
+import { a as readWebRecord, d as webProfileDir, g as removeSingletonFiles, h as liveProfileHolder, i as clearWebRecord, m as chromeProcessState, s as webClaimRoot, t as CDP_PORT_LABEL } from "./state-l1pYwOre.mjs";
+import { S as resolveOwnedIosSim, a as deleteParkedIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, i as deleteIosSim, o as eraseIosSim, v as renameIosSim, w as shutdownIosSim } from "./ios-CmEzZiOj.mjs";
+import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, rmSync, unlinkSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { homedir } from "node:os";
@@ -111,202 +113,6 @@ function closeOwnedDeviceSessions(device, stillOwned, workspace) {
 		report(`could not list agent-device sessions for ${device.id}: ${error.message}`);
 	}
 }
-const POOL_SETTING_REMEDY = "Run `stim guide settings` for the device pool bounds and where it can be set.";
-const MAX_SETTING = {
-	ios: {
-		key: "iosParkedMax",
-		env: "STIM_POOL_IOS_PARKED_MAX"
-	},
-	android: {
-		key: "androidParkedMax",
-		env: "STIM_POOL_ANDROID_PARKED_MAX"
-	}
-};
-function parseMax(raw, strings) {
-	const value = strings && typeof raw === "string" ? /^\d+$/.test(raw.trim()) ? Number(raw.trim()) : NaN : raw;
-	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) return null;
-	return value;
-}
-function parkedMaxSetting(platform, { config, env = process.env } = {}) {
-	const { key, env: envKey } = MAX_SETTING[platform];
-	const fromEnv = env[envKey];
-	const explicit = fromEnv !== void 0 && fromEnv !== "";
-	const pool = (config === void 0 ? loadConfig() : config)?.pool;
-	if (!explicit && pool !== void 0 && (pool === null || typeof pool !== "object" || Array.isArray(pool))) return {
-		max: 0,
-		error: "Invalid pool value. Expected an object with simulator and emulator bounds."
-	};
-	const fromConfig = pool !== null && typeof pool === "object" && !Array.isArray(pool) ? pool[key] : void 0;
-	const raw = explicit ? fromEnv : fromConfig;
-	if (raw === void 0) return {
-		max: env.STIM_HOME ? 0 : 3,
-		error: null
-	};
-	const parsed = parseMax(raw, explicit);
-	if (parsed === null) return {
-		max: 0,
-		error: `Invalid ${explicit ? envKey : `pool.${key}`} value ${JSON.stringify(raw)}. Expected a whole number of parked ${platform === "ios" ? "simulators" : "emulators"}, 0 or more.`
-	};
-	return {
-		max: explicit ? parsed : env.STIM_HOME ? 0 : parsed,
-		error: null
-	};
-}
-function isParkedRecord(value, platform) {
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-	const record = value;
-	return typeof record.udid === "string" && typeof record.name === "string" && record.name.startsWith("stim-") && typeof record.parkedAt === "string" && (platform === "android" ? record.udid === record.name && /^stim-[A-Za-z0-9._-]+$/.test(record.name) && typeof record.systemImage === "string" && typeof record.configuration === "string" : typeof record.deviceTypeIdentifier === "string" && typeof record.runtimeIdentifier === "string" && typeof record.simslimManaged === "boolean" && (record.bundleId === void 0 || typeof record.bundleId === "string") && (record.cacheKey === void 0 || typeof record.cacheKey === "string"));
-}
-function poolBlock(config) {
-	const raw = config?.parked;
-	const block = raw !== null && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
-	const read = (platform) => {
-		const list = block[platform];
-		return Array.isArray(list) ? list.filter((record) => isParkedRecord(record, platform)) : [];
-	};
-	return {
-		ios: read("ios"),
-		android: read("android")
-	};
-}
-function readParked(platform, { config } = {}) {
-	return poolBlock(config === void 0 ? loadConfig() : config)[platform];
-}
-function writeParked(config, platform, records) {
-	config.parked = {
-		...poolBlock(config),
-		[platform]: records
-	};
-}
-function oldestFirst(records) {
-	return records.toSorted((a, b) => String(a.parkedAt).localeCompare(String(b.parkedAt)));
-}
-function isLegacyDeletionClaim(value) {
-	if (value === void 0) return false;
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return true;
-	const marker = value;
-	return marker.kind !== "ownership-claim" || typeof marker.claimId !== "string" || marker.claimId.length === 0;
-}
-function selectParked(records, { deviceTypeIdentifier, runtimeIdentifier }) {
-	return oldestFirst(records.filter((r) => !isLegacyDeletionClaim(r.deletionClaim) && r.deviceTypeIdentifier === deviceTypeIdentifier && r.runtimeIdentifier === runtimeIdentifier));
-}
-function evictOverflow(records, max) {
-	if (records.length <= max) return {
-		keep: [...records],
-		evicted: []
-	};
-	const ordered = oldestFirst(records);
-	const evicted = ordered.slice(0, ordered.length - max);
-	const dropped = new Set(evicted.map((r) => r.udid));
-	return {
-		keep: records.filter((r) => !dropped.has(r.udid)),
-		evicted
-	};
-}
-function parkSim({ platform, projectPath, slot = "default", record, max }) {
-	return withConfigLock(() => {
-		const cfg = ensureConfig();
-		const current = deviceSlotPlatforms(cfg.projects[projectPath], slot)?.[platform];
-		const currentId = platform === "ios" ? current?.deviceUdid : current?.avdName;
-		if (!current?.owned || currentId !== record.udid) throw new Error(`The ${platform === "ios" ? "simulator" : "emulator"} assignment changed before parking.`);
-		const { keep, evicted } = evictOverflow([...readParked(platform, { config: cfg }).filter((r) => r.udid !== record.udid), record], max);
-		writeParked(cfg, platform, [...keep, ...evicted]);
-		const project = cfg.projects[projectPath];
-		if (project) removeSlotDevice(project, platform, slot);
-		saveConfig(cfg);
-		return evicted;
-	});
-}
-function adoptParked({ platform, projectPath, slot = "default", udid, device }) {
-	const claim = claimParkedOperation(platform, udid);
-	if (!claim) return null;
-	try {
-		return withConfigLock(() => {
-			const cfg = ensureConfig();
-			const records = readParked(platform, { config: cfg });
-			const taken = records.find((r) => r.udid === udid);
-			if (!taken || isLegacyDeletionClaim(taken.deletionClaim)) return null;
-			if (deviceSlotPlatforms(cfg.projects[projectPath], slot)?.[platform]) return null;
-			writeParked(cfg, platform, records.filter((r) => r.udid !== udid));
-			const project = cfg.projects[projectPath];
-			if (!project) throw new Error(`Project not registered: ${projectPath}`);
-			assignSlotDevice(project, platform, device, slot);
-			saveConfig(cfg);
-			const adopted = { ...taken };
-			delete adopted.deletionClaim;
-			return adopted;
-		});
-	} finally {
-		(0, ownership_claim_exports.releaseClaim)(claim);
-	}
-}
-function claimParkedOperation(platform, udid) {
-	const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
-		root: join(getConfigDir(), "pool-locks", platform, `${encodeURIComponent(udid.toLowerCase())}.lock`),
-		mode: "exclusive",
-		label: `parked ${platform} device ${udid}`
-	});
-	if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
-	return attempt.acquired ?? null;
-}
-function removeParkedAfter(platform, udid, beforeRemove) {
-	const claim = claimParkedOperation(platform, udid);
-	if (!claim) return null;
-	try {
-		const claimed = withConfigLock(() => {
-			const cfg = loadConfig();
-			if (!cfg) return null;
-			const records = readParked(platform, { config: cfg });
-			const current = records.find((candidate) => candidate.udid === udid);
-			if (!current) return null;
-			if (isLegacyDeletionClaim(current.deletionClaim)) throw new Error(`Parked ${platform} device ${udid} has a legacy deletionClaim in ${getConfigPath()}. Its PID does not establish whether the original operation finished. Keep the device and pool record; after verifying that neither the old Stim process nor its native child is using it, remove only that record's deletionClaim field and retry.`);
-			const record = { ...current };
-			delete record.deletionClaim;
-			const marked = {
-				...record,
-				deletionClaim: {
-					kind: "ownership-claim",
-					claimId: claim.claimId
-				}
-			};
-			writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? marked : candidate));
-			saveConfig(cfg);
-			return {
-				record,
-				marked
-			};
-		});
-		if (!claimed) return null;
-		let completed = false;
-		let removed = null;
-		try {
-			(0, ownership_claim_exports.markClaimChildPending)(claim);
-			try {
-				beforeRemove(claimed.record);
-			} finally {
-				(0, ownership_claim_exports.clearClaimChild)(claim);
-			}
-			completed = true;
-		} finally {
-			withConfigLock(() => {
-				const cfg = loadConfig();
-				if (!cfg) return;
-				const records = readParked(platform, { config: cfg });
-				const current = records.find((candidate) => candidate.udid === udid);
-				if (!isDeepStrictEqual(current, claimed.marked)) return;
-				writeParked(cfg, platform, completed ? records.filter((candidate) => candidate.udid !== udid) : records.map((candidate) => candidate.udid === udid ? claimed.record : candidate));
-				saveConfig(cfg);
-				if (completed) removed = claimed.record;
-			});
-		}
-		return removed;
-	} finally {
-		(0, ownership_claim_exports.releaseClaim)(claim);
-	}
-}
-function dropParked(platform, udid) {
-	return removeParkedAfter(platform, udid, () => {}) !== null;
-}
 //#endregion
 //#region src/devices/teardown.ts
 function teardownParkedAvd(avdName) {
@@ -500,8 +306,16 @@ function removeOrphanedAvdDirectory(candidate, owner) {
 		const current = lstatSync(candidate.directory);
 		if (!current.isDirectory() || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`AVD data at ${candidate.directory} changed or is registered; it was kept.`);
 		assertAvdReferences(candidate.name, owner);
-		const destination = join(dirname(candidate.directory), `stim-gc-${randomUUID()}.avd`);
-		renameSync(candidate.directory, destination);
+		const name = `stim-gc-${randomUUID()}`;
+		recordCreatedDevice("android", name);
+		const destination = join(dirname(candidate.directory), `${name}.avd`);
+		try {
+			renameSync(candidate.directory, destination);
+		} catch (error) {
+			forgetCreatedDevice("android", name);
+			throw error;
+		}
+		forgetCreatedDevice("android", candidate.name);
 		return destination;
 	});
 	const current = lstatSync(detached);
@@ -511,6 +325,7 @@ function removeOrphanedAvdDirectory(candidate, owner) {
 	} catch (error) {
 		throw new Error(`Could not remove AVD data at ${detached}; retry gc --delete: ${error.message}`, { cause: error });
 	}
+	forgetCreatedDevice("android", basename(detached, ".avd"));
 }
 function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
 	const candidates = surveyed ? [surveyed] : listOrphanedAvdDirectories(avdName);
@@ -534,7 +349,7 @@ function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
 function teardownOwnedAvd(avdName, options = {}) {
 	let claim;
 	try {
-		if (!isStimOwnedAvdName(avdName, options.orphanedDirectory ? options.orphanedDirectory.directory : void 0)) return {
+		if (!isStimOwnedAvd(avdName)) return {
 			status: "skipped",
 			kind: "not-owned",
 			reason: `AVD ${avdName} is not Stim-owned: Stim has no record of creating it`
@@ -591,7 +406,7 @@ function teardownClaimedAvd(avdName, claim, { del = false, park, owner, workspac
 					(0, ownership_claim_exports.clearClaimChild)(claim);
 				}
 			});
-		} else assertStopped(avdName);
+		} else waitForShutdown(avdName, null);
 		if (del) {
 			const current = resolveAvd(avdName);
 			if (current.notOwned) return {
@@ -672,6 +487,116 @@ function teardownClaimedAvd(avdName, claim, { del = false, park, owner, workspac
 		};
 	}
 }
+const BROWSER_EXIT_WAIT_MS = 15e3;
+const CHROME_KILL_WAIT_MS = 5e3;
+async function stopOwnedChrome(record) {
+	for (const signal of ["SIGTERM", "SIGKILL"]) {
+		const state = chromeProcessState(record);
+		if (state === "gone") return true;
+		if (state === "unknown") return false;
+		try {
+			signalProcessTree(record.pid, signal, { group: true });
+		} catch {}
+		const deadline = Date.now() + CHROME_KILL_WAIT_MS;
+		while (chromeProcessState(record) !== "gone" && Date.now() < deadline) await sleepAsync(50);
+	}
+	return chromeProcessState(record) === "gone";
+}
+const sleepAsync = (ms) => new Promise((done) => setTimeout(done, ms));
+/**
+* Closes the workspace's Stim-owned Chrome and its supervisor, after verifying both process identities. With
+* `deleteProfile`, it also deletes the profile directory, only when the created-devices ledger lists it.
+*/
+async function teardownOwnedBrowser(root, options = {}) {
+	try {
+		return await withWorkspaceProcessLock(workspaceDir(root), "web", () => teardownBrowserHeld(root, options), {
+			external: true,
+			ownerPurpose: "browser teardown"
+		});
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
+		};
+	}
+}
+/** {@link teardownOwnedBrowser} for a caller that already holds the {@link BROWSER_LOCK} lock. */
+async function teardownBrowserHeld(root, { deleteProfile = false } = {}) {
+	try {
+		const record = readWebRecord(root);
+		const profile = record?.profile ?? webProfileDir(root);
+		if (record) {
+			const supervisor = (0, process_identity_exports.inspectProcessIdentity)(record);
+			const chrome = record.chromeProcess ? (0, process_identity_exports.inspectProcessIdentity)(record.chromeProcess) : "gone";
+			if (supervisor === "unknown" || chrome === "unknown") return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `the browser supervisor (pid ${record.pid}) or its Chrome could not be verified; its record was kept`
+			};
+			if (supervisor === "same") {
+				try {
+					process.kill(record.pid, "SIGTERM");
+				} catch {}
+				if (!await (0, process_identity_exports.waitForProcessExit)(record, BROWSER_EXIT_WAIT_MS)) return {
+					status: "failed",
+					reason: `browser supervisor pid ${record.pid} did not exit`
+				};
+			}
+			if (record.chromeProcess && !await stopOwnedChrome(record.chromeProcess)) return {
+				status: "failed",
+				reason: `Chrome pid ${record.chromeProcess.pid} did not exit`
+			};
+			const holder = liveProfileHolder(profile);
+			if (holder !== null) return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `pid ${holder} still holds ${profile}, and the browser record does not name it; it was left running`
+			};
+			const claims = (0, ownership_claim_exports.clearFreeClaimSet)({
+				root: webClaimRoot(root),
+				label: "browser supervisor"
+			});
+			if (claims.status !== "cleared") return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: claims.status === "held" ? `the browser supervisor claim is still held${claims.holder ? ` by pid ${claims.holder.owner.pid}` : ""}` : `the browser supervisor claim could not be cleared (${claims.reason}); remove it with ${(0, ownership_claim_exports.claimRemoveCommand)(webClaimRoot(root))}`
+			};
+			clearWebRecord(root, record);
+			await releaseBrowserPort(root, record.cdpPort);
+		} else {
+			const holder = liveProfileHolder(profile);
+			if (holder !== null) return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `pid ${holder} holds ${profile} but no browser supervisor is recorded; it was left running`
+			};
+			const port = getProject(root)?.ports?.[CDP_PORT_LABEL];
+			if (typeof port === "number") await releaseBrowserPort(root, port);
+		}
+		if (existsSync(profile)) removeSingletonFiles(profile);
+		if (deleteProfile && existsSync(profile)) {
+			if (!readCreatedDevices().web.has(profile)) return {
+				status: "skipped",
+				kind: "not-owned",
+				reason: `${profile} is not in Stim's ledger; it was kept`
+			};
+			rmSync(profile, {
+				recursive: true,
+				force: true
+			});
+			forgetCreatedDevice("web", profile);
+		}
+		return record ? {
+			status: "torn-down",
+			label: `Chrome (${profile})`
+		} : { status: "missing" };
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
+		};
+	}
+}
 //#endregion
 //#region src/engine/public-http-probe.ts
 const DNS_TIMEOUT_MS = 5e3;
@@ -1210,4 +1135,4 @@ function numberOrNull(v) {
 	return typeof v === "number" && Number.isSafeInteger(v) && v > 0 ? v : null;
 }
 //#endregion
-export { dropParked as _, terminateChild as a, readParked as b, withManagedTunnelLock as c, teardownOwnedAvd as d, teardownOwnedIosSim as f, adoptParked as g, POOL_SETTING_REMEDY as h, stopTunnel as i, withManagedTunnelRemovalLock as l, teardownParkedIosSim as m, managedLockHolders as n, withManagedRemoteWorktreeLock as o, teardownParkedAvd as p, startTunnelSequence as r, withManagedRemoteWorktreeRemovalLock as s, resolveSupervisorTarget as t, probePublicHttp as u, isLegacyDeletionClaim as v, selectParked as x, parkedMaxSetting as y };
+export { terminateChild as a, withManagedTunnelLock as c, teardownBrowserHeld as d, teardownOwnedAvd as f, teardownParkedIosSim as g, teardownParkedAvd as h, stopTunnel as i, withManagedTunnelRemovalLock as l, teardownOwnedIosSim as m, managedLockHolders as n, withManagedRemoteWorktreeLock as o, teardownOwnedBrowser as p, startTunnelSequence as r, withManagedRemoteWorktreeRemovalLock as s, resolveSupervisorTarget as t, probePublicHttp as u };

package/dist/page-BTu7I60K.mjs

@@ -0,0 +1,29 @@
+import { O as process_identity_exports } from "./config-0jCcMM0E.mjs";
+import { t as connectOwnedBrowser } from "./cdp-Dq_ypAlJ.mjs";
+//#region src/web/page.ts
+/** The record of a verified live browser: its supervisor and Chrome are the processes the record names. */
+function liveWebRecord(record) {
+	if (!record?.targetId || !record.chromeProcess) return null;
+	if ((0, process_identity_exports.inspectProcessIdentity)(record) !== "same" || (0, process_identity_exports.inspectProcessIdentity)(record.chromeProcess) !== "same") return null;
+	return record;
+}
+const NAVIGATE_ACK_MS = 1e3;
+/** Sends one page-level DevTools command to the owned page, through a connection verified to reach its Chrome. */
+async function sendToOwnedPage(record, method, params = {}) {
+	const cdp = await connectOwnedBrowser(record.cdpPort, record.chromeProcess.pid);
+	try {
+		const { sessionId } = await cdp.send("Target.attachToTarget", {
+			targetId: record.targetId,
+			flatten: true
+		});
+		const reply = cdp.send(method, params, sessionId);
+		if (method === "Page.navigate") {
+			reply.catch(() => {});
+			await Promise.race([reply, new Promise((resolve) => setTimeout(resolve, NAVIGATE_ACK_MS))]);
+		} else await reply;
+	} finally {
+		cdp.close();
+	}
+}
+//#endregion
+export { sendToOwnedPage as n, liveWebRecord as t };

package/dist/{ports-Dp_QTwTC.mjs → ports-C5UutqpJ.mjs}

@@ -1,10 +1,10 @@
 import { p as getProject } from "./config-0jCcMM0E.mjs";
-import { i as findProjectRoot } from "./project-B8rbutVC.mjs";
-import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-Dn1o61D9.mjs";
+import { i as findCommandWorkspace } from "./project-DGeclhvO.mjs";
+import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-n7tnJsI8.mjs";
 //#region src/commands/ports.ts
 async function inProject(action) {
 	try {
-		const root = findProjectRoot(process.cwd());
+		const root = findCommandWorkspace(process.cwd());
 		if (!root) throw new Error("No package.json found. Run stim ports from the workspace that owns the server.");
 		await action(root);
 	} catch (error) {
@@ -16,7 +16,7 @@ function portsCommand(program) {
 	const ports = program.command("ports").description("Reserve workspace ports for servers Stim does not manage");
 	ports.action(() => inProject(async (root) => {
 		const project = getProject(root);
-		const rows = Object.entries(project?.ports ?? {});
+		const rows = Object.entries(project?.ports ?? {}).map(([name, port]) => [name === "web-cdp" ? "web-cdp (managed)" : name, port]);
 		if (typeof project?.metroPort === "number") rows.push(["metro (managed)", project.metroPort]);
 		if (!rows.length) {
 			console.log("No ports allocated. Use stim ports get <label>.");