@band-app/server 0.63.0 → 0.64.0

package/dist/openapi.json

@@ -721,6 +721,12 @@
                                       "null"
                                     ]
                                   },
+                                  "languageServers": {
+                                    "type": "array",
+                                    "items": {
+                                      "$ref": "#/components/schemas/LanguageServerView"
+                                    }
+                                  },
                                   "extensionServices": {
                                     "type": "array",
                                     "items": {
@@ -851,6 +857,7 @@
                                   "manualCommand",
                                   "capabilities",
                                   "sleepError",
+                                  "languageServers",
                                   "extensionServices",
                                   "id",
                                   "name",
@@ -1082,8 +1089,8 @@
                                 "state": {
                                   "type": "string",
                                   "enum": [
-                                    "idle",
                                     "failed",
+                                    "idle",
                                     "updating"
                                   ]
                                 },
@@ -2306,6 +2313,12 @@
                                       "null"
                                     ]
                                   },
+                                  "languageServers": {
+                                    "type": "array",
+                                    "items": {
+                                      "$ref": "#/components/schemas/LanguageServerView"
+                                    }
+                                  },
                                   "extensionServices": {
                                     "type": "array",
                                     "items": {
@@ -2436,6 +2449,7 @@
                                   "manualCommand",
                                   "capabilities",
                                   "sleepError",
+                                  "languageServers",
                                   "extensionServices",
                                   "id",
                                   "name",
@@ -2667,8 +2681,8 @@
                                 "state": {
                                   "type": "string",
                                   "enum": [
-                                    "idle",
                                     "failed",
+                                    "idle",
                                     "updating"
                                   ]
                                 },
@@ -9636,12 +9650,12 @@
                                       "type": "string"
                                     }
                                   },
-                                  "worker": {
-                                    "type": "boolean"
-                                  },
                                   "version": {
                                     "type": "string"
                                   },
+                                  "worker": {
+                                    "type": "boolean"
+                                  },
                                   "sha256": {
                                     "type": "string"
                                   },
@@ -9659,8 +9673,8 @@
                                   "description",
                                   "name",
                                   "requires",
-                                  "worker",
                                   "version",
+                                  "worker",
                                   "sha256",
                                   "minBand"
                                 ],
@@ -9815,7 +9829,7 @@
                                     "additionalProperties": false
                                   }
                                 },
