@band-app/server 0.45.0 → 0.47.0

package/dist/openapi.json

@@ -673,6 +673,58 @@
         ]
       }
     },
+    "/hosts.forAgents": {
+      "get": {
+        "operationId": "hosts.forAgents",
+        "description": "The host list as an agent may see it: id, name, status, OS and architecture, agents,\ncapabilities and labels. No roots, home, tool versions, tokens or runner settings. The MCP\nendpoint lists this one and not `hosts.list`.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "hosts": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/AgentHostView"
+                              }
+                            }
+                          },
+                          "required": [
+                            "hosts"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
     "/hosts.browse": {
       "get": {
         "operationId": "hosts.browse",
@@ -2105,11 +2157,11 @@
         }
       }
     },
-    "/runners.list": {
+    "/checkpoints.list": {
       "get": {
-        "operationId": "runners.list",
+        "operationId": "checkpoints.list",
         "tags": [
-          "runners"
+          "checkpoints"
         ],
         "responses": {
           "200": {
@@ -2125,29 +2177,22 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "runs": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/RunnerRun"
-                              }
-                            },
-                            "runners": {
+                            "checkpoints": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/RunnerView"
+                                "$ref": "#/components/schemas/CheckpointView"
                               }
                             },
-                            "errors": {
-                              "type": "array",
-                              "items": {
-                                "type": "string"
-                              }
+                            "warning": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
                             }
                           },
                           "required": [
-                            "runs",
-                            "runners",
-                            "errors"
+                            "checkpoints",
+                            "warning"
                           ],
                           "additionalProperties": false
                         }
@@ -2167,15 +2212,39 @@
           "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
+                }
+              }
+            }
+          }
+        ]
       }
     },
-    "/runners.snapshots": {
-      "get": {
-        "operationId": "runners.snapshots",
-        "description": "The machine snapshots the hub holds, newest first (plan step 3.10).",
+    "/checkpoints.take": {
+      "post": {
+        "operationId": "checkpoints.take",
+        "description": "Takes a checkpoint now. Answers `unchanged` when nothing differs from the newest one.",
         "tags": [
-          "runners"
+          "checkpoints"
         ],
         "responses": {
           "200": {
@@ -2189,69 +2258,62 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "snapshots": {
-                              "type": "array",
-                              "items": {
-                                "type": "object",
-                                "properties": {
-                                  "id": {
-                                    "type": "string"
-                                  },
-                                  "runnerId": {
-                                    "type": "string"
-                                  },
-                                  "hostId": {
-                                    "type": "string"
-                                  },
-                                  "worktreeIds": {
-                                    "type": "array",
-                                    "items": {
-                                      "type": "string"
-                                    }
-                                  },
-                                  "snapshotId": {
-                                    "type": "string"
-                                  },
-                                  "sizeBytes": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "restoredAt": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "createdAt": {
-                                    "type": "number"
-                                  },
-                                  "expiresAt": {
-                                    "type": "number"
-                                  }
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "created"
                                 },
-                                "required": [
-                                  "id",
-                                  "runnerId",
-                                  "hostId",
-                                  "worktreeIds",
-                                  "snapshotId",
-                                  "sizeBytes",
-                                  "restoredAt",
-                                  "createdAt",
-                                  "expiresAt"
-                                ],
-                                "additionalProperties": false
-                              }
+                                "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
                             }
-                          },
-                          "required": [
-                            "snapshots"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "status"
+                          }
                         }
                       },
                       "required": [
@@ -2269,15 +2331,33 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "worktreeId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
         }
       }
     },
-    "/runners.log": {
+    "/checkpoints.changes": {
       "get": {
-        "operationId": "runners.log",
-        "description": "The hook output of a host request, as the hub logged it (tokens removed).",
+        "operationId": "checkpoints.changes",
         "tags": [
-          "runners"
+          "checkpoints"
         ],
         "responses": {
           "200": {
@@ -2293,15 +2373,19 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "log": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
+                            "checkpoint": {
+                              "$ref": "#/components/schemas/CheckpointView"
+                            },
+                            "files": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ChangedFile"
+                              }
                             }
                           },
                           "required": [
-                            "log"
+                            "checkpoint",
+                            "files"
                           ],
                           "additionalProperties": false
                         }
@@ -2333,12 +2417,15 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "requestId": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
                       "type": "string"
                     }
                   },
                   "required": [
-                    "requestId"
+                    "worktreeId"
                   ],
                   "additionalProperties": false
                 }
