@stim-cli/server 1.16.0 → 1.17.1

package/dist/{protocol-BHSl7bQ_.mjs → protocol-Btu-PwQS.mjs}

@@ -187,13 +187,26 @@ function protocolJsonSchema() {
 									"deviceKey"
 								],
 								additionalProperties: false,
-								oneOf: [{
-									required: ["backend"],
-									properties: { deviceKey: { pattern: "^ios:mobile:[a-fA-F0-9-]{36}$" } }
-								}, {
-									not: { required: ["backend"] },
-									properties: { deviceKey: { pattern: "^[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+)+@[1-9][0-9]{0,9}$" } }
-								}],
+								oneOf: [
+									{
+										required: ["backend"],
+										properties: {
+											backend: { const: "ios-instance" },
+											deviceKey: { pattern: "^ios:mobile:[a-fA-F0-9-]{36}$" }
+										}
+									},
+									{
+										required: ["backend"],
+										properties: {
+											backend: { const: "android-instance" },
+											deviceKey: { pattern: "^android:mobile:emulator-[0-9]+$" }
+										}
+									},
+									{
+										not: { required: ["backend"] },
+										properties: { deviceKey: { pattern: "^[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+)+@[1-9][0-9]{0,9}$" } }
+									}
+								],
 								properties: {
 									tenant: {
 										type: "string",
@@ -207,7 +220,7 @@ function protocolJsonSchema() {
 										type: "string",
 										pattern: "^[A-Za-z0-9._-]{1,128}$"
 									},
-									backend: { const: "ios-instance" },
+									backend: { enum: ["ios-instance", "android-instance"] },
 									deviceKey: { type: "string" }
 								}
 							}
@@ -391,6 +404,19 @@ function protocolJsonSchema() {
 					}
 				}
 			},
+			HostedLocalDeviceCount: { anyOf: [{
+				type: "integer",
+				minimum: 0
+			}, {
+				type: "object",
+				required: ["unknown"],
+				additionalProperties: false,
+				properties: { unknown: {
+					type: "string",
+					minLength: 1,
+					maxLength: 4e3
+				} }
+			}] },
 			HostedDeviceOffer: {
 				type: "object",
 				required: [
@@ -444,7 +470,8 @@ function protocolJsonSchema() {
 							workerDiskFreeBytes: {
 								type: ["number", "null"],
 								minimum: 0
-							}
+							},
+							localDevices: { $ref: "#/$defs/HostedLocalDeviceCount" }
 						}
 					},
 					capacity: {
@@ -467,7 +494,8 @@ function protocolJsonSchema() {
 							available: {
 								type: ["integer", "null"],
 								minimum: 0
-							}
+							},
+							local: { $ref: "#/$defs/HostedLocalDeviceCount" }
 						}
 					}
 				},
@@ -541,6 +569,68 @@ function protocolJsonSchema() {
 					maximum: 65535
 				} }
 			},