-                                "fileEditors": {
+                                "languageServers": {
                                   "type": "array",
                                   "items": {
                                     "type": "object",
@@ -9823,236 +9837,52 @@
                                       "id": {
                                         "type": "string"
                                       },
-                                      "label": {
-                                        "type": "string"
-                                      },
-                                      "binary": {
-                                        "type": "boolean",
-                                        "description": "The editor reads and writes bytes, not text."
+                                      "command": {
+                                        "type": "string",
+                                        "description": "A file in the extension folder that ends in `.js`, `.mjs` or `.cjs` (run with the worker's\nnode), or the name of a binary on the worker's PATH."
                                       },
-                                      "selector": {
+                                      "requires": {
                                         "type": "array",
                                         "items": {
                                           "type": "string"
                                         }
                                       },
-                                      "default": {
-                                        "type": "boolean"
-                                      },
-                                      "entry": {
-                                        "type": "string"
+                                      "files": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "File name globs, matched like a file editor's `selector`."
                                       },
-                                      "tools": {
-                                        "type": "string",
-                                        "description": "The editor's `tools/list` answer, a JSON file in the folder."
-                                      }
-                                    },
-                                    "required": [
-                                      "id",
-                                      "label",
-                                      "binary",
-                                      "selector",
-                                      "default",
-                                      "entry"
-                                    ],
-                                    "additionalProperties": false
-                                  }
-                                },
-                                "workerServices": {
-                                  "type": "array",
-                                  "items": {
-                                    "type": "object",
-                                    "properties": {
-                                      "id": {
-                                        "type": "string"
+                                      "languages": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "LSP languageIds the server handles, such as `typescript` and `typescriptreact`."
                                       },
-                                      "requires": {
+                                      "args": {
                                         "type": "array",
                                         "items": {
                                           "type": "string"
                                         }
                                       },
-                                      "capability": {
-                                        "type": "string",
-                                        "description": "What the worker reports in its capabilities while the service runs. The hub's `plugin.call` names it."
-                                      },
-                                      "entry": {
-                                        "type": "string"
+                                      "rootMarkers": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "Files at the worktree root that mark a project. With none present the server is not offered. Empty means always."
                                       }
                                     },
                                     "required": [
                                       "id",
+                                      "command",
                                       "requires",
-                                      "capability",
-                                      "entry"
-                                    ],
-                                    "additionalProperties": false
-                                  }
-                                },
-                                "panels": {
-                                  "type": "array",
-                                  "items": {
-                                    "type": "object",
-                                    "properties": {
-                                      "id": {
-                                        "type": "string"
-                                      },
-                                      "label": {
-                                        "type": "string"
-                                      },
-                                      "capability": {
-                                        "type": "string",
-                                        "description": "The `capability` of one of this extension's worker services."
-                                      },
-                                      "entry": {
-                                        "type": "string"
-                                      },
-                                      "defaultControl": {
-                                        "type": "boolean",
-                                        "description": "Accepted so existing manifests keep loading. It has no effect: panel streams always accept\ninput."
-                                      },
-                                      "icon": {
-                                        "type": "string",
-                                        "description": "A lucide icon name. Unknown names fall back to a generic icon."
-                                      }
-                                    },
-                                    "required": [
-                                      "id",
-                                      "label",
-                                      "capability",
-                                      "entry",
-                                      "defaultControl"
-                                    ],
-                                    "additionalProperties": false
-                                  }
-                                }
-                              },
-                              "required": [
-                                "tools",
-                                "fileEditors",
-                                "workerServices",
-                                "panels"
-                              ],
-                              "additionalProperties": false
-                            }
-                          },
-                          "required": [
-                            "id",
-                            "name",
-                            "version",
-                            "extensionApi",
-                            "contributes"
-                          ],
-                          "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
-              }
-            }
-          }
-        }
-      }
-    },
-    "/extensions.install": {
-      "post": {
-        "operationId": "extensions.install",
-        "tags": [
-          "extensions"
-        ],
-        "responses": {
-          "200": {
-            "description": "Successful response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "result": {
-                      "type": "object",
-                      "properties": {
-                        "data": {
-                          "type": "object",
-                          "properties": {
-                            "id": {
-                              "type": "string"
-                            },
-                            "name": {
-                              "type": "string"
-                            },
-                            "version": {
-                              "type": "string"
-                            },
-                            "extensionApi": {
-                              "type": "number",
-                              "const": 1
-                            },
-                            "contributes": {
-                              "type": "object",
-                              "properties": {
-                                "tools": {
-                                  "type": "array",
-                                  "items": {
-                                    "type": "object",
-                                    "properties": {
-                                      "agent": {
-                                        "type": "boolean",
-                                        "description": "`false` leaves the tool out of the agent's list."
-                                      },
-                                      "description": {
-                                        "type": "string"
-                                      },
-                                      "name": {
-                                        "type": "string"
-                                      },
-                                      "method": {
-                                        "type": "string"
-                                      },
-                                      "inputSchema": {
-                                        "type": "object",
-                                        "additionalProperties": {}
-                                      },
-                                      "service": {
-                                        "type": "string",
-                                        "description": "The `id` of one of this extension's worker services."
-                                      }
-                                    },
-                                    "required": [
-                                      "agent",
-                                      "description",
-                                      "name",
-                                      "method",
-                                      "inputSchema",
-                                      "service"
+                                      "files",
+                                      "languages",
+                                      "args",
+                                      "rootMarkers"
                                     ],
                                     "additionalProperties": false
                                   }
@@ -10072,15 +9902,15 @@
                                         "type": "boolean",
                                         "description": "The editor reads and writes bytes, not text."
                                       },
+                                      "default": {
+                                        "type": "boolean"
+                                      },
                                       "selector": {
                                         "type": "array",
                                         "items": {
                                           "type": "string"
                                         }
                                       },
-                                      "default": {
-                                        "type": "boolean"
-                                      },
                                       "entry": {
                                         "type": "string"
                                       },
@@ -10093,8 +9923,8 @@
                                       "id",
                                       "label",
                                       "binary",
-                                      "selector",
                                       "default",
+                                      "selector",
                                       "entry"
                                     ],
                                     "additionalProperties": false
@@ -10120,13 +9950,21 @@
                                       },
                                       "entry": {
                                         "type": "string"
+                                      },
+                                      "worktreeEnv": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "Variables the service may add to the environment of the agents and terminals of a worktree\non this worker, through its `worktreeEnv` handler. A variable not listed is ignored."
                                       }
                                     },
                                     "required": [
                                       "id",
                                       "requires",
                                       "capability",
-                                      "entry"
+                                      "entry",
+                                      "worktreeEnv"
                                     ],
                                     "additionalProperties": false
                                   }
@@ -10153,6 +9991,10 @@
                                         "type": "boolean",
                                         "description": "Accepted so existing manifests keep loading. It has no effect: panel streams always accept\ninput."
                                       },
+                                      "binaryInput": {
+                                        "type": "boolean",
+                                        "description": "Binary frames from the page (1 MiB at most each) reach the service, as text frames do.\nWithout it every binary frame from the page is dropped."
+                                      },
                                       "icon": {
                                         "type": "string",
                                         "description": "A lucide icon name. Unknown names fall back to a generic icon."
@@ -10163,7 +10005,8 @@
                                       "label",
                                       "capability",
                                       "entry",
-                                      "defaultControl"
+                                      "defaultControl",
+                                      "binaryInput"
                                     ],
                                     "additionalProperties": false
                                   }
@@ -10171,11 +10014,334 @@
                               },
                               "required": [
                                 "tools",
+                                "languageServers",
                                 "fileEditors",
                                 "workerServices",
                                 "panels"
                               ],
                               "additionalProperties": false
+                            },
+                            "agentHint": {
+                              "type": "string",
+                              "description": "One standing instruction for agents. The built-in `band` MCP server sends it as part of its\nMCP `instructions`, so it reaches the system prompt of every chat. Keep it to one line."
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "name",
+                            "version",
+                            "extensionApi",
+                            "contributes"
+                          ],
+                          "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
+              }
+            }
+          }
+        }
+      }
+    },
+    "/extensions.install": {
+      "post": {
+        "operationId": "extensions.install",
+        "tags": [
+          "extensions"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "string"
+                            },
+                            "name": {
+                              "type": "string"
+                            },
+                            "version": {
+                              "type": "string"
+                            },
+                            "extensionApi": {
+                              "type": "number",
+                              "const": 1
+                            },
+                            "contributes": {
+                              "type": "object",
+                              "properties": {
+                                "tools": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "agent": {
+                                        "type": "boolean",
+                                        "description": "`false` leaves the tool out of the agent's list."
+                                      },
+                                      "description": {
+                                        "type": "string"
+                                      },
+                                      "name": {
+                                        "type": "string"
+                                      },
+                                      "method": {
+                                        "type": "string"
+                                      },
+                                      "inputSchema": {
+                                        "type": "object",
+                                        "additionalProperties": {}
+                                      },
+                                      "service": {
+                                        "type": "string",
+                                        "description": "The `id` of one of this extension's worker services."
+                                      }
+                                    },
+                                    "required": [
+                                      "agent",
+                                      "description",
+                                      "name",
+                                      "method",
+                                      "inputSchema",
+                                      "service"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "languageServers": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "id": {
+                                        "type": "string"
+                                      },
+                                      "command": {
+                                        "type": "string",
+                                        "description": "A file in the extension folder that ends in `.js`, `.mjs` or `.cjs` (run with the worker's\nnode), or the name of a binary on the worker's PATH."
+                                      },
+                                      "requires": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "files": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "File name globs, matched like a file editor's `selector`."
+                                      },
+                                      "languages": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "LSP languageIds the server handles, such as `typescript` and `typescriptreact`."
+                                      },
+                                      "args": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "rootMarkers": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "Files at the worktree root that mark a project. With none present the server is not offered. Empty means always."
+                                      }
+                                    },
+                                    "required": [
+                                      "id",
+                                      "command",
+                                      "requires",
+                                      "files",
+                                      "languages",
+                                      "args",
+                                      "rootMarkers"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "fileEditors": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "id": {
+                                        "type": "string"
+                                      },
+                                      "label": {
+                                        "type": "string"
+                                      },
+                                      "binary": {
+                                        "type": "boolean",
+                                        "description": "The editor reads and writes bytes, not text."
+                                      },
+                                      "default": {
+                                        "type": "boolean"
+                                      },
+                                      "selector": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "entry": {
+                                        "type": "string"
+                                      },
+                                      "tools": {
+                                        "type": "string",
+                                        "description": "The editor's `tools/list` answer, a JSON file in the folder."
+                                      }
+                                    },
+                                    "required": [
+                                      "id",
+                                      "label",
+                                      "binary",
+                                      "default",
+                                      "selector",
+                                      "entry"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "workerServices": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "id": {
+                                        "type": "string"
+                                      },
+                                      "requires": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "capability": {
+                                        "type": "string",
+                                        "description": "What the worker reports in its capabilities while the service runs. The hub's `plugin.call` names it."
+                                      },
+                                      "entry": {
+                                        "type": "string"
+                                      },
+                                      "worktreeEnv": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "string"
+                                        },
+                                        "description": "Variables the service may add to the environment of the agents and terminals of a worktree\non this worker, through its `worktreeEnv` handler. A variable not listed is ignored."
+                                      }
+                                    },
+                                    "required": [
+                                      "id",
+                                      "requires",
+                                      "capability",
+                                      "entry",
+                                      "worktreeEnv"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                },
+                                "panels": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "id": {
+                                        "type": "string"
+                                      },
+                                      "label": {
+                                        "type": "string"
+                                      },
+                                      "capability": {
+                                        "type": "string",
+                                        "description": "The `capability` of one of this extension's worker services."
+                                      },
+                                      "entry": {
+                                        "type": "string"
+                                      },
+                                      "defaultControl": {
+                                        "type": "boolean",
+                                        "description": "Accepted so existing manifests keep loading. It has no effect: panel streams always accept\ninput."
+                                      },
+                                      "binaryInput": {
+                                        "type": "boolean",
+                                        "description": "Binary frames from the page (1 MiB at most each) reach the service, as text frames do.\nWithout it every binary frame from the page is dropped."
+                                      },
+                                      "icon": {
+                                        "type": "string",
+                                        "description": "A lucide icon name. Unknown names fall back to a generic icon."
+                                      }
+                                    },
+                                    "required": [
+                                      "id",
+                                      "label",
+                                      "capability",
+                                      "entry",
+                                      "defaultControl",
+                                      "binaryInput"
+                                    ],
+                                    "additionalProperties": false
+                                  }
+                                }
+                              },
+                              "required": [
+                                "tools",
+                                "languageServers",
+                                "fileEditors",
+                                "workerServices",
+                                "panels"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "agentHint": {
+                              "type": "string",
+                              "description": "One standing instruction for agents. The built-in `band` MCP server sends it as part of its\nMCP `instructions`, so it reaches the system prompt of every chat. Keep it to one line."
                             }
                           },
                           "required": [
@@ -10356,18 +10522,18 @@
                   "worktreeId": {
                     "type": "string"
                   },
-                  "capability": {
+                  "method": {
                     "type": "string"
                   },
-                  "method": {
+                  "capability": {
                     "type": "string"
                   },
                   "params": {}
                 },
                 "required": [
                   "worktreeId",
-                  "capability",
-                  "method"
+                  "method",
+                  "capability"
                 ],
                 "additionalProperties": false
               }
@@ -10436,22 +10602,22 @@
                   "worktreeId": {
                     "type": "string"
                   },
-                  "panelId": {
+                  "method": {
                     "type": "string"
                   },
-                  "extensionId": {
+                  "panelId": {
                     "type": "string"
                   },
-                  "method": {
+                  "extensionId": {
                     "type": "string"
                   },
                   "params": {}
                 },
                 "required": [
                   "worktreeId",
+                  "method",
                   "panelId",
-                  "extensionId",
-                  "method"
+                  "extensionId"
                 ],
                 "additionalProperties": false
               }
@@ -10567,6 +10733,64 @@
                                           "additionalProperties": false
                                         }
                                       },