@@ -2348,12 +2435,11 @@
         ]
       }
     },
-    "/runners.machines": {
+    "/checkpoints.diff": {
       "get": {
-        "operationId": "runners.machines",
-        "description": "The machines the runners started, newest first, with the state the reaper keeps them in.",
+        "operationId": "checkpoints.diff",
         "tags": [
-          "runners"
+          "checkpoints"
         ],
         "responses": {
           "200": {
@@ -2369,11 +2455,1219 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "machines": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/MachineView"
-                              }
+                            "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"
+                  },
+                  "fromHostId": {
+                    "type": "string"
+                  },
+                  "addHost": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "toHostId",
+                  "fromHostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.evacuable": {
+      "get": {
+        "operationId": "checkpoints.evacuable",
+        "description": "The worktrees on a host that an evacuation would take.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "worktrees": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "repo": {
+                                    "type": "string"
+                                  },
+                                  "name": {
+                                    "type": "string"
+                                  },
+                                  "worktreeId": {
+                                    "type": "string"
+                                  }
+                                },
+                                "required": [
+                                  "repo",
+                                  "name",
+                                  "worktreeId"
+                                ],
+                                "additionalProperties": false
+                              }
+                            }
+                          },
+                          "required": [
+                            "worktrees"
+                          ],
+                          "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": {
+                    "hostId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "hostId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/follow.offer": {
+      "get": {
+        "operationId": "follow.offer",
+        "description": "Who could take the work, what will not carry over, or why it cannot continue.",
+        "tags": [
+          "follow"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/ContinueOffer"
+                        }
+                      },
+                      "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"
+                    },
+                    "chatId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/follow.continue": {
+      "post": {
+        "operationId": "follow.continue",
+        "description": "Continues the worktree on `toHostId` (the recommended host when left out) from its latest checkpoint.",
+        "tags": [
+          "follow"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/ContinueResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "chatId": {
+                    "type": "string"
+                  },
+                  "toHostId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "worktreeId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/follow.divergence": {
+      "get": {
+        "operationId": "follow.divergence",
+        "description": "Compares the old copy with the checkpoint the continuation used.",
+        "tags": [
+          "follow"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/DivergenceReport"
+                        }
+                      },
+                      "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
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/follow.divergenceDiff": {
+      "get": {
+        "operationId": "follow.divergenceDiff",
+        "description": "The diff of one file the old copy changed since the checkpoint.",
+        "tags": [
+          "follow"
+        ],
+        "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"
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/follow.bringOver": {
+      "post": {
+        "operationId": "follow.bringOver",
+        "description": "Applies the old copy's newer changes to the new copy as a patch. Conflicts change nothing.",
+        "tags": [
+          "follow"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/BringOverResult"
+                        }
+                      },
+                      "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
+              }
+            }
+          }
+        }
+      }
+    },
+    "/follow.discardOld": {
+      "post": {
+        "operationId": "follow.discardOld",
+        "description": "Removes the old copy and its files. Refused unless `confirm` is true, and for a diverged copy unless `discardChanges` is true too.",
+        "tags": [
+          "follow"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "ok": {
+                              "type": "boolean",
+                              "const": true
+                            }
+                          },
+                          "required": [
+                            "ok"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "confirm": {
+                    "type": "boolean"
+                  },
+                  "discardChanges": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "confirm"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/runners.list": {
+      "get": {
+        "operationId": "runners.list",
+        "tags": [
+          "runners"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "runs": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/RunnerRun"
+                              }
+                            },
+                            "runners": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/RunnerView"
+                              }
+                            },
+                            "errors": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "required": [
+                            "runs",
+                            "runners",
+                            "errors"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/runners.snapshots": {
+      "get": {
+        "operationId": "runners.snapshots",
+        "description": "The machine snapshots the hub holds, newest first (plan step 3.10).",
+        "tags": [
+          "runners"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "snapshots": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "id": {
+                                    "type": "string"
+                                  },
+                                  "runnerId": {
+                                    "type": "string"
+                                  },
+                                  "hostId": {
+                                    "type": "string"
+                                  },
+                                  "worktreeIds": {
+                                    "type": "array",
+                                    "items": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "snapshotId": {
+                                    "type": "string"
+                                  },
+                                  "sizeBytes": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "restoredAt": {
+                                    "type": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "createdAt": {
+                                    "type": "number"
+                                  },
+                                  "expiresAt": {
+                                    "type": "number"
+                                  }
+                                },
+                                "required": [
+                                  "id",
+                                  "runnerId",
+                                  "hostId",
+                                  "worktreeIds",
+                                  "snapshotId",
+                                  "sizeBytes",
+                                  "restoredAt",
+                                  "createdAt",
+                                  "expiresAt"
+                                ],
+                                "additionalProperties": false
+                              }
+                            }
+                          },
+                          "required": [
+                            "snapshots"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/runners.log": {
+      "get": {
+        "operationId": "runners.log",
+        "description": "The hook output of a host request, as the hub logged it (tokens removed).",
+        "tags": [
+          "runners"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "log": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "log"
+                          ],
+                          "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": {
+                    "requestId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "requestId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/runners.machines": {
+      "get": {
+        "operationId": "runners.machines",
+        "description": "The machines the runners started, newest first, with the state the reaper keeps them in.",
+        "tags": [
+          "runners"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "machines": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/MachineView"
+                              }
                             }
                           },
                           "required": [
@@ -8539,6 +9833,9 @@
                           "gui",
                           "tui"
                         ]
+                      },
+                      "crossHostWorktrees": {
+                        "type": "boolean"
                       }
                     },
                     "additionalProperties": {}
@@ -8764,6 +10061,41 @@
                                     ],
                                     "description": "The host whose default-branch checkout is listed as a worktree, once one is known."
                                   },
