@band-app/server 0.46.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",
@@ -2939,11 +2991,12 @@
         ]
       }
     },
-    "/runners.list": {
+    "/follow.offer": {
       "get": {
-        "operationId": "runners.list",
+        "operationId": "follow.offer",
+        "description": "Who could take the work, what will not carry over, or why it cannot continue.",
         "tags": [
-          "runners"
+          "follow"
         ],
         "responses": {
           "200": {
@@ -2957,33 +3010,7 @@
                       "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
+                          "$ref": "#/components/schemas/ContinueOffer"
                         }
                       },
                       "required": [
@@ -3001,15 +3028,42 @@
           "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
+                }
+              }
+            }
+          }
+        ]
       }
     },
-    "/runners.snapshots": {
-      "get": {
-        "operationId": "runners.snapshots",
-        "description": "The machine snapshots the hub holds, newest first (plan step 3.10).",
+    "/follow.continue": {
+      "post": {
+        "operationId": "follow.continue",
+        "description": "Continues the worktree on `toHostId` (the recommended host when left out) from its latest checkpoint.",
         "tags": [
-          "runners"
+          "follow"
         ],
         "responses": {
           "200": {
@@ -3023,69 +3077,7 @@
                       "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
+                          "$ref": "#/components/schemas/ContinueResult"
                         }
                       },
                       "required": [
@@ -3103,15 +3095,40 @@
           "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
+              }
+            }
+          }
         }
       }
     },
-    "/runners.log": {
+    "/follow.divergence": {
       "get": {
-        "operationId": "runners.log",
-        "description": "The hook output of a host request, as the hub logged it (tokens removed).",
+        "operationId": "follow.divergence",
+        "description": "Compares the old copy with the checkpoint the continuation used.",
         "tags": [
-          "runners"
+          "follow"
         ],
         "responses": {
           "200": {
@@ -3125,19 +3142,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "log": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            }
-                          },
-                          "required": [
-                            "log"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/DivergenceReport"
                         }
                       },
                       "required": [
@@ -3167,12 +3172,12 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "requestId": {
+                    "worktreeId": {
                       "type": "string"
                     }
                   },
                   "required": [
-                    "requestId"
+                    "worktreeId"
                   ],
                   "additionalProperties": false
                 }
@@ -3182,12 +3187,12 @@
         ]
       }
     },
-    "/runners.machines": {
+    "/follow.divergenceDiff": {
       "get": {
-        "operationId": "runners.machines",
-        "description": "The machines the runners started, newest first, with the state the reaper keeps them in.",
+        "operationId": "follow.divergenceDiff",
+        "description": "The diff of one file the old copy changed since the checkpoint.",
         "tags": [
-          "runners"
+          "follow"
         ],
         "responses": {
           "200": {
@@ -3203,15 +3208,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "machines": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/MachineView"
-                              }
+                            "diff": {
+                              "type": "string"
                             }
                           },
                           "required": [
-                            "machines"
+                            "diff"
                           ],
                           "additionalProperties": false
                         }
@@ -3231,25 +3233,483 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
-        }
-      }
-    },
-    "/runners.destroyMachine": {
-      "post": {
-        "operationId": "runners.destroyMachine",
-        "description": "Destroys a machine now. A machine holding worktrees that are not stored is refused unless\n`force` is set.",
-        "tags": [
-          "runners"
-        ],
-        "responses": {
-          "200": {
-            "description": "Successful response",
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "result": {
+                    "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": [
+                            "machines"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/runners.destroyMachine": {
+      "post": {
+        "operationId": "runners.destroyMachine",
+        "description": "Destroys a machine now. A machine holding worktrees that are not stored is refused unless\n`force` is set.",
+        "tags": [
+          "runners"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
                       "type": "object",
                       "properties": {
                         "data": {
@@ -9373,6 +9833,9 @@
                           "gui",
                           "tui"
                         ]
+                      },
+                      "crossHostWorktrees": {
+                        "type": "boolean"
                       }
                     },
                     "additionalProperties": {}
@@ -9598,6 +10061,26 @@
                                     ],
                                     "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)."
@@ -9609,6 +10092,10 @@
                                     ],
                                     "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": [
                                       {
@@ -9660,6 +10147,12 @@
                                           "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",
@@ -9725,8 +10218,10 @@
                                   "meta",
                                   "allowedHostIds",
                                   "primaryHostId",
+                                  "mainMissing",
                                   "checkpointsEnabled",
                                   "checkpointsSetting",
+                                  "autoContinue",
                                   "avatar",
                                   "worktrees"
                                 ],
@@ -9896,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": [
@@ -10473,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) and `checkpointsEnabled` (whether the hub keeps checkpoints, `null` for the default). Changing the host policy or the checkpoint setting 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"
         ],
@@ -10554,6 +11084,12 @@
                       "boolean",
                       "null"
                     ]
+                  },
+                  "autoContinue": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -15799,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": [
@@ -18272,16 +18851,75 @@
               "null"
             ]
           },
