@band-app/server 0.48.1 → 0.50.0

package/dist/openapi.json

@@ -184,6 +184,66 @@
         }
       }
     },
+    "/accountUsage.list": {
+      "get": {
+        "operationId": "accountUsage.list",
+        "tags": [
+          "accountUsage"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/AccountUsageReport"
+                        }
+                      },
+                      "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": {
+                    "refresh": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
     "/hooks.check": {
       "get": {
         "operationId": "hooks.check",
@@ -4113,9 +4173,10 @@
         }
       }
     },
-    "/tokens.issueWorkerBootstrap": {
+    "/tokens.createUnpairedDevice": {
       "post": {
-        "operationId": "tokens.issueWorkerBootstrap",
+        "operationId": "tokens.createUnpairedDevice",
+        "description": "A device with no token yet. Show its pairing link next (`pairing`).",
         "tags": [
           "tokens"
         ],
@@ -4133,19 +4194,11 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "token": {
-                              "type": "string"
-                            },
-                            "hostId": {
-                              "type": "string"
-                            },
                             "view": {
                               "$ref": "#/components/schemas/TokenView"
                             }
                           },
                           "required": [
-                            "token",
-                            "hostId",
                             "view"
                           ],
                           "additionalProperties": false
@@ -4174,24 +4227,15 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "hostName": {
-                    "type": "string"
-                  },
-                  "labels": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  },
-                  "hostId": {
+                  "label": {
                     "type": "string"
                   },
-                  "ttlMinutes": {
-                    "type": "number"
+                  "admin": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
-                  "hostName"
+                  "label"
                 ],
                 "additionalProperties": false
               }
@@ -4200,9 +4244,10 @@
         }
       }
     },
-    "/tokens.revoke": {
+    "/tokens.pairing": {
       "post": {
-        "operationId": "tokens.revoke",
+        "operationId": "tokens.pairing",
+        "description": "The pairing code of a device: a pending one again, or a new one with `regenerate`. It works\nfor one exchange within 15 minutes. The link is `<address>/?pair=<code>`.",
         "tags": [
           "tokens"
         ],
@@ -4218,16 +4263,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "token": {
-                              "$ref": "#/components/schemas/TokenView"
-                            }
-                          },
-                          "required": [
-                            "token"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/PairingCode"
                         }
                       },
                       "required": [
@@ -4255,6 +4291,9 @@
                 "properties": {
                   "tokenId": {
                     "type": "string"
+                  },
+                  "regenerate": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -4267,11 +4306,12 @@
         }
       }
     },
-    "/vault.list": {
+    "/tokens.pairingAddresses": {
       "get": {
-        "operationId": "vault.list",
+        "operationId": "tokens.pairingAddresses",
+        "description": "The addresses a pairing link may use: `BAND_PUBLIC_URL`, this machine's network interfaces\n(Tailscale, IPv4, IPv6, then bridges) and the custom addresses saved in settings. Read on\nevery call, so Refresh sees a network that changed.",
         "tags": [
-          "vault"
+          "tokens"
         ],
         "responses": {
           "200": {
@@ -4285,27 +4325,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "items": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/VaultItemView"
-                              }
-                            },
-                            "keySource": {
-                              "type": "string",
-                              "enum": [
-                                "env",
-                                "file"
-                              ]
-                            }
-                          },
-                          "required": [
-                            "items",
-                            "keySource"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/PairingAddresses"
                         }
                       },
                       "required": [
@@ -4326,11 +4346,12 @@
         }
       }
     },
