@stim-cli/server 1.20.2 → 1.22.0

package/dist/{protocol-CjUChTWJ.mjs → protocol-ZY9j2h32.mjs}

@@ -1,5 +1,6 @@
 import "node:module";
-import { ACTIONS, BUILD_REPO_PATTERN, BUILD_RUBY_VERSION_PATTERN, CAPABILITIES, CONTROL_END_REASONS, DEVICE_POSTURES, ERROR_CODES, FEATURES, FRAME_EDGE, FRAME_FPS, INPUT_BUTTONS, INPUT_KEYS, KEY_MODIFIERS, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, MAX_INPUT_TEXT, MAX_LOG_TAIL, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, PLATFORMS, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, TOUCH_PHASES, VIDEO_CODECS } from "@stim-cli/core/protocol";
+import { ACTIONS, ARCHIVED_PAGE_LIMIT, BUILD_REPO_PATTERN, BUILD_RUBY_VERSION_PATTERN, CAPABILITIES, CONTROL_END_REASONS, DEVICE_POSTURES, ERROR_CODES, FEATURES, FRAME_EDGE, FRAME_FPS, INPUT_BUTTONS, INPUT_KEYS, KEY_MODIFIERS, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, MAX_INPUT_TEXT, MAX_LOG_TAIL, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, PLATFORMS, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, TOUCH_PHASES, VIDEO_CODECS } from "@stim-cli/core/protocol";
+import { SETTING_SCOPES } from "@stim-cli/core/state";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -31,6 +32,116 @@ var protocol_exports = /* @__PURE__ */ __exportAll({ protocolJsonSchema: () => p
 import * as import__stim_cli_core_protocol from "@stim-cli/core/protocol";
 __reExport(protocol_exports, import__stim_cli_core_protocol);
 const requestId = { type: ["integer", "string"] };
+const runText = {
+	type: "string",
+	minLength: 1,
+	maxLength: 1024,
+	pattern: "^[^\\u0000]+$"
+};
+const runSelector = { oneOf: [runText, { type: "boolean" }] };
+const nativeRunProperties = {
+	slot: runText,
+	remote: runText,
+	remoteBuild: runText,
+	easProfile: runText,
+	device: runSelector,
+	wait: runSelector,
+	metroCheck: { type: "boolean" },
+	buildCache: { type: "boolean" }
+};
+const platformRunOptions = { oneOf: [
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "ios" },
+			...nativeRunProperties,
+			configuration: runText,
+			scheme: runText,
+			deviceType: runText,
+			runtime: runText,
+			simulatorApp: runText
+		}
+	},
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "android" },
+			...nativeRunProperties,
+			variant: runText,
+			systemImage: runText,
+			deviceProfile: runText
+		}
+	},
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "macos" },
+			remote: runText,
+			remoteBuild: runText
+		}
+	},
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "web" },
+			headed: { type: "boolean" }
+		}
+	}
+] };
+const platformBuildOptions = { oneOf: [
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "ios" },
+			configuration: runText,
+			scheme: runText,
+			arch: { enum: [
+				"arm64",
+				"x86_64",
+				"all"
+			] },
+			buildCache: { type: "boolean" },
+			remoteBuild: runText
+		}
+	},
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "android" },
+			variant: runText,
+			abi: { enum: [
+				"arm64-v8a",
+				"armeabi-v7a",
+				"x86",
+				"x86_64",
+				"all"
+			] },
+			buildCache: { type: "boolean" },
+			remoteBuild: runText
+		}
+	},
+	{
+		type: "object",
+		required: ["platform"],
+		additionalProperties: false,
+		properties: {
+			platform: { const: "macos" },
+			remoteBuild: runText
+		}
+	}
+] };
 const protocolError = {
 	type: "object",
 	required: ["code", "message"],
@@ -40,14 +151,355 @@ const protocolError = {
 		message: { type: "string" }
 	}
 };
