@stim-cli/core 1.20.0 → 1.20.2

package/dist/state.mjs

@@ -1,12 +1,12 @@
 import { _ as releaseClaim, f as isClaimRefusal, g as readClaimSet, x as tryAcquireClaim } from "./ownership-claim-O31Y5iIb.mjs";
 import { inspectProcessIdentity } from "./process-identity.mjs";
-import { M as withDirLock, S as workspaceName, g as rotatedLogPath, h as rotateLog, l as configDir, t as LOG_ROTATE_BYTES, u as ensurePrivateDir, w as workspaceStateDir } from "./core-Btea8jlo.mjs";
+import { C as workspaceName, F as readJsonObject, I as readStateFile, L as withStateReadCache, N as isJsonObject, P as readJsonFile, R as withDirLock, T as workspaceStateDir, _ as rotatedLogPath, d as ensurePrivateDir, g as rotateLog, t as LOG_ROTATE_BYTES, u as configDir } from "./core-BkgfKqJ8.mjs";
+import { n as withGitChip, t as withDerivedFacts } from "./status-derived-C13g6eQt.mjs";
 import { appendFileSync, closeSync, existsSync, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { availableParallelism, homedir, loadavg } from "node:os";
 import { basename, dirname, isAbsolute, join, posix, relative, resolve, sep } from "node:path";
 import { createHash, randomBytes } from "node:crypto";
 import { isIP } from "node:net";
-import { AsyncLocalStorage } from "node:async_hooks";
 import { StringDecoder } from "node:string_decoder";
 //#region state/agent-actions.ts
 const EVENTS_VERSION = 1;
@@ -307,48 +307,6 @@ function createAgentActionReader({ sessionsDirs, targets: resolveTargets, sinceT
 	};
 }
 //#endregion
-//#region state/json-file.ts
-const readScope = new AsyncLocalStorage();
-/**
-* Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
-* returns the text of the first read of that path, and a path found missing stays missing. Callers still parse every time, so no two
-* share a mutable object. Only for computations that write none of the files they read.
-*/
-function withStateReadCache(fn) {
-	return readScope.run(/* @__PURE__ */ new Map(), fn);
-}
-function readStateFile(path) {
-	const cache = readScope.getStore();
-	if (!cache) return readFileSync(path, "utf-8");
-	const cached = cache.get(path);
-	if (cached) {
-		if ("missing" in cached) throw cached.missing;
-		return cached.text;
-	}
-	try {
-		const text = readFileSync(path, "utf-8");
-		cache.set(path, { text });
-		return text;
-	} catch (error) {
-		if (error.code === "ENOENT") cache.set(path, { missing: error });
-		throw error;
-	}
-}
-function readJsonFile(path) {
-	return JSON.parse(readStateFile(path));
-}
-function isJsonObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readJsonObject(path) {
-	try {
-		const value = readJsonFile(path);
-		return isJsonObject(value) ? value : null;
-	} catch {
-		return null;
-	}
-}
-//#endregion
 //#region state/agent-device-usage.ts
 function agentDeviceUsageFile() {
 	return join(configDir(), "agent-device-usage.json");
@@ -403,8 +361,17 @@ function swiftpmCacheUsageFile() {
 }
 function readSwiftpmCacheUsage() {
 	const value = readJsonObject(swiftpmCacheUsageFile());
-	if (!value || value.version !== 1 || typeof value.measuredAt !== "string" || !Number.isFinite(Date.parse(value.measuredAt)) || typeof value.dir !== "string" || typeof value.present !== "boolean" || typeof value.complete !== "boolean" || !(value.bytes === null || typeof value.bytes === "number" && Number.isFinite(value.bytes) && value.bytes >= 0)) return null;
-	return value;
+	if (!value) return null;
+	const { version, measuredAt, dir, present, bytes, complete } = value;
+	if (version !== 1 || typeof measuredAt !== "string" || !Number.isFinite(Date.parse(measuredAt)) || typeof dir !== "string" || typeof present !== "boolean" || typeof complete !== "boolean" || !(bytes === null || typeof bytes === "number" && Number.isFinite(bytes) && bytes >= 0)) return null;
+	return {
+		version,
+		measuredAt,
+		dir,
+		present,
+		bytes,
+		complete
+	};
 }
 //#endregion
 //#region state/paths.ts
@@ -802,23 +769,47 @@ function parseHostedMacosChoice(value) {
 	};
 }
 function parseHostedMacosDevice(value) {
-	if (!isJsonObject(value) || !parseHostedMacosChoice(value) || !hostedMacosAppSlot(value.appSlot) || Object.keys(value).some((key) => ![
+	if (!isJsonObject(value) || !hostedMacosAppSlot(value.appSlot) || Object.keys(value).some((key) => ![
 		"architecture",
 		"macosVersion",
 		"appSlot"
 	].includes(key))) return null;
-	return value;
+	const choice = parseHostedMacosChoice(value);
+	return choice && {
+		...choice,
+		appSlot: value.appSlot
+	};
 }
 const AGENT_PATH = /^\/device-host\/agent\/[a-f0-9-]{36}\/$/;
 const LEASE_NAME = /^[A-Za-z0-9._-]{1,128}$/;
 const LEASE_DEVICE_KEY = /^[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)+@[1-9][0-9]{0,9}$/;
+function leaseName(value) {
+	return typeof value === "string" && LEASE_NAME.test(value);
+}
 function parseHostedAgentLease(value) {
-	if (!isJsonObject(value) || Object.keys(value).length !== (value.backend === "ios-instance" || value.backend === "android-instance" ? 5 : 4) || ![
-		value.tenant,
-		value.runId,
-		value.clientId
-	].every((name) => typeof name === "string" && LEASE_NAME.test(name)) || typeof value.deviceKey !== "string" || !(value.backend === "ios-instance" ? /^ios:mobile:[a-fA-F0-9-]{36}$/.test(value.deviceKey) : value.backend === "android-instance" ? /^android:mobile:emulator-[0-9]+$/.test(value.deviceKey) : value.backend === void 0 && LEASE_DEVICE_KEY.test(value.deviceKey))) return null;
-	return value;
+	if (!isJsonObject(value)) return null;
+	const { tenant, runId, clientId, deviceKey, backend } = value;
+	if (Object.keys(value).length !== (backend === "ios-instance" || backend === "android-instance" ? 5 : 4) || !leaseName(tenant) || !leaseName(runId) || !leaseName(clientId) || typeof deviceKey !== "string") return null;
+	if (backend === "ios-instance") return /^ios:mobile:[a-fA-F0-9-]{36}$/.test(deviceKey) ? {
+		tenant,
+		runId,
+		clientId,
+		deviceKey,
+		backend
+	} : null;
+	if (backend === "android-instance") return /^android:mobile:emulator-[0-9]+$/.test(deviceKey) ? {
+		tenant,
+		runId,
+		clientId,
+		deviceKey,
+		backend
+	} : null;
+	return backend === void 0 && LEASE_DEVICE_KEY.test(deviceKey) ? {
+		tenant,
+		runId,
+		clientId,
+		deviceKey
+	} : null;
 }
 /** A grant naming a driver this client does not know is not usable; it parses as null. */
 function parseHostedAgentGrant(value) {
@@ -1010,7 +1001,7 @@ const SETTINGS = [
 		key: "ios.scheme",
 		type: STRING,
 		scopes: ["workspace", "committed"],
-		description: "Shared Xcode scheme to build when the workspace has several"
+		description: "Shared Xcode scheme to build when the workspace has several; the --scheme flag overrides it"
 	},
 	{
 		key: "ios.remote",
@@ -1382,6 +1373,13 @@ const SETTINGS = [
 		env: "STIM_ARCHIVE_AGENT_ACTIONS_MAX_AGE_DAYS",
 		description: "Days to keep archived agent-device sessions; 0 keeps none"
 	},
+	{
+		key: "workspace.hidden",
+		type: BOOLEAN,
+		scopes: ["workspace"],
+		default: false,
+		description: "Hide this workspace in Stim Desktop and the phone app; the next command that uses it unhides it"
+	},
 	{
 		key: "worktree.exclude",
 		type: { kind: "strings" },
@@ -2062,16 +2060,19 @@ function liveNativeBuilds() {
 	for (const name of names) {
 		let active;
 		try {
-			active = JSON.parse(readFileSync(join(dir, name, "state.json"), "utf8")).activeBuild;
+			const state = JSON.parse(readFileSync(join(dir, name, "state.json"), "utf8"));
+			active = isJsonObject(state) ? state.activeBuild : void 0;
 		} catch {
 			continue;
 		}
-		if (!active || typeof active !== "object") continue;
+		if (!isJsonObject(active)) continue;
 		const { phase, claim, placement } = active;
 		if (typeof phase !== "string" || !NATIVE_PHASES.has(phase) || placement) continue;
-		if (typeof claim?.root !== "string" || typeof claim.claimId !== "string") continue;
+		if (!isJsonObject(claim)) continue;
+		const { root, claimId } = claim;
+		if (typeof root !== "string" || typeof claimId !== "string") continue;
 		try {
-			if (readClaimSet(claim.root).live.some((holder) => holder.claimId === claim.claimId)) count += 1;
+			if (readClaimSet(root).live.some((holder) => holder.claimId === claimId)) count += 1;
 		} catch {}
 	}
 	return count;
@@ -2264,10 +2265,15 @@ function ids(value) {
 function readCreatedDevices() {
 	try {
 		const parsed = JSON.parse(readStateFile(createdDevicesFile()));
+		if (!isJsonObject(parsed)) return {
+			ios: /* @__PURE__ */ new Set(),
+			android: /* @__PURE__ */ new Set(),
+			web: /* @__PURE__ */ new Set()
+		};
 		return {
-			ios: new Set(ids(parsed?.ios)),
-			android: new Set(ids(parsed?.android)),
-			web: new Set(ids(parsed?.web))
+			ios: new Set(ids(parsed.ios)),
+			android: new Set(ids(parsed.android)),
+			web: new Set(ids(parsed.web))
 		};
 	} catch {
 		return {
@@ -3251,154 +3257,6 @@ const MACHINE_OWNER_KINDS = [
 	"shared"
 ];
 //#endregion
-//#region state/status-derived.ts
-const PLATFORMS$1 = ["ios", "android"];
-function isRunning(platform, device) {
-	if (platform === "ios") return device.state === "Booted";
-	return device.state === "detected" && !device.physical;
-}
-function appPresence(env, platform, device) {
-	if (!isRunning(platform, device) || device.app?.state === "running") return null;
-	const everBuilt = env.builds?.[platform]?.some((entry) => entry.result === "succeeded") ?? true;
-	if (env.lastBuilds?.[platform]?.status === "failed" && !everBuilt) return "none";
-	return device.app?.state === "stopped" ? "closed" : null;
-}
-function deviceSlots(env) {
-	return [{
-		slot: "default",
-		ios: env.ios,
-		android: env.android
-	}, ...env.slots ?? []];
-}
-function latestBuild(env) {
-	let latest = null;
-	for (const platform of PLATFORMS$1) {
-		const build = env.lastBuilds?.[platform];
-		if (build && (latest === null || Date.parse(build.startedAt) > Date.parse(latest.startedAt))) latest = build;
-	}
-	return latest;
-}
-function stage(kind, since, platform = null) {
-	return {
-		kind,
-		since: since ?? null,
-		platform,
-		closedApps: []
-	};
-}
-function workspaceStage(env) {
-	if (env.macos?.build.state === "running") return stage("building", env.macos.build.startedAt, "macos");
-	if (env.macos?.build.state === "failed") return stage("build-failed", env.macos.build.finishedAt ?? env.macos.build.startedAt, "macos");
-	if (env.build?.state === "running") return stage("building", env.build.startedAt, env.build.platform);
-	if (!env.live && env.phase === "warming") return stage("warming", env.phaseSince);
-	if (!env.live && env.phase === "ready") return stage("ready", env.phaseSince);
-	const latest = latestBuild(env);
-	if (latest?.status === "failed") return stage("build-failed", latest.finishedAt ?? latest.startedAt, latest.platform);
-	if (env.live || (env.remoteDevices?.length ?? 0) > 0) {
-		const closedApps = deviceSlots(env).flatMap(({ slot, ...devices }) => PLATFORMS$1.flatMap((platform) => {
-			const device = devices[platform];
-			return device && appPresence(env, platform, device) === "closed" ? [{
-				platform,
-				slot
-			}] : [];
-		}));
-		return {
-			...stage("running", env.supervisor?.startedAt),
-			closedApps
-		};
-	}
-	const lastStop = env.metro?.lastStop;
-	return stage("stopped", lastStop && "at" in lastStop ? lastStop.at : null);
-}
-function checksState(checks) {
-	if (!checks) return null;
-	if (checks.failing > 0) return "failing";
-	if (checks.pending > 0) return "pending";
-	return checks.passing > 0 ? "passing" : null;
-}
-function gitChip(worktree) {
-	const git = worktree.git;
-	if (!git) return null;
-	const pull = worktree.pullRequest;
-	const parts = [];
-	const ahead = git.ahead ?? 0;
-	const behind = git.behind ?? 0;
-	if (ahead || behind) parts.push({
-		kind: "arrows",
-		ahead,
-		behind
-	});
-	const uncommitted = git.changed + git.untracked;
-	if (uncommitted) parts.push({
-		kind: "changed",
-		count: uncommitted
-	});
-	if (git.mergedInto !== null) {
-		if (pull?.state !== "merged") parts.push({
-			kind: "merged",
-			into: git.mergedInto
-		});
-	} else if (git.upstream === null) parts.push({ kind: "no-upstream" });
-	return {
-		parts,
-		ci: pull ? checksState(pull.checks) : null
-	};
-}
-function buildCause(build) {
-	if (("result" in build ? build.result : build.status) !== "failed") return null;
-	const at = build.diagnostics?.find((d) => d.file && d.line !== null && d.line !== void 0);
-	if (at) return {
-		key: `${at.file}:${at.line}`,
-		file: at.file,
-		line: at.line
-	};
-	return {
-		key: build.errorCode ?? "failed",
-		file: null,
-		line: null
-	};
-}
-function withCauses(builds) {
-	if (!builds) return builds;
-	return Object.fromEntries(Object.entries(builds).map(([platform, list]) => [platform, list?.map((build) => withCause(build))]));
-}
-function withCause(build) {
-	const cause = buildCause(build);
-	return cause ? {
-		...build,
-		cause
-	} : build;
-}
-function withGitChip(worktree) {
-	const chip = gitChip(worktree);
-	return chip ? {
-		...worktree,
-		gitChip: chip
-	} : worktree;
-}
-/** The environment with the conclusions clients draw from it: `stage`, `appPresence`, `gitChip` and `cause`. */
-function withDerivedFacts(env) {
-	const device = (platform, record) => record ? {
-		...record,
-		appPresence: appPresence(env, platform, record)
-	} : record;
-	const derived = {
-		...env,
-		stage: workspaceStage(env)
-	};
-	if (env.ios) derived.ios = device("ios", env.ios);
-	if (env.android) derived.android = device("android", env.android);
-	if (env.slots) derived.slots = env.slots.map((slot) => ({
-		...slot,
-		ios: device("ios", slot.ios),
-		android: device("android", slot.android)
-	}));
-	if (env.worktree) derived.worktree = withGitChip(env.worktree);
-	if (env.lastBuilds) derived.lastBuilds = Object.fromEntries(Object.entries(env.lastBuilds).map(([platform, build]) => [platform, withCause(build)]));
-	if (env.builds) derived.builds = withCauses(env.builds);
-	return derived;
-}
-//#endregion
 //#region state/status-measures.ts
 function cacheName(path) {
 	return `${createHash("sha256").update(path).digest("hex").slice(0, 32)}.json`;
@@ -3459,7 +3317,7 @@ const REVIEW_DECISIONS = /* @__PURE__ */ new Set([
 ]);
 function pullRequestOf(value) {
 	if (value === null) return null;
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	if (!isJsonObject(value)) return void 0;
 	const pr = value;
 	if (!Number.isInteger(pr.number) || typeof pr.url !== "string" || typeof pr.title !== "string") return void 0;
 	if (!PR_STATES.has(pr.state) || typeof pr.checkedAt !== "string") return void 0;
@@ -3524,7 +3382,7 @@ function readBuildDetail(root, claimId) {
 	const file = readJsonObject(workspaceBuildDetailFile(root));
 	if (!file || file.claimId !== claimId) return null;
 	const detail = file.detail;
-	if (!detail || typeof detail !== "object" || Array.isArray(detail)) return null;
+	if (!isJsonObject(detail)) return null;
 	const raw = detail;
 	if (typeof raw.updatedAt !== "string") return null;
 	return {
@@ -3541,7 +3399,7 @@ function optionalString(value) {
 }
 /** An agent session as Stim wrote it to its cache or workspace state, or null when it is not one. */
 function agentSessionOf(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	if (!isJsonObject(value)) return null;
 	const raw = value;
 	if (!AGENT_TOOLS.includes(raw.tool)) return null;
 	if (typeof raw.sessionId !== "string" || !raw.sessionId || typeof raw.cwd !== "string" || !raw.cwd) return null;
@@ -3558,7 +3416,7 @@ function agentSessionOf(value) {
 	if (title) session.title = title;
 	if (startedAt) session.startedAt = startedAt;
 	if (lastActiveAt) session.lastActiveAt = lastActiveAt;
-	if (Number.isInteger(raw.pid) && raw.pid > 0) session.pid = raw.pid;
+	if (typeof raw.pid === "number" && Number.isInteger(raw.pid) && raw.pid > 0) session.pid = raw.pid;
 	if (openUrl) session.openUrl = openUrl;
 	if (webUrl) session.webUrl = webUrl;
 	return session;
@@ -3718,7 +3576,7 @@ function missChange(value) {
 }
 /** A recorded miss reason in the shape status reports, without `baseline.cacheKey`; null when malformed. */
 function parseMissReason(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	if (!isJsonObject(value)) return null;
 	const record = value;
 	if (typeof record.kind !== "string" || !MISS_KINDS.has(record.kind) || typeof record.summary !== "string") return null;
 	const changes = (Array.isArray(record.changes) ? record.changes : []).map(missChange).filter((change) => change !== null).slice(0, MISS_CHANGE_CAP);
@@ -3727,7 +3585,7 @@ function parseMissReason(value) {
 		kind: record.kind,
 		summary: record.summary,
 		changes,
-		changeCount: Number.isInteger(record.changeCount) && record.changeCount >= changes.length ? record.changeCount : changes.length,
+		changeCount: typeof record.changeCount === "number" && Number.isInteger(record.changeCount) && record.changeCount >= changes.length ? record.changeCount : changes.length,
 		baseline: baseline && typeof baseline.fingerprint === "string" && (baseline.from === "workspace" || baseline.from === "project") ? {
 			fingerprint: baseline.fingerprint,
 			from: baseline.from
@@ -3755,7 +3613,7 @@ function buildDiagnostics(value) {
 	}).toSorted((a, b) => Number(b.file !== null) - Number(a.file !== null)).slice(0, DIAGNOSTIC_CAP);
 }
 function devicePlacement(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	if (!isJsonObject(value)) return null;
 	const record = value;
 	if (record.decision !== "local" && record.decision !== "hosted" && record.decision !== "waited-locally" && record.decision !== "eas" || typeof record.reason !== "string") return null;
 	return {
@@ -3771,7 +3629,7 @@ function readDevicePlacement(state, platform, slot = "default") {
 	return devicePlacement(isJsonObject(device) ? device.devicePlacement : void 0);
 }
 function lastBuildReport(platform, value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	if (!isJsonObject(value)) return null;
 	const record = value;
 	if (record.platform !== platform || record.status !== "ok" && record.status !== "failed") return null;
 	if (typeof record.startedAt !== "string") return null;
@@ -4322,6 +4180,17 @@ function findProjectRoot(startDir) {
 }
 //#endregion
 //#region state/device-host.ts
+const DEVICE_HOST_LIMITS = {
+	prepareMs: 3e5,
+	offerMs: 3e4,
+	stopMs: 9e4,
+	logsMs: 15e3,
+	killGraceMs: 5e3
+};
+/** How long a cancelled hosted worker run can take to settle: SIGTERM, SIGKILL after the grace, then it is abandoned. */
+function hostedWorkerSettleMs(limits = DEVICE_HOST_LIMITS) {
+	return limits.killGraceMs * 2;
+}
 function deviceHostRoot() {
 	return join(configDir(), "server", "device-host-sessions");
 }
@@ -4331,24 +4200,39 @@ function deviceHostArea(id) {
 }
 function parseHostedChoice(value) {
 	if (!isJsonObject(value)) return null;
-	if (![
-		"deviceTypeId",
-		"runtimeId",
-		"deviceType",
-		"runtime"
-	].every((key) => typeof value[key] === "string" && value[key])) return null;
-	if (value.architecture !== "arm64" && value.architecture !== "x86_64") return null;
-	return value;
+	const { deviceTypeId, runtimeId, deviceType, runtime, architecture } = value;
+	if (typeof deviceTypeId !== "string" || !deviceTypeId || typeof runtimeId !== "string" || !runtimeId || typeof deviceType !== "string" || !deviceType || typeof runtime !== "string" || !runtime || architecture !== "arm64" && architecture !== "x86_64") return null;
+	return {
+		deviceTypeId,
+		runtimeId,
+		deviceType,
+		runtime,
+		architecture
+	};
 }
 function parseHostedDevice(value) {
-	if (!isJsonObject(value) || value.avdName !== void 0 || !parseHostedChoice(value)) return null;
-	if (typeof value.udid !== "string" || !/^[a-fA-F0-9-]{36}$/.test(value.udid) || typeof value.name !== "string") return null;
-	return value;
+	if (!isJsonObject(value) || value.avdName !== void 0) return null;
+	const choice = parseHostedChoice(value);
+	const { udid, name } = value;
+	if (!choice || typeof udid !== "string" || !/^[a-fA-F0-9-]{36}$/.test(udid) || typeof name !== "string") return null;
+	return {
+		...choice,
+		udid,
+		name
+	};
 }
 function parseHostedAndroidDevice(value) {
 	if (!isJsonObject(value)) return null;
-	if (value.udid !== void 0 || typeof value.avdName !== "string" || !/^stim-[A-Za-z0-9._-]+$/.test(value.avdName) || !hostedConsolePort(value.consolePort) || value.serial !== `emulator-${value.consolePort}` || typeof value.systemImage !== "string" || !/^system-images;android-\d+;[^;\s]+;(arm64-v8a|x86_64)$/.test(value.systemImage) || typeof value.deviceProfile !== "string" || !value.deviceProfile || value.architecture !== "arm64-v8a" && value.architecture !== "x86_64" || !value.systemImage.endsWith(`;${value.architecture}`)) return null;
-	return value;
+	const { avdName, consolePort, systemImage, deviceProfile, architecture } = value;
+	if (value.udid !== void 0 || typeof avdName !== "string" || !/^stim-[A-Za-z0-9._-]+$/.test(avdName) || !hostedConsolePort(consolePort) || value.serial !== `emulator-${consolePort}` || typeof systemImage !== "string" || !/^system-images;android-\d+;[^;\s]+;(arm64-v8a|x86_64)$/.test(systemImage) || typeof deviceProfile !== "string" || !deviceProfile || architecture !== "arm64-v8a" && architecture !== "x86_64" || !systemImage.endsWith(`;${architecture}`)) return null;
+	return {
+		avdName,
+		serial: `emulator-${consolePort}`,
+		consolePort,
+		systemImage,
+		deviceProfile,
+		architecture
+	};
 }
 /** Android Emulator -help-port defines the supported even console ports as 5554 through 5584. */
 function hostedConsolePort(value) {
@@ -4645,8 +4529,8 @@ function readHostedApp(session, attempt, workerHome) {
 function processRecord(value) {
 	if (!value || typeof value !== "object") return void 0;
 	const { pid, processToken, startedAtMicros } = value;
-	if (!Number.isSafeInteger(pid) || pid <= 0 || typeof processToken !== "string") return void 0;
-	if (!Number.isSafeInteger(startedAtMicros) || startedAtMicros <= 0) return void 0;
+	if (typeof pid !== "number" || !Number.isSafeInteger(pid) || pid <= 0 || typeof processToken !== "string") return void 0;
+	if (typeof startedAtMicros !== "number" || !Number.isSafeInteger(startedAtMicros) || startedAtMicros <= 0) return void 0;
 	return {
 		pid,
 		processToken,
@@ -4866,11 +4750,11 @@ const hostedNativeLogsDir = (home, platform) => join(home, `${platform}-logs`);
 function readHostedNativeLogsCheckpoint(home, platform = "ios") {
 	try {
 		const value = JSON.parse(readFileSync(join(hostedNativeLogsDir(home, platform), "checkpoint.json"), "utf8"));
-		if (!isJsonObject(value) || !Number.isSafeInteger(value.until) || value.until < 0 || value.windowMs !== void 0 && (!Number.isSafeInteger(value.windowMs) || value.windowMs < 1e3) || !Array.isArray(value.boundary) || !value.boundary.every((each) => typeof each === "string" && /^[a-f0-9]{64}$/.test(each))) return null;
+		if (!isJsonObject(value) || !Number.isSafeInteger(value.until) || value.until < 0 || value.windowMs !== void 0 && (typeof value.windowMs !== "number" || !Number.isSafeInteger(value.windowMs) || value.windowMs < 1e3) || !Array.isArray(value.boundary) || !value.boundary.every((each) => typeof each === "string" && /^[a-f0-9]{64}$/.test(each))) return null;
 		return {
 			until: value.until,
 			boundary: value.boundary,
-			...typeof value.appAttempt === "string" && Number.isSafeInteger(value.pid) && value.pid > 0 ? {
+			...typeof value.appAttempt === "string" && typeof value.pid === "number" && Number.isSafeInteger(value.pid) && value.pid > 0 ? {
 				appAttempt: value.appAttempt,
 				pid: value.pid
 			} : {},
@@ -5159,7 +5043,7 @@ function parseSetupJournal(value) {
 		"ok",
 		"skipped",
 		"failed"
-	].includes(step.state) && text(step.title) && (step.detail === void 0 || typeof step.detail === "string") && (step.fix === void 0 || typeof step.fix === "string")) || !Array.isArray(value.granted) || !value.granted.every((grant) => isJsonObject(grant) && knownKeys(grant, ["capability", "id"]) && capability(grant.capability) && text(grant.id)) || typeof value.done !== "boolean" || value.exit !== void 0 && (!Number.isInteger(value.exit) || value.exit < 0)) return null;
+	].includes(step.state) && text(step.title) && (step.detail === void 0 || typeof step.detail === "string") && (step.fix === void 0 || typeof step.fix === "string")) || !Array.isArray(value.granted) || !value.granted.every((grant) => isJsonObject(grant) && knownKeys(grant, ["capability", "id"]) && capability(grant.capability) && text(grant.id)) || typeof value.done !== "boolean" || value.exit !== void 0 && (typeof value.exit !== "number" || !Number.isInteger(value.exit) || value.exit < 0)) return null;
 	return value;
 }
 function readSetupJournal(hash) {
@@ -5173,4 +5057,4 @@ function isSetupJournalPrunable(journal, now) {
 	return Date.parse(journal.expiresAt) + 36e5 < now;
 }
 //#endregion
-export { ACTIVITY_RECENCY_BASES, AGENT_TOOLS, ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, APP_PROCESS_STATES, BUILD_HISTORY_KEY, BUILD_HISTORY_LIMIT, BUILD_PHASES, BUILD_RESULTS, CAPACITY_REFUSAL_LIMIT, CAPACITY_REFUSAL_MAX_AGE_MS, DEBUG_ENV, DEVICE_IDLE_SHUTDOWN_KEY, DEVICE_RECLAIM_REASON, DEV_SERVER_STOP_REQUEST_KEY, ENDED_AGENT_RETENTION_MS, ERROR_SOURCES, HISTORY_LIMIT, HOSTED_AGENT_DRIVERS, HOSTED_APP_CHUNK_BYTES, HOSTED_LOGS_FIRST_BYTES, HOSTED_LOGS_PAGE_BYTES, HOSTED_MACOS_APP_SLOTS, HOSTED_METRO_GATEWAYS_KEY, HOSTED_METRO_REQUESTS_KEY, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, LAST_BUILD_KEYS, LEVELS, MACHINE_OWNER_KINDS, MAINTENANCE_LOG_NAME, MEMORY_SOURCES, NATIVE_BUILD_STEPS, NATIVE_CRASH_LOG_PREFIX, OFFLOAD_MODES, PHYSICAL_DEVICE_CONNECTIONS, PLACEMENT_DECISIONS, READY_PHASE_MS, RECORDING_CAP_BYTES, RECORDING_FOOTAGE_MS, RECORDING_PLATFORMS, REMOTE_DEVICE_BACKENDS, RUN_ID_ENV, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATS_VERSION, STATUS_ISSUE_CODES, TAILNET_MACHINE_PATTERN, TUNNEL_MODES, TUTORIAL_VERSION, WARM_KEY, WEB_PAGE_STATES, WEB_VIEWPORTS, WORKSPACE_AGENT_KEY, WORKSPACE_PHASES, WORKSPACE_STAGE_KINDS, acceptsShape, advanceTail, agentDeviceStateDirs, agentDeviceUsageFile, agentSessionOf, agentSessionsCacheFile, allMetroPorts, archiveDir, archiveEnabled, archiveLock, archiveRoot, archivedUsage, assertHostedDeviceLedger, attachExpoErrorContext, automaticMachineEnabled, buildCriteria, buildDiagnostics, buildMachinesFile, buildMachinesLock, buildSlotPath, buildSlotsDir, buildWorkerRoot, bundleMarkerPlatform, capDrops, closedSegmentName, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, countErrorEntries, createAgentActionReader, createDebugLog, createdDevicesFile, createdDevicesLock, debugLogDir, debugLoggingEnabled, decodeStats, deviceHostArea, deviceHostMachinesClaims, deviceHostMachinesFile, deviceHostMachinesLock, deviceHostRoot, deviceViewersDir, diskUsageCacheDir, diskUsageCacheFile, diskUsageFailureFile, diskUsageWalkClaims, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, endedAgentSessionOf, endpoint, expectedShape, fileSizes, findEnclosingWorktreeRoot, findPeer, findProjectByMetroPort, findProjectRoot, followLogs, footageDrops, getConcurrencyLimits, getConfigPath, getParkedMax, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, hostedAndroidDeviceName, hostedAndroidPlacements, hostedAndroidRecords, hostedAndroidStatus, hostedAppArea, hostedAppAttempt, hostedAppBlobs, hostedConsolePort, hostedDeviceId, hostedIosPlacements, hostedIosRecords, hostedIosStatus, hostedMacosAppSlot, hostedMacosBundleId, hostedMacosLogsDir, hostedMetroGateways, hostedMetroRequests, hostedNativeLogsDir, hostedNativeRecords, isJournalExpired, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, isSetupJournalPrunable, lastUseFrom, levelRank, linkReplacedArchives, listRecordedDevices, listSegments, listStatusCacheEntries, loadConfig, logFiles, machineCapacity, macosAppState, maintenanceAttemptFile, maintenanceChildLogFile, maintenanceDir, maintenanceNdjsonFile, maintenanceRunClaims, maintenanceStateFile, markerWindow, offloadSummary, openSegmentName, parseHostedAgentAccess, parseHostedAgentGrant, parseHostedAndroidDevice, parseHostedAndroidPlacement, parseHostedAppManifest, parseHostedAppOffer, parseHostedChoice, parseHostedDevice, parseHostedIosPlacement, parseHostedLocalDeviceCount, parseHostedLogsCursor, parseHostedMacosChoice, parseHostedMacosDevice, parseHostedMacosPlacement, parseHostedNativeOffer, parseHostedNativePlacement, parseHostedOfferRequest, parseHostedPlatformDevice, parseHostedRequest, parseMachine, parseMacosRecord, parseMaintenanceState, parseMissReason, parseNdjsonLine, parseNdjsonText, parseSetupJournal, parseSince, pinnedEndpoint, projectRootDirectories, pullRequestCacheDir, pullRequestCacheFile, queryJsonLogs, queryLogs, readAgentDeviceUsage, readAgentDeviceUsageCache, readAgentSessionsCache, readArchive, readArchiveState, readArchives, readBuildDetail, readBuildHistory, readBuildMachines, readCreatedDevices, readDevServerStop, readDevServerStopRequest, readDeviceHostMachines, readDeviceIdleShutdowns, readDevicePlacement, readDiskUsage, readDiskUsageFailure, readEasSessionLedger, readEndedAgentSessions, readHostedApp, readHostedAppMetadata, readHostedDevice, readHostedDeviceLedger, readHostedMacosApp, readHostedNativeLogsCheckpoint, readHostedSessions, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readLogTimeline, readLogsSince, readMacosRecord, readMaintenanceAttempt, readMaintenanceState, readNdjsonGenerations, readPullRequestCache, readRunEstimates, readSetupJournal, readStateFile, readStats, readStatsReport, readSwiftpmCacheUsage, readViewedDevices, readWarmRecord, readWorkspaceAgent, readWorkspaceState, recordMatches, recordedBytes, recordingDeviceName, recordingEnabled, rememberHostedAppBlobRename, requireAutomaticMachine, runId, saturation, serverSetupDir, settingDefinition, settingValueError, settingsJsonSchema, setupJournalFile, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, statsFile, statsProjectKey, stimBuildDigest, supervisorLogFile, supervisorPidFile, swiftpmCacheUsageFile, tailRead, trimCapacityRefusals, trimCapacityWaits, trimSamples, tryAcquireBuildSlotClaim, unreadableHostedAndroid, unreadableHostedIos, unreadableHostedNative, validEasSessionClaim, validHostedAppArguments, validHostedAppBlob, validRunId, validateAutomaticPool, wholePhases, withConfigLock, withDerivedFacts, withGitChip, withStateReadCache, workspaceAgentDeviceDir, workspaceBuildDetailFile, workspaceDerivedData, workspaceEndedAgentsFile, workspaceEndedAgentsLock, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceRecordingsDir, workspaceStateFile, workspaceStateLock };
+export { ACTIVITY_RECENCY_BASES, AGENT_TOOLS, ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, APP_PROCESS_STATES, BUILD_HISTORY_KEY, BUILD_HISTORY_LIMIT, BUILD_PHASES, BUILD_RESULTS, CAPACITY_REFUSAL_LIMIT, CAPACITY_REFUSAL_MAX_AGE_MS, DEBUG_ENV, DEVICE_HOST_LIMITS, DEVICE_IDLE_SHUTDOWN_KEY, DEVICE_RECLAIM_REASON, DEV_SERVER_STOP_REQUEST_KEY, ENDED_AGENT_RETENTION_MS, ERROR_SOURCES, HISTORY_LIMIT, HOSTED_AGENT_DRIVERS, HOSTED_APP_CHUNK_BYTES, HOSTED_LOGS_FIRST_BYTES, HOSTED_LOGS_PAGE_BYTES, HOSTED_MACOS_APP_SLOTS, HOSTED_METRO_GATEWAYS_KEY, HOSTED_METRO_REQUESTS_KEY, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, LAST_BUILD_KEYS, LEVELS, MACHINE_OWNER_KINDS, MAINTENANCE_LOG_NAME, MEMORY_SOURCES, NATIVE_BUILD_STEPS, NATIVE_CRASH_LOG_PREFIX, OFFLOAD_MODES, PHYSICAL_DEVICE_CONNECTIONS, PLACEMENT_DECISIONS, READY_PHASE_MS, RECORDING_CAP_BYTES, RECORDING_FOOTAGE_MS, RECORDING_PLATFORMS, REMOTE_DEVICE_BACKENDS, RUN_ID_ENV, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATS_VERSION, STATUS_ISSUE_CODES, TAILNET_MACHINE_PATTERN, TUNNEL_MODES, TUTORIAL_VERSION, WARM_KEY, WEB_PAGE_STATES, WEB_VIEWPORTS, WORKSPACE_AGENT_KEY, WORKSPACE_PHASES, WORKSPACE_STAGE_KINDS, acceptsShape, advanceTail, agentDeviceStateDirs, agentDeviceUsageFile, agentSessionOf, agentSessionsCacheFile, allMetroPorts, archiveDir, archiveEnabled, archiveLock, archiveRoot, archivedUsage, assertHostedDeviceLedger, attachExpoErrorContext, automaticMachineEnabled, buildCriteria, buildDiagnostics, buildMachinesFile, buildMachinesLock, buildSlotPath, buildSlotsDir, buildWorkerRoot, bundleMarkerPlatform, capDrops, closedSegmentName, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, countErrorEntries, createAgentActionReader, createDebugLog, createdDevicesFile, createdDevicesLock, debugLogDir, debugLoggingEnabled, decodeStats, deviceHostArea, deviceHostMachinesClaims, deviceHostMachinesFile, deviceHostMachinesLock, deviceHostRoot, deviceViewersDir, diskUsageCacheDir, diskUsageCacheFile, diskUsageFailureFile, diskUsageWalkClaims, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, endedAgentSessionOf, endpoint, expectedShape, fileSizes, findEnclosingWorktreeRoot, findPeer, findProjectByMetroPort, findProjectRoot, followLogs, footageDrops, getConcurrencyLimits, getConfigPath, getParkedMax, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, hostedAndroidDeviceName, hostedAndroidPlacements, hostedAndroidRecords, hostedAndroidStatus, hostedAppArea, hostedAppAttempt, hostedAppBlobs, hostedConsolePort, hostedDeviceId, hostedIosPlacements, hostedIosRecords, hostedIosStatus, hostedMacosAppSlot, hostedMacosBundleId, hostedMacosLogsDir, hostedMetroGateways, hostedMetroRequests, hostedNativeLogsDir, hostedNativeRecords, hostedWorkerSettleMs, isJournalExpired, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, isSetupJournalPrunable, lastUseFrom, levelRank, linkReplacedArchives, listRecordedDevices, listSegments, listStatusCacheEntries, loadConfig, logFiles, machineCapacity, macosAppState, maintenanceAttemptFile, maintenanceChildLogFile, maintenanceDir, maintenanceNdjsonFile, maintenanceRunClaims, maintenanceStateFile, markerWindow, offloadSummary, openSegmentName, parseHostedAgentAccess, parseHostedAgentGrant, parseHostedAndroidDevice, parseHostedAndroidPlacement, parseHostedAppManifest, parseHostedAppOffer, parseHostedChoice, parseHostedDevice, parseHostedIosPlacement, parseHostedLocalDeviceCount, parseHostedLogsCursor, parseHostedMacosChoice, parseHostedMacosDevice, parseHostedMacosPlacement, parseHostedNativeOffer, parseHostedNativePlacement, parseHostedOfferRequest, parseHostedPlatformDevice, parseHostedRequest, parseMachine, parseMacosRecord, parseMaintenanceState, parseMissReason, parseNdjsonLine, parseNdjsonText, parseSetupJournal, parseSince, pinnedEndpoint, projectRootDirectories, pullRequestCacheDir, pullRequestCacheFile, queryJsonLogs, queryLogs, readAgentDeviceUsage, readAgentDeviceUsageCache, readAgentSessionsCache, readArchive, readArchiveState, readArchives, readBuildDetail, readBuildHistory, readBuildMachines, readCreatedDevices, readDevServerStop, readDevServerStopRequest, readDeviceHostMachines, readDeviceIdleShutdowns, readDevicePlacement, readDiskUsage, readDiskUsageFailure, readEasSessionLedger, readEndedAgentSessions, readHostedApp, readHostedAppMetadata, readHostedDevice, readHostedDeviceLedger, readHostedMacosApp, readHostedNativeLogsCheckpoint, readHostedSessions, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readLogTimeline, readLogsSince, readMacosRecord, readMaintenanceAttempt, readMaintenanceState, readNdjsonGenerations, readPullRequestCache, readRunEstimates, readSetupJournal, readStateFile, readStats, readStatsReport, readSwiftpmCacheUsage, readViewedDevices, readWarmRecord, readWorkspaceAgent, readWorkspaceState, recordMatches, recordedBytes, recordingDeviceName, recordingEnabled, rememberHostedAppBlobRename, requireAutomaticMachine, runId, saturation, serverSetupDir, settingDefinition, settingValueError, settingsJsonSchema, setupJournalFile, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, statsFile, statsProjectKey, stimBuildDigest, supervisorLogFile, supervisorPidFile, swiftpmCacheUsageFile, tailRead, trimCapacityRefusals, trimCapacityWaits, trimSamples, tryAcquireBuildSlotClaim, unreadableHostedAndroid, unreadableHostedIos, unreadableHostedNative, validEasSessionClaim, validHostedAppArguments, validHostedAppBlob, validRunId, validateAutomaticPool, wholePhases, withConfigLock, withDerivedFacts, withGitChip, withStateReadCache, workspaceAgentDeviceDir, workspaceBuildDetailFile, workspaceDerivedData, workspaceEndedAgentsFile, workspaceEndedAgentsLock, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceRecordingsDir, workspaceStateFile, workspaceStateLock };