-    "/vault.put": {
+    "/tokens.addPairingAddress": {
       "post": {
-        "operationId": "vault.put",
+        "operationId": "tokens.addPairingAddress",
+        "description": "Saves a custom address (an http(s) origin). It is not probed: the hub can't tell what another device reaches.",
         "tags": [
-          "vault"
+          "tokens"
         ],
         "responses": {
           "200": {
@@ -4346,12 +4367,19 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "item": {
-                              "$ref": "#/components/schemas/VaultItemView"
+                            "url": {
+                              "type": "string"
+                            },
+                            "custom": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
                             }
                           },
                           "required": [
-                            "item"
+                            "url",
+                            "custom"
                           ],
                           "additionalProperties": false
                         }
@@ -4379,39 +4407,12 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "value": {
-                    "type": "string"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "kind": {
-                    "type": "string",
-                    "enum": [
-                      "env",
-                      "git",
-                      "api_key"
-                    ]
-                  },
-                  "description": {
-                    "type": "string"
-                  },
-                  "scope": {
-                    "type": "string"
-                  },
-                  "host": {
-                    "type": "string"
-                  },
-                  "pathPattern": {
-                    "type": "string"
-                  },
-                  "username": {
+                  "url": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "value",
-                  "name"
+                  "url"
                 ],
                 "additionalProperties": false
               }
@@ -4420,11 +4421,11 @@
         }
       }
     },
-    "/vault.delete": {
+    "/tokens.removePairingAddress": {
       "post": {
-        "operationId": "vault.delete",
+        "operationId": "tokens.removePairingAddress",
         "tags": [
-          "vault"
+          "tokens"
         ],
         "responses": {
           "200": {
@@ -4440,20 +4441,15 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "removed": {
-                              "type": "boolean",
-                              "const": true
-                            },
-                            "revoked": {
-                              "type": [
-                                "boolean",
-                                "null"
-                              ]
+                            "custom": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
                             }
                           },
                           "required": [
-                            "removed",
-                            "revoked"
+                            "custom"
                           ],
                           "additionalProperties": false
                         }
@@ -4481,12 +4477,12 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "id": {
+                  "url": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "id"
+                  "url"
                 ],
                 "additionalProperties": false
               }
@@ -4495,11 +4491,11 @@
         }
       }
     },
-    "/vault.rotateKey": {
+    "/tokens.issueWorkerBootstrap": {
       "post": {
-        "operationId": "vault.rotateKey",
+        "operationId": "tokens.issueWorkerBootstrap",
         "tags": [
-          "vault"
+          "tokens"
         ],
         "responses": {
           "200": {
@@ -4515,12 +4511,20 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "rotated": {
-                              "type": "number"
+                            "token": {
+                              "type": "string"
+                            },
+                            "hostId": {
+                              "type": "string"
+                            },
+                            "view": {
+                              "$ref": "#/components/schemas/TokenView"
                             }
                           },
                           "required": [
-                            "rotated"
+                            "token",
+                            "hostId",
+                            "view"
                           ],
                           "additionalProperties": false
                         }
@@ -4540,14 +4544,45 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostName": {
+                    "type": "string"
+                  },
+                  "labels": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "hostId": {
+                    "type": "string"
+                  },
+                  "ttlMinutes": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "hostName"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
         }
       }
     },