+                                      "languageServers": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "object",
+                                          "properties": {
+                                            "id": {
+                                              "type": "string"
+                                            },
+                                            "command": {
+                                              "type": "string",
+                                              "description": "A file in the extension folder that ends in `.js`, `.mjs` or `.cjs` (run with the worker's\nnode), or the name of a binary on the worker's PATH."
+                                            },
+                                            "requires": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            "files": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "File name globs, matched like a file editor's `selector`."
+                                            },
+                                            "languages": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "LSP languageIds the server handles, such as `typescript` and `typescriptreact`."
+                                            },
+                                            "args": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            "rootMarkers": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "Files at the worktree root that mark a project. With none present the server is not offered. Empty means always."
+                                            }
+                                          },
+                                          "required": [
+                                            "id",
+                                            "command",
+                                            "requires",
+                                            "files",
+                                            "languages",
+                                            "args",
+                                            "rootMarkers"
+                                          ],
+                                          "additionalProperties": false
+                                        }
+                                      },
                                       "fileEditors": {
                                         "type": "array",
                                         "items": {
@@ -10582,15 +10806,15 @@
                                               "type": "boolean",
                                               "description": "The editor reads and writes bytes, not text."
                                             },
+                                            "default": {
+                                              "type": "boolean"
+                                            },
                                             "selector": {
                                               "type": "array",
                                               "items": {
                                                 "type": "string"
                                               }
                                             },
-                                            "default": {
-                                              "type": "boolean"
-                                            },
                                             "entry": {
                                               "type": "string"
                                             },
@@ -10603,8 +10827,8 @@
                                             "id",
                                             "label",
                                             "binary",
-                                            "selector",
                                             "default",
+                                            "selector",
                                             "entry"
                                           ],
                                           "additionalProperties": false