+                                  "mainMissing": {
+                                    "oneOf": [
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "hostId": {
+                                            "type": "string"
+                                          }
+                                        },
+                                        "required": [
+                                          "hostId"
+                                        ],
+                                        "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ],
+                                    "description": "Set when no host lists a default-branch checkout: the primary host, whose clone is not on it."
+                                  },
+                                  "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."
+                                  },
+                                  "autoContinue": {
+                                    "type": "boolean",
+                                    "description": "Whether a worktree whose host is offline continues on another host without asking."
+                                  },
                                   "avatar": {
                                     "oneOf": [
                                       {
@@ -8811,6 +10143,23 @@
                                           ],
                                           "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."
+                                        },
+                                        "continuedFrom": {
+                                          "$ref": "#/components/schemas/ContinuedFrom"
+                                        },
+                                        "divergence": {
+                                          "$ref": "#/components/schemas/Divergence"
+                                        },
+                                        "lastCheckpointAt": {
+                                          "type": [
+                                            "number",
+                                            "null"
+                                          ],
+                                          "description": "When the hub took the newest checkpoint of this worktree, or null when it has none."
+                                        },
                                         "worktreeId": {
                                           "type": "string"
                                         },
@@ -8848,6 +10197,7 @@
                                         "branch",
                                         "path",
                                         "pinned",
+                                        "lastCheckpointAt",
                                         "worktreeId",
                                         "agent",
                                         "origin",
@@ -8868,6 +10218,10 @@
                                   "meta",
                                   "allowedHostIds",
                                   "primaryHostId",
+                                  "mainMissing",
+                                  "checkpointsEnabled",
+                                  "checkpointsSetting",
+                                  "autoContinue",
                                   "avatar",
                                   "worktrees"
                                 ],