-    "/vault.startOAuth": {
+    "/tokens.revoke": {
       "post": {
-        "operationId": "vault.startOAuth",
+        "operationId": "tokens.revoke",
         "tags": [
-          "vault"
+          "tokens"
         ],
         "responses": {
           "200": {
@@ -4563,16 +4598,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "flowId": {
-                              "type": "string"
-                            },
-                            "authorizationUrl": {
-                              "type": "string"
+                            "token": {
+                              "$ref": "#/components/schemas/TokenView"
                             }
                           },
                           "required": [
-                            "flowId",
-                            "authorizationUrl"
+                            "token"
                           ],
                           "additionalProperties": false
                         }
@@ -4600,7 +4631,354 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "name": {
+                  "tokenId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "tokenId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vault.list": {
+      "get": {
+        "operationId": "vault.list",
+        "tags": [
+          "vault"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "items": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/VaultItemView"
+                              }
+                            },
+                            "keySource": {
+                              "type": "string",
+                              "enum": [
+                                "env",
+                                "file"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "items",
+                            "keySource"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/vault.put": {
+      "post": {
+        "operationId": "vault.put",
+        "tags": [
+          "vault"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "item": {
+                              "$ref": "#/components/schemas/VaultItemView"
+                            }
+                          },
+                          "required": [
+                            "item"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "value": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "env",
+                      "git",
+                      "api_key"
+                    ]
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "host": {
+                    "type": "string"
+                  },
+                  "pathPattern": {
+                    "type": "string"
+                  },
+                  "username": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "value",
+                  "name"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vault.delete": {
+      "post": {
+        "operationId": "vault.delete",
+        "tags": [
+          "vault"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "removed": {
+                              "type": "boolean",
+                              "const": true
+                            },
+                            "revoked": {
+                              "type": [
+                                "boolean",
+                                "null"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "removed",
+                            "revoked"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/vault.rotateKey": {
+      "post": {
+        "operationId": "vault.rotateKey",
+        "tags": [
+          "vault"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "rotated": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "rotated"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/vault.startOAuth": {
+      "post": {
+        "operationId": "vault.startOAuth",
+        "tags": [
+          "vault"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "flowId": {
+                              "type": "string"
+                            },
+                            "authorizationUrl": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "flowId",
+                            "authorizationUrl"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
                     "type": "string"
                   },
                   "serverUrl": {
@@ -4696,6 +5074,165 @@
         ]
       }
     },
+    "/voice.status": {
+      "get": {
+        "operationId": "voice.status",
+        "tags": [
+          "voice"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/VoiceStatus"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/voice.config": {
+      "get": {
+        "operationId": "voice.config",
+        "tags": [
+          "voice"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/VoiceSettings"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/voice.test": {
+      "post": {
+        "operationId": "voice.test",
+        "tags": [
+          "voice"
+        ],
+        "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
+                            },
+                            "hostId": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "ok",
+                            "hostId"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "model": {
+                    "type": "string"
+                  },
+                  "baseUrl": {
+                    "type": "string"
+                  },
+                  "language": {
+                    "type": "string"
+                  },
+                  "hostId": {
+                    "type": "string"
+                  },
+                  "apiKeyItemId": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/mcp.list": {
       "get": {
         "operationId": "mcp.list",
@@ -4806,6 +5343,9 @@
                   "command": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "hostId": {
                     "type": "string"
                   },
@@ -4851,9 +5391,6 @@
                       ]
                     }
                   },
-                  "enabled": {
-                    "type": "boolean"
-                  },
                   "cwd": {
                     "type": [
                       "string",
@@ -5003,6 +5540,9 @@
                   "command": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "hostId": {
                     "type": "string"
                   },
@@ -5048,9 +5588,6 @@
                       ]
                     }
                   },
-                  "enabled": {
-                    "type": "boolean"
-                  },
                   "cwd": {
                     "type": [
                       "string",
@@ -7831,7 +8368,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -7949,7 +8486,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8033,7 +8570,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8118,7 +8655,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8684,6 +9221,97 @@
         }
       }
     },
+    "/reviews.rerunChecks": {
+      "post": {
+        "operationId": "reviews.rerunChecks",
+        "description": "Run CI jobs of the worktree's branch again.",
+        "tags": [
+          "reviews"
+        ],
+        "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"
+                  },
+                  "targets": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "runId": {
+                          "type": "string"
+                        },
+                        "jobId": {
+                          "type": "string"
+                        },
+                        "failedOnly": {
+                          "type": "boolean"
+                        }
+                      },
+                      "required": [
+                        "runId"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "targets"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/services.health": {
       "get": {
         "operationId": "services.health",
@@ -8813,6 +9441,9 @@
                       "active",
                       "background"
                     ]
+                  },
+                  "clientId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -8825,6 +9456,73 @@
         }
       }
     },
+    "/services.releaseActivity": {
+      "post": {
+        "operationId": "services.releaseActivity",
+        "tags": [
+          "services"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "released": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "released"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "clientId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "clientId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/services.getActivity": {
       "get": {
         "operationId": "services.getActivity",
@@ -8852,11 +9550,21 @@
                                 "active",
                                 "background"
                               ],
-                              "description": "Activity level controls how aggressively we poll git/CI status. The Electron\nmain process drives this via the `services.setActivity` tRPC mutation when\nthe window gains/loses focus or the laptop transitions on/off battery —\nsee `apps/desktop/src/main/services/activity-monitor.ts`. Other clients\n(CLI, web-only deployments) can leave it at the default `\"active\"`."
+                              "description": "How actively a client looks at Band. The branch-status poller picks its cadence from the most active live client."
+                            },
+                            "poller": {
+                              "type": "string",
+                              "enum": [
+                                "idle",
+                                "active",
+                                "background"
+                              ],
+                              "description": "Activity level controls how aggressively we poll git/CI status. Each UI\nreports its own through `services.setActivity` (window focus and power\nstate, see `apps/web/src/lib/activity-reporter.ts`); `clientActivityService`\nkeeps one entry per client, drops one that stops reporting, and the poller\nfollows the most active live client. With no live client the level is\n`\"idle\"`."
                             }
                           },
                           "required": [
-                            "activity"
+                            "activity",
+                            "poller"
                           ],
                           "additionalProperties": false
                         }
@@ -9785,7 +10493,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/Settings"
+                          "$ref": "#/components/schemas/settings"
                         }
                       },
                       "required": [
@@ -10005,6 +10713,30 @@
                     },
                     "additionalProperties": {}
                   },
+                  "voice": {
+                    "type": "object",
+                    "properties": {
+                      "model": {
+                        "type": "string"
+                      },
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "baseUrl": {
+                        "type": "string"
+                      },
+                      "language": {
+                        "type": "string"
+                      },
+                      "hostId": {
+                        "type": "string"
+                      },
+                      "apiKeyItemId": {
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": {}
+                  },
                   "environmentBuilder": {
                     "type": "object",
                     "properties": {
@@ -11645,17 +12377,138 @@
                   "repo": {
                     "type": "string"
                   },
-                  "pinned": {
-                    "type": "boolean"
+                  "pinned": {
+                    "type": "boolean"
+                  },
+                  "hostId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "repo",
+                  "pinned"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/worktrees.reorder": {
+      "post": {
+        "operationId": "worktrees.reorder",
+        "tags": [
+          "worktrees"
+        ],
+        "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": {
+                  "order": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "repo": {
+                          "type": "string"
+                        },
+                        "hostId": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "repo"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "siblings",
+                      "pins"
+                    ]
                   },
-                  "hostId": {
-                    "type": "string"
+                  "reparent": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "repo": {
+                        "type": "string"
+                      },
+                      "origin": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "hostId": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "repo",
+                      "origin"
+                    ],
+                    "additionalProperties": false
                   }
                 },
                 "required": [
-                  "name",
-                  "repo",
-                  "pinned"
+                  "order",
+                  "scope"
                 ],
                 "additionalProperties": false
               }
@@ -12038,6 +12891,76 @@
         }
       }
     },
+    "/worktree.directAccess": {
+      "post": {
+        "operationId": "worktree.directAccess",
+        "description": "A short-lived token for the worker that holds `worktreeId`, when that\nworker is `hostId`, the caller's own machine (the desktop app passes its\nworker's id). Null when the direct path does not apply, and the caller\nkeeps using the hub.",
+        "tags": [
+          "worktree"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "oneOf": [
+                            {
+                              "$ref": "#/components/schemas/DirectAccess"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostId": {
+                    "type": "string"
+                  },
+                  "worktreeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "hostId",
+                  "worktreeId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/worktree.getTerminalConfig": {
       "get": {
         "operationId": "worktree.getTerminalConfig",
@@ -14688,12 +15611,6 @@
                   "prompt": {
                     "type": "string"
                   },
-                  "key": {
-                    "type": "string"
-                  },
-                  "cronExpression": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -14701,6 +15618,15 @@
                       "repo"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
+                  "cronExpression": {
+                    "type": "string"
+                  },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "worktreeId": {
                     "type": "string"
                   },
@@ -14710,17 +15636,14 @@
                       "chat",
                       "terminal"
                     ]
-                  },
-                  "enabled": {
-                    "type": "boolean"
                   }
                 },
                 "required": [
                   "name",
                   "prompt",
+                  "scope",
                   "key",
-                  "cronExpression",
-                  "scope"
+                  "cronExpression"
                 ],
                 "additionalProperties": false
               }
@@ -14791,14 +15714,14 @@
                   "name": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "prompt": {
                     "type": "string"
                   },
                   "cronExpression": {
                     "type": "string"
-                  },
-                  "enabled": {
-                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -18190,9 +19113,6 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "key": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -18201,6 +19121,9 @@
                       "all"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
                   "baseVersion": {
                     "type": "number"
                   },
@@ -18210,8 +19133,8 @@
                   "value": {}
                 },
                 "required": [
-                  "key",
                   "scope",
+                  "key",
                   "baseVersion",
                   "clientId"
                 ],
@@ -18304,9 +19227,6 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "key": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -18315,6 +19235,9 @@
                       "all"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
                   "baseVersion": {
                     "type": "number"
                   },
@@ -18323,8 +19246,8 @@
                   }
                 },
                 "required": [
-                  "key",
                   "scope",
+                  "key",
                   "baseVersion",
                   "clientId"
                 ],
@@ -19037,42 +19960,179 @@
               }
             }
           },
-          "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
-                }
-              }
+          "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
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "AccountUsageReport": {
+        "type": "object",
+        "properties": {
+          "rows": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountUsageRow"
+            }
+          },
+          "problems": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountUsageProblem"
+            }
+          }
+        },
+        "required": [
+          "rows",
+          "problems"
+        ],
+        "additionalProperties": false
+      },
+      "AccountUsageRow": {
+        "type": "object",
+        "properties": {
+          "provider": {
+            "type": "string",
+            "enum": [
+              "claude",
+              "codex"
+            ]
+          },
+          "account": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Email or account id. Null when the login names neither."
+          },
+          "plan": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "windows": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UsageWindow"
+            }
+          },
+          "hosts": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Names of the hosts that hold this login."
+          },
+          "updatedAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "provider",
+          "account",
+          "plan",
+          "windows",
+          "hosts",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "UsageWindow": {
+        "type": "object",
+        "properties": {
+          "label": {
+            "type": "string",
+            "description": "Short label for the bar: `5h`, `wk`, `Fable`."
+          },
+          "percent": {
+            "type": "number",
+            "description": "Share of the window used, 0 to 100."
+          },
+          "resetsAt": {
+            "type": [
+              "number",
+              "null"
+            ],
+            "description": "Epoch ms when the window resets, or null when the provider does not say."
+          }
+        },
+        "required": [
+          "label",
+          "percent",
+          "resetsAt"
+        ],
+        "additionalProperties": false
+      },
+      "AccountUsageProblem": {
+        "type": "object",
+        "properties": {
+          "provider": {
+            "type": "string",
+            "enum": [
+              "claude",
+              "codex"
+            ]
+          },
+          "reason": {
+            "type": "string",
+            "enum": [
+              "error",
+              "offline",
+              "not-logged-in",
+              "expired",
+              "rate-limited"
+            ]
+          },
+          "message": {
+            "type": "string",
+            "description": "A short sentence for the popover, such as \"Not logged in on contabo\"."
+          },
+          "hosts": {
+            "type": "array",
+            "items": {
+              "type": "string"
             }
           }
-        ]
-      }
-    }
-  },
-  "components": {
-    "schemas": {
+        },
+        "required": [
+          "provider",
+          "reason",
+          "message",
+          "hosts"
+        ],
+        "additionalProperties": false
+      },
       "HooksStatus": {
         "type": "object",
         "properties": {
@@ -19959,6 +21019,13 @@
             "type": "string",
             "description": "The worktree it replaced, marked superseded. Absent when a move removed it."
           },
+          "backupRefs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Refs on the target host (`refs/band/backup/<worktree id>/<time>`) that keep what it held under\nthis name before the checkpoint replaced it. Absent when it held nothing."
+          },
           "sourceRemoved": {
             "type": "boolean",
             "description": "For a move: whether the source worktree was removed."
@@ -20061,6 +21128,7 @@
                   "no-checkpoint",
                   "no-online-host",
                   "agent-unavailable",
+                  "lease-active",
                   "already-continued",
                   "not-offline"
                 ]
