@band-app/server 0.49.0 → 0.50.0

package/dist/openapi.json

@@ -4173,6 +4173,324 @@
         }
       }
     },
+    "/tokens.createUnpairedDevice": {
+      "post": {
+        "operationId": "tokens.createUnpairedDevice",
+        "description": "A device with no token yet. Show its pairing link next (`pairing`).",
+        "tags": [
+          "tokens"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "view": {
+                              "$ref": "#/components/schemas/TokenView"
+                            }
+                          },
+                          "required": [
+                            "view"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "admin": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "label"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/tokens.pairing": {
+      "post": {
+        "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"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/PairingCode"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "tokenId": {
+                    "type": "string"
+                  },
+                  "regenerate": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "tokenId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/tokens.pairingAddresses": {
+      "get": {
+        "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": [
+          "tokens"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/PairingAddresses"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/tokens.addPairingAddress": {
+      "post": {
+        "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": [
+          "tokens"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "url": {
+                              "type": "string"
+                            },
+                            "custom": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "required": [
+                            "url",
+                            "custom"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/tokens.removePairingAddress": {
+      "post": {
+        "operationId": "tokens.removePairingAddress",
+        "tags": [
+          "tokens"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "custom": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          },
+                          "required": [
+                            "custom"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/tokens.issueWorkerBootstrap": {
       "post": {
         "operationId": "tokens.issueWorkerBootstrap",
@@ -4756,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",
@@ -4866,6 +5343,9 @@
                   "command": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "hostId": {
                     "type": "string"
                   },
@@ -4911,9 +5391,6 @@
                       ]
                     }
                   },
-                  "enabled": {
-                    "type": "boolean"
-                  },
                   "cwd": {
                     "type": [
                       "string",
@@ -5063,6 +5540,9 @@
                   "command": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "hostId": {
                     "type": "string"
                   },
@@ -5108,9 +5588,6 @@
                       ]
                     }
                   },
-                  "enabled": {
-                    "type": "boolean"
-                  },
                   "cwd": {
                     "type": [
                       "string",
@@ -7891,7 +8368,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8009,7 +8486,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8093,7 +8570,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -8178,7 +8655,7 @@
                             "messages": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/WireQueuedMessage"
+                                "$ref": "#/components/schemas/QueuedChatMessage"
                               }
                             }
                           },
@@ -10236,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": {
@@ -11807,7 +12308,86 @@
                 },
                 "required": [
                   "name",
-                  "repo"
+                  "repo"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/worktrees.setPinned": {
+      "post": {
+        "operationId": "worktrees.setPinned",
+        "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": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "repo": {
+                    "type": "string"
+                  },
+                  "pinned": {
+                    "type": "boolean"
+                  },
+                  "hostId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "repo",
+                  "pinned"
                 ],
                 "additionalProperties": false
               }
@@ -11816,9 +12396,9 @@
         }
       }
     },
-    "/worktrees.setPinned": {
+    "/worktrees.reorder": {
       "post": {
-        "operationId": "worktrees.setPinned",
+        "operationId": "worktrees.reorder",
         "tags": [
           "worktrees"
         ],
@@ -11870,23 +12450,65 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "name": {
-                    "type": "string"
-                  },
-                  "repo": {
-                    "type": "string"
+                  "order": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "repo": {
+                          "type": "string"
+                        },
+                        "hostId": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "repo"
+                      ],
+                      "additionalProperties": false
+                    }
                   },
-                  "pinned": {
-                    "type": "boolean"
+                  "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
               }
@@ -14989,12 +15611,6 @@
                   "prompt": {
                     "type": "string"
                   },
-                  "key": {
-                    "type": "string"
-                  },
-                  "cronExpression": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -15002,6 +15618,15 @@
                       "repo"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
+                  "cronExpression": {
+                    "type": "string"
+                  },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "worktreeId": {
                     "type": "string"
                   },
@@ -15011,17 +15636,14 @@
                       "chat",
                       "terminal"
                     ]
-                  },
-                  "enabled": {
-                    "type": "boolean"
                   }
                 },
                 "required": [
                   "name",
                   "prompt",
+                  "scope",
                   "key",
-                  "cronExpression",
-                  "scope"
+                  "cronExpression"
                 ],
                 "additionalProperties": false
               }
@@ -15092,14 +15714,14 @@
                   "name": {
                     "type": "string"
                   },
+                  "enabled": {
+                    "type": "boolean"
+                  },
                   "prompt": {
                     "type": "string"
                   },
                   "cronExpression": {
                     "type": "string"
-                  },
-                  "enabled": {
-                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -18491,9 +19113,6 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "key": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -18502,6 +19121,9 @@
                       "all"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
                   "baseVersion": {
                     "type": "number"
                   },
@@ -18511,8 +19133,8 @@
                   "value": {}
                 },
                 "required": [
-                  "key",
                   "scope",
+                  "key",
                   "baseVersion",
                   "clientId"
                 ],
@@ -18605,9 +19227,6 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "key": {
-                    "type": "string"
-                  },
                   "scope": {
                     "type": "string",
                     "enum": [
@@ -18616,6 +19235,9 @@
                       "all"
                     ]
                   },
+                  "key": {
+                    "type": "string"
+                  },
                   "baseVersion": {
                     "type": "number"
                   },
@@ -18624,8 +19246,8 @@
                   }
                 },
                 "required": [
-                  "key",
                   "scope",
+                  "key",
                   "baseVersion",
                   "clientId"
                 ],
@@ -21019,7 +21641,8 @@
             "enum": [
               "device",
               "worker_bootstrap",
-              "worker_session"
+              "worker_session",
+              "device_pairing"
             ]
           },
           "label": {
@@ -21079,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": {
@@ -21153,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": {
@@ -21669,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": {
@@ -22332,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"
           },
@@ -22790,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`."
@@ -23551,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": [
@@ -23564,7 +24384,8 @@
           "activeSessionSummary",
           "activeSessionLastModified",
           "status",
-          "labels"
+          "labels",
+          "ownerHostId"
         ],
         "additionalProperties": false
       },