@@ -10630,13 +10854,21 @@
                                             },
                                             "entry": {
                                               "type": "string"
+                                            },
+                                            "worktreeEnv": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "Variables the service may add to the environment of the agents and terminals of a worktree\non this worker, through its `worktreeEnv` handler. A variable not listed is ignored."
                                             }
                                           },
                                           "required": [
                                             "id",
                                             "requires",
                                             "capability",
-                                            "entry"
+                                            "entry",
+                                            "worktreeEnv"
                                           ],
                                           "additionalProperties": false
                                         }
@@ -10663,6 +10895,10 @@
                                               "type": "boolean",
                                               "description": "Accepted so existing manifests keep loading. It has no effect: panel streams always accept\ninput."
                                             },
+                                            "binaryInput": {
+                                              "type": "boolean",
+                                              "description": "Binary frames from the page (1 MiB at most each) reach the service, as text frames do.\nWithout it every binary frame from the page is dropped."
+                                            },
                                             "icon": {
                                               "type": "string",
                                               "description": "A lucide icon name. Unknown names fall back to a generic icon."
@@ -10673,7 +10909,8 @@
                                             "label",
                                             "capability",
                                             "entry",
-                                            "defaultControl"
+                                            "defaultControl",
+                                            "binaryInput"
                                           ],
                                           "additionalProperties": false
                                         }
