@stim-cli/server 1.20.1 → 1.21.0

package/dist/protocol.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Stim server protocol",
-  "description": "Messages exchanged over the stim-server WebSocket, protocol version 1.",
-  "x-stim-protocol": 1,
+  "description": "Messages exchanged over the stim-server WebSocket, protocol version 2.",
+  "x-stim-protocol": 2,
   "$defs": {
     "ProtocolError": {
       "type": "object",
@@ -17,8 +17,7 @@
             "unauthorized",
             "pairing-expired",
             "protocol-unsupported",
-            "approval-pending",
-            "identity-unavailable",
+            "unknown-secret",
             "bad-request",
             "unknown-method",
             "already-authenticated",
@@ -1124,16 +1123,12 @@
     },
     "HelloParams": {
       "type": "object",
+      "description": "The first request, sent encrypted after the Noise handshake on a network connection, or in the clear on the local Unix socket.",
       "required": [
-        "protocol",
-        "client",
-        "auth"
+        "client"
       ],
       "additionalProperties": false,
       "properties": {
-        "protocol": {
-          "type": "integer"
-        },
         "client": {
           "type": "object",
           "required": [
@@ -1153,64 +1148,14 @@
             }
           }
         },
-        "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
         }
       }
     },
@@ -1276,6 +1221,12 @@
             },
             "home": {
               "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "port": {
+              "type": "integer"
             }
           }
         },
@@ -1315,10 +1266,20 @@
               "hosted-ios-process",
               "native-xcode-build",
               "native-xcode-toolchain",
+              "build-artifact-cache",
               "native-gradle-build",
               "hosted-android-data",
               "hosted-android-process",
-              "server-update"
+              "server-update",
+              "status-views",
+              "desktop-reports",
+              "desktop-report-platform",
+              "desktop-settings",
+              "desktop-settings-write",
+              "desktop-full-logs",
+              "desktop-doctor-run",
+              "desktop-stop",
+              "desktop-reload"
             ]
           }
         },
@@ -1347,27 +1308,38 @@
             }
           }
         },
-        "deviceToken": {
-          "type": "string"
-        },
-        "approval": {
+        "desktopBootstrap": {
           "type": "object",
           "required": [
-            "state",
-            "expiresAt"
+            "nonce",
+            "proof"
           ],
           "additionalProperties": false,
           "properties": {
-            "state": {
-              "const": "pending"
+            "nonce": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_-]{43}$"
             },
-            "expiresAt": {
-              "type": "string"
+            "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.",
@@ -1393,6 +1365,49 @@
         }
       }
     },
+    "DesktopLogFilter": {
+      "type": "object",
+      "required": [
+        "workspace"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "workspace": {
+          "type": "string"
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "enum": [
+              "metro",
+              "client",
+              "device",
+              "build",
+              "agent",
+              "maintenance",
+              "placement"
+            ]
+          }
+        },
+        "level": {
+          "enum": [
+            "debug",
+            "info",
+            "warn",
+            "error",
+            "fatal"
+          ]
+        },
+        "grep": {
+          "type": "string",
+          "pattern": "^[^\\u0000]*$"
+        },
+        "errors": {
+          "type": "boolean"
+        }
+      }
+    },
     "LogFilter": {
       "type": "object",
       "oneOf": [
@@ -2094,6 +2109,71 @@
         }
       }
     },
+    "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": [
@@ -2129,7 +2209,7 @@
             "array",
             "null"
           ],
-          "description": "`remoteMachines` from `stim doctor --json --platform ios`.",
+          "description": "`remoteMachines` from `stim doctor --json`.",
           "items": {
             "type": "object"
           }
@@ -2145,7 +2225,7 @@
         },
         "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": [
@@ -3777,7 +3857,8 @@
           "type": "object",
           "required": [
             "id",
-            "method"
+            "method",
+            "params"
           ],
           "additionalProperties": false,
           "properties": {
@@ -3788,11 +3869,20 @@
               ]
             },
             "method": {
-              "const": "route.setup"
+              "const": "desktop.authenticate"
             },
             "params": {
               "type": "object",
-              "maxProperties": 0
+              "required": [
+                "proof"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "proof": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_-]{43}$"
+                }
+              }
             }
           }
         },
