@band-app/server 0.45.0 → 0.46.0

package/dist/openapi.json

@@ -2105,6 +2105,840 @@
         }
       }
     },
+    "/checkpoints.list": {
+      "get": {
+        "operationId": "checkpoints.list",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoints": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/CheckpointView"
+                              }
+                            },
+                            "warning": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "checkpoints",
+                            "warning"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.take": {
+      "post": {
+        "operationId": "checkpoints.take",
+        "description": "Takes a checkpoint now. Answers `unchanged` when nothing differs from the newest one.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "created"
+                                },
+                                "checkpoint": {
+                                  "$ref": "#/components/schemas/CheckpointView"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "checkpoint"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "unchanged"
+                                },
+                                "checkpoint": {
+                                  "$ref": "#/components/schemas/CheckpointView"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "checkpoint"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "skipped"
+                                },
+                                "reason": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "reason"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "discriminator": {
+                            "propertyName": "status"
+                          }
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "worktreeId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.changes": {
+      "get": {
+        "operationId": "checkpoints.changes",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoint": {
+                              "$ref": "#/components/schemas/CheckpointView"
+                            },
+                            "files": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ChangedFile"
+                              }
+                            }
+                          },
+                          "required": [
+                            "checkpoint",
+                            "files"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.diff": {
+      "get": {
+        "operationId": "checkpoints.diff",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "diff": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "diff"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.files": {
+      "get": {
+        "operationId": "checkpoints.files",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "checkpoint": {
+                              "$ref": "#/components/schemas/CheckpointView"
+                            },
+                            "paths": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "required": [
+                            "checkpoint",
+                            "paths"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.file": {
+      "get": {
+        "operationId": "checkpoints.file",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "path": {
+                              "type": "string"
+                            },
+                            "size": {
+                              "type": "number"
+                            },
+                            "binary": {
+                              "type": "boolean"
+                            },
+                            "truncated": {
+                              "type": "boolean"
+                            },
+                            "content": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "path",
+                            "size",
+                            "binary",
+                            "truncated",
+                            "content"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "checkpointId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "worktreeId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/checkpoints.restore": {
+      "post": {
+        "operationId": "checkpoints.restore",
+        "description": "Restores a worktree on another host from a checkpoint. The old copy is left alone, superseded.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/RestoreResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "toHostId": {
+                    "type": "string"
+                  },
+                  "hostRepoPath": {
+                    "type": "string"
+                  },
+                  "checkpointId": {
+                    "type": "string"
+                  },
+                  "addHost": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "toHostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.move": {
+      "post": {
+        "operationId": "checkpoints.move",
+        "description": "Moves a worktree whose host is online, and removes the source once the target has it.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/RestoreResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "toHostId": {
+                    "type": "string"
+                  },
+                  "hostRepoPath": {
+                    "type": "string"
+                  },
+                  "addHost": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "toHostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/checkpoints.evacuate": {
+      "post": {
+        "operationId": "checkpoints.evacuate",
+        "description": "Moves every worktree on a host to another, one after the other.",
+        "tags": [
+          "checkpoints"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/EvacuateResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "toHostId": {
+                    "type": "string"
+                  },
+                  "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
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
     "/runners.list": {
       "get": {
         "operationId": "runners.list",
@@ -8764,6 +9598,17 @@
                                     ],
                                     "description": "The host whose default-branch checkout is listed as a worktree, once one is known."
                                   },
+                                  "checkpointsEnabled": {
+                                    "type": "boolean",
+                                    "description": "Whether the hub keeps checkpoints of this repo's worktrees (the stored choice, else the default)."
+                                  },
+                                  "checkpointsSetting": {
+                                    "type": [
+                                      "boolean",
+                                      "null"
+                                    ],
+                                    "description": "The stored choice, or null when the repo follows the default."
+                                  },
                                   "avatar": {
                                     "oneOf": [
                                       {
@@ -8811,6 +9656,17 @@
                                           ],
                                           "description": "Set while the worktree's ephemeral worker has exited (`sleeping`) or is coming back (`waking`)."
                                         },
+                                        "supersededBy": {
+                                          "type": "string",
+                                          "description": "Set when this copy was restored on another host. The value is the replacement's worktree id."
+                                        },
+                                        "lastCheckpointAt": {
+                                          "type": [
+                                            "number",
+                                            "null"
+                                          ],
+                                          "description": "When the hub took the newest checkpoint of this worktree, or null when it has none."
+                                        },
                                         "worktreeId": {
                                           "type": "string"
                                         },
@@ -8848,6 +9704,7 @@
                                         "branch",
                                         "path",
                                         "pinned",
+                                        "lastCheckpointAt",
                                         "worktreeId",
                                         "agent",
                                         "origin",
@@ -8868,6 +9725,8 @@
                                   "meta",
                                   "allowedHostIds",
                                   "primaryHostId",
+                                  "checkpointsEnabled",
+                                  "checkpointsSetting",
                                   "avatar",
                                   "worktrees"
                                 ],
@@ -9614,7 +10473,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). Changing the host policy or the checkpoint setting is an admin call.",
         "tags": [
           "repos"
         ],
@@ -9689,6 +10548,12 @@
                       "string",
                       "null"
                     ]
+                  },
+                  "checkpointsEnabled": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -17978,6 +18843,186 @@
         ],
         "additionalProperties": false
       },
+      "CheckpointView": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "worktreeId": {
+            "type": "string"
+          },
+          "hostId": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "baseSha": {
+            "type": "string"
+          },
+          "snapshotSha": {
+            "type": "string"
+          },
+          "dirty": {
+            "type": "boolean",
+            "description": "Whether the working tree differed from the branch head."
+          },
+          "sizeBytes": {
+            "type": "number"
+          },
+          "trigger": {
+            "type": "string",
+            "enum": [
+              "move",
+              "turn",
+              "quiet",
+              "shutdown",
+              "manual"
+            ]
+          },
+          "createdAt": {
+            "type": "number"
+          },
+          "sessions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "id",
+          "worktreeId",
+          "hostId",
+          "branch",
+          "baseSha",
+          "snapshotSha",
+          "dirty",
+          "sizeBytes",
+          "trigger",
+          "createdAt",
+          "sessions"
+        ],
+        "additionalProperties": false
+      },
+      "ChangedFile": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "additions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "deletions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "path",
+          "status",
+          "additions",
+          "deletions"
+        ],
+        "additionalProperties": false
+      },
+      "RestoreResult": {
+        "type": "object",
+        "properties": {
+          "worktreeId": {
+            "type": "string",
+            "description": "The worktree on the target host."
+          },
+          "hostId": {
+            "type": "string"
+          },
+          "supersededId": {
+            "type": "string",
+            "description": "The worktree it replaced, marked superseded. Absent when a move removed it."
+          },
+          "sourceRemoved": {
+            "type": "boolean",
+            "description": "For a move: whether the source worktree was removed."
+          },
+          "warning": {
+            "type": "string",
+            "description": "For a move whose source could not be removed."
+          },
+          "checkpointId": {
+            "type": "string"
+          },
+          "chatIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The chats that now belong to the new worktree."
+          }
+        },
+        "required": [
+          "worktreeId",
+          "hostId",
+          "checkpointId",
+          "chatIds"
+        ],
+        "additionalProperties": false
+      },
+      "EvacuateResult": {
+        "type": "object",
+        "properties": {
+          "fromHostId": {
+            "type": "string"
+          },
+          "toHostId": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "worktreeId": {
+                  "type": "string"
+                },
+                "ok": {
+                  "type": "boolean"
+                },
+                "newWorktreeId": {
+                  "type": "string"
+                },
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "restore",
+                    "move"
+                  ]
+                },
+                "error": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "worktreeId",
+                "ok"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "fromHostId",
+          "toHostId",
+          "results"
+        ],
+        "additionalProperties": false
+      },
       "RunnerRun": {
         "type": "object",
         "properties": {
@@ -19162,9 +20207,9 @@
               "running",
               "cancelled",
               "pending",
+              "skipped",
               "success",
               "failure",
-              "skipped",
               "neutral"
             ],
             "description": "The state of one check or CI job."
@@ -19660,6 +20705,10 @@
           "primaryHostId": {
             "type": "string",
             "description": "The host whose default-branch checkout is listed as a worktree. Read-only here: `setHostPolicy` writes it."
+          },
+          "checkpointsEnabled": {
+            "type": "boolean",
+            "description": "Whether the hub keeps checkpoints of the repo's worktrees; absent means the default. Read-only here: `setCheckpointsEnabled` writes it."
           }
         },
         "required": [
@@ -19702,6 +20751,10 @@
           },
           "origin": {
             "$ref": "#/components/schemas/WorktreeOrigin"
+          },
+          "supersededBy": {
+            "type": "string",
+            "description": "The id of the worktree that replaced this one when it was restored on another host. The copy\nstays on its host untouched. Read-only here: `saveAll` keeps what the database holds, and\n`RepoQueries.setSupersededBy` writes it."
           }
         },
         "required": [