@@ -10681,11 +10918,16 @@
                                     },
                                     "required": [
                                       "tools",
+                                      "languageServers",
                                       "fileEditors",
                                       "workerServices",
                                       "panels"
                                     ],
                                     "additionalProperties": false
+                                  },
+                                  "agentHint": {
+                                    "type": "string",
+                                    "description": "One standing instruction for agents. The built-in `band` MCP server sends it as part of its\nMCP `instructions`, so it reaches the system prompt of every chat. Keep it to one line."
                                   }
                                 },
                                 "required": [
@@ -10846,6 +11088,64 @@
                                           "additionalProperties": false
                                         }
                                       },
+                                      "languageServers": {
+                                        "type": "array",
+                                        "items": {
+                                          "type": "object",
+                                          "properties": {
+                                            "id": {
+                                              "type": "string"
+                                            },
+                                            "command": {
+                                              "type": "string",
+                                              "description": "A file in the extension folder that ends in `.js`, `.mjs` or `.cjs` (run with the worker's\nnode), or the name of a binary on the worker's PATH."
+                                            },
+                                            "requires": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            "files": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "File name globs, matched like a file editor's `selector`."
+                                            },
+                                            "languages": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "LSP languageIds the server handles, such as `typescript` and `typescriptreact`."
+                                            },
+                                            "args": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            "rootMarkers": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "Files at the worktree root that mark a project. With none present the server is not offered. Empty means always."
+                                            }
+                                          },
+                                          "required": [
+                                            "id",
+                                            "command",
+                                            "requires",
+                                            "files",
+                                            "languages",
+                                            "args",
+                                            "rootMarkers"
+                                          ],
+                                          "additionalProperties": false
+                                        }
+                                      },
                                       "fileEditors": {
                                         "type": "array",
                                         "items": {
@@ -10861,15 +11161,15 @@
                                               "type": "boolean",
                                               "description": "The editor reads and writes bytes, not text."
                                             },
+                                            "default": {
+                                              "type": "boolean"
+                                            },
                                             "selector": {
                                               "type": "array",
                                               "items": {
                                                 "type": "string"
                                               }
                                             },
-                                            "default": {
-                                              "type": "boolean"
-                                            },
                                             "entry": {
                                               "type": "string"
                                             },
@@ -10882,8 +11182,8 @@
                                             "id",
                                             "label",
                                             "binary",
-                                            "selector",
                                             "default",
+                                            "selector",
                                             "entry"
                                           ],
                                           "additionalProperties": false
