@stim-cli/core 1.26.0 → 1.28.0

package/dist/{index-CVIwytv5.d.mts → index-31SZcxv0.d.mts}

@@ -160,613 +160,690 @@ interface MachineCacheUsage {
 declare function machineCacheUsageFile(): string;
 declare function readMachineCacheUsage(): MachineCacheUsage | null;
 //#endregion
-//#region state/build-capacity.d.ts
-declare function buildSlotsDir(): string;
-declare function buildSlotPath(index: number): string;
+//#region state/hosted-app.d.ts
+interface HostedAppFile {
+  path: string;
+  kind: "file" | "exec" | "link";
+  size: number;
+  sha256: string;
+}
+interface HostedAppOffer {
+  session: string;
+  attempt: string;
+  bundleId: string;
+  mode: "development" | "release" | "process";
+  devClientScheme?: string;
+  arguments?: string[];
+  manifest: {
+    sha256: string;
+    size: number;
+  };
+}
+interface HostedAppDelivery extends Omit<HostedAppOffer, "manifest"> {
+  state: "receiving" | "installing" | "installed" | "unknown";
+  launched: true | "unverified" | null;
+  notice?: string;
+}
+interface HostedAppRecord extends HostedAppDelivery {
+  manifest: HostedAppOffer["manifest"];
+  files: HostedAppFile[];
+}
+declare const HOSTED_APP_CHUNK_BYTES: number;
+declare function hostedAppAttempt(value: unknown): value is string;
+declare function hostedAppArea(session: string, attempt: string, workerHome?: string): string;
+declare function hostedAppBlobs(session: string, workerHome?: string): string;
+/** Transfers cached verification after a rename, only for the same inode, size, mtime and digest. */
+declare function rememberHostedAppBlobRename(from: string, to: string, file: {
+  size: number;
+  sha256: string;
+}): void;
+/** Checks regular blob bytes, including their size, before content-addressed reuse. */
+declare function validHostedAppBlob(path: string, file: {
+  size: number;
+  sha256: string;
+}): boolean;
+/** At most 32 plain arguments of 1024 characters (8192 in total), with no NUL, CR or LF. */
+declare function validHostedAppArguments(value: unknown): value is string[];
+declare function parseHostedAppOffer(value: unknown): HostedAppOffer | null;
+/** Relative normalized paths, with no file or link as another entry's ancestor. */
+declare function parseHostedAppManifest(value: unknown): HostedAppFile[] | null;
+/** Reads a server-written receipt; malformed or missing established state remains unresolved. */
+declare function readHostedAppMetadata(session: string, attempt: string, workerHome?: string): Omit<HostedAppRecord, "files">;
+declare function readHostedApp(session: string, attempt: string, workerHome?: string): HostedAppRecord;
+//#endregion
+//#region state/hosted-macos.d.ts
+/** App slots one host offers; a slot names the host-assigned bundle id `<bundleId>.hosted<slot>`. */
+declare const HOSTED_MACOS_APP_SLOTS = 64;
+/** The drivers `hosting.agentDriver` can name: `none` and the first-party driver packages stim-server ships. */
+declare const HOSTED_AGENT_DRIVERS: readonly ["none", "agent-device"];
+type HostedAgentDriverName = (typeof HOSTED_AGENT_DRIVERS)[number];
+/** A driver name a grant or access record can carry; a client resolves only the drivers it knows. */
+declare function hostedAgentDriverName(value: unknown): value is string;
+/** What a host reports in a macOS offer: no simulator is created, so the choice is the host itself. */
+interface HostedMacosChoice {
+  architecture: "arm64" | "x86_64";
+  macosVersion: string;
+}
+/** A ready hosted macOS session's identity: the host it runs on and the app slot reserved for it. */
+interface HostedMacosDevice extends HostedMacosChoice {
+  appSlot: number;
+}
 /**
- * Takes the first free one of `max` `concurrency.maxBuilds` slots, recording `details` and the slot `index`. Returns
- * null while every slot is held; throws the claim refusal when no slot is busy but one cannot be resolved.
+ * The agent-device lease owner scope a client names on every request. `deviceKey` is `<bundleId>@<pid>`
+ * for a macOS app, or `ios:mobile:<udid>` with `backend: ios-instance` for a hosted simulator, or `android:mobile:<serial>` with `backend: android-instance` for a hosted emulator.
  */
-declare function tryAcquireBuildSlotClaim({ max, details }: {
-  max: number;
-  details: Record<string, unknown>;
-}): {
-  claim: ClaimHandle;
-  index: number;
-  path: string;
-} | null;
+interface HostedAgentLease {
+  tenant: string;
+  runId: string;
+  clientId: string;
+  deviceKey: string;
+  backend?: "ios-instance" | "android-instance";
+}
 /**
- * How busy this machine is for native builds. `loadPerCore` is the 5-minute load average divided by the CPU count,
- * rounded to one decimal. `builds` counts this Stim home's runs that hold a live native-run claim and are in
- * prebuild, pods or compile here, not on a remote machine, plus the build slots this machine holds for other machines'
- * offloaded builds. `maxBuilds` is `concurrency.maxBuilds`, 0 when unlimited.
+ * Agent control a driver issues for one installed hosted app. `path` is the session's base route on the host,
+ * `scope` the driver's handle that limits it to this one app, and `lease`, for a driver that allocates leases,
+ * the scope that pins the allocation.
  */
-interface MachineCapacity {
-  cpus: number;
-  loadPerCore: number;
-  builds: number;
-  maxBuilds: number;
-  maxLoadPerCore: number;
+interface HostedAgentIssuedGrant {
+  driver: string;
+  path: string;
+  token: string;
+  scope: string;
+  lease?: HostedAgentLease;
 }
-declare function machineCapacity(): MachineCapacity;
-/** Why a machine with this capacity should not take another native build; null when it can. */
-declare function saturation(capacity: MachineCapacity): string | null;
-//#endregion
-//#region state/build-machines.d.ts
 /**
- * What this machine keeps about a remote machine it asked for access. `machine` is the `remote.machines` entry and
- * `address` the name it resolved to. Once approved, `serverKey` is the worker's pinned stim-server key: every later
- * connection must prove it holds that key. While pending, `ticket` is the setup ticket this machine generated or was
- * given, and `expiresAt` its expiry when known. Records of protocol 1, which pinned a tailnet node, are not read.
+ * Agent control the host grants a client for one installed hosted app, sent only over that client's approved
+ * device-host connection and never journaled. `none` means the host's `hosting.agentDriver` starts no driver.
  */
-interface MachineCredential {
+type HostedAgentGrant = {
+  driver: "none";
+} | HostedAgentIssuedGrant;
+/** `app.launch` and `app.attach` results; a host includes `agent` once the app is installed. */
+type HostedAppLaunch = HostedAppDelivery & {
+  agent?: HostedAgentGrant;
+};
+/**
+ * Agent control as the client hands it to a coding agent: secrets stay in files Stim writes with mode
+ * 0600, and `command` shows how to address the hosted app. Never carries a token inline. `setting` names
+ * the hosting Mac's setting that turns a driver on.
+ */
+type HostedAgentAccess = {
+  driver: "none";
+  setting: "hosting.agentDriver";
+} | {
+  driver: string;
+  remoteConfig: string;
+  command: string;
+};
+/** Where a workspace's macOS app runs when `stim macos --remote` placed it on another Mac. */
+interface HostedMacosPlacement {
   machine: string;
-  transport: "tailscale";
-  address: string;
-  state: "pending" | "approved";
-  requestedAt: string;
-  serverKey?: string;
-  deviceId?: string;
-  ticket?: string;
-  expiresAt?: string;
+  session: string;
+  appSlot: number;
+  appAttempt: string;
+  /** The host-assigned id the running app uses, `hostedMacosBundleId(<offered id>, appSlot)`. */
+  bundleId: string;
+  agent: HostedAgentAccess;
 }
-type BuildMachineCredential = MachineCredential;
-declare const MACHINE_CREDENTIALS_VERSION = 2;
-/** A stored credential, or null when it is malformed or from an older version. */
-declare function parseMachineCredential(value: unknown): MachineCredential | null;
-declare function readBuildMachines(): BuildMachineCredential[];
-//#endregion
-//#region state/client-identity.d.ts
-/** This machine's long-term X25519 key as a client of other machines, in `$STIM_HOME/client-identity.key`. */
-declare function clientIdentity(): NoiseKeyPair;
+declare function hostedMacosAppSlot(value: unknown): value is number;
+declare function hostedMacosBundleId(bundleId: string, appSlot: number): string;
+declare function parseHostedMacosChoice(value: unknown): HostedMacosChoice | null;
+declare function parseHostedMacosDevice(value: unknown): HostedMacosDevice | null;
+/** A grant naming a driver this client does not know is not usable; it parses as null. */
+declare function parseHostedAgentGrant(value: unknown): HostedAgentGrant | null;
+declare function parseHostedAgentAccess(value: unknown): HostedAgentAccess | null;
+declare function parseHostedMacosPlacement(value: unknown): HostedMacosPlacement | null;
 //#endregion
-//#region state/config-types.d.ts
-type SettingsObject = Record<string, unknown>;
-interface SupervisorRecord {
-  processToken?: string;
-  pid?: number;
-  port?: number;
-  startedAt?: string;
-  serverPid?: number;
-  mode?: string;
-  [key: string]: unknown;
+//#region state/device-host.d.ts
+type HostedDevicePlatform = "ios" | "android" | "macos";
+/** Deadlines stim-server gives each hosted worker run. Clients derive their waits from these. */
+interface DeviceHostLimits {
+  prepareMs: number;
+  offerMs: number;
+  stopMs: number;
+  logsMs: number;
+  killGraceMs: number;
 }
-interface IosDeviceRecord {
-  deviceUdid?: string;
-  deviceName?: string | null;
-  owned?: boolean;
-  serial?: string;
-  simslimManaged?: boolean;
-  simslimApplied?: {
-    profile: string;
-    springBoardPid: number;
-  };
-  schemeApprovals?: string[];
-  [key: string]: unknown;
+declare const DEVICE_HOST_LIMITS: Readonly<DeviceHostLimits>;
+/** How many parked sessions one reserve inspects, and possibly retires, before it creates a device. */
+declare const HOSTED_PARKED_CANDIDATES: number;
+/** How long a cancelled hosted worker run can take to settle: SIGTERM, SIGKILL after the grace, then it is abandoned. */
+declare function hostedWorkerSettleMs(limits?: Pick<DeviceHostLimits, "killGraceMs">): number;
+interface HostedIosChoice {
+  deviceTypeId: string;
+  runtimeId: string;
+  deviceType: string;
+  runtime: string;
+  architecture: "arm64" | "x86_64";
 }
-interface AndroidDeviceRecord {
-  avdName?: string;
-  consolePort?: number;
-  serial?: string;
-  kind?: string;
-  deviceName?: string | null;
-  owned?: boolean;
-  setupIncomplete?: boolean;
-  bootPending?: boolean;
-  [key: string]: unknown;
+interface HostedIosDevice extends HostedIosChoice {
+  udid: string;
+  name: string;
 }
-type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
-interface PlatformRecords {
-  ios?: IosDeviceRecord;
-  android?: AndroidDeviceRecord;
-  [platform: string]: DeviceRecord | undefined;
+interface HostedAndroidChoice {
+  systemImage: string;
+  deviceProfile: string;
+  architecture: "arm64-v8a" | "x86_64";
 }
-interface ProjectRecord {
-  ports?: Record<string, number>;
-  metroPort?: number | null;
-  platforms?: PlatformRecords;
-  deviceSlots?: Record<string, PlatformRecords>;
-  supervisor?: SupervisorRecord;
-  settings?: SettingsObject;
-  worktreeRoot?: boolean;
-  worktreeBranch?: string;
-  worktreeBranchOwned?: boolean;
-  worktreeMainRoot?: string;
-  worktreeRemovalComplete?: boolean;
-  worktreePendingBranchSha?: string;
-  label?: string;
-  bundleId?: string;
-  androidPackage?: string;
-  isExpo?: boolean;
-  lastBuild?: Record<string, unknown>;
-  doctorRuns?: Partial<Record<"ios" | "android", DoctorRunRecord>>;
-  [key: string]: unknown;
-}
-interface DoctorRunRecord {
-  at: string;
-  version: string;
+interface HostedAndroidDevice extends HostedAndroidChoice {
+  avdName: string;
+  serial: string;
+  consolePort: number;
 }
-interface RepoRecord {
-  settings?: SettingsObject;
-  [key: string]: unknown;
+type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
+interface HostedDeviceSelectors {
+  deviceType?: string;
+  runtime?: string;
+  systemImage?: string;
+  deviceProfile?: string;
 }
-interface ConcurrencyLimits {
-  maxBuilds: number;
-  maxDevices: number;
+interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
+  platform: HostedDevicePlatform;
 }
-interface StimConfig {
-  version?: number;
-  homeId?: string;
-  projects: Record<string, ProjectRecord>;
-  repos: Record<string, RepoRecord>;
-  tempDir?: unknown;
-  iosSimulatorApp?: unknown;
-  androidEmulatorApp?: unknown;
-  optimizations?: unknown;
-  concurrency?: {
-    maxBuilds?: unknown;
-    maxDevices?: unknown;
+type HostedNativeOffer = {
+  resources: {
+    cpus: number;
+    /** Five-minute system load divided by available CPU count. */
+    loadPerCore: number;
+    maxLoadPerCore?: number;
+    memoryFreeBytes: number;
+    memoryPressure: "normal" | "warning" | "critical" | null;
+    /** Available bytes on the Stim home volume, not necessarily the Android AVD volume. */
+    workerDiskFreeBytes: number | null;
+    localDevices?: number | {
+      unknown: string;
+    };
   };
-  pool?: {
-    iosParkedMax?: unknown;
-    androidParkedMax?: unknown;
+  declined: string | null;
+} & ({
+  platform: "ios";
+  choice: HostedIosChoice | null;
+} | {
+  platform: "android";
+  choice: HostedAndroidChoice | null;
+} | {
+  platform: "macos";
+  choice: HostedMacosChoice | null;
+});
+type HostedDeviceOffer = HostedNativeOffer & {
+  capacity: {
+    running: number;
+    max: number;
+    available: number | null;
+    local?: number | {
+      unknown: string;
+    };
   };
+};
+interface HostedDeviceRequest extends HostedDeviceOfferRequest {
+  workspace: string;
+  slot: string;
+  attempt: string;
+}
+type HostedDevicePhase = "preparing" | "ready" | "stopping" | "stopped" | "unknown";
+interface HostedDeviceSession extends HostedDeviceRequest {
+  id: string;
+  client: string;
+  state: HostedDevicePhase;
+  device: HostedDevice | null;
+  consolePort?: number;
+  appSlot?: number;
+  createdAt: string;
   parked?: {
-    ios?: unknown;
-    android?: unknown;
-  };
-  caches?: {
-    buildCache?: unknown;
-    metroCache?: unknown;
-  };
-  hosting?: {
-    agentDriver?: unknown;
-  };
-  debug?: {
-    logs?: unknown;
-  };
-  server?: {
-    buildsPaused?: unknown;
-    devicesPaused?: unknown;
-    acceptClientBuilds?: unknown;
-    maxLoadPerCore?: unknown;
-    workerRoot?: unknown;
-    gradleDaemonIdleMinutes?: unknown;
-  };
-  remote?: {
-    machines?: unknown;
-    easMaxDurationMinutes?: unknown;
-    build?: unknown;
-    buildMode?: unknown;
-    buildPoolDisabled?: unknown;
-    devicePoolDisabled?: unknown;
+    at: string;
   };
-  [key: string]: unknown;
+  notice?: string;
+  appAttempt?: string;
+  agent?: HostedAgentGrant;
+  metroPort?: number;
+  clientMetroPort?: number;
 }
-type Config = StimConfig;
-//#endregion
-//#region state/automatic-pools.d.ts
-type AutomaticPoolRole = "build" | "device";
-declare function automaticMachineEnabled(role: AutomaticPoolRole, machine: string, config?: StimConfig | null): boolean;
-declare function requireAutomaticMachine(role: AutomaticPoolRole, machine: string): void;
-/**
- * Refuses a pool with no enabled member: local, or a configured remote approved for the role. `canHost` excludes
- * device-pool remotes that can never host, such as a Linux machine.
- */
-declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig, canHost?: (machine: string) => boolean): void;
+declare function deviceHostRoot(): string;
+declare function deviceHostArea(id: string): string;
+declare function parseHostedChoice(value: unknown): HostedIosChoice | null;
+declare function parseHostedDevice(value: unknown): HostedIosDevice | null;
+declare function parseHostedAndroidDevice(value: unknown): HostedAndroidDevice | null;
+/** Android Emulator -help-port defines the supported even console ports as 5554 through 5584. */
+declare function hostedConsolePort(value: unknown): value is number;
+declare function parseHostedPlatformDevice(value: unknown, platform: HostedDevicePlatform): HostedDevice | null;
+declare function hostedDeviceId(device: HostedDevice): string;
+declare function parseHostedRequest(value: unknown): HostedDeviceRequest | null;
+declare function parseHostedOfferRequest(value: unknown): HostedDeviceOfferRequest | null;
+declare function parseHostedLocalDeviceCount(value: unknown): number | {
+  unknown: string;
+} | null;
+declare function parseHostedNativeOffer(value: unknown): HostedNativeOffer | null;
+/** A missing established journal or malformed record is a refusal, never an empty reservation set. */
+declare function readHostedSessions(): HostedDeviceSession[];
+/** The private worker's exact device record; an absent record is unresolved after creation started. */
+declare function readHostedDevice(home: string): HostedIosDevice;
+declare function readHostedDevice(home: string, platform: "android"): HostedAndroidDevice;
+declare function readHostedDevice(home: string, platform: "macos"): HostedMacosDevice;
+declare function readHostedDevice(home: string, platform: HostedDevicePlatform): HostedDevice;
+declare function readHostedDeviceLedger(home: string, options?: {
+  required?: boolean;
+}): {
+  ios: string[];
+  android: string[];
+  web: string[];
+} | null;
+/** Hosted sessions use isolated homes: only one exact device of their platform may appear in this ledger. */
+declare function assertHostedDeviceLedger(home: string, id: string, platform?: HostedDevicePlatform, options?: {
+  allowEmpty?: boolean;
+}): "listed" | "empty";
 //#endregion
-//#region state/config.d.ts
-declare function withConfigLock<T>(fn: () => T): T;
-/** Waits for the config lock without blocking the event loop. The signal cancels acquisition; `fn` runs synchronously. */
-declare function withConfigLockAsync<T>(fn: () => T, signal?: AbortSignal): Promise<T>;
-declare function configCorruptRepair(path?: string): string;
-/** The build worker root: `server.workerRoot` when it is absolute, else `$STIM_HOME/build-worker`. */
-declare function buildWorkerRoot(config?: Config | null): string;
-/**
- * A short directory at the drive root that stands in for the build worker directory `path` on Windows. The NDK's
- * ninja is not long-path aware (STIM_PATH_TOO_LONG), and it opens paths under the checkout and under the Gradle user
- * home's transforms cache, both of which are too long under the worker root. A subst drive does not help: Node's
- * native realpath, which expo-modules-autolinking uses, resolves it back to the long path.
- */
-declare function windowsShortDir(path: string, systemDrive?: string): string;
-/** The ASCII key a Windows build worker records beside a `windowsShortDir` to tell which `kind` and `path` it serves. */
-declare function windowsShortDirKey(kind: "checkout" | "gradle", path: string): string;
-declare function loadConfig(): Config | null;
-declare function getProject(projectPath: string): ProjectRecord | null;
-declare function getConcurrencyLimits({ env }?: {
-  env?: NodeJS.ProcessEnv;
-}): ConcurrencyLimits;
-interface ParkedMax {
-  max: number;
-  error: string | null;
+//#region state/workspace-state.d.ts
+interface WorkspaceState {
+  supervisor?: Record<string, unknown>;
+  collectors?: Record<string, unknown>;
+  lastBuild?: Record<string, unknown>;
+  launches?: Record<string, unknown>;
+  remoteDevice?: Record<string, unknown>;
+  metroTunnel?: Record<string, unknown>;
+  [key: string]: unknown;
 }
-declare function getParkedMax(platform: "ios" | "android", { config, env }?: {
-  config?: Config | null;
-  env?: NodeJS.ProcessEnv;
-}): ParkedMax;
-declare function getProjectSettings(projectPath: string): Record<string, unknown>;
-declare function getRepoSettings(gitCommonDir: string): Record<string, unknown>;
-declare function isPathPrefix(prefix: string, path: string): boolean;
-declare function findEnclosingWorktreeRoot(projectPath: string): string | null;
-declare function allMetroPorts(): number[];
-//#endregion
-//#region state/debug-log.d.ts
-declare const DEBUG_ENV = "STIM_DEBUG";
-declare function debugLogDir(): string;
-/** The `STIM_DEBUG` override (1/true on, 0/false off, anything else off), else the machine setting `debug.logs`. Never throws. */
-declare function debugLoggingEnabled(env?: NodeJS.ProcessEnv): boolean;
-interface DebugLog {
-  /** Whether debug logging is on right now; re-read every few seconds so a long-running process follows the setting. */
-  enabled(): boolean;
-  /** Appends one record to `$STIM_HOME/logs/debug/<component>.ndjson` when enabled. Never throws; keys that look like secrets are redacted. */
-  log(event: string, fields?: Record<string, unknown>): void;
+declare const IDLE_STOP_KEY = "devServerStop";
+/** Why the supervisor last stopped the dev server on its own: `metro.idleStopMinutes` with no use. */
+interface IdleStopRecord {
+  reason: "idle";
+  at: string;
+  idleMinutes: number;
+}
+declare function readIdleStop(state: WorkspaceState | null | undefined): IdleStopRecord | null;
+declare const DEVICE_RECLAIM_REASON = "reclaimed for a waiting run";
+declare const DEVICE_IDLE_SHUTDOWN_KEY = "deviceIdleShutdowns";
+/** An owned simulator or emulator shut down after being idle. */
+interface DeviceIdleShutdownRecord {
+  at: string;
+  idleMinutes: number;
+  reason?: string;
+}
+/** The recorded idle shutdowns by device slot key (`ios`, `android`, `ios:<slot>`). */
+declare function readDeviceIdleShutdowns(state: WorkspaceState | null | undefined): Record<string, DeviceIdleShutdownRecord>;
+declare const DEV_SERVER_STOP_REQUEST_KEY = "devServerStopRequest";
+/** A Stim component's intent to stop the supervisor with `processToken`, written before it signals. */
+interface DevServerStopRequest {
+  processToken: string;
+  by: string;
+  pid: number;
+  at: string;
+  workspace?: string;
 }
+declare function readDevServerStopRequest(state: WorkspaceState | null | undefined): DevServerStopRequest | null;
 /**
- * Debug-level records for one component (`cli` or `server`). Off by default; `STIM_DEBUG=1` or `debug.logs` turns it
- * on. Callers pass names, durations and codes, never arguments, environment values, tokens or tickets.
+ * Why the dev server last stopped, stored under `IDLE_STOP_KEY`. `requested` names the Stim component that
+ * asked; `signal` is a SIGTERM or SIGINT no Stim component asked for; `server-exited` is the dev server
+ * process exiting on its own.
  */
-declare function createDebugLog(component: "cli" | "server", { env, now, base }?: {
-  env?: NodeJS.ProcessEnv;
-  now?: () => number;
-  base?: () => Record<string, unknown>;
-}): DebugLog;
-//#endregion
-//#region state/home-identity.d.ts
-/** The persistent, nonsecret identity of this Stim home; null until the CLI initializes it. */
-declare function readHomeIdentity(config?: Config | null): string | null;
-//#endregion
-//#region state/json-file.d.ts
+type DevServerStopRecord = IdleStopRecord | {
+  reason: "requested";
+  at: string;
+  by: string;
+  byPid: number;
+  byWorkspace?: string;
+} | {
+  reason: "signal";
+  at: string;
+  signal: string;
+} | {
+  reason: "server-exited";
+  at: string;
+  mode: string;
+  code: number | null;
+  signal: string | null;
+};
+/** A stopped dev server's last cause in status; `vanished` is a supervisor proven gone that recorded none. */
+type MetroLastStop = DevServerStopRecord | {
+  reason: "vanished";
+  pid: number;
+  startedAt: string | null;
+};
+declare function readDevServerStop(state: WorkspaceState | null | undefined): DevServerStopRecord | null;
+/** Each platform's latest run; `lastBuild` holds whichever platform ran last. */
+declare const LAST_BUILD_KEYS: Readonly<Record<StatsPlatform, string>>;
+declare const BUILD_HISTORY_KEY = "buildHistory";
+declare const BUILD_HISTORY_LIMIT = 10;
+/** A recorded miss reason in the shape status reports, without `baseline.cacheKey`; null when malformed. */
+declare function parseMissReason(value: unknown): BuildMissReason | null;
 /**
- * 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.
+ * The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
+ * ones with a source position first.
  */
-declare function withStateReadCache<T>(fn: () => T): T;
-declare function readStateFile(path: string): string;
-declare function readJsonFile(path: string): unknown;
-declare function isJsonObject(value: unknown): value is Record<string, unknown>;
-declare function readJsonObject(path: string): Record<string, unknown> | null;
-//#endregion
-//#region state/ledgers.d.ts
-type CreatedDevicePlatform = "ios" | "android" | "web";
-/** `web` lists the absolute paths of browser profile directories Stim created. */
-interface CreatedDevices {
-  ios: ReadonlySet<string>;
-  android: ReadonlySet<string>;
-  web: ReadonlySet<string>;
-}
-declare function readCreatedDevices(): CreatedDevices;
-interface EasSessionClaim {
-  sessionId: string;
-  name: string;
-  platform: "ios" | "android";
-  workspaceRoot: string;
-  workspaceHome: string;
-  stateFile: string;
-}
-interface EasSessionLedgerRead {
-  claims: Map<string, EasSessionClaim>;
-  notice: string | null;
-  safe: boolean;
-}
-/** Returns the claim normalized to canonical paths, or null when it is not a valid claim for `id`. */
-declare function validEasSessionClaim(id: string, value: unknown): EasSessionClaim | null;
-declare function readEasSessionLedger(root?: string): EasSessionLedgerRead;
-//#endregion
-//#region state/error-entries.d.ts
+declare function buildDiagnostics(value: unknown): BuildDiagnostic[];
+declare function readDevicePlacement(state: WorkspaceState | null, platform: StatsPlatform, slot?: string): DevicePlacement | null;
+declare function readLastBuilds(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, LastBuildReport>>;
+/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+declare function readBuildHistory(state: WorkspaceState | null | undefined): Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
+declare function readWorkspaceState(root: string): WorkspaceState | null;
+declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
 /**
- * The number of rows a log list shows for `records`, an error query's result in log order. Stim Desktop's
- * `LogEntryList` and the phone's `groupRecords` group the same way and replay the same vectors: in Expo's dev
- * server one failed bundle is a `Bundling failed` marker line, the error line and a failed bundle response,
- * which the apps list as one row, and every other record is its own row.
+ * When an ios, android or macos run last finished in the workspace, from its recorded builds (a cache hit counts),
+ * in epoch milliseconds; NaN when it records none. Dev server starts, reloads and logs do not count.
  */
-declare function countErrorEntries(records: readonly NdjsonRecord[]): number;
-//#endregion
-//#region state/fingerprint-memo.d.ts
-declare const FINGERPRINT_MEMO_SCHEMA = 1;
-/** Full native fingerprints shared by every workspace of this Stim home, one file per platform and static digest. */
-declare function fingerprintMemoDir(platform?: string): string;
-declare function fingerprintMemoFile(platform: string, digest: string): string;
-declare function fingerprintMemoLock(): string;
-/** The full fingerprint a tree with this static digest produced, written by the CLI. */
-interface FingerprintMemoRecord {
-  schema: typeof FINGERPRINT_MEMO_SCHEMA;
-  platform: string;
-  digest: string;
-  recordedAt: number;
-  hash: string;
-  sources: unknown[];
-  /** The packages the static check counted as native, to name the ones a disagreeing check found it missed. */
-  nativePackages: string[];
-}
-declare function readFingerprintMemo(platform: string, digest: string): FingerprintMemoRecord | null;
-//#endregion
-//#region state/logs-query.d.ts
-interface SinceResult {
-  ms?: number;
-  error?: string;
-}
-interface GrepResult {
-  re?: RegExp;
-  error?: string;
-}
-interface MarkerWindow {
-  launchTs: number | null;
-  bundleTs: number | null;
-  pageLoadTs: number | null;
-}
-interface QueryCriteria {
-  slot?: string;
-  includeAppDeviceErrors?: boolean;
-  sources?: string[];
-  minLevel?: string;
-  grep?: RegExp;
-  sinceTs?: number;
-  errorsOnly?: boolean;
-  markerTs?: number;
-  bundleMarkerTs?: number;
-}
-interface TailState {
-  offset: number;
-  partial: string;
-}
-declare function parseSince(text: unknown): SinceResult;
-declare function compileGrep(pattern: unknown): GrepResult;
-declare const ERROR_SOURCES: string[];
-declare function markerWindow(records: NdjsonRecord[]): MarkerWindow;
+declare function lastNativeUseFrom(state: WorkspaceState | null): number;
+declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
 /**
- * The platform a bundle marker speaks for, lowercased: its `platform` field, or the tag @expo/cli prints before
- * "Bundled" ("iOS", "Android", "Web", "RSC(iOS)" as ios, or an environment tag such as "DOM"). Null when unknown.
+ * When the workspace was last used, in epoch milliseconds. A workspace that recorded no use falls back to the mtime
+ * of its workspace.json, which is written once when the workspace is created, so it is a lower bound on the last
+ * use. NaN when its state.json exists but does not parse, or when workspace.json cannot be read either.
  */
-declare function bundleMarkerPlatform(record: NdjsonRecord): string | null;
-declare function recordMatches(record: NdjsonRecord | null | undefined, criteria?: QueryCriteria): boolean;
-declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now }?: {
-  slot?: string;
-  sources?: string[];
-  minLevel?: string;
-  since?: string | null;
-  grep?: string | RegExp | null;
-  errorsOnly?: boolean;
-  markerTs?: number;
-  bundleMarkerTs?: number;
-  now?: number;
-}): QueryCriteria;
-declare function logFiles(dir: string): string[];
-declare function fileSizes(dir: string): Record<string, number>;
-declare function readLogRecords(dir: string, include?: (name: string) => boolean): NdjsonRecord[];
-declare const NATIVE_CRASH_LOG_PREFIX = "native-crash-";
-/** Reads the CLI timeline with retained native crash records after other records at the same timestamp. */
-declare function readLogTimeline(dir: string, records?: NdjsonRecord[]): NdjsonRecord[];
-declare function isExpoErrorContext(record: NdjsonRecord, event: unknown): boolean;
-type ExpoContextTarget = "msg" | "field";
+declare function workspaceLastUsed(root: string): number;
+declare const WARM_KEY = "warm";
+/** How long a successful warm keeps a workspace `ready` when nothing runs in it. */
+declare const READY_PHASE_MS: number;
 /**
- * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
- * `msg` or as a `context` string array.
+ * What `stim worktree warm` last recorded in a workspace: a warm in progress, held by the ownership claim
+ * `claim` names, or a successful warm that finished at `at`.
  */
-declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
-interface LogQueryOptions {
-  slot?: string;
-  sources?: string[];
-  minLevel?: string;
-  since?: string;
-  grep?: string | RegExp;
-  errorsOnly?: boolean;
-  now?: number;
-}
-interface LogQueryPlan {
-  /** Whether a record belongs to the queried slot's timeline, before any other filter. */
-  inTimeline: (record: NdjsonRecord) => boolean;
-  matches: (record: NdjsonRecord) => boolean;
-  launchTs: number | null;
-  sinceTs: number | undefined;
-  /**
-   * Whether no record with a timestamp at most `maxTs`, or without one when `maxTs` is Infinity, can match.
-   * `slots` lists every `slot ?? 'default'` value the records can carry; without it, a query that depends on
-   * per-slot launch markers cannot rule out any timestamp.
-   */
-  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
-}
-/** Decides which records a query matches from the timeline's marker records alone. */
-declare function planLogQuery(markers: readonly NdjsonRecord[], { slot, sources, minLevel, since, grep, errorsOnly, now }?: LogQueryOptions): LogQueryPlan;
-declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: LogQueryOptions & {
-  dir?: string;
-  records?: NdjsonRecord[];
-  tail?: number;
-  errorContext?: boolean;
-}): NdjsonRecord[];
-/** Queries the JSON timeline, including Expo context fields on errors as `stim logs --json` does. */
-declare function queryJsonLogs(options?: Parameters<typeof queryLogs>[0]): NdjsonRecord[];
-declare function tailRead(prev: TailState | null | undefined, size: number): {
-  start: number;
-  prev: TailState;
-};
-declare function advanceTail(prev: TailState | null | undefined, chunk: string | null | undefined, size: number): {
-  state: TailState;
-  records: NdjsonRecord[];
+type WarmRecord = {
+  phase: "warming";
+  step: WarmStep;
+  startedAt: string;
+  claim: {
+    root: string;
+    claimId: string;
+  };
+} | {
+  phase: "ready";
+  at: string;
 };
-declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, identities: seededIdentities, errorContext }: {
-  dir: string;
-  onRecord: (record: NdjsonRecord) => void;
-  criteria?: QueryCriteria;
-  /** An explicit polling interval. Omit for filesystem hints with a ten-second repair scan. */
-  intervalMs?: number;
-  offsets?: Record<string, number> | null;
-  /** `fileIdentity` of each file `offsets` was read from, so a replacement made since is recognized. */
-  identities?: Record<string, string> | null;
-  /** Holds each Expo error until its code frame and stack stop growing, then attaches them. */
-  errorContext?: ExpoContextTarget;
-}): () => void;
-declare function fileIdentity(stat: BigIntStats): string | undefined;
-declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
-//#endregion
-//#region state/log-reader.d.ts
-interface LogDirQuery extends LogQueryOptions {
-  tail?: number;
-  /** Records from outside the directory, such as agent-device actions; they follow its records at equal timestamps. */
-  extra?: readonly NdjsonRecord[];
-}
+declare function readWarmRecord(state: WorkspaceState | null | undefined): WarmRecord | null;
+declare const WORKSPACE_AGENT_KEY = "agentSession";
 /**
- * An indexed view of a workspace log directory, read in timestamp order without loading whole files. Each file
- * generation is indexed once per process (block timestamp bounds, markers, slots and launch attempts) and later
- * views read only what was appended since. Close it to release the open files.
+ * The coding-agent session whose shell ran the Stim command that last recorded `lastUsedAt`, with that command's
+ * working directory as `cwd` and its time as `lastActiveAt`.
  */
-interface LogDir {
-  /** Bytes read from each current `.ndjson` file, through its last complete line. */
-  readonly sizes: Record<string, number>;
-  /** `fileIdentity` of each current `.ndjson` file that `sizes` was read from. */
-  readonly identities: Record<string, string>;
-  /** The oldest timestamp in the directory. */
-  readonly firstTs: number | undefined;
-  /** Launch attempt records outside native crash files, in timeline order. */
-  launchAttempts(): NdjsonRecord[];
-  /** The records `queryJsonLogs` returns for this directory's timeline followed by `extra`. */
-  query(query?: LogDirQuery): Promise<NdjsonRecord[]>;
-  /** Every matching record in timestamp order, in batches of at most 500, with the same filters and context as query. */
-  batches(query?: Omit<LogDirQuery, "tail">): AsyncIterable<NdjsonRecord[]>;
-  /** Prepares the directory marker predicate for records without markers, such as attributed agent actions. */
-  filter(query?: LogQueryOptions): (record: NdjsonRecord) => boolean;
-  close(): Promise<void>;
+declare function readWorkspaceAgent(state: WorkspaceState | null | undefined): AgentSession | null;
+//#endregion
+//#region state/hosted-native.d.ts
+interface HostedNativePlacement<D> {
+  machine: string;
+  session: string;
+  appAttempt: string;
+  device: D | null;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
 }
-/**
- * Opens `dir` for reading. With `order: 'timeline'`, native crash files follow every other file at equal
- * timestamps, as `readLogTimeline` orders them; with `'name'`, every file is ranked by name, as `readLogRecords`.
- */
-declare function openLogDir(dir: string, { order, signal }?: {
-  order?: "timeline" | "name";
-  signal?: AbortSignal;
-}): Promise<LogDir>;
+declare function parseHostedNativePlacement(value: unknown, platform: "ios"): HostedNativePlacement<HostedIosDevice> | null;
+declare function parseHostedNativePlacement(value: unknown, platform: "android"): HostedNativePlacement<HostedAndroidDevice> | null;
+declare function parseHostedNativePlacement(value: unknown, platform: "ios" | "android"): HostedNativePlacement<HostedIosDevice | HostedAndroidDevice> | null;
+declare function hostedNativeRecords(state: WorkspaceState | null, platform: "ios" | "android"): Record<string, unknown>;
+declare function unreadableHostedNative(slot: string, platform: "ios" | "android"): string;
 //#endregion
-//#region state/paths.d.ts
-declare function getConfigPath(): string;
-declare function configLockPath(): string;
-declare function workspaceMetadataFile(projectRoot: string): string;
-declare function workspaceAgentDeviceDir(projectRoot: string): string;
-declare function workspaceLogsDir(projectRoot: string): string;
-/** Device screen footage stim-server records for the workspace, one directory per platform and slot. */
-declare function workspaceRecordingsDir(projectRoot: string): string;
-declare function workspaceLogErrorIndex(projectRoot: string): string;
-declare function workspaceDerivedData(projectRoot: string): string;
-declare function workspaceGradleBuild(projectRoot: string): string;
-declare function workspaceBuildDetailFile(projectRoot: string): string;
-/** The agent sessions that stopped running in the workspace in the last `ENDED_AGENT_RETENTION_MS`. */
-declare function workspaceEndedAgentsFile(projectRoot: string): string;
-declare function workspaceEndedAgentsLock(projectRoot: string): string;
-declare function supervisorPidFile(projectRoot: string): string;
-declare function workspaceStateFile(projectRoot: string): string;
-declare function workspaceStateLock(projectRoot: string): string;
-declare function supervisorLogFile(projectRoot: string): string;
-declare function emulatorLogFile(projectRoot: string): string;
-declare function sharedCompilationCache(): string;
-declare function sharedCcache(): string;
-declare function sharedGradle(): string;
-declare function sharedPods(): string;
-declare function createdDevicesFile(): string;
-declare function gitMergeCacheDir(): string;
-declare function pullRequestCacheDir(): string;
-declare function agentSessionsCacheFile(): string;
-declare function diskUsageCacheDir(): string;
-/** The ownership claim root that admits one disk-usage walk at a time on this machine. */
-declare function diskUsageWalkClaims(): string;
-/** The remote machines this machine asked for build access, each with its pinned stim-server key once approved. */
-declare function buildMachinesFile(): string;
-declare function buildMachinesLock(): string;
-/** The remote machines this machine asked for access, separate from build credentials. */
-declare function deviceHostMachinesFile(): string;
-declare function deviceHostMachinesLock(): string;
-declare function deviceHostMachinesClaims(): string;
-declare function createdDevicesLock(): string;
-/** The EAS session ledger lives under the real home directory, never under STIM_HOME. */
-declare function easMachineStateRoot(): string;
-declare function easSessionLedgerFile(root?: string): string;
-declare function easSessionLedgerLock(root?: string): string;
-/** Where stim-server records, one file per server process, the devices whose frames a client subscribes to. */
-declare function deviceViewersDir(): string;
-declare function statsFile(): string;
-declare function maintenanceDir(): string;
-declare function maintenanceStateFile(): string;
-declare function maintenanceAttemptFile(): string;
-declare function maintenanceNdjsonFile(): string;
-declare function gcLogDir(): string;
-declare function gcLogFile(): string;
-declare function maintenanceChildLogFile(): string;
-declare function maintenanceRunClaims(): string;
-/** Dependency trees `worktree remove` moved out of a worktree before git removed it; gc deletes what is left. */
-declare function trashRoot(): string;
-declare function archiveRoot(): string;
-declare function archiveDir(id: string): string;
-declare function archiveLock(): string;
-/** This machine's own long-term X25519 key as a client of other machines' stim-servers. */
-declare function clientIdentityKeyFile(): string;
-/**
- * The local Unix socket. sun_path permits 103 UTF-8 bytes on macOS and 107 on Linux. Longer paths use
- * /tmp/stim-sockets-<uid>/<SHA-256 of the normalized absolute socket path>.sock.
- */
-declare function serverLocalSocket(): string;
-declare function serverSetupDir(): string;
-declare function setupJournalFile(hash: string): string | null;
+//#region state/hosted-android.d.ts
+/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
+interface HostedAndroidPlacement extends HostedNativePlacement<HostedAndroidDevice> {}
+/** Public hosting facts; the host's serial, AVD name and private Metro links are excluded. */
+type HostedAndroidStatus = {
+  machine: string;
+  session: string;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
+  device: {
+    name: string;
+    systemImage: string;
+    api: number;
+  } | null;
+  /** The latest session probe in status, independent of a conflicting local emulator's state. */
+  state?: string;
+};
+declare function parseHostedAndroidPlacement(value: unknown): HostedAndroidPlacement | null;
+declare function hostedAndroidStatus(placement: HostedAndroidPlacement): HostedAndroidStatus;
+declare function hostedAndroidRecords(state: WorkspaceState | null): Record<string, unknown>;
+declare function unreadableHostedAndroid(slot: string): string;
+declare function hostedAndroidPlacements(state: WorkspaceState | null): Record<string, HostedAndroidPlacement>;
+declare function hostedAndroidDeviceName(device: HostedAndroidDevice): string;
 //#endregion
-//#region state/recordings.d.ts
-/** The footage stim-server keeps per device: the last 15 minutes recorded, however long ago. */
-declare const RECORDING_FOOTAGE_MS: number;
-/** The recordings of every workspace of one Stim home together; past it the oldest footage goes first. */
-declare const RECORDING_CAP_BYTES: number;
-/** The platforms stim-server records: owned simulators and emulators, and the Stim-owned Chrome page. */
-declare const RECORDING_PLATFORMS: readonly ["ios", "android", "web"];
-type RecordingPlatform = (typeof RECORDING_PLATFORMS)[number];
+//#region state/hosted-ios.d.ts
+/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
+interface HostedIosPlacement extends HostedNativePlacement<HostedIosDevice> {}
+/** Public hosting facts; the host's UDID and private Metro links are excluded. */
+type HostedIosStatus = {
+  machine: string;
+  session: string;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
+  device: {
+    name: string;
+    runtime: string;
+  } | null;
+  /** The latest session probe in status, independent of a conflicting local simulator's state. */
+  state?: string;
+};
+declare function parseHostedIosPlacement(value: unknown): HostedIosPlacement | null;
+declare function hostedIosStatus(placement: HostedIosPlacement): HostedIosStatus;
+declare function hostedIosRecords(state: WorkspaceState | null): Record<string, unknown>;
+declare function unreadableHostedIos(slot: string): string;
+declare function hostedIosPlacements(state: WorkspaceState | null): Record<string, HostedIosPlacement>;
+//#endregion
+//#region state/maintenance.d.ts
+type MaintenanceMode = "off" | "report" | "on";
+type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep" | "idle";
+type MaintenanceActionKind = "would-clear-outputs" | "would-trim-cache" | "would-empty-cache" | "would-shutdown-device" | "would-stop-workspace" | "would-remove-worktree" | "would-remove-orphan" | "would-unregister-cache" | "would-delete-parked-device" | "would-delete-devices" | "would-clear-build-dirs" | "would-delete-dependencies" | "would-stop-gradle-daemons" | "would-delete-gradle-version" | "would-delete-temp-leftovers";
+/** Disk pressure: 0 above every threshold, 1 under the budget floor, 2 under the urgent threshold, 3 under the critical threshold or the hard floor. */
+type DiskPressureLevel = 0 | 1 | 2 | 3;
+interface MaintenanceAction {
+  kind: MaintenanceActionKind;
+  target: string;
+  bytes: number;
+  reason: string;
+  workspace?: string;
+  dir?: string;
+  olderThanDays?: number;
+  check?: "worktree" | "sweep" | "disk";
+  /** The disk pressure level that planned the action; it runs only while free disk stays under that level's floor. */
+  level?: 2 | 3;
+}
+interface MaintenanceSize {
+  name: string;
+  dir: string;
+  bytes: number;
+  measuredAt: number;
+  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "owned-devices" | "other";
+  workspace?: string;
+  idleDays?: number | null;
+  blocked?: string;
+}
 /**
- * One file of H.264 footage. A closed segment is named `<start>-<end>.seg`, in epoch milliseconds of its first and
- * last access unit; the segment being written is `<start>.part`, and its end is its modification time.
+ * A process whose physical footprint, as `top` reports it, is abnormally large. `command` is the one command that
+ * safely restarts or stops it, null when Stim knows none; `note` says what that command does.
  */
-interface RecordedSegment {
-  file: string;
-  start: number;
-  end: number;
+interface MemoryCulprit {
+  pid: number;
+  name: string;
   bytes: number;
-  open: boolean;
+  command: string | null;
+  note: string | null;
+}
+interface MaintenancePressure {
+  disk: {
+    volume: string;
+    freeMb: number;
+  }[];
+  memory: {
+    level: "normal" | "warning" | "critical" | null;
+    availableBytes: number | null;
+    pressured: boolean;
+    /** Read only while the level is warning or critical; absent otherwise. */
+    culprits?: MemoryCulprit[];
+  };
+  warningSince: number | null;
+  diskLevel?: DiskPressureLevel;
+}
+interface MaintenancePass {
+  startedAt: number;
+  durationMs: number;
+  trigger: string;
+  mode: "report" | "on";
+  freedBytes: number;
+  actions: number;
+  stopped: 0;
+  blocked: string[];
+}
+interface MaintenanceRecord extends NdjsonRecord {
+  ts: number;
+  src: "maintenance";
+  level: "debug" | "info" | "warn" | "error";
+  msg: string;
+  event: "maintenance_pass" | "maintenance_action" | "maintenance_skip" | "maintenance_failure" | "maintenance_check";
+  pass: string;
+  trigger: string;
+  mode: "report" | "on";
+}
+interface MaintenanceState {
+  version: 1;
+  lastAt: Partial<Record<MaintenanceCheck, number>>;
+  deferredAt?: Partial<Record<MaintenanceCheck, number>>;
+  pressure: MaintenancePressure | null;
+  sizes: MaintenanceSize[];
+  lastPass: MaintenancePass | null;
+  recent: MaintenanceRecord[];
+  plan: MaintenanceAction[];
+  skipKeys?: string[];
+}
+interface MaintenanceStatus {
+  mode: MaintenanceMode;
+  invalid?: string;
+  claim?: {
+    unresolved: string;
+    removeCommand: string;
+  };
+  lastChecks: {
+    pressure: number | null;
+    size: number | null;
+    worktree: number | null;
+    sweep: number | null;
+  };
+  pressure: MaintenancePressure | null;
+  sizes: MaintenanceSize[];
+  lastPass: MaintenancePass | null;
+  running: {
+    startedAt: string;
+    trigger: string;
+  } | null;
+  recent: MaintenanceRecord[];
+  plan: MaintenanceAction[];
+}
+/** Rejects missing, corrupt or unsupported payloads without throwing. */
+declare function parseMaintenanceState(value: unknown): MaintenanceState | null;
+declare function readMaintenanceState(): MaintenanceState | null;
+declare function readMaintenanceAttempt(): number | undefined;
+//#endregion
+//#region state/archive.d.ts
+interface ArchivedBytes {
+  logs: number;
+  recordings: number;
+  agentActions: number;
+  record: number;
+  total: number;
+}
+interface ArchivedWorkspace {
+  id: string;
+  projectRoot: string;
+  project: string;
+  workspace: string;
+  worktree: {
+    repository: string | null;
+    branch: string | null;
+    head: string | null;
+    subject: string | null;
+    merged: boolean | null;
+    pullRequest: {
+      number: number;
+      state: string;
+      title: string;
+      url: string;
+    } | null;
+  };
+  removedAt: string;
+  removedBy: string;
+  lastUsedAt: string | null;
+  builds: {
+    count: number;
+    last: LastBuildReport | null;
+    lastErrorCount: number;
+  };
+  agents: EndedAgentSession[];
+  bytes: ArchivedBytes;
+  expires: {
+    logs: string | null;
+    recordings: string | null;
+    agentActions: string | null;
+    record: string | null;
+  };
+  version: number;
+  replacedBy?: string;
 }
-interface RecordedDevice {
-  platform: RecordingPlatform;
-  slot: string;
-  dir: string;
-  segments: RecordedSegment[];
+interface ArchivedUsage {
+  count: number;
+  bytes: number;
+  byKind: {
+    logs: number;
+    recordings: number;
+    agentActions: number;
+    record: number;
+  };
 }
-/** The directory under a workspace's recordings that holds one device slot's footage. */
-declare function recordingDeviceName(platform: RecordingPlatform, slot: string): string;
-/** Segment names hold whole milliseconds: the start rounded down and the end rounded up. */
-declare function closedSegmentName(start: number, end: number): string;
-declare function openSegmentName(start: number): string;
-/** The segments in one device directory, oldest first. Files that are not segments are left out; `closedOnly` excludes files still being written. */
-declare function listSegments(dir: string, closedOnly?: boolean): RecordedSegment[];
-/** Reads current segment files asynchronously, oldest first; cancellation propagates. */
-declare function listSegmentsAsync(dir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedSegment[]>;
-/** Every device slot recorded under a workspace's recordings directory. */
-declare function listRecordedDevices(recordingsDir: string, closedOnly?: boolean): RecordedDevice[];
-/** Reads current device slots and their segment files asynchronously; cancellation propagates. */
-declare function listRecordedDevicesAsync(recordingsDir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedDevice[]>;
-declare function recordedBytes(devices: readonly RecordedDevice[]): number;
-/**
- * The oldest closed segments to delete so that one device keeps at most `footageMs` of footage. Time between
- * segments, while nothing was recorded, does not count. The open segment is never chosen.
- */
-declare function footageDrops(segments: readonly RecordedSegment[], footageMs: number): RecordedSegment[];
-/** The oldest closed segments across all devices to delete so that together they hold at most `capBytes`. */
-declare function capDrops(devices: readonly RecordedDevice[], capBytes: number): RecordedSegment[];
-/**
- * Whether stim-server records a workspace's devices: `STIM_RECORDING`, then `recording.enabled` in the workspace,
- * repo and machine layers, in that order, and true by default.
- */
-declare function recordingEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
+declare function readArchives(): ArchivedWorkspace[];
+/** Reads current archive files asynchronously, outside the synchronous state-read cache; cancellation propagates. */
+declare function readArchivesAsync(signal?: AbortSignal): Promise<ArchivedWorkspace[]>;
+declare function readArchive(id: string): ArchivedWorkspace | null;
+/** Reads a current archive without the synchronous state-read cache; invalid or missing records return null. */
+declare function readArchiveAsync(id: string, signal?: AbortSignal): Promise<ArchivedWorkspace | null>;
+declare function readArchiveState(id: string): WorkspaceState | null;
+declare function archivedUsage(archives: readonly ArchivedWorkspace[]): ArchivedUsage;
+declare function linkReplacedArchives(archives: readonly ArchivedWorkspace[], paths: readonly string[]): ArchivedWorkspace[];
+declare function archiveEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
 //#endregion
-//#region state/run-id.d.ts
-declare const RUN_ID_ENV = "STIM_RUN_ID";
-/** A run id as the CLI and stim-server accept it: letters, digits, `.`, `_` and `-`, at most 64. Null otherwise. */
-declare function validRunId(value: unknown): string | null;
-/**
- * The run id of the ambient operation context, else of this CLI invocation: `STIM_RUN_ID` when it holds a valid id
- * (Stim Desktop passes one), else a random one. The CLI entry exports it back to `STIM_RUN_ID` so processes the run
- * starts inherit it; this function does not.
- */
-declare function runId(env?: NodeJS.ProcessEnv): string;
+//#region state/macos.d.ts
+interface MacosProcess {
+  pid: number;
+  processToken: string;
+  startedAtMicros: number;
+}
+interface MacosBuild {
+  state: "running" | "ok" | "failed";
+  startedAt: string;
+  finishedAt?: string;
+  durationMs?: number;
+  fingerprint?: string;
+  cacheKey?: string;
+  cacheHit?: boolean;
+  cacheSource?: "local" | "provider" | "peer";
+  error?: string;
+  errorCode?: string;
+  buildMachine?: string;
+  builtOn?: string;
+  offloadedTo?: string;
+  offloadFallback?: string;
+}
+interface MacosAppRecord {
+  launchId: string;
+  arguments: string[];
+  product: string;
+  /** The app's visible name: the product and the workspace label. Absent in older records. */
+  displayName?: string;
+  bundle: string;
+  bundleId: string;
+  executable: string;
+  build: MacosBuild;
+  supervisor?: MacosProcess;
+  app?: MacosProcess;
+  /** Set when `stim macos --remote` reserved a session on another Mac; the app then has no local process. */
+  host?: HostedMacosPlacement;
+  /** Host launch evidence: true for a live app; status can override it in memory after probing the session. */
+  hostLaunched?: boolean | "unverified";
+}
+interface MacosAppState extends MacosAppRecord {
+  state: "running" | "orphaned" | "stopped" | "unverified";
+}
+declare function parseMacosRecord(value: unknown): MacosAppRecord | null;
+declare function readMacosRecord(root: string): MacosAppRecord | null;
+declare function readHostedMacosApp(home: string): MacosAppRecord | null;
+declare function macosAppState(record: MacosAppRecord | null): MacosAppState | null;
 //#endregion
 //#region state/settings-registry.d.ts
 declare const ANDROID_COMPILER_CACHE_CHOICES: readonly ["auto", "ccache", "cas", "none"];
@@ -834,1470 +911,1547 @@ interface SettingEntry {
     value: string;
   };
   sensitive?: true;
-  defaultReason?: string;
-}
-/** The payload `stim settings --json` prints. */
-type SettingsPayload = {
-  project: string | null;
-  files: Partial<Record<SettingScope, string>>;
-  settings: SettingEntry[];
-  unknown: Array<{
-    key: string;
-    scope: SettingScope;
-    file: string;
-    value: unknown;
-  }>;
-};
-/** The masked JSON result of a settings set or unset. */
-interface SettingWriteResult {
-  key: string;
-  scope: SettingScope;
-  file: string;
-  changed: boolean;
-  setting: SettingEntry;
-  recordingsDeleted?: string[];
-}
-declare const REMOTE_DEVICE_BACKENDS: readonly RemoteDeviceBackend[];
-declare const IOS_SIMULATOR_APPS: readonly ["xcode", "siniulator", "stim-desktop"];
-declare const ANDROID_EMULATOR_APPS: readonly ["emulator", "stim-desktop"];
-declare const OFFLOAD_MODES: readonly ["auto", "force", "off"];
-type OffloadMode = (typeof OFFLOAD_MODES)[number];
-declare const WEB_VIEWPORTS: readonly ["desktop", "phone"];
-type WebViewport = (typeof WEB_VIEWPORTS)[number];
-declare const SETTINGS: readonly SettingDefinition[];
-declare function settingDefinition(key: string): SettingDefinition | null;
-declare function isLayeredSetting(setting: SettingDefinition): boolean;
-declare const SETTING_GROUPS: readonly string[];
-declare function expectedShape(type: SettingType): string;
-declare function acceptsShape(setting: SettingDefinition, value: unknown): boolean;
-declare function settingValueError(setting: SettingDefinition, value: unknown): string | null;
-declare function isSensitiveReference(value: unknown): boolean;
-/**
- * Coerces raw text (a CLI argument or an environment variable) through a setting's
- * registry type, the same way for both sources. Types whose values are not written
- * as bare text (boolean, number, strings, object) are read as JSON; a value that
- * fails to parse is left as the original string so `settingValueError` reports it. A boolean also reads `1` and `0`.
- */
-declare function coerceSettingText(setting: SettingDefinition, raw: string): unknown;
-//#endregion
-//#region state/settings-schema.d.ts
-declare const SETTINGS_SCHEMA_FILE = "settings.schema.json";
-declare const SETTINGS_SCHEMA_URL: string;
-type JsonSchema = Record<string, unknown>;
-/**
- * The published settings schema. The root describes a committed `.stim.json`;
- * `$defs.machine` describes the settings keys of `$STIM_HOME/config.json`.
- * Every leaf carries `x-stim` with its dotted key, kind, writable scopes,
- * environment override, and sensitivity.
- */
-declare function settingsJsonSchema(): JsonSchema;
-//#endregion
-//#region state/hosted-app.d.ts
-interface HostedAppFile {
-  path: string;
-  kind: "file" | "exec" | "link";
-  size: number;
-  sha256: string;
-}
-interface HostedAppOffer {
-  session: string;
-  attempt: string;
-  bundleId: string;
-  mode: "development" | "release" | "process";
-  devClientScheme?: string;
-  arguments?: string[];
-  manifest: {
-    sha256: string;
-    size: number;
-  };
-}
-interface HostedAppDelivery extends Omit<HostedAppOffer, "manifest"> {
-  state: "receiving" | "installing" | "installed" | "unknown";
-  launched: true | "unverified" | null;
-  notice?: string;
-}
-interface HostedAppRecord extends HostedAppDelivery {
-  manifest: HostedAppOffer["manifest"];
-  files: HostedAppFile[];
-}
-declare const HOSTED_APP_CHUNK_BYTES: number;
-declare function hostedAppAttempt(value: unknown): value is string;
-declare function hostedAppArea(session: string, attempt: string, workerHome?: string): string;
-declare function hostedAppBlobs(session: string, workerHome?: string): string;
-/** Transfers cached verification after a rename, only for the same inode, size, mtime and digest. */
-declare function rememberHostedAppBlobRename(from: string, to: string, file: {
-  size: number;
-  sha256: string;
-}): void;
-/** Checks regular blob bytes, including their size, before content-addressed reuse. */
-declare function validHostedAppBlob(path: string, file: {
-  size: number;
-  sha256: string;
-}): boolean;
-/** At most 32 plain arguments of 1024 characters (8192 in total), with no NUL, CR or LF. */
-declare function validHostedAppArguments(value: unknown): value is string[];
-declare function parseHostedAppOffer(value: unknown): HostedAppOffer | null;
-/** Relative normalized paths, with no file or link as another entry's ancestor. */
-declare function parseHostedAppManifest(value: unknown): HostedAppFile[] | null;
-/** Reads a server-written receipt; malformed or missing established state remains unresolved. */
-declare function readHostedAppMetadata(session: string, attempt: string, workerHome?: string): Omit<HostedAppRecord, "files">;
-declare function readHostedApp(session: string, attempt: string, workerHome?: string): HostedAppRecord;
-//#endregion
-//#region state/hosted-macos.d.ts
-/** App slots one host offers; a slot names the host-assigned bundle id `<bundleId>.hosted<slot>`. */
-declare const HOSTED_MACOS_APP_SLOTS = 64;
-/** The drivers `hosting.agentDriver` can name: `none` and the first-party driver packages stim-server ships. */
-declare const HOSTED_AGENT_DRIVERS: readonly ["none", "agent-device"];
-type HostedAgentDriverName = (typeof HOSTED_AGENT_DRIVERS)[number];
-/** A driver name a grant or access record can carry; a client resolves only the drivers it knows. */
-declare function hostedAgentDriverName(value: unknown): value is string;
-/** What a host reports in a macOS offer: no simulator is created, so the choice is the host itself. */
-interface HostedMacosChoice {
-  architecture: "arm64" | "x86_64";
-  macosVersion: string;
+  defaultReason?: string;
 }
-/** A ready hosted macOS session's identity: the host it runs on and the app slot reserved for it. */
-interface HostedMacosDevice extends HostedMacosChoice {
-  appSlot: number;
+/** The payload `stim settings --json` prints. */
+type SettingsPayload = {
+  project: string | null;
+  files: Partial<Record<SettingScope, string>>;
+  settings: SettingEntry[];
+  unknown: Array<{
+    key: string;
+    scope: SettingScope;
+    file: string;
+    value: unknown;
+    replacement?: string;
+  }>;
+};
+/** The masked JSON result of a settings set or unset. */
+interface SettingWriteResult {
+  key: string;
+  scope: SettingScope;
+  file: string;
+  changed: boolean;
+  setting: SettingEntry;
+  recordingsDeleted?: string[];
 }
+declare const REMOTE_DEVICE_BACKENDS: readonly RemoteDeviceBackend[];
+declare const IOS_SIMULATOR_APPS: readonly ["xcode", "siniulator", "stim-desktop"];
+declare const ANDROID_EMULATOR_APPS: readonly ["emulator", "stim-desktop"];
+declare const REPLACED_SETTINGS: Readonly<Record<string, {
+  key: string;
+  env?: string;
+  value: (old: unknown) => string | null;
+}>>;
+declare function replacementAdvice(key: string, old: unknown): {
+  key: string;
+  command: string | null;
+} | null;
+declare const WEB_VIEWPORTS: readonly ["desktop", "phone"];
+type WebViewport = (typeof WEB_VIEWPORTS)[number];
+declare const SETTINGS: readonly SettingDefinition[];
+declare function settingDefinition(key: string): SettingDefinition | null;
+declare function isLayeredSetting(setting: SettingDefinition): boolean;
+declare const SETTING_GROUPS: readonly string[];
+declare function expectedShape(type: SettingType): string;
+declare function acceptsShape(setting: SettingDefinition, value: unknown): boolean;
+declare function settingValueError(setting: SettingDefinition, value: unknown): string | null;
+declare function isSensitiveReference(value: unknown): boolean;
 /**
- * The agent-device lease owner scope a client names on every request. `deviceKey` is `<bundleId>@<pid>`
- * for a macOS app, or `ios:mobile:<udid>` with `backend: ios-instance` for a hosted simulator, or `android:mobile:<serial>` with `backend: android-instance` for a hosted emulator.
+ * Coerces raw text (a CLI argument or an environment variable) through a setting's
+ * registry type, the same way for both sources. Types whose values are not written
+ * as bare text (boolean, number, strings, object) are read as JSON; a value that
+ * fails to parse is left as the original string so `settingValueError` reports it. A boolean also reads `1` and `0`.
  */
-interface HostedAgentLease {
-  tenant: string;
-  runId: string;
-  clientId: string;
-  deviceKey: string;
-  backend?: "ios-instance" | "android-instance";
-}
+declare function coerceSettingText(setting: SettingDefinition, raw: string): unknown;
+//#endregion
+//#region state/status.d.ts
+type StatsPlatform = "ios" | "android";
+/** A platform whose build reports phases: the stats platforms and `macos`. */
+type BuildPlatform = StatsPlatform | "macos";
+type RunOutcomeKind = "hit" | "cold";
+declare const BUILD_PHASES: readonly ["prepare", "cache-lookup", "wait", "prebuild", "pods", "compile", "device", "install", "launch"];
+type BuildPhase = (typeof BUILD_PHASES)[number];
+type ActiveBuildState = "running" | "stale" | "unknown";
 /**
- * Agent control a driver issues for one installed hosted app. `path` is the session's base route on the host,
- * `scope` the driver's handle that limits it to this one app, and `lease`, for a driver that allocates leases,
- * the scope that pins the allocation.
+ * Where a running build compiles: `local`, or the remote machine it was offloaded to, with the phase it is in there
+ * (`sync`, `deps`, `prebuild`, `pods`, `build` or `fetch`) and when the offload and that phase started.
  */
-interface HostedAgentIssuedGrant {
-  driver: string;
-  path: string;
-  token: string;
-  scope: string;
-  lease?: HostedAgentLease;
+type BuildPlacement = "local" | {
+  host: string;
+  phase: string;
+  startedAt: string;
+  phaseStartedAt: string;
+};
+interface BuildWaitingFor {
+  kind: "build-slot" | "device-slot";
+  inUse: number;
+  max: number;
+  since: string;
+}
+interface BuildReport {
+  platform: BuildPlatform;
+  slot: string;
+  state: ActiveBuildState;
+  phase: BuildPhase;
+  startedAt: string;
+  phaseStartedAt: string;
+  outcome: RunOutcomeKind | null;
+  /** Whether `outcome` is this run's own; before its cache lookup resolves it is the project's latest outcome. */
+  outcomeKnown: boolean;
+  /** The resolved lookup result; absent before resolution and when the run skips cache lookup. */
+  cacheLookupOutcome?: "hit" | "miss";
+  expectedMs: number | null;
+  expectedPhaseMs: number | null;
+  /** Milliseconds spent in phases already left; sums repeat visits, excludes the current visit, and is omitted before any phase completes and by older Stim. */
+  completedPhaseMs?: Partial<Record<BuildPhase, number>>;
+  basis: number;
+  /**
+   * The phases a run like this one goes through, in order, with each one's median in milliseconds, from the same
+   * runs as `expectedMs`; null without comparable runs. The current phase can be one the plan does not list.
+   */
+  plannedPhases: PlannedPhase[] | null;
+  /** Why the run's cache lookup missed, once the run knows; `baseline` omits `cacheKey`. */
+  missReason?: BuildMissReason;
+  /**
+   * True while `missReason` is the miss of the key the run looked up first and the run will prebuild or install pods,
+   * then look the key up again. A hit on the second lookup removes `missReason` and sets `outcome` to `hit`.
+   */
+  missProvisional?: true;
+  /** What the native build tool is doing now, once it printed a line Stim recognizes. */
+  detail?: BuildDetail;
+  /** What the `device` or `launch` phase is waiting on, once Stim observed it; absent otherwise and from older Stim. */
+  activity?: BuildActivity;
+  placement: BuildPlacement;
+  /** While `phase` is `wait`: the workspace whose build of the same artifact this run waits on, when it is known. */
+  waitingOn?: {
+    path: string;
+  };
+  waitingFor?: BuildWaitingFor;
 }
 /**
- * Agent control the host grants a client for one installed hosted app, sent only over that client's approved
- * device-host connection and never journaled. `none` means the host's `hosting.agentDriver` starts no driver.
+ * What a run's `device` or `launch` phase is waiting on. `booting` lasts while the run waits for the owned simulator or
+ * emulator it started booting. `bundling` starts when the app's bundle request reaches this workspace's
+ * Metro and ends when Metro delivered it; `percent` is Metro's own progress for that request, present only once Metro
+ * reported one. `waiting-ready` lasts while the app reports its readiness pending. `startedAt` is when the evidence was
+ * recorded.
  */
-type HostedAgentGrant = {
-  driver: "none";
-} | HostedAgentIssuedGrant;
-/** `app.launch` and `app.attach` results; a host includes `agent` once the app is installed. */
-type HostedAppLaunch = HostedAppDelivery & {
-  agent?: HostedAgentGrant;
-};
+interface BuildActivity {
+  name: "booting" | "bundling" | "waiting-ready";
+  startedAt: string;
+  percent?: number;
+}
+/** One phase a running build is expected to go through, and its median duration in comparable runs. */
+interface PlannedPhase {
+  phase: BuildPhase;
+  expectedMs: number;
+}
+/** The native build tool's step inside a build's `compile` phase. */
+declare const NATIVE_BUILD_STEPS: readonly ["configure", "compile", "link", "resources", "script", "dex", "package", "sign"];
+type NativeBuildStep = (typeof NATIVE_BUILD_STEPS)[number];
 /**
- * Agent control as the client hands it to a coding agent: secrets stay in files Stim writes with mode
- * 0600, and `command` shows how to address the hosted app. Never carries a token inline. `setting` names
- * the hosting Mac's setting that turns a driver on.
+ * A running build's progress as its tool reports it. `unit` is `targets` for xcodebuild, `tasks` for Gradle and
+ * `steps` for SwiftPM. xcodebuild's `done` counts targets it finished and `total` the targets in its dependency graph,
+ * which includes targets with nothing to do; Gradle's `done` counts the tasks it reported, with a null `total`;
+ * SwiftPM's `done` and `total` are the `[done/total]` of its latest progress line, and its total can grow while it
+ * builds. They are counts, not a completion fraction. `status` reports the detail only during the `compile` phase. `line` is
+ * the latest compile, link or task line with paths shortened to file names.
  */
-type HostedAgentAccess = {
-  driver: "none";
-  setting: "hosting.agentDriver";
-} | {
-  driver: string;
-  remoteConfig: string;
-  command: string;
-};
-/** Where a workspace's macOS app runs when `stim macos --remote` placed it on another Mac. */
-interface HostedMacosPlacement {
-  machine: string;
-  session: string;
-  appSlot: number;
-  appAttempt: string;
-  /** The host-assigned id the running app uses, `hostedMacosBundleId(<offered id>, appSlot)`. */
-  bundleId: string;
-  agent: HostedAgentAccess;
+interface BuildDetail {
+  step: NativeBuildStep | null;
+  unit: "targets" | "tasks" | "steps" | null;
+  done: number | null;
+  total: number | null;
+  line: string | null;
+  updatedAt: string;
 }
-declare function hostedMacosAppSlot(value: unknown): value is number;
-declare function hostedMacosBundleId(bundleId: string, appSlot: number): string;
-declare function parseHostedMacosChoice(value: unknown): HostedMacosChoice | null;
-declare function parseHostedMacosDevice(value: unknown): HostedMacosDevice | null;
-/** A grant naming a driver this client does not know is not usable; it parses as null. */
-declare function parseHostedAgentGrant(value: unknown): HostedAgentGrant | null;
-declare function parseHostedAgentAccess(value: unknown): HostedAgentAccess | null;
-declare function parseHostedMacosPlacement(value: unknown): HostedMacosPlacement | null;
-//#endregion
-//#region state/device-host.d.ts
-type HostedDevicePlatform = "ios" | "android" | "macos";
-/** Deadlines stim-server gives each hosted worker run. Clients derive their waits from these. */
-interface DeviceHostLimits {
-  prepareMs: number;
-  offerMs: number;
-  stopMs: number;
-  logsMs: number;
-  killGraceMs: number;
+/** Where a build's app came from: a cache tier, or `false` when it compiled or failed before one was found. */
+type BuildCacheHit = "local" | "remote" | false;
+/** A platform's most recent `ios` or `android` run in one workspace. */
+interface DevicePlacement {
+  decision: "local" | "hosted" | "waited-locally" | "eas";
+  reason: string;
+  machine?: string;
 }
-declare const DEVICE_HOST_LIMITS: Readonly<DeviceHostLimits>;
-/** How many parked sessions one reserve inspects, and possibly retires, before it creates a device. */
-declare const HOSTED_PARKED_CANDIDATES: number;
-/** How long a cancelled hosted worker run can take to settle: SIGTERM, SIGKILL after the grace, then it is abandoned. */
-declare function hostedWorkerSettleMs(limits?: Pick<DeviceHostLimits, "killGraceMs">): number;
-interface HostedIosChoice {
-  deviceTypeId: string;
-  runtimeId: string;
-  deviceType: string;
-  runtime: string;
-  architecture: "arm64" | "x86_64";
+interface LastBuildReport {
+  devicePlacement?: DevicePlacement;
+  platform: BuildPlatform;
+  status: "ok" | "failed";
+  cacheHit: BuildCacheHit;
+  cacheSkipped: boolean;
+  durationMs: number | null;
+  fingerprint: string | null;
+  startedAt: string;
+  finishedAt: string | null;
+  errorCode?: string;
+  missReason?: BuildMissReason;
+  /** The selected auto, local, or configured machine entry; present on new build records, including cache hits. */
+  buildMachine?: string;
+  /** Where compilation ran: here or a machine name; absent when no build ran. */
+  builtOn?: string;
+  /** The remote machine that compiled the app when the build was offloaded. */
+  offloadedTo?: string;
+  /** Why the run built here after it considered offloading; absent when it offloaded or never considered it. */
+  offloadFallback?: string;
+  /** The first compiler diagnostics of a failed build, when the build tool reported any. */
+  diagnostics?: BuildDiagnostic[];
+  /** Present on a failed run: what failed, from `buildCause`. */
+  cause?: BuildCause;
 }
-interface HostedIosDevice extends HostedIosChoice {
-  udid: string;
-  name: string;
+/**
+ * A failed run's cause: the first diagnostic with a file and a line, keyed `file:line`, else the run's error code
+ * (or `failed`), with null `file` and `line`. Consecutive failures with the same `key` failed the same way.
+ */
+interface BuildCause {
+  key: string;
+  file: string | null;
+  line: number | null;
 }
-interface HostedAndroidChoice {
-  systemImage: string;
-  deviceProfile: string;
-  architecture: "arm64-v8a" | "x86_64";
+/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
+declare const BUILD_RESULTS: readonly ["succeeded", "failed", "cancelled", "interrupted"];
+type BuildResult = (typeof BUILD_RESULTS)[number];
+/**
+ * One run in a workspace's recent build history. `configuration` is the iOS configuration or the Android
+ * variant the run built, `Debug` or `debug` by default, and null when the run ended before resolving it.
+ * `phases` holds the milliseconds spent in each phase the run entered. An interrupted run has null
+ * `durationMs` and `finishedAt`, no cache facts, and 0 for the phase it stopped in.
+ */
+interface BuildHistoryEntry extends LastBuildReport {
+  result: BuildResult;
+  slot: string;
+  configuration: string | null;
+  cacheKey: string | null;
+  phases: Partial<Record<BuildPhase, number>>;
+  /** A `stim macos` run's SwiftPM step total; absent for other runs and when the build reported none. */
+  compileSteps?: number;
 }
-interface HostedAndroidDevice extends HostedAndroidChoice {
-  avdName: string;
-  serial: string;
-  consolePort: number;
+/** One compiler error from a failed build: where it is, when the tool said, and its message. */
+interface BuildDiagnostic {
+  file: string | null;
+  line: number | null;
+  column: number | null;
+  message: string;
 }
-type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
-interface HostedDeviceSelectors {
-  deviceType?: string;
-  runtime?: string;
-  systemImage?: string;
-  deviceProfile?: string;
+/** What kind of native input a changed fingerprint source is. */
+type BuildMissCategory = "native-dependency" | "config-plugin" | "app-config" | "app-asset" | "package" | "native-dir" | "autolinking" | "package-scripts" | "file" | "other";
+interface BuildMissChange {
+  source: string;
+  change: "added" | "removed" | "changed";
+  category: BuildMissCategory;
 }
-interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
-  platform: HostedDevicePlatform;
+/**
+ * Why a run compiled instead of installing a cached app. `changes` holds at most 20 entries,
+ * ordered by importance; `changeCount` is the full number of changed fingerprint sources.
+ * Only a plan reports `prebuild-pending`: the run would prebuild before compiling, so the changes
+ * compare the fingerprint before that prebuild.
+ */
+interface BuildMissReason {
+  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error" | "prebuild-pending";
+  summary: string;
+  changes: BuildMissChange[];
+  changeCount: number;
+  /** `cacheKey` is kept in workspace state so a later miss can find this baseline; status omits it. */
+  baseline: {
+    fingerprint: string;
+    cacheKey?: string;
+    from: "workspace" | "project";
+  } | null;
+  rekeyedBy: string[];
 }
-type HostedNativeOffer = {
-  resources: {
-    cpus: number;
-    /** Five-minute system load divided by available CPU count. */
-    loadPerCore: number;
-    memoryFreeBytes: number;
-    memoryPressure: "normal" | "warning" | "critical" | null;
-    /** Available bytes on the Stim home volume, not necessarily the Android AVD volume. */
-    workerDiskFreeBytes: number | null;
-    localDevices?: number | {
-      unknown: string;
-    };
-  };
-  declined: string | null;
-} & ({
-  platform: "ios";
-  choice: HostedIosChoice | null;
-} | {
-  platform: "android";
-  choice: HostedAndroidChoice | null;
-} | {
-  platform: "macos";
-  choice: HostedMacosChoice | null;
-});
-type HostedDeviceOffer = HostedNativeOffer & {
-  capacity: {
-    running: number;
-    max: number;
-    available: number | null;
-    local?: number | {
-      unknown: string;
-    };
+/** The payload `stim ios --plan --json` and `stim android --plan --json` print. */
+interface BuildPlanPayload {
+  platform: StatsPlatform;
+  slot?: string;
+  fingerprint: string;
+  cacheKey: string | null;
+  cacheHit: BuildCacheHit;
+  provider: string | null;
+  cacheSkipped: boolean;
+  prebuild: "none" | "generate" | "regenerate" | "refuse" | null;
+  outcome: RunOutcomeKind | null;
+  expectedMs: number | null;
+  basis: number;
+  /** On a predicted miss with cache reads on, why the cache has no app; `baseline` omits `cacheKey`. */
+  missReason?: BuildMissReason;
+  refusal?: {
+    code: string;
+    message: string;
+    remedy: string;
   };
-};
-interface HostedDeviceRequest extends HostedDeviceOfferRequest {
-  workspace: string;
-  slot: string;
-  attempt: string;
+  /** With ios.remote or android.remote set to auto or a Mac, where the plan assumes the device runs, such as `this machine; auto may use janics-mac-mini`. */
+  placement?: string;
 }
-type HostedDevicePhase = "preparing" | "ready" | "stopping" | "stopped" | "unknown";
-interface HostedDeviceSession extends HostedDeviceRequest {
-  id: string;
-  client: string;
-  state: HostedDevicePhase;
-  device: HostedDevice | null;
-  consolePort?: number;
-  appSlot?: number;
-  createdAt: string;
-  parked?: {
-    at: string;
-  };
-  notice?: string;
-  appAttempt?: string;
-  agent?: HostedAgentGrant;
-  metroPort?: number;
-  clientMetroPort?: number;
+/** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
+interface MacosBuildPlanPayload {
+  platform: "macos";
+  product: string;
+  buildMachine: string;
+  fingerprint: string | null;
+  cacheKey: string | null;
+  cacheHit: boolean;
+  provider: null;
+  cacheSkipped: boolean;
+  prebuild: null;
+  outcome: null;
+  expectedMs: null;
+  basis: number;
 }
-declare function deviceHostRoot(): string;
-declare function deviceHostArea(id: string): string;
-declare function parseHostedChoice(value: unknown): HostedIosChoice | null;
-declare function parseHostedDevice(value: unknown): HostedIosDevice | null;
-declare function parseHostedAndroidDevice(value: unknown): HostedAndroidDevice | null;
-/** Android Emulator -help-port defines the supported even console ports as 5554 through 5584. */
-declare function hostedConsolePort(value: unknown): value is number;
-declare function parseHostedPlatformDevice(value: unknown, platform: HostedDevicePlatform): HostedDevice | null;
-declare function hostedDeviceId(device: HostedDevice): string;
-declare function parseHostedRequest(value: unknown): HostedDeviceRequest | null;
-declare function parseHostedOfferRequest(value: unknown): HostedDeviceOfferRequest | null;
-declare function parseHostedLocalDeviceCount(value: unknown): number | {
-  unknown: string;
-} | null;
-declare function parseHostedNativeOffer(value: unknown): HostedNativeOffer | null;
-/** A missing established journal or malformed record is a refusal, never an empty reservation set. */
-declare function readHostedSessions(): HostedDeviceSession[];
-/** The private worker's exact device record; an absent record is unresolved after creation started. */
-declare function readHostedDevice(home: string): HostedIosDevice;
-declare function readHostedDevice(home: string, platform: "android"): HostedAndroidDevice;
-declare function readHostedDevice(home: string, platform: "macos"): HostedMacosDevice;
-declare function readHostedDevice(home: string, platform: HostedDevicePlatform): HostedDevice;
-declare function readHostedDeviceLedger(home: string, options?: {
-  required?: boolean;
-}): {
-  ios: string[];
-  android: string[];
-  web: string[];
-} | null;
-/** Hosted sessions use isolated homes: only one exact device of their platform may appear in this ledger. */
-declare function assertHostedDeviceLedger(home: string, id: string, platform?: HostedDevicePlatform, options?: {
-  allowEmpty?: boolean;
-}): "listed" | "empty";
-//#endregion
-//#region state/workspace-state.d.ts
-interface WorkspaceState {
-  supervisor?: Record<string, unknown>;
-  collectors?: Record<string, unknown>;
-  lastBuild?: Record<string, unknown>;
-  launches?: Record<string, unknown>;
-  remoteDevice?: Record<string, unknown>;
-  metroTunnel?: Record<string, unknown>;
-  [key: string]: unknown;
+type ActivityState = "driven" | "active" | "idle" | "unknown";
+interface ActivityDriver {
+  tool: string;
+  pid: number | null;
+  since: string | null;
 }
-declare const IDLE_STOP_KEY = "devServerStop";
-/** Why the supervisor last stopped the dev server on its own: `metro.idleStopMinutes` with no use. */
-interface IdleStopRecord {
-  reason: "idle";
-  at: string;
-  idleMinutes: number;
+/** The kinds of evidence that date a device's last activity, in the order `recent` lists them. */
+declare const ACTIVITY_RECENCY_BASES: readonly ["agent-action", "device-log", "metro-bundle", "workspace-use", "supervisor-start", "page-log", "viewer"];
+type ActivityRecencyBasis = (typeof ACTIVITY_RECENCY_BASES)[number];
+interface DeviceActivity {
+  state: ActivityState;
+  driver?: ActivityDriver;
+  lastActivityAt?: string;
+  /** The newest time of each kind of evidence behind `lastActivityAt`, so a reader can leave out app log chatter. */
+  recent?: Partial<Record<ActivityRecencyBasis, string>>;
+  basis: string[];
 }
-declare function readIdleStop(state: WorkspaceState | null | undefined): IdleStopRecord | null;
-declare const DEVICE_RECLAIM_REASON = "reclaimed for a waiting run";
-declare const DEVICE_IDLE_SHUTDOWN_KEY = "deviceIdleShutdowns";
-/** An owned simulator or emulator shut down after being idle. */
-interface DeviceIdleShutdownRecord {
-  at: string;
-  idleMinutes: number;
-  reason?: string;
+/** Every state a device's app process can report. */
+declare const APP_PROCESS_STATES: readonly ["running", "stopped", "unknown"];
+/**
+ * Whether the workspace's app process is alive on a device now. This is current process state, not launch evidence:
+ * `launched` in an `ios` or `android` result stays the record of one launch. `id` is the bundle identifier or
+ * package that was checked; `state` is "unknown" when the process listing could not be read.
+ */
+interface DeviceAppProcess {
+  id: string;
+  state: (typeof APP_PROCESS_STATES)[number];
 }
-/** The recorded idle shutdowns by device slot key (`ios`, `android`, `ios:<slot>`). */
-declare function readDeviceIdleShutdowns(state: WorkspaceState | null | undefined): Record<string, DeviceIdleShutdownRecord>;
-declare const DEV_SERVER_STOP_REQUEST_KEY = "devServerStopRequest";
-/** A Stim component's intent to stop the supervisor with `processToken`, written before it signals. */
-interface DevServerStopRequest {
-  processToken: string;
-  by: string;
-  pid: number;
-  at: string;
-  workspace?: string;
+/**
+ * A linked worktree's `git status`. `changed` counts tracked paths with staged or unstaged changes, including
+ * conflicts; `untracked` counts untracked entries as `git status` lists them, so an untracked directory counts once.
+ * `ahead` and `behind` compare HEAD with `upstream`, and are null when there is no upstream or it no longer exists.
+ * `mergedInto` names the default branch (`origin/main`) when `gc` would consider the branch merged into it, judged
+ * from local refs without fetching.
+ */
+interface WorktreeGit {
+  changed: number;
+  untracked: number;
+  upstream: string | null;
+  ahead: number | null;
+  behind: number | null;
+  mergedInto: string | null;
 }
-declare function readDevServerStopRequest(state: WorkspaceState | null | undefined): DevServerStopRequest | null;
 /**
- * Why the dev server last stopped, stored under `IDLE_STOP_KEY`. `requested` names the Stim component that
- * asked; `signal` is a SIGTERM or SIGINT no Stim component asked for; `server-exited` is the dev server
- * process exiting on its own.
+ * The GitHub pull request of a worktree's branch and HEAD, as `status --watch` last looked it up through `gh`.
+ * `state` is `draft` for an open draft. `checks` counts the head commit's check runs and commit statuses, null when it
+ * has none. `checkedAt` is when Stim last asked GitHub.
  */
-type DevServerStopRecord = IdleStopRecord | {
-  reason: "requested";
-  at: string;
-  by: string;
-  byPid: number;
-  byWorkspace?: string;
-} | {
-  reason: "signal";
-  at: string;
-  signal: string;
-} | {
-  reason: "server-exited";
-  at: string;
-  mode: string;
-  code: number | null;
-  signal: string | null;
-};
-/** A stopped dev server's last cause in status; `vanished` is a supervisor proven gone that recorded none. */
-type MetroLastStop = DevServerStopRecord | {
-  reason: "vanished";
-  pid: number;
-  startedAt: string | null;
-};
-declare function readDevServerStop(state: WorkspaceState | null | undefined): DevServerStopRecord | null;
-/** Each platform's latest run; `lastBuild` holds whichever platform ran last. */
-declare const LAST_BUILD_KEYS: Readonly<Record<StatsPlatform, string>>;
-declare const BUILD_HISTORY_KEY = "buildHistory";
-declare const BUILD_HISTORY_LIMIT = 10;
-/** A recorded miss reason in the shape status reports, without `baseline.cacheKey`; null when malformed. */
-declare function parseMissReason(value: unknown): BuildMissReason | null;
+interface WorktreePullRequest {
+  number: number;
+  url: string;
+  title: string;
+  state: "open" | "draft" | "merged" | "closed";
+  checks: {
+    passing: number;
+    failing: number;
+    pending: number;
+  } | null;
+  reviewDecision: "approved" | "changes-requested" | "review-required" | null;
+  checkedAt: string;
+}
+interface WorktreeFacts {
+  path: string;
+  branch?: string;
+  repository?: string;
+  /** Null when git could not be read in time, the worktree is in a folder status does not open, or one-shot status skipped an idle environment or an unprovisioned worktree. */
+  git?: WorktreeGit | null;
+  /** Null when GitHub has no pull request for the branch; absent when unknown, such as without `gh`. */
+  pullRequest?: WorktreePullRequest | null;
+  /** Present with `git`: what the worktree's git chip shows, from `gitChip`. */
+  gitChip?: GitChip;
+}
+/** Every coding-agent tool whose sessions status can attribute to an environment. */
+declare const AGENT_TOOLS: readonly ["claude-code", "codex"];
+type AgentTool = (typeof AGENT_TOOLS)[number];
 /**
- * The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
- * ones with a source position first.
+ * A coding-agent session working in an environment: one whose working directory `cwd` is the environment's path,
+ * inside it, or its git worktree root, or one that ran a Stim command in it. `title` is the short name the tool keeps
+ * for the session, never its conversation. `lastActiveAt` is the tool's own last update, or the Stim command's time
+ * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this machine.
+ * `webUrl` opens a Claude Code session with Remote Control connected on claude.ai/code or in the Claude mobile app.
  */
-declare function buildDiagnostics(value: unknown): BuildDiagnostic[];
-declare function readDevicePlacement(state: WorkspaceState | null, platform: StatsPlatform, slot?: string): DevicePlacement | null;
-declare function readLastBuilds(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, LastBuildReport>>;
-/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
-declare function readBuildHistory(state: WorkspaceState | null | undefined): Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
-declare function readWorkspaceState(root: string): WorkspaceState | null;
-declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
-declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
+interface AgentSession {
+  tool: AgentTool;
+  sessionId: string;
+  title?: string;
+  cwd: string;
+  startedAt?: string;
+  lastActiveAt?: string;
+  pid?: number;
+  openUrl?: string;
+  webUrl?: string;
+}
 /**
- * When the workspace was last used, in epoch milliseconds. A workspace that recorded no use falls back to the mtime
- * of its workspace.json, which is written once when the workspace is created, so it is a lower bound on the last
- * use. NaN when its state.json exists but does not parse, or when workspace.json cannot be read either.
+ * An agent session that stopped running in an environment, with the details Stim last found while it ran. `endedAt`
+ * is the last time a status watcher found it running.
  */
-declare function workspaceLastUsed(root: string): number;
-declare const WARM_KEY = "warm";
-/** How long a successful warm keeps a workspace `ready` when nothing runs in it. */
-declare const READY_PHASE_MS: number;
+interface EndedAgentSession extends Omit<AgentSession, "pid"> {
+  endedAt: string;
+}
+interface AndroidRuntimeFacts {
+  serial: string | null;
+  state: "detected" | "not-detected" | "missing" | "unknown";
+  error?: string;
+}
+/** Every connection state a physical device can report. */
+declare const PHYSICAL_DEVICE_CONNECTIONS: readonly ["connected", "disconnected", "unknown"];
+type PhysicalDeviceConnection = (typeof PHYSICAL_DEVICE_CONNECTIONS)[number];
 /**
- * What `stim worktree warm` last recorded in a workspace: a warm in progress, held by the ownership claim
- * `claim` names, or a successful warm that finished at `at`.
+ * A physical iPhone, iPad or Android phone the workspace holds an unexpired lease on, from `ios --device`,
+ * `android --device` or `device lock`. Stim uses it and never owns it, so `owned` is always false. `id` is the
+ * UDID or adb serial. `name` is the device's own name, falling back to the name the lease recorded; `model` is the
+ * marketing name devicectl reports, null when it could not be read, or the Android model the lease recorded.
+ * `connection` is `connected` when devicectl can reach the phone or adb lists it as `device`, `disconnected` when
+ * the tool answered without it, and `unknown` when the tool could not be read in time. `lease.holder` is the
+ * workspace path that holds it.
  */
-type WarmRecord = {
-  phase: "warming";
-  step: WarmStep;
-  startedAt: string;
-  claim: {
-    root: string;
-    claimId: string;
+interface PhysicalDeviceState {
+  platform: StatsPlatform;
+  slot: string;
+  id: string;
+  name: string | null;
+  model: string | null;
+  owned: false;
+  physical: true;
+  connection: PhysicalDeviceConnection;
+  lease: {
+    holder: string;
+    kind: "declared" | "run";
+    grantedAt: string | null;
+    expiresAt: string;
   };
-} | {
-  phase: "ready";
-  at: string;
-};
-declare function readWarmRecord(state: WorkspaceState | null | undefined): WarmRecord | null;
-declare const WORKSPACE_AGENT_KEY = "agentSession";
-/**
- * The coding-agent session whose shell ran the Stim command that last recorded `lastUsedAt`, with that command's
- * working directory as `cwd` and its time as `lastActiveAt`.
- */
-declare function readWorkspaceAgent(state: WorkspaceState | null | undefined): AgentSession | null;
-//#endregion
-//#region state/hosted-native.d.ts
-interface HostedNativePlacement<D> {
-  machine: string;
-  session: string;
-  appAttempt: string;
-  device: D | null;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
 }
-declare function parseHostedNativePlacement(value: unknown, platform: "ios"): HostedNativePlacement<HostedIosDevice> | null;
-declare function parseHostedNativePlacement(value: unknown, platform: "android"): HostedNativePlacement<HostedAndroidDevice> | null;
-declare function parseHostedNativePlacement(value: unknown, platform: "ios" | "android"): HostedNativePlacement<HostedIosDevice | HostedAndroidDevice> | null;
-declare function hostedNativeRecords(state: WorkspaceState | null, platform: "ios" | "android"): Record<string, unknown>;
-declare function unreadableHostedNative(slot: string, platform: "ios" | "android"): string;
-//#endregion
-//#region state/hosted-android.d.ts
-/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
-interface HostedAndroidPlacement extends HostedNativePlacement<HostedAndroidDevice> {}
-/** Public hosting facts; the host's serial, AVD name and private Metro gateway are excluded. */
-type HostedAndroidStatus = {
-  machine: string;
-  session: string;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
-  device: {
-    name: string;
-    systemImage: string;
-    api: number;
-  } | null;
-  /** The latest session probe in status, independent of a conflicting local emulator's state. */
-  state?: string;
-};
-declare function parseHostedAndroidPlacement(value: unknown): HostedAndroidPlacement | null;
-declare function hostedAndroidStatus(placement: HostedAndroidPlacement): HostedAndroidStatus;
-declare function hostedAndroidRecords(state: WorkspaceState | null): Record<string, unknown>;
-declare function unreadableHostedAndroid(slot: string): string;
-declare function hostedAndroidPlacements(state: WorkspaceState | null): Record<string, HostedAndroidPlacement>;
-declare function hostedAndroidDeviceName(device: HostedAndroidDevice): string;
-//#endregion
-//#region state/hosted-ios.d.ts
-/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
-interface HostedIosPlacement extends HostedNativePlacement<HostedIosDevice> {}
-/** Public hosting facts; the host's UDID and private Metro gateway are excluded. */
-type HostedIosStatus = {
-  machine: string;
-  session: string;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
-  device: {
-    name: string;
-    runtime: string;
-  } | null;
-  /** The latest session probe in status, independent of a conflicting local simulator's state. */
-  state?: string;
-};
-declare function parseHostedIosPlacement(value: unknown): HostedIosPlacement | null;
-declare function hostedIosStatus(placement: HostedIosPlacement): HostedIosStatus;
-declare function hostedIosRecords(state: WorkspaceState | null): Record<string, unknown>;
-declare function unreadableHostedIos(slot: string): string;
-declare function hostedIosPlacements(state: WorkspaceState | null): Record<string, HostedIosPlacement>;
-//#endregion
-//#region state/maintenance.d.ts
-type MaintenanceMode = "off" | "report" | "on";
-type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep" | "idle";
-type MaintenanceActionKind = "would-clear-outputs" | "would-trim-cache" | "would-empty-cache" | "would-shutdown-device" | "would-stop-workspace" | "would-remove-worktree" | "would-remove-orphan" | "would-unregister-cache" | "would-delete-parked-device" | "would-delete-devices" | "would-clear-build-dirs" | "would-delete-dependencies" | "would-stop-gradle-daemons" | "would-delete-gradle-version" | "would-delete-temp-leftovers";
-/** Disk pressure: 0 above every threshold, 1 under the budget floor, 2 under the urgent threshold, 3 under the critical threshold or the hard floor. */
-type DiskPressureLevel = 0 | 1 | 2 | 3;
-interface MaintenanceAction {
-  kind: MaintenanceActionKind;
-  target: string;
-  bytes: number;
-  reason: string;
-  workspace?: string;
-  dir?: string;
-  olderThanDays?: number;
-  check?: "worktree" | "sweep" | "disk";
-  /** The disk pressure level that planned the action; it runs only while free disk stays under that level's floor. */
-  level?: 2 | 3;
+interface RemoteDeviceState {
+  platform: "ios" | "android" | null;
+  backend: "eas";
+  sessionId: string;
+  state: "claimed" | "unclaimed" | "unknown";
+  startedAt: string | null;
+  webPreviewUrl: string | null;
 }
-interface MaintenanceSize {
-  name: string;
-  dir: string;
-  bytes: number;
-  measuredAt: number;
-  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "owned-devices" | "other";
-  workspace?: string;
-  idleDays?: number | null;
-  blocked?: string;
+/**
+ * One part of a worktree's git chip, in display order: commits ahead of and behind the upstream, uncommitted files
+ * (changed plus untracked), the base branch the branch is merged into (left out when its pull request is merged,
+ * whose own mark says so), and a branch with no upstream that is not merged.
+ */
+type GitChipPart = {
+  kind: "arrows";
+  ahead: number;
+  behind: number;
+} | {
+  kind: "changed";
+  count: number;
+} | {
+  kind: "merged";
+  into: string;
+} | {
+  kind: "no-upstream";
+};
+/** A pull request's checks at a glance: any failing, else any pending, else any passing; null without checks. */
+type ChecksState = "passing" | "failing" | "pending" | null;
+interface GitChip {
+  parts: GitChipPart[];
+  ci: ChecksState;
 }
 /**
- * A process whose physical footprint, as `top` reports it, is abnormally large. `command` is the one command that
- * safely restarts or stops it, null when Stim knows none; `note` says what that command does.
+ * Whether a running owned simulator or emulator lacks the workspace's app: `none` when its platform never built
+ * successfully here and the latest build failed, `closed` when status saw no app process, else null.
  */
-interface MemoryCulprit {
-  pid: number;
-  name: string;
-  bytes: number;
-  command: string | null;
-  note: string | null;
-}
-interface MaintenancePressure {
-  disk: {
-    volume: string;
-    freeMb: number;
+type AppPresence = "none" | "closed" | null;
+declare const WORKSPACE_STAGE_KINDS: readonly ["building", "warming", "ready", "build-failed", "running", "stopped"];
+/**
+ * Where a workspace is, first match wins: `building` while a build runs, `warming` and `ready` from `phase` when
+ * nothing is live, `build-failed` when the newest run of either platform failed, `running` when it is live, its
+ * macOS app is running or orphaned, or it holds a remote device, else `stopped`. `since` is when that began: the
+ * build's start, the warm phase's time, the failed run's end (else start), the supervisor's start (else the running
+ * macOS app's build end, else its start), or Metro's last stop. `platform` names the build for `building`
+ * and `build-failed`. `closedApps` lists, for `running`, the devices whose `appPresence` is `closed`.
+ */
+interface WorkspaceStage {
+  kind: (typeof WORKSPACE_STAGE_KINDS)[number];
+  since: string | null;
+  platform: StatsPlatform | "macos" | null;
+  closedApps: {
+    platform: StatsPlatform;
+    slot: string;
   }[];
-  memory: {
-    level: "normal" | "warning" | "critical" | null;
-    availableBytes: number | null;
-    pressured: boolean;
-    /** Read only while the level is warning or critical; absent otherwise. */
-    culprits?: MemoryCulprit[];
-  };
-  warningSince: number | null;
-  diskLevel?: DiskPressureLevel;
-}
-interface MaintenancePass {
-  startedAt: number;
-  durationMs: number;
-  trigger: string;
-  mode: "report" | "on";
-  freedBytes: number;
-  actions: number;
-  stopped: 0;
-  blocked: string[];
 }
-interface MaintenanceRecord extends NdjsonRecord {
-  ts: number;
-  src: "maintenance";
-  level: "debug" | "info" | "warn" | "error";
-  msg: string;
-  event: "maintenance_pass" | "maintenance_action" | "maintenance_skip" | "maintenance_failure" | "maintenance_check";
-  pass: string;
-  trigger: string;
-  mode: "report" | "on";
+/** Every code a status issue can carry. */
+declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "android-reverse-missing", "supervisor-unverified", "browser-unverified", "browser-orphaned"];
+type StatusIssueCode = (typeof STATUS_ISSUE_CODES)[number];
+/**
+ * One thing in a workspace that needs the user, or with severity `info` a note that needs nothing. `remedy` is a
+ * command to run from `workspace`; `slot` is absent for the default device slot. `warnings` carries the `error` and
+ * `warning` issues as text.
+ *
+ * Severity:
+ * - `error`: Stim cannot verify or safely act on something; a person resolves it, following the teardown guide.
+ * - `warning`: something is broken now and needs someone to act, such as an app that cannot reach Metro, a held
+ *   port or a device that vanished while expected.
+ * - `info`: a fact the next normal Stim command handles by itself, so it needs no action.
+ *
+ * The phone app and Stim Desktop show `error` and `warning` and hide `info`; plain `stim status` prints `info` as a
+ * dim note with no remedy.
+ */
+interface StatusIssue {
+  code: StatusIssueCode;
+  severity: "error" | "warning" | "info";
+  message: string;
+  remedy: string;
+  workspace: string;
+  slot?: string;
 }
-interface MaintenanceState {
-  version: 1;
-  lastAt: Partial<Record<MaintenanceCheck, number>>;
-  deferredAt?: Partial<Record<MaintenanceCheck, number>>;
-  pressure: MaintenancePressure | null;
-  sizes: MaintenanceSize[];
-  lastPass: MaintenancePass | null;
-  recent: MaintenanceRecord[];
-  plan: MaintenanceAction[];
-  skipKeys?: string[];
+/** Every state the owned page's latest load can report. */
+declare const WEB_PAGE_STATES: readonly ["loading", "loaded", "failed"];
+/**
+ * The owned page's latest load, from the page-load marker in the workspace's web log: `url` is the document it
+ * loaded, `state` is `failed` when that document did not load or the page crashed, with the log message as
+ * `error`. `route`, present only when an in-app route change (history API or fragment) moved the page off `url`
+ * since the load, is the URL it shows now.
+ */
+interface WebPageState {
+  url: string;
+  state: (typeof WEB_PAGE_STATES)[number];
+  error?: string;
+  route?: string;
 }
-interface MaintenanceStatus {
-  mode: MaintenanceMode;
-  invalid?: string;
-  claim?: {
-    unresolved: string;
-    removeCommand: string;
-  };
-  lastChecks: {
-    pressure: number | null;
-    size: number | null;
-    worktree: number | null;
-    sweep: number | null;
-  };
-  pressure: MaintenancePressure | null;
-  sizes: MaintenanceSize[];
-  lastPass: MaintenancePass | null;
-  running: {
-    startedAt: string;
-    trigger: string;
-  } | null;
-  recent: MaintenanceRecord[];
-  plan: MaintenanceAction[];
+/**
+ * The workspace's Stim-owned Chrome. `pid` is Chrome's process and `supervisorPid` the Stim process that holds
+ * its DevTools session. `cdpEndpoint` is the loopback DevTools HTTP endpoint agents can attach to, and `targetId`
+ * the DevTools target of the owned page; both are null when the browser is not running. `profile` is the
+ * Stim-owned user data directory. `page` is null before the page's first load. `activity` names DevTools clients
+ * other than Stim's as drivers.
+ */
+interface WebBrowserState {
+  browser: "chrome";
+  version: string | null;
+  running: boolean;
+  pid: number | null;
+  supervisorPid: number | null;
+  url: string;
+  headless: boolean;
+  viewport: WebViewport;
+  profile: string;
+  cdpEndpoint: string | null;
+  targetId: string | null;
+  page?: WebPageState | null;
+  activity?: DeviceActivity;
 }
-/** Rejects missing, corrupt or unsupported payloads without throwing. */
-declare function parseMaintenanceState(value: unknown): MaintenanceState | null;
-declare function readMaintenanceState(): MaintenanceState | null;
-declare function readMaintenanceAttempt(): number | undefined;
-//#endregion
-//#region state/archive.d.ts
-interface ArchivedBytes {
-  logs: number;
-  recordings: number;
-  agentActions: number;
-  record: number;
-  total: number;
+/** The steps of `stim worktree warm`: `refresh` fast-forwards and installs in the source checkout, `copy` carries ignored entries. */
+type WarmStep = "refresh" | "copy";
+/**
+ * Where a workspace is in its lifecycle: `warming` while `stim worktree warm` runs in it, `ready` after a warm
+ * succeeded and before any `start`, `ios`, `android`, `web` or `reload` there, for at most two hours; `live` when
+ * anything it owns runs, else `idle`.
+ */
+declare const WORKSPACE_PHASES: readonly ["warming", "ready", "live", "idle"];
+type WorkspacePhase = (typeof WORKSPACE_PHASES)[number];
+/** A folder's size on disk as `status --watch` last measured it. */
+interface DiskMeasure {
+  bytes: number;
+  measuredAt: string;
 }
-interface ArchivedWorkspace {
-  id: string;
-  projectRoot: string;
-  project: string;
-  workspace: string;
-  worktree: {
-    repository: string | null;
-    branch: string | null;
-    head: string | null;
-    subject: string | null;
-    merged: boolean | null;
-    pullRequest: {
-      number: number;
-      state: string;
-      title: string;
-      url: string;
-    } | null;
-  };
-  removedAt: string;
-  removedBy: string;
-  lastUsedAt: string | null;
-  builds: {
-    count: number;
-    last: LastBuildReport | null;
-    lastErrorCount: number;
-  };
-  agents: EndedAgentSession[];
-  bytes: ArchivedBytes;
-  expires: {
-    logs: string | null;
-    recordings: string | null;
-    agentActions: string | null;
-    record: string | null;
-  };
-  version: number;
-  replacedBy?: string;
+/**
+ * An environment's disk use as `status --watch` last measured it. `worktreeBytes` is the git worktree folder, or the
+ * workspace folder outside one, node_modules included. `nodeModulesBytes` is node_modules at the worktree root and,
+ * when different, at the workspace path, and is part of `worktreeBytes`. `buildBytes` is Stim's own folder for the
+ * workspace: Xcode derived data, Gradle outputs and logs. A figure is null until it was measured; `measuredAt` is the
+ * oldest measurement.
+ */
+interface EnvironmentDisk {
+  worktreeBytes: number | null;
+  nodeModulesBytes: number | null;
+  buildBytes: number | null;
+  measuredAt: string;
 }
-interface ArchivedUsage {
-  count: number;
-  bytes: number;
-  byKind: {
-    logs: number;
-    recordings: number;
-    agentActions: number;
-    record: number;
+/**
+ * A Metro bundle request: `bundling` while one is in flight on the workspace's Metro, with its `platform`,
+ * `startedAt` and, when Metro reported progress for it, `percent` (0-100). `last` is the newest finished request,
+ * `durationMs` from request to response end.
+ */
+interface MetroBundleState {
+  bundling: boolean;
+  platform?: StatsPlatform;
+  startedAt?: string;
+  percent?: number;
+  last?: {
+    platform: StatsPlatform;
+    status: "ok" | "failed";
+    durationMs: number;
+    finishedAt: string;
   };
 }
-declare function readArchives(): ArchivedWorkspace[];
-/** Reads current archive files asynchronously, outside the synchronous state-read cache; cancellation propagates. */
-declare function readArchivesAsync(signal?: AbortSignal): Promise<ArchivedWorkspace[]>;
-declare function readArchive(id: string): ArchivedWorkspace | null;
-/** Reads a current archive without the synchronous state-read cache; invalid or missing records return null. */
-declare function readArchiveAsync(id: string, signal?: AbortSignal): Promise<ArchivedWorkspace | null>;
-declare function readArchiveState(id: string): WorkspaceState | null;
-declare function archivedUsage(archives: readonly ArchivedWorkspace[]): ArchivedUsage;
-declare function linkReplacedArchives(archives: readonly ArchivedWorkspace[], paths: readonly string[]): ArchivedWorkspace[];
-declare function archiveEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
-//#endregion
-//#region state/macos.d.ts
-interface MacosProcess {
-  pid: number;
-  processToken: string;
-  startedAtMicros: number;
+interface SimulatorState {
+  devicePlacement?: DevicePlacement;
+  host?: HostedIosStatus;
+  name: string | null;
+  udid: string;
+  owned: boolean;
+  state: string;
+  activity?: DeviceActivity;
+  app?: DeviceAppProcess;
+  appPresence?: AppPresence;
+  /** The simulator's data folder, for an owned simulator once measured. */
+  disk?: DiskMeasure;
+  /** Present while the device is not booted after idle shutdown or queue reclaim. */
+  idleShutdown?: DeviceIdleShutdownRecord;
 }
-interface MacosBuild {
-  state: "running" | "ok" | "failed";
-  startedAt: string;
-  finishedAt?: string;
-  durationMs?: number;
-  fingerprint?: string;
-  cacheKey?: string;
-  cacheHit?: boolean;
-  cacheSource?: "local" | "provider" | "peer";
-  error?: string;
-  errorCode?: string;
-  buildMachine?: string;
-  builtOn?: string;
-  offloadedTo?: string;
-  offloadFallback?: string;
+interface AndroidDeviceState {
+  devicePlacement?: DevicePlacement;
+  host?: HostedAndroidStatus;
+  name: string | undefined;
+  owned: boolean;
+  physical: boolean;
+  serial?: string | null;
+  state?: AndroidRuntimeFacts["state"] | "ready" | "stopped" | "unverified";
+  deviceProfile?: string | null;
+  activity?: DeviceActivity;
+  app?: DeviceAppProcess;
+  appPresence?: AppPresence;
+  /** The AVD's folder, for an owned emulator once measured. */
+  disk?: DiskMeasure;
+  /** Present while the emulator is not running after idle shutdown or queue reclaim. */
+  idleShutdown?: DeviceIdleShutdownRecord;
 }
-interface MacosAppRecord {
-  launchId: string;
-  arguments: string[];
-  product: string;
-  /** The app's visible name: the product and the workspace label. Absent in older records. */
-  displayName?: string;
-  bundle: string;
-  bundleId: string;
-  executable: string;
-  build: MacosBuild;
-  supervisor?: MacosProcess;
-  app?: MacosProcess;
-  /** Set when `stim macos --remote` reserved a session on another Mac; the app then has no local process. */
-  host?: HostedMacosPlacement;
-  /** Host launch evidence: true for a live app; status can override it in memory after probing the session. */
-  hostLaunched?: boolean | "unverified";
+/** The tutorial format version the installed Stim writes into the tutorial app. */
+declare const TUTORIAL_VERSION = 2;
+interface EnvironmentState {
+  slots?: {
+    slot: string;
+    ios: SimulatorState | null | undefined;
+    android: AndroidDeviceState | null | undefined;
+  }[];
+  path: string;
+  /** The 16-hex identity of the registered canonical project path, used by shared workspace links. */
+  workspaceId?: string;
+  /** Statically detected app platforms; always set by status, empty when none are detected. */
+  platforms?: string[];
+  /** Present when the app's app.json sets expo.extra.stimTutorial to a positive integer: that version. */
+  tutorial?: {
+    version: number;
+  };
+  /** When `stim doctor` last ran in this workspace, per platform; absent until it has run. */
+  doctorRuns?: Partial<Record<"ios" | "android", {
+    at: string;
+  }>>;
+  live: boolean;
+  phase?: WorkspacePhase;
+  /** When the warm started (`warming`) or finished (`ready`); null for `live` and `idle`. */
+  phaseSince?: string | null;
+  /** Whether stim-server may record this workspace's device screens, from `recording.enabled`. */
+  recording?: {
+    enabled: boolean;
+  };
+  /** Present when `workspace.hidden` is true: clients list the workspace under Hidden. */
+  hidden?: true;
+  /** Where the workspace is, from `workspaceStage`; `stim status --json` always sets it. */
+  stage?: WorkspaceStage;
+  /** The step a `warming` workspace's warm is in; absent in every other phase. */
+  warmStep?: WarmStep;
+  /**
+   * The memory this workspace's processes use, as `memorySource` says: the sum of its `machine` owners' `memoryMb`
+   * when status read their footprints, or else a fixed estimate per booted simulator, detected emulator, running
+   * Metro and running Chrome. `capacity.committedMb` sums it.
+   */
+  memoryMb: number;
+  /** How `memoryMb` was obtained; absent from payloads written before it existed, which carry the estimate. */
+  memorySource?: Exclude<MemorySource, "rss">;
+  warnings: string[];
+  issues: StatusIssue[];
+  ios?: SimulatorState | null;
+  android?: AndroidDeviceState | null;
+  metro?: {
+    port: number;
+    running: boolean;
+    pid: number | null;
+    tunnel?: {
+      provider: Exclude<TunnelMode, "auto" | "off" | "expo">;
+      url: string;
+    };
+    idleStop?: IdleStopRecord;
+    lastStop?: MetroLastStop;
+    /** The other process that answers Metro on `port`; `cwd` is null when its directory could not be read. */
+    heldBy?: {
+      pid: number;
+      cwd: string | null;
+    };
+    /** Absent when the Metro log holds no bundle request. */
+    bundle?: MetroBundleState;
+  } | null;
+  web?: WebBrowserState | null;
+  macos?: MacosAppState | null;
+  supervisor?: {
+    pid: number | null;
+    mode: string | null;
+    startedAt: string | null;
+    healthy: boolean;
+  } | null;
+  logs?: {
+    dir: string;
+    errorsSinceMarker: number;
+  } | null;
+  /** `installed` is whether the agent-device executable is on the PATH of the process that ran status. */
+  agentDevice?: {
+    stateDir: string;
+    installed?: boolean;
+  };
+  worktree?: WorktreeFacts | null;
+  remoteDevices?: RemoteDeviceState[];
+  /** The physical devices this workspace leases, in every slot; absent when it leases none. */
+  physicalDevices?: PhysicalDeviceState[];
+  build?: BuildReport | null;
+  lastBuilds?: Partial<Record<StatsPlatform, LastBuildReport>>;
+  /** Each platform's recent runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+  builds?: Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
+  disk?: EnvironmentDisk;
+  /** The coding-agent sessions working in the environment, most recently active first; absent when none. */
+  agents?: AgentSession[];
+  /** The agent sessions that stopped running here in the last 3 days, most recently ended first; absent when none. */
+  endedAgents?: EndedAgentSession[];
 }
-interface MacosAppState extends MacosAppRecord {
-  state: "running" | "orphaned" | "stopped" | "unverified";
+/** `committedMb` sums the environments' `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
+interface StatusCapacity {
+  liveCount: number;
+  committedMb: number;
+  totalMemoryMb: number;
+  overCapacity: boolean;
+  /** `concurrency.maxBuilds` usage; present only while that cap is set. */
+  builds?: StatusBuildSlots;
+  /** `concurrency.maxDevices` usage; present only while that cap is set. */
+  devices?: StatusDeviceSlots;
+  /** This machine's load. Optional only so payloads from releases that predate it still decode. */
+  load?: StatusCapacityLoad;
 }
-declare function parseMacosRecord(value: unknown): MacosAppRecord | null;
-declare function readMacosRecord(root: string): MacosAppRecord | null;
-declare function readHostedMacosApp(home: string): MacosAppRecord | null;
-declare function macosAppState(record: MacosAppRecord | null): MacosAppState | null;
-//#endregion
-//#region state/status.d.ts
-type StatsPlatform = "ios" | "android";
-/** A platform whose build reports phases: the stats platforms and `macos`. */
-type BuildPlatform = StatsPlatform | "macos";
-type RunOutcomeKind = "hit" | "cold";
-declare const BUILD_PHASES: readonly ["prepare", "cache-lookup", "wait", "prebuild", "pods", "compile", "device", "install", "launch"];
-type BuildPhase = (typeof BUILD_PHASES)[number];
-type ActiveBuildState = "running" | "stale" | "unknown";
 /**
- * Where a running build compiles: `local`, or the remote machine it was offloaded to, with the phase it is in there
- * (`sync`, `deps`, `prebuild`, `pods`, `build` or `fetch`) and when the offload and that phase started.
+ * `free` is under `busyAt` (`server.maxLoadPerCore`), where placement keeps work on this machine; `busy` is at or over
+ * it, where placement prefers another machine; `holding` is at or over `limit`, where new local native work waits.
  */
-type BuildPlacement = "local" | {
-  host: string;
-  phase: string;
-  startedAt: string;
-  phaseStartedAt: string;
-};
-interface BuildWaitingFor {
-  kind: "build-slot" | "device-slot";
-  inUse: number;
-  max: number;
-  since: string;
+type LoadState = "free" | "busy" | "holding";
+/**
+ * `loadPerCore` is the 5-minute load average divided by `cpus`, rounded to one decimal. `limit` is the load per core at
+ * which new local native work waits, null while no limit is configured.
+ */
+interface StatusCapacityLoad {
+  cpus: number;
+  loadPerCore: number;
+  busyAt: number;
+  limit: number | null;
+  state: LoadState;
 }
-interface BuildReport {
-  platform: BuildPlatform;
-  slot: string;
-  state: ActiveBuildState;
-  phase: BuildPhase;
-  startedAt: string;
-  phaseStartedAt: string;
-  outcome: RunOutcomeKind | null;
-  /** Whether `outcome` is this run's own; before its cache lookup resolves it is the project's latest outcome. */
-  outcomeKnown: boolean;
-  /** The resolved lookup result; absent before resolution and when the run skips cache lookup. */
-  cacheLookupOutcome?: "hit" | "miss";
-  expectedMs: number | null;
-  expectedPhaseMs: number | null;
-  /** Milliseconds spent in phases already left; sums repeat visits, excludes the current visit, and is omitted before any phase completes and by older Stim. */
-  completedPhaseMs?: Partial<Record<BuildPhase, number>>;
-  basis: number;
-  /**
-   * The phases a run like this one goes through, in order, with each one's median in milliseconds, from the same
-   * runs as `expectedMs`; null without comparable runs. The current phase can be one the plan does not list.
-   */
-  plannedPhases: PlannedPhase[] | null;
-  /** Why the run's cache lookup missed, once the run knows; `baseline` omits `cacheKey`. */
-  missReason?: BuildMissReason;
-  /**
-   * True while `missReason` is the miss of the key the run looked up first and the run will prebuild or install pods,
-   * then look the key up again. A hit on the second lookup removes `missReason` and sets `outcome` to `hit`.
-   */
-  missProvisional?: true;
-  /** What the native build tool is doing now, once it printed a line Stim recognizes. */
-  detail?: BuildDetail;
-  /** What the `device` or `launch` phase is waiting on, once Stim observed it; absent otherwise and from older Stim. */
-  activity?: BuildActivity;
-  placement: BuildPlacement;
-  /** While `phase` is `wait`: the workspace whose build of the same artifact this run waits on, when it is known. */
-  waitingOn?: {
-    path: string;
-  };
-  waitingFor?: BuildWaitingFor;
+/**
+ * A held build slot. `workspace` is the root of the local build holding it, `client` the device id of the client
+ * whose offloaded build this machine runs in it; both are null for a slot whose holder Stim cannot read.
+ */
+interface StatusBuildSlotHolder {
+  slot: number;
+  workspace: string | null;
+  client: string | null;
+  since: string | null;
+  unresolved?: true;
+}
+/** `inUse` counts the slots below `max` that a live or unresolved claim holds, which a new build cannot take. */
+interface StatusBuildSlots {
+  max: number;
+  inUse: number;
+  holders: StatusBuildSlotHolder[];
 }
 /**
- * What a run's `device` or `launch` phase is waiting on. `booting` lasts while the run waits for the owned simulator or
- * emulator it started booting. `bundling` starts when the app's bundle request reaches this workspace's
- * Metro and ends when Metro delivered it; `percent` is Metro's own progress for that request, present only once Metro
- * reported one. `waiting-ready` lasts while the app reports its readiness pending. `startedAt` is when the evidence was
- * recorded.
+ * An owned device counted against `concurrency.maxDevices`. `label` is the label of the workspace that records it, or
+ * the device's name when no workspace does; `workspace` and `slot` are null then.
  */
-interface BuildActivity {
-  name: "booting" | "bundling" | "waiting-ready";
-  startedAt: string;
-  percent?: number;
+interface StatusDeviceSlotHolder {
+  platform: "ios" | "android";
+  label: string;
+  workspace: string | null;
+  slot: string | null;
+  booting?: true;
 }
-/** One phase a running build is expected to go through, and its median duration in comparable runs. */
-interface PlannedPhase {
-  phase: BuildPhase;
-  expectedMs: number;
+/** `inUse` is null, with `unknown` saying why, when Stim cannot count the owned devices. */
+interface StatusDeviceSlots {
+  max: number;
+  inUse: number | null;
+  unknown?: string;
+  holders: StatusDeviceSlotHolder[];
+}
+interface DeviceLeaseState {
+  slot?: string;
+  path: string;
+  platform: string;
+  id: string | null;
+  deviceName: string | null;
+  holder: string | null;
+  grantedAt: string | null;
+  expiresAt: string | null;
+  mine: boolean;
+  expired: boolean;
+  parsed: boolean;
 }
-/** The native build tool's step inside a build's `compile` phase. */
-declare const NATIVE_BUILD_STEPS: readonly ["configure", "compile", "link", "resources", "script", "dex", "package", "sign"];
-type NativeBuildStep = (typeof NATIVE_BUILD_STEPS)[number];
 /**
- * A running build's progress as its tool reports it. `unit` is `targets` for xcodebuild, `tasks` for Gradle and
- * `steps` for SwiftPM. xcodebuild's `done` counts targets it finished and `total` the targets in its dependency graph,
- * which includes targets with nothing to do; Gradle's `done` counts the tasks it reported, with a null `total`;
- * SwiftPM's `done` and `total` are the `[done/total]` of its latest progress line, and its total can grow while it
- * builds. They are counts, not a completion fraction. `status` reports the detail only during the `compile` phase. `line` is
- * the latest compile, link or task line with paths shortened to file names.
+ * Where a memory figure comes from. `footprint` is each process's physical footprint, which Activity Monitor's Memory
+ * column shows. `rss` sums resident set sizes, which count pages shared between processes once per process, so a
+ * simulator reports well above its footprint; the machine owners fall back to it when the footprint helper cannot be
+ * built. `estimate` is a fixed amount per running thing, which an environment reports whenever it has no footprint.
  */
-interface BuildDetail {
-  step: NativeBuildStep | null;
-  unit: "targets" | "tasks" | "steps" | null;
-  done: number | null;
-  total: number | null;
-  line: string | null;
-  updatedAt: string;
+declare const MEMORY_SOURCES: readonly ["footprint", "rss", "estimate"];
+type MemorySource = (typeof MEMORY_SOURCES)[number];
+/** Every kind of process owner the status machine section reports. */
+declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "macos", "server", "shared"];
+type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
+/**
+ * One thing using this machine's CPU and memory now. Each process is counted in exactly one owner: the one whose root
+ * process is its nearest ancestor. `workspace` and `slot` (absent for the default slot) name the workspace a
+ * simulator, emulator, Metro, build or Chrome belongs to; a device no workspace records has a null workspace, and
+ * machine-wide processes are `shared`. `id` is the simulator's UDID, the emulator's AVD name, Metro's port as text,
+ * the build's platform, or null. `owned` is true only for what Stim started and stops: a workspace's owned device,
+ * Metro, build or Chrome. `cpuPercent` is `ps` %CPU summed over the owner's processes, where 100 is one core.
+ * `residentMb` sums their resident set sizes; pages shared between processes count once per process, so a
+ * simulator, whose processes all map the runtime's shared libraries, reports well above its physical footprint.
+ * `memoryMb` sums their physical footprints when `MachineUsageState.memorySource` is `footprint`, taking the resident
+ * size of a process the footprint helper could not read, and equals `residentMb` when it is `rss`.
+ */
+interface MachineOwner {
+  kind: MachineOwnerKind;
+  name: string;
+  workspace: string | null;
+  slot?: string;
+  id: string | null;
+  owned: boolean;
+  cpuPercent: number;
+  residentMb: number;
+  memoryMb: number;
+  processes: number;
 }
-/** Where a build's app came from: a cache tier, or `false` when it compiled or failed before one was found. */
-type BuildCacheHit = "local" | "remote" | false;
-/** A platform's most recent `ios` or `android` run in one workspace. */
-interface DevicePlacement {
-  decision: "local" | "hosted" | "waited-locally" | "eas";
-  reason: string;
-  machine?: string;
+/** Where this machine's CPU and memory go, from one pass over the host process table. */
+interface MachineUsageState {
+  memorySource: Exclude<MemorySource, "estimate">;
+  owners: MachineOwner[];
 }
-interface LastBuildReport {
-  devicePlacement?: DevicePlacement;
-  platform: BuildPlatform;
-  status: "ok" | "failed";
-  cacheHit: BuildCacheHit;
-  cacheSkipped: boolean;
-  durationMs: number | null;
-  fingerprint: string | null;
-  startedAt: string;
-  finishedAt: string | null;
-  errorCode?: string;
-  missReason?: BuildMissReason;
-  /** The selected auto, local, or configured machine entry; present on new build records, including cache hits. */
-  buildMachine?: string;
-  /** Where compilation ran: here or a machine name; absent when no build ran. */
-  builtOn?: string;
-  /** The remote machine that compiled the app when the build was offloaded. */
-  offloadedTo?: string;
-  /** Why the run built here after it considered offloading; absent when it offloaded or never considered it. */
-  offloadFallback?: string;
-  /** The first compiler diagnostics of a failed build, when the build tool reported any. */
-  diagnostics?: BuildDiagnostic[];
-  /** Present on a failed run: what failed, from `buildCause`. */
-  cause?: BuildCause;
+/** The payload `stim status --json` prints, and `status --watch --json` prints on each change. */
+interface StatusPayload {
+  maintenance?: MaintenanceStatus;
+  archived?: ArchivedWorkspace[];
+  archivedUsage?: ArchivedUsage;
+  environments: (EnvironmentState & {
+    labelOnly?: true;
+  })[];
+  capacity: StatusCapacity;
+  deviceLeases: DeviceLeaseState[];
+  unprovisionedWorktrees: WorktreeFacts[];
+  simctlAvailable: boolean;
+  /** Null when nothing runs that status attributes, so it read no process table, or when the table was unreadable. */
+  machine: MachineUsageState | null;
 }
+//#endregion
+//#region state/build-capacity.d.ts
+declare function buildSlotsDir(): string;
+declare function buildSlotPath(index: number): string;
 /**
- * A failed run's cause: the first diagnostic with a file and a line, keyed `file:line`, else the run's error code
- * (or `failed`), with null `file` and `line`. Consecutive failures with the same `key` failed the same way.
+ * Takes the first free one of `max` `concurrency.maxBuilds` slots, recording `details` and the slot `index`. Returns
+ * null while every slot is held; throws the claim refusal when no slot is busy but one cannot be resolved.
  */
-interface BuildCause {
-  key: string;
-  file: string | null;
-  line: number | null;
+declare function tryAcquireBuildSlotClaim({ max, details }: {
+  max: number;
+  details: Record<string, unknown>;
+}): {
+  claim: ClaimHandle;
+  index: number;
+  path: string;
+} | null;
+/**
+ * How busy this machine is for native builds. `loadPerCore` is the 5-minute load average divided by the CPU count,
+ * rounded to one decimal. `builds` counts this Stim home's runs that hold a live native-run claim and are in
+ * prebuild, pods or compile here, not on a remote machine, plus the build slots this machine holds for other machines'
+ * offloaded builds. `maxBuilds` is `concurrency.maxBuilds`, 0 when unlimited.
+ */
+interface MachineCapacity {
+  cpus: number;
+  loadPerCore: number;
+  builds: number;
+  maxBuilds: number;
+  maxLoadPerCore: number;
 }
-/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
-declare const BUILD_RESULTS: readonly ["succeeded", "failed", "cancelled", "interrupted"];
-type BuildResult = (typeof BUILD_RESULTS)[number];
+declare function maxLoadPerCore(): number;
+/** The 5-minute load average per CPU, rounded to one decimal, and the CPU count it divides by. */
+declare function loadPerCore(): {
+  cpus: number;
+  loadPerCore: number;
+};
+declare function loadState(load: number, busyAt: number, limit: number | null): LoadState;
+declare function machineCapacity(): MachineCapacity;
+/** Why a machine with this capacity should not take another native build; null when it can. */
+declare function saturation(capacity: MachineCapacity): string | null;
+//#endregion
+//#region state/build-machines.d.ts
 /**
- * One run in a workspace's recent build history. `configuration` is the iOS configuration or the Android
- * variant the run built, `Debug` or `debug` by default, and null when the run ended before resolving it.
- * `phases` holds the milliseconds spent in each phase the run entered. An interrupted run has null
- * `durationMs` and `finishedAt`, no cache facts, and 0 for the phase it stopped in.
+ * What this machine keeps about a remote machine it asked for access. `machine` is the `remote.machines` entry and
+ * `address` the name it resolved to. Once approved, `serverKey` is the worker's pinned stim-server key: every later
+ * connection must prove it holds that key. While pending, `ticket` is the setup ticket this machine generated or was
+ * given, and `expiresAt` its expiry when known. Records of protocol 1, which pinned a tailnet node, are not read.
  */
-interface BuildHistoryEntry extends LastBuildReport {
-  result: BuildResult;
-  slot: string;
-  configuration: string | null;
-  cacheKey: string | null;
-  phases: Partial<Record<BuildPhase, number>>;
-  /** A `stim macos` run's SwiftPM step total; absent for other runs and when the build reported none. */
-  compileSteps?: number;
+interface MachineCredential {
+  machine: string;
+  transport: "tailscale";
+  address: string;
+  state: "pending" | "approved";
+  requestedAt: string;
+  serverKey?: string;
+  deviceId?: string;
+  ticket?: string;
+  expiresAt?: string;
 }
-/** One compiler error from a failed build: where it is, when the tool said, and its message. */
-interface BuildDiagnostic {
-  file: string | null;
-  line: number | null;
-  column: number | null;
-  message: string;
+type BuildMachineCredential = MachineCredential;
+declare const MACHINE_CREDENTIALS_VERSION = 2;
+/** A stored credential, or null when it is malformed or from an older version. */
+declare function parseMachineCredential(value: unknown): MachineCredential | null;
+declare function readBuildMachines(): BuildMachineCredential[];
+//#endregion
+//#region state/client-identity.d.ts
+/** This machine's long-term X25519 key as a client of other machines, in `$STIM_HOME/client-identity.key`. */
+declare function clientIdentity(): NoiseKeyPair;
+//#endregion
+//#region state/config-types.d.ts
+type SettingsObject = Record<string, unknown>;
+interface SupervisorRecord {
+  processToken?: string;
+  pid?: number;
+  port?: number;
+  startedAt?: string;
+  serverPid?: number;
+  mode?: string;
+  [key: string]: unknown;
 }
-/** What kind of native input a changed fingerprint source is. */
-type BuildMissCategory = "native-dependency" | "config-plugin" | "app-config" | "app-asset" | "package" | "native-dir" | "autolinking" | "package-scripts" | "file" | "other";
-interface BuildMissChange {
-  source: string;
-  change: "added" | "removed" | "changed";
-  category: BuildMissCategory;
+interface IosDeviceRecord {
+  deviceUdid?: string;
+  deviceName?: string | null;
+  owned?: boolean;
+  serial?: string;
+  simslimManaged?: boolean;
+  simslimApplied?: {
+    profile: string;
+    springBoardPid: number;
+  };
+  schemeApprovals?: string[];
+  [key: string]: unknown;
+}
+interface AndroidDeviceRecord {
+  avdName?: string;
+  consolePort?: number;
+  serial?: string;
+  kind?: string;
+  deviceName?: string | null;
+  owned?: boolean;
+  setupIncomplete?: boolean;
+  bootPending?: boolean;
+  [key: string]: unknown;
 }
-/**
- * Why a run compiled instead of installing a cached app. `changes` holds at most 20 entries,
- * ordered by importance; `changeCount` is the full number of changed fingerprint sources.
- * Only a plan reports `prebuild-pending`: the run would prebuild before compiling, so the changes
- * compare the fingerprint before that prebuild.
- */
-interface BuildMissReason {
-  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error" | "prebuild-pending";
-  summary: string;
-  changes: BuildMissChange[];
-  changeCount: number;
-  /** `cacheKey` is kept in workspace state so a later miss can find this baseline; status omits it. */
-  baseline: {
-    fingerprint: string;
-    cacheKey?: string;
-    from: "workspace" | "project";
-  } | null;
-  rekeyedBy: string[];
+type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
+interface PlatformRecords {
+  ios?: IosDeviceRecord;
+  android?: AndroidDeviceRecord;
+  [platform: string]: DeviceRecord | undefined;
 }
-/** The payload `stim ios --plan --json` and `stim android --plan --json` print. */
-interface BuildPlanPayload {
-  platform: StatsPlatform;
-  slot?: string;
-  fingerprint: string;
-  cacheKey: string | null;
-  cacheHit: BuildCacheHit;
-  provider: string | null;
-  cacheSkipped: boolean;
-  prebuild: "none" | "generate" | "regenerate" | "refuse" | null;
-  outcome: RunOutcomeKind | null;
-  expectedMs: number | null;
-  basis: number;
-  /** On a predicted miss with cache reads on, why the cache has no app; `baseline` omits `cacheKey`. */
-  missReason?: BuildMissReason;
-  refusal?: {
-    code: string;
-    message: string;
-    remedy: string;
-  };
-  /** With ios.remote or android.remote set to auto or a Mac, where the plan assumes the device runs, such as `this machine; auto may use janics-mac-mini`. */
-  placement?: string;
+interface ProjectRecord {
+  ports?: Record<string, number>;
+  metroPort?: number | null;
+  platforms?: PlatformRecords;
+  deviceSlots?: Record<string, PlatformRecords>;
+  supervisor?: SupervisorRecord;
+  settings?: SettingsObject;
+  worktreeRoot?: boolean;
+  worktreeBranch?: string;
+  worktreeBranchOwned?: boolean;
+  worktreeMainRoot?: string;
+  worktreeRemovalComplete?: boolean;
+  worktreePendingBranchSha?: string;
+  label?: string;
+  bundleId?: string;
+  androidPackage?: string;
+  isExpo?: boolean;
+  lastBuild?: Record<string, unknown>;
+  doctorRuns?: Partial<Record<"ios" | "android", DoctorRunRecord>>;
+  [key: string]: unknown;
 }
-/** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
-interface MacosBuildPlanPayload {
-  platform: "macos";
-  product: string;
-  buildMachine: string;
-  fingerprint: string | null;
-  cacheKey: string | null;
-  cacheHit: boolean;
-  provider: null;
-  cacheSkipped: boolean;
-  prebuild: null;
-  outcome: null;
-  expectedMs: null;
-  basis: number;
+interface DoctorRunRecord {
+  at: string;
+  version: string;
 }
-type ActivityState = "driven" | "active" | "idle" | "unknown";
-interface ActivityDriver {
-  tool: string;
-  pid: number | null;
-  since: string | null;
+interface RepoRecord {
+  settings?: SettingsObject;
+  [key: string]: unknown;
 }
-/** The kinds of evidence that date a device's last activity, in the order `recent` lists them. */
-declare const ACTIVITY_RECENCY_BASES: readonly ["agent-action", "device-log", "metro-bundle", "workspace-use", "supervisor-start", "page-log", "viewer"];
-type ActivityRecencyBasis = (typeof ACTIVITY_RECENCY_BASES)[number];
-interface DeviceActivity {
-  state: ActivityState;
-  driver?: ActivityDriver;
-  lastActivityAt?: string;
-  /** The newest time of each kind of evidence behind `lastActivityAt`, so a reader can leave out app log chatter. */
-  recent?: Partial<Record<ActivityRecencyBasis, string>>;
-  basis: string[];
+interface ConcurrencyLimits {
+  maxBuilds: number;
+  maxDevices: number;
 }
-/** Every state a device's app process can report. */
-declare const APP_PROCESS_STATES: readonly ["running", "stopped", "unknown"];
-/**
- * Whether the workspace's app process is alive on a device now. This is current process state, not launch evidence:
- * `launched` in an `ios` or `android` result stays the record of one launch. `id` is the bundle identifier or
- * package that was checked; `state` is "unknown" when the process listing could not be read.
- */
-interface DeviceAppProcess {
-  id: string;
-  state: (typeof APP_PROCESS_STATES)[number];
+interface StimConfig {
+  version?: number;
+  homeId?: string;
+  projects: Record<string, ProjectRecord>;
+  repos: Record<string, RepoRecord>;
+  tempDir?: unknown;
+  iosSimulatorApp?: unknown;
+  androidEmulatorApp?: unknown;
+  optimizations?: unknown;
+  concurrency?: {
+    maxBuilds?: unknown;
+    maxDevices?: unknown;
+  };
+  pool?: {
+    iosParkedMax?: unknown;
+    androidParkedMax?: unknown;
+  };
+  parked?: {
+    ios?: unknown;
+    android?: unknown;
+  };
+  caches?: {
+    buildCache?: unknown;
+    metroCache?: unknown;
+  };
+  hosting?: {
+    agentDriver?: unknown;
+  };
+  debug?: {
+    logs?: unknown;
+  };
+  server?: {
+    buildsPaused?: unknown;
+    devicesPaused?: unknown;
+    acceptClientBuilds?: unknown;
+    maxLoadPerCore?: unknown;
+    workerRoot?: unknown;
+    gradleDaemonIdleMinutes?: unknown;
+  };
+  remote?: {
+    machines?: unknown;
+    easMaxDurationMinutes?: unknown;
+    build?: unknown;
+    buildPoolDisabled?: unknown;
+    devicePoolDisabled?: unknown;
+  };
+  [key: string]: unknown;
 }
+type Config = StimConfig;
+//#endregion
+//#region state/automatic-pools.d.ts
+type AutomaticPoolRole = "build" | "device";
+declare function automaticMachineEnabled(role: AutomaticPoolRole, machine: string, config?: StimConfig | null): boolean;
+declare function requireAutomaticMachine(role: AutomaticPoolRole, machine: string): void;
 /**
- * A linked worktree's `git status`. `changed` counts tracked paths with staged or unstaged changes, including
- * conflicts; `untracked` counts untracked entries as `git status` lists them, so an untracked directory counts once.
- * `ahead` and `behind` compare HEAD with `upstream`, and are null when there is no upstream or it no longer exists.
- * `mergedInto` names the default branch (`origin/main`) when `gc` would consider the branch merged into it, judged
- * from local refs without fetching.
+ * Refuses a pool with no enabled member: local, or a configured remote approved for the role. `canHost` excludes
+ * device-pool remotes that can never host, such as a Linux machine.
  */
-interface WorktreeGit {
-  changed: number;
-  untracked: number;
-  upstream: string | null;
-  ahead: number | null;
-  behind: number | null;
-  mergedInto: string | null;
-}
+declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig, canHost?: (machine: string) => boolean): void;
+//#endregion
+//#region state/config.d.ts
+declare function withConfigLock<T>(fn: () => T): T;
+/** Waits for the config lock without blocking the event loop. The signal cancels acquisition; `fn` runs synchronously. */
+declare function withConfigLockAsync<T>(fn: () => T, signal?: AbortSignal): Promise<T>;
+declare function configCorruptRepair(path?: string): string;
+/** The build worker root: `server.workerRoot` when it is absolute, else `$STIM_HOME/build-worker`. */
+declare function buildWorkerRoot(config?: Config | null): string;
 /**
- * The GitHub pull request of a worktree's branch and HEAD, as `status --watch` last looked it up through `gh`.
- * `state` is `draft` for an open draft. `checks` counts the head commit's check runs and commit statuses, null when it
- * has none. `checkedAt` is when Stim last asked GitHub.
+ * A short directory at the drive root that stands in for the build worker directory `path` on Windows. The NDK's
+ * ninja is not long-path aware (STIM_PATH_TOO_LONG), and it opens paths under the checkout and under the Gradle user
+ * home's transforms cache, both of which are too long under the worker root. A subst drive does not help: Node's
+ * native realpath, which expo-modules-autolinking uses, resolves it back to the long path.
  */
-interface WorktreePullRequest {
-  number: number;
-  url: string;
-  title: string;
-  state: "open" | "draft" | "merged" | "closed";
-  checks: {
-    passing: number;
-    failing: number;
-    pending: number;
-  } | null;
-  reviewDecision: "approved" | "changes-requested" | "review-required" | null;
-  checkedAt: string;
-}
-interface WorktreeFacts {
-  path: string;
-  branch?: string;
-  repository?: string;
-  /** Null when git could not be read in time, the worktree is in a folder status does not open, or one-shot status skipped an idle environment or an unprovisioned worktree. */
-  git?: WorktreeGit | null;
-  /** Null when GitHub has no pull request for the branch; absent when unknown, such as without `gh`. */
-  pullRequest?: WorktreePullRequest | null;
-  /** Present with `git`: what the worktree's git chip shows, from `gitChip`. */
-  gitChip?: GitChip;
+declare function windowsShortDir(path: string, systemDrive?: string): string;
+/** The ASCII key a Windows build worker records beside a `windowsShortDir` to tell which `kind` and `path` it serves. */
+declare function windowsShortDirKey(kind: "checkout" | "gradle", path: string): string;
+declare function loadConfig(): Config | null;
+declare function getProject(projectPath: string): ProjectRecord | null;
+declare function getConcurrencyLimits({ env }?: {
+  env?: NodeJS.ProcessEnv;
+}): ConcurrencyLimits;
+interface ParkedMax {
+  max: number;
+  error: string | null;
 }
-/** Every coding-agent tool whose sessions status can attribute to an environment. */
-declare const AGENT_TOOLS: readonly ["claude-code", "codex"];
-type AgentTool = (typeof AGENT_TOOLS)[number];
-/**
- * A coding-agent session working in an environment: one whose working directory `cwd` is the environment's path,
- * inside it, or its git worktree root, or one that ran a Stim command in it. `title` is the short name the tool keeps
- * for the session, never its conversation. `lastActiveAt` is the tool's own last update, or the Stim command's time
- * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this machine.
- * `webUrl` opens a Claude Code session with Remote Control connected on claude.ai/code or in the Claude mobile app.
- */
-interface AgentSession {
-  tool: AgentTool;
-  sessionId: string;
-  title?: string;
-  cwd: string;
-  startedAt?: string;
-  lastActiveAt?: string;
-  pid?: number;
-  openUrl?: string;
-  webUrl?: string;
+declare function getParkedMax(platform: "ios" | "android", { config, env }?: {
+  config?: Config | null;
+  env?: NodeJS.ProcessEnv;
+}): ParkedMax;
+declare function getProjectSettings(projectPath: string): Record<string, unknown>;
+declare function getRepoSettings(gitCommonDir: string): Record<string, unknown>;
+declare function isPathPrefix(prefix: string, path: string): boolean;
+declare function findEnclosingWorktreeRoot(projectPath: string): string | null;
+declare function allMetroPorts(): number[];
+//#endregion
+//#region state/debug-log.d.ts
+declare const DEBUG_ENV = "STIM_DEBUG";
+declare function debugLogDir(): string;
+/** The `STIM_DEBUG` override (1/true on, 0/false off, anything else off), else the machine setting `debug.logs`. Never throws. */
+declare function debugLoggingEnabled(env?: NodeJS.ProcessEnv): boolean;
+interface DebugLog {
+  /** Whether debug logging is on right now; re-read every few seconds so a long-running process follows the setting. */
+  enabled(): boolean;
+  /** Appends one record to `$STIM_HOME/logs/debug/<component>.ndjson` when enabled. Never throws; keys that look like secrets are redacted. */
+  log(event: string, fields?: Record<string, unknown>): void;
 }
 /**
- * An agent session that stopped running in an environment, with the details Stim last found while it ran. `endedAt`
- * is the last time a status watcher found it running.
+ * Debug-level records for one component (`cli` or `server`). Off by default; `STIM_DEBUG=1` or `debug.logs` turns it
+ * on. Callers pass names, durations and codes, never arguments, environment values, tokens or tickets.
  */
-interface EndedAgentSession extends Omit<AgentSession, "pid"> {
-  endedAt: string;
-}
-interface AndroidRuntimeFacts {
-  serial: string | null;
-  state: "detected" | "not-detected" | "missing" | "unknown";
-  error?: string;
-}
-/** Every connection state a physical device can report. */
-declare const PHYSICAL_DEVICE_CONNECTIONS: readonly ["connected", "disconnected", "unknown"];
-type PhysicalDeviceConnection = (typeof PHYSICAL_DEVICE_CONNECTIONS)[number];
+declare function createDebugLog(component: "cli" | "server", { env, now, base }?: {
+  env?: NodeJS.ProcessEnv;
+  now?: () => number;
+  base?: () => Record<string, unknown>;
+}): DebugLog;
+//#endregion
+//#region state/trace.d.ts
+declare const TRACE_ENV = "STIM_TRACE";
+/**
+ * `args` with the value of any flag or assignment that looks like a secret, credentials in URLs, token shapes and
+ * the `exact` values replaced. `program` selects the flags that carry a credential without a secret-looking name,
+ * such as `curl -u`.
+ */
+declare function redactArgv(args: readonly string[], exact?: readonly string[], program?: string): string[];
+/** A shell command line with the same redactions as `redactArgv`, clipped to a fixed length. */
+declare function redactCommandLine(command: string, exact?: readonly string[]): string;
+type TraceArgs = Record<string, unknown>;
+type EndSpan = (args?: TraceArgs) => void;
+type Args = TraceArgs;
+interface TracePhases {
+  /** Ends the phase in progress and starts `name`; entering the phase already in progress does nothing. */
+  enter(name: string, args?: Args): void;
+  end(args?: Args): void;
+}
+interface Trace {
+  enabled(): boolean;
+  /** Starts a span; the returned function ends it, with optional extra args. */
+  begin(name: string, args?: TraceArgs): EndSpan;
+  /** `begin` for the outermost span of a process: it ends at exit with the exit code. */
+  command(name: string, args?: TraceArgs): void;
+  /** `begin` for a child process: same event with the `exec` category. */
+  beginExec(name: string, args?: TraceArgs): EndSpan;
+  /** Runs `fn` inside a span and ends it when `fn` returns or throws. */
+  span<T>(name: string, fn: () => T, args?: TraceArgs): T;
+  /** `span` for an async `fn`: ends when its promise settles. */
+  spanAsync<T>(name: string, fn: () => Promise<T>, args?: TraceArgs): Promise<T>;
+  mark(name: string, args?: TraceArgs): void;
+  /** A strip of consecutive, non-overlapping phases on its own track. */
+  phases(track: string): TracePhases;
+}
+/**
+ * Timing spans for one stim process tree, written as Chrome trace events (open the file in Perfetto or
+ * chrome://tracing) when `STIM_TRACE=<path>` is set. Unset, every call is one environment check. A stim command
+ * (`trace.command`) truncates the file and writes `[`; every other process that inherits the variable appends one
+ * event per line, creating the file if it is missing, so the file has no closing bracket. Child process arguments are written through `redactArgv`.
+ */
+declare const trace: Trace;
+//#endregion
+//#region state/home-identity.d.ts
+/** The persistent, nonsecret identity of this Stim home; null until the CLI initializes it. */
+declare function readHomeIdentity(config?: Config | null): string | null;
+//#endregion
+//#region state/json-file.d.ts
 /**
- * A physical iPhone, iPad or Android phone the workspace holds an unexpired lease on, from `ios --device`,
- * `android --device` or `device lock`. Stim uses it and never owns it, so `owned` is always false. `id` is the
- * UDID or adb serial. `name` is the device's own name, falling back to the name the lease recorded; `model` is the
- * marketing name devicectl reports, null when it could not be read, or the Android model the lease recorded.
- * `connection` is `connected` when devicectl can reach the phone or adb lists it as `device`, `disconnected` when
- * the tool answered without it, and `unknown` when the tool could not be read in time. `lease.holder` is the
- * workspace path that holds it.
+ * 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.
  */
-interface PhysicalDeviceState {
-  platform: StatsPlatform;
-  slot: string;
-  id: string;
-  name: string | null;
-  model: string | null;
-  owned: false;
-  physical: true;
-  connection: PhysicalDeviceConnection;
-  lease: {
-    holder: string;
-    kind: "declared" | "run";
-    grantedAt: string | null;
-    expiresAt: string;
-  };
+declare function withStateReadCache<T>(fn: () => T): T;
+declare function readStateFile(path: string): string;
+declare function readJsonFile(path: string): unknown;
+declare function isJsonObject(value: unknown): value is Record<string, unknown>;
+declare function readJsonObject(path: string): Record<string, unknown> | null;
+//#endregion
+//#region state/ledgers.d.ts
+type CreatedDevicePlatform = "ios" | "android" | "web";
+/** `web` lists the absolute paths of browser profile directories Stim created. */
+interface CreatedDevices {
+  ios: ReadonlySet<string>;
+  android: ReadonlySet<string>;
+  web: ReadonlySet<string>;
 }
-interface RemoteDeviceState {
-  platform: "ios" | "android" | null;
-  backend: "eas";
+declare function readCreatedDevices(): CreatedDevices;
+interface EasSessionClaim {
   sessionId: string;
-  state: "claimed" | "unclaimed" | "unknown";
-  startedAt: string | null;
-  webPreviewUrl: string | null;
+  name: string;
+  platform: "ios" | "android";
+  workspaceRoot: string;
+  workspaceHome: string;
+  stateFile: string;
 }
-/**
- * One part of a worktree's git chip, in display order: commits ahead of and behind the upstream, uncommitted files
- * (changed plus untracked), the base branch the branch is merged into (left out when its pull request is merged,
- * whose own mark says so), and a branch with no upstream that is not merged.
- */
-type GitChipPart = {
-  kind: "arrows";
-  ahead: number;
-  behind: number;
-} | {
-  kind: "changed";
-  count: number;
-} | {
-  kind: "merged";
-  into: string;
-} | {
-  kind: "no-upstream";
-};
-/** A pull request's checks at a glance: any failing, else any pending, else any passing; null without checks. */
-type ChecksState = "passing" | "failing" | "pending" | null;
-interface GitChip {
-  parts: GitChipPart[];
-  ci: ChecksState;
+interface EasSessionLedgerRead {
+  claims: Map<string, EasSessionClaim>;
+  notice: string | null;
+  safe: boolean;
 }
+/** Returns the claim normalized to canonical paths, or null when it is not a valid claim for `id`. */
+declare function validEasSessionClaim(id: string, value: unknown): EasSessionClaim | null;
+declare function readEasSessionLedger(root?: string): EasSessionLedgerRead;
+//#endregion
+//#region state/error-entries.d.ts
 /**
- * Whether a running owned simulator or emulator lacks the workspace's app: `none` when its platform never built
- * successfully here and the latest build failed, `closed` when status saw no app process, else null.
- */
-type AppPresence = "none" | "closed" | null;
-declare const WORKSPACE_STAGE_KINDS: readonly ["building", "warming", "ready", "build-failed", "running", "stopped"];
-/**
- * Where a workspace is, first match wins: `building` while a build runs, `warming` and `ready` from `phase` when
- * nothing is live, `build-failed` when the newest run of either platform failed, `running` when it is live, its
- * macOS app is running or orphaned, or it holds a remote device, else `stopped`. `since` is when that began: the
- * build's start, the warm phase's time, the failed run's end (else start), the supervisor's start (else the running
- * macOS app's build end, else its start), or Metro's last stop. `platform` names the build for `building`
- * and `build-failed`. `closedApps` lists, for `running`, the devices whose `appPresence` is `closed`.
+ * The number of rows a log list shows for `records`, an error query's result in log order. Stim Desktop's
+ * `LogEntryList` and the phone's `groupRecords` group the same way and replay the same vectors: in Expo's dev
+ * server one failed bundle is a `Bundling failed` marker line, the error line and a failed bundle response,
+ * which the apps list as one row, and every other record is its own row.
  */
-interface WorkspaceStage {
-  kind: (typeof WORKSPACE_STAGE_KINDS)[number];
-  since: string | null;
-  platform: StatsPlatform | "macos" | null;
-  closedApps: {
-    platform: StatsPlatform;
-    slot: string;
-  }[];
+declare function countErrorEntries(records: readonly NdjsonRecord[]): number;
+//#endregion
+//#region state/fingerprint-memo.d.ts
+declare const FINGERPRINT_MEMO_SCHEMA = 1;
+/** Full native fingerprints shared by every workspace of this Stim home, one file per platform and static digest. */
+declare function fingerprintMemoDir(platform?: string): string;
+declare function fingerprintMemoFile(platform: string, digest: string): string;
+declare function fingerprintMemoLock(): string;
+/** The full fingerprint a tree with this static digest produced, written by the CLI. */
+interface FingerprintMemoRecord {
+  schema: typeof FINGERPRINT_MEMO_SCHEMA;
+  platform: string;
+  digest: string;
+  recordedAt: number;
+  hash: string;
+  sources: unknown[];
+  /** The packages the static check counted as native, to name the ones a disagreeing check found it missed. */
+  nativePackages: string[];
 }
-/** Every code a status issue can carry. */
-declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "android-reverse-missing", "supervisor-unverified", "browser-unverified", "browser-orphaned"];
-type StatusIssueCode = (typeof STATUS_ISSUE_CODES)[number];
-/**
- * One thing in a workspace that needs the user, or with severity `info` a note that needs nothing. `remedy` is a
- * command to run from `workspace`; `slot` is absent for the default device slot. `warnings` carries the `error` and
- * `warning` issues as text.
- *
- * Severity:
- * - `error`: Stim cannot verify or safely act on something; a person resolves it, following the teardown guide.
- * - `warning`: something is broken now and needs someone to act, such as an app that cannot reach Metro, a held
- *   port or a device that vanished while expected.
- * - `info`: a fact the next normal Stim command handles by itself, so it needs no action.
- *
- * The phone app and Stim Desktop show `error` and `warning` and hide `info`; plain `stim status` prints `info` as a
- * dim note with no remedy.
- */
-interface StatusIssue {
-  code: StatusIssueCode;
-  severity: "error" | "warning" | "info";
-  message: string;
-  remedy: string;
-  workspace: string;
-  slot?: string;
+declare function readFingerprintMemo(platform: string, digest: string): FingerprintMemoRecord | null;
+//#endregion
+//#region state/logs-query.d.ts
+interface SinceResult {
+  ms?: number;
+  error?: string;
 }
-/** Every state the owned page's latest load can report. */
-declare const WEB_PAGE_STATES: readonly ["loading", "loaded", "failed"];
-/**
- * The owned page's latest load, from the page-load marker in the workspace's web log: `url` is the document it
- * loaded, `state` is `failed` when that document did not load or the page crashed, with the log message as
- * `error`. `route`, present only when an in-app route change (history API or fragment) moved the page off `url`
- * since the load, is the URL it shows now.
- */
-interface WebPageState {
-  url: string;
-  state: (typeof WEB_PAGE_STATES)[number];
+interface GrepResult {
+  re?: RegExp;
   error?: string;
-  route?: string;
 }
-/**
- * The workspace's Stim-owned Chrome. `pid` is Chrome's process and `supervisorPid` the Stim process that holds
- * its DevTools session. `cdpEndpoint` is the loopback DevTools HTTP endpoint agents can attach to, and `targetId`
- * the DevTools target of the owned page; both are null when the browser is not running. `profile` is the
- * Stim-owned user data directory. `page` is null before the page's first load. `activity` names DevTools clients
- * other than Stim's as drivers.
- */
-interface WebBrowserState {
-  browser: "chrome";
-  version: string | null;
-  running: boolean;
-  pid: number | null;
-  supervisorPid: number | null;
-  url: string;
-  headless: boolean;
-  viewport: WebViewport;
-  profile: string;
-  cdpEndpoint: string | null;
-  targetId: string | null;
-  page?: WebPageState | null;
-  activity?: DeviceActivity;
+interface MarkerWindow {
+  launchTs: number | null;
+  bundleTs: number | null;
+  pageLoadTs: number | null;
 }
-/** The steps of `stim worktree warm`: `refresh` fast-forwards and installs in the source checkout, `copy` carries ignored entries. */
-type WarmStep = "refresh" | "copy";
-/**
- * Where a workspace is in its lifecycle: `warming` while `stim worktree warm` runs in it, `ready` after a warm
- * succeeded and before any `start`, `ios`, `android`, `web` or `reload` there, for at most two hours; `live` when
- * anything it owns runs, else `idle`.
- */
-declare const WORKSPACE_PHASES: readonly ["warming", "ready", "live", "idle"];
-type WorkspacePhase = (typeof WORKSPACE_PHASES)[number];
-/** A folder's size on disk as `status --watch` last measured it. */
-interface DiskMeasure {
-  bytes: number;
-  measuredAt: string;
+interface QueryCriteria {
+  slot?: string;
+  includeAppDeviceErrors?: boolean;
+  sources?: string[];
+  minLevel?: string;
+  grep?: RegExp;
+  sinceTs?: number;
+  errorsOnly?: boolean;
+  markerTs?: number;
+  bundleMarkerTs?: number;
+}
+interface TailState {
+  offset: number;
+  partial: string;
 }
+declare function parseSince(text: unknown): SinceResult;
+declare function compileGrep(pattern: unknown): GrepResult;
+declare const ERROR_SOURCES: string[];
+declare function markerWindow(records: NdjsonRecord[]): MarkerWindow;
 /**
- * An environment's disk use as `status --watch` last measured it. `worktreeBytes` is the git worktree folder, or the
- * workspace folder outside one, node_modules included. `nodeModulesBytes` is node_modules at the worktree root and,
- * when different, at the workspace path, and is part of `worktreeBytes`. `buildBytes` is Stim's own folder for the
- * workspace: Xcode derived data, Gradle outputs and logs. A figure is null until it was measured; `measuredAt` is the
- * oldest measurement.
+ * The platform a bundle marker speaks for, lowercased: its `platform` field, or the tag @expo/cli prints before
+ * "Bundled" ("iOS", "Android", "Web", "RSC(iOS)" as ios, or an environment tag such as "DOM"). Null when unknown.
  */
-interface EnvironmentDisk {
-  worktreeBytes: number | null;
-  nodeModulesBytes: number | null;
-  buildBytes: number | null;
-  measuredAt: string;
-}
+declare function bundleMarkerPlatform(record: NdjsonRecord): string | null;
+declare function recordMatches(record: NdjsonRecord | null | undefined, criteria?: QueryCriteria): boolean;
+declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now }?: {
+  slot?: string;
+  sources?: string[];
+  minLevel?: string;
+  since?: string | null;
+  grep?: string | RegExp | null;
+  errorsOnly?: boolean;
+  markerTs?: number;
+  bundleMarkerTs?: number;
+  now?: number;
+}): QueryCriteria;
+declare function logFiles(dir: string): string[];
+declare function fileSizes(dir: string): Record<string, number>;
+declare function readLogRecords(dir: string, include?: (name: string) => boolean): NdjsonRecord[];
+declare const NATIVE_CRASH_LOG_PREFIX = "native-crash-";
+/** Reads the CLI timeline with retained native crash records after other records at the same timestamp. */
+declare function readLogTimeline(dir: string, records?: NdjsonRecord[]): NdjsonRecord[];
+declare function isExpoErrorContext(record: NdjsonRecord, event: unknown): boolean;
+type ExpoContextTarget = "msg" | "field";
 /**
- * A Metro bundle request: `bundling` while one is in flight on the workspace's Metro, with its `platform`,
- * `startedAt` and, when Metro reported progress for it, `percent` (0-100). `last` is the newest finished request,
- * `durationMs` from request to response end.
+ * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
+ * `msg` or as a `context` string array.
  */
-interface MetroBundleState {
-  bundling: boolean;
-  platform?: StatsPlatform;
-  startedAt?: string;
-  percent?: number;
-  last?: {
-    platform: StatsPlatform;
-    status: "ok" | "failed";
-    durationMs: number;
-    finishedAt: string;
-  };
-}
-interface SimulatorState {
-  devicePlacement?: DevicePlacement;
-  host?: HostedIosStatus;
-  name: string | null;
-  udid: string;
-  owned: boolean;
-  state: string;
-  activity?: DeviceActivity;
-  app?: DeviceAppProcess;
-  appPresence?: AppPresence;
-  /** The simulator's data folder, for an owned simulator once measured. */
-  disk?: DiskMeasure;
-  /** Present while the device is not booted after idle shutdown or queue reclaim. */
-  idleShutdown?: DeviceIdleShutdownRecord;
-}
-interface AndroidDeviceState {
-  devicePlacement?: DevicePlacement;
-  host?: HostedAndroidStatus;
-  name: string | undefined;
-  owned: boolean;
-  physical: boolean;
-  serial?: string | null;
-  state?: AndroidRuntimeFacts["state"] | "ready" | "stopped" | "unverified";
-  deviceProfile?: string | null;
-  activity?: DeviceActivity;
-  app?: DeviceAppProcess;
-  appPresence?: AppPresence;
-  /** The AVD's folder, for an owned emulator once measured. */
-  disk?: DiskMeasure;
-  /** Present while the emulator is not running after idle shutdown or queue reclaim. */
-  idleShutdown?: DeviceIdleShutdownRecord;
+declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
+interface LogQueryOptions {
+  slot?: string;
+  sources?: string[];
+  minLevel?: string;
+  since?: string;
+  grep?: string | RegExp;
+  errorsOnly?: boolean;
+  now?: number;
 }
-/** The tutorial format version the installed Stim writes into the tutorial app. */
-declare const TUTORIAL_VERSION = 2;
-interface EnvironmentState {
-  slots?: {
-    slot: string;
-    ios: SimulatorState | null | undefined;
-    android: AndroidDeviceState | null | undefined;
-  }[];
-  path: string;
-  /** The 16-hex identity of the registered canonical project path, used by shared workspace links. */
-  workspaceId?: string;
-  /** Statically detected app platforms; always set by status, empty when none are detected. */
-  platforms?: string[];
-  /** Present when the app's app.json sets expo.extra.stimTutorial to a positive integer: that version. */
-  tutorial?: {
-    version: number;
-  };
-  /** When `stim doctor` last ran in this workspace, per platform; absent until it has run. */
-  doctorRuns?: Partial<Record<"ios" | "android", {
-    at: string;
-  }>>;
-  live: boolean;
-  phase?: WorkspacePhase;
-  /** When the warm started (`warming`) or finished (`ready`); null for `live` and `idle`. */
-  phaseSince?: string | null;
-  /** Whether stim-server may record this workspace's device screens, from `recording.enabled`. */
-  recording?: {
-    enabled: boolean;
-  };
-  /** Present when `workspace.hidden` is true: clients list the workspace under Hidden. */
-  hidden?: true;
-  /** Where the workspace is, from `workspaceStage`; `stim status --json` always sets it. */
-  stage?: WorkspaceStage;
-  /** The step a `warming` workspace's warm is in; absent in every other phase. */
-  warmStep?: WarmStep;
+interface LogQueryPlan {
+  /** Whether a record belongs to the queried slot's timeline, before any other filter. */
+  inTimeline: (record: NdjsonRecord) => boolean;
+  matches: (record: NdjsonRecord) => boolean;
+  launchTs: number | null;
+  sinceTs: number | undefined;
   /**
-   * The memory this workspace's processes use, as `memorySource` says: the sum of its `machine` owners' `memoryMb`
-   * when status read their footprints, or else a fixed estimate per booted simulator, detected emulator, running
-   * Metro and running Chrome. `capacity.committedMb` sums it.
+   * Whether no record with a timestamp at most `maxTs`, or without one when `maxTs` is Infinity, can match.
+   * `slots` lists every `slot ?? 'default'` value the records can carry; without it, a query that depends on
+   * per-slot launch markers cannot rule out any timestamp.
    */
-  memoryMb: number;
-  /** How `memoryMb` was obtained; absent from payloads written before it existed, which carry the estimate. */
-  memorySource?: Exclude<MemorySource, "rss">;
-  warnings: string[];
-  issues: StatusIssue[];
-  ios?: SimulatorState | null;
-  android?: AndroidDeviceState | null;
-  metro?: {
-    port: number;
-    running: boolean;
-    pid: number | null;
-    tunnel?: {
-      provider: Exclude<TunnelMode, "auto" | "off" | "expo">;
-      url: string;
-    };
-    idleStop?: IdleStopRecord;
-    lastStop?: MetroLastStop;
-    /** The other process that answers Metro on `port`; `cwd` is null when its directory could not be read. */
-    heldBy?: {
-      pid: number;
-      cwd: string | null;
-    };
-    /** Absent when the Metro log holds no bundle request. */
-    bundle?: MetroBundleState;
-  } | null;
-  web?: WebBrowserState | null;
-  macos?: MacosAppState | null;
-  supervisor?: {
-    pid: number | null;
-    mode: string | null;
-    startedAt: string | null;
-    healthy: boolean;
-  } | null;
-  logs?: {
-    dir: string;
-    errorsSinceMarker: number;
-  } | null;
-  /** `installed` is whether the agent-device executable is on the PATH of the process that ran status. */
-  agentDevice?: {
-    stateDir: string;
-    installed?: boolean;
-  };
-  worktree?: WorktreeFacts | null;
-  remoteDevices?: RemoteDeviceState[];
-  /** The physical devices this workspace leases, in every slot; absent when it leases none. */
-  physicalDevices?: PhysicalDeviceState[];
-  build?: BuildReport | null;
-  lastBuilds?: Partial<Record<StatsPlatform, LastBuildReport>>;
-  /** Each platform's recent runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
-  builds?: Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
-  disk?: EnvironmentDisk;
-  /** The coding-agent sessions working in the environment, most recently active first; absent when none. */
-  agents?: AgentSession[];
-  /** The agent sessions that stopped running here in the last 3 days, most recently ended first; absent when none. */
-  endedAgents?: EndedAgentSession[];
-}
-/** `committedMb` sums the environments' `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
-interface StatusCapacity {
-  liveCount: number;
-  committedMb: number;
-  totalMemoryMb: number;
-  overCapacity: boolean;
+  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
 }
-interface DeviceLeaseState {
-  slot?: string;
-  path: string;
-  platform: string;
-  id: string | null;
-  deviceName: string | null;
-  holder: string | null;
-  grantedAt: string | null;
-  expiresAt: string | null;
-  mine: boolean;
-  expired: boolean;
-  parsed: boolean;
+/** Decides which records a query matches from the timeline's marker records alone. */
+declare function planLogQuery(markers: readonly NdjsonRecord[], { slot, sources, minLevel, since, grep, errorsOnly, now }?: LogQueryOptions): LogQueryPlan;
+declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: LogQueryOptions & {
+  dir?: string;
+  records?: NdjsonRecord[];
+  tail?: number;
+  errorContext?: boolean;
+}): NdjsonRecord[];
+/** Queries the JSON timeline, including Expo context fields on errors as `stim logs --json` does. */
+declare function queryJsonLogs(options?: Parameters<typeof queryLogs>[0]): NdjsonRecord[];
+declare function tailRead(prev: TailState | null | undefined, size: number): {
+  start: number;
+  prev: TailState;
+};
+declare function advanceTail(prev: TailState | null | undefined, chunk: string | null | undefined, size: number): {
+  state: TailState;
+  records: NdjsonRecord[];
+};
+declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, identities: seededIdentities, errorContext }: {
+  dir: string;
+  onRecord: (record: NdjsonRecord) => void;
+  criteria?: QueryCriteria;
+  /** An explicit polling interval. Omit for filesystem hints with a ten-second repair scan. */
+  intervalMs?: number;
+  offsets?: Record<string, number> | null;
+  /** `fileIdentity` of each file `offsets` was read from, so a replacement made since is recognized. */
+  identities?: Record<string, string> | null;
+  /** Holds each Expo error until its code frame and stack stop growing, then attaches them. */
+  errorContext?: ExpoContextTarget;
+}): () => void;
+declare function fileIdentity(stat: BigIntStats): string | undefined;
+declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
+//#endregion
+//#region state/log-reader.d.ts
+interface LogDirQuery extends LogQueryOptions {
+  tail?: number;
+  /** Records from outside the directory, such as agent-device actions; they follow its records at equal timestamps. */
+  extra?: readonly NdjsonRecord[];
 }
 /**
- * Where a memory figure comes from. `footprint` is each process's physical footprint, which Activity Monitor's Memory
- * column shows. `rss` sums resident set sizes, which count pages shared between processes once per process, so a
- * simulator reports well above its footprint; the machine owners fall back to it when the footprint helper cannot be
- * built. `estimate` is a fixed amount per running thing, which an environment reports whenever it has no footprint.
+ * An indexed view of a workspace log directory, read in timestamp order without loading whole files. Each file
+ * generation is indexed once per process (block timestamp bounds, markers, slots and launch attempts) and later
+ * views read only what was appended since. Close it to release the open files.
  */
-declare const MEMORY_SOURCES: readonly ["footprint", "rss", "estimate"];
-type MemorySource = (typeof MEMORY_SOURCES)[number];
-/** Every kind of process owner the status machine section reports. */
-declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "macos", "server", "shared"];
-type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
+interface LogDir {
+  /** Bytes read from each current `.ndjson` file, through its last complete line. */
+  readonly sizes: Record<string, number>;
+  /** `fileIdentity` of each current `.ndjson` file that `sizes` was read from. */
+  readonly identities: Record<string, string>;
+  /** The oldest timestamp in the directory. */
+  readonly firstTs: number | undefined;
+  /** Launch attempt records outside native crash files, in timeline order. */
+  launchAttempts(): NdjsonRecord[];
+  /** The records `queryJsonLogs` returns for this directory's timeline followed by `extra`. */
+  query(query?: LogDirQuery): Promise<NdjsonRecord[]>;
+  /** Every matching record in timestamp order, in batches of at most 500, with the same filters and context as query. */
+  batches(query?: Omit<LogDirQuery, "tail">): AsyncIterable<NdjsonRecord[]>;
+  /** Prepares the directory marker predicate for records without markers, such as attributed agent actions. */
+  filter(query?: LogQueryOptions): (record: NdjsonRecord) => boolean;
+  close(): Promise<void>;
+}
 /**
- * One thing using this machine's CPU and memory now. Each process is counted in exactly one owner: the one whose root
- * process is its nearest ancestor. `workspace` and `slot` (absent for the default slot) name the workspace a
- * simulator, emulator, Metro, build or Chrome belongs to; a device no workspace records has a null workspace, and
- * machine-wide processes are `shared`. `id` is the simulator's UDID, the emulator's AVD name, Metro's port as text,
- * the build's platform, or null. `owned` is true only for what Stim started and stops: a workspace's owned device,
- * Metro, build or Chrome. `cpuPercent` is `ps` %CPU summed over the owner's processes, where 100 is one core.
- * `residentMb` sums their resident set sizes; pages shared between processes count once per process, so a
- * simulator, whose processes all map the runtime's shared libraries, reports well above its physical footprint.
- * `memoryMb` sums their physical footprints when `MachineUsageState.memorySource` is `footprint`, taking the resident
- * size of a process the footprint helper could not read, and equals `residentMb` when it is `rss`.
+ * Opens `dir` for reading. With `order: 'timeline'`, native crash files follow every other file at equal
+ * timestamps, as `readLogTimeline` orders them; with `'name'`, every file is ranked by name, as `readLogRecords`.
  */
-interface MachineOwner {
-  kind: MachineOwnerKind;
-  name: string;
-  workspace: string | null;
-  slot?: string;
-  id: string | null;
-  owned: boolean;
-  cpuPercent: number;
-  residentMb: number;
-  memoryMb: number;
-  processes: number;
-}
-/** Where this machine's CPU and memory go, from one pass over the host process table. */
-interface MachineUsageState {
-  memorySource: Exclude<MemorySource, "estimate">;
-  owners: MachineOwner[];
+declare function openLogDir(dir: string, { order, signal }?: {
+  order?: "timeline" | "name";
+  signal?: AbortSignal;
+}): Promise<LogDir>;
+//#endregion
+//#region state/ndjson-tail.d.ts
+/**
+ * Returns a reader of `file` and its rotated generation that yields, on every call, the records a full
+ * `readNdjsonGenerations(file)` would, while reading only the bytes appended since the previous call. A file renamed
+ * to its rotated generation between two calls is finished from there; any other replacement or a shrunk file is
+ * read again from its start. A file rewritten in place to at least its previous length is not detected.
+ */
+declare function createNdjsonTail(file: string): () => NdjsonRecord[];
+//#endregion
+//#region state/paths.d.ts
+declare function getConfigPath(): string;
+declare function configLockPath(): string;
+declare function workspaceMetadataFile(projectRoot: string): string;
+declare function workspaceAgentDeviceDir(projectRoot: string): string;
+declare function workspaceLogsDir(projectRoot: string): string;
+/** Device screen footage stim-server records for the workspace, one directory per platform and slot. */
+declare function workspaceRecordingsDir(projectRoot: string): string;
+declare function workspaceLogErrorIndex(projectRoot: string): string;
+declare function workspaceDerivedData(projectRoot: string): string;
+declare function workspaceGradleBuild(projectRoot: string): string;
+declare function workspaceBuildDetailFile(projectRoot: string): string;
+/** The agent sessions that stopped running in the workspace in the last `ENDED_AGENT_RETENTION_MS`. */
+declare function workspaceEndedAgentsFile(projectRoot: string): string;
+declare function workspaceEndedAgentsLock(projectRoot: string): string;
+declare function supervisorPidFile(projectRoot: string): string;
+declare function workspaceStateFile(projectRoot: string): string;
+/** The dependency directories `gc --delete` deleted from the workspace's worktree, apart from state.json so writing it is not workspace activity. */
+declare function workspaceLightenedFile(projectRoot: string): string;
+declare function workspaceStateLock(projectRoot: string): string;
+declare function supervisorLogFile(projectRoot: string): string;
+declare function emulatorLogFile(projectRoot: string): string;
+declare function sharedCompilationCache(): string;
+declare function sharedCcache(): string;
+declare function sharedGradle(): string;
+declare function sharedPods(): string;
+declare function createdDevicesFile(): string;
+declare function gitMergeCacheDir(): string;
+declare function pullRequestCacheDir(): string;
+declare function agentSessionsCacheFile(): string;
+declare function diskUsageCacheDir(): string;
+/** The ownership claim root that admits one disk-usage walk at a time on this machine. */
+declare function diskUsageWalkClaims(): string;
+/** The remote machines this machine asked for build access, each with its pinned stim-server key once approved. */
+declare function buildMachinesFile(): string;
+declare function buildMachinesLock(): string;
+/** The remote machines this machine asked for access, separate from build credentials. */
+declare function deviceHostMachinesFile(): string;
+declare function deviceHostMachinesLock(): string;
+declare function deviceHostMachinesClaims(): string;
+declare function createdDevicesLock(): string;
+/** The EAS session ledger lives under the real home directory, never under STIM_HOME. */
+declare function easMachineStateRoot(): string;
+declare function easSessionLedgerFile(root?: string): string;
+declare function easSessionLedgerLock(root?: string): string;
+/** Where stim-server records, one file per server process, the devices whose frames a client subscribes to. */
+declare function deviceViewersDir(): string;
+declare function budgetSweepFile(): string;
+declare function budgetSweepLock(): string;
+declare function statsFile(): string;
+declare function maintenanceDir(): string;
+declare function maintenanceStateFile(): string;
+declare function maintenanceAttemptFile(): string;
+declare function maintenanceNdjsonFile(): string;
+declare function gcLogDir(): string;
+declare function gcLogFile(): string;
+declare function buildLedgerDir(): string;
+declare function buildLedgerFile(): string;
+declare function buildLedgerLock(): string;
+declare function maintenanceChildLogFile(): string;
+declare function maintenanceRunClaims(): string;
+/** Dependency trees `worktree remove` moved out of a worktree before git removed it; gc deletes what is left. */
+declare function trashRoot(): string;
+declare function archiveRoot(): string;
+declare function archiveDir(id: string): string;
+declare function archiveLock(): string;
+/** Uncommitted changes of removed worktrees: `<repository>/<branch-or-dir>-<timestamp>/` holding `manifest.json`. */
+declare function worktreeArchiveRoot(): string;
+/** This machine's own long-term X25519 key as a client of other machines' stim-servers. */
+declare function clientIdentityKeyFile(): string;
+/**
+ * The local Unix socket. sun_path permits 103 UTF-8 bytes on macOS and 107 on Linux. Longer paths use
+ * /tmp/stim-sockets-<uid>/<SHA-256 of the normalized absolute socket path>.sock.
+ */
+declare function serverLocalSocket(): string;
+declare function serverSetupDir(): string;
+declare function setupJournalFile(hash: string): string | null;
+//#endregion
+//#region state/placement.d.ts
+/**
+ * The placement words every workload shares (`remote.build`, `ios.remote`, `android.remote`, `macos.remote` and their
+ * flags). Anything else a setting holds is a machine name, or for devices `eas` or `proxy`.
+ *
+ * - `local`: this machine only.
+ * - `auto`: this machine first, a remote machine when this one is full or busy.
+ * - `remote`: remote machines first, in `remote.machines` order; this machine only when none takes the run.
+ * - `remote-only`: remote machines in `remote.machines` order, never this machine.
+ */
+declare const PLACEMENT_WORDS: readonly ["local", "auto", "remote", "remote-only"];
+type PlacementWord = (typeof PLACEMENT_WORDS)[number];
+type AutomaticPlacement = Exclude<PlacementWord, "local">;
+declare function placementWord(value: string): PlacementWord | null;
+declare function prefersRemote(word: PlacementWord): boolean;
+declare function mayRunHere(word: PlacementWord): boolean;
+//#endregion
+//#region state/recordings.d.ts
+/** The footage stim-server keeps per device: the last 15 minutes recorded, however long ago. */
+declare const RECORDING_FOOTAGE_MS: number;
+/** The recordings of every workspace of one Stim home together; past it the oldest footage goes first. */
+declare const RECORDING_CAP_BYTES: number;
+/** The platforms stim-server records: owned simulators and emulators, and the Stim-owned Chrome page. */
+declare const RECORDING_PLATFORMS: readonly ["ios", "android", "web"];
+type RecordingPlatform = (typeof RECORDING_PLATFORMS)[number];
+/**
+ * One file of H.264 footage. A closed segment is named `<start>-<end>.seg`, in epoch milliseconds of its first and
+ * last access unit; the segment being written is `<start>.part`, and its end is its modification time.
+ */
+interface RecordedSegment {
+  file: string;
+  start: number;
+  end: number;
+  bytes: number;
+  open: boolean;
 }
-/** The payload `stim status --json` prints, and `status --watch --json` prints on each change. */
-interface StatusPayload {
-  maintenance?: MaintenanceStatus;
-  archived?: ArchivedWorkspace[];
-  archivedUsage?: ArchivedUsage;
-  environments: (EnvironmentState & {
-    labelOnly?: true;
-  })[];
-  capacity: StatusCapacity;
-  deviceLeases: DeviceLeaseState[];
-  unprovisionedWorktrees: WorktreeFacts[];
-  simctlAvailable: boolean;
-  /** Null when nothing runs that status attributes, so it read no process table, or when the table was unreadable. */
-  machine: MachineUsageState | null;
+interface RecordedDevice {
+  platform: RecordingPlatform;
+  slot: string;
+  dir: string;
+  segments: RecordedSegment[];
 }
+/** The directory under a workspace's recordings that holds one device slot's footage. */
+declare function recordingDeviceName(platform: RecordingPlatform, slot: string): string;
+/** Segment names hold whole milliseconds: the start rounded down and the end rounded up. */
+declare function closedSegmentName(start: number, end: number): string;
+declare function openSegmentName(start: number): string;
+/** The segments in one device directory, oldest first. Files that are not segments are left out; `closedOnly` excludes files still being written. */
+declare function listSegments(dir: string, closedOnly?: boolean): RecordedSegment[];
+/** Reads current segment files asynchronously, oldest first; cancellation propagates. */
+declare function listSegmentsAsync(dir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedSegment[]>;
+/** Every device slot recorded under a workspace's recordings directory. */
+declare function listRecordedDevices(recordingsDir: string, closedOnly?: boolean): RecordedDevice[];
+/** Reads current device slots and their segment files asynchronously; cancellation propagates. */
+declare function listRecordedDevicesAsync(recordingsDir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedDevice[]>;
+declare function recordedBytes(devices: readonly RecordedDevice[]): number;
+/**
+ * The oldest closed segments to delete so that one device keeps at most `footageMs` of footage. Time between
+ * segments, while nothing was recorded, does not count. The open segment is never chosen.
+ */
+declare function footageDrops(segments: readonly RecordedSegment[], footageMs: number): RecordedSegment[];
+/** The oldest closed segments across all devices to delete so that together they hold at most `capBytes`. */
+declare function capDrops(devices: readonly RecordedDevice[], capBytes: number): RecordedSegment[];
+/**
+ * Whether stim-server records a workspace's devices: `STIM_RECORDING`, then `recording.enabled` in the workspace,
+ * repo and machine layers, in that order, and true by default.
+ */
+declare function recordingEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
+//#endregion
+//#region state/run-id.d.ts
+declare const RUN_ID_ENV = "STIM_RUN_ID";
+/** A run id as the CLI and stim-server accept it: letters, digits, `.`, `_` and `-`, at most 64. Null otherwise. */
+declare function validRunId(value: unknown): string | null;
+/**
+ * The run id of the ambient operation context, else of this CLI invocation: `STIM_RUN_ID` when it holds a valid id
+ * (Stim Desktop passes one), else a random one. The CLI entry exports it back to `STIM_RUN_ID` so processes the run
+ * starts inherit it; this function does not.
+ */
+declare function runId(env?: NodeJS.ProcessEnv): string;
+//#endregion
+//#region state/settings-schema.d.ts
+declare const SETTINGS_SCHEMA_FILE = "settings.schema.json";
+declare const SETTINGS_SCHEMA_URL: string;
+type JsonSchema = Record<string, unknown>;
+/**
+ * The published settings schema. The root describes a committed `.stim.json`;
+ * `$defs.machine` describes the settings keys of `$STIM_HOME/config.json`.
+ * Every leaf carries `x-stim` with its dotted key, kind, writable scopes,
+ * environment override, and sensitivity.
+ */
+declare function settingsJsonSchema(): JsonSchema;
 //#endregion
 //#region state/status-derived.d.ts
 declare function withGitChip(worktree: WorktreeFacts): WorktreeFacts;
@@ -2558,23 +2712,21 @@ declare function readDeviceHostMachines(): DeviceHostMachineCredential[];
 //#endregion
 //#region state/hosted-metro.d.ts
 declare const HOSTED_METRO_REQUESTS_KEY = "hostedMetroRequests";
-declare const HOSTED_METRO_GATEWAYS_KEY = "hostedMetroGateways";
+declare const HOSTED_METRO_LINKS_KEY = "hostedMetroLinks";
 /** Private supervisor request, keyed by hosted session; never part of a public payload. */
 interface HostedMetroRequest {
   id: string;
   machine: string;
-  address: string;
-  peer: string;
-  secret: string;
 }
-interface HostedMetroGateway {
+/** The supervisor's answer to a request: `ready` while the host holds one of its links, `error` when it cannot link. */
+interface HostedMetroLinks {
   id: string;
   processToken: string;
-  port?: number;
+  ready?: true;
   error?: string;
 }
 declare function hostedMetroRequests(state: WorkspaceState | null): Record<string, HostedMetroRequest>;
-declare function hostedMetroGateways(state: WorkspaceState | null): Record<string, HostedMetroGateway>;
+declare function hostedMetroLinks(state: WorkspaceState | null): Record<string, HostedMetroLinks>;
 //#endregion
 //#region state/tailnet.d.ts
 declare const TAILNET_MACHINE_PATTERN: string;
@@ -2684,6 +2836,81 @@ interface GcLogRecord extends NdjsonRecord {
 declare function isGcLogRecord(record: NdjsonRecord): record is GcLogRecord;
 declare function readGcLog(file?: string): GcLogRecord[];
 //#endregion
+//#region state/build-ledger.d.ts
+declare const BUILD_LEDGER_CAP = 500;
+type BuildLedgerPlatform = "ios" | "android" | "macos";
+type BuildLedgerOutcome = BuildResult;
+type BuildLedgerCacheResult = "hit" | "miss" | "bypassed";
+interface BuildLedgerPlacement {
+  where: "local" | "offloaded";
+  /** The build machine that compiled the app, for an offloaded build. */
+  machine?: string;
+  /** The run considered offloading, then built here; `reason` says why. */
+  fellBack?: true;
+  reason?: string;
+}
+interface BuildLedgerCache {
+  result: BuildLedgerCacheResult;
+  /** Where a hit came from. */
+  source?: "local" | "remote";
+  key: string | null;
+  fingerprint: string | null;
+  missReason?: string;
+}
+interface BuildLedgerFailure {
+  code: string | null;
+  message: string | null;
+  remedy: string | null;
+  /** The phase the run was in when it failed. */
+  phase: string | null;
+}
+/** The simulator, emulator or device the run targeted. Never a serial or UDID. */
+interface BuildLedgerDevice {
+  name: string;
+  runtime?: string;
+}
+/** One native build run, as `stim logs --source builds --json` prints it. */
+interface BuildLedgerRecord extends NdjsonRecord {
+  /** Epoch milliseconds when the run finished. */
+  ts: number;
+  src: "builds";
+  level: "info" | "warn" | "error";
+  msg: string;
+  event: "build";
+  id: string;
+  /** Epoch milliseconds when the run started. */
+  startedAt: number;
+  project: string;
+  workspace: string;
+  branch: string | null;
+  platform: BuildLedgerPlatform;
+  scheme?: string;
+  variant?: string;
+  configuration: string | null;
+  placement: BuildLedgerPlacement;
+  cache: BuildLedgerCache;
+  durationMs: number;
+  /** Milliseconds in each local phase of the run. */
+  phases: Record<string, number>;
+  /** Milliseconds in each phase on the build machine (`sync`, `deps`, `prebuild`, `pods`, `build`, `fetch`). */
+  offloadPhases?: Record<string, number>;
+  outcome: BuildLedgerOutcome;
+  failure?: BuildLedgerFailure;
+  device?: BuildLedgerDevice;
+  /** This machine's 5-minute load per core when the run started. Absent in older records. */
+  loadPerCore?: number;
+  /** The run's first owned simulator or emulator boot: when it started, in epoch milliseconds, and the load per core then. */
+  boot?: BuildLedgerBoot;
+  stimVersion: string;
+}
+interface BuildLedgerBoot {
+  startedAt: number;
+  loadPerCore: number;
+}
+declare function isBuildLedgerRecord(record: NdjsonRecord): record is BuildLedgerRecord;
+/** The ledger's records, oldest first. A missing or unreadable ledger is empty. */
+declare function readBuildLedger(file?: string): BuildLedgerRecord[];
+//#endregion
 //#region state/agent-device.d.ts
 declare function agentDeviceStateDirs(home?: string, env?: NodeJS.ProcessEnv): string[];
 declare function agentDeviceStateDirsAsync(home?: string, env?: NodeJS.ProcessEnv): Promise<string[]>;
@@ -2798,4 +3025,4 @@ declare class KeyedEntities<T> {
 /** Applies `delta` to `entities` keyed by `key`, keeping the order of `entities` and appending new keys. */
 declare function applyKeyedDelta<T>(entities: readonly T[], delta: KeyedDelta<T>, key: (entity: T) => string): T[];
 //#endregion
-export { BuildMachineTotals as $, hostedAppArea as $a, readHomeIdentity as $c, HostedAndroidChoice as $i, swiftpmCacheUsageFile as $l, RunOutcomeKind as $n, listRecordedDevicesAsync as $o, HostedIosPlacement as $r, workspaceGradleBuild as $s, APP_PROCESS_STATES as $t, HostedLogsCursor as A, HOSTED_MACOS_APP_SLOTS as Aa, readLogTimeline as Ac, MetroLastStop as Ai, ProjectRecord as Al, DevicePlacement as An, TunnelMode as Ao, archiveEnabled as Ar, maintenanceAttemptFile as As, ViewedDevice as At, cannotHost as B, hostedAgentDriverName as Ba, countErrorEntries as Bc, readDevServerStop as Bi, readBuildMachines as Bl, MachineOwner as Bn, RUN_ID_ENV as Bo, MaintenanceActionKind as Br, sharedCcache as Bs, endedAgentSessionOf as Bt, GcLogRecord as C, parseHostedOfferRequest as Ca, logFiles as Cc, DevServerStopRecord as Ci, requireAutomaticMachine as Cl, BuildReport as Cn, SettingDefinition as Co, macosAppState as Cr, easSessionLedgerFile as Cs, readStatsReport as Ct, readGcLog as D, readHostedDeviceLedger as Da, queryJsonLogs as Dc, IdleStopRecord as Di, DeviceRecord as Dl, DeviceActivity as Dn, SettingWriteResult as Do, ArchivedBytes as Dr, gcLogFile as Ds, trimSamples as Dt, isGcLogRecord as E, readHostedDevice as Ea, planLogQuery as Ec, IDLE_STOP_KEY as Ei, Config as El, ChecksState as En, SettingType as Eo, readMacosRecord as Er, gcLogDir as Es, trimCapacityWaits as Et, readHostedNativeLogsCheckpoint as F, HostedAgentLease as Fa, FingerprintMemoRecord as Fc, WorkspaceState as Fi, clientIdentity as Fl, GitChip as Fn, expectedShape as Fo, readArchiveState as Fr, maintenanceStateFile as Fs, PullRequestCacheEntry as Ft, HOSTED_METRO_GATEWAYS_KEY as G, parseHostedMacosChoice as Ga, readCreatedDevices as Gc, readLastBuilds as Gi, saturation as Gl, MetroBundleState as Gn, RECORDING_PLATFORMS as Go, MaintenanceRecord as Gr, supervisorLogFile as Gs, readDiskUsage as Gt, findPeer as H, hostedMacosBundleId as Ha, CreatedDevices as Hc, readDeviceIdleShutdowns as Hi, buildSlotPath as Hl, MachineUsageState as Hn, validRunId as Ho, MaintenanceMode as Hr, sharedGradle as Hs, pullRequestCacheFile as Ht, readLogsSince as I, HostedAppLaunch as Ia, fingerprintMemoDir as Ic, buildDiagnostics as Ii, BuildMachineCredential as Il, GitChipPart as In, isLayeredSetting as Io, readArchives as Ir, pullRequestCacheDir as Is, StatusCacheEntry as It, HostedMetroRequest as J, HOSTED_APP_CHUNK_BYTES as Ja, isJsonObject as Jc, readWorkspaceState as Ji, SimRuntimeUsage as Jl, PHYSICAL_DEVICE_CONNECTIONS as Jn, RecordingPlatform as Jo, MaintenanceStatus as Jr, workspaceAgentDeviceDir as Js, readPullRequestCache as Jt, HOSTED_METRO_REQUESTS_KEY as K, parseHostedMacosDevice as Ka, readEasSessionLedger as Kc, readWarmRecord as Ki, tryAcquireBuildSlotClaim as Kl, NATIVE_BUILD_STEPS as Kn, RecordedDevice as Ko, MaintenanceSize as Kr, supervisorPidFile as Ks, readDiskUsageFailure as Kt, Endpoint as L, HostedMacosChoice as La, fingerprintMemoFile as Lc, lastUseFrom as Li, MACHINE_CREDENTIALS_VERSION as Ll, LastBuildReport as Ln, isSensitiveReference as Lo, readArchivesAsync as Lr, serverLocalSocket as Ls, agentSessionOf as Lt, hostedMacosLogsDir as M, HostedAgentDriverName as Ma, sortByTs as Mc, WARM_KEY as Mi, SettingsObject as Ml, EndedAgentSession as Mn, WebViewport as Mo, linkReplacedArchives as Mr, maintenanceDir as Ms, stimBuildDigest as Mt, hostedNativeLogsDir as N, HostedAgentGrant as Na, tailRead as Nc, WORKSPACE_AGENT_KEY as Ni, StimConfig as Nl, EnvironmentDisk as Nn, acceptsShape as No, readArchive as Nr, maintenanceNdjsonFile as Ns, AgentSessionsCache as Nt, HOSTED_LOGS_FIRST_BYTES as O, readHostedSessions as Oa, queryLogs as Oc, LAST_BUILD_KEYS as Oi, DoctorRunRecord as Ol, DeviceAppProcess as On, SettingsPayload as Oo, ArchivedUsage as Or, getConfigPath as Os, wholePhases as Ot, parseHostedLogsCursor as P, HostedAgentIssuedGrant as Pa, FINGERPRINT_MEMO_SCHEMA as Pc, WarmRecord as Pi, SupervisorRecord as Pl, EnvironmentState as Pn, coerceSettingText as Po, readArchiveAsync as Pr, maintenanceRunClaims as Ps, ENDED_AGENT_RETENTION_MS as Pt, readDeviceHostMachines as Q, HostedAppRecord as Qa, withStateReadCache as Qc, HOSTED_PARKED_CANDIDATES as Qi, readSwiftpmCacheUsage as Ql, RemoteDeviceState as Qn, listRecordedDevices as Qo, readMaintenanceState as Qr, workspaceEndedAgentsLock as Qs, AGENT_TOOLS as Qt, TAILNET_MACHINE_PATTERN as R, HostedMacosDevice as Ra, fingerprintMemoLock as Rc, parseMissReason as Ri, MachineCredential as Rl, MACHINE_OWNER_KINDS as Rn, settingDefinition as Ro, DiskPressureLevel as Rr, serverSetupDir as Rs, diskUsageCacheFile as Rt, GcLogOptions as S, parseHostedNativeOffer as Sa, isExpoErrorContext as Sc, DEV_SERVER_STOP_REQUEST_KEY as Si, automaticMachineEnabled as Sl, BuildPlatform as Sn, SETTING_SCOPES as So, MacosProcess as Sr, easMachineStateRoot as Ss, readStats as St, GcLogTrigger as T, parseHostedRequest as Ta, parseSince as Tc, DeviceIdleShutdownRecord as Ti, ConcurrencyLimits as Tl, BuildWaitingFor as Tn, SettingScope as To, readHostedMacosApp as Tr, emulatorLogFile as Ts, trimCapacityRefusals as Tt, machineEndpoint as U, parseHostedAgentAccess as Ua, EasSessionClaim as Uc, readDevicePlacement as Ui, buildSlotsDir as Ul, MacosBuildPlanPayload as Un, RECORDING_CAP_BYTES as Uo, MaintenancePass as Ur, sharedPods as Us, readAgentSessionsCache as Ut, endpoint as V, hostedMacosAppSlot as Va, CreatedDevicePlatform as Vc, readDevServerStopRequest as Vi, MachineCapacity as Vl, MachineOwnerKind as Vn, runId as Vo, MaintenanceCheck as Vr, sharedCompilationCache as Vs, listStatusCacheEntries as Vt, parseMachine as W, parseHostedAgentGrant as Wa, EasSessionLedgerRead as Wc, readIdleStop as Wi, machineCapacity as Wl, MemorySource as Wn, RECORDING_FOOTAGE_MS as Wo, MaintenancePressure as Wr, statsFile as Ws, readBuildDetail as Wt, hostedMetroRequests as X, HostedAppFile as Xa, readJsonObject as Xc, DEVICE_HOST_LIMITS as Xi, readMachineCacheUsage as Xl, PhysicalDeviceState as Xn, closedSegmentName as Xo, parseMaintenanceState as Xr, workspaceDerivedData as Xs, withGitChip as Xt, hostedMetroGateways as Y, HostedAppDelivery as Ya, readJsonFile as Yc, workspaceLastUsed as Yi, machineCacheUsageFile as Yl, PhysicalDeviceConnection as Yn, capDrops as Yo, MemoryCulprit as Yr, workspaceBuildDetailFile as Ys, withDerivedFacts as Yt, DeviceHostMachineCredential as Z, HostedAppOffer as Za, readStateFile as Zc, DeviceHostLimits as Zi, SwiftpmCacheUsage as Zl, PlannedPhase as Zn, footageDrops as Zo, readMaintenanceAttempt as Zr, workspaceEndedAgentsFile as Zs, ACTIVITY_RECENCY_BASES as Zt, isSetupJournalPrunable as _, hostedWorkerSettleMs as _a, bundleMarkerPlatform as _c, unreadableHostedNative as _i, windowsShortDir as _l, BuildMissChange as _n, OffloadMode as _o, WorktreeGit as _r, deviceHostMachinesFile as _s, decodeStats as _t, MachineView as a, HostedDevicePlatform as aa, workspaceStateLock as ac, unreadableHostedIos as ai, ParkedMax as al, AndroidDeviceState as an, readHostedAppMetadata as ao, StatusIssueCode as ar, recordingEnabled as as, ReadStatsResult as at, AgentActionReaderOptions as au, agentDeviceStateDirs as b, parseHostedDevice as ba, fileSizes as bc, DEVICE_IDLE_SHUTDOWN_KEY as bi, withConfigLockAsync as bl, BuildPlacement as bn, SETTINGS as bo, MacosAppState as br, diskUsageCacheDir as bs, projectRootDirectories as bt, SummaryBuild as c, HostedDeviceSession as ca, openLogDir as cc, hostedAndroidDeviceName as ci, configCorruptRepair as cl, BUILD_PHASES as cn, validHostedAppBlob as co, WEB_PAGE_STATES as cr, archiveLock as cs, RunSample as ct, createAgentActionReader as cu, WorktreeRow as d, HostedNativeOffer as da, LogQueryPlan as dc, hostedAndroidStatus as di, getParkedMax as dl, BuildCacheHit as dn, settingsJsonSchema as do, WarmStep as dr, buildMachinesLock as ds, StatsCapacityRefusal as dt, NdjsonRecord as du, HostedAndroidDevice as ea, workspaceLogErrorIndex as ec, HostedIosStatus as ei, DEBUG_ENV as el, ActiveBuildState as en, hostedAppAttempt as eo, STATUS_ISSUE_CODES as er, listSegments as es, CAPACITY_REFUSAL_LIMIT as et, AgentDeviceUsage as eu, statusViews as f, assertHostedDeviceLedger as fa, NATIVE_CRASH_LOG_PREFIX as fc, parseHostedAndroidPlacement as fi, getProject as fl, BuildCause as fn, ANDROID_COMPILER_CACHE_CHOICES as fo, WebBrowserState as fr, clientIdentityKeyFile as fs, StatsCapacityWait as ft, SOURCES as fu, isJournalExpired as g, hostedDeviceId as ga, buildCriteria as gc, parseHostedNativePlacement as gi, loadConfig as gl, BuildMissCategory as gn, OFFLOAD_MODES as go, WorktreeFacts as gr, deviceHostMachinesClaims as gs, StatsScope as gt, readNdjsonGenerations as gu, SetupJournal as h, hostedConsolePort as ha, attachExpoErrorContext as hc, hostedNativeRecords as hi, isPathPrefix as hl, BuildHistoryEntry as hn, IOS_SIMULATOR_APPS as ho, WorkspaceStage as hr, createdDevicesLock as hs, StatsReport as ht, parseNdjsonText as hu, ArchivedSummary as i, HostedDevicePhase as ia, workspaceStateFile as ic, parseHostedIosPlacement as ii, debugLoggingEnabled as il, AgentTool as in, readHostedApp as io, StatusIssue as ir, recordingDeviceName as is, PLACEMENT_DECISIONS as it, readAgentDeviceUsageCache as iu, HostedLogsPage as j, HostedAgentAccess as ja, recordMatches as jc, READY_PHASE_MS as ji, RepoRecord as jl, DiskMeasure as jn, WEB_VIEWPORTS as jo, archivedUsage as jr, maintenanceChildLogFile as js, readViewedDevices as jt, HOSTED_LOGS_PAGE_BYTES as k, HOSTED_AGENT_DRIVERS as ka, readLogRecords as kc, MAINTENANCE_LOG_NAME as ki, PlatformRecords as kl, DeviceLeaseState as kn, TUNNEL_MODES as ko, ArchivedWorkspace as kr, gitMergeCacheDir as ks, DeviceViewersRecord as kt, SummaryHistoryEntry as l, HostedIosChoice as la, ERROR_SOURCES as lc, hostedAndroidPlacements as li, findEnclosingWorktreeRoot as ll, BUILD_RESULTS as ln, SETTINGS_SCHEMA_FILE as lo, WORKSPACE_PHASES as lr, archiveRoot as ls, STATS_VERSION as lt, createAsyncAgentActionReader as lu, SetupCapability as m, deviceHostRoot as ma, advanceTail as mc, HostedNativePlacement as mi, getRepoSettings as ml, BuildDiagnostic as mn, ANDROID_PCH_CHOICES as mo, WorkspacePhase as mr, createdDevicesFile as ms, StatsRecord as mt, parseNdjsonLine as mu, KeyedEntities as n, HostedDeviceOffer as na, workspaceMetadataFile as nc, hostedIosRecords as ni, createDebugLog as nl, ActivityRecencyBasis as nn, parseHostedAppManifest as no, StatsPlatform as nr, openSegmentName as ns, HISTORY_LIMIT as nt, agentDeviceUsageFile as nu, SUMMARY_ARCHIVES as o, HostedDeviceRequest as oa, LogDir as oc, HostedAndroidPlacement as oi, allMetroPorts as ol, AndroidRuntimeFacts as on, rememberHostedAppBlobRename as oo, StatusPayload as or, agentSessionsCacheFile as os, RunEstimates as ot, AgentRecordSelection as ou, workspaceSummary as p, deviceHostArea as pa, QueryCriteria as pc, unreadableHostedAndroid as pi, getProjectSettings as pl, BuildDetail as pn, ANDROID_EMULATOR_APPS as po, WebPageState as pr, configLockPath as ps, StatsPlacement as pt, levelRank as pu, HostedMetroGateway as q, parseHostedMacosPlacement as qa, validEasSessionClaim as qc, readWorkspaceAgent as qi, MachineCacheUsage as ql, NativeBuildStep as qn, RecordedSegment as qo, MaintenanceState as qr, trashRoot as qs, readEndedAgentSessions as qt, applyKeyedDelta as r, HostedDeviceOfferRequest as ra, workspaceRecordingsDir as rc, hostedIosStatus as ri, debugLogDir as rl, AgentSession as rn, parseHostedAppOffer as ro, StatusCapacity as rr, recordedBytes as rs, OffloadSummary as rt, readAgentDeviceUsage as ru, StatusViews as s, HostedDeviceSelectors as sa, LogDirQuery as sc, HostedAndroidStatus as si, buildWorkerRoot as sl, AppPresence as sn, validHostedAppArguments as so, TUTORIAL_VERSION as sr, archiveDir as ss, RunHistory as st, AgentTarget as su, KeyedDelta as t, HostedDevice as ta, workspaceLogsDir as tc, hostedIosPlacements as ti, DebugLog as tl, ActivityDriver as tn, hostedAppBlobs as to, SimulatorState as tr, listSegmentsAsync as ts, CAPACITY_REFUSAL_MAX_AGE_MS as tt, AgentDeviceUsageRoots as tu, WorkspaceSummary as u, HostedIosDevice as ua, LogQueryOptions as uc, hostedAndroidRecords as ui, getConcurrencyLimits as ul, BuildActivity as un, SETTINGS_SCHEMA_URL as uo, WORKSPACE_STAGE_KINDS as ur, buildMachinesFile as us, StatsBucket as ut, LEVELS as uu, parseSetupJournal as v, parseHostedAndroidDevice as va, compileGrep as vc, BUILD_HISTORY_KEY as vi, windowsShortDirKey as vl, BuildMissReason as vn, REMOTE_DEVICE_BACKENDS as vo, WorktreePullRequest as vr, deviceHostMachinesLock as vs, findProjectRoot as vt, GcLogStatus as w, parseHostedPlatformDevice as wa, markerWindow as wc, DevServerStopRequest as wi, validateAutomaticPool as wl, BuildResult as wn, SettingEntry as wo, parseMacosRecord as wr, easSessionLedgerLock as ws, statsProjectKey as wt, agentDeviceStateDirsAsync as x, parseHostedLocalDeviceCount as xa, followLogs as xc, DEVICE_RECLAIM_REASON as xi, AutomaticPoolRole as xl, BuildPlanPayload as xn, SETTING_GROUPS as xo, MacosBuild as xr, diskUsageWalkClaims as xs, readRunEstimates as xt, readSetupJournal as y, parseHostedChoice as ya, fileIdentity as yc, BUILD_HISTORY_LIMIT as yi, withConfigLock as yl, BuildPhase as yn, RemoteDeviceBackend as yo, MacosAppRecord as yr, deviceViewersDir as ys, offloadSummary as yt, TailnetPeer as z, HostedMacosPlacement as za, readFingerprintMemo as zc, readBuildHistory as zi, parseMachineCredential as zl, MEMORY_SOURCES as zn, settingValueError as zo, MaintenanceAction as zr, setupJournalFile as zs, diskUsageFailureFile as zt };
+export { endpoint as $, AndroidRuntimeFacts as $a, IDLE_STOP_KEY as $c, ParkedMax as $i, parseHostedRequest as $l, deviceHostMachinesClaims as $n, StatusCapacity as $o, QueryCriteria as $r, readMacosRecord as $s, listStatusCacheEntries as $t, createAsyncAgentActionReader as $u, BuildLedgerPlatform as A, BuildMachineCredential as Aa, hostedIosStatus as Ac, EasSessionLedgerRead as Ai, HostedDeviceOffer as Al, recordingDeviceName as An, LastBuildReport as Ao, trashRoot as Ar, SettingScope as As, findProjectRoot as At, parseHostedAppManifest as Au, HOSTED_LOGS_FIRST_BYTES as B, machineCapacity as Ba, unreadableHostedAndroid as Bc, EndSpan as Bi, assertHostedDeviceLedger as Bl, archiveLock as Bn, NATIVE_BUILD_STEPS as Bo, workspaceMetadataFile as Br, expectedShape as Bs, wholePhases as Bt, readMachineCacheUsage as Bu, BuildLedgerBoot as C, PlatformRecords as Ca, parseMaintenanceState as Cc, fingerprintMemoFile as Ci, workspaceLastUsed as Cl, footageDrops as Cn, DevicePlacement as Co, sharedCcache as Cr, REPLACED_SETTINGS as Cs, StatsCapacityRefusal as Ct, HostedAppDelivery as Cu, BuildLedgerFailure as D, StimConfig as Da, HostedIosStatus as Dc, CreatedDevicePlatform as Di, HostedAndroidChoice as Dl, listSegmentsAsync as Dn, EnvironmentState as Do, statsFile as Dr, SETTING_SCOPES as Ds, StatsReport as Dt, hostedAppArea as Du, BuildLedgerDevice as E, SettingsObject as Ea, HostedIosPlacement as Ec, countErrorEntries as Ei, HOSTED_PARKED_CANDIDATES as El, listSegments as En, EnvironmentDisk as Eo, sharedPods as Er, SETTING_GROUPS as Es, StatsRecord as Et, HostedAppRecord as Eu, GcLogRecord as F, MachineCapacity as Fa, hostedAndroidDeviceName as Fc, readJsonFile as Fi, HostedDeviceSelectors as Fl, mayRunHere as Fn, MachineOwnerKind as Fo, workspaceEndedAgentsLock as Fr, TunnelMode as Fs, readStatsReport as Ft, validHostedAppArguments as Fu, hostedNativeLogsDir as G, AGENT_TOOLS as Ga, BUILD_HISTORY_KEY as Gc, redactArgv as Gi, hostedWorkerSettleMs as Gl, buildLedgerFile as Gn, PlannedPhase as Go, createNdjsonTail as Gr, settingValueError as Gs, AgentSessionsCache as Gt, AgentDeviceUsageRoots as Gu, HostedLogsCursor as H, saturation as Ha, hostedNativeRecords as Hc, Trace as Hi, deviceHostRoot as Hl, budgetSweepFile as Hn, PHYSICAL_DEVICE_CONNECTIONS as Ho, workspaceStateFile as Hr, isSensitiveReference as Hs, ViewedDevice as Ht, readSwiftpmCacheUsage as Hu, GcLogStatus as I, buildSlotPath as Ia, hostedAndroidPlacements as Ic, readJsonObject as Ii, HostedDeviceSession as Il, placementWord as In, MachineUsageState as Io, workspaceGradleBuild as Ir, WEB_VIEWPORTS as Is, statsProjectKey as It, validHostedAppBlob as Iu, readLogsSince as J, ActivityDriver as Ja, DEVICE_RECLAIM_REASON as Jc, DEBUG_ENV as Ji, parseHostedDevice as Jl, buildMachinesLock as Jn, STATUS_ISSUE_CODES as Jo, openLogDir as Jr, MacosBuild as Js, StatusCacheEntry as Jt, readAgentDeviceUsageCache as Ju, parseHostedLogsCursor as K, APP_PROCESS_STATES as Ka, BUILD_HISTORY_LIMIT as Kc, redactCommandLine as Ki, parseHostedAndroidDevice as Kl, buildLedgerLock as Kn, RemoteDeviceState as Ko, LogDir as Kr, MacosAppRecord as Ks, ENDED_AGENT_RETENTION_MS as Kt, agentDeviceUsageFile as Ku, GcLogTrigger as L, buildSlotsDir as La, hostedAndroidRecords as Lc, readStateFile as Li, HostedIosChoice as Ll, prefersRemote as Ln, MacosBuildPlanPayload as Lo, workspaceLightenedFile as Lr, WebViewport as Ls, trimCapacityRefusals as Lt, MachineCacheUsage as Lu, isBuildLedgerRecord as M, MachineCredential as Ma, unreadableHostedIos as Mc, readEasSessionLedger as Mi, HostedDevicePhase as Ml, AutomaticPlacement as Mn, MACHINE_OWNER_KINDS as Mo, workspaceBuildDetailFile as Mr, SettingWriteResult as Ms, projectRootDirectories as Mt, readHostedApp as Mu, readBuildLedger as N, parseMachineCredential as Na, HostedAndroidPlacement as Nc, validEasSessionClaim as Ni, HostedDevicePlatform as Nl, PLACEMENT_WORDS as Nn, MEMORY_SOURCES as No, workspaceDerivedData as Nr, SettingsPayload as Ns, readRunEstimates as Nt, readHostedAppMetadata as Nu, BuildLedgerOutcome as O, SupervisorRecord as Oa, hostedIosPlacements as Oc, CreatedDevices as Oi, HostedAndroidDevice as Ol, openSegmentName as On, GitChip as Oo, supervisorLogFile as Or, SettingDefinition as Os, StatsScope as Ot, hostedAppAttempt as Ou, GcLogOptions as P, readBuildMachines as Pa, HostedAndroidStatus as Pc, isJsonObject as Pi, HostedDeviceRequest as Pl, PlacementWord as Pn, MachineOwner as Po, workspaceEndedAgentsFile as Pr, TUNNEL_MODES as Ps, readStats as Pt, rememberHostedAppBlobRename as Pu, cannotHost as Q, AndroidDeviceState as Qa, DeviceIdleShutdownRecord as Qc, debugLoggingEnabled as Qi, parseHostedPlatformDevice as Ql, createdDevicesLock as Qn, StatusBuildSlots as Qo, NATIVE_CRASH_LOG_PREFIX as Qr, readHostedMacosApp as Qs, endedAgentSessionOf as Qt, createAgentActionReader as Qu, isGcLogRecord as R, loadPerCore as Ra, hostedAndroidStatus as Rc, withStateReadCache as Ri, HostedIosDevice as Rl, agentSessionsCacheFile as Rn, MemorySource as Ro, workspaceLogErrorIndex as Rr, acceptsShape as Rs, trimCapacityWaits as Rt, SimRuntimeUsage as Ru, BUILD_LEDGER_CAP as S, DoctorRunRecord as Sa, MemoryCulprit as Sc, fingerprintMemoDir as Si, readWorkspaceState as Sl, closedSegmentName as Sn, DeviceLeaseState as So, setupJournalFile as Sr, REMOTE_DEVICE_BACKENDS as Ss, StatsBucket as St, HOSTED_APP_CHUNK_BYTES as Su, BuildLedgerCacheResult as T, RepoRecord as Ta, readMaintenanceState as Tc, readFingerprintMemo as Ti, DeviceHostLimits as Tl, listRecordedDevicesAsync as Tn, EndedAgentSession as To, sharedGradle as Tr, SETTINGS as Ts, StatsPlacement as Tt, HostedAppOffer as Tu, HostedLogsPage as U, tryAcquireBuildSlotClaim as Ua, parseHostedNativePlacement as Uc, TraceArgs as Ui, hostedConsolePort as Ul, budgetSweepLock as Un, PhysicalDeviceConnection as Uo, workspaceStateLock as Ur, replacementAdvice as Us, readViewedDevices as Ut, swiftpmCacheUsageFile as Uu, HOSTED_LOGS_PAGE_BYTES as V, maxLoadPerCore as Va, HostedNativePlacement as Vc, TRACE_ENV as Vi, deviceHostArea as Vl, archiveRoot as Vn, NativeBuildStep as Vo, workspaceRecordingsDir as Vr, isLayeredSetting as Vs, DeviceViewersRecord as Vt, SwiftpmCacheUsage as Vu, hostedMacosLogsDir as W, ACTIVITY_RECENCY_BASES as Wa, unreadableHostedNative as Wc, TracePhases as Wi, hostedDeviceId as Wl, buildLedgerDir as Wn, PhysicalDeviceState as Wo, worktreeArchiveRoot as Wr, settingDefinition as Ws, stimBuildDigest as Wt, AgentDeviceUsage as Wu, TAILNET_MACHINE_PATTERN as X, AgentSession as Xa, DevServerStopRecord as Xc, createDebugLog as Xi, parseHostedNativeOffer as Xl, configLockPath as Xn, StatsPlatform as Xo, LogQueryOptions as Xr, macosAppState as Xs, diskUsageCacheFile as Xt, AgentRecordSelection as Xu, Endpoint as Y, ActivityRecencyBasis as Ya, DEV_SERVER_STOP_REQUEST_KEY as Yc, DebugLog as Yi, parseHostedLocalDeviceCount as Yl, clientIdentityKeyFile as Yn, SimulatorState as Yo, ERROR_SOURCES as Yr, MacosProcess as Ys, agentSessionOf as Yt, AgentActionReaderOptions as Yu, TailnetPeer as Z, AgentTool as Za, DevServerStopRequest as Zc, debugLogDir as Zi, parseHostedOfferRequest as Zl, createdDevicesFile as Zn, StatusBuildSlotHolder as Zo, LogQueryPlan as Zr, parseMacosRecord as Zs, diskUsageFailureFile as Zt, AgentTarget as Zu, isSetupJournalPrunable as _, requireAutomaticMachine as _a, MaintenancePressure as _c, recordMatches as _i, readDevicePlacement as _l, RECORDING_PLATFORMS as _n, BuildResult as _o, maintenanceRunClaims as _r, WorktreePullRequest as _s, ReadStatsResult as _t, parseHostedAgentAccess as _u, MachineView as a, getParkedMax as aa, linkReplacedArchives as ac, parseNdjsonText as ad, fileIdentity as ai, WARM_KEY as al, readEndedAgentSessions as an, BuildCause as ao, easMachineStateRoot as ar, StatusPayload as as, HostedMetroLinks as at, HostedAgentAccess as au, agentDeviceStateDirs as b, Config as ba, MaintenanceState as bc, FINGERPRINT_MEMO_SCHEMA as bi, readWarmRecord as bl, RecordingPlatform as bn, DeviceActivity as bo, serverLocalSocket as br, ANDROID_PCH_CHOICES as bs, RunSample as bt, parseHostedMacosDevice as bu, SummaryBuild as c, getRepoSettings as ca, readArchiveState as cc, isExpoErrorContext as ci, WorkspaceState as cl, withGitChip as cn, BuildHistoryEntry as co, emulatorLogFile as cr, WORKSPACE_PHASES as cs, hostedMetroRequests as ct, HostedAgentIssuedGrant as cu, WorktreeRow as d, windowsShortDir as da, DiskPressureLevel as dc, parseSince as di, lastUseFrom as dl, settingsJsonSchema as dn, BuildMissReason as do, getConfigPath as dr, WebBrowserState as ds, BuildMachineTotals as dt, HostedMacosChoice as du, allMetroPorts as ea, ArchivedBytes as ec, LEVELS as ed, advanceTail as ei, IdleStopRecord as el, pullRequestCacheFile as en, AppPresence as eo, deviceHostMachinesFile as er, StatusCapacityLoad as es, findPeer as et, readHostedDevice as eu, statusViews as f, windowsShortDirKey as fa, MaintenanceAction as fc, planLogQuery as fi, parseMissReason as fl, RUN_ID_ENV as fn, BuildPhase as fo, gitMergeCacheDir as fr, WebPageState as fs, CAPACITY_REFUSAL_LIMIT as ft, HostedMacosDevice as fu, isJournalExpired as g, automaticMachineEnabled as ga, MaintenancePass as gc, readLogTimeline as gi, readDeviceIdleShutdowns as gl, RECORDING_FOOTAGE_MS as gn, BuildReport as go, maintenanceNdjsonFile as gr, WorktreeGit as gs, PLACEMENT_DECISIONS as gt, hostedMacosBundleId as gu, SetupJournal as h, AutomaticPoolRole as ha, MaintenanceMode as hc, readLogRecords as hi, readDevServerStopRequest as hl, RECORDING_CAP_BYTES as hn, BuildPlatform as ho, maintenanceDir as hr, WorktreeFacts as hs, OffloadSummary as ht, hostedMacosAppSlot as hu, ArchivedSummary as i, getConcurrencyLimits as ia, archivedUsage as ic, parseNdjsonLine as id, compileGrep as ii, READY_PHASE_MS as il, readDiskUsageFailure as in, BuildCacheHit as io, diskUsageWalkClaims as ir, StatusIssueCode as is, HOSTED_METRO_REQUESTS_KEY as it, HOSTED_MACOS_APP_SLOTS as iu, BuildLedgerRecord as j, MACHINE_CREDENTIALS_VERSION as ja, parseHostedIosPlacement as jc, readCreatedDevices as ji, HostedDeviceOfferRequest as jl, recordingEnabled as jn, LoadState as jo, workspaceAgentDeviceDir as jr, SettingType as js, offloadSummary as jt, parseHostedAppOffer as ju, BuildLedgerPlacement as k, clientIdentity as ka, hostedIosRecords as kc, EasSessionClaim as ki, HostedDevice as kl, recordedBytes as kn, GitChipPart as ko, supervisorPidFile as kr, SettingEntry as ks, decodeStats as kt, hostedAppBlobs as ku, SummaryHistoryEntry as l, isPathPrefix as la, readArchives as lc, logFiles as li, buildDiagnostics as ll, SETTINGS_SCHEMA_FILE as ln, BuildMissCategory as lo, gcLogDir as lr, WORKSPACE_STAGE_KINDS as ls, DeviceHostMachineCredential as lt, HostedAgentLease as lu, SetupCapability as m, withConfigLockAsync as ma, MaintenanceCheck as mc, queryLogs as mi, readDevServerStop as ml, validRunId as mn, BuildPlanPayload as mo, maintenanceChildLogFile as mr, WorkspaceStage as ms, HISTORY_LIMIT as mt, hostedAgentDriverName as mu, KeyedEntities as n, configCorruptRepair as na, ArchivedWorkspace as nc, SOURCES as nd, buildCriteria as ni, MAINTENANCE_LOG_NAME as nl, readBuildDetail as nn, BUILD_RESULTS as no, deviceViewersDir as nr, StatusDeviceSlots as ns, parseMachine as nt, readHostedSessions as nu, SUMMARY_ARCHIVES as o, getProject as oa, readArchive as oc, readNdjsonGenerations as od, fileSizes as oi, WORKSPACE_AGENT_KEY as ol, readPullRequestCache as on, BuildDetail as oo, easSessionLedgerFile as or, TUTORIAL_VERSION as os, HostedMetroRequest as ot, HostedAgentDriverName as ou, workspaceSummary as p, withConfigLock as pa, MaintenanceActionKind as pc, queryJsonLogs as pi, readBuildHistory as pl, runId as pn, BuildPlacement as po, maintenanceAttemptFile as pr, WorkspacePhase as ps, CAPACITY_REFUSAL_MAX_AGE_MS as pt, HostedMacosPlacement as pu, readHostedNativeLogsCheckpoint as q, ActiveBuildState as qa, DEVICE_IDLE_SHUTDOWN_KEY as qc, trace as qi, parseHostedChoice as ql, buildMachinesFile as qn, RunOutcomeKind as qo, LogDirQuery as qr, MacosAppState as qs, PullRequestCacheEntry as qt, readAgentDeviceUsage as qu, applyKeyedDelta as r, findEnclosingWorktreeRoot as ra, archiveEnabled as rc, levelRank as rd, bundleMarkerPlatform as ri, MetroLastStop as rl, readDiskUsage as rn, BuildActivity as ro, diskUsageCacheDir as rr, StatusIssue as rs, HOSTED_METRO_LINKS_KEY as rt, HOSTED_AGENT_DRIVERS as ru, StatusViews as s, getProjectSettings as sa, readArchiveAsync as sc, followLogs as si, WarmRecord as sl, withDerivedFacts as sn, BuildDiagnostic as so, easSessionLedgerLock as sr, WEB_PAGE_STATES as ss, hostedMetroLinks as st, HostedAgentGrant as su, KeyedDelta as t, buildWorkerRoot as ta, ArchivedUsage as tc, NdjsonRecord as td, attachExpoErrorContext as ti, LAST_BUILD_KEYS as tl, readAgentSessionsCache as tn, BUILD_PHASES as to, deviceHostMachinesLock as tr, StatusDeviceSlotHolder as ts, machineEndpoint as tt, readHostedDeviceLedger as tu, WorkspaceSummary as u, loadConfig as ua, readArchivesAsync as uc, markerWindow as ui, lastNativeUseFrom as ul, SETTINGS_SCHEMA_URL as un, BuildMissChange as uo, gcLogFile as ur, WarmStep as us, readDeviceHostMachines as ut, HostedAppLaunch as uu, parseSetupJournal as v, validateAutomaticPool as va, MaintenanceRecord as vc, sortByTs as vi, readIdleStop as vl, RecordedDevice as vn, BuildWaitingFor as vo, maintenanceStateFile as vr, ANDROID_COMPILER_CACHE_CHOICES as vs, RunEstimates as vt, parseHostedAgentGrant as vu, BuildLedgerCache as w, ProjectRecord as wa, readMaintenanceAttempt as wc, fingerprintMemoLock as wi, DEVICE_HOST_LIMITS as wl, listRecordedDevices as wn, DiskMeasure as wo, sharedCompilationCache as wr, RemoteDeviceBackend as ws, StatsCapacityWait as wt, HostedAppFile as wu, agentDeviceStateDirsAsync as x, DeviceRecord as xa, MaintenanceStatus as xc, FingerprintMemoRecord as xi, readWorkspaceAgent as xl, capDrops as xn, DeviceAppProcess as xo, serverSetupDir as xr, IOS_SIMULATOR_APPS as xs, STATS_VERSION as xt, parseHostedMacosPlacement as xu, readSetupJournal as y, ConcurrencyLimits as ya, MaintenanceSize as yc, tailRead as yi, readLastBuilds as yl, RecordedSegment as yn, ChecksState as yo, pullRequestCacheDir as yr, ANDROID_EMULATOR_APPS as ys, RunHistory as yt, parseHostedMacosChoice as yu, readGcLog as z, loadState as za, parseHostedAndroidPlacement as zc, readHomeIdentity as zi, HostedNativeOffer as zl, archiveDir as zn, MetroBundleState as zo, workspaceLogsDir as zr, coerceSettingText as zs, trimSamples as zt, machineCacheUsageFile as zu };