@band-app/server 0.50.0 → 0.51.0

package/dist/openapi.json

@@ -708,6 +708,70 @@
                               "items": {
                                 "type": "object",
                                 "properties": {
+                                  "update": {
+                                    "oneOf": [
+                                      {
+                                        "$ref": "#/components/schemas/WorkerUpdateStatus"
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ]
+                                  },
+                                  "workerVersion": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "description": "The worker's release version, or null when it never said (a worker from before version reporting)."
+                                  },
+                                  "versionState": {
+                                    "type": "string",
+                                    "enum": [
+                                      "unknown",
+                                      "current",
+                                      "behind",
+                                      "ahead",
+                                      "refused"
+                                    ],
+                                    "description": "`refused` when the hub turned the worker away for being too far from its version."
+                                  },
+                                  "updateRequired": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "description": "Why the hub refused the link, or null."
+                                  },
+                                  "serviceManager": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "enum": [
+                                      "launchd",
+                                      "systemd"
+                                    ],
+                                    "description": "What restarts the worker, or null when nothing supervises it."
+                                  },
+                                  "updateTarget": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "description": "The version an update installs, or null when there is nothing to update to."
+                                  },
+                                  "canUpdate": {
+                                    "type": "boolean",
+                                    "description": "True when the Update button works: the worker is online, supervised and not current."
+                                  },
+                                  "manualCommand": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ],
+                                    "description": "The command to run on the worker by hand, shown when the button cannot be."
+                                  },
                                   "sleepError": {
                                     "type": [
                                       "string",
@@ -818,9 +882,26 @@
                                   "usable": {
                                     "type": "boolean",
                                     "description": "False for the hub's own machine when `BAND_LOCAL_HOST=off`."
+                                  },
+                                  "trust": {
+                                    "type": "string",
+                                    "enum": [
+                                      "admin",
+                                      "restricted",
+                                      "standard"
+                                    ],
+                                    "description": "How far the host's agents reach through the relay (the stored level, else the default for the host)."
                                   }
                                 },
                                 "required": [
+                                  "update",
+                                  "workerVersion",
+                                  "versionState",
+                                  "updateRequired",
+                                  "serviceManager",
+                                  "updateTarget",
+                                  "canUpdate",
+                                  "manualCommand",
                                   "sleepError",
                                   "id",
                                   "name",
@@ -837,7 +918,8 @@
                                   "capabilities",
                                   "home",
                                   "tools",
-                                  "usable"
+                                  "usable",
+                                  "trust"
                                 ],
                                 "additionalProperties": false
                               }
@@ -876,10 +958,446 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "limit": {
-                      "type": "number"
+                    "limit": {
+                      "type": "number"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/hosts.forAgents": {
+      "get": {
+        "operationId": "hosts.forAgents",
+        "description": "The host list as an agent may see it: id, name, status, OS and architecture, agents,\ncapabilities and labels. No roots, home, tool versions, tokens or runner settings. The MCP\nendpoint lists this one and not `hosts.list`.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "hosts": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/AgentHostView"
+                              }
+                            }
+                          },
+                          "required": [
+                            "hosts"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/hosts.updateStatus": {
+      "get": {
+        "operationId": "hosts.updateStatus",
+        "description": "The hub's version, the newest release GitHub reported and the command that updates the hub for\nhow it was installed. Any device token may read it: the sidebar badge uses it.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "hubVersion": {
+                              "type": "string"
+                            },
+                            "latest": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "updateAvailable": {
+                              "type": "boolean"
+                            },
+                            "checkEnabled": {
+                              "type": "boolean"
+                            },
+                            "checkedAt": {
+                              "type": [
+                                "number",
+                                "null"
+                              ]
+                            },
+                            "installMethod": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "enum": [
+                                "compose",
+                                "helm",
+                                "k8s",
+                                "docker"
+                              ]
+                            },
+                            "hubCommand": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "hubVersion",
+                            "latest",
+                            "updateAvailable",
+                            "checkEnabled",
+                            "checkedAt",
+                            "installMethod",
+                            "hubCommand"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/hosts.interruptions": {
+      "get": {
+        "operationId": "hosts.interruptions",
+        "description": "The agents on a host that restarting its worker would end, for the confirm dialog.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "agents": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "chatId": {
+                                    "type": "string"
+                                  },
+                                  "worktreeId": {
+                                    "type": "string"
+                                  },
+                                  "busy": {
+                                    "type": "boolean"
+                                  }
+                                },
+                                "required": [
+                                  "chatId",
+                                  "worktreeId",
+                                  "busy"
+                                ],
+                                "additionalProperties": false
+                              }
+                            }
+                          },
+                          "required": [
+                            "agents"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "hostId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "hostId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/hosts.update": {
+      "post": {
+        "operationId": "hosts.update",
+        "description": "Starts updating a worker to its target version and restarting it through its service manager.\nAnswers at once; the host row (`update`) shows installing, restarting and then the result. A\nfailed install keeps npm's message there and the worker running as it was. Restarting ends the agents on that host, so the UI asks first.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "target": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "target"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "hostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/hosts.dismissUpdate": {
+      "post": {
+        "operationId": "hosts.dismissUpdate",
+        "description": "Dismisses a failed update, so the Update button is offered again.",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "hostId": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "hostId"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "hostId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/hosts.browse": {
+      "get": {
+        "operationId": "hosts.browse",
+        "description": "Lists the directories in a folder on a host, for the folder picker of \"Add repo from a\nworker\". Without a path it starts at the host's home directory. It reaches outside the\nhost's roots, so only an admin token may call it, and picking a folder outside the roots\nneeds confirmation before it becomes a root (`repos.addFromWorker`).",
+        "tags": [
+          "hosts"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/FsBrowseResult"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "hostId": {
+                      "type": "string"
+                    },
+                    "path": {
+                      "type": "string"
                     }
                   },
+                  "required": [
+                    "hostId"
+                  ],
                   "additionalProperties": false
                 }
               }
@@ -888,10 +1406,10 @@
         ]
       }
     },