+const sha256 = {
+	type: "string",
+	pattern: "^[0-9a-f]{64}$"
+};
 const buildRepo = {
 	type: "string",
 	pattern: BUILD_REPO_PATTERN
 };
-const sha256 = {
-	type: "string",
-	pattern: "^[0-9a-f]{64}$"
+const buildArtifactIdentity = {
+	type: "object",
+	required: ["fingerprint", "cacheKey"],
+	additionalProperties: false,
+	properties: {
+		fingerprint: {
+			type: "string",
+			minLength: 1,
+			maxLength: 256
+		},
+		cacheKey: {
+			type: "string",
+			minLength: 1,
+			maxLength: 1024
+		}
+	}
+};
+const gradleArtifactQuery = {
+	type: "object",
+	required: [
+		"project",
+		"sourceDigest",
+		"inputs",
+		"android"
+	],
+	additionalProperties: false,
+	properties: {
+		project: { type: "string" },
+		sourceDigest: sha256,
+		inputs: {
+			type: "object",
+			required: [
+				"complete",
+				"ignored",
+				"outputs"
+			],
+			additionalProperties: false,
+			properties: {
+				complete: { const: true },
+				ignored: {
+					type: "array",
+					items: {
+						type: "string",
+						minLength: 1
+					}
+				},
+				outputs: {
+					type: "array",
+					items: {
+						type: "string",
+						minLength: 1
+					}
+				}
+			}
+		},
+		android: {
+			type: "object",
+			required: [
+				"variant",
+				"abi",
+				"gradleBuildCache",
+				"pch",
+				"compilerCache"
+			],
+			additionalProperties: false,
+			properties: {
+				variant: {
+					type: "string",
+					minLength: 1
+				},
+				abi: { type: ["string", "null"] },
+				gradleBuildCache: { type: "boolean" },
+				pch: { enum: [
+					"auto",
+					"on",
+					"off"
+				] },
+				compilerCache: { enum: ["ccache", "none"] },
+				gradleRoot: { type: ["string", "null"] },
+				module: { type: ["string", "null"] }
+			}
+		}
+	}
+};
+const swiftpmArtifactInputs = {
+	type: "object",
+	required: [
+		"complete",
+		"ignored",
+		"outputs",
+		"localFiles",
+		"environment"
+	],
+	additionalProperties: false,
+	properties: {
+		complete: { const: true },
+		ignored: {
+			type: "array",
+			maxItems: 1e3,
+			items: {
+				type: "string",
+				minLength: 1
+			}
+		},
+		outputs: {
+			type: "array",
+			maxItems: 1e3,
+			items: {
+				type: "string",
+				minLength: 1
+			}
+		},
+		localFiles: {
+			type: "array",
+			maxItems: 1e3,
+			items: {
+				type: "string",
+				minLength: 1,
+				maxLength: 4096
+			}
+		},
+		environment: {
+			type: "array",
+			maxItems: 1e3,
+			items: {
+				type: "string",
+				pattern: "^[A-Za-z_][A-Za-z0-9_]*$"
+			}
+		}
+	}
+};
+const swiftpmArtifactQuery = {
+	type: "object",
+	required: [
+		"project",
+		"sourceDigest",
+		"stimBuild",
+		"inputs",
+		"build"
+	],
+	additionalProperties: false,
+	properties: {
+		project: { type: "string" },
+		sourceDigest: sha256,
+		stimBuild: {
+			type: "string",
+			minLength: 1,
+			maxLength: 256
+		},
+		inputs: swiftpmArtifactInputs,
+		build: {
+			type: "object",
+			required: [
+				"product",
+				"infoPlist",
+				"resources",
+				"assetCatalog"
+			],
+			additionalProperties: false,
+			properties: {
+				product: {
+					type: "string",
+					pattern: "^[A-Za-z0-9_.-]{1,100}$"
+				},
+				infoPlist: {
+					type: "string",
+					minLength: 1
+				},
+				resources: {
+					type: "object",
+					maxProperties: 256,
+					additionalProperties: { type: "string" }
+				},
+				assetCatalog: {
+					type: ["string", "null"],
+					minLength: 1
+				}
+			}
+		}
+	}
+};
+const reactNativeArtifactQuery = {
+	type: "object",
+	required: [
+		"project",
+		"fingerprint",
+		"isExpo",
+		"platform",
+		"toolchain"
+	],
+	additionalProperties: false,
+	oneOf: [{
+		properties: {
+			platform: { const: "ios" },
+			toolchain: { required: [
+				"arch",
+				"xcode",
+				"simulatorSdk",
+				"cocoapods"
+			] }
+		},
+		required: ["ios"]
+	}, {
+		properties: {
+			platform: { const: "android" },
+			toolchain: { required: ["jdk"] }
+		},
+		required: ["android"]
+	}],
+	properties: {
+		project: { type: "string" },
+		fingerprint: {
+			type: "string",
+			minLength: 1,
+			maxLength: 256
+		},
+		isExpo: { type: "boolean" },
+		platform: { enum: ["ios", "android"] },
+		toolchain: {
+			type: "object",
+			required: ["stimBuild"],
+			additionalProperties: false,
+			properties: {
+				stimBuild: {
+					type: "string",
+					minLength: 1
+				},
+				arch: {
+					type: "string",
+					minLength: 1
+				},
+				xcode: {
+					type: "string",
+					minLength: 1
+				},
+				simulatorSdk: {
+					type: "string",
+					minLength: 1
+				},
+				cocoapods: {
+					type: "string",
+					minLength: 1
+				},
+				jdk: {
+					type: "string",
+					minLength: 1
+				}
+			}
+		},
+		ios: {
+			type: "object",
+			required: [
+				"runtime",
+				"configuration",
+				"scheme",
+				"projectPath",
+				"optimizations"
+			],
+			additionalProperties: false,
+			properties: {
+				runtime: {
+					type: "string",
+					minLength: 1
+				},
+				configuration: {
+					type: "string",
+					minLength: 1
+				},
+				scheme: { type: ["string", "null"] },
+				projectPath: {
+					type: "string",
+					minLength: 1
+				},
+				optimizations: {
+					type: "object",
+					required: [
+						"compilationCache",
+						"swiftCompilationCache",
+						"prefixMapping"
+					],
+					additionalProperties: false,
+					properties: {
+						compilationCache: { type: "boolean" },
+						swiftCompilationCache: { type: ["boolean", "null"] },
+						prefixMapping: { type: "boolean" }
+					}
+				}
+			}
+		},
+		android: {
+			type: "object",
+			required: [
+				"variant",
+				"abi",
+				"gradleBuildCache",
+				"pch",
+				"compilerCache"
+			],
+			additionalProperties: false,
+			properties: {
+				variant: { type: ["string", "null"] },
+				abi: { type: ["string", "null"] },
+				gradleBuildCache: { type: "boolean" },
+				pch: { enum: [
+					"auto",
+					"on",
+					"off"
+				] },
+				compilerCache: { enum: ["ccache", "none"] },
+				gradleRoot: { type: ["string", "null"] },
+				module: { type: ["string", "null"] }
+			}
+		}
+	}
+};
+const workspaceRef = {
+	type: "object",
+	required: ["workspace"],
+	additionalProperties: false,
+	properties: { workspace: {
+		type: "string",
+		minLength: 1
+	} }
 };
+const keyedDelta = (description) => ({
+	type: "object",
+	required: ["upsert", "remove"],
+	additionalProperties: false,
+	properties: {
+		upsert: {
+			type: "array",
+			items: { type: "object" },
+			description
+		},
+		remove: {
+			type: "array",
+			items: { type: "string" },
+			description: "The paths that are gone."
+		}
+	}
+});
 const buildJob = {
 	type: "object",
 	required: ["job"],
@@ -776,14 +1228,10 @@ function protocolJsonSchema() {
 			},
 			HelloParams: {
 				type: "object",
-				required: [
-					"protocol",
-					"client",
-					"auth"
-				],
+				description: "The first request, sent encrypted after the Noise handshake on a network connection, or in the clear on the local Unix socket.",
+				required: ["client"],
 				additionalProperties: false,
 				properties: {
-					protocol: { type: "integer" },
 					client: {
 						type: "object",
 						required: ["name", "version"],
@@ -796,44 +1244,8 @@ function protocolJsonSchema() {
 							}
 						}
 					},
-					auth: { oneOf: [
-						{
-							type: "object",
-							required: ["pairingToken", "deviceName"],
-							additionalProperties: false,
-							properties: {
-								pairingToken: { type: "string" },
-								deviceName: {
-									type: "string",
-									minLength: 1
-								}
-							}
-						},
-						{
-							type: "object",
-							required: ["deviceToken"],
-							additionalProperties: false,
-							properties: { deviceToken: { type: "string" } }
-						},
-						{
-							type: "object",
-							required: ["request", "deviceName"],
-							additionalProperties: false,
-							properties: {
-								request: { enum: ["build", "device-host"] },
-								deviceName: {
-									type: "string",
-									minLength: 1
-								},
-								setupTicket: {
-									type: "string",
-									minLength: 43,
-									maxLength: 43,
-									pattern: "^[A-Za-z0-9_-]{43}$"
-								}
-							}
-						}
-					] }
+					access: { enum: ["build", "device-host"] },
+					desktopBootstrap: { const: true }
 				}
 			},
 			HelloResult: {
@@ -875,7 +1287,9 @@ function protocolJsonSchema() {
 							name: { type: "string" },
 							version: { type: "string" },
 							stim: { type: "string" },
-							home: { type: "string" }
+							home: { type: "string" },
+							id: { type: "string" },
+							port: { type: "integer" }
 						}
 					},
 					capabilities: {
@@ -899,18 +1313,29 @@ function protocolJsonSchema() {
 							name: { type: "string" }
 						}
 					},
-					deviceToken: { type: "string" },
-					approval: {
+					desktopBootstrap: {
 						type: "object",
-						required: ["state", "expiresAt"],
+						required: ["nonce", "proof"],
 						additionalProperties: false,
 						properties: {
-							state: { const: "pending" },
-							expiresAt: { type: "string" }
+							nonce: {
+								type: "string",
+								pattern: "^[A-Za-z0-9_-]{43}$"
+							},
+							proof: {
+								type: "string",
+								pattern: "^[A-Za-z0-9_-]{43}$"
+							}
 						}
 					}
 				}
 			},