@@ -9037,7 +10391,42 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/RepoState"
+                          "allOf": [
+                            {
+                              "$ref": "#/components/schemas/RepoState"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "existed": {
+                                  "type": "boolean",
+                                  "const": true
+                                },
+                                "clone": {
+                                  "type": "object",
+                                  "properties": {
+                                    "hostId": {
+                                      "type": "string"
+                                    },
+                                    "hostName": {
+                                      "type": "string"
+                                    },
+                                    "path": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "hostId",
+                                    "hostName",
+                                    "path"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              },
+                              "additionalProperties": false
+                            }
+                          ],
+                          "description": "What `addFromWorker` answers: the repo, plus the clone it registered when the repo already existed."
                         }
                       },
                       "required": [
@@ -9614,7 +11003,7 @@
     "/repos.update": {
       "post": {
         "operationId": "repos.update",
-        "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). Changing the host policy is an admin call.",
+        "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) and `autoContinue` (whether a worktree on an offline host continues elsewhere without asking, `null` for off). Changing the host policy, the checkpoint setting or auto-continue is an admin call.",
         "tags": [
           "repos"
         ],
@@ -9689,6 +11078,18 @@
                       "string",
                       "null"
                     ]
+                  },
+                  "checkpointsEnabled": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "autoContinue": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -14934,7 +16335,50 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/result"
+                          "oneOf": [
+                            {
+                              "$ref": "#/components/schemas/result"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "worktreeId": {
+                                  "type": "string"
+                                },
+                                "continued": {
+                                  "$ref": "#/components/schemas/ContinuedFrom"
+                                },
+                                "agentSession": {
+                                  "$ref": "#/components/schemas/AgentSessionRecord"
+                                },
+                                "mode": {
+                                  "type": "string",
+                                  "enum": [
+                                    "gui",
+                                    "tui"
+                                  ],
+                                  "description": "Agent session types shared by the server and the dashboard (issue #682).\n\nAn agent session is one run of a coding agent. Its `mode` says how it is\ndisplayed: `gui` in a chat pane, `tui` as the agent's CLI in a terminal.\nThe mode is fixed for the life of the session."
+                                },
+                                "chatId": {
+                                  "type": "string"
+                                },
+                                "terminalId": {
+                                  "type": "string"
+                                },
+                                "notice": {
+                                  "type": "string",
+                                  "description": "Why the requested mode wasn't used, e.g. an agent without a TUI invocation."
+                                }
+                              },
+                              "required": [
+                                "worktreeId",
+                                "continued",
+                                "agentSession",
+                                "mode"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ]
                         }
                       },
                       "required": [
@@ -17392,31 +18836,90 @@
           "tool": {
             "type": "string"
           },
-          "installed": {
-            "type": "boolean"
+          "installed": {
+            "type": "boolean"
+          },
+          "version": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "loggedIn": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "fix": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "tool",
+          "installed",
+          "version",
+          "loggedIn",
+          "fix"
+        ],
+        "additionalProperties": false
+      },
+      "AgentHostView": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
           },
-          "version": {
+          "os": {
             "type": [
               "string",
               "null"
             ]
           },
-          "loggedIn": {
+          "arch": {
             "type": [
-              "boolean",
+              "string",
               "null"
             ]
           },
-          "fix": {
-            "type": "string"
+          "agents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
-          "tool",
-          "installed",
-          "version",
-          "loggedIn",
-          "fix"
+          "id",
+          "name",
+          "status",
+          "mode",
+          "os",
+          "arch",
+          "agents",
+          "capabilities",
+          "labels"
         ],
         "additionalProperties": false
       },
@@ -17964,17 +19467,492 @@
               }
             ]
           },