+			HostedSessionRow: {
+				type: "object",
+				required: [
+					"id",
+					"client",
+					"platform",
+					"device",
+					"app",
+					"state",
+					"parked",
+					"since",
+					"workspace"
+				],
+				additionalProperties: false,
+				properties: {
+					id: { type: "string" },
+					client: {
+						type: "object",
+						required: ["id", "name"],
+						additionalProperties: false,
+						properties: {
+							id: { type: "string" },
+							name: { type: "string" }
+						}
+					},
+					platform: { enum: [
+						"ios",
+						"android",
+						"macos"
+					] },
+					device: { type: ["string", "null"] },
+					app: { type: ["string", "null"] },
+					state: { enum: [
+						"preparing",
+						"ready",
+						"stopping",
+						"stopped",
+						"unknown"
+					] },
+					parked: { type: "boolean" },
+					since: { type: "string" },
+					workspace: { type: "string" }
+				}
+			},
+			HostedSessionsResult: {
+				type: "object",
+				required: ["sessions"],
+				additionalProperties: false,
+				properties: { sessions: {
+					type: "array",
+					items: { $ref: "#/$defs/HostedSessionRow" }
+				} }
+			},
+			HostedSessionStopResult: {
+				type: "object",
+				required: ["id", "state"],
+				additionalProperties: false,
+				properties: {
+					id: { type: "string" },
+					state: { enum: ["stopping", "stopped"] }
+				}
+			},
 			HostedDeviceSession: {
 				type: "object",
 				required: [
@@ -662,6 +752,7 @@ function protocolJsonSchema() {
 					createdAt: { type: "string" },
 					notice: { type: "string" },
 					appAttempt: { type: "string" },
+					agent: { $ref: "#/$defs/HostedAppDelivery/properties/agent" },
 					metroPort: {
 						type: "integer",
 						minimum: 1,
@@ -1307,7 +1398,7 @@ function protocolJsonSchema() {
 					statsError: { type: "string" },
 					buildMachines: {
 						type: ["array", "null"],
-						description: "`buildMachines` from `stim doctor --json --platform ios`.",
+						description: "`remoteMachines` from `stim doctor --json --platform ios`.",
 						items: { type: "object" }
 					},
 					buildMachinesError: { type: "string" },
@@ -1315,7 +1406,7 @@ function protocolJsonSchema() {
 					buildMachinesPending: { type: "boolean" },
 					buildClients: {
 						type: "array",
-						description: "The builds this Mac ran for each client as a build machine, from the audit log.",
+						description: "The builds this Mac ran for each client, from the audit log.",
 						items: {
 							type: "object",
 							required: [
@@ -1689,6 +1780,11 @@ function protocolJsonSchema() {
 						minimum: 1,
 						maximum: 65535
 					},
+					clientMetroPort: {
+						type: "integer",
+						minimum: 1,
+						maximum: 65535
+					},
 					secret: {
 						type: "string",
 						pattern: "^[a-f0-9]{64}$"
@@ -1865,6 +1961,16 @@ function protocolJsonSchema() {
 						}
 					}
 				}),
+				request("archive.detail", {
+					type: "object",
+					required: ["archive"],
+					additionalProperties: false,
+					properties: { archive: {
+						type: "string",
+						minLength: 1,
+						pattern: "^(?!.*\\.\\.)[^/\\\\\\u0000]+$"
+					} }
+				}),
 				request("replay.keyframe", {
 					type: "object",
 					required: ["platform", "at"],
@@ -2263,6 +2369,8 @@ function protocolJsonSchema() {
 				request("build.artifact", buildJob),
 				request("build.attach", buildJob),
 				request("server.update.status"),
+				request("device-host.sessions"),
+				request("device-host.sessions.stop", session({})),
 				request("machines.update.start", {
 					type: "object",
 					required: ["machine"],
@@ -2352,6 +2460,8 @@ function protocolJsonSchema() {
 					result: { anyOf: [
 						{ $ref: "#/$defs/HostedDeviceOffer" },
 						{ $ref: "#/$defs/HostedDeviceSession" },
+						{ $ref: "#/$defs/HostedSessionsResult" },
+						{ $ref: "#/$defs/HostedSessionStopResult" },
 						{ $ref: "#/$defs/HostedAppDelivery" },
 						{ $ref: "#/$defs/HostedMetroResult" },
 						{ $ref: "#/$defs/HostedAppOfferResult" },

package/dist/protocol.mjs

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

package/dist/protocol.schema.json

@@ -162,11 +162,27 @@
                         "backend"
                       ],
                       "properties": {
+                        "backend": {
+                          "const": "ios-instance"
+                        },
                         "deviceKey": {
                           "pattern": "^ios:mobile:[a-fA-F0-9-]{36}$"
                         }
                       }
                     },
+                    {
+                      "required": [
+                        "backend"
+                      ],
+                      "properties": {
+                        "backend": {
+                          "const": "android-instance"
+                        },
+                        "deviceKey": {
+                          "pattern": "^android:mobile:emulator-[0-9]+$"
+                        }
+                      }
+                    },
                     {
                       "not": {
                         "required": [
@@ -194,7 +210,10 @@
                       "pattern": "^[A-Za-z0-9._-]{1,128}$"
                     },
                     "backend": {
-                      "const": "ios-instance"
+                      "enum": [
+                        "ios-instance",
+                        "android-instance"
+                      ]
                     },
                     "deviceKey": {
                       "type": "string"
@@ -490,6 +509,28 @@
         }
       }
     },
+    "HostedLocalDeviceCount": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": 0
+        },
+        {
+          "type": "object",
+          "required": [
+            "unknown"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "unknown": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4000
+            }
+          }
+        }
+      ]
+    },
     "HostedDeviceOffer": {
       "type": "object",
       "required": [
@@ -553,6 +594,9 @@
                 "null"
               ],
               "minimum": 0
+            },
+            "localDevices": {
+              "$ref": "#/$defs/HostedLocalDeviceCount"
             }
           }
         },
@@ -579,6 +623,9 @@
                 "null"
               ],
               "minimum": 0
+            },
+            "local": {
+              "$ref": "#/$defs/HostedLocalDeviceCount"
             }
           }
         }
@@ -729,6 +776,113 @@
         }
       }
     },
