@stim-cli/core 1.27.0 → 1.28.0

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

@@ -160,690 +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 maxLoadPerCore(): number;
-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;
-    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/trace.d.ts
-declare const TRACE_ENV = "STIM_TRACE";
+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;
 /**
- * `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`.
+ * 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 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;
-}
+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;
 /**
- * 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`.
+ * 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 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
+declare function lastNativeUseFrom(state: WorkspaceState | null): number;
+declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
 /**
- * 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.
+ * 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 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 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;
 /**
- * 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.
+ * 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 countErrorEntries(records: readonly NdjsonRecord[]): number;
+type WarmRecord = {
+  phase: "warming";
+  step: WarmStep;
+  startedAt: string;
+  claim: {
+    root: string;
+    claimId: 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/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[];
+//#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 readFingerprintMemo(platform: string, digest: string): FingerprintMemoRecord | null;
+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/logs-query.d.ts
-interface SinceResult {
-  ms?: number;
-  error?: string;
+//#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/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 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;
+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;
 }
-declare function parseSince(text: unknown): SinceResult;
-declare function compileGrep(pattern: unknown): GrepResult;
-declare const ERROR_SOURCES: string[];
-declare function markerWindow(records: NdjsonRecord[]): MarkerWindow;
-/**
- * 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.
- */
-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";
 /**
- * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
- * `msg` or as a `context` string array.
+ * 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.
  */
-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 MemoryCulprit {
+  pid: number;
+  name: string;
+  bytes: number;
+  command: string | null;
+  note: string | null;
 }
-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;
+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;
 }
-/** 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[];
+interface MaintenancePass {
+  startedAt: number;
+  durationMs: number;
+  trigger: string;
+  mode: "report" | "on";
+  freedBytes: number;
+  actions: number;
+  stopped: 0;
+  blocked: string[];
 }
-/**
- * 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.
- */
-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>;
+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";
 }
-/**
- * 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>;
-//#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;
+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/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;
+//#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"];
@@ -943,1452 +943,1515 @@ declare const REPLACED_SETTINGS: Readonly<Record<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;
-/**
- * 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;
-}
-/** 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 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.
- */
-interface HostedAgentLease {
-  tenant: string;
-  runId: string;
-  clientId: string;
-  deviceKey: string;
-  backend?: "ios-instance" | "android-instance";
-}
-/**
- * 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 HostedAgentIssuedGrant {
-  driver: string;
-  path: string;
-  token: string;
-  scope: string;
-  lease?: HostedAgentLease;
-}
+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;
 /**
- * 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.
+ * 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`.
  */
-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;
-};
+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 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.
+ * 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.
  */
-type HostedAgentAccess = {
-  driver: "none";
-  setting: "hosting.agentDriver";
-} | {
-  driver: string;
-  remoteConfig: string;
-  command: string;
+type BuildPlacement = "local" | {
+  host: string;
+  phase: string;
+  startedAt: string;
+  phaseStartedAt: 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;
-}
-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;
-}
-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 BuildWaitingFor {
+  kind: "build-slot" | "device-slot";
+  inUse: number;
+  max: number;
+  since: string;
 }
-interface HostedIosDevice extends HostedIosChoice {
-  udid: string;
-  name: 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;
 }