@@ -10909,13 +11209,21 @@
                                             },
                                             "entry": {
                                               "type": "string"
+                                            },
+                                            "worktreeEnv": {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              },
+                                              "description": "Variables the service may add to the environment of the agents and terminals of a worktree\non this worker, through its `worktreeEnv` handler. A variable not listed is ignored."
                                             }
                                           },
                                           "required": [
                                             "id",
                                             "requires",
                                             "capability",
-                                            "entry"
+                                            "entry",
+                                            "worktreeEnv"
                                           ],
                                           "additionalProperties": false
                                         }
@@ -10942,6 +11250,10 @@
                                               "type": "boolean",
                                               "description": "Accepted so existing manifests keep loading. It has no effect: panel streams always accept\ninput."
                                             },
+                                            "binaryInput": {
+                                              "type": "boolean",
+                                              "description": "Binary frames from the page (1 MiB at most each) reach the service, as text frames do.\nWithout it every binary frame from the page is dropped."
+                                            },
                                             "icon": {
                                               "type": "string",
                                               "description": "A lucide icon name. Unknown names fall back to a generic icon."
@@ -10952,7 +11264,8 @@
                                             "label",
                                             "capability",
                                             "entry",
-                                            "defaultControl"
+                                            "defaultControl",
+                                            "binaryInput"
                                           ],
                                           "additionalProperties": false
                                         }
@@ -10960,11 +11273,16 @@
                                     },
                                     "required": [
                                       "tools",
+                                      "languageServers",
                                       "fileEditors",
                                       "workerServices",
                                       "panels"
                                     ],
                                     "additionalProperties": false
+                                  },
+                                  "agentHint": {
+                                    "type": "string",
+                                    "description": "One standing instruction for agents. The built-in `band` MCP server sends it as part of its\nMCP `instructions`, so it reaches the system prompt of every chat. Keep it to one line."
                                   }
                                 },
                                 "required": [
@@ -11188,6 +11506,12 @@
                       "null"
                     ]
                   },
+                  "args": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
                   "transport": {
                     "type": "string",
                     "enum": [
@@ -11195,12 +11519,6 @@
                       "stdio"
                     ]
                   },
-                  "args": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  },
                   "headerName": {
                     "type": "string"
                   },
@@ -22885,13 +23203,147 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "chatId": {
-                      "type": "string"
-                    },
-                    "worktreeId": {
+                    "chatId": {
+                      "type": "string"
+                    },
+                    "worktreeId": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/subscriptions.remove": {
+      "post": {
+        "operationId": "subscriptions.remove",
+        "tags": [
+          "subscriptions"
+        ],
+        "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": {
+                  "id": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions.events": {
+      "get": {
+        "operationId": "subscriptions.events",
+        "tags": [
+          "subscriptions"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/components/schemas/SubscriptionEventRecord"
+                          }
+                        }
+                      },
+                      "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"
                     }
                   },
+                  "required": [
+                    "id"
+                  ],
                   "additionalProperties": false
                 }
               }
@@ -22900,11 +23352,11 @@
         ]
       }
     },
-    "/subscriptions.remove": {
-      "post": {
-        "operationId": "subscriptions.remove",
+    "/tools.list": {
+      "get": {
+        "operationId": "tools.list",
         "tags": [
-          "subscriptions"
+          "tools"
         ],
         "responses": {
           "200": {
@@ -22918,17 +23370,47 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
-                            }
-                          },
-                          "required": [
-                            "ok"
-                          ],
-                          "additionalProperties": false
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "name": {
+                                "type": "string"
+                              },
+                              "description": {
+                                "type": "string"
+                              },
+                              "inputSchema": {
+                                "type": "object",
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "object"
+                                  },
+                                  "properties": {
+                                    "type": "object",
+                                    "additionalProperties": {}
+                                  },
+                                  "required": {
+                                    "type": "array",
+                                    "items": {
+                                      "type": "string"
+                                    }
+                                  }
+                                },
+                                "required": [
+                                  "type"
+                                ],
+                                "additionalProperties": {}
+                              }
+                            },
+                            "required": [
+                              "name",
+                              "description",
+                              "inputSchema"
+                            ],
+                            "additionalProperties": false
+                          }
                         }
                       },
                       "required": [
@@ -22947,32 +23429,39 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "id": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "additionalProperties": false
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "chatId": {
+                      "type": "string",
+                      "description": "The chat the call acts for. Wins over `worktreeId`."
+                    },
+                    "worktreeId": {
+                      "type": "string",
+                      "description": "The worktree of a terminal with no chat."
+                    }
+                  },
+                  "additionalProperties": false
+                }
               }
             }
           }