@@ -20076,6 +21144,14 @@
             "additionalProperties": false,
             "description": "Set when the work cannot continue, with a message that says why and what to do."
           },
+          "leaseExpiresAt": {
+            "type": "number",
+            "description": "Epoch ms when the old host's lease ends. Until then the old copy may still be running, so the\nwork cannot continue elsewhere (`blocked.reason` is `lease-active`). The UI counts down to it."
+          },
+          "leaseRemainingMs": {
+            "type": "number",
+            "description": "The same moment as milliseconds left when the hub answered, so a client clock that is off cannot skew a countdown."
+          },
           "checkpointId": {
             "type": "string"
           },
@@ -20565,7 +21641,8 @@
             "enum": [
               "device",
               "worker_bootstrap",
-              "worker_session"
+              "worker_session",
+              "device_pairing"
             ]
           },
           "label": {
@@ -20625,6 +21702,93 @@
         ],
         "additionalProperties": false
       },
+      "PairingCode": {
+        "type": "object",
+        "properties": {
+          "deviceId": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "expiresAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "deviceId",
+          "code",
+          "expiresAt"
+        ],
+        "additionalProperties": false
+      },
+      "PairingAddresses": {
+        "type": "object",
+        "properties": {
+          "publicUrl": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "interfaces": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/PairingInterface"
+            }
+          },
+          "custom": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "publicUrl",
+          "interfaces",
+          "custom"
+        ],
+        "additionalProperties": false
+      },
+      "PairingInterface": {
+        "type": "object",
+        "properties": {
+          "address": {
+            "type": "string",
+            "description": "The IP address, without brackets."
+          },
+          "name": {
+            "type": "string",
+            "description": "The interface name, such as `en0` or `tailscale0`."
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "tailscale",
+              "ipv4",
+              "ipv6",
+              "bridge"
+            ]
+          },
+          "url": {
+            "type": "string",
+            "description": "The link base: `http://<address>:<port>`, with an IPv6 address in brackets."
+          },
+          "label": {
+            "type": "string",
+            "description": "`<address> (<ifname>)`"
+          }
+        },
+        "required": [
+          "address",
+          "name",
+          "kind",
+          "url",
+          "label"
+        ],
+        "additionalProperties": false
+      },
       "VaultItemView": {
         "type": "object",
         "properties": {
@@ -20699,6 +21863,57 @@
         ],
         "additionalProperties": false
       },