+    "HostedSessionRow": {
+      "type": "object",
+      "required": [
+        "id",
+        "client",
+        "platform",
+        "device",
+        "app",
+        "state",
+        "parked",
+        "since",
+        "workspace"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "client": {
+          "type": "object",
+          "required": [
+            "id",
+            "name"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            }
+          }
+        },
+        "platform": {
+          "enum": [
+            "ios",
+            "android",
+            "macos"
+          ]
+        },
+        "device": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "app": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "state": {
+          "enum": [
+            "preparing",
+            "ready",
+            "stopping",
+            "stopped",
+            "unknown"
+          ]
+        },
+        "parked": {
+          "type": "boolean"
+        },
+        "since": {
+          "type": "string"
+        },
+        "workspace": {
+          "type": "string"
+        }
+      }
+    },
+    "HostedSessionsResult": {
+      "type": "object",
+      "required": [
+        "sessions"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "sessions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/HostedSessionRow"
+          }
+        }
+      }
+    },
+    "HostedSessionStopResult": {
+      "type": "object",
+      "required": [
+        "id",
+        "state"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "state": {
+          "enum": [
+            "stopping",
+            "stopped"
+          ]
+        }
+      }
+    },
     "HostedDeviceSession": {
       "type": "object",
       "required": [
@@ -917,6 +1071,9 @@
         "appAttempt": {
           "type": "string"
         },
+        "agent": {
+          "$ref": "#/$defs/HostedAppDelivery/properties/agent"
+        },
         "metroPort": {
           "type": "integer",
           "minimum": 1,
@@ -1144,11 +1301,14 @@
               "device-frames",
               "macos-hosted",
               "ios-hosted",
+              "android-hosted",
               "hosted-ios-agent",
+              "hosted-android-agent",
               "duo-frames",
               "workspace-diff",
               "hosted-congestion",
               "hosted-ios-data",
+              "hosted-android-data",
               "server-update"
             ]
           }
@@ -1959,7 +2119,7 @@
             "array",
             "null"
           ],
-          "description": "`buildMachines` from `stim doctor --json --platform ios`.",
+          "description": "`remoteMachines` from `stim doctor --json --platform ios`.",
           "items": {
             "type": "object"
           }
