@band-app/server 0.51.0 → 0.52.0

package/dist/openapi.json

@@ -2100,6 +2100,9 @@
                                     "null"
                                   ]
                                 },
+                                "branch": {
+                                  "type": "string"
+                                },
                                 "input": {
                                   "type": "object",
                                   "additionalProperties": {}
@@ -2110,9 +2113,6 @@
                                 "repo": {
                                   "type": "string"
                                 },
-                                "branch": {
-                                  "type": "string"
-                                },
                                 "requires": {
                                   "type": "object",
                                   "additionalProperties": {
@@ -2161,10 +2161,10 @@
                                 "id",
                                 "labels",
                                 "hostId",
+                                "branch",
                                 "input",
                                 "worktreeId",
                                 "repo",
-                                "branch",
                                 "requires",
                                 "environment",
                                 "createdAt",
@@ -2275,6 +2275,9 @@
                                         "null"
                                       ]
                                     },
+                                    "branch": {
+                                      "type": "string"
+                                    },
                                     "input": {
                                       "type": "object",
                                       "additionalProperties": {}
@@ -2285,9 +2288,6 @@
                                     "repo": {
                                       "type": "string"
                                     },
-                                    "branch": {
-                                      "type": "string"
-                                    },
                                     "requires": {
                                       "type": "object",
                                       "additionalProperties": {
@@ -2336,10 +2336,10 @@
                                     "id",
                                     "labels",
                                     "hostId",
+                                    "branch",
                                     "input",
                                     "worktreeId",
                                     "repo",
-                                    "branch",
                                     "requires",
                                     "environment",
                                     "createdAt",
@@ -2485,6 +2485,9 @@
                                     "null"
                                   ]
                                 },
+                                "branch": {
+                                  "type": "string"
+                                },
                                 "input": {
                                   "type": "object",
                                   "additionalProperties": {}
@@ -2495,9 +2498,6 @@
                                 "repo": {
                                   "type": "string"
                                 },
-                                "branch": {
-                                  "type": "string"
-                                },
                                 "requires": {
                                   "type": "object",
                                   "additionalProperties": {
@@ -2546,10 +2546,10 @@
                                 "id",
                                 "labels",
                                 "hostId",
+                                "branch",
                                 "input",
                                 "worktreeId",
                                 "repo",
-                                "branch",
                                 "requires",
                                 "environment",
                                 "createdAt",
@@ -2665,6 +2665,9 @@
                                     "null"
                                   ]
                                 },
+                                "branch": {
+                                  "type": "string"
+                                },
                                 "input": {
                                   "type": "object",
                                   "additionalProperties": {}
@@ -2675,9 +2678,6 @@
                                 "repo": {
                                   "type": "string"
                                 },
-                                "branch": {
-                                  "type": "string"
-                                },
                                 "requires": {
                                   "type": "object",
                                   "additionalProperties": {
@@ -2726,10 +2726,10 @@
                                 "id",
                                 "labels",
                                 "hostId",
+                                "branch",
                                 "input",
                                 "worktreeId",
                                 "repo",
-                                "branch",
                                 "requires",
                                 "environment",
                                 "createdAt",
@@ -2849,6 +2849,9 @@
                                     "null"
                                   ]
                                 },
+                                "branch": {
+                                  "type": "string"
+                                },
                                 "input": {
                                   "type": "object",
                                   "additionalProperties": {}
@@ -2859,9 +2862,6 @@
                                 "repo": {
                                   "type": "string"
                                 },
-                                "branch": {
-                                  "type": "string"
-                                },
                                 "requires": {
                                   "type": "object",
                                   "additionalProperties": {
@@ -2910,10 +2910,10 @@
                                 "id",
                                 "labels",
                                 "hostId",
+                                "branch",
                                 "input",
                                 "worktreeId",
                                 "repo",
-                                "branch",
                                 "requires",
                                 "environment",
                                 "createdAt",
@@ -5663,15 +5663,671 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "flowId"
-                  ],
-                  "additionalProperties": false
-                }
+                  "required": [
+                    "flowId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/provisioning.createCommand": {
+      "post": {
+        "operationId": "provisioning.createCommand",
+        "description": "Makes a one-time command. `hubUrl` is the address the new machine reaches the hub at.",
+        "tags": [
+          "provisioning"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/CreatedCommand"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hubUrl": {
+                    "type": "string"
+                  },
+                  "labels": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "hostName": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "hubUrl"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/provisioning.status": {
+      "get": {
+        "operationId": "provisioning.status",
+        "description": "One command's state and log, or the newest commands when no id is given.",
+        "tags": [
+          "provisioning"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "commands": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ProvisionView"
+                              }
+                            }
+                          },
+                          "required": [
+                            "commands"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/provisioning.settings": {
+      "get": {
+        "operationId": "provisioning.settings",
+        "tags": [
+          "provisioning"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/ProvisionSettings"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/provisioning.updateSettings": {
+      "post": {
+        "operationId": "provisioning.updateSettings",
+        "tags": [
+          "provisioning"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/ProvisionSettings"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "command": {
+                    "type": "string"
+                  },
+                  "repoUrl": {
+                    "type": "string"
+                  },
+                  "branch": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentLogins.list": {
+      "get": {
+        "operationId": "agentLogins.list",
+        "tags": [
+          "agentLogins"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/AgentLoginList"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/agentLogins.create": {
+      "post": {
+        "operationId": "agentLogins.create",
+        "tags": [
+          "agentLogins"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "login": {
+                              "$ref": "#/components/schemas/AgentLoginView"
+                            }
+                          },
+                          "required": [
+                            "login"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "kind": {
+                    "type": "string"
+                  },
+                  "agentType": {
+                    "type": "string"
+                  },
+                  "secret": {
+                    "type": "string"
+                  },
+                  "vaultItemId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "label",
+                  "kind",
+                  "agentType"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentLogins.update": {
+      "post": {
+        "operationId": "agentLogins.update",
+        "tags": [
+          "agentLogins"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "login": {
+                              "$ref": "#/components/schemas/AgentLoginView"
+                            }
+                          },
+                          "required": [
+                            "login"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "secret": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentLogins.remove": {
+      "post": {
+        "operationId": "agentLogins.remove",
+        "tags": [
+          "agentLogins"
+        ],
+        "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
+                            }
+                          },
+                          "required": [
+                            "removed"
+                          ],
+                          "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
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentLogins.setDefault": {
+      "post": {
+        "operationId": "agentLogins.setDefault",
+        "tags": [
+          "agentLogins"
+        ],
+        "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": {
+                  "loginId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "agentType": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "loginId",
+                  "agentType"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentLogins.setRepoOverride": {
+      "post": {
+        "operationId": "agentLogins.setRepoOverride",
+        "tags": [
+          "agentLogins"
+        ],
+        "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": {
+                  "repo": {
+                    "type": "string"
+                  },
+                  "loginId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "agentType": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "repo",
+                  "loginId",
+                  "agentType"
+                ],
+                "additionalProperties": false
               }
             }
           }
-        ]
+        }
       }
     },
     "/voice.status": {
@@ -11337,6 +11993,21 @@
                     },
                     "additionalProperties": {}
                   },
+                  "provisioning": {
+                    "type": "object",
+                    "properties": {
+                      "command": {
+                        "type": "string"
+                      },
+                      "repoUrl": {
+                        "type": "string"
+                      },
+                      "branch": {
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": {}
+                  },
                   "environmentBuilder": {
                     "type": "object",
                     "properties": {
@@ -12758,10 +13429,10 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "repo": {
+                  "branch": {
                     "type": "string"
                   },
-                  "branch": {
+                  "repo": {
                     "type": "string"
                   },
                   "model": {
@@ -12832,8 +13503,8 @@
                   }
                 },
                 "required": [
-                  "repo",
-                  "branch"
+                  "branch",
+                  "repo"
                 ],
                 "additionalProperties": false
               }
@@ -16797,6 +17468,10 @@
                     "type": "number",
                     "description": "Timer only: fire once at this time, in epoch milliseconds."
                   },
+                  "branch": {
+                    "type": "string",
+                    "description": "GitHub only: branch whose CI result is delivered once per commit, after every check completes."
+                  },
                   "chatId": {
                     "type": "string"
                   },
@@ -16807,10 +17482,6 @@
                     "type": "string",
                     "description": "GitHub only: `owner/name`. With `pr` it watches that pull request, with `branch` its CI."
                   },
-                  "branch": {
-                    "type": "string",
-                    "description": "GitHub only: branch whose CI result is delivered once per commit, after every check completes."
-                  },
                   "coalesceSeconds": {
                     "type": "number"
                   },
@@ -17625,6 +18296,12 @@
                   },
                   "agent": {
                     "type": "string"
+                  },
+                  "loginId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -22514,6 +23191,226 @@
         ],
         "additionalProperties": false
       },
+      "CreatedCommand": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "command": {
+            "type": "string",
+            "description": "The one line to paste."
+          },
+          "cloudInit": {
+            "type": "string",
+            "description": "The same line inside a `#cloud-config` document."
+          },
+          "expiresAt": {
+            "type": "number"
+          },
+          "hostName": {
+            "type": "string"
+          },
+          "commitSha": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "command",
+          "cloudInit",
+          "expiresAt",
+          "hostName",
+          "commitSha"
+        ],
+        "additionalProperties": false
+      },
+      "ProvisionView": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "provisioning",
+              "failed",
+              "online",
+              "expired",
+              "waiting"
+            ]
+          },
+          "hostId": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hostName": {
+            "type": "string"
+          },
+          "expiresAt": {
+            "type": "number"
+          },
+          "createdAt": {
+            "type": "number"
+          },
+          "commitSha": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "repoUrl": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "exitCode": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "log": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "status",
+          "hostId",
+          "hostName",
+          "expiresAt",
+          "createdAt",
+          "commitSha",
+          "repoUrl",
+          "exitCode",
+          "log"
+        ],
+        "additionalProperties": false
+      },
+      "ProvisionSettings": {
+        "type": "object",
+        "properties": {
+          "repoUrl": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "command": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "repoUrl",
+          "branch",
+          "command"
+        ],
+        "additionalProperties": false
+      },
+      "AgentLoginList": {
+        "type": "object",
+        "properties": {
+          "logins": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AgentLoginView"
+            }
+          },
+          "defaults": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "repoOverrides": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "agentType": {
+                  "type": "string"
+                },
+                "repo": {
+                  "type": "string"
+                },
+                "loginId": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "agentType",
+                "repo",
+                "loginId"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "logins",
+          "defaults",
+          "repoOverrides"
+        ],
+        "additionalProperties": false
+      },
+      "AgentLoginView": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "agentType": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "kindLabel": {
+            "type": "string"
+          },
+          "envVar": {
+            "type": "string",
+            "description": "The variable that carries the secret."
+          },
+          "vaultItemId": {
+            "type": "string"
+          },
+          "missingSecret": {
+            "type": "boolean",
+            "description": "True when the vault item is gone, so the login cannot be used until it is replaced."
+          },
+          "createdAt": {
+            "type": "number"
+          },
+          "updatedAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "id",
+          "agentType",
+          "label",
+          "kind",
+          "kindLabel",
+          "envVar",
+          "vaultItemId",
+          "missingSecret",
+          "createdAt",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
       "VoiceStatus": {
         "type": "object",
         "properties": {
@@ -22829,6 +23726,13 @@
           },
           "defaultModel": {
             "type": "string"
+          },
+          "logins": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AgentLoginOption"
+            },
+            "description": "Band-managed logins for this agent (`agentLogins`). The chat shows a picker when there are two or more choices."
           }
         },
         "required": [
@@ -22839,6 +23743,30 @@
         ],
         "additionalProperties": false
       },
+      "AgentLoginOption": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "kindLabel": {
+            "type": "string"
+          },
+          "isDefault": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "id",
+          "label",
+          "kindLabel",
+          "isDefault"
+        ],
+        "additionalProperties": false
+      },
       "ModelRefreshResult": {
         "type": "object",
         "properties": {
@@ -25034,6 +25962,10 @@
           "ownerHostId": {
             "type": "string",
             "description": "The worker that runs this chat and replicates it to the hub, or\nundefined when the hub runs it."
+          },
+          "loginId": {
+            "type": "string",
+            "description": "The agent login (`agentLogins`) this chat picked, or undefined for the repo's or the agent's default."
           }
         },
         "required": [
@@ -25048,7 +25980,8 @@
           "activeSessionLastModified",
           "status",
           "labels",
-          "ownerHostId"
+          "ownerHostId",
+          "loginId"
         ],
         "additionalProperties": false
       },