+      "VoiceStatus": {
+        "type": "object",
+        "properties": {
+          "available": {
+            "type": "boolean",
+            "description": "Voice is on and complete, so the composer shows a mic."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Why it is not available, for the composer tooltip."
+          },
+          "maxBytes": {
+            "type": "number"
+          },
+          "maxSeconds": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "available",
+          "maxBytes",
+          "maxSeconds"
+        ],
+        "additionalProperties": false
+      },
+      "VoiceSettings": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "baseUrl": {
+            "type": "string"
+          },
+          "model": {
+            "type": "string"
+          },
+          "language": {
+            "type": "string"
+          },
+          "hostId": {
+            "type": "string",
+            "description": "A host id: that worker makes the request. Unset means the hub does."
+          },
+          "apiKeyItemId": {
+            "type": "string",
+            "description": "A vault item (`api_key`) holding the key."
+          }
+        },
+        "additionalProperties": false
+      },
       "McpServerView": {
         "type": "object",
         "properties": {
@@ -21215,6 +22430,47 @@
         ],
         "additionalProperties": false
       },
+      "QueuedChatMessage": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChatEventFile"
+            }
+          }
+        },
+        "required": [
+          "id",
+          "text"
+        ],
+        "additionalProperties": false
+      },
+      "ChatEventFile": {
+        "type": "object",
+        "properties": {
+          "mediaType": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          },
+          "filename": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "mediaType",
+          "url"
+        ],
+        "additionalProperties": false
+      },
       "ReportsSummary": {
         "type": "object",
         "properties": {
@@ -21559,6 +22815,23 @@
               "null"
             ],
             "description": "A one-line result, e.g. a check run's title or a commit status description."
+          },
+          "rerun": {
+            "type": "object",
+            "properties": {
+              "runId": {
+                "type": "string"
+              },
+              "jobId": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "runId",
+              "jobId"
+            ],
+            "additionalProperties": false,
+            "description": "Set when the forge can run this job again: the CI run it belongs to and\nits own id. Absent for checks from external apps and commit statuses."
           }
         },
         "required": [
@@ -21823,7 +23096,7 @@
         ],
         "additionalProperties": false
       },
