@stim-cli/core 1.20.2 → 1.21.0

package/dist/{index-VDWBflH3.d.mts → index-_wkluvP_.d.mts}

@@ -1,4 +1,5 @@
-import { o as ClaimHandle } from "./ownership-claim-Xxxr9MPp.mjs";
+import { l as NoiseKeyPair } from "./noise-DYIbymAJ.mjs";
+import { o as ClaimHandle } from "./ownership-claim-Bf8Lq6AY.mjs";
 //#region state/ndjson.d.ts
 interface NdjsonRecord {
   ts?: number;
@@ -38,12 +39,14 @@ interface AgentActionReaderOptions {
   now?: () => number;
   claimedDevice?: (session: string, sessionsDir: string) => string | null;
 }
-/**
- * Reads agent-device session actions incrementally from the supplied sessions directories. With targets,
- * records are restricted to those devices; without targets, retained session metadata supplies attribution.
- * Missing directories and unreadable files yield no records.
- */
-declare function createAgentActionReader({ sessionsDirs, targets: resolveTargets, sinceTs, now, claimedDevice }: AgentActionReaderOptions): () => NdjsonRecord[];
+interface AgentRecordSelection {
+  tail?: number;
+  matches: (record: NdjsonRecord) => boolean;
+}
+/** Reads new agent-device actions synchronously, retaining attribution cursors between reads. */
+declare function createAgentActionReader(options: AgentActionReaderOptions): () => NdjsonRecord[];
+/** Reads new agent-device actions asynchronously; selection applies only to matching output from this call. */
+declare function createAsyncAgentActionReader(options: AgentActionReaderOptions, signal?: AbortSignal): (selection?: AgentRecordSelection) => Promise<NdjsonRecord[]>;
 //#endregion
 //#region state/agent-device-usage.d.ts
 interface AgentDeviceUsage {
@@ -129,6 +132,33 @@ interface SwiftpmCacheUsage {
 declare function swiftpmCacheUsageFile(): string;
 declare function readSwiftpmCacheUsage(): SwiftpmCacheUsage | null;
 //#endregion
+//#region state/machine-cache-usage.d.ts
+interface SimRuntimeUsage {
+  identifier: string;
+  runtimeIdentifier: string;
+  version: string | null;
+  build: string | null;
+  bytes: number | null;
+  deletable: boolean;
+  lastUsedAt: string | null;
+  devices: number;
+}
+/** The cached measurement of other tools' machine-wide caches that gc reports and never deletes. */
+interface MachineCacheUsage {
+  version: 1;
+  measuredAt: string;
+  roots: string[];
+  sizes: {
+    dir: string;
+    bytes: number | null;
+  }[];
+  runtimes: SimRuntimeUsage[] | null;
+  agentDeviceVersion: string | null;
+  xcodeBuildVersion: string | null;
+}
+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;
@@ -145,9 +175,9 @@ declare function tryAcquireBuildSlotClaim({ max, details }: {
   path: string;
 } | null;
 /**
- * How busy this Mac is for native builds. `loadPerCore` is the 5-minute load average divided by the CPU count,
+ * 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 Mac, plus the build slots this Mac holds for other Macs'
+ * 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 {
@@ -158,27 +188,37 @@ interface MachineCapacity {
   maxLoadPerCore: number;
 }
 declare function machineCapacity(): MachineCapacity;
-/** Why a Mac with this capacity should not take another native build; null when it can. */
+/** 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
 /**
- * A remote Mac this Mac asked to build on. `machine` is the `remote.machines` entry; `nodeId` is the
- * worker's tailnet StableID pinned when the request was sent, which every later connection must match.
+ * 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 BuildMachineCredential {
+interface MachineCredential {
   machine: string;
-  nodeId: string;
-  dnsName: string;
-  deviceId: string;
-  deviceToken: string;
+  transport: "tailscale";
+  address: string;
   state: "pending" | "approved";
   requestedAt: string;
+  serverKey?: string;
+  deviceId?: string;
+  ticket?: string;
   expiresAt?: string;
-  ticketHash?: 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 {
@@ -251,6 +291,7 @@ interface ConcurrencyLimits {
 }
 interface StimConfig {
   version?: number;
+  homeId?: string;
   projects: Record<string, ProjectRecord>;
   repos: Record<string, RepoRecord>;
   tempDir?: unknown;
@@ -280,6 +321,8 @@ interface StimConfig {
     logs?: unknown;
   };
   server?: {
+    buildsPaused?: unknown;
+    devicesPaused?: unknown;
     acceptClientBuilds?: unknown;
     maxLoadPerCore?: unknown;
     workerRoot?: unknown;
@@ -300,13 +343,28 @@ type Config = StimConfig;
 type AutomaticPoolRole = "build" | "device";
 declare function automaticMachineEnabled(role: AutomaticPoolRole, machine: string, config?: StimConfig | null): boolean;
 declare function requireAutomaticMachine(role: AutomaticPoolRole, machine: string): void;
-declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig): 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;
 //#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 }?: {
@@ -321,12 +379,10 @@ declare function getParkedMax(platform: "ios" | "android", { config, env }?: {
   env?: NodeJS.ProcessEnv;
 }): ParkedMax;
 declare function getProjectSettings(projectPath: string): Record<string, unknown>;
-declare function getProjectSetting(projectPath: string, dottedKey: 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[];
-declare function findProjectByMetroPort(port: number): string | null;
 //#endregion
 //#region state/debug-log.d.ts
 declare const DEBUG_ENV = "STIM_DEBUG";
@@ -349,6 +405,10 @@ declare function createDebugLog(component: "cli" | "server", { env, now, base }?
   base?: () => Record<string, unknown>;
 }): DebugLog;
 //#endregion
+//#region state/home-identity.d.ts
+/** The persistent, nonsecret identity of this Stim home; null until the CLI initializes it. */
+declare function readHomeIdentity(config?: Config | null): string | null;
+//#endregion
 //#region state/json-file.d.ts
 /**
  * Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
@@ -452,24 +512,42 @@ declare function readLogRecords(dir: string, include?: (name: string) => boolean
 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.
  */
 declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
-declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: {
+interface LogQueryOptions {
   slot?: string;
-  dir?: string;
-  records?: NdjsonRecord[];
   sources?: string[];
   minLevel?: string;
   since?: string;
   grep?: string | RegExp;
-  tail?: number;
   errorsOnly?: boolean;
-  errorContext?: boolean;
   now?: number;
+}
+interface LogQueryPlan {
+  /** Whether a record belongs to the queried slot's timeline, before any other filter. */
+  inTimeline: (record: NdjsonRecord) => boolean;
+  matches: (record: NdjsonRecord) => boolean;
+  launchTs: number | null;
+  sinceTs: number | undefined;
+  /**
+   * Whether no record with a timestamp at most `maxTs`, or without one when `maxTs` is Infinity, can match.
+   * `slots` lists every `slot ?? 'default'` value the records can carry; without it, a query that depends on
+   * per-slot launch markers cannot rule out any timestamp.
+   */
+  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
+}
+/** Decides which records a query matches from the timeline's marker records alone. */
+declare function planLogQuery(markers: readonly NdjsonRecord[], { slot, sources, minLevel, since, grep, errorsOnly, now }?: LogQueryOptions): LogQueryPlan;
+declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: LogQueryOptions & {
+  dir?: string;
+  records?: NdjsonRecord[];
+  tail?: number;
+  errorContext?: boolean;
 }): NdjsonRecord[];
 /** Queries the JSON timeline, including Expo context fields on errors as `stim logs --json` does. */
 declare function queryJsonLogs(options?: Parameters<typeof queryLogs>[0]): NdjsonRecord[];
@@ -485,13 +563,49 @@ declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, erro
   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;
-  /** Holds each Expo error until a poll adds no more of its code frame or stack lines, then attaches them. */
+  /** Holds each Expo error until its code frame and stack stop growing, then attaches them. */
   errorContext?: ExpoContextTarget;
 }): () => void;
 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[];
+}
+/**
+ * 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>;
+  /** 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>;
+}
+/**
+ * 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/paths.d.ts
 declare function getConfigPath(): string;
 declare function configLockPath(): string;
@@ -523,10 +637,10 @@ 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 Macs this Mac paired with, each with its pinned tailnet node and device token. */
+/** 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 Macs this Mac asked for access, separate from build credentials. */
+/** The remote machines this machine asked for access, separate from build credentials. */
 declare function deviceHostMachinesFile(): string;
 declare function deviceHostMachinesLock(): string;
 declare function deviceHostMachinesClaims(): string;
@@ -547,6 +661,10 @@ declare function maintenanceRunClaims(): string;
 declare function archiveRoot(): string;
 declare function archiveDir(id: string): string;
 declare function archiveLock(): string;
+/** This machine's own long-term X25519 key as a client of other machines' stim-servers. */
+declare function clientIdentityKeyFile(): string;
+/** The Unix socket stim-server serves this machine's own user on, without Noise or pairing. */
+declare function serverLocalSocket(): string;
 declare function serverSetupDir(): string;
 declare function setupJournalFile(hash: string): string | null;
 //#endregion
@@ -603,8 +721,9 @@ 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 id 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.
+ * 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
@@ -677,7 +796,7 @@ interface SettingEntry {
   defaultReason?: string;
 }
 /** The payload `stim settings --json` prints. */
-interface SettingsPayload {
+type SettingsPayload = {
   project: string | null;
   files: Partial<Record<SettingScope, string>>;
   settings: SettingEntry[];
@@ -687,6 +806,15 @@ interface SettingsPayload {
     file: string;
     value: unknown;
   }>;
+};
+/** The masked JSON result of a settings set or unset. */
+interface SettingWriteResult {
+  key: string;
+  scope: SettingScope;
+  file: string;
+  changed: boolean;
+  setting: SettingEntry;
+  recordingsDeleted?: string[];
 }
 declare const REMOTE_DEVICE_BACKENDS: readonly RemoteDeviceBackend[];
 declare const IOS_SIMULATOR_APPS: readonly ["xcode", "siniulator", "stim-desktop"];
@@ -777,8 +905,11 @@ declare function readHostedApp(session: string, attempt: string, workerHome?: st
 //#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";
@@ -799,21 +930,25 @@ interface HostedAgentLease {
   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;
+}
 /**
  * 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.
- * `path` is the session's base route on the host, `scope` the driver's handle that limits it to this one app,
- * and `lease` the scope that pins the driver's lease allocation.
  */
 type HostedAgentGrant = {
   driver: "none";
-} | {
-  driver: Exclude<HostedAgentDriverName, "none">;
-  path: string;
-  token: string;
-  scope: string;
-  lease: HostedAgentLease;
-};
+} | HostedAgentIssuedGrant;
 /** `app.launch` and `app.attach` results; a host includes `agent` once the app is installed. */
 type HostedAppLaunch = HostedAppDelivery & {
   agent?: HostedAgentGrant;
@@ -827,7 +962,7 @@ type HostedAgentAccess = {
   driver: "none";
   setting: "hosting.agentDriver";
 } | {
-  driver: "agent-device";
+  driver: string;
   remoteConfig: string;
   command: string;
 };
@@ -861,6 +996,8 @@ interface DeviceHostLimits {
   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 {
@@ -1070,6 +1207,11 @@ declare function readBuildHistory(state: WorkspaceState | null | undefined): Par
 declare function readWorkspaceState(root: string): WorkspaceState | null;
 declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
 declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
+/**
+ * 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 workspaceLastUsed(root: string): number;
 declare const WARM_KEY = "warm";
 /** How long a successful warm keeps a workspace `ready` when nothing runs in it. */
@@ -1165,7 +1307,9 @@ declare function hostedIosPlacements(state: WorkspaceState | null): Record<strin
 //#region state/maintenance.d.ts
 type MaintenanceMode = "off" | "report" | "on";
 type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep";
-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";
+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;
@@ -1175,13 +1319,15 @@ interface MaintenanceAction {
   dir?: string;
   olderThanDays?: number;
   check?: "worktree" | "sweep" | "disk";
+  /** The disk pressure level that planned the action; it runs only while free disk stays under that level's floor. */
+  level?: 2 | 3;
 }
 interface MaintenanceSize {
   name: string;
   dir: string;
   bytes: number;
   measuredAt: number;
-  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "other";
+  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "owned-devices" | "other";
   workspace?: string;
   idleDays?: number | null;
   blocked?: string;
@@ -1210,6 +1356,7 @@ interface MaintenancePressure {
     culprits?: MemoryCulprit[];
   };
   warningSince: number | null;
+  diskLevel?: DiskPressureLevel;
 }
 interface MaintenancePass {
   startedAt: number;
@@ -1384,7 +1531,7 @@ declare const BUILD_PHASES: readonly ["prepare", "cache-lookup", "wait", "prebui
 type BuildPhase = (typeof BUILD_PHASES)[number];
 type ActiveBuildState = "running" | "stale" | "unknown";
 /**
- * Where a running build compiles: `local`, or the remote Mac it was offloaded to, with the phase it is in there
+ * 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 BuildPlacement = "local" | {
@@ -1499,7 +1646,7 @@ interface LastBuildReport {
   buildMachine?: string;
   /** Where compilation ran: here or a machine name; absent when no build ran. */
   builtOn?: string;
-  /** The remote Mac that compiled the app when the build was offloaded. */
+  /** 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;
@@ -1588,7 +1735,7 @@ interface BuildPlanPayload {
     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 Mac; auto may use janics-mac-mini`. */
+  /** 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;
 }
 /** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
@@ -1685,7 +1832,7 @@ type AgentTool = (typeof AGENT_TOOLS)[number];
  * A coding-agent session working in an environment: one whose working directory `cwd` is the environment's path,
  * inside it, or its git worktree root, or one that ran a Stim command in it. `title` is the short name the tool keeps
  * for the session, never its conversation. `lastActiveAt` is the tool's own last update, or the Stim command's time
- * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this Mac.
+ * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this machine.
  * `webUrl` opens a Claude Code session with Remote Control connected on claude.ai/code or in the Claude mobile app.
  */
 interface AgentSession {
@@ -1940,6 +2087,8 @@ interface EnvironmentState {
     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. */
@@ -2057,7 +2206,7 @@ type MemorySource = (typeof MEMORY_SOURCES)[number];
 declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "macos", "server", "shared"];
 type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
 /**
- * One thing using this Mac's CPU and memory now. Each process is counted in exactly one owner: the one whose root
+ * 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,
@@ -2123,13 +2272,20 @@ interface StatusCacheEntry {
 }
 /** Every finished file in the disk-usage and pull-request caches; a file being written is not listed. */
 declare function listStatusCacheEntries(): StatusCacheEntry[];
-/** A worktree's cached pull request lookup: the branch and HEAD it was looked up for, and when. */
+/**
+ * A worktree's cached pull request lookup: the branch and HEAD it was looked up for, and when. `containsHead` and
+ * `endedAt` (epoch milliseconds) carry the lookup's pull request facts; entries written before them leave them out.
+ * `partial` marks a lookup made without the title, checks and review decision.
+ */
 interface PullRequestCacheEntry {
   path: string;
   branch: string;
   head: string;
   checkedAt: string;
   pullRequest: WorktreePullRequest | null;
+  containsHead?: boolean;
+  endedAt?: number | null;
+  partial?: true;
 }
 /** The cached pull request lookup of the worktree at `path`, or null before one succeeded. */
 declare function readPullRequestCache(path: string): PullRequestCacheEntry | null;
@@ -2139,7 +2295,7 @@ declare function readDiskUsage(path: string): DiskMeasure | null;
 declare function readDiskUsageFailure(path: string): string | null;
 /** The running build's tool detail its process last wrote, when the file belongs to the build with `claimId`. */
 declare function readBuildDetail(root: string, claimId: string): BuildDetail | null;
-/** The coding-agent sessions `status --watch` last found running on this Mac, and when it looked. */
+/** The coding-agent sessions `status --watch` last found running on this machine, and when it looked. */
 interface AgentSessionsCache {
   discoveredAt: string;
   sessions: AgentSession[];
@@ -2158,7 +2314,7 @@ declare function readAgentSessionsCache(): AgentSessionsCache | null;
 //#region state/stim-build.d.ts
 /**
  * A digest of Stim's built code: the first 16 hex characters of the sha256 over the sorted `*.mjs` names and
- * bytes of a `stim` `dist` directory. A client and a remote Mac offload only when both compute the same one.
+ * bytes of a `stim` `dist` directory. A client and a remote machine offload only when both compute the same one.
  */
 declare function stimBuildDigest(dir: string): string | null;
 //#endregion
@@ -2209,7 +2365,7 @@ interface RunSample {
   deviceSetup?: boolean;
 }
 type RunHistory = Partial<Record<StatsPlatform, Partial<Record<RunOutcomeKind, RunSample[]>>>>;
-/** Where a compiling build ran: here, on a remote Mac, or here after offloading it failed. */
+/** Where a compiling build ran: here, on a remote machine, or here after offloading it failed. */
 declare const PLACEMENT_DECISIONS: readonly ["here", "offloaded", "fell-back"];
 type PlacementDecision = (typeof PLACEMENT_DECISIONS)[number];
 interface StatsPlacement {
@@ -2318,21 +2474,22 @@ declare function decodeStats(text: string): {
   record: StatsRecord | null;
   newerVersion: number | null;
 };
-interface StatsReport {
+type StatsBuckets = {
+  ios: StatsBucket | null;
+  android: StatsBucket | null;
+};
+type StatsReport = {
   version: number;
   project: ({
     key: string;
-  } & StatsReport["machine"]) | null;
-  machine: {
-    ios: StatsBucket | null;
-    android: StatsBucket | null;
-  };
+  } & StatsBuckets) | null;
+  machine: StatsBuckets;
   offload: OffloadSummary;
   capacityRefusals?: StatsCapacityRefusal[];
   capacityWaits?: StatsCapacityWait[];
   agentDevice: AgentDeviceUsage | null;
   swiftpmCache: SwiftpmCacheUsage | null;
-}
+};
 declare function readStatsReport(key: string | null, now: number): {
   report: StatsReport;
   note: string | null;
@@ -2341,19 +2498,12 @@ declare function projectRootDirectories(startDir: string): Generator<string>;
 declare function findProjectRoot(startDir: string): string | null;
 //#endregion
 //#region state/device-host-machines.d.ts
-/** A separately approved remote Mac, pinned before sending its device token. */
-interface DeviceHostMachineCredential {
-  machine: string;
-  nodeId: string;
-  dnsName: string;
-  deviceId: string;
-  deviceToken: string;
-  state: "pending" | "approved";
-  requestedAt: string;
-  expiresAt?: string;
-  ticketHash?: string;
-}
-/** An absent store is empty; unreadable or malformed credentials refuse access without discarding pins. */
+/** A remote machine this machine asked for device-host access, separate from build credentials. */
+type DeviceHostMachineCredential = MachineCredential;
+/**
+ * An absent store, or one from protocol 1, is empty; an unreadable or malformed one refuses access without discarding
+ * pinned keys.
+ */
 declare function readDeviceHostMachines(): DeviceHostMachineCredential[];
 //#endregion
 //#region state/hosted-metro.d.ts
@@ -2383,6 +2533,8 @@ interface TailnetPeer {
   dnsName: string;
   /** A tailnet address of the node; WireGuard delivers packets to it only from that node. */
   address: string;
+  /** Tailscale's `OS` for the node, such as `macOS` or `linux`; absent when the status does not report it. */
+  os?: string;
 }
 declare function parseMachine(entry: string): {
   name: string;
@@ -2393,25 +2545,27 @@ declare function parseMachine(entry: string): {
  * the node's StableID, the same value `tailscale whois` reports as `Node.StableID`.
  */
 declare function findPeer(status: unknown, name: string): TailnetPeer | "missing" | "ambiguous";
+/**
+ * Whether `tailscale status` reports the peer a `remote.machines` entry names as running an OS other than macOS.
+ * Such a machine can build but never host simulators or emulators; an unknown OS counts as able to host.
+ */
+declare function cannotHost(status: unknown, entry: string): boolean;
 interface Endpoint {
   url: string;
   servername: string;
   host: string;
 }
 /**
- * Connects to the pinned node's own tailnet address rather than resolving its name, so the socket reaches the
- * node whose ID was just checked. `tailscale serve` still needs the MagicDNS name for TLS (SNI and certificate)
- * and for its Host routing.
+ * Connects to the node's own tailnet address from `tailscale status`. `tailscale serve` still needs the MagicDNS name
+ * for TLS (SNI and certificate) and for its Host routing.
  */
 declare function endpoint(peer: TailnetPeer, port: number): Endpoint;
 /**
- * The endpoint of a paired machine's pinned node, or why Stim does not connect to it. The name must still
- * resolve to exactly the pinned node; the token is never sent anywhere else.
+ * Where to reach a `remote.machines` entry now, or why Stim cannot. The tailnet only carries the bytes: the Noise
+ * handshake, pinned to the worker's server key, decides whether the machine answering is the one this machine paired
+ * with.
  */
-declare function pinnedEndpoint(credential: {
-  machine: string;
-  nodeId: string;
-}, current: unknown): Endpoint | string;
+declare function machineEndpoint(machine: string, current: unknown): Endpoint | string;
 //#endregion
 //#region state/hosted-logs.d.ts
 type HostedLogsCursor = Record<string, number>;
@@ -2444,15 +2598,17 @@ declare function readHostedNativeLogsCheckpoint(home: string, platform?: "ios" |
 declare function readLogsSince(dir: string, cursor: HostedLogsCursor): HostedLogsPage;
 //#endregion
 //#region state/agent-device.d.ts
-declare function agentDeviceStateDirs(home?: string): string[];
+declare function agentDeviceStateDirs(home?: string, env?: NodeJS.ProcessEnv): string[];
+declare function agentDeviceStateDirsAsync(home?: string, env?: NodeJS.ProcessEnv): Promise<string[]>;
 //#endregion
 //#region state/setup-journal.d.ts
 type SetupCapability = "build" | "device-host";
+/**
+ * A `stim-server setup` run's progress, named by the `journal` value derived from its ticket. It holds no secret, so it
+ * is served to whoever names it.
+ */
 interface SetupJournal {
   v: 1;
-  client: {
-    nodeId: string;
-  };
   expiresAt: string;
   capabilities: SetupCapability[];
   steps: {
@@ -2474,4 +2630,85 @@ declare function readSetupJournal(hash: string): SetupJournal | null;
 declare function isJournalExpired(journal: SetupJournal, now?: number): boolean;
 declare function isSetupJournalPrunable(journal: SetupJournal, now: number): boolean;
 //#endregion
-export { projectRootDirectories as $, SettingType as $a, readAgentDeviceUsageCache as $c, parseHostedPlatformDevice as $i, MacosAppState as $n, maintenanceDir as $o, DevServerStopRecord as $r, isJsonObject as $s, BuildPlacement as $t, DeviceHostMachineCredential as A, parseHostedAppOffer as Aa, DeviceRecord as Ac, HostedDevice as Ai, PlannedPhase as An, agentSessionsCacheFile as Ao, HostedIosStatus as Ar, buildCriteria as As, ACTIVITY_RECENCY_BASES as At, RunHistory as B, ANDROID_EMULATOR_APPS as Ba, MachineCapacity as Bc, HostedNativeOffer as Bi, TUTORIAL_VERSION as Bn, deviceHostMachinesFile as Bo, hostedAndroidRecords as Br, readLogRecords as Bs, AppPresence as Bt, pinnedEndpoint as C, HostedAppFile as Ca, withConfigLock as Cc, readWorkspaceAgent as Ci, MemorySource as Cn, footageDrops as Co, MaintenanceState as Cr, workspaceStateFile as Cs, readBuildDetail as Ct, HostedMetroRequest as D, hostedAppAttempt as Da, validateAutomaticPool as Dc, DeviceHostLimits as Di, PHYSICAL_DEVICE_CONNECTIONS as Dn, recordedBytes as Do, readMaintenanceAttempt as Dr, QueryCriteria as Ds, readPullRequestCache as Dt, HostedMetroGateway as E, hostedAppArea as Ea, requireAutomaticMachine as Ec, DEVICE_HOST_LIMITS as Ei, NativeBuildStep as En, openSegmentName as Eo, parseMaintenanceState as Er, NATIVE_CRASH_LOG_PREFIX as Es, readEndedAgentSessions as Et, HISTORY_LIMIT as F, validHostedAppBlob as Fa, SettingsObject as Fc, HostedDeviceRequest as Fi, StatsPlatform as Fn, buildMachinesLock as Fo, unreadableHostedIos as Fr, logFiles as Fs, ActivityRecencyBasis as Ft, StatsCapacityWait as G, REMOTE_DEVICE_BACKENDS as Ga, tryAcquireBuildSlotClaim as Gc, hostedDeviceId as Gi, WebBrowserState as Gn, easMachineStateRoot as Go, hostedNativeRecords as Gr, countErrorEntries as Gs, BuildCause as Gt, STATS_VERSION as H, IOS_SIMULATOR_APPS as Ha, buildSlotsDir as Hc, deviceHostArea as Hi, WORKSPACE_PHASES as Hn, deviceViewersDir as Ho, parseHostedAndroidPlacement as Hr, recordMatches as Hs, BUILD_RESULTS as Ht, OffloadSummary as I, SETTINGS_SCHEMA_FILE as Ia, StimConfig as Ic, HostedDeviceSelectors as Ii, StatusCapacity as In, configLockPath as Io, HostedAndroidPlacement as Ir, markerWindow as Is, AgentSession as It, StatsReport as J, SETTING_GROUPS as Ja, swiftpmCacheUsageFile as Jc, parseHostedChoice as Ji, WorkspaceStage as Jn, emulatorLogFile as Jo, BUILD_HISTORY_KEY as Jr, EasSessionClaim as Js, BuildHistoryEntry as Jt, StatsPlacement as K, RemoteDeviceBackend as Ka, SwiftpmCacheUsage as Kc, hostedWorkerSettleMs as Ki, WebPageState as Kn, easSessionLedgerFile as Ko, parseHostedNativePlacement as Kr, CreatedDevicePlatform as Ks, BuildDetail as Kt, PLACEMENT_DECISIONS as L, SETTINGS_SCHEMA_URL as La, SupervisorRecord as Lc, HostedDeviceSession as Li, StatusIssue as Ln, createdDevicesFile as Lo, HostedAndroidStatus as Lr, parseSince as Ls, AgentTool as Lt, BuildMachineTotals as M, readHostedAppMetadata as Ma, PlatformRecords as Mc, HostedDeviceOfferRequest as Mi, RunOutcomeKind as Mn, archiveLock as Mo, hostedIosRecords as Mr, compileGrep as Ms, APP_PROCESS_STATES as Mt, CAPACITY_REFUSAL_LIMIT as N, rememberHostedAppBlobRename as Na, ProjectRecord as Nc, HostedDevicePhase as Ni, STATUS_ISSUE_CODES as Nn, archiveRoot as No, hostedIosStatus as Nr, fileSizes as Ns, ActiveBuildState as Nt, hostedMetroGateways as O, hostedAppBlobs as Oa, ConcurrencyLimits as Oc, HostedAndroidChoice as Oi, PhysicalDeviceConnection as On, recordingDeviceName as Oo, readMaintenanceState as Or, advanceTail as Os, withDerivedFacts as Ot, CAPACITY_REFUSAL_MAX_AGE_MS as P, validHostedAppArguments as Pa, RepoRecord as Pc, HostedDevicePlatform as Pi, SimulatorState as Pn, buildMachinesFile as Po, parseHostedIosPlacement as Pr, followLogs as Ps, ActivityDriver as Pt, offloadSummary as Q, SettingScope as Qa, readAgentDeviceUsage as Qc, parseHostedOfferRequest as Qi, MacosAppRecord as Qn, maintenanceChildLogFile as Qo, DEV_SERVER_STOP_REQUEST_KEY as Qr, validEasSessionClaim as Qs, BuildPhase as Qt, ReadStatsResult as R, settingsJsonSchema as Ra, BuildMachineCredential as Rc, HostedIosChoice as Ri, StatusIssueCode as Rn, createdDevicesLock as Ro, hostedAndroidDeviceName as Rr, queryJsonLogs as Rs, AndroidDeviceState as Rt, parseMachine as S, HostedAppDelivery as Sa, loadConfig as Sc, readWarmRecord as Si, MacosBuildPlanPayload as Sn, closedSegmentName as So, MaintenanceSize as Sr, workspaceRecordingsDir as Ss, readAgentSessionsCache as St, HOSTED_METRO_REQUESTS_KEY as T, HostedAppRecord as Ta, automaticMachineEnabled as Tc, workspaceLastUsed as Ti, NATIVE_BUILD_STEPS as Tn, listSegments as To, MemoryCulprit as Tr, ERROR_SOURCES as Ts, readDiskUsageFailure as Tt, StatsBucket as U, OFFLOAD_MODES as Ua, machineCapacity as Uc, deviceHostRoot as Ui, WORKSPACE_STAGE_KINDS as Un, diskUsageCacheDir as Uo, unreadableHostedAndroid as Ur, sortByTs as Us, BuildActivity as Ut, RunSample as V, ANDROID_PCH_CHOICES as Va, buildSlotPath as Vc, assertHostedDeviceLedger as Vi, WEB_PAGE_STATES as Vn, deviceHostMachinesLock as Vo, hostedAndroidStatus as Vr, readLogTimeline as Vs, BUILD_PHASES as Vt, StatsCapacityRefusal as W, OffloadMode as Wa, saturation as Wc, hostedConsolePort as Wi, WarmStep as Wn, diskUsageWalkClaims as Wo, HostedNativePlacement as Wr, tailRead as Ws, BuildCacheHit as Wt, decodeStats as X, SettingDefinition as Xa, AgentDeviceUsageRoots as Xc, parseHostedLocalDeviceCount as Xi, WorktreeGit as Xn, gitMergeCacheDir as Xo, DEVICE_IDLE_SHUTDOWN_KEY as Xr, readCreatedDevices as Xs, BuildMissChange as Xt, StatsScope as Y, SETTING_SCOPES as Ya, AgentDeviceUsage as Yc, parseHostedDevice as Yi, WorktreeFacts as Yn, getConfigPath as Yo, BUILD_HISTORY_LIMIT as Yr, EasSessionLedgerRead as Ys, BuildMissCategory as Yt, findProjectRoot as Z, SettingEntry as Za, agentDeviceUsageFile as Zc, parseHostedNativeOffer as Zi, WorktreePullRequest as Zn, maintenanceAttemptFile as Zo, DEVICE_RECLAIM_REASON as Zr, readEasSessionLedger as Zs, BuildMissReason as Zt, Endpoint as _, parseHostedAgentGrant as _a, getProject as _c, readDevServerStopRequest as _i, MACHINE_OWNER_KINDS as _n, RECORDING_PLATFORMS as _o, MaintenanceCheck as _r, workspaceEndedAgentsLock as _s, diskUsageCacheFile as _t, parseSetupJournal as a, HOSTED_MACOS_APP_SLOTS as aa, DebugLog as ac, MAINTENANCE_LOG_NAME as ai, SOURCES as al, ChecksState as an, acceptsShape as ao, readMacosRecord as ar, setupJournalFile as as, trimCapacityWaits as at, endpoint as b, parseHostedMacosPlacement as ba, getRepoSettings as bc, readIdleStop as bi, MachineOwnerKind as bn, RecordingPlatform as bo, MaintenancePressure as br, workspaceLogsDir as bs, listStatusCacheEntries as bt, HOSTED_LOGS_FIRST_BYTES as c, HostedAgentGrant as ca, debugLoggingEnabled as cc, WARM_KEY as ci, parseNdjsonText as cl, DeviceLeaseState as cn, isLayeredSetting as co, ArchivedWorkspace as cr, sharedGradle as cs, DeviceViewersRecord as ct, HostedLogsPage as d, HostedMacosChoice as da, buildWorkerRoot as dc, WorkspaceState as di, EndedAgentSession as dn, settingValueError as do, linkReplacedArchives as dr, supervisorLogFile as ds, stimBuildDigest as dt, parseHostedRequest as ea, readJsonFile as ec, DevServerStopRequest as ei, AgentActionReaderOptions as el, BuildPlanPayload as en, SettingsPayload as eo, MacosBuild as er, maintenanceNdjsonFile as es, readRunEstimates as et, hostedMacosLogsDir as f, HostedMacosDevice as fa, configCorruptRepair as fc, buildDiagnostics as fi, EnvironmentDisk as fn, RUN_ID_ENV as fo, readArchive as fr, supervisorPidFile as fs, AgentSessionsCache as ft, readLogsSince as g, parseHostedAgentAccess as ga, getParkedMax as gc, readDevServerStop as gi, LastBuildReport as gn, RECORDING_FOOTAGE_MS as go, MaintenanceActionKind as gr, workspaceEndedAgentsFile as gs, agentSessionOf as gt, readHostedNativeLogsCheckpoint as h, hostedMacosBundleId as ha, getConcurrencyLimits as hc, readBuildHistory as hi, GitChipPart as hn, RECORDING_CAP_BYTES as ho, MaintenanceAction as hr, workspaceDerivedData as hs, StatusCacheEntry as ht, isSetupJournalPrunable as i, HOSTED_AGENT_DRIVERS as ia, DEBUG_ENV as ic, LAST_BUILD_KEYS as ii, NdjsonRecord as il, BuildWaitingFor as in, WebViewport as io, readHostedMacosApp as ir, serverSetupDir as is, trimCapacityRefusals as it, readDeviceHostMachines as j, readHostedApp as ja, DoctorRunRecord as jc, HostedDeviceOffer as ji, RemoteDeviceState as jn, archiveDir as jo, hostedIosPlacements as jr, bundleMarkerPlatform as js, AGENT_TOOLS as jt, hostedMetroRequests as k, parseHostedAppManifest as ka, Config as kc, HostedAndroidDevice as ki, PhysicalDeviceState as kn, recordingEnabled as ko, HostedIosPlacement as kr, attachExpoErrorContext as ks, withGitChip as kt, HOSTED_LOGS_PAGE_BYTES as l, HostedAgentLease as la, ParkedMax as lc, WORKSPACE_AGENT_KEY as li, readNdjsonGenerations as ll, DevicePlacement as ln, isSensitiveReference as lo, archiveEnabled as lr, sharedPods as ls, ViewedDevice as lt, parseHostedLogsCursor as m, hostedMacosAppSlot as ma, findProjectByMetroPort as mc, parseMissReason as mi, GitChip as mn, validRunId as mo, readArchives as mr, workspaceBuildDetailFile as ms, PullRequestCacheEntry as mt, SetupJournal as n, readHostedDeviceLedger as na, readStateFile as nc, IDLE_STOP_KEY as ni, createAgentActionReader as nl, BuildReport as nn, TunnelMode as no, macosAppState as nr, maintenanceStateFile as ns, readStatsReport as nt, readSetupJournal as o, HostedAgentAccess as oa, createDebugLog as oc, MetroLastStop as oi, levelRank as ol, DeviceActivity as on, coerceSettingText as oo, ArchivedBytes as or, sharedCcache as os, trimSamples as ot, hostedNativeLogsDir as p, HostedMacosPlacement as pa, findEnclosingWorktreeRoot as pc, lastUseFrom as pi, EnvironmentState as pn, runId as po, readArchiveState as pr, workspaceAgentDeviceDir as ps, ENDED_AGENT_RETENTION_MS as pt, StatsRecord as q, SETTINGS as qa, readSwiftpmCacheUsage as qc, parseHostedAndroidDevice as qi, WorkspacePhase as qn, easSessionLedgerLock as qo, unreadableHostedNative as qr, CreatedDevices as qs, BuildDiagnostic as qt, isJournalExpired as r, readHostedSessions as ra, withStateReadCache as rc, IdleStopRecord as ri, LEVELS as rl, BuildResult as rn, WEB_VIEWPORTS as ro, parseMacosRecord as rr, pullRequestCacheDir as rs, statsProjectKey as rt, agentDeviceStateDirs as s, HostedAgentDriverName as sa, debugLogDir as sc, READY_PHASE_MS as si, parseNdjsonLine as sl, DeviceAppProcess as sn, expectedShape as so, ArchivedUsage as sr, sharedCompilationCache as ss, wholePhases as st, SetupCapability as t, readHostedDevice as ta, readJsonObject as tc, DeviceIdleShutdownRecord as ti, AgentTarget as tl, BuildPlatform as tn, TUNNEL_MODES as to, MacosProcess as tr, maintenanceRunClaims as ts, readStats as tt, HostedLogsCursor as u, HostedAppLaunch as ua, allMetroPorts as uc, WarmRecord as ui, DiskMeasure as un, settingDefinition as uo, archivedUsage as ur, statsFile as us, readViewedDevices as ut, TAILNET_MACHINE_PATTERN as v, parseHostedMacosChoice as va, getProjectSetting as vc, readDeviceIdleShutdowns as vi, MEMORY_SOURCES as vn, RecordedDevice as vo, MaintenanceMode as vr, workspaceGradleBuild as vs, diskUsageFailureFile as vt, HOSTED_METRO_GATEWAYS_KEY as w, HostedAppOffer as wa, AutomaticPoolRole as wc, readWorkspaceState as wi, MetroBundleState as wn, listRecordedDevices as wo, MaintenanceStatus as wr, workspaceStateLock as ws, readDiskUsage as wt, findPeer as x, HOSTED_APP_CHUNK_BYTES as xa, isPathPrefix as xc, readLastBuilds as xi, MachineUsageState as xn, capDrops as xo, MaintenanceRecord as xr, workspaceMetadataFile as xs, pullRequestCacheFile as xt, TailnetPeer as y, parseHostedMacosDevice as ya, getProjectSettings as yc, readDevicePlacement as yi, MachineOwner as yn, RecordedSegment as yo, MaintenancePass as yr, workspaceLogErrorIndex as ys, endedAgentSessionOf as yt, RunEstimates as z, ANDROID_COMPILER_CACHE_CHOICES as za, readBuildMachines as zc, HostedIosDevice as zi, StatusPayload as zn, deviceHostMachinesClaims as zo, hostedAndroidPlacements as zr, queryLogs as zs, AndroidRuntimeFacts as zt };
+//#region state/status-views.d.ts
+/** How many of the newest archives the workspace list names. */
+declare const SUMMARY_ARCHIVES = 10;
+/** A build as a workspace summary carries it: everything but its fingerprint, miss reason and later diagnostics. */
+type SummaryBuild = Omit<LastBuildReport, "fingerprint" | "missReason">;
+type SummaryHistoryEntry = SummaryBuild & Pick<BuildHistoryEntry, "result" | "slot" | "phases">;
+type SummaryPlatforms<K extends "lastBuilds" | "builds", V> = Partial<Record<keyof NonNullable<EnvironmentState[K]>, V>>;
+/**
+ * A workspace as the list of every workspace shows it: the environment `stim status --json` prints, without what only a
+ * shown workspace reads. A build drops its fingerprint, miss reason and every diagnostic but the first one with a file
+ * and a line. Each platform's history keeps its newest build and, while that one failed, every failure right before
+ * it, which is what a failure streak counts. `logs` keeps only its error count, a pull request drops its review
+ * decision and lookup time, a macOS app its launch arguments, and `agentDevice` stays only on a tutorial workspace.
+ */
+type WorkspaceSummary = Omit<EnvironmentState, "logs" | "builds" | "lastBuilds" | "macos" | "agentDevice" | "worktree"> & {
+  logs?: {
+    errorsSinceMarker: number;
+  } | null;
+  lastBuilds?: SummaryPlatforms<"lastBuilds", SummaryBuild>;
+  builds?: SummaryPlatforms<"builds", SummaryHistoryEntry[]>;
+  macos?: Omit<NonNullable<EnvironmentState["macos"]>, "arguments"> | null;
+  agentDevice?: EnvironmentState["agentDevice"];
+  worktree?: (Omit<WorktreeFacts, "pullRequest"> & {
+    pullRequest?: Omit<NonNullable<WorktreeFacts["pullRequest"]>, "reviewDecision" | "checkedAt"> | null;
+  }) | null;
+  labelOnly?: true;
+};
+/** An unprovisioned worktree as the workspace list shows it. */
+type WorktreeRow = Pick<WorktreeFacts, "path" | "branch" | "repository" | "git" | "gitChip"> & {
+  pullRequest?: Omit<NonNullable<WorktreeFacts["pullRequest"]>, "reviewDecision" | "checkedAt"> | null;
+};
+/** The archives, counted, with the newest named; the rest are read a page at a time. */
+interface ArchivedSummary {
+  count: number;
+  bytes: number;
+  newest: Pick<ArchivedWorkspace, "id" | "projectRoot" | "project" | "workspace" | "removedAt">[];
+}
+/** The machine, as the always-visible capacity, memory and maintenance indicators show it. */
+interface MachineView {
+  capacity: StatusPayload["capacity"];
+  machine: StatusPayload["machine"];
+  deviceLeases: StatusPayload["deviceLeases"];
+  simctlAvailable: boolean;
+  maintenance: Omit<MaintenanceStatus, "recent" | "sizes"> | null;
+}
+interface StatusViews {
+  workspaces: WorkspaceSummary[];
+  worktrees: WorktreeRow[];
+  archived: ArchivedSummary;
+  machine: MachineView;
+  /** The full environment of each workspace by path, as `stim status --json` prints it. */
+  details: Map<string, StatusPayload["environments"][number]>;
+}
+/** The summary of one environment of a status payload. */
+declare function workspaceSummary(environment: StatusPayload["environments"][number]): WorkspaceSummary;
+/** The live views of a status payload as `stim status --json` prints it. */
+declare function statusViews(payload: StatusPayload): StatusViews;
+//#endregion
+//#region state/keyed-delta.d.ts
+/** The entities that changed since the last emit: whole entities to insert or replace, and keys to drop. */
+interface KeyedDelta<T> {
+  upsert: T[];
+  remove: string[];
+}
+/**
+ * Tracks the JSON of the entities last sent on one subscription, so the next emit carries only what changed. An
+ * entity counts as changed when its JSON differs, so the order of its fields matters and producers build entities
+ * with a stable field order.
+ */
+declare class KeyedEntities<T> {
+  private sent;
+  private readonly key;
+  constructor(key: (entity: T) => string);
+  /** Records `entities` as sent in full, for a snapshot. */
+  reset(entities: readonly T[]): void;
+  /** The delta from what was last sent to `entities`, recorded as sent; null when nothing changed. */
+  next(entities: readonly T[]): KeyedDelta<T> | null;
+}
+/** 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 { ReadStatsResult as $, validHostedAppArguments as $a, withConfigLock as $c, HostedDeviceSelectors as $i, StatusIssueCode as $n, archiveRoot as $o, HostedAndroidStatus as $r, NATIVE_CRASH_LOG_PREFIX as $s, AndroidDeviceState as $t, readLogsSince as A, HostedMacosDevice as Aa, readJsonObject as Ac, parseMissReason as Ai, readMachineCacheUsage as Al, GitChipPart as An, settingDefinition as Ao, DiskPressureLevel as Ar, sharedGradle as As, StatusCacheEntry as At, HOSTED_METRO_REQUESTS_KEY as B, HOSTED_APP_CHUNK_BYTES as Ba, allMetroPorts as Bc, readWorkspaceState as Bi, AgentRecordSelection as Bl, NATIVE_BUILD_STEPS as Bn, RecordingPlatform as Bo, MaintenanceStatus as Br, workspaceGradleBuild as Bs, readDiskUsageFailure as Bt, HOSTED_LOGS_PAGE_BYTES as C, HostedAgentAccess as Ca, EasSessionClaim as Cc, READY_PHASE_MS as Ci, buildSlotsDir as Cl, DeviceLeaseState as Cn, WEB_VIEWPORTS as Co, ArchivedWorkspace as Cr, maintenanceStateFile as Cs, DeviceViewersRecord as Ct, hostedNativeLogsDir as D, HostedAgentLease as Da, validEasSessionClaim as Dc, WorkspaceState as Di, MachineCacheUsage as Dl, EnvironmentDisk as Dn, expectedShape as Do, readArchive as Dr, setupJournalFile as Ds, AgentSessionsCache as Dt, hostedMacosLogsDir as E, HostedAgentIssuedGrant as Ea, readEasSessionLedger as Ec, WarmRecord as Ei, tryAcquireBuildSlotClaim as El, EndedAgentSession as En, coerceSettingText as Eo, linkReplacedArchives as Er, serverSetupDir as Es, stimBuildDigest as Et, endpoint as F, parseHostedAgentAccess as Fa, DebugLog as Fc, readDevicePlacement as Fi, AgentDeviceUsageRoots as Fl, MachineOwnerKind as Fn, RECORDING_CAP_BYTES as Fo, MaintenancePass as Fr, workspaceAgentDeviceDir as Fs, listStatusCacheEntries as Ft, DeviceHostMachineCredential as G, hostedAppArea as Ga, getParkedMax as Gc, HostedAndroidChoice as Gi, NdjsonRecord as Gl, PlannedPhase as Gn, listSegments as Go, HostedIosPlacement as Gr, workspaceStateFile as Gs, ACTIVITY_RECENCY_BASES as Gt, HostedMetroRequest as H, HostedAppFile as Ha, configCorruptRepair as Hc, DEVICE_HOST_LIMITS as Hi, createAgentActionReader as Hl, PHYSICAL_DEVICE_CONNECTIONS as Hn, closedSegmentName as Ho, parseMaintenanceState as Hr, workspaceLogsDir as Hs, readPullRequestCache as Ht, findPeer as I, parseHostedAgentGrant as Ia, createDebugLog as Ic, readIdleStop as Ii, agentDeviceUsageFile as Il, MachineUsageState as In, RECORDING_FOOTAGE_MS as Io, MaintenancePressure as Ir, workspaceBuildDetailFile as Is, pullRequestCacheFile as It, CAPACITY_REFUSAL_LIMIT as J, parseHostedAppManifest as Ja, getRepoSettings as Jc, HostedDeviceOffer as Ji, parseNdjsonLine as Jl, STATUS_ISSUE_CODES as Jn, recordingDeviceName as Jo, hostedIosRecords as Jr, LogDirQuery as Js, ActiveBuildState as Jt, readDeviceHostMachines as K, hostedAppAttempt as Ka, getProject as Kc, HostedAndroidDevice as Ki, SOURCES as Kl, RemoteDeviceState as Kn, openSegmentName as Ko, HostedIosStatus as Kr, workspaceStateLock as Ks, AGENT_TOOLS as Kt, machineEndpoint as L, parseHostedMacosChoice as La, debugLogDir as Lc, readLastBuilds as Li, readAgentDeviceUsage as Ll, MacosBuildPlanPayload as Ln, RECORDING_PLATFORMS as Lo, MaintenanceRecord as Lr, workspaceDerivedData as Ls, readAgentSessionsCache as Lt, TAILNET_MACHINE_PATTERN as M, hostedAgentDriverName as Ma, withStateReadCache as Mc, readDevServerStop as Mi, readSwiftpmCacheUsage as Ml, MACHINE_OWNER_KINDS as Mn, RUN_ID_ENV as Mo, MaintenanceActionKind as Mr, statsFile as Ms, diskUsageCacheFile as Mt, TailnetPeer as N, hostedMacosAppSlot as Na, readHomeIdentity as Nc, readDevServerStopRequest as Ni, swiftpmCacheUsageFile as Nl, MEMORY_SOURCES as Nn, runId as No, MaintenanceCheck as Nr, supervisorLogFile as Ns, diskUsageFailureFile as Nt, parseHostedLogsCursor as O, HostedAppLaunch as Oa, isJsonObject as Oc, buildDiagnostics as Oi, SimRuntimeUsage as Ol, EnvironmentState as On, isLayeredSetting as Oo, readArchiveState as Or, sharedCcache as Os, ENDED_AGENT_RETENTION_MS as Ot, cannotHost as P, hostedMacosBundleId as Pa, DEBUG_ENV as Pc, readDeviceIdleShutdowns as Pi, AgentDeviceUsage as Pl, MachineOwner as Pn, validRunId as Po, MaintenanceMode as Pr, supervisorPidFile as Ps, endedAgentSessionOf as Pt, PLACEMENT_DECISIONS as Q, rememberHostedAppBlobRename as Qa, windowsShortDirKey as Qc, HostedDeviceRequest as Qi, StatusIssue as Qn, archiveLock as Qo, HostedAndroidPlacement as Qr, LogQueryPlan as Qs, AgentTool as Qt, parseMachine as R, parseHostedMacosDevice as Ra, debugLoggingEnabled as Rc, readWarmRecord as Ri, readAgentDeviceUsageCache as Rl, MemorySource as Rn, RecordedDevice as Ro, MaintenanceSize as Rr, workspaceEndedAgentsFile as Rs, readBuildDetail as Rt, HOSTED_LOGS_FIRST_BYTES as S, HOSTED_MACOS_APP_SLOTS as Sa, CreatedDevices as Sc, MetroLastStop as Si, buildSlotPath as Sl, DeviceAppProcess as Sn, TunnelMode as So, ArchivedUsage as Sr, maintenanceRunClaims as Ss, wholePhases as St, HostedLogsPage as T, HostedAgentGrant as Ta, readCreatedDevices as Tc, WORKSPACE_AGENT_KEY as Ti, saturation as Tl, DiskMeasure as Tn, acceptsShape as To, archivedUsage as Tr, serverLocalSocket as Ts, readViewedDevices as Tt, hostedMetroGateways as U, HostedAppOffer as Ua, findEnclosingWorktreeRoot as Uc, DeviceHostLimits as Ui, createAsyncAgentActionReader as Ul, PhysicalDeviceConnection as Un, footageDrops as Uo, readMaintenanceAttempt as Ur, workspaceMetadataFile as Us, withDerivedFacts as Ut, HostedMetroGateway as V, HostedAppDelivery as Va, buildWorkerRoot as Vc, workspaceLastUsed as Vi, AgentTarget as Vl, NativeBuildStep as Vn, capDrops as Vo, MemoryCulprit as Vr, workspaceLogErrorIndex as Vs, readEndedAgentSessions as Vt, hostedMetroRequests as W, HostedAppRecord as Wa, getConcurrencyLimits as Wc, HOSTED_PARKED_CANDIDATES as Wi, LEVELS as Wl, PhysicalDeviceState as Wn, listRecordedDevices as Wo, readMaintenanceState as Wr, workspaceRecordingsDir as Ws, withGitChip as Wt, HISTORY_LIMIT as X, readHostedApp as Xa, loadConfig as Xc, HostedDevicePhase as Xi, readNdjsonGenerations as Xl, StatsPlatform as Xn, agentSessionsCacheFile as Xo, parseHostedIosPlacement as Xr, ERROR_SOURCES as Xs, ActivityRecencyBasis as Xt, CAPACITY_REFUSAL_MAX_AGE_MS as Y, parseHostedAppOffer as Ya, isPathPrefix as Yc, HostedDeviceOfferRequest as Yi, parseNdjsonText as Yl, SimulatorState as Yn, recordingEnabled as Yo, hostedIosStatus as Yr, openLogDir as Ys, ActivityDriver as Yt, OffloadSummary as Z, readHostedAppMetadata as Za, windowsShortDir as Zc, HostedDevicePlatform as Zi, StatusCapacity as Zn, archiveDir as Zo, unreadableHostedIos as Zr, LogQueryOptions as Zs, AgentSession as Zt, isSetupJournalPrunable as _, parseHostedRequest as _a, recordMatches as _c, DeviceIdleShutdownRecord as _i, MACHINE_CREDENTIALS_VERSION as _l, BuildReport as _n, SettingScope as _o, macosAppState as _r, gitMergeCacheDir as _s, readStatsReport as _t, MachineView as a, deviceHostArea as aa, compileGrep as ac, unreadableHostedAndroid as ai, ConcurrencyLimits as al, BuildCacheHit as an, ANDROID_EMULATOR_APPS as ao, WarmStep as ar, createdDevicesLock as as, StatsCapacityRefusal as at, agentDeviceStateDirs as b, readHostedSessions as ba, countErrorEntries as bc, LAST_BUILD_KEYS as bi, readBuildMachines as bl, ChecksState as bn, SettingsPayload as bo, readMacosRecord as br, maintenanceDir as bs, trimCapacityWaits as bt, SummaryBuild as c, hostedDeviceId as ca, isExpoErrorContext as cc, parseHostedNativePlacement as ci, DoctorRunRecord as cl, BuildDiagnostic as cn, OFFLOAD_MODES as co, WorkspacePhase as cr, deviceHostMachinesLock as cs, StatsRecord as ct, WorktreeRow as d, parseHostedChoice as da, parseSince as dc, BUILD_HISTORY_LIMIT as di, RepoRecord as dl, BuildMissChange as dn, RemoteDeviceBackend as do, WorktreeGit as dr, diskUsageWalkClaims as ds, decodeStats as dt, HostedDeviceSession as ea, QueryCriteria as ec, hostedAndroidDeviceName as ei, withConfigLockAsync as el, AndroidRuntimeFacts as en, validHostedAppBlob as eo, StatusPayload as er, buildMachinesFile as es, RunEstimates as et, statusViews as f, parseHostedDevice as fa, planLogQuery as fc, DEVICE_IDLE_SHUTDOWN_KEY as fi, SettingsObject as fl, BuildMissReason as fn, SETTINGS as fo, WorktreePullRequest as fr, easMachineStateRoot as fs, findProjectRoot as ft, isJournalExpired as g, parseHostedPlatformDevice as ga, readLogTimeline as gc, DevServerStopRequest as gi, BuildMachineCredential as gl, BuildPlatform as gn, SettingEntry as go, MacosProcess as gr, getConfigPath as gs, readStats as gt, SetupJournal as h, parseHostedOfferRequest as ha, readLogRecords as hc, DevServerStopRecord as hi, clientIdentity as hl, BuildPlanPayload as hn, SettingDefinition as ho, MacosBuild as hr, emulatorLogFile as hs, readRunEstimates as ht, ArchivedSummary as i, assertHostedDeviceLedger as ia, bundleMarkerPlatform as ic, parseHostedAndroidPlacement as ii, validateAutomaticPool as il, BuildActivity as in, ANDROID_COMPILER_CACHE_CHOICES as io, WORKSPACE_STAGE_KINDS as ir, createdDevicesFile as is, StatsBucket as it, Endpoint as j, HostedMacosPlacement as ja, readStateFile as jc, readBuildHistory as ji, SwiftpmCacheUsage as jl, LastBuildReport as jn, settingValueError as jo, MaintenanceAction as jr, sharedPods as js, agentSessionOf as jt, readHostedNativeLogsCheckpoint as k, HostedMacosChoice as ka, readJsonFile as kc, lastUseFrom as ki, machineCacheUsageFile as kl, GitChip as kn, isSensitiveReference as ko, readArchives as kr, sharedCompilationCache as ks, PullRequestCacheEntry as kt, SummaryHistoryEntry as l, hostedWorkerSettleMs as la, logFiles as lc, unreadableHostedNative as li, PlatformRecords as ll, BuildHistoryEntry as ln, OffloadMode as lo, WorkspaceStage as lr, deviceViewersDir as ls, StatsReport as lt, SetupCapability as m, parseHostedNativeOffer as ma, queryLogs as mc, DEV_SERVER_STOP_REQUEST_KEY as mi, SupervisorRecord as ml, BuildPlacement as mn, SETTING_SCOPES as mo, MacosAppState as mr, easSessionLedgerLock as ms, projectRootDirectories as mt, KeyedEntities as n, HostedIosDevice as na, attachExpoErrorContext as nc, hostedAndroidRecords as ni, automaticMachineEnabled as nl, BUILD_PHASES as nn, SETTINGS_SCHEMA_URL as no, WEB_PAGE_STATES as nr, clientIdentityKeyFile as ns, RunSample as nt, SUMMARY_ARCHIVES as o, deviceHostRoot as oa, fileSizes as oc, HostedNativePlacement as oi, Config as ol, BuildCause as on, ANDROID_PCH_CHOICES as oo, WebBrowserState as or, deviceHostMachinesClaims as os, StatsCapacityWait as ot, workspaceSummary as p, parseHostedLocalDeviceCount as pa, queryJsonLogs as pc, DEVICE_RECLAIM_REASON as pi, StimConfig as pl, BuildPhase as pn, SETTING_GROUPS as po, MacosAppRecord as pr, easSessionLedgerFile as ps, offloadSummary as pt, BuildMachineTotals as q, hostedAppBlobs as qa, getProjectSettings as qc, HostedDevice as qi, levelRank as ql, RunOutcomeKind as qn, recordedBytes as qo, hostedIosPlacements as qr, LogDir as qs, APP_PROCESS_STATES as qt, applyKeyedDelta as r, HostedNativeOffer as ra, buildCriteria as rc, hostedAndroidStatus as ri, requireAutomaticMachine as rl, BUILD_RESULTS as rn, settingsJsonSchema as ro, WORKSPACE_PHASES as rr, configLockPath as rs, STATS_VERSION as rt, StatusViews as s, hostedConsolePort as sa, followLogs as sc, hostedNativeRecords as si, DeviceRecord as sl, BuildDetail as sn, IOS_SIMULATOR_APPS as so, WebPageState as sr, deviceHostMachinesFile as ss, StatsPlacement as st, KeyedDelta as t, HostedIosChoice as ta, advanceTail as tc, hostedAndroidPlacements as ti, AutomaticPoolRole as tl, AppPresence as tn, SETTINGS_SCHEMA_FILE as to, TUTORIAL_VERSION as tr, buildMachinesLock as ts, RunHistory as tt, WorkspaceSummary as u, parseHostedAndroidDevice as ua, markerWindow as uc, BUILD_HISTORY_KEY as ui, ProjectRecord as ul, BuildMissCategory as un, REMOTE_DEVICE_BACKENDS as uo, WorktreeFacts as ur, diskUsageCacheDir as us, StatsScope as ut, parseSetupJournal as v, readHostedDevice as va, sortByTs as vc, IDLE_STOP_KEY as vi, MachineCredential as vl, BuildResult as vn, SettingType as vo, parseMacosRecord as vr, maintenanceAttemptFile as vs, statsProjectKey as vt, HostedLogsCursor as w, HostedAgentDriverName as wa, EasSessionLedgerRead as wc, WARM_KEY as wi, machineCapacity as wl, DevicePlacement as wn, WebViewport as wo, archiveEnabled as wr, pullRequestCacheDir as ws, ViewedDevice as wt, agentDeviceStateDirsAsync as x, HOSTED_AGENT_DRIVERS as xa, CreatedDevicePlatform as xc, MAINTENANCE_LOG_NAME as xi, MachineCapacity as xl, DeviceActivity as xn, TUNNEL_MODES as xo, ArchivedBytes as xr, maintenanceNdjsonFile as xs, trimSamples as xt, readSetupJournal as y, readHostedDeviceLedger as ya, tailRead as yc, IdleStopRecord as yi, parseMachineCredential as yl, BuildWaitingFor as yn, SettingWriteResult as yo, readHostedMacosApp as yr, maintenanceChildLogFile as ys, trimCapacityRefusals as yt, HOSTED_METRO_GATEWAYS_KEY as z, parseHostedMacosPlacement as za, ParkedMax as zc, readWorkspaceAgent as zi, AgentActionReaderOptions as zl, MetroBundleState as zn, RecordedSegment as zo, MaintenanceState as zr, workspaceEndedAgentsLock as zs, readDiskUsage as zt };