+			DesktopAuthenticateResult: {
+				type: "object",
+				required: ["authorized"],
+				additionalProperties: false,
+				properties: { authorized: { const: true } }
+			},
 			LogRecord: {
 				type: "object",
 				description: "One record as `stim logs --json` prints it.",
@@ -926,6 +1351,25 @@ function protocolJsonSchema() {
 					}
 				}
 			},
+			DesktopLogFilter: {
+				type: "object",
+				required: ["workspace"],
+				additionalProperties: false,
+				properties: {
+					workspace: { type: "string" },
+					sources: {
+						type: "array",
+						minItems: 1,
+						items: { enum: [...LOG_SOURCES] }
+					},
+					level: { enum: [...LOG_LEVELS] },
+					grep: {
+						type: "string",
+						pattern: "^[^\\u0000]*$"
+					},
+					errors: { type: "boolean" }
+				}
+			},
 			LogFilter: {
 				type: "object",
 				oneOf: [{ required: ["workspace"] }, { required: ["archive"] }],
@@ -1383,6 +1827,36 @@ function protocolJsonSchema() {
 					suppressed: { enum: [...NOTIFICATION_SUPPRESSIONS] }
 				}
 			},
+			DesktopReportTarget: { oneOf: [{
+				type: "object",
+				required: ["report"],
+				additionalProperties: false,
+				properties: { report: { const: "gc" } }
+			}, {
+				type: "object",
+				required: ["report", "cwd"],
+				additionalProperties: false,
+				properties: {
+					report: { const: "doctor" },
+					cwd: {
+						type: "string",
+						minLength: 1,
+						maxLength: 4096
+					},
+					platform: { enum: ["ios", "android"] }
+				}
+			}] },
+			DesktopReportSnapshot: {
+				type: "object",
+				required: ["pending", "value"],
+				additionalProperties: false,
+				properties: {
+					pending: { type: "boolean" },
+					value: { type: ["object", "null"] },
+					error: { type: "string" },
+					measuredAt: { type: "string" }
+				}
+			},
 			MachineDetails: {
 				type: "object",
 				required: [
@@ -1405,7 +1879,7 @@ function protocolJsonSchema() {
 					statsError: { type: "string" },
 					buildMachines: {
 						type: ["array", "null"],
-						description: "`remoteMachines` from `stim doctor --json --platform ios`.",
+						description: "`remoteMachines` from `stim doctor --json`.",
 						items: { type: "object" }
 					},
 					buildMachinesError: { type: "string" },
@@ -1413,7 +1887,7 @@ function protocolJsonSchema() {
 					buildMachinesPending: { type: "boolean" },
 					buildClients: {
 						type: "array",
-						description: "The builds this Mac ran for each client, from the audit log.",
+						description: "The builds this machine ran for each client, from the audit log.",
 						items: {
 							type: "object",
 							required: [
@@ -1916,43 +2390,327 @@ function protocolJsonSchema() {
 				request("device-host.input.rotate", session({ direction: { enum: [...ROTATE_DIRECTIONS] } }, ["direction"])),
 				request("device-host.input.posture", session({ posture: { enum: [...DEVICE_POSTURES] } }, ["posture"])),
 				request("hello", { $ref: "#/$defs/HelloParams" }),
+				request("desktop.authenticate", {
+					type: "object",
+					required: ["proof"],
+					additionalProperties: false,
+					properties: { proof: {
+						type: "string",
+						pattern: "^[A-Za-z0-9_-]{43}$"
+					} }
+				}),
 				optionalParams("route.setup", {
 					type: "object",
 					maxProperties: 0
 				}),
-				request("status.subscribe"),
-				request("logs.query", { $ref: "#/$defs/LogFilter" }),
-				request("logs.subscribe", { $ref: "#/$defs/LogFilter" }),
-				request("frames.subscribe", { $ref: "#/$defs/FrameTarget" }),
-				request("frames.keyframe", {
+				request("desktop.reports.get", { $ref: "#/$defs/DesktopReportTarget" }),
+				request("desktop.reports.subscribe", { $ref: "#/$defs/DesktopReportTarget" }),
+				optionalParams("desktop.reports.invalidate", {
 					type: "object",
-					required: ["subscription"],
+					maxProperties: 0
+				}),
+				request("desktop.settings.get", {
+					type: "object",
+					required: ["cwd"],
 					additionalProperties: false,
-					properties: { subscription: { type: "string" } }
+					properties: { cwd: {
+						type: "string",
+						minLength: 1,
+						maxLength: 4096
+					} }
 				}),
-				request("frames.seek", {
+				request("desktop.settings.write", { oneOf: ["set", "unset"].map((action) => ({
 					type: "object",
 					required: [
-						"subscription",
-						"at",
-						"rate"
+						"cwd",
+						"action",
+						"key",
+						...action === "set" ? ["value"] : []
 					],
 					additionalProperties: false,
 					properties: {
-						subscription: { type: "string" },
-						at: {
-							type: "number",
-							description: "Epoch milliseconds on the Mac clock."
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
 						},
-						rate: { enum: [...REPLAY_RATES] }
+						action: { const: action },
+						key: {
+							type: "string",
+							minLength: 1,
+							maxLength: 256
+						},
+						scope: { enum: [...SETTING_SCOPES] },
+						...action === "set" ? { value: { type: "string" } } : {}
 					}
-				}),
-				request("frames.live", {
+				})) }),
+				request("desktop.logs.subscribe", { $ref: "#/$defs/DesktopLogFilter" }),
+				request("desktop.doctor.run", {
 					type: "object",
-					required: ["subscription"],
+					required: ["cwd"],
 					additionalProperties: false,
-					properties: { subscription: { type: "string" } }
-				}),
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						platform: { enum: ["ios", "android"] }
+					}
+				}),
+				request("desktop.stop.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						slot: {
+							type: "string",
+							pattern: "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+							not: { enum: [
+								"constructor",
+								"prototype",
+								"__proto__"
+							] }
+						}
+					}
+				}),
+				request("desktop.machine-access.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						ticket: {
+							type: "string",
+							pattern: "^[A-Za-z0-9_-]{43}$"
+						}
+					}
+				}),
+				request("desktop.reload.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						platform: { enum: [...RELOAD_PLATFORMS] }
+					}
+				}),
+				request("desktop.start.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						remote: { type: "boolean" },
+						resetCache: { type: "boolean" },
+						waitSeconds: {
+							type: "integer",
+							minimum: 1,
+							maximum: Number.MAX_SAFE_INTEGER
+						}
+					}
+				}),
+				request("desktop.run.subscribe", {
+					type: "object",
+					required: ["cwd", "options"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						options: platformRunOptions
+					}
+				}),
+				request("desktop.plan.get", { oneOf: [{
+					type: "object",
+					required: ["cwd", "platform"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						platform: { enum: ["ios", "android"] },
+						slot: {
+							type: "string",
+							pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+						},
+						request: {
+							type: "string",
+							pattern: "^[A-Za-z0-9_-]{1,128}$"
+						}
+					}
+				}, {
+					type: "object",
+					required: ["cwd", "platform"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						platform: { const: "macos" },
+						request: {
+							type: "string",
+							pattern: "^[A-Za-z0-9_-]{1,128}$"
+						}
+					}
+				}] }),
+				request("desktop.plan.cancel", {
+					type: "object",
+					required: ["request"],
+					additionalProperties: false,
+					properties: { request: {
+						type: "string",
+						pattern: "^[A-Za-z0-9_-]{1,128}$"
+					} }
+				}),
+				request("desktop.build.subscribe", {
+					type: "object",
+					required: ["cwd", "options"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						options: platformBuildOptions
+					}
+				}),
+				request("desktop.gc.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						cache: {
+							type: "string",
+							minLength: 1,
+							maxLength: 1024,
+							pattern: "^.*\\S.*$"
+						},
+						olderThan: {
+							type: "integer",
+							minimum: Number.MIN_SAFE_INTEGER,
+							maximum: Number.MAX_SAFE_INTEGER
+						},
+						worktrees: { type: "boolean" },
+						delete: { type: "boolean" },
+						idleMs: {
+							type: "integer",
+							minimum: 1,
+							maximum: Number.MAX_SAFE_INTEGER
+						}
+					}
+				}),
+				request("desktop.worktree.warm.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: { cwd: {
+						type: "string",
+						minLength: 1,
+						maxLength: 4096
+					} }
+				}),
+				request("desktop.worktree.remove.subscribe", {
+					type: "object",
+					required: ["cwd"],
+					additionalProperties: false,
+					properties: {
+						cwd: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						target: {
+							type: "string",
+							minLength: 1,
+							maxLength: 4096
+						},
+						force: { type: "boolean" }
+					}
+				}),
+				request("status.subscribe"),
+				request("workspaces.subscribe"),
+				request("workspace.subscribe", workspaceRef),
+				request("machine.subscribe"),
+				request("builds.history", workspaceRef),
+				optionalParams("archived.list", {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						before: {
+							type: "string",
+							minLength: 1
+						},
+						limit: {
+							type: "integer",
+							minimum: 1,
+							maximum: ARCHIVED_PAGE_LIMIT
+						}
+					}
+				}),
+				request("worktrees.list"),
+				request("maintenance.get"),
+				request("logs.query", { $ref: "#/$defs/LogFilter" }),
+				request("logs.subscribe", { $ref: "#/$defs/LogFilter" }),
+				request("frames.subscribe", { $ref: "#/$defs/FrameTarget" }),
+				request("frames.keyframe", {
+					type: "object",
+					required: ["subscription"],
+					additionalProperties: false,
+					properties: { subscription: { type: "string" } }
+				}),
+				request("frames.seek", {
+					type: "object",
+					required: [
+						"subscription",
+						"at",
+						"rate"
+					],
+					additionalProperties: false,
+					properties: {
+						subscription: { type: "string" },
+						at: {
+							type: "number",
+							description: "Epoch milliseconds on the machine clock."
+						},
+						rate: { enum: [...REPLAY_RATES] }
+					}
+				}),
+				request("frames.live", {
+					type: "object",
+					required: ["subscription"],
+					additionalProperties: false,
+					properties: { subscription: { type: "string" } }
+				}),
 				request("replay.range", {
 					type: "object",
 					required: ["platform"],
@@ -2001,7 +2759,7 @@ function protocolJsonSchema() {
 						},
 						at: {
 							type: "number",
-							description: "Epoch milliseconds on the Mac clock."
+							description: "Epoch milliseconds on the machine clock."
 						}
 					}
 				}),