-        }
+        ]
       }
     },
-    "/subscriptions.events": {
-      "get": {
-        "operationId": "subscriptions.events",
+    "/tools.run": {
+      "post": {
+        "operationId": "tools.run",
         "tags": [
-          "subscriptions"
+          "tools"
         ],
         "responses": {
           "200": {
@@ -22986,10 +23475,21 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "array",
-                          "items": {
-                            "$ref": "#/components/schemas/SubscriptionEventRecord"
-                          }
+                          "type": "object",
+                          "properties": {
+                            "isError": {
+                              "type": "boolean"
+                            },
+                            "content": {
+                              "type": "array",
+                              "items": {}
+                            }
+                          },
+                          "required": [
+                            "isError",
+                            "content"
+                          ],
+                          "additionalProperties": false
                         }
                       },
                       "required": [
@@ -23008,30 +23508,37 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "parameters": [
-          {
-            "name": "input",
-            "in": "query",
-            "required": true,
-            "style": "deepObject",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string"
-                    }
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
                   },
-                  "required": [
-                    "id"
-                  ],
-                  "additionalProperties": false
-                }
+                  "chatId": {
+                    "type": "string",
+                    "description": "The chat the call acts for. Wins over `worktreeId`."
+                  },
+                  "worktreeId": {
+                    "type": "string",
+                    "description": "The worktree of a terminal with no chat."
+                  },
+                  "arguments": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
               }
             }
           }
-        ]
+        }
       }
     },
     "/chats.list": {
@@ -24412,17 +24919,17 @@
                   "chatId": {
                     "type": "string"
                   },
-                  "requestId": {
-                    "type": "string"
-                  },
                   "action": {
                     "type": "string",
                     "enum": [
+                      "cancel",
                       "accept",
-                      "decline",
-                      "cancel"
+                      "decline"
                     ]
                   },
+                  "requestId": {
+                    "type": "string"
+                  },
                   "content": {
                     "type": "object",
                     "additionalProperties": {
@@ -24448,8 +24955,8 @@
                 },
                 "required": [
                   "chatId",
-                  "requestId",
-                  "action"
+                  "action",
+                  "requestId"
                 ],
                 "additionalProperties": false
               }
@@ -26058,20 +26565,20 @@
                       "prompt": {
                         "type": "string"
                       },
-                      "agentId": {
-                        "type": "string"
-                      },
                       "action": {
                         "type": "string",
                         "const": "agent"
+                      },
+                      "agentId": {
+                        "type": "string"
                       }
                     },
                     "required": [
                       "label",
                       "repo",
                       "prompt",
-                      "agentId",
-                      "action"
+                      "action",
+                      "agentId"
                     ],
                     "additionalProperties": false
                   }
@@ -26281,20 +26788,20 @@
                           "prompt": {
                             "type": "string"
                           },
-                          "agentId": {
-                            "type": "string"
-                          },
                           "action": {
                             "type": "string",
                             "const": "agent"
+                          },
+                          "agentId": {
+                            "type": "string"
                           }
                         },
                         "required": [
                           "label",
                           "repo",
                           "prompt",
-                          "agentId",
-                          "action"
+                          "action",
+                          "agentId"
                         ],
                         "additionalProperties": false
                       }
@@ -26952,9 +27459,9 @@
                                   "status": {
                                     "type": "string",
                                     "enum": [
-                                      "running",
                                       "completed",
-                                      "failed"
+                                      "failed",
+                                      "running"
                                     ],
                                     "description": "Persisted-task status. Mirrors the `tasks.status` enum in `schema.ts`.\n\nKept distinct from the in-memory `TaskInfo.status` (declared in the\nservice tier) because the service tier may add transient states (e.g.\n`pending` for queued tasks) without touching the persisted column."
                                   },
@@ -27030,9 +27537,9 @@
                     "status": {
                       "type": "string",
                       "enum": [
-                        "running",
                         "completed",
-                        "failed"
+                        "failed",
+                        "running"
                       ]
                     },
                     "chatId": {
@@ -28314,6 +28821,51 @@
         ],
         "additionalProperties": false
       },