-    "/hosts.forAgents": {
-      "get": {
-        "operationId": "hosts.forAgents",
-        "description": "The host list as an agent may see it: id, name, status, OS and architecture, agents,\ncapabilities and labels. No roots, home, tool versions, tokens or runner settings. The MCP\nendpoint lists this one and not `hosts.list`.",
+    "/hosts.setTrust": {
+      "post": {
+        "operationId": "hosts.setTrust",
+        "description": "Sets how far a host's agents reach through the relay. Admin device tokens only: an agent's\nrelay call can never get here (`relay-scope.ts` refuses it whatever the host's level).",
         "tags": [
           "hosts"
         ],
@@ -909,15 +1427,21 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "hosts": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/AgentHostView"
-                              }
+                            "hostId": {
+                              "type": "string"
+                            },
+                            "trust": {
+                              "type": "string",
+                              "enum": [
+                                "admin",
+                                "restricted",
+                                "standard"
+                              ]
                             }
                           },
                           "required": [
-                            "hosts"
+                            "hostId",
+                            "trust"
                           ],
                           "additionalProperties": false
                         }
@@ -937,13 +1461,41 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostId": {
+                    "type": "string"
+                  },
+                  "trust": {
+                    "type": "string",
+                    "enum": [
+                      "admin",
+                      "restricted",
+                      "standard"
+                    ]
+                  }
+                },
+                "required": [
+                  "hostId",
+                  "trust"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
         }
       }
     },
-    "/hosts.browse": {
+    "/hosts.audit": {
       "get": {
-        "operationId": "hosts.browse",
-        "description": "Lists the directories in a folder on a host, for the folder picker of \"Add repo from a\nworker\". Without a path it starts at the host's home directory. It reaches outside the\nhost's roots, so only an admin token may call it, and picking a folder outside the roots\nneeds confirmation before it becomes a root (`repos.addFromWorker`).",
+        "operationId": "hosts.audit",
+        "description": "What admin hosts did across hosts: time, calling host, chat, procedure and target. Newest first.",
         "tags": [
           "hosts"
         ],
@@ -959,7 +1511,61 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/FsBrowseResult"
+                          "type": "object",
+                          "properties": {
+                            "entries": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "at": {
+                                    "type": "number"
+                                  },
+                                  "id": {
+                                    "type": "number"
+                                  },
+                                  "chatId": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "callerHostId": {
+                                    "type": "string"
+                                  },
+                                  "procedure": {
+                                    "type": "string"
+                                  },
+                                  "targetHostId": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "target": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "required": [
+                                  "at",
+                                  "id",
+                                  "chatId",
+                                  "callerHostId",
+                                  "procedure",
+                                  "targetHostId",
+                                  "target"
+                                ],
+                                "additionalProperties": false
+                              }
+                            }
+                          },
+                          "required": [
+                            "entries"
+                          ],
+                          "additionalProperties": false
                         }
                       },
                       "required": [
@@ -989,16 +1595,10 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "hostId": {
-                      "type": "string"
-                    },
-                    "path": {
-                      "type": "string"
+                    "limit": {
+                      "type": "number"
                     }
                   },
-                  "required": [
-                    "hostId"
-                  ],
                   "additionalProperties": false
                 }
               }