-      "Settings": {
+      "settings": {
         "type": "object",
         "properties": {
           "worktreesDir": {
@@ -21854,9 +23127,6 @@
               "$ref": "#/components/schemas/LabelDefinition"
             }
           },
-          "tokenSecret": {
-            "type": "string"
-          },
           "corsAllowedOrigins": {
             "type": "array",
             "items": {
@@ -21864,6 +23134,13 @@
             },
             "description": "Extra browser origins allowed to call the hub from another origin (the\nUI on a static host or another port). Same-origin, `app://local` and\n`app://h-<12 hex>` are always allowed. `file://` and `null` need an entry. `BAND_CORS_ORIGINS` and `BAND_ALLOWED_ORIGINS` (comma-separated) add to this list."
           },
+          "pairingAddresses": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Custom hub addresses Settings > Devices offers when it shows a pairing link. Written by `tokens.addPairingAddress` only."
+          },
           "autoStartTunnel": {
             "type": "boolean"
           },
@@ -22322,6 +23599,13 @@
           "pinned": {
             "type": "boolean"
           },
+          "sortIndex": {
+            "type": "number",
+            "description": "Position among siblings and inside the Pinned section. Read-only here like `origin`:\n`saveAll` keeps what the database holds, and `RepoQueries.setSortIndexes` writes them."
+          },
+          "pinSortIndex": {
+            "type": "number"
+          },
           "hostId": {
             "type": "string",
             "description": "Host the worktree lives on. Absent means `local`."
@@ -22370,6 +23654,32 @@
         ],
         "additionalProperties": false
       },
+      "DirectAccess": {
+        "type": "object",
+        "properties": {
+          "hostId": {
+            "type": "string"
+          },
+          "port": {
+            "type": "number",
+            "description": "The listener's port on `127.0.0.1`."
+          },
+          "token": {
+            "type": "string"
+          },
+          "expiresAt": {
+            "type": "number",
+            "description": "Epoch ms. The client asks for a new token before then."
+          }
+        },
+        "required": [
+          "hostId",
+          "port",
+          "token",
+          "expiresAt"
+        ],
+        "additionalProperties": false
+      },
       "WorktreeTerminalConfig": {
         "type": "object",
         "properties": {
@@ -23057,6 +24367,10 @@
             "additionalProperties": {
               "type": "string"
             }
+          },
+          "ownerHostId": {
+            "type": "string",
+            "description": "The worker that runs this chat and replicates it to the hub, or\nundefined when the hub runs it."
           }
         },
         "required": [
@@ -23070,7 +24384,8 @@
           "activeSessionSummary",
           "activeSessionLastModified",
           "status",
-          "labels"
+          "labels",
+          "ownerHostId"
         ],
         "additionalProperties": false
       },