-interface HostedAndroidChoice {
-  systemImage: string;
-  deviceProfile: string;
-  architecture: "arm64-v8a" | "x86_64";
+/**
+ * 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.
+ */
+interface BuildActivity {
+  name: "booting" | "bundling" | "waiting-ready";
+  startedAt: string;
+  percent?: number;
 }
-interface HostedAndroidDevice extends HostedAndroidChoice {
-  avdName: string;
-  serial: string;
-  consolePort: number;
+/** One phase a running build is expected to go through, and its median duration in comparable runs. */
+interface PlannedPhase {
+  phase: BuildPhase;
+  expectedMs: number;
 }
-type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
-interface HostedDeviceSelectors {
-  deviceType?: string;
-  runtime?: string;
-  systemImage?: string;
-  deviceProfile?: string;
+/** 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.
+ */
+interface BuildDetail {
+  step: NativeBuildStep | null;
+  unit: "targets" | "tasks" | "steps" | null;
+  done: number | null;
+  total: number | null;
+  line: string | null;
+  updatedAt: string;
 }
-interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
-  platform: HostedDevicePlatform;
+/** 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;
 }
-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;
-    };
-  };
-  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;
+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;
+}
+/**
+ * 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;
+}
+/** 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;
-  attempt: 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;
 }
-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;
+/** 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;
+}
+/** 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;
+}
+/**
+ * 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[];
+}
+/** 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;
   };
-  notice?: string;
-  appAttempt?: string;
-  agent?: HostedAgentGrant;
-  metroPort?: number;
-  clientMetroPort?: number;
+  /** 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;
 }
-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;
+/** 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 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;
+type ActivityState = "driven" | "active" | "idle" | "unknown";
+interface ActivityDriver {
+  tool: string;
+  pid: number | null;
+  since: string | null;
 }
-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 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[];
 }
-/** 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;
+/** 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];
 }
-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.
+ * 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.
  */
-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 WorktreeGit {
+  changed: number;
+  untracked: number;
+  upstream: string | null;
+  ahead: number | null;
+  behind: number | null;
+  mergedInto: string | null;
+}
 /**
- * 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.
+ * 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.
  */
-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;
+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];
 /**
- * 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.
+ * 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 lastNativeUseFrom(state: WorkspaceState | null): 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";
+}
+interface RemoteDeviceState {
+  platform: "ios" | "android" | null;
+  backend: "eas";
+  sessionId: string;
+  state: "claimed" | "unclaimed" | "unknown";
+  startedAt: string | null;
+  webPreviewUrl: string | null;
+}
 /**
- * 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`.
+ * 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.
  */
-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;
+type GitChipPart = {
+  kind: "arrows";
+  ahead: number;
+  behind: number;
+} | {
+  kind: "changed";
+  count: number;
+} | {
+  kind: "merged";
+  into: string;
+} | {
+  kind: "no-upstream";
 };
-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;
+/** 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 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;
+/**
+ * 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`.
+ */
+interface WorkspaceStage {
+  kind: (typeof WORKSPACE_STAGE_KINDS)[number];
+  since: string | null;
+  platform: StatsPlatform | "macos" | null;
+  closedApps: {
+    platform: StatsPlatform;
+    slot: 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];
 /**
- * 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.
+ * 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 MemoryCulprit {
-  pid: number;
-  name: string;
-  bytes: number;
-  command: string | null;
-  note: string | null;
+interface StatusIssue {
+  code: StatusIssueCode;
+  severity: "error" | "warning" | "info";
+  message: string;
+  remedy: string;
+  workspace: string;
+  slot?: string;
 }
-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;
+/** 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 MaintenancePass {
-  startedAt: number;
-  durationMs: number;
-  trigger: string;
-  mode: "report" | "on";
-  freedBytes: number;
-  actions: number;
-  stopped: 0;
-  blocked: 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 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";
+/** 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 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[];
+/**
+ * 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 MaintenanceStatus {
-  mode: MaintenanceMode;
-  invalid?: string;
-  claim?: {
-    unresolved: string;
-    removeCommand: string;
-  };
-  lastChecks: {
-    pressure: number | null;
-    size: number | null;
-    worktree: number | null;
-    sweep: number | null;
+/**
+ * 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;
   };
-  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 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 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;
+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;
+}
+/** 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;
   };
-  version: number;
-  replacedBy?: string;
-}
-interface ArchivedUsage {
-  count: number;
-  bytes: number;
-  byKind: {
-    logs: number;
-    recordings: number;
-    agentActions: number;
-    record: 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[];
 }
-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 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";
+/** `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;
 }
-interface MacosAppState extends MacosAppRecord {
-  state: "running" | "orphaned" | "stopped" | "unverified";
+/**
+ * `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 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;
 }
-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.
+ * 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.
  */
-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 StatusBuildSlotHolder {
+  slot: number;
+  workspace: string | null;
+  client: string | null;
+  since: string | null;
+  unresolved?: true;
 }
-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;
+/** `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[];
 }
-/** 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];
+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;
+}
+/**
+ * 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.
+ */
+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];
 /**
- * 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.
+ * 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 BuildDetail {
-  step: NativeBuildStep | null;
-  unit: "targets" | "tasks" | "steps" | null;
-  done: number | null;
-  total: number | null;
-  line: string | null;
-  updatedAt: string;
+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;
 }
-/**
- * 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[];
+interface AndroidDeviceRecord {
+  avdName?: string;
+  consolePort?: number;
+  serial?: string;
+  kind?: string;
+  deviceName?: string | null;
+  owned?: boolean;
+  setupIncomplete?: boolean;
+  bootPending?: boolean;
+  [key: string]: unknown;
+}
+type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
+interface PlatformRecords {
+  ios?: IosDeviceRecord;
+  android?: AndroidDeviceRecord;
+  [platform: string]: DeviceRecord | undefined;
+}
+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 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 DoctorRunRecord {
+  at: string;
+  version: string;
 }
-/** 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 RepoRecord {
+  settings?: SettingsObject;
+  [key: string]: unknown;
 }
-type ActivityState = "driven" | "active" | "idle" | "unknown";
-interface ActivityDriver {
-  tool: string;
-  pid: number | null;
-  since: string | null;
+interface ConcurrencyLimits {
+  maxBuilds: number;
+  maxDevices: 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[];
+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;
 }
-/** Every state a device's app process can report. */
-declare const APP_PROCESS_STATES: readonly ["running", "stopped", "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;
 /**
- * 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.
+ * 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 DeviceAppProcess {
-  id: string;
-  state: (typeof APP_PROCESS_STATES)[number];
-}
+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;
 /**
- * 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.
+ * 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 WorktreeGit {
-  changed: number;
-  untracked: number;
-  upstream: string | null;
-  ahead: number | null;
-  behind: number | null;
-  mergedInto: string | null;
+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;
+}
+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;
 }
 /**
- * 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.
+ * 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 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];
+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";
 /**
- * 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.
+ * `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`.
  */
-interface AgentSession {
-  tool: AgentTool;
-  sessionId: string;
-  title?: string;
-  cwd: string;
-  startedAt?: string;
-  lastActiveAt?: string;
-  pid?: number;
-  openUrl?: string;
-  webUrl?: string;
+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;
 }
 /**
- * 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.
+ * 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`.
  */
-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 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[];
+  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
 }
-/** `committedMb` sums the environments' `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
-interface StatusCapacity {
-  liveCount: number;
-  committedMb: number;
-  totalMemoryMb: number;
-  overCapacity: 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[];
 }
-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;
+/**
+ * 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.
+ */
+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>;
 }
 /**
- * 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.
+ * 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 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];
+declare function openLogDir(dir: string, { order, signal }?: {
+  order?: "timeline" | "name";
+  signal?: AbortSignal;
+}): Promise<LogDir>;
+//#endregion
+//#region state/ndjson-tail.d.ts
 /**
- * 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`.
+ * 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.
  */
-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 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;
@@ -2649,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;
@@ -2836,8 +2897,16 @@ interface BuildLedgerRecord extends NdjsonRecord {
   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[];
@@ -2956,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 { findPeer as $, hostedMacosAppSlot as $a, queryJsonLogs as $c, readDevServerStopRequest as $i, withConfigLock as $l, MachineUsageState as $n, runId as $o, MaintenanceMode as $r, maintenanceAttemptFile as $s, pullRequestCacheFile as $t, BuildLedgerRecord as A, parseHostedAndroidDevice as Aa, worktreeArchiveRoot as Ac, BUILD_HISTORY_LIMIT as Ai, TracePhases as Al, BuildPhase as An, RemoteDeviceBackend as Ao, MacosAppRecord as Ar, buildLedgerDir as As, offloadSummary as At, machineCacheUsageFile as Au, HOSTED_LOGS_PAGE_BYTES as B, readHostedSessions as Ba, advanceTail as Bc, MAINTENANCE_LOG_NAME as Bi, allMetroPorts as Bl, DeviceLeaseState as Bn, TUNNEL_MODES as Bo, ArchivedWorkspace as Br, deviceHostMachinesFile as Bs, DeviceViewersRecord as Bt, AgentActionReaderOptions as Bu, BuildLedgerCache as C, HostedNativeOffer as Ca, workspaceLightenedFile as Cc, parseHostedAndroidPlacement as Ci, readStateFile as Cl, BuildCause as Cn, settingsJsonSchema as Co, WebBrowserState as Cr, prefersRemote as Cs, StatsCapacityWait as Ct, buildSlotsDir as Cu, BuildLedgerOutcome as D, hostedConsolePort as Da, workspaceRecordingsDir as Dc, parseHostedNativePlacement as Di, TRACE_ENV as Dl, BuildMissCategory as Dn, IOS_SIMULATOR_APPS as Do, WorktreeFacts as Dr, archiveRoot as Ds, StatsScope as Dt, tryAcquireBuildSlotClaim as Du, BuildLedgerFailure as E, deviceHostRoot as Ea, workspaceMetadataFile as Ec, hostedNativeRecords as Ei, EndSpan as El, BuildHistoryEntry as En, ANDROID_PCH_CHOICES as Eo, WorkspaceStage as Er, archiveLock as Es, StatsReport as Et, saturation as Eu, GcLogStatus as F, parseHostedOfferRequest as Fa, ERROR_SOURCES as Fc, DevServerStopRequest as Fi, DebugLog as Fl, BuildResult as Fn, SettingEntry as Fo, parseMacosRecord as Fr, clientIdentityKeyFile as Fs, statsProjectKey as Ft, AgentDeviceUsage as Fu, parseHostedLogsCursor as G, HostedAgentGrant as Ga, fileIdentity as Gc, WarmRecord as Gi, getParkedMax as Gl, EnvironmentState as Gn, coerceSettingText as Go, readArchiveAsync as Gr, easMachineStateRoot as Gs, ENDED_AGENT_RETENTION_MS as Gt, LEVELS as Gu, HostedLogsPage as H, HOSTED_MACOS_APP_SLOTS as Ha, buildCriteria as Hc, READY_PHASE_MS as Hi, configCorruptRepair as Hl, DiskMeasure as Hn, WEB_VIEWPORTS as Ho, archivedUsage as Hr, deviceViewersDir as Hs, readViewedDevices as Ht, AgentTarget as Hu, GcLogTrigger as I, parseHostedPlatformDevice as Ia, LogQueryOptions as Ic, DeviceIdleShutdownRecord as Ii, createDebugLog as Il, BuildWaitingFor as In, SettingScope as Io, readHostedMacosApp as Ir, configLockPath as Is, trimCapacityRefusals as It, AgentDeviceUsageRoots as Iu, Endpoint as J, HostedAppLaunch as Ja, isExpoErrorContext as Jc, lastNativeUseFrom as Ji, getRepoSettings as Jl, LastBuildReport as Jn, isSensitiveReference as Jo, readArchivesAsync as Jr, emulatorLogFile as Js, agentSessionOf as Jt, levelRank as Ju, readHostedNativeLogsCheckpoint as K, HostedAgentIssuedGrant as Ka, fileSizes as Kc, WorkspaceState as Ki, getProject as Kl, GitChip as Kn, expectedShape as Ko, readArchiveState as Kr, easSessionLedgerFile as Ks, PullRequestCacheEntry as Kt, NdjsonRecord as Ku, isGcLogRecord as L, parseHostedRequest as La, LogQueryPlan as Lc, IDLE_STOP_KEY as Li, debugLogDir as Ll, ChecksState as Ln, SettingType as Lo, readMacosRecord as Lr, createdDevicesFile as Ls, trimCapacityWaits as Lt, agentDeviceUsageFile as Lu, readBuildLedger as M, parseHostedDevice as Ma, LogDir as Mc, DEVICE_RECLAIM_REASON as Mi, redactCommandLine as Ml, BuildPlanPayload as Mn, SETTING_GROUPS as Mo, MacosBuild as Mr, buildLedgerLock as Ms, readRunEstimates as Mt, SwiftpmCacheUsage as Mu, GcLogOptions as N, parseHostedLocalDeviceCount as Na, LogDirQuery as Nc, DEV_SERVER_STOP_REQUEST_KEY as Ni, trace as Nl, BuildPlatform as Nn, SETTING_SCOPES as No, MacosProcess as Nr, buildMachinesFile as Ns, readStats as Nt, readSwiftpmCacheUsage as Nu, BuildLedgerPlacement as O, hostedDeviceId as Oa, workspaceStateFile as Oc, unreadableHostedNative as Oi, Trace as Ol, BuildMissChange as On, REMOTE_DEVICE_BACKENDS as Oo, WorktreeGit as Or, budgetSweepFile as Os, decodeStats as Ot, MachineCacheUsage as Ou, GcLogRecord as P, parseHostedNativeOffer as Pa, openLogDir as Pc, DevServerStopRecord as Pi, DEBUG_ENV as Pl, BuildReport as Pn, SettingDefinition as Po, macosAppState as Pr, buildMachinesLock as Ps, readStatsReport as Pt, swiftpmCacheUsageFile as Pu, endpoint as Q, hostedAgentDriverName as Qa, planLogQuery as Qc, readDevServerStop as Qi, windowsShortDirKey as Ql, MachineOwnerKind as Qn, RUN_ID_ENV as Qo, MaintenanceCheck as Qr, gitMergeCacheDir as Qs, listStatusCacheEntries as Qt, readGcLog as R, readHostedDevice as Ra, NATIVE_CRASH_LOG_PREFIX as Rc, IdleStopRecord as Ri, debugLoggingEnabled as Rl, DeviceActivity as Rn, SettingWriteResult as Ro, ArchivedBytes as Rr, createdDevicesLock as Rs, trimSamples as Rt, readAgentDeviceUsage as Ru, BUILD_LEDGER_CAP as S, HostedIosDevice as Sa, workspaceGradleBuild as Sc, hostedAndroidStatus as Si, readJsonObject as Sl, BuildCacheHit as Sn, SETTINGS_SCHEMA_URL as So, WarmStep as Sr, placementWord as Ss, StatsCapacityRefusal as St, buildSlotPath as Su, BuildLedgerDevice as T, deviceHostArea as Ta, workspaceLogsDir as Tc, HostedNativePlacement as Ti, readHomeIdentity as Tl, BuildDiagnostic as Tn, ANDROID_EMULATOR_APPS as To, WorkspacePhase as Tr, archiveDir as Ts, StatsRecord as Tt, maxLoadPerCore as Tu, hostedMacosLogsDir as U, HostedAgentAccess as Ua, bundleMarkerPlatform as Uc, WARM_KEY as Ui, findEnclosingWorktreeRoot as Ul, EndedAgentSession as Un, WebViewport as Uo, linkReplacedArchives as Ur, diskUsageCacheDir as Us, stimBuildDigest as Ut, createAgentActionReader as Uu, HostedLogsCursor as V, HOSTED_AGENT_DRIVERS as Va, attachExpoErrorContext as Vc, MetroLastStop as Vi, buildWorkerRoot as Vl, DevicePlacement as Vn, TunnelMode as Vo, archiveEnabled as Vr, deviceHostMachinesLock as Vs, ViewedDevice as Vt, AgentRecordSelection as Vu, hostedNativeLogsDir as W, HostedAgentDriverName as Wa, compileGrep as Wc, WORKSPACE_AGENT_KEY as Wi, getConcurrencyLimits as Wl, EnvironmentDisk as Wn, acceptsShape as Wo, readArchive as Wr, diskUsageWalkClaims as Ws, AgentSessionsCache as Wt, createAsyncAgentActionReader as Wu, TailnetPeer as X, HostedMacosDevice as Xa, markerWindow as Xc, parseMissReason as Xi, loadConfig as Xl, MEMORY_SOURCES as Xn, settingDefinition as Xo, MaintenanceAction as Xr, gcLogFile as Xs, diskUsageFailureFile as Xt, parseNdjsonText as Xu, TAILNET_MACHINE_PATTERN as Y, HostedMacosChoice as Ya, logFiles as Yc, lastUseFrom as Yi, isPathPrefix as Yl, MACHINE_OWNER_KINDS as Yn, replacementAdvice as Yo, DiskPressureLevel as Yr, gcLogDir as Ys, diskUsageCacheFile as Yt, parseNdjsonLine as Yu, cannotHost as Z, HostedMacosPlacement as Za, parseSince as Zc, readBuildHistory as Zi, windowsShortDir as Zl, MachineOwner as Zn, settingValueError as Zo, MaintenanceActionKind as Zr, getConfigPath as Zs, endedAgentSessionOf as Zt, readNdjsonGenerations as Zu, isSetupJournalPrunable as _, HostedDevicePlatform as _a, workspaceAgentDeviceDir as _c, HostedAndroidPlacement as _i, readCreatedDevices as _l, AndroidRuntimeFacts as _n, readHostedAppMetadata as _o, StatusPayload as _r, recordingEnabled as _s, RunEstimates as _t, MACHINE_CREDENTIALS_VERSION as _u, MachineView as a, readWorkspaceAgent as aa, pullRequestCacheDir as ac, MaintenanceStatus as ai, tailRead as al, readPullRequestCache as an, parseHostedMacosPlacement as ao, PHYSICAL_DEVICE_CONNECTIONS as ar, RecordedSegment as as, HostedMetroRequest as at, ConcurrencyLimits as au, agentDeviceStateDirs as b, HostedDeviceSession as ba, workspaceEndedAgentsFile as bc, hostedAndroidPlacements as bi, isJsonObject as bl, BUILD_RESULTS as bn, validHostedAppBlob as bo, WORKSPACE_PHASES as br, PlacementWord as bs, STATS_VERSION as bt, readBuildMachines as bu, SummaryBuild as c, DEVICE_HOST_LIMITS as ca, setupJournalFile as cc, readMaintenanceAttempt as ci, fingerprintMemoDir as cl, ACTIVITY_RECENCY_BASES as cn, HostedAppFile as co, PlannedPhase as cr, closedSegmentName as cs, DeviceHostMachineCredential as ct, DoctorRunRecord as cu, WorktreeRow as d, HostedAndroidChoice as da, sharedGradle as dc, HostedIosStatus as di, readFingerprintMemo as dl, ActiveBuildState as dn, hostedAppArea as do, STATUS_ISSUE_CODES as dr, listRecordedDevicesAsync as ds, CAPACITY_REFUSAL_LIMIT as dt, RepoRecord as du, readDeviceIdleShutdowns as ea, maintenanceChildLogFile as ec, MaintenancePass as ei, queryLogs as el, readAgentSessionsCache as en, hostedMacosBundleId as eo, MacosBuildPlanPayload as er, validRunId as es, machineEndpoint as et, withConfigLockAsync as eu, statusViews as f, HostedAndroidDevice as fa, sharedPods as fc, hostedIosPlacements as fi, countErrorEntries as fl, ActivityDriver as fn, hostedAppAttempt as fo, SimulatorState as fr, listSegments as fs, CAPACITY_REFUSAL_MAX_AGE_MS as ft, SettingsObject as fu, isJournalExpired as g, HostedDevicePhase as ga, trashRoot as gc, unreadableHostedIos as gi, EasSessionLedgerRead as gl, AndroidDeviceState as gn, readHostedApp as go, StatusIssueCode as gr, recordingDeviceName as gs, ReadStatsResult as gt, BuildMachineCredential as gu, SetupJournal as h, HostedDeviceOfferRequest as ha, supervisorPidFile as hc, parseHostedIosPlacement as hi, EasSessionClaim as hl, AgentTool as hn, parseHostedAppOffer as ho, StatusIssue as hr, recordedBytes as hs, PLACEMENT_DECISIONS as ht, clientIdentity as hu, ArchivedSummary as i, readWarmRecord as ia, maintenanceStateFile as ic, MaintenanceState as ii, sortByTs as il, readEndedAgentSessions as in, parseHostedMacosDevice as io, NativeBuildStep as ir, RecordedDevice as is, HostedMetroGateway as it, validateAutomaticPool as iu, isBuildLedgerRecord as j, parseHostedChoice as ja, createNdjsonTail as jc, DEVICE_IDLE_SHUTDOWN_KEY as ji, redactArgv as jl, BuildPlacement as jn, SETTINGS as jo, MacosAppState as jr, buildLedgerFile as js, projectRootDirectories as jt, readMachineCacheUsage as ju, BuildLedgerPlatform as k, hostedWorkerSettleMs as ka, workspaceStateLock as kc, BUILD_HISTORY_KEY as ki, TraceArgs as kl, BuildMissReason as kn, REPLACED_SETTINGS as ko, WorktreePullRequest as kr, budgetSweepLock as ks, findProjectRoot as kt, SimRuntimeUsage as ku, SummaryHistoryEntry as l, DeviceHostLimits as la, sharedCcache as lc, readMaintenanceState as li, fingerprintMemoFile as ll, AGENT_TOOLS as ln, HostedAppOffer as lo, RemoteDeviceState as lr, footageDrops as ls, readDeviceHostMachines as lt, PlatformRecords as lu, SetupCapability as m, HostedDeviceOffer as ma, supervisorLogFile as mc, hostedIosStatus as mi, CreatedDevices as ml, AgentSession as mn, parseHostedAppManifest as mo, StatusCapacity as mr, openSegmentName as ms, OffloadSummary as mt, SupervisorRecord as mu, KeyedEntities as n, readIdleStop as na, maintenanceNdjsonFile as nc, MaintenanceRecord as ni, readLogTimeline as nl, readDiskUsage as nn, parseHostedAgentGrant as no, MetroBundleState as nr, RECORDING_FOOTAGE_MS as ns, HOSTED_METRO_GATEWAYS_KEY as nt, automaticMachineEnabled as nu, SUMMARY_ARCHIVES as o, readWorkspaceState as oa, serverLocalSocket as oc, MemoryCulprit as oi, FINGERPRINT_MEMO_SCHEMA as ol, withDerivedFacts as on, HOSTED_APP_CHUNK_BYTES as oo, PhysicalDeviceConnection as or, RecordingPlatform as os, hostedMetroGateways as ot, Config as ou, workspaceSummary as p, HostedDevice as pa, statsFile as pc, hostedIosRecords as pi, CreatedDevicePlatform as pl, ActivityRecencyBasis as pn, hostedAppBlobs as po, StatsPlatform as pr, listSegmentsAsync as ps, HISTORY_LIMIT as pt, StimConfig as pu, readLogsSince as q, HostedAgentLease as qa, followLogs as qc, buildDiagnostics as qi, getProjectSettings as ql, GitChipPart as qn, isLayeredSetting as qo, readArchives as qr, easSessionLedgerLock as qs, StatusCacheEntry as qt, SOURCES as qu, applyKeyedDelta as r, readLastBuilds as ra, maintenanceRunClaims as rc, MaintenanceSize as ri, recordMatches as rl, readDiskUsageFailure as rn, parseHostedMacosChoice as ro, NATIVE_BUILD_STEPS as rr, RECORDING_PLATFORMS as rs, HOSTED_METRO_REQUESTS_KEY as rt, requireAutomaticMachine as ru, StatusViews as s, workspaceLastUsed as sa, serverSetupDir as sc, parseMaintenanceState as si, FingerprintMemoRecord as sl, withGitChip as sn, HostedAppDelivery as so, PhysicalDeviceState as sr, capDrops as ss, hostedMetroRequests as st, DeviceRecord as su, KeyedDelta as t, readDevicePlacement as ta, maintenanceDir as tc, MaintenancePressure as ti, readLogRecords as tl, readBuildDetail as tn, parseHostedAgentAccess as to, MemorySource as tr, RECORDING_CAP_BYTES as ts, parseMachine as tt, AutomaticPoolRole as tu, WorkspaceSummary as u, HOSTED_PARKED_CANDIDATES as ua, sharedCompilationCache as uc, HostedIosPlacement as ui, fingerprintMemoLock as ul, APP_PROCESS_STATES as un, HostedAppRecord as uo, RunOutcomeKind as ur, listRecordedDevices as us, BuildMachineTotals as ut, ProjectRecord as uu, parseSetupJournal as v, HostedDeviceRequest as va, workspaceBuildDetailFile as vc, HostedAndroidStatus as vi, readEasSessionLedger as vl, AppPresence as vn, rememberHostedAppBlobRename as vo, TUTORIAL_VERSION as vr, AutomaticPlacement as vs, RunHistory as vt, MachineCredential as vu, BuildLedgerCacheResult as w, assertHostedDeviceLedger as wa, workspaceLogErrorIndex as wc, unreadableHostedAndroid as wi, withStateReadCache as wl, BuildDetail as wn, ANDROID_COMPILER_CACHE_CHOICES as wo, WebPageState as wr, agentSessionsCacheFile as ws, StatsPlacement as wt, machineCapacity as wu, agentDeviceStateDirsAsync as x, HostedIosChoice as xa, workspaceEndedAgentsLock as xc, hostedAndroidRecords as xi, readJsonFile as xl, BuildActivity as xn, SETTINGS_SCHEMA_FILE as xo, WORKSPACE_STAGE_KINDS as xr, mayRunHere as xs, StatsBucket as xt, MachineCapacity as xu, readSetupJournal as y, HostedDeviceSelectors as ya, workspaceDerivedData as yc, hostedAndroidDeviceName as yi, validEasSessionClaim as yl, BUILD_PHASES as yn, validHostedAppArguments as yo, WEB_PAGE_STATES as yr, PLACEMENT_WORDS as ys, RunSample as yt, parseMachineCredential as yu, HOSTED_LOGS_FIRST_BYTES as z, readHostedDeviceLedger as za, QueryCriteria as zc, LAST_BUILD_KEYS as zi, ParkedMax as zl, DeviceAppProcess as zn, SettingsPayload as zo, ArchivedUsage as zr, deviceHostMachinesClaims as zs, wholePhases as zt, readAgentDeviceUsageCache as zu };
+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 };