@stim-cli/server 1.24.0 → 1.25.0

package/README.md

@@ -49,8 +49,8 @@ and [device-host clients](#device-host-approval). The plain listing shows
 [Actions](#actions).
 
 `GET http://127.0.0.1:7787/health` answers requests from this machine with the
-server's name, versions, `stimBuild` (the digest of the bundled Stim's build,
-which offload compares between machines), protocol, `stimHome`, `startup`, `busy`
+server's name, versions, `stimBuild` (the digest of the bundled Stim's build),
+protocol, `stimHome`, `startup`, `busy`
 (the offloaded `builds` and `hostedSessions` running now) and the current
 Tailscale state. It answers HTTP 200 once `startup.state` is `ready`; while the
 state is `pending` or `degraded` (see the LaunchAgent notes below) it answers
@@ -1615,6 +1615,8 @@ connected since stim-server started keeps its directory when revoked.
   same Ruby selection and UTF-8 locale defaults as `pod install`; omitting
   `rubyVersion` uses the worker's default Ruby. It
   returns `toolchain` (`stimBuild`, a digest of the bundled Stim's built code;
+  `compat`, the bundled Stim's build compatibility version, which a client
+  compares instead of `stimBuild` when it is present;
   `os`, the OS stim-server runs on as Node names it (`darwin`, `linux`, `win32`);
   `arch`; `xcode`; `simulatorSdk`; `macosSdk` (from
   `xcrun --sdk macosx --show-sdk-version`); `cocoapods`; `runtimes`, the simulator
@@ -1652,8 +1654,10 @@ connected since stim-server started keeps its directory when revoked.
   architecture and target options. These are exact lookups, not a full inventory.
   With `react-native-peer-cache`, a React Native/Expo development offer can send
   `reactNativeArtifact: { project, fingerprint, isExpo, platform, toolchain, ios | android }`.
-  The query includes the caller's compatible toolchain and normalized native
-  build choices; the worker constructs its own receipt around compilation.
+  The query includes the caller's compatible toolchain, whose `toolchain.compat`
+  takes the place of `stimBuild` with `build-compat`, and normalized native
+  build choices; a caller sends React Native and SwiftPM queries only to a
+  server with `build-compat`; the worker constructs its own receipt around compilation.
   The returned identity is opaque, not an alias for the caller's local cache key.
   The completed receipt binds the worker-verified post-mutation fingerprint
   and native options to the toolchain checked before and after compilation.
@@ -1661,7 +1665,7 @@ connected since stim-server started keeps its directory when revoked.
   does not discard a matching archive. Older workers receive no new query
   parameters and continue through their normal build path.
   With `swiftpm-peer-cache`, `swiftpmArtifact` carries `project`, `sourceDigest`,
-  `stimBuild`, complete `inputs` (`ignored`, `outputs`, `localFiles`,
+  `stimBuild` or, with `build-compat`, `compat` in its place, complete `inputs` (`ignored`, `outputs`, `localFiles`,
   `environment`) and `build` (`product`, `infoPlist`, `resources`, `assetCatalog`).
   Resource and catalog paths are repository-relative; the plist is
   project-relative. The worker verifies actual transferred files and full
@@ -1711,7 +1715,7 @@ connected since stim-server started keeps its directory when revoked.
   simulator runtime identifier, required for `ios`, null for `android`),
   `fingerprint`, `packageName`, `isExpo`, `optimizations`, `android` (for
   `android`: `variant`, `abi`, `gradleBuildCache`, `pch` and `compilerCache`,
-  `ccache` or `none`) and `stimBuild`, after the whole manifest of `repo` was
+  `ccache` or `none`), `stimBuild` and, from a caller that saw `build-compat`, `compat`, after the whole manifest of `repo` was
   synced on this connection. A peer-cache-capable React Native caller can set
   `cacheArtifact: true` to retain a completed development archive when its cache
   write and remote policies allow it. With the `fingerprint-sources` feature, a
@@ -1728,7 +1732,8 @@ connected since stim-server started keeps its directory when revoked.
   `build-busy` while the offer would be declined, naming the reason, or while
   another build of the same client and repository runs, or while every one
   of this machine's `concurrency.maxBuilds` slots is held, and with
-  `build-refused` when `stimBuild` differs. The build runs `offload-worker.mjs` of the bundled Stim with
+  `build-refused` when `compat` differs from this machine's, or, when either
+  side has no `compat`, when `stimBuild` differs. The build runs `offload-worker.mjs` of the bundled Stim with
   `STIM_HOME` set to the repository's area. It makes the area's checkout
   hold exactly the manifest (a file git lists as untracked and not ignored,
   and not in the manifest, is deleted; ignored dependencies and generated

package/dist/{protocol-B8Ztv1K4.mjs → protocol-VEZO2CyR.mjs}

@@ -290,15 +290,21 @@ const swiftpmArtifactInputs = {
 		}
 	}
 };
