@band-app/server 0.58.0 → 0.60.0

package/dist/openapi.json

@@ -248,12 +248,11 @@
         ]
       }
     },
-    "/hooks.check": {
+    "/resources.snapshot": {
       "get": {
-        "operationId": "hooks.check",
-        "description": "The hub's own host.",
+        "operationId": "resources.snapshot",
         "tags": [
-          "hooks"
+          "resources"
         ],
         "responses": {
           "200": {
@@ -267,7 +266,46 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/HooksStatus"
+                          "$ref": "#/components/schemas/ResourcesReport"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/resources.storage": {
+      "get": {
+        "operationId": "resources.storage",
+        "tags": [
+          "resources"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/ResourceStorageView"
                         }
                       },
                       "required": [
@@ -301,6 +339,9 @@
                       "type": "string"
                     }
                   },
+                  "required": [
+                    "hostId"
+                  ],
                   "additionalProperties": false
                 }
               }
@@ -309,10 +350,10 @@
         ]
       }
     },
-    "/hooks.hosts": {
+    "/hooks.check": {
       "get": {
-        "operationId": "hooks.hosts",
-        "description": "Every host with its hooks status.",
+        "operationId": "hooks.check",
+        "description": "The hub's own host.",
         "tags": [
           "hooks"
         ],
@@ -328,19 +369,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "hosts": {
-                              "type": "array",
-                              "items": {
-                                "$ref": "#/components/schemas/HostHooksView"
-                              }
-                            }
-                          },
-                          "required": [
-                            "hosts"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/HooksStatus"
                         }
                       },
                       "required": [
@@ -358,12 +387,34 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
-        }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "hostId": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
       }
     },
-    "/hooks.install": {
-      "post": {
-        "operationId": "hooks.install",
+    "/hooks.hosts": {
+      "get": {
+        "operationId": "hooks.hosts",
+        "description": "Every host with its hooks status.",
         "tags": [
           "hooks"
         ],
@@ -381,12 +432,15 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "ok": {
-                              "type": "boolean"
+                            "hosts": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/HostHooksView"
+                              }
                             }
                           },
                           "required": [
-                            "ok"
+                            "hosts"
                           ],
                           "additionalProperties": false
                         }
@@ -406,29 +460,12 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
-        },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "hostId": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false
-              }
-            }
-          }
         }
       }
     },
-    "/hooks.remove": {
+    "/hooks.install": {
       "post": {
-        "operationId": "hooks.remove",
-        "description": "Removes Band's entries and leaves every other hook and setting.",
+        "operationId": "hooks.install",
         "tags": [
           "hooks"
         ],
@@ -490,137 +527,12 @@
         }
       }
     },