@@ -1975,7 +2135,7 @@
         },
         "buildClients": {
           "type": "array",
-          "description": "The builds this Mac ran for each client as a build machine, from the audit log.",
+          "description": "The builds this Mac ran for each client, from the audit log.",
           "items": {
             "type": "object",
             "required": [
@@ -2905,6 +3065,11 @@
                   "minimum": 1,
                   "maximum": 65535
                 },
+                "clientMetroPort": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 65535
+                },
                 "secret": {
                   "type": "string",
                   "pattern": "^[a-f0-9]{64}$"
@@ -3881,6 +4046,40 @@
             }
           }
         },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "archive.detail"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "archive"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "archive": {
+                  "type": "string",
+                  "minLength": 1,
+                  "pattern": "^(?!.*\\.\\.)[^/\\\\\\u0000]+$"
+                }
+              }
+            }
+          }
+        },
         {
           "type": "object",
           "required": [
@@ -5419,6 +5618,61 @@
             }
           }
         },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "device-host.sessions"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "device-host.sessions.stop"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "session"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "session": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
         {
           "type": "object",
           "required": [
@@ -5632,6 +5886,12 @@
                 {
                   "$ref": "#/$defs/HostedDeviceSession"
                 },
+                {
+                  "$ref": "#/$defs/HostedSessionsResult"
+                },
+                {
+                  "$ref": "#/$defs/HostedSessionStopResult"
+                },
                 {
                   "$ref": "#/$defs/HostedAppDelivery"
                 },

package/dist/stim-frames/DuoModelAsset.swift

@@ -0,0 +1,34 @@
+import Foundation
+
+/// Finds DeviceKit's iPhone Duo model (V68.usdz). Xcode 27.0 does not ship it; Xcode 27.1 does.
+public enum DuoModelAsset {
+  static let relativePath =
+    "SharedFrameworks/DeviceKit.framework/Versions/A/PlugIns/CoreDevicePopDeviceKitExtension.devicekitplugin/Contents/Resources/V68.usdz"
+
+  static func locate(selected: String, installed: [String], exists: (String) -> Bool) -> String? {
+    for developerDir in [selected] + installed.filter({ $0 != selected }) {
+      let path = URL(fileURLWithPath: developerDir).deletingLastPathComponent().appendingPathComponent(relativePath).path
+      if exists(path) { return path }
+    }
+    return nil
+  }
+
+  static func reason(selected: String) -> String {
+    "The iPhone Duo hardware model is not in the selected Xcode (\(URL(fileURLWithPath: selected).deletingLastPathComponent().deletingLastPathComponent().lastPathComponent)) or any other Xcode in /Applications. Xcode 27.1 or later includes it."
+  }
+
+  static var installedDeveloperDirs: [String] {
+    let names = (try? FileManager.default.contentsOfDirectory(atPath: "/Applications")) ?? []
+    return names.filter { $0.hasPrefix("Xcode") && $0.hasSuffix(".app") }.sorted(by: >)
+      .map { "/Applications/\($0)/Contents/Developer" }
+  }
+
+  static var current: URL? {
+    locate(selected: CoreSimulator.developerDir, installed: installedDeveloperDirs, exists: FileManager.default.fileExists)
+      .map { URL(fileURLWithPath: $0) }
+  }
+
+  public static var unavailableReason: String? {
+    current == nil ? reason(selected: CoreSimulator.developerDir) : nil
+  }
+}

package/dist/stim-frames/DuoModelView.swift

@@ -24,16 +24,8 @@ final class DuoModelView: SCNView {
   private var quarterTurns = 0
   var activeID: UInt32
 
-  static var assetURL: URL {
-    URL(fileURLWithPath: CoreSimulator.developerDir)
-      .deletingLastPathComponent()
-      .appendingPathComponent(
-        "SharedFrameworks/DeviceKit.framework/Versions/A/PlugIns/CoreDevicePopDeviceKitExtension.devicekitplugin/Contents/Resources/V68.usdz"
-      )
-  }
-
   static func load(innerID: UInt32, coverID: UInt32, nativeTurns: [UInt32: Int], assetURL: URL? = nil) -> DuoModelView? {
-    guard let source = SCNSceneSource(url: assetURL ?? Self.assetURL, options: nil),
+    guard let url = assetURL ?? DuoModelAsset.current, let source = SCNSceneSource(url: url, options: nil),
       let scene = source.scene(options: [.animationImportPolicy: SCNSceneSource.AnimationImportPolicy.play]),
       let inner = scene.rootNode.childNode(withName: "mQHVkATpIwJRVQx", recursively: true),
       let cover = scene.rootNode.childNode(withName: "zaWsadDZpWAUDAX", recursively: true),