+const buildCompat = {
+	type: "integer",
+	minimum: 1,
+	description: "The Stim build compatibility version, sent to a stim-server with the build-compat feature."
+};
+const stimIdentity = [{ required: ["stimBuild"] }, { required: ["compat"] }];
 const swiftpmArtifactQuery = {
 	type: "object",
 	required: [
 		"project",
 		"sourceDigest",
-		"stimBuild",
 		"inputs",
 		"build"
 	],
+	oneOf: stimIdentity,
 	additionalProperties: false,
 	properties: {
 		project: { type: "string" },
@@ -308,6 +314,7 @@ const swiftpmArtifactQuery = {
 			minLength: 1,
 			maxLength: 256
 		},
+		compat: buildCompat,
 		inputs: swiftpmArtifactInputs,
 		build: {
 			type: "object",
@@ -379,13 +386,14 @@ const reactNativeArtifactQuery = {
 		platform: { enum: ["ios", "android"] },
 		toolchain: {
 			type: "object",
-			required: ["stimBuild"],
+			oneOf: stimIdentity,
 			additionalProperties: false,
 			properties: {
 				stimBuild: {
 					type: "string",
 					minLength: 1
 				},
+				compat: buildCompat,
 				arch: {
 					type: "string",
 					minLength: 1
@@ -3304,6 +3312,10 @@ function protocolJsonSchema() {
 						stimBuild: {
 							type: "string",
 							minLength: 1
+						},
+						compat: {
+							...buildCompat,
+							description: "Compared instead of stimBuild by a machine whose build.offer toolchain reports compat."
 						}
 					}
 				}),

package/dist/protocol.mjs

@@ -1,3 +1,3 @@
-import { t as protocolJsonSchema } from "./protocol-B8Ztv1K4.mjs";
+import { t as protocolJsonSchema } from "./protocol-VEZO2CyR.mjs";
 export * from "@stim-cli/core/protocol";
 export { protocolJsonSchema };

package/dist/protocol.schema.json

@@ -1280,6 +1280,7 @@
               "hosted-android-process",
               "hosted-metro-ports",
               "server-update",
+              "build-compat",
               "status-views",
               "desktop-reports",
               "desktop-report-platform",
@@ -6885,8 +6886,17 @@
                     },
                     "toolchain": {
                       "type": "object",
-                      "required": [
-                        "stimBuild"
+                      "oneOf": [
+                        {
+                          "required": [
+                            "stimBuild"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "compat"
+                          ]
+                        }
                       ],
                       "additionalProperties": false,
                       "properties": {
@@ -6894,6 +6904,11 @@
                           "type": "string",
                           "minLength": 1
                         },
+                        "compat": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The Stim build compatibility version, sent to a stim-server with the build-compat feature."
+                        },
                         "arch": {
                           "type": "string",
                           "minLength": 1
@@ -7030,10 +7045,21 @@
                   "required": [
                     "project",
                     "sourceDigest",
-                    "stimBuild",
                     "inputs",
                     "build"
                   ],
+                  "oneOf": [
+                    {
+                      "required": [
+                        "stimBuild"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "compat"
+                      ]
+                    }
+                  ],
                   "additionalProperties": false,
                   "properties": {
                     "project": {
@@ -7048,6 +7074,11 @@
                       "minLength": 1,
                       "maxLength": 256
                     },
+                    "compat": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "description": "The Stim build compatibility version, sent to a stim-server with the build-compat feature."
+                    },
                     "inputs": {
                       "type": "object",
                       "required": [
@@ -7652,6 +7683,11 @@
                 "stimBuild": {
                   "type": "string",
                   "minLength": 1
+                },
+                "compat": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Compared instead of stimBuild by a machine whose build.offer toolchain reports compat."
                 }
               }
             }
@@ -7934,8 +7970,17 @@
                     },
                     "toolchain": {
                       "type": "object",
-                      "required": [
-                        "stimBuild"
+                      "oneOf": [
+                        {
+                          "required": [
+                            "stimBuild"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "compat"
+                          ]
+                        }
                       ],
                       "additionalProperties": false,
                       "properties": {
@@ -7943,6 +7988,11 @@
                           "type": "string",
                           "minLength": 1
                         },
+                        "compat": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The Stim build compatibility version, sent to a stim-server with the build-compat feature."
+                        },
                         "arch": {
                           "type": "string",
                           "minLength": 1
@@ -8079,10 +8129,21 @@
                   "required": [
                     "project",
                     "sourceDigest",
-                    "stimBuild",
                     "inputs",
                     "build"
                   ],
+                  "oneOf": [
+                    {
+                      "required": [
+                        "stimBuild"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "compat"
+                      ]
+                    }
+                  ],
                   "additionalProperties": false,
                   "properties": {
                     "project": {
@@ -8097,6 +8158,11 @@
                       "minLength": 1,
                       "maxLength": 256
                     },
+                    "compat": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "description": "The Stim build compatibility version, sent to a stim-server with the build-compat feature."
+                    },
                     "inputs": {
                       "type": "object",
                       "required": [

package/dist/{stim-server-Z40-_Git.mjs → stim-server-DowAx-6v.mjs}

@@ -1,4 +1,4 @@
-import { n as protocol_exports } from "./protocol-B8Ztv1K4.mjs";
+import { n as protocol_exports } from "./protocol-VEZO2CyR.mjs";
 import { createRequire } from "node:module";
 import { execFile, execFileSync, spawn } from "node:child_process";
 import { appendFileSync, chmodSync, closeSync, constants, copyFileSync, cpSync, createReadStream, existsSync, futimesSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, rmdirSync, statSync, statfsSync, watch, writeFileSync, writeSync } from "node:fs";
@@ -3283,7 +3283,7 @@ function macosBuildOptions(params) {
 	const artifactQuery = options.artifactInputs === void 0 ? null : swiftpmArtifactQuery({
 		project: params.project,
 		sourceDigest: params.fingerprint,
-		stimBuild: params.stimBuild,
+		...typeof params.compat === "number" ? { compat: params.compat } : { stimBuild: params.stimBuild },
 		inputs: options.artifactInputs,
 		build: {
 			product: options.product,
@@ -3636,7 +3636,7 @@ var BuildHost = class {
 		const query = swiftpmArtifactQuery({
 			project: job.project,
 			sourceDigest: job.expectedFingerprint,
-			stimBuild: job.stimBuild,
+			...typeof job.compat === "number" ? { compat: job.compat } : { stimBuild: job.stimBuild },
 			inputs: options.artifactInputs,
 			build: {
 				product: options.product,
@@ -4352,7 +4352,11 @@ var BuildSession = class {
 		for (const file of this.files.values()) if (!existsSync(this.blobPath(file.sha256))) return refusal("bad-request", `The blob of ${file.path} is missing; sync again.`);
 		const toolchain = await this.host.toolchain(null, native?.provider);
 		if (this.closed) return refusal("build-refused", "The connection closed.");
-		if (!toolchain || toolchain.stimBuild !== params.stimBuild) return refusal("build-refused", `This machine runs Stim build ${toolchain?.stimBuild ?? "unknown"}.`);
+		const compat = typeof params.compat === "number" ? params.compat : void 0;
+		if (!toolchain) return refusal("build-refused", "This machine runs Stim build unknown.");
+		if (compat !== void 0 && toolchain.compat !== void 0) {
+			if (toolchain.compat !== compat) return refusal("build-refused", `This machine runs Stim build ${toolchain.stimBuild ?? "unknown"} with build compatibility ${toolchain.compat}, not ${compat}.`);
+		} else if (toolchain.stimBuild !== params.stimBuild) return refusal("build-refused", `This machine runs Stim build ${toolchain.stimBuild ?? "unknown"}.`);
 		const launched = this.host.launch({
 			client: this.client,
 			repo: params.repo,
@@ -4368,6 +4372,7 @@ var BuildSession = class {
 				isExpo: params.isExpo === true,
 				cacheArtifact: params.cacheArtifact === true,
 				stimBuild: params.stimBuild,
+				...compat !== void 0 && toolchain.compat !== void 0 ? { compat } : {},
 				configuration: optional(params.configuration),
 				scheme: optional(params.scheme),
 				iosProjectPath: optional(params.iosProjectPath),

package/dist/stim-server.mjs

@@ -4,6 +4,6 @@ const encode = (version) => version.split(".", 3).reduce((sum, part) => sum * 1e
 if (encode(process.versions.node) < encode("22.12.0")) {
 	process.stderr.write(`STIM_NODE_UNSUPPORTED: stim-server needs Node 22.12.0 or later; this is Node ${process.versions.node} at ${process.execPath}. To run stim-server where a project pins an older Node, see https://stim.appandflow.com/docs/requirements#older-node-pins\n`);
 	process.exitCode = 1;
-} else import("./stim-server-Z40-_Git.mjs");
+} else import("./stim-server-DowAx-6v.mjs");
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stim-cli/server",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Serves Stim status to paired clients over Tailscale, and runs reload and stop for clients granted control.",
   "license": "MIT",
   "repository": {
@@ -28,13 +28,13 @@
     "./protocol.schema.json": "./dist/protocol.schema.json"
   },
   "dependencies": {
-    "@stim-cli/agent-driver": "^1.24.0",
-    "@stim-cli/agent-driver-agent-device": "^1.24.0",
-    "@stim-cli/cache": "^1.24.0",
-    "@stim-cli/core": "^1.24.0",
-    "@stim-cli/transport": "^1.24.0",
-    "@stim-cli/transport-tailscale": "^1.24.0",
-    "stim": "1.24.0",
+    "@stim-cli/agent-driver": "1.25.0",
+    "@stim-cli/agent-driver-agent-device": "1.25.0",
+    "@stim-cli/cache": "1.25.0",
+    "@stim-cli/core": "1.25.0",
+    "@stim-cli/transport": "1.25.0",
+    "@stim-cli/transport-tailscale": "1.25.0",
+    "stim": "1.25.0",
     "ws": "^8.21.3"
   },
   "devDependencies": {