-    "/host.readFile": {
-      "get": {
-        "operationId": "host.readFile",
-        "tags": [
-          "host"
-        ],
-        "responses": {
-          "200": {
-            "description": "Successful response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "result": {
-                      "type": "object",
-                      "properties": {
-                        "data": {
-                          "oneOf": [
-                            {
-                              "type": "object",
-                              "properties": {
-                                "tooLarge": {
-                                  "type": "boolean",
-                                  "const": true
-                                },
-                                "size": {
-                                  "type": "number"
-                                },
-                                "binary": {},
-                                "content": {},
-                                "language": {}
-                              },
-                              "required": [
-                                "tooLarge",
-                                "size"
-                              ],
-                              "additionalProperties": false
-                            },
-                            {
-                              "type": "object",
-                              "properties": {
-                                "binary": {
-                                  "type": "boolean",
-                                  "const": true
-                                },
-                                "size": {
-                                  "type": "number"
-                                },
-                                "tooLarge": {},
-                                "content": {},
-                                "language": {}
-                              },
-                              "required": [
-                                "binary",
-                                "size"
-                              ],
-                              "additionalProperties": false
-                            },
-                            {
-                              "type": "object",
-                              "properties": {
-                                "content": {
-                                  "type": "string"
-                                },
-                                "size": {
-                                  "type": "number"
-                                },
-                                "language": {
-                                  "type": "string"
-                                },
-                                "tooLarge": {},
-                                "binary": {}
-                              },
-                              "required": [
-                                "content",
-                                "size",
-                                "language"
-                              ],
-                              "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": {
-                    "absolutePath": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "absolutePath"
-                  ],
-                  "additionalProperties": false
-                }
-              }
-            }
-          }
-        ]
-      }
-    },
-    "/host.saveFile": {
+    "/hooks.remove": {
       "post": {
-        "operationId": "host.saveFile",
+        "operationId": "hooks.remove",
+        "description": "Removes Band's entries and leaves every other hook and setting.",
         "tags": [
-          "host"
+          "hooks"
         ],
         "responses": {
           "200": {
@@ -669,17 +581,10 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "content": {
-                    "type": "string"
-                  },
-                  "absolutePath": {
+                  "hostId": {
                     "type": "string"
                   }
                 },
-                "required": [
-                  "content",
-                  "absolutePath"
-                ],
                 "additionalProperties": false
               }
             }
@@ -18568,9 +18473,10 @@
         }
       }
     },
-    "/worktree.createFile": {
-      "post": {
-        "operationId": "worktree.createFile",
+    "/worktree.readExternalFile": {
+      "get": {
+        "operationId": "worktree.readExternalFile",
+        "description": "A file outside the worktree, read on the worktree's own worker (never the\nhub's disk). Left out of the relay and the direct path: device tokens only.",
         "tags": [
           "worktree"
         ],
@@ -18586,7 +18492,205 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "tooLarge": {
+                                  "type": "boolean",
+                                  "const": true
+                                },
+                                "size": {
+                                  "type": "number"
+                                }
+                              },
+                              "required": [
+                                "tooLarge",
+                                "size"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "binary": {
+                                  "type": "boolean",
+                                  "const": true
+                                },
+                                "size": {
+                                  "type": "number"
+                                }
+                              },
+                              "required": [
+                                "binary",
+                                "size"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "content": {
+                                  "type": "string"
+                                },
+                                "size": {
+                                  "type": "number"
+                                },
+                                "language": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "content",
+                                "size",
+                                "language"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "worktreeId": {
+                      "type": "string"
+                    },
+                    "absolutePath": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "worktreeId",
+                    "absolutePath"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/worktree.saveExternalFile": {
+      "post": {
+        "operationId": "worktree.saveExternalFile",
+        "tags": [
+          "worktree"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "ok": {
+                              "type": "boolean",
+                              "const": true
+                            }
+                          },
+                          "required": [
+                            "ok"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "worktreeId": {
+                    "type": "string"
+                  },
+                  "content": {
+                    "type": "string"
+                  },
+                  "absolutePath": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "worktreeId",
+                  "content",
+                  "absolutePath"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/worktree.createFile": {
+      "post": {
+        "operationId": "worktree.createFile",
+        "tags": [
+          "worktree"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
                           "properties": {
                             "ok": {
                               "type": "boolean",
@@ -24467,62 +24571,457 @@
         ],
         "additionalProperties": false
       },
-      "HooksStatus": {
+      "ResourcesReport": {
         "type": "object",
         "properties": {
-          "installed": {
-            "type": "boolean",
-            "description": "Band's current hook is present for every hook event."
-          },
-          "outdated": {
-            "type": "boolean",
-            "description": "Band has hooks, but not the current set (fewer events, or an older command)."
-          },
-          "other_hooks_exist": {
-            "type": "boolean",
-            "description": "The settings also hold hooks that are not Band's."
+          "takenAt": {
+            "type": "number"
           },
-          "version": {
-            "type": "number",
-            "description": "The version of the hook set this build installs."
+          "machines": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ResourceMachine"
+            }
           }
         },
         "required": [
-          "installed",
-          "outdated",
-          "other_hooks_exist",
-          "version"
+          "takenAt",
+          "machines"
         ],
         "additionalProperties": false
       },
-      "HostHooksView": {
+      "ResourceMachine": {
         "type": "object",
         "properties": {
-          "hostId": {
-            "type": "string"
+          "id": {
+            "type": "string",
+            "description": "`local` for the hub's own machine, else the worker id."
+          },
+          "role": {
+            "type": "string",
+            "enum": [
+              "hub",
+              "worker"
+            ],
+            "description": "`hub` for the hub's machine (its built-in worker included), `worker` for any other."
           },
           "name": {
             "type": "string"
           },
-          "online": {
-            "type": "boolean"
+          "version": {
+            "type": [
+              "string",
+              "null"
+            ]
           },
-          "hasClaudeCode": {
+          "builtInWorker": {
             "type": "boolean",
-            "description": "Whether Claude Code can start on the host."
+            "description": "Whether the hub's machine also runs the built-in `local` worker."
+          },
+          "onBattery": {
+            "type": [
+              "boolean",
+              "null"
+            ]
           },
           "status": {
-            "oneOf": [
-              {
-                "$ref": "#/components/schemas/HooksStatus"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Null when the host is offline or could not be read; `error` says why."
+            "type": "string",
+            "enum": [
+              "ok",
+              "unavailable"
+            ]
           },
-          "error": {
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "enum": [
+              "offline",
+              "no-answer"
+            ],
+            "description": "Why a machine shows no numbers."
+          },
+          "snapshot": {
+            "oneOf": [
+              {
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/Omit"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "processes": {
+                        "type": "array",
+                        "items": {
+                          "$ref": "#/components/schemas/ResourceProcessView"
+                        }
+                      }
+                    },
+                    "required": [
+                      "processes"
+                    ],
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "role",
+          "name",
+          "version",
+          "builtInWorker",
+          "onBattery",
+          "status",
+          "reason",
+          "snapshot"
+        ],
+        "additionalProperties": false
+      },
+      "Omit": {
+        "type": "object",
+        "properties": {
+          "hostname": {
+            "type": "string"
+          },
+          "os": {
+            "type": "string"
+          },
+          "cores": {
+            "type": "number"
+          },
+          "memTotalBytes": {
+            "type": "number",
+            "description": "RAM of the machine and what is in use, in bytes."
+          },
+          "memUsedBytes": {
+            "type": "number"
+          },
+          "machineCpuPercent": {
+            "type": [
+              "number",
+              "null"
+            ],
+            "description": "Machine CPU over the sampling window, 0 to 100. Null when it could not be read."
+          },
+          "loadAverage": {
+            "type": "number"
+          },
+          "windowMs": {
+            "type": "number",
+            "description": "How long the sampling window was, in milliseconds."
+          },
+          "takenAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "hostname",
+          "os",
+          "cores",
+          "memTotalBytes",
+          "memUsedBytes",
+          "machineCpuPercent",
+          "loadAverage",
+          "windowMs",
+          "takenAt"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceProcessView": {
+        "type": "object",
+        "properties": {
+          "worktree": {
+            "$ref": "#/components/schemas/ResourceWorktreeRef"
+          },
+          "chat": {
+            "$ref": "#/components/schemas/ResourceChatRef"
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "terminal",
+              "agent",
+              "browser",
+              "hub",
+              "worker",
+              "mcp",
+              "terminal-daemon",
+              "agent-daemon",
+              "lsp",
+              "simulator",
+              "other"
+            ],
+            "description": "What a Band process on a machine is for."
+          },
+          "chatId": {
+            "type": "string"
+          },
+          "worktreeId": {
+            "type": "string",
+            "description": "Ids from the process environment (`BAND_WORKTREE_ID`, `BAND_CHAT_ID`, `BAND_TERMINAL_ID`)."
+          },
+          "terminalId": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string",
+            "description": "Short name: the shell, the agent adapter, the language server."
+          },
+          "pid": {
+            "type": "number"
+          },
+          "rssBytes": {
+            "type": "number",
+            "description": "Resident memory of the process and its children, in bytes."
+          },
+          "cpuPercent": {
+            "type": "number",
+            "description": "CPU of the process and its children over the sampling window, in percent of one core."
+          },
+          "processCount": {
+            "type": "number",
+            "description": "How many processes the numbers cover (the process and its descendants)."
+          }
+        },
+        "required": [
+          "kind",
+          "name",
+          "pid",
+          "rssBytes",
+          "cpuPercent",
+          "processCount"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceWorktreeRef": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "repo": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "repo",
+          "branch",
+          "title"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceChatRef": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "agent": {
+            "type": "string"
+          },
+          "running": {
+            "type": "boolean"
+          },
+          "idleMs": {
+            "type": [
+              "number",
+              "null"
+            ],
+            "description": "Milliseconds since the agent last sent anything. Null when unknown."
+          },
+          "idle": {
+            "type": "boolean",
+            "description": "True when the agent has been quiet for an hour and runs no turn."
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "agent",
+          "running",
+          "idleMs",
+          "idle"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceStorageView": {
+        "type": "object",
+        "properties": {
+          "worktrees": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ResourceStorageWorktree"
+            }
+          },
+          "state": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "sizeBytes": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "name",
+                "sizeBytes"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "disk": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/ResourceDisk"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "worktrees",
+          "state",
+          "disk"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceStorageWorktree": {
+        "type": "object",
+        "properties": {
+          "sizeBytes": {
+            "type": "number"
+          },
+          "error": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "repo": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "sizeBytes",
+          "id",
+          "repo",
+          "branch",
+          "title"
+        ],
+        "additionalProperties": false
+      },
+      "ResourceDisk": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "The folder the numbers describe."
+          },
+          "totalBytes": {
+            "type": "number"
+          },
+          "freeBytes": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "path",
+          "totalBytes",
+          "freeBytes"
+        ],
+        "additionalProperties": false
+      },
+      "HooksStatus": {
+        "type": "object",
+        "properties": {
+          "installed": {
+            "type": "boolean",
+            "description": "Band's current hook is present for every hook event."
+          },
+          "outdated": {
+            "type": "boolean",
+            "description": "Band has hooks, but not the current set (fewer events, or an older command)."
+          },
+          "other_hooks_exist": {
+            "type": "boolean",
+            "description": "The settings also hold hooks that are not Band's."
+          },
+          "version": {
+            "type": "number",
+            "description": "The version of the hook set this build installs."
+          }
+        },
+        "required": [
+          "installed",
+          "outdated",
+          "other_hooks_exist",
+          "version"
+        ],
+        "additionalProperties": false
+      },
+      "HostHooksView": {
+        "type": "object",
+        "properties": {
+          "hostId": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "online": {
+            "type": "boolean"
+          },
+          "hasClaudeCode": {
+            "type": "boolean",
+            "description": "Whether Claude Code can start on the host."
+          },
+          "status": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/HooksStatus"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Null when the host is offline or could not be read; `error` says why."
+          },
+          "error": {
             "type": "string"
           }
         },
@@ -24961,6 +25460,24 @@
                   "install": {
                     "type": "string"
                   },
+                  "resources": {
+                    "type": "object",
+                    "properties": {
+                      "cpu": {
+                        "type": "number"
+                      },
+                      "memory": {
+                        "type": "string"
+                      },
+                      "disk": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "cpu"
+                    ],
+                    "additionalProperties": false
+                  },
                   "build": {
                     "type": "object",
                     "properties": {
@@ -24996,24 +25513,6 @@
                     "items": {
                       "type": "string"
                     }
-                  },
-                  "resources": {
-                    "type": "object",
-                    "properties": {
-                      "cpu": {
-                        "type": "number"
-                      },
-                      "memory": {
-                        "type": "string"
-                      },
-                      "disk": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "cpu"
-                    ],
-                    "additionalProperties": false
                   }
                 },
                 "additionalProperties": false
@@ -25329,6 +25828,24 @@
                   "install": {
                     "type": "string"
                   },
+                  "resources": {
+                    "type": "object",
+                    "properties": {
+                      "cpu": {
+                        "type": "number"
+                      },
+                      "memory": {
+                        "type": "string"
+                      },
+                      "disk": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "cpu"
+                    ],
+                    "additionalProperties": false
+                  },
                   "build": {
                     "type": "object",
                     "properties": {
@@ -25364,24 +25881,6 @@
                     "items": {
                       "type": "string"
                     }
-                  },
-                  "resources": {
-                    "type": "object",
-                    "properties": {
-                      "cpu": {
-                        "type": "number"
-                      },
-                      "memory": {
-                        "type": "string"
-                      },
-                      "disk": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "cpu"
-                    ],
-                    "additionalProperties": false
                   }
                 },
                 "additionalProperties": false