-          "issues": {
+          "issues": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EnvironmentIssue"
+            }
+          }
+        },
+        "required": [
+          "source",
+          "environment",
+          "issues"
+        ],
+        "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
+      },
+      "ContinueOffer": {
+        "type": "object",
+        "properties": {
+          "worktreeId": {
+            "type": "string"
+          },
+          "repo": {
+            "type": "string"
+          },
+          "fromHostId": {
+            "type": "string"
+          },
+          "fromHostName": {
+            "type": "string"
+          },
+          "blocked": {
+            "type": "object",
+            "properties": {
+              "reason": {
+                "type": "string",
+                "enum": [
+                  "restricted-to-offline-host",
+                  "checkpoints-off",
+                  "no-checkpoint",
+                  "no-online-host",
+                  "agent-unavailable",
+                  "already-continued",
+                  "not-offline"
+                ]
+              },
+              "message": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "reason",
+              "message"
+            ],
+            "additionalProperties": false,
+            "description": "Set when the work cannot continue, with a message that says why and what to do."
+          },
+          "checkpointId": {
+            "type": "string"
+          },
+          "checkpointAt": {
+            "type": "number"
+          },
+          "checkpointAgeMs": {
+            "type": "number",
+            "description": "Age of the checkpoint in ms, at the time of the offer."
+          },
+          "targets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ContinueTarget"
+            }
+          },
+          "question": {
+            "type": "string",
+            "description": "The message the prompt shows."
+          },
+          "limits": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "What will not carry over."
+          },
+          "willRun": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "What runs on the new copy, such as the repo's setup."
+          },
+          "fresh": {
+            "type": "boolean",
+            "description": "The checkpoint is young enough that the repo would continue without asking, were it set to."
+          }
+        },
+        "required": [
+          "worktreeId",
+          "repo",
+          "fromHostId",
+          "fromHostName",
+          "targets",
+          "question",
+          "limits",
+          "willRun",
+          "fresh"
+        ],
+        "additionalProperties": false
+      },
+      "ContinueTarget": {
+        "type": "object",
+        "properties": {
+          "hostId": {
+            "type": "string"
+          },
+          "hostName": {
+            "type": "string"
+          },
+          "hasClone": {
+            "type": "boolean",
+            "description": "The repo already has a clone on this host."
+          },
+          "agentReady": {
+            "type": "boolean",
+            "description": "The worktree's agent can start on this host."
+          },
+          "agentProblem": {
+            "type": "string",
+            "description": "Why the agent cannot start, when it cannot."
+          },
+          "load": {
+            "type": "number",
+            "description": "Worktrees already on the host, the \"least busy\" measure."
+          },
+          "recommended": {
+            "type": "boolean",
+            "description": "The host the hub would choose."
+          }
+        },
+        "required": [
+          "hostId",
+          "hostName",
+          "hasClone",
+          "agentReady",
+          "load",
+          "recommended"
+        ],
+        "additionalProperties": false
+      },
+      "ContinueResult": {
+        "type": "object",
+        "properties": {
+          "worktreeId": {
+            "type": "string"
+          },
+          "hostId": {
+            "type": "string"
+          },
+          "hostName": {
+            "type": "string"
+          },
+          "continuedFrom": {
+            "$ref": "#/components/schemas/ContinuedFrom"
+          },
+          "chatIds": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/EnvironmentIssue"
+              "type": "string"
             }
           }
         },
         "required": [
-          "source",
-          "environment",
-          "issues"
+          "worktreeId",
+          "hostId",
+          "hostName",
+          "continuedFrom",
+          "chatIds"
+        ],
+        "additionalProperties": false
+      },
+      "ContinuedFrom": {
+        "type": "object",
+        "properties": {
+          "fromHostId": {
+            "type": "string",
+            "description": "The host the work came from, which was offline."
+          },
+          "fromWorktreeId": {
+            "type": "string",
+            "description": "The id of the copy that stays behind, superseded."
+          },
+          "toHostId": {
+            "type": "string",
+            "description": "The host the work continues on."
+          },
+          "checkpointId": {
+            "type": "string",
+            "description": "The checkpoint the new copy was restored from."
+          },
+          "reason": {
+            "type": "string",
+            "enum": [
+              "manual",
+              "auto"
+            ],
+            "description": "Why a worktree was continued: a person accepted the offer, or the repo continues by itself."
+          },
+          "at": {
+            "type": "number",
+            "description": "Epoch ms of the continuation."
+          },
+          "checkpointAt": {
+            "type": "number",
+            "description": "Epoch ms of the checkpoint, so the UI can say how old the work was."
+          }
+        },
+        "required": [
+          "fromHostId",
+          "fromWorktreeId",
+          "toHostId",
+          "checkpointId",
+          "reason",
+          "at",
+          "checkpointAt"
+        ],
+        "additionalProperties": false
+      },
+      "DivergenceReport": {
+        "type": "object",
+        "properties": {
+          "worktreeId": {
+            "type": "string"
+          },
+          "replacementId": {
+            "type": "string",
+            "description": "The copy that replaced this one."
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "clean",
+              "diverged",
+              "resolved"
+            ],
+            "description": "What the old host's copy holds once the host is back. `clean` means its files are the ones the\ncheckpoint holds. `diverged` means it has changes the continuation did not carry. `resolved`\nmeans a person brought them over."
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangedFile"
+            }
+          },
+          "hostOnline": {
+            "type": "boolean",
+            "description": "False when the old copy's host is offline, so nothing could be compared."
+          },
+          "checkedAt": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "worktreeId",
+          "replacementId",
+          "state",
+          "files",
+          "hostOnline",
+          "checkedAt"
+        ],
+        "additionalProperties": false
+      },
+      "BringOverResult": {
+        "type": "object",
+        "properties": {
+          "applied": {
+            "type": "boolean"
+          },
+          "files": {
+            "type": "number",
+            "description": "The files the patch changed on the new copy."
+          },
+          "conflicts": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "message"
+              ],
+              "additionalProperties": false
+            },
+            "description": "Set when the patch does not apply cleanly. Nothing was changed."
+          }
+        },
+        "required": [
+          "applied",
+          "files",
+          "conflicts"
         ],
         "additionalProperties": false
       },
