@band-app/server 0.44.0 → 0.46.0

package/dist/openapi.json

@@ -1202,6 +1202,12 @@
                             "request": {
                               "type": "object",
                               "properties": {
+                                "error": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
                                 "status": {
                                   "type": "string",
                                   "enum": [
@@ -1260,12 +1266,6 @@
                                 "createdAt": {
                                   "type": "number"
                                 },
-                                "error": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                },
                                 "leasedBy": {
                                   "type": [
                                     "string",
@@ -1289,6 +1289,7 @@
                                 }
                               },
                               "required": [
+                                "error",
                                 "status",
                                 "id",
                                 "labels",
@@ -1300,7 +1301,6 @@
                                 "requires",
                                 "environment",
                                 "createdAt",
-                                "error",
                                 "leasedBy",
                                 "leaseExpiresAt",
                                 "completedAt",
@@ -1377,6 +1377,12 @@
                                 {
                                   "type": "object",
                                   "properties": {
+                                    "error": {
+                                      "type": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
                                     "status": {
                                       "type": "string",
                                       "enum": [
@@ -1435,12 +1441,6 @@
                                     "createdAt": {
                                       "type": "number"
                                     },
-                                    "error": {
-                                      "type": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
                                     "leasedBy": {
                                       "type": [
                                         "string",
@@ -1464,6 +1464,7 @@
                                     }
                                   },
                                   "required": [
+                                    "error",
                                     "status",
                                     "id",
                                     "labels",
@@ -1475,7 +1476,6 @@
                                     "requires",
                                     "environment",
                                     "createdAt",
-                                    "error",
                                     "leasedBy",
                                     "leaseExpiresAt",
                                     "completedAt",
@@ -1587,6 +1587,12 @@
                             "request": {
                               "type": "object",
                               "properties": {
+                                "error": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
                                 "status": {
                                   "type": "string",
                                   "enum": [
@@ -1645,12 +1651,6 @@
                                 "createdAt": {
                                   "type": "number"
                                 },
-                                "error": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                },
                                 "leasedBy": {
                                   "type": [
                                     "string",
@@ -1674,6 +1674,7 @@
                                 }
                               },
                               "required": [
+                                "error",
                                 "status",
                                 "id",
                                 "labels",
@@ -1685,7 +1686,6 @@
                                 "requires",
                                 "environment",
                                 "createdAt",
-                                "error",
                                 "leasedBy",
                                 "leaseExpiresAt",
                                 "completedAt",
@@ -1767,6 +1767,12 @@
                             "request": {
                               "type": "object",
                               "properties": {
+                                "error": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
                                 "status": {
                                   "type": "string",
                                   "enum": [
@@ -1825,12 +1831,190 @@
                                 "createdAt": {
                                   "type": "number"
                                 },
+                                "leasedBy": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "leaseExpiresAt": {
+                                  "type": [
+                                    "number",
+                                    "null"
+                                  ]
+                                },
+                                "completedAt": {
+                                  "type": [
+                                    "number",
+                                    "null"
+                                  ]
+                                },
+                                "updatedAt": {
+                                  "type": "number"
+                                }
+                              },
+                              "required": [
+                                "error",
+                                "status",
+                                "id",
+                                "labels",
+                                "hostId",
+                                "input",
+                                "worktreeId",
+                                "repo",
+                                "branch",
+                                "requires",
+                                "environment",
+                                "createdAt",
+                                "leasedBy",
+                                "leaseExpiresAt",
+                                "completedAt",
+                                "updatedAt"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "required": [
+                            "request"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostId": {
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "type": "string"
+                  },
+                  "runnerId": {
+                    "type": "string"
+                  },
+                  "hostRepoPath": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "hostId",
+                  "requestId",
+                  "runnerId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/hostRequests.fail": {
+      "post": {
+        "operationId": "hostRequests.fail",
+        "tags": [
+          "hostRequests"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "request": {
+                              "type": "object",
+                              "properties": {
                                 "error": {
                                   "type": [
                                     "string",
                                     "null"
                                   ]
                                 },
+                                "status": {
+                                  "type": "string",
+                                  "enum": [
+                                    "failed",
+                                    "cancelled",
+                                    "pending",
+                                    "leased",
+                                    "fulfilled"
+                                  ]
+                                },
+                                "id": {
+                                  "type": "string"
+                                },
+                                "labels": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "string"
+                                  }
+                                },
+                                "hostId": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "input": {
+                                  "type": "object",
+                                  "additionalProperties": {}
+                                },
+                                "worktreeId": {
+                                  "type": "string"
+                                },
+                                "repo": {
+                                  "type": "string"
+                                },
+                                "branch": {
+                                  "type": "string"
+                                },
+                                "requires": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "string"
+                                  }
+                                },
+                                "environment": {
+                                  "oneOf": [
+                                    {
+                                      "type": "object",
+                                      "additionalProperties": {}
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "createdAt": {
+                                  "type": "number"
+                                },
                                 "leasedBy": {
                                   "type": [
                                     "string",
@@ -1854,6 +2038,7 @@
                                 }
                               },
                               "required": [
+                                "error",
                                 "status",
                                 "id",
                                 "labels",
@@ -1865,7 +2050,6 @@
                                 "requires",
                                 "environment",
                                 "createdAt",
-                                "error",
                                 "leasedBy",
                                 "leaseExpiresAt",
                                 "completedAt",
@@ -1903,23 +2087,757 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "hostId": {
-                    "type": "string"
-                  },
-                  "requestId": {
+                  "requestId": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "requestId",
+                  "reason"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.list": {
+      "get": {
+        "operationId": "checkpoints.list",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoints": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/CheckpointView"
+                              }
+                            },
+                            "warning": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "checkpoints",
+                            "warning"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.take": {
+      "post": {
+        "operationId": "checkpoints.take",
+        "description": "Takes a checkpoint now. Answers `unchanged` when nothing differs from the newest one.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "created"
+                                },
+                                "checkpoint": {
+                                  "$ref": "#/components/schemas/CheckpointView"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "checkpoint"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "unchanged"
+                                },
+                                "checkpoint": {
+                                  "$ref": "#/components/schemas/CheckpointView"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "checkpoint"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "skipped"
+                                },
+                                "reason": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "reason"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "discriminator": {
+                            "propertyName": "status"
+                          }
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "worktreeId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.changes": {
+      "get": {
+        "operationId": "checkpoints.changes",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoint": {
+                              "$ref": "#/components/schemas/CheckpointView"
+                            },
+                            "files": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ChangedFile"
+                              }
+                            }
+                          },
+                          "required": [
+                            "checkpoint",
+                            "files"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.diff": {
+      "get": {
+        "operationId": "checkpoints.diff",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "diff": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "diff"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.files": {
+      "get": {
+        "operationId": "checkpoints.files",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoint": {
+                              "$ref": "#/components/schemas/CheckpointView"
+                            },
+                            "paths": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "required": [
+                            "checkpoint",
+                            "paths"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.file": {
+      "get": {
+        "operationId": "checkpoints.file",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "path": {
+                              "type": "string"
+                            },
+                            "size": {
+                              "type": "number"
+                            },
+                            "binary": {
+                              "type": "boolean"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            },
+                            "content": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "path",
+                            "size",
+                            "binary",
+                            "truncated",
+                            "content"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.restore": {
+      "post": {
+        "operationId": "checkpoints.restore",
+        "description": "Restores a worktree on another host from a checkpoint. The old copy is left alone, superseded.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/RestoreResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "toHostId": {
+                    "type": "string"
+                  },
+                  "hostRepoPath": {
+                    "type": "string"
+                  },
+                  "checkpointId": {
+                    "type": "string"
+                  },
+                  "addHost": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "toHostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.move": {
+      "post": {
+        "operationId": "checkpoints.move",
+        "description": "Moves a worktree whose host is online, and removes the source once the target has it.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/RestoreResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "toHostId": {
+                    "type": "string"
+                  },
+                  "hostRepoPath": {
+                    "type": "string"
+                  },
+                  "addHost": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "toHostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.evacuate": {
+      "post": {
+        "operationId": "checkpoints.evacuate",
+        "description": "Moves every worktree on a host to another, one after the other.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/EvacuateResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "toHostId": {
                     "type": "string"
                   },
-                  "runnerId": {
+                  "fromHostId": {
                     "type": "string"
                   },
-                  "hostRepoPath": {
-                    "type": "string"
+                  "addHost": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
-                  "hostId",
-                  "requestId",
-                  "runnerId"
+                  "toHostId",
+                  "fromHostId"
                 ],
                 "additionalProperties": false
               }
@@ -1928,11 +2846,12 @@
         }
       }
     },
-    "/hostRequests.fail": {
-      "post": {
-        "operationId": "hostRequests.fail",
+    "/checkpoints.evacuable": {
+      "get": {
+        "operationId": "checkpoints.evacuable",
+        "description": "The worktrees on a host that an evacuation would take.",
         "tags": [
-          "hostRequests"
+          "checkpoints"
         ],
         "responses": {
           "200": {
@@ -1948,118 +2867,32 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "request": {
-                              "type": "object",
-                              "properties": {
-                                "status": {
-                                  "type": "string",
-                                  "enum": [
-                                    "failed",
-                                    "cancelled",
-                                    "pending",
-                                    "leased",
-                                    "fulfilled"
-                                  ]
-                                },
-                                "id": {
-                                  "type": "string"
-                                },
-                                "labels": {
-                                  "type": "object",
-                                  "additionalProperties": {
+                            "worktrees": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "repo": {
                                     "type": "string"
-                                  }
-                                },
-                                "hostId": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                },
-                                "input": {
-                                  "type": "object",
-                                  "additionalProperties": {}
-                                },
-                                "worktreeId": {
-                                  "type": "string"
-                                },
-                                "repo": {
-                                  "type": "string"
-                                },
-                                "branch": {
-                                  "type": "string"
-                                },
-                                "requires": {
-                                  "type": "object",
-                                  "additionalProperties": {
+                                  },
+                                  "name": {
+                                    "type": "string"
+                                  },
+                                  "worktreeId": {
                                     "type": "string"
                                   }
                                 },
-                                "environment": {
-                                  "oneOf": [
-                                    {
-                                      "type": "object",
-                                      "additionalProperties": {}
-                                    },
-                                    {
-                                      "type": "null"
-                                    }
-                                  ]
-                                },
-                                "createdAt": {
-                                  "type": "number"
-                                },
-                                "error": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                },
-                                "leasedBy": {
-                                  "type": [
-                                    "string",
-                                    "null"
-                                  ]
-                                },
-                                "leaseExpiresAt": {
-                                  "type": [
-                                    "number",
-                                    "null"
-                                  ]
-                                },
-                                "completedAt": {
-                                  "type": [
-                                    "number",
-                                    "null"
-                                  ]
-                                },
-                                "updatedAt": {
-                                  "type": "number"
-                                }
-                              },
-                              "required": [
-                                "status",
-                                "id",
-                                "labels",
-                                "hostId",
-                                "input",
-                                "worktreeId",
-                                "repo",
-                                "branch",
-                                "requires",
-                                "environment",
-                                "createdAt",
-                                "error",
-                                "leasedBy",
-                                "leaseExpiresAt",
-                                "completedAt",
-                                "updatedAt"
-                              ],
-                              "additionalProperties": false
+                                "required": [
+                                  "repo",
+                                  "name",
+                                  "worktreeId"
+                                ],
+                                "additionalProperties": false
+                              }
                             }
                           },
                           "required": [
-                            "request"
+                            "worktrees"
                           ],
                           "additionalProperties": false
                         }
@@ -2080,29 +2913,30 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "requestId": {
-                    "type": "string"
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "hostId": {
+                      "type": "string"
+                    }
                   },
-                  "reason": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "requestId",
-                  "reason"
-                ],
-                "additionalProperties": false
+                  "required": [
+                    "hostId"
+                  ],
+                  "additionalProperties": false
+                }
               }
             }
           }
-        }
+        ]
       }
     },
     "/runners.list": {
@@ -2734,6 +3568,9 @@
                       "type": "string"
                     }
                   },
+                  "hostId": {
+                    "type": "string"
+                  },
                   "ttlMinutes": {
                     "type": "number"
                   }
@@ -4103,6 +4940,12 @@
                               "items": {
                                 "type": "object",
                                 "properties": {
+                                  "error": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
                                   "at": {
                                     "type": "number"
                                   },
@@ -4115,12 +4958,6 @@
                                   "sessionId": {
                                     "type": "string"
                                   },
-                                  "error": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
                                   "server": {
                                     "type": "string"
                                   },
@@ -4129,11 +4966,11 @@
                                   }
                                 },
                                 "required": [
+                                  "error",
                                   "at",
                                   "id",
                                   "ok",
                                   "sessionId",
-                                  "error",
                                   "server",
                                   "tool"
                                 ],
@@ -8740,6 +9577,38 @@
                                     "type": "boolean",
                                     "description": "Whether the repo is a meta repo, where work in other repos is started from."
                                   },
+                                  "allowedHostIds": {
+                                    "oneOf": [
+                                      {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ],
+                                    "description": "The hosts the repo may run on, or null for every host."
+                                  },
+                                  "primaryHostId": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "description": "The host whose default-branch checkout is listed as a worktree, once one is known."
+                                  },
+                                  "checkpointsEnabled": {
+                                    "type": "boolean",
+                                    "description": "Whether the hub keeps checkpoints of this repo's worktrees (the stored choice, else the default)."
+                                  },
+                                  "checkpointsSetting": {
+                                    "type": [
+                                      "boolean",
+                                      "null"
+                                    ],
+                                    "description": "The stored choice, or null when the repo follows the default."
+                                  },
                                   "avatar": {
                                     "oneOf": [
                                       {
@@ -8775,6 +9644,10 @@
                                           "type": "string",
                                           "description": "The remote host the worktree lives on. Absent for the hub's own machine."
                                         },
+                                        "hostNotAllowed": {
+                                          "type": "boolean",
+                                          "description": "True when the repo is no longer allowed on this worktree's host. The worktree is kept and still opens."
+                                        },
                                         "lifecycle": {
                                           "type": "string",
                                           "enum": [
@@ -8783,6 +9656,17 @@
                                           ],
                                           "description": "Set while the worktree's ephemeral worker has exited (`sleeping`) or is coming back (`waking`)."
                                         },
+                                        "supersededBy": {
+                                          "type": "string",
+                                          "description": "Set when this copy was restored on another host. The value is the replacement's worktree id."
+                                        },
+                                        "lastCheckpointAt": {
+                                          "type": [
+                                            "number",
+                                            "null"
+                                          ],
+                                          "description": "When the hub took the newest checkpoint of this worktree, or null when it has none."
+                                        },
                                         "worktreeId": {
                                           "type": "string"
                                         },
@@ -8820,6 +9704,7 @@
                                         "branch",
                                         "path",
                                         "pinned",
+                                        "lastCheckpointAt",
                                         "worktreeId",
                                         "agent",
                                         "origin",
@@ -8838,6 +9723,10 @@
                                   "label",
                                   "kind",
                                   "meta",
+                                  "allowedHostIds",
+                                  "primaryHostId",
+                                  "checkpointsEnabled",
+                                  "checkpointsSetting",
                                   "avatar",
                                   "worktrees"
                                 ],
@@ -9042,11 +9931,27 @@
                   "label": {
                     "type": "string"
                   },
-                  "name": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "addRoot": {
+                    "type": "boolean"
+                  },
+                  "allowedHostIds": {
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "primaryHostId": {
                     "type": "string"
-                  },
-                  "addRoot": {
-                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -9114,6 +10019,22 @@
                   "name": {
                     "type": "string"
                   },
+                  "allowedHostIds": {
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "primaryHostId": {
+                    "type": "string"
+                  },
                   "defaultBranch": {
                     "type": "string"
                   }
@@ -9552,7 +10473,7 @@
     "/repos.update": {
       "post": {
         "operationId": "repos.update",
-        "description": "Changes a repo's settings. Only `meta` so far: whether the repo is a meta repo.",
+        "description": "Changes a repo's settings: `meta` (whether it is a meta repo), `allowedHostIds` (the hosts it\nmay run on, `null` for all) and `primaryHostId` (the host that lists its default branch,\n`null` to let the hub pick) and `checkpointsEnabled` (whether the hub keeps checkpoints, `null` for the default). Changing the host policy or the checkpoint setting is an admin call.",
         "tags": [
           "repos"
         ],
@@ -9608,6 +10529,31 @@
                   },
                   "meta": {
                     "type": "boolean"
+                  },
+                  "allowedHostIds": {
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "primaryHostId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "checkpointsEnabled": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -9721,6 +10667,10 @@
                             "path": {
                               "type": "string"
                             },
+                            "hostId": {
+                              "type": "string",
+                              "description": "The host the worktree lives on, once it exists (an omitted `hostId` is resolved here)."
+                            },
                             "via": {
                               "type": "string",
                               "enum": [
@@ -9918,6 +10868,9 @@
                   },
                   "repo": {
                     "type": "string"
+                  },
+                  "hostId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -9993,6 +10946,9 @@
                   },
                   "pinned": {
                     "type": "boolean"
+                  },
+                  "hostId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -10101,6 +11057,9 @@
                   },
                   "repo": {
                     "type": "string"
+                  },
+                  "hostId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -10208,6 +11167,9 @@
                   },
                   "repo": {
                     "type": "string"
+                  },
+                  "hostId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -17881,6 +18843,186 @@
         ],
         "additionalProperties": false
       },
+      "CheckpointView": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "worktreeId": {
+            "type": "string"
+          },
+          "hostId": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "baseSha": {
+            "type": "string"
+          },
+          "snapshotSha": {
+            "type": "string"
+          },
+          "dirty": {
+            "type": "boolean",
+            "description": "Whether the working tree differed from the branch head."
+          },
+          "sizeBytes": {
+            "type": "number"
+          },
+          "trigger": {
+            "type": "string",
+            "enum": [
+              "move",
+              "turn",
+              "quiet",
+              "shutdown",
+              "manual"
+            ]
+          },
+          "createdAt": {
+            "type": "number"
+          },
+          "sessions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "id",
+          "worktreeId",
+          "hostId",
+          "branch",
+          "baseSha",
+          "snapshotSha",
+          "dirty",
+          "sizeBytes",
+          "trigger",
+          "createdAt",
+          "sessions"
+        ],
+        "additionalProperties": false
+      },
+      "ChangedFile": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "additions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "deletions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "path",
+          "status",
+          "additions",
+          "deletions"
+        ],
+        "additionalProperties": false
+      },
+      "RestoreResult": {
+        "type": "object",
+        "properties": {
+          "worktreeId": {
+            "type": "string",
+            "description": "The worktree on the target host."
+          },
+          "hostId": {
+            "type": "string"
+          },
+          "supersededId": {
+            "type": "string",
+            "description": "The worktree it replaced, marked superseded. Absent when a move removed it."
+          },
+          "sourceRemoved": {
+            "type": "boolean",
+            "description": "For a move: whether the source worktree was removed."
+          },
+          "warning": {
+            "type": "string",
+            "description": "For a move whose source could not be removed."
+          },
+          "checkpointId": {
+            "type": "string"
+          },
+          "chatIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The chats that now belong to the new worktree."
+          }
+        },
+        "required": [
+          "worktreeId",
+          "hostId",
+          "checkpointId",
+          "chatIds"
+        ],
+        "additionalProperties": false
+      },
+      "EvacuateResult": {
+        "type": "object",
+        "properties": {
+          "fromHostId": {
+            "type": "string"
+          },
+          "toHostId": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "worktreeId": {
+                  "type": "string"
+                },
+                "ok": {
+                  "type": "boolean"
+                },
+                "newWorktreeId": {
+                  "type": "string"
+                },
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "restore",
+                    "move"
+                  ]
+                },
+                "error": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "worktreeId",
+                "ok"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "fromHostId",
+          "toHostId",
+          "results"
+        ],
+        "additionalProperties": false
+      },
       "RunnerRun": {
         "type": "object",
         "properties": {
@@ -18979,8 +20121,8 @@
           "mergeState": {
             "type": "string",
             "enum": [
-              "dirty",
               "unknown",
+              "dirty",
               "draft",
               "clean",
               "unstable",
@@ -19065,9 +20207,9 @@
               "running",
               "cancelled",
               "pending",
+              "skipped",
               "success",
               "failure",
-              "skipped",
               "neutral"
             ],
             "description": "The state of one check or CI job."
@@ -19552,6 +20694,21 @@
           "meta": {
             "type": "boolean",
             "description": "Whether the repo is a meta repo. Read-only here: `RepoQueries.setMeta` changes it."
+          },
+          "allowedHostIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The hosts the repo may run on; absent means every host. Read-only here: `setHostPolicy` writes it."
+          },
+          "primaryHostId": {
+            "type": "string",
+            "description": "The host whose default-branch checkout is listed as a worktree. Read-only here: `setHostPolicy` writes it."
+          },
+          "checkpointsEnabled": {
+            "type": "boolean",
+            "description": "Whether the hub keeps checkpoints of the repo's worktrees; absent means the default. Read-only here: `setCheckpointsEnabled` writes it."
           }
         },
         "required": [
@@ -19588,8 +20745,16 @@
             "type": "string",
             "description": "Host the worktree lives on. Absent means `local`."
           },
+          "missing": {
+            "type": "boolean",
+            "description": "Set by a scan of the worktree's host when its folder no longer exists there. Never stored:\nthe next scan sets it again, and `repos.list` passes it on so the UI offers Remove."
+          },
           "origin": {
             "$ref": "#/components/schemas/WorktreeOrigin"
+          },
+          "supersededBy": {
+            "type": "string",
+            "description": "The id of the worktree that replaced this one when it was restored on another host. The copy\nstays on its host untouched. Read-only here: `saveAll` keeps what the database holds, and\n`RepoQueries.setSupersededBy` writes it."
           }
         },
         "required": [
@@ -20293,10 +21458,10 @@
           "status": {
             "type": "string",
             "enum": [
+              "error",
               "running",
               "idle",
-              "stopped",
-              "error"
+              "stopped"
             ],
             "description": "Chat status as persisted in the `state` JSON blob's `status` field.\n\nMirrors the runtime status the chat-service hands the dashboard. Stored\non disk so a server restart can deterministically reset every chat to\n`\"idle\"` (see `resetAllToIdle`)."
           },
@@ -20985,8 +22150,8 @@
           "status": {
             "type": "string",
             "enum": [
-              "idle",
               "error",
+              "idle",
               "loading"
             ],
             "description": "Browser tab status as persisted in the `state` JSON blob's `status` field.\n\nMirrors the runtime status the browser-service hands the dashboard.\nStored on disk so a server restart can deterministically reset every\nbrowser to `\"idle\"` (see `resetAllToIdle`)."
@@ -21300,7 +22465,100 @@
               "type": "object",
               "properties": {
                 "error": {
-                  "$ref": "#/components/schemas/DefaultErrorShape"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/DefaultErrorShape"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "existingWorktreeId": {
+                              "type": "string"
+                            },
+                            "existingHostId": {
+                              "type": "string"
+                            },
+                            "code": {
+                              "type": "string",
+                              "enum": [
+                                "PARSE_ERROR",
+                                "BAD_REQUEST",
+                                "INTERNAL_SERVER_ERROR",
+                                "NOT_IMPLEMENTED",
+                                "BAD_GATEWAY",
+                                "SERVICE_UNAVAILABLE",
+                                "GATEWAY_TIMEOUT",
+                                "UNAUTHORIZED",
+                                "PAYMENT_REQUIRED",
+                                "FORBIDDEN",
+                                "NOT_FOUND",
+                                "METHOD_NOT_SUPPORTED",
+                                "TIMEOUT",
+                                "CONFLICT",
+                                "PRECONDITION_FAILED",
+                                "PAYLOAD_TOO_LARGE",
+                                "UNSUPPORTED_MEDIA_TYPE",
+                                "UNPROCESSABLE_CONTENT",
+                                "PRECONDITION_REQUIRED",
+                                "TOO_MANY_REQUESTS",
+                                "CLIENT_CLOSED_REQUEST"
+                              ]
+                            },
+                            "httpStatus": {
+                              "type": "number"
+                            },
+                            "path": {
+                              "type": "string"
+                            },
+                            "stack": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "existingWorktreeId",
+                            "existingHostId",
+                            "code",
+                            "httpStatus"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "number",
+                          "enum": [
+                            -32700,
+                            -32600,
+                            -32603,
+                            -32001,
+                            -32002,
+                            -32003,
+                            -32004,
+                            -32005,
+                            -32008,
+                            -32009,
+                            -32012,
+                            -32013,
+                            -32015,
+                            -32022,
+                            -32028,
+                            -32029,
+                            -32099
+                          ]
+                        }
+                      },
+                      "required": [
+                        "data",
+                        "message",
+                        "code"
+                      ],
+                      "additionalProperties": false
+                    }
+                  ]
                 }
               },
               "required": [