@@ -15463,9 +16063,6 @@
                   "properties": {
                     "worktreeId": {
                       "type": "string"
-                    },
-                    "repo": {
-                      "type": "string"
                     }
                   },
                   "additionalProperties": false
@@ -15611,16 +16208,6 @@
                   "prompt": {
                     "type": "string"
                   },
-                  "scope": {
-                    "type": "string",
-                    "enum": [
-                      "worktree",
-                      "repo"
-                    ]
-                  },
-                  "key": {
-                    "type": "string"
-                  },
                   "cronExpression": {
                     "type": "string"
                   },
@@ -15636,13 +16223,23 @@
                       "chat",
                       "terminal"
                     ]
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "key": {
+                    "type": "string"
+                  },
+                  "agent": {
+                    "type": "string"
+                  },
+                  "sessionId": {
+                    "type": "string"
                   }
                 },
                 "required": [
                   "name",
                   "prompt",
-                  "scope",
-                  "key",
                   "cronExpression"
                 ],
                 "additionalProperties": false
@@ -15717,11 +16314,33 @@
                   "enabled": {
                     "type": "boolean"
                   },
+                  "worktreeId": {
+                    "type": "string"
+                  },
                   "prompt": {
                     "type": "string"
                   },
+                  "via": {
+                    "type": "string",
+                    "enum": [
+                      "chat",
+                      "terminal"
+                    ]
+                  },
                   "cronExpression": {
                     "type": "string"
+                  },
+                  "agent": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "sessionId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
                   }
                 },
                 "required": [
@@ -15833,19 +16452,23 @@
                                   "type": "string",
                                   "const": "chat"
                                 },
-                                "taskId": {
-                                  "type": "string"
-                                },
                                 "worktreeId": {
                                   "type": "string"
                                 },
                                 "chatId": {
                                   "type": "string"
+                                },
+                                "taskId": {
+                                  "type": "string",
+                                  "description": "Set when the prompt started a turn now."
+                                },
+                                "queuedMessageId": {
+                                  "type": "string",
+                                  "description": "Set when the chat was mid-turn and the prompt joined its queue."
                                 }
                               },
                               "required": [
                                 "via",
-                                "taskId",
                                 "worktreeId",
                                 "chatId"
                               ],
@@ -20201,6 +20824,34 @@
         ],
         "additionalProperties": false
       },
+      "WorkerUpdateStatus": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "failed",
+              "installing",
+              "restarting"
+            ]
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "target",
+          "state",
+          "error"
+        ],
+        "additionalProperties": false
+      },
       "CapabilityReport": {
         "type": "object",
         "properties": {
@@ -22689,12 +23340,12 @@
             "enum": [
               "unknown",
               "dirty",
+              "behind",
               "clean",
               "draft",
               "unstable",
               "has_hooks",
-              "blocked",
-              "behind"
+              "blocked"
             ],
             "description": "Whether the review can merge now, and if not, why."
           },
@@ -24232,11 +24883,23 @@
               "worktree",
               "repo"
             ],
-            "description": "One scheduled cron-style task — a prompt the agent runs on a recurring\nschedule against a repo's main branch or a specific worktree.\n\nPersisted shape matches the Drizzle row 1:1; the `worktreeId` and\n`lastRun*` columns are nullable in SQLite but exposed here as optional\n`T | undefined` to make consumers' optional-chaining ergonomic. Conversion\nhappens inside `CronjobQueries.rowToDefinition` below."
+            "description": "One scheduled cron-style task — a prompt the agent runs on a recurring\nschedule against one worktree (the default-branch worktree or any other).\n\nPersisted shape matches the Drizzle row 1:1; the `worktreeId` and\n`lastRun*` columns are nullable in SQLite but exposed here as optional\n`T | undefined` to make consumers' optional-chaining ergonomic. Conversion\nhappens inside `CronjobQueries.rowToDefinition` below."
           },
           "worktreeId": {
             "type": "string",
-            "description": "For worktree-scoped jobs, the worktree ID (repo-branch)"
+            "description": "The worktree the job fires into"
+          },
+          "agent": {
+            "type": "string",
+            "description": "Coding agent id (`settings.codingAgents[].id`) the job's chat runs. Default agent when absent."
+          },
+          "sessionId": {
+            "type": "string",
+            "description": "Agent provider session id. Fires go to the chat whose active session is this id."
+          },
+          "lastRunMessage": {
+            "type": "string",
+            "description": "Why the last run failed, or why the boot migration disabled the job"
           },
           "via": {
             "type": "string",