@@ -2221,11 +2979,24 @@ function protocolJsonSchema() {
 					properties: {
 						repo: buildRepo,
 						lockfile: sha256,
+						dependencies: {
+							type: "object",
+							required: ["project", "packageName"],
+							additionalProperties: false,
+							properties: {
+								project: { type: "string" },
+								packageName: { type: ["string", "null"] }
+							}
+						},
 						rubyVersion: {
 							type: "string",
 							pattern: BUILD_RUBY_VERSION_PATTERN
 						},
-						native: { enum: ["xcode", "gradle"] }
+						native: { enum: ["xcode", "gradle"] },
+						artifact: buildArtifactIdentity,
+						gradleArtifact: gradleArtifactQuery,
+						reactNativeArtifact: reactNativeArtifactQuery,
+						swiftpmArtifact: swiftpmArtifactQuery
 					}
 				}),
 				request("build.sync", {
@@ -2369,6 +3140,20 @@ function protocolJsonSchema() {
 							properties: {
 								provider: { const: "gradle" },
 								sourceDigest: sha256,
+								cache: {
+									type: "object",
+									required: [
+										"read",
+										"write",
+										"remote"
+									],
+									additionalProperties: false,
+									properties: {
+										read: { type: "boolean" },
+										write: { type: "boolean" },
+										remote: { type: "boolean" }
+									}
+								},
 								inputs: {
 									type: "object",
 									required: [
@@ -2443,6 +3228,7 @@ function protocolJsonSchema() {
 									type: "string",
 									pattern: "^[A-Za-z0-9][A-Za-z0-9.-]{0,199}$"
 								},
+								artifactInputs: swiftpmArtifactInputs,
 								resources: {
 									type: "object",
 									maxProperties: 256,
@@ -2454,6 +3240,7 @@ function protocolJsonSchema() {
 								}
 							}
 						},
+						cacheArtifact: { type: "boolean" },
 						stimBuild: {
 							type: "string",
 							minLength: 1
@@ -2462,6 +3249,18 @@ function protocolJsonSchema() {
 				}),
 				request("build.cancel", buildJob),
 				request("build.artifact", buildJob),
+				request("build.cached-artifact", {
+					type: "object",
+					required: ["repo", "artifact"],
+					additionalProperties: false,
+					properties: {
+						repo: buildRepo,
+						artifact: buildArtifactIdentity,
+						gradleArtifact: gradleArtifactQuery,
+						reactNativeArtifact: reactNativeArtifactQuery,
+						swiftpmArtifact: swiftpmArtifactQuery
+					}
+				}),
 				request("build.attach", buildJob),
 				request("server.update.status"),
 				request("device-host.sessions"),
@@ -2566,6 +3365,7 @@ function protocolJsonSchema() {
 						{ $ref: "#/$defs/ServerUpdateProgress" },
 						{ $ref: "#/$defs/MachineUpdateStatus" },
 						{ $ref: "#/$defs/HelloResult" },
+						{ $ref: "#/$defs/DesktopAuthenticateResult" },
 						{ $ref: "#/$defs/ControlBeginResult" },
 						{ $ref: "#/$defs/SimulatorOptions" },
 						{ $ref: "#/$defs/ActionResult" },
@@ -2714,6 +3514,76 @@ function protocolJsonSchema() {
 				}
 			}] },
 			ServerEvent: { oneOf: [
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"stream",
+						"message"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { enum: [
+							"desktop-stop-progress",
+							"desktop-reload-progress",
+							"desktop-start-progress",
+							"desktop-run-progress",
+							"desktop-build-progress",
+							"desktop-gc-progress",
+							"desktop-worktree-remove-progress",
+							"desktop-worktree-warm-progress",
+							"desktop-machine-access-progress"
+						] },
+						subscription: { type: "string" },
+						stream: { enum: ["stdout", "stderr"] },
+						message: { type: "string" }
+					}
+				},
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"exitCode",
+						"stdout",
+						"message"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { enum: [
+							"desktop-stop-ended",
+							"desktop-reload-ended",
+							"desktop-start-ended",
+							"desktop-run-ended",
+							"desktop-build-ended",
+							"desktop-gc-ended",
+							"desktop-worktree-remove-ended",
+							"desktop-worktree-warm-ended",
+							"desktop-machine-access-ended"
+						] },
+						subscription: { type: "string" },
+						exitCode: { enum: [0, 1] },
+						stdout: { type: "string" },
+						message: { type: "string" }
+					}
+				},
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"target",
+						"snapshot"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { const: "desktop-report" },
+						subscription: { type: "string" },
+						target: { $ref: "#/$defs/DesktopReportTarget" },
+						snapshot: { $ref: "#/$defs/DesktopReportSnapshot" }
+					}
+				},
 				{
 					type: "object",
 					required: [
@@ -2804,6 +3674,95 @@ function protocolJsonSchema() {
 						}
 					}
 				},
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"seq"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { const: "workspaces" },
+						subscription: { type: "string" },
+						seq: {
+							type: "integer",
+							minimum: 0
+						},
+						snapshot: {
+							type: "object",
+							required: [
+								"workspaces",
+								"worktrees",
+								"archived"
+							],
+							additionalProperties: false,
+							properties: {
+								workspaces: {
+									type: "array",
+									items: { type: "object" }
+								},
+								worktrees: {
+									type: "array",
+									items: { type: "object" }
+								},
+								archived: { type: "object" }
+							}
+						},
+						workspaces: keyedDelta("Workspace summaries to insert or replace by path."),
+						worktrees: keyedDelta("Unprovisioned worktree rows to insert or replace by path."),
+						archived: {
+							type: "object",
+							description: "The archives summary, when it changed."
+						}
+					}
+				},
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"seq",
+						"environment"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { const: "workspace" },
+						subscription: { type: "string" },
+						seq: {
+							type: "integer",
+							minimum: 0
+						},
+						environment: {
+							oneOf: [{ type: "null" }, { type: "object" }],
+							description: "The environment, as `stim status --json` prints it."
+						}
+					}
+				},
+				{
+					type: "object",
+					required: [
+						"event",
+						"subscription",
+						"seq",
+						"machine"
+					],
+					additionalProperties: false,
+					properties: {
+						event: { const: "machine" },
+						subscription: { type: "string" },
+						seq: {
+							type: "integer",
+							minimum: 0
+						},
+						machine: { type: "object" },
+						usage: { $ref: "#/$defs/UsageHistory" },
+						ownLeases: {
+							type: "array",
+							items: { type: "string" }
+						}
+					}
+				},
 				{
 					type: "object",
 					required: [