@@ -19078,8 +21056,8 @@
             "enum": [
               "unknown",
               "dirty",
-              "draft",
               "clean",
+              "draft",
               "unstable",
               "has_hooks",
               "blocked",
@@ -19162,9 +21140,9 @@
               "running",
               "cancelled",
               "pending",
+              "skipped",
               "success",
               "failure",
-              "skipped",
               "neutral"
             ],
             "description": "The state of one check or CI job."
@@ -19345,6 +21323,10 @@
                   "gui",
                   "tui"
                 ]
+              },
+              "crossHostWorktrees": {
+                "type": "boolean",
+                "description": "Agents on a worker may start worktrees on other hosts. On unless false."
               }
             },
             "additionalProperties": {},
@@ -19574,6 +21556,42 @@
         ],
         "additionalProperties": false
       },
+      "Divergence": {
+        "type": "object",
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "clean",
+              "diverged",
+              "resolved"
+            ],
+            "description": "What the old host's copy holds once the host is back. `clean` means its files are the ones the\ncheckpoint holds. `diverged` means it has changes the continuation did not carry. `resolved`\nmeans a person brought them over."
+          },
+          "checkedAt": {
+            "type": "number",
+            "description": "Epoch ms of the last comparison."
+          },
+          "checkpointId": {
+            "type": "string",
+            "description": "The checkpoint the comparison used."
+          },
+          "files": {
+            "type": "number",
+            "description": "How many files differ. Absent when unknown."
+          },
+          "treeSha": {
+            "type": "string",
+            "description": "The tree of the old copy when it was compared, so a `resolved` verdict holds until the copy changes again."
+          }
+        },
+        "required": [
+          "state",
+          "checkedAt",
+          "checkpointId"
+        ],
+        "additionalProperties": false
+      },
       "WorktreeOriginInfo": {
         "type": "object",
         "properties": {
@@ -19660,6 +21678,14 @@
           "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."
+          },
+          "autoContinue": {
+            "type": "boolean",
+            "description": "Whether an offline host's worktrees continue elsewhere without asking. Read-only here: `setAutoContinue` writes it."
           }
         },
         "required": [
@@ -19702,6 +21728,16 @@
           },
           "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."
+          },
+          "continuedFrom": {
+            "$ref": "#/components/schemas/ContinuedFrom"
+          },
+          "divergence": {
+            "$ref": "#/components/schemas/Divergence"
           }
         },
         "required": [
@@ -21401,6 +23437,30 @@
           "httpStatus"
         ],
         "additionalProperties": false
+      },
+      "HostOfflineAnswer": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "enum": [
+              "HOST_OFFLINE",
+              "CONTINUE_NOT_POSSIBLE"
+            ]
+          },
+          "error": {
+            "type": "string"
+          },
+          "offer": {
+            "$ref": "#/components/schemas/ContinueOffer"
+          }
+        },
+        "required": [
+          "code",
+          "error",
+          "offer"
+        ],
+        "additionalProperties": false
       }
     },
     "responses": {
@@ -21504,6 +23564,91 @@
                         "code"
                       ],
                       "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "hostOffline": {
+                              "$ref": "#/components/schemas/HostOfflineAnswer"
+                            },
+                            "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": [
+                            "hostOffline",
+                            "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
                     }
                   ]
                 }