+      "LanguageServerView": {
+        "type": "object",
+        "properties": {
+          "extensionId": {
+            "type": "string"
+          },
+          "serverId": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "languages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "ready",
+              "unavailable"
+            ]
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "extensionId",
+          "serverId",
+          "key",
+          "languages",
+          "files",
+          "state"
+        ],
+        "additionalProperties": false
+      },
       "ExtensionServiceView": {
         "type": "object",
         "properties": {
@@ -28332,9 +28884,9 @@
           "state": {
             "type": "string",
             "enum": [
+              "failed",
               "running",
               "stopped",
-              "failed",
               "restarting",
               "not-eligible"
             ]
@@ -28726,6 +29278,24 @@
                       "type": "string"
                     }
                   },
+                  "resources": {
+                    "type": "object",
+                    "properties": {
+                      "cpu": {
+                        "type": "number"
+                      },
+                      "memory": {
+                        "type": "string"
+                      },
+                      "disk": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "cpu"
+                    ],
+                    "additionalProperties": false
+                  },
                   "terminals": {
                     "type": "array",
                     "items": {
@@ -28748,35 +29318,17 @@
                   "install": {
                     "type": "string"
                   },
-                  "resources": {
+                  "build": {
                     "type": "object",
                     "properties": {
-                      "cpu": {
-                        "type": "number"
-                      },
-                      "memory": {
+                      "image": {
                         "type": "string"
                       },
-                      "disk": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "cpu"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "build": {
-                    "type": "object",
-                    "properties": {
                       "devcontainer": {
                         "type": "string"
                       },
                       "dockerfile": {
                         "type": "string"
-                      },
-                      "image": {
-                        "type": "string"
                       }
                     },
                     "additionalProperties": false
@@ -28983,8 +29535,8 @@
           "status": {
             "type": "string",
             "enum": [
-              "ready",
               "failed",
+              "ready",
               "building"
             ]
           },
@@ -29094,6 +29646,24 @@
                       "type": "string"
                     }
                   },
+                  "resources": {
+                    "type": "object",
+                    "properties": {
+                      "cpu": {
+                        "type": "number"
+                      },
+                      "memory": {
+                        "type": "string"
+                      },
+                      "disk": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "cpu"
+                    ],
+                    "additionalProperties": false
+                  },
                   "terminals": {
                     "type": "array",
                     "items": {
@@ -29116,35 +29686,17 @@
                   "install": {
                     "type": "string"
                   },
-                  "resources": {
+                  "build": {
                     "type": "object",
                     "properties": {
-                      "cpu": {
-                        "type": "number"
-                      },
-                      "memory": {
+                      "image": {
                         "type": "string"
                       },
-                      "disk": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "cpu"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "build": {
-                    "type": "object",
-                    "properties": {
                       "devcontainer": {
                         "type": "string"
                       },
                       "dockerfile": {
                         "type": "string"
-                      },
-                      "image": {
-                        "type": "string"
                       }
                     },
                     "additionalProperties": false
@@ -32113,11 +32665,11 @@
             "enum": [
               "unknown",
               "limit",
+              "timeout",
               "exit",
               "killed",
               "auth",
-              "disconnected",
-              "timeout"
+              "disconnected"
             ],
             "description": "Why a chat's agent failed. The hub classifies it, the chat renders it as a card."
           },
@@ -33931,9 +34483,9 @@
             "type": "string",
             "enum": [
               "aborted",
+              "failed",
               "running",
-              "ready",
-              "failed"
+              "ready"
             ]
           },
           "attempt": {
@@ -34274,9 +34826,9 @@
           "kind": {
             "type": "string",
             "enum": [
-              "tailscale",
               "ipv4",
               "ipv6",
+              "tailscale",
               "bridge"
             ]
           },
@@ -35211,8 +35763,8 @@
           "status": {
             "type": "string",
             "enum": [
-              "failed",
               "working",
+              "failed",
               "monitoring",
               "question",
               "done"
@@ -35599,8 +36151,8 @@
           "state": {
             "type": "string",
             "enum": [
-              "running",
               "cancelled",
+              "running",
               "pending",
               "success",
               "failure",
@@ -35656,8 +36208,8 @@
           "state": {
             "type": "string",
             "enum": [
-              "running",
               "cancelled",
+              "running",
               "pending",
               "skipped",
               "success",
@@ -37687,9 +38239,9 @@
           "status": {
             "type": "string",
             "enum": [
-              "running",
               "completed",
-              "failed"
+              "failed",
+              "running"
             ]
           },
           "startedAt": {