-          "fix": {
-            "type": "string"
+          "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"
+          },
+          "os": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "arch": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "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
       },
@@ -18889,137 +19527,432 @@
           }
         },
         "required": [
-          "id",
+          "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": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
           "worktreeId",
           "hostId",
-          "branch",
-          "baseSha",
-          "snapshotSha",
-          "dirty",
-          "sizeBytes",
-          "trigger",
-          "createdAt",
-          "sessions"
+          "hostName",
+          "continuedFrom",
+          "chatIds"
         ],
         "additionalProperties": false
       },
-      "ChangedFile": {
+      "ContinuedFrom": {
         "type": "object",
         "properties": {
-          "path": {
-            "type": "string"
+          "fromHostId": {
+            "type": "string",
+            "description": "The host the work came from, which was offline."
           },
-          "status": {
-            "type": "string"
+          "fromWorktreeId": {
+            "type": "string",
+            "description": "The id of the copy that stays behind, superseded."
           },
-          "additions": {
-            "type": [
-              "number",
-              "null"
-            ]
+          "toHostId": {
+            "type": "string",
+            "description": "The host the work continues on."
           },
-          "deletions": {
-            "type": [
-              "number",
-              "null"
-            ]
+          "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": [
-          "path",
-          "status",
-          "additions",
-          "deletions"
+          "fromHostId",
+          "fromWorktreeId",
+          "toHostId",
+          "checkpointId",
+          "reason",
+          "at",
+          "checkpointAt"
         ],
         "additionalProperties": false
       },
-      "RestoreResult": {
+      "DivergenceReport": {
         "type": "object",
         "properties": {
           "worktreeId": {
-            "type": "string",
-            "description": "The worktree on the target host."
-          },
-          "hostId": {
             "type": "string"
           },
-          "supersededId": {
+          "replacementId": {
             "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."
+            "description": "The copy that replaced this one."
           },
-          "warning": {
+          "state": {
             "type": "string",
-            "description": "For a move whose source could not be removed."
-          },
-          "checkpointId": {
-            "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."
           },
-          "chatIds": {
+          "files": {
             "type": "array",
             "items": {
-              "type": "string"
-            },
-            "description": "The chats that now belong to the new worktree."
+              "$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",
-          "hostId",
-          "checkpointId",
-          "chatIds"
+          "replacementId",
+          "state",
+          "files",
+          "hostOnline",
+          "checkedAt"
         ],
         "additionalProperties": false
       },
-      "EvacuateResult": {
+      "BringOverResult": {
         "type": "object",
         "properties": {
-          "fromHostId": {
-            "type": "string"
+          "applied": {
+            "type": "boolean"
           },
-          "toHostId": {
-            "type": "string"
+          "files": {
+            "type": "number",
+            "description": "The files the patch changed on the new copy."
           },
-          "results": {
+          "conflicts": {
             "type": "array",
             "items": {
               "type": "object",
               "properties": {
-                "worktreeId": {
-                  "type": "string"
-                },
-                "ok": {
-                  "type": "boolean"
-                },
-                "newWorktreeId": {
+                "path": {
                   "type": "string"
                 },
-                "mode": {
-                  "type": "string",
-                  "enum": [
-                    "restore",
-                    "move"
-                  ]
-                },
-                "error": {
+                "message": {
                   "type": "string"
                 }
               },
               "required": [
-                "worktreeId",
-                "ok"
+                "path",
+                "message"
               ],
               "additionalProperties": false
-            }
+            },
+            "description": "Set when the patch does not apply cleanly. Nothing was changed."
           }
         },
         "required": [
-          "fromHostId",
-          "toHostId",
-          "results"
+          "applied",
+          "files",
+          "conflicts"
         ],
         "additionalProperties": false
       },
@@ -20123,8 +21056,8 @@
             "enum": [
               "unknown",
               "dirty",
-              "draft",
               "clean",
+              "draft",
               "unstable",
               "has_hooks",
               "blocked",
@@ -20390,6 +21323,10 @@
                   "gui",
                   "tui"
                 ]
+              },
+              "crossHostWorktrees": {
+                "type": "boolean",
+                "description": "Agents on a worker may start worktrees on other hosts. On unless false."
               }
             },
             "additionalProperties": {},
@@ -20619,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": {
@@ -20709,6 +21682,10 @@
           "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": [
@@ -20755,6 +21732,12 @@
           "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": [
@@ -22454,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": {
@@ -22557,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
                     }
                   ]
                 }