@@ -3811,7 +3901,7 @@
               ]
             },
             "method": {
-              "const": "status.subscribe"
+              "const": "route.setup"
             },
             "params": {
               "type": "object",
@@ -3835,10 +3925,10 @@
               ]
             },
             "method": {
-              "const": "logs.query"
+              "const": "desktop.reports.get"
             },
             "params": {
-              "$ref": "#/$defs/LogFilter"
+              "$ref": "#/$defs/DesktopReportTarget"
             }
           }
         },
@@ -3858,10 +3948,10 @@
               ]
             },
             "method": {
-              "const": "logs.subscribe"
+              "const": "desktop.reports.subscribe"
             },
             "params": {
-              "$ref": "#/$defs/LogFilter"
+              "$ref": "#/$defs/DesktopReportTarget"
             }
           }
         },
@@ -3869,8 +3959,7 @@
           "type": "object",
           "required": [
             "id",
-            "method",
-            "params"
+            "method"
           ],
           "additionalProperties": false,
           "properties": {
@@ -3881,10 +3970,11 @@
               ]
             },
             "method": {
-              "const": "frames.subscribe"
+              "const": "desktop.reports.invalidate"
             },
             "params": {
-              "$ref": "#/$defs/FrameTarget"
+              "type": "object",
+              "maxProperties": 0
             }
           }
         },
@@ -3904,17 +3994,19 @@
               ]
             },
             "method": {
-              "const": "frames.keyframe"
+              "const": "desktop.settings.get"
             },
             "params": {
               "type": "object",
               "required": [
-                "subscription"
+                "cwd"
               ],
               "additionalProperties": false,
               "properties": {
-                "subscription": {
-                  "type": "string"
+                "cwd": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096
                 }
               }
             }
@@ -3936,32 +4028,79 @@
               ]
             },
             "method": {
-              "const": "frames.seek"
+              "const": "desktop.settings.write"
             },
             "params": {
-              "type": "object",
-              "required": [
-                "subscription",
-                "at",
-                "rate"
-              ],
-              "additionalProperties": false,
-              "properties": {
-                "subscription": {
-                  "type": "string"
-                },
-                "at": {
-                  "type": "number",
-                  "description": "Epoch milliseconds on the Mac clock."
+              "oneOf": [
+                {
+                  "type": "object",
+                  "required": [
+                    "cwd",
+                    "action",
+                    "key",
+                    "value"
+                  ],
+                  "additionalProperties": false,
+                  "properties": {
+                    "cwd": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 4096
+                    },
+                    "action": {
+                      "const": "set"
+                    },
+                    "key": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "scope": {
+                      "enum": [
+                        "machine",
+                        "workspace",
+                        "repo",
+                        "committed"
+                      ]
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  }
                 },
-                "rate": {
-                  "enum": [
-                    0,
-                    1,
-                    2
-                  ]
+                {
+                  "type": "object",
+                  "required": [
+                    "cwd",
+                    "action",
+                    "key"
+                  ],
+                  "additionalProperties": false,
+                  "properties": {
+                    "cwd": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 4096
+                    },
+                    "action": {
+                      "const": "unset"
+                    },
+                    "key": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "scope": {
+                      "enum": [
+                        "machine",
+                        "workspace",
+                        "repo",
+                        "committed"
+                      ]
+                    }
+                  }
                 }
-              }
+              ]
             }
           }
         },
@@ -3981,12 +4120,522 @@
               ]
             },
             "method": {
-              "const": "frames.live"
+              "const": "desktop.logs.subscribe"
             },
             "params": {
-              "type": "object",
-              "required": [
-                "subscription"
+              "$ref": "#/$defs/DesktopLogFilter"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "desktop.doctor.run"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "cwd"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "cwd": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096
+                },
+                "platform": {
+                  "enum": [
+                    "ios",
+                    "android"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "desktop.stop.subscribe"
+            },
+            "params": {
+              "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__"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "desktop.reload.subscribe"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "cwd"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "cwd": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096
+                },
+                "platform": {
+                  "enum": [
+                    "ios",
+                    "android",
+                    "web"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "status.subscribe"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "workspaces.subscribe"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "workspace.subscribe"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "workspace"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "workspace": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "machine.subscribe"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "builds.history"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "workspace"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "workspace": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "archived.list"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "before": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "limit": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 50
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "worktrees.list"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "maintenance.get"
+            },
+            "params": {
+              "type": "object",
+              "maxProperties": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "logs.query"
+            },
+            "params": {
+              "$ref": "#/$defs/LogFilter"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "logs.subscribe"
+            },
+            "params": {
+              "$ref": "#/$defs/LogFilter"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "frames.subscribe"
+            },
+            "params": {
+              "$ref": "#/$defs/FrameTarget"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "frames.keyframe"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "subscription"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "subscription": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "frames.seek"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "subscription",
+                "at",
+                "rate"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "subscription": {
+                  "type": "string"
+                },
+                "at": {
+                  "type": "number",
+                  "description": "Epoch milliseconds on the machine clock."
+                },
+                "rate": {
+                  "enum": [
+                    0,
+                    1,
+                    2
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "frames.live"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "subscription"
               ],
               "additionalProperties": false,
               "properties": {
@@ -4150,7 +4799,7 @@
                 },
                 "at": {
                   "type": "number",
-                  "description": "Epoch milliseconds on the Mac clock."
+                  "description": "Epoch milliseconds on the machine clock."
                 }
               }
             }
@@ -5236,6 +5885,26 @@
                     "xcode",
                     "gradle"
                   ]
+                },
+                "artifact": {
+                  "type": "object",
+                  "required": [
+                    "fingerprint",
+                    "cacheKey"
+                  ],
+                  "additionalProperties": false,
+                  "properties": {
+                    "fingerprint": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "cacheKey": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 1024
+                    }
+                  }
                 }
               }
             }
@@ -5705,6 +6374,60 @@
             }
           }
         },
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "method",
+            "params"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "integer",
+                "string"
+              ]
+            },
+            "method": {
+              "const": "build.cached-artifact"
+            },
+            "params": {
+              "type": "object",
+              "required": [
+                "repo",
+                "artifact"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "repo": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$"
+                },
+                "artifact": {
+                  "type": "object",
+                  "required": [
+                    "fingerprint",
+                    "cacheKey"
+                  ],
+                  "additionalProperties": false,
+                  "properties": {
+                    "fingerprint": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "cacheKey": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 1024
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         {
           "type": "object",
           "required": [
@@ -6061,6 +6784,9 @@
                 {
                   "$ref": "#/$defs/HelloResult"
                 },
+                {
+                  "$ref": "#/$defs/DesktopAuthenticateResult"
+                },
                 {
                   "$ref": "#/$defs/ControlBeginResult"
                 },
@@ -6304,6 +7030,94 @@
     },
     "ServerEvent": {
       "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "event",
+            "subscription",
+            "stream",
+            "message"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "event": {
+              "enum": [
+                "desktop-stop-progress",
+                "desktop-reload-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"
+              ]
+            },
+            "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": [
@@ -6466,6 +7280,172 @@
             }
           }
         },
+        {
+          "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": {
+              "type": "object",
+              "required": [
+                "upsert",
+                "remove"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "upsert": {
+                  "type": "array",
+                  "items": {
+                    "type": "object"
+                  },
+                  "description": "Workspace summaries to insert or replace by path."
+                },
+                "remove": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "The paths that are gone."
+                }
+              }
+            },
+            "worktrees": {
+              "type": "object",
+              "required": [
+                "upsert",
+                "remove"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "upsert": {
+                  "type": "array",
+                  "items": {
+                    "type": "object"
+                  },
+                  "description": "Unprovisioned worktree rows to insert or replace by path."
+                },
+                "remove": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "The paths that are gone."
+                }
+              }
+            },
+            "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": [