@band-app/server 0.33.0 → 0.35.0

package/dist/openapi.json

@@ -1562,6 +1562,74 @@
         }
       }
     },
+    "/statuses.refreshBranchStatus": {
+      "post": {
+        "operationId": "statuses.refreshBranchStatus",
+        "description": "Re-read one workspace's git status now and push it on the status stream.\nThe dashboard calls this when the user selects a workspace, so its badge\ndoesn't wait for the next poll tick. `refreshed` is false when no git\nworkspace has that id.",
+        "tags": [
+          "statuses"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "refreshed": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "refreshed"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "workspaceId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "workspaceId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/statuses.clearNeedsAttention": {
       "post": {
         "operationId": "statuses.clearNeedsAttention",
@@ -1707,7 +1775,7 @@
     "/statuses.notify": {
       "post": {
         "operationId": "statuses.notify",
-        "description": "Agent-agnostic entry point for coding-agent lifecycle notifications\n(e.g. Claude Code hooks piped through `band notify`). The CLI forwards\nthe raw payload plus the agent's cwd; the server resolves the workspace,\nlooks up its configured agent, and dispatches to that agent's adapter to\ntranslate the payload into a status. Keeping the mapping in the adapter\nmeans adding hook support for a new agent never touches the CLI.\n\nFire-and-forget semantics: unknown cwd → no-op `{ ok: true }` (matches the\nCLI hook contract, which must never fail and break the agent).",
+        "description": "Agent-agnostic entry point for coding-agent lifecycle notifications\n(e.g. Claude Code hooks piped through `band notify`). The CLI forwards\nthe raw payload plus the agent's cwd, the agent type the hook command\nnames (`--agent`), and its `BAND_DISPATCH` / `BAND_TERMINAL_ID`. The\nserver resolves the workspace and the sending agent, and dispatches to\nthat agent's adapter to translate the payload into a status. Keeping the\nmapping in the adapter means adding hook support for a new agent never\ntouches the CLI.\n\nFire-and-forget semantics: unknown cwd → no-op `{ ok: true }` (matches the\nCLI hook contract, which must never fail and break the agent).",
         "tags": [
           "statuses"
         ],
@@ -1764,6 +1832,15 @@
                   "payload": {
                     "type": "object",
                     "additionalProperties": {}
+                  },
+                  "agent": {
+                    "type": "string"
+                  },
+                  "terminalId": {
+                    "type": "string"
+                  },
+                  "dispatch": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -2326,10 +2403,10 @@
                   "range": {
                     "type": "string",
                     "enum": [
+                      "all",
                       "hour",
                       "day",
-                      "week",
-                      "all"
+                      "week"
                     ]
                   }
                 },
@@ -3042,6 +3119,297 @@
         ]
       }
     },
+    "/plugins.list": {
+      "get": {
+        "operationId": "plugins.list",
+        "description": "The bundled plugins and their state. The dashboard hides the UI of disabled ones.",
+        "tags": [
+          "plugins"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/components/schemas/PluginInfo"
+                          }
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
+    "/reviews.forWorkspace": {
+      "get": {
+        "operationId": "reviews.forWorkspace",
+        "description": "The review for the workspace's branch with its checks, or the branch's\nCI jobs when there is no review. Provider failures come back as\n`status: \"error\"` rather than a thrown error, so the panel can show them.",
+        "tags": [
+          "reviews"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "ok"
+                                },
+                                "provider": {
+                                  "type": "object",
+                                  "properties": {
+                                    "id": {
+                                      "type": "string"
+                                    },
+                                    "name": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "id",
+                                    "name"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                "repo": {
+                                  "$ref": "#/components/schemas/RepoInfo"
+                                },
+                                "branch": {
+                                  "type": "string"
+                                },
+                                "review": {
+                                  "oneOf": [
+                                    {
+                                      "$ref": "#/components/schemas/ReviewInfo"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "checks": {
+                                  "$ref": "#/components/schemas/ChecksReport"
+                                },
+                                "fetchedAt": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "provider",
+                                "repo",
+                                "branch",
+                                "review",
+                                "checks",
+                                "fetchedAt"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "unavailable"
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "plain-project",
+                                    "detached-head",
+                                    "no-remote",
+                                    "no-provider"
+                                  ]
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "status": {
+                                  "type": "string",
+                                  "const": "error"
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "status",
+                                "message"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "discriminator": {
+                            "propertyName": "status"
+                          },
+                          "description": "What the core returns for a workspace's review panel: the review for the\nworkspace's branch, or when there is none, the checks on the branch."
+                        }
+                      },
+                      "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": {
+                    "workspaceId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/reviews.merge": {
+      "post": {
+        "operationId": "reviews.merge",
+        "description": "Merge the workspace branch's open review.",
+        "tags": [
+          "reviews"
+        ],
+        "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": {
+                  "workspaceId": {
+                    "type": "string"
+                  },
+                  "method": {
+                    "type": "string",
+                    "enum": [
+                      "merge",
+                      "squash",
+                      "rebase"
+                    ]
+                  }
+                },
+                "required": [
+                  "workspaceId",
+                  "method"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/services.health": {
       "get": {
         "operationId": "services.health",
@@ -5206,17 +5574,52 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                }
+                              },
+                              "required": [
+                                "ok"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local-changes",
+                                    "no-upstream",
+                                    "behind-remote",
+                                    "nothing-to-commit"
+                                  ],
+                                  "description": "Result of a workspace git pull, push or commit, shared by the server and\nthe dashboard.\n\nGit refusing an operation for an ordinary reason (local changes in the way\nof a pull, a push the remote rejects as non-fast-forward, nothing to\ncommit) is a normal outcome, so the server returns it as `ok: false` with a\nplain-words `message` instead of throwing. The dashboard shows that message\nas an informational notice. Anything else still throws and shows as an\nerror."
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -5278,17 +5681,52 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                }
+                              },
+                              "required": [
+                                "ok"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local-changes",
+                                    "no-upstream",
+                                    "behind-remote",
+                                    "nothing-to-commit"
+                                  ],
+                                  "description": "Result of a workspace git pull, push or commit, shared by the server and\nthe dashboard.\n\nGit refusing an operation for an ordinary reason (local changes in the way\nof a pull, a push the remote rejects as non-fast-forward, nothing to\ncommit) is a normal outcome, so the server returns it as `ok: false` with a\nplain-words `message` instead of throwing. The dashboard shows that message\nas an informational notice. Anything else still throws and shows as an\nerror."
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -6455,17 +6893,52 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                }
+                              },
+                              "required": [
+                                "ok"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local-changes",
+                                    "no-upstream",
+                                    "behind-remote",
+                                    "nothing-to-commit"
+                                  ],
+                                  "description": "Result of a workspace git pull, push or commit, shared by the server and\nthe dashboard.\n\nGit refusing an operation for an ordinary reason (local changes in the way\nof a pull, a push the remote rejects as non-fast-forward, nothing to\ncommit) is a normal outcome, so the server returns it as `ok: false` with a\nplain-words `message` instead of throwing. The dashboard shows that message\nas an informational notice. Anything else still throws and shows as an\nerror."
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -6523,17 +6996,52 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                }
+                              },
+                              "required": [
+                                "ok"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local-changes",
+                                    "no-upstream",
+                                    "behind-remote",
+                                    "nothing-to-commit"
+                                  ],
+                                  "description": "Result of a workspace git pull, push or commit, shared by the server and\nthe dashboard.\n\nGit refusing an operation for an ordinary reason (local changes in the way\nof a pull, a push the remote rejects as non-fast-forward, nothing to\ncommit) is a normal outcome, so the server returns it as `ok: false` with a\nplain-words `message` instead of throwing. The dashboard shows that message\nas an informational notice. Anything else still throws and shows as an\nerror."
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -6591,17 +7099,52 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                }
+                              },
+                              "required": [
+                                "ok"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "local-changes",
+                                    "no-upstream",
+                                    "behind-remote",
+                                    "nothing-to-commit"
+                                  ],
+                                  "description": "Result of a workspace git pull, push or commit, shared by the server and\nthe dashboard.\n\nGit refusing an operation for an ordinary reason (local changes in the way\nof a pull, a push the remote rejects as non-fast-forward, nothing to\ncommit) is a normal outcome, so the server returns it as `ok: false` with a\nplain-words `message` instead of throwing. The dashboard shows that message\nas an informational notice. Anything else still throws and shows as an\nerror."
+                                },
+                                "message": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "reason",
+                                "message"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -10434,14 +10977,294 @@
               }
             }
           }
-        ]
+        ]
+      }
+    },
+    "/panelFocus.set": {
+      "post": {
+        "operationId": "panelFocus.set",
+        "tags": [
+          "panelFocus"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "ok": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "ok"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "workspaceId": {
+                    "type": "string"
+                  },
+                  "panelType": {
+                    "type": "string",
+                    "enum": [
+                      "chat",
+                      "terminal",
+                      "browser"
+                    ]
+                  },
+                  "panelId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "workspaceId",
+                  "panelType",
+                  "panelId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/clientState.list": {
+      "get": {
+        "operationId": "clientState.list",
+        "tags": [
+          "clientState"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "entries": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ClientStateEntry"
+                              }
+                            }
+                          },
+                          "required": [
+                            "entries"
+                          ],
+                          "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": {
+                    "workspaceId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "deviceType": {
+                      "type": "string",
+                      "enum": [
+                        "desktop",
+                        "mobile"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "workspaceId",
+                    "deviceType"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/clientState.set": {
+      "post": {
+        "operationId": "clientState.set",
+        "tags": [
+          "clientState"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                },
+                                "entry": {
+                                  "$ref": "#/components/schemas/ClientStateEntry"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "entry"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "entry": {
+                                  "$ref": "#/components/schemas/ClientStateEntry"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "entry"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "key": {
+                    "type": "string"
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "desktop",
+                      "mobile",
+                      "all"
+                    ]
+                  },
+                  "baseVersion": {
+                    "type": "number"
+                  },
+                  "clientId": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "required": [
+                  "key",
+                  "scope",
+                  "baseVersion",
+                  "clientId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
       }
     },
-    "/panelFocus.set": {
+    "/clientState.delete": {
       "post": {
-        "operationId": "panelFocus.set",
+        "operationId": "clientState.delete",
         "tags": [
-          "panelFocus"
+          "clientState"
         ],
         "responses": {
           "200": {
@@ -10455,16 +11278,45 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean"
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": true
+                                },
+                                "entry": {
+                                  "$ref": "#/components/schemas/ClientStateEntry"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "entry"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "ok": {
+                                  "type": "boolean",
+                                  "const": false
+                                },
+                                "entry": {
+                                  "$ref": "#/components/schemas/ClientStateEntry"
+                                }
+                              },
+                              "required": [
+                                "ok",
+                                "entry"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "ok"
                           ],
-                          "additionalProperties": false
+                          "discriminator": {
+                            "propertyName": "ok"
+                          }
                         }
                       },
                       "required": [
@@ -10490,25 +11342,29 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "workspaceId": {
+                  "key": {
                     "type": "string"
                   },
-                  "panelType": {
+                  "scope": {
                     "type": "string",
                     "enum": [
-                      "chat",
-                      "terminal",
-                      "browser"
+                      "desktop",
+                      "mobile",
+                      "all"
                     ]
                   },
-                  "panelId": {
+                  "baseVersion": {
+                    "type": "number"
+                  },
+                  "clientId": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "workspaceId",
-                  "panelType",
-                  "panelId"
+                  "key",
+                  "scope",
+                  "baseVersion",
+                  "clientId"
                 ],
                 "additionalProperties": false
               }
@@ -11518,6 +12374,242 @@
         ],
         "additionalProperties": false
       },
+      "PluginInfo": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "inactive",
+              "disabled",
+              "errored"
+            ]
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The last activation error, when `status` is `errored`."
+          },
+          "slots": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "const": "workspace.sideTabs"
+            }
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "version",
+          "status",
+          "error",
+          "slots"
+        ],
+        "additionalProperties": false
+      },
+      "RepoInfo": {
+        "type": "object",
+        "properties": {
+          "host": {
+            "type": "string"
+          },
+          "owner": {
+            "type": "string"
+          },
+          "repo": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "host",
+          "owner",
+          "repo"
+        ],
+        "additionalProperties": false
+      },
+      "ReviewInfo": {
+        "type": "object",
+        "properties": {
+          "number": {
+            "type": "number"
+          },
+          "url": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "open",
+              "draft",
+              "merged",
+              "closed"
+            ]
+          },
+          "updatedAt": {
+            "type": "string"
+          },
+          "reviewDecision": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "enum": [
+              "approved",
+              "changes_requested",
+              "review_required"
+            ]
+          },
+          "mergeState": {
+            "type": "string",
+            "enum": [
+              "dirty",
+              "unknown",
+              "draft",
+              "clean",
+              "unstable",
+              "has_hooks",
+              "blocked",
+              "behind"
+            ],
+            "description": "Whether the review can merge now, and if not, why."
+          },
+          "checks": {
+            "$ref": "#/components/schemas/ChecksReport"
+          }
+        },
+        "required": [
+          "number",
+          "url",
+          "title",
+          "state",
+          "updatedAt",
+          "reviewDecision",
+          "mergeState",
+          "checks"
+        ],
+        "additionalProperties": false
+      },
+      "ChecksReport": {
+        "type": "object",
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "running",
+              "cancelled",
+              "success",
+              "failure",
+              "pending",
+              "none"
+            ],
+            "description": "The overall state of a set of checks. `none` means there are no checks."
+          },
+          "headSha": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The commit the checks ran on."
+          },
+          "checks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CheckRun"
+            }
+          }
+        },
+        "required": [
+          "state",
+          "headSha",
+          "checks"
+        ],
+        "additionalProperties": false
+      },
+      "CheckRun": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable within one report, for list keys."
+          },
+          "name": {
+            "type": "string"
+          },
+          "workflowName": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The CI workflow that ran the job, when the check came from one."
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "running",
+              "cancelled",
+              "success",
+              "failure",
+              "pending",
+              "skipped",
+              "neutral"
+            ],
+            "description": "The state of one check or CI job."
+          },
+          "url": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The job's page on the forge."
+          },
+          "startedAt": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "completedAt": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "A one-line result, e.g. a check run's title or a commit status description."
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "workflowName",
+          "state",
+          "url",
+          "startedAt",
+          "completedAt",
+          "description"
+        ],
+        "additionalProperties": false
+      },
       "TerminalListEntry": {
         "type": "object",
         "properties": {
@@ -11652,6 +12744,19 @@
             },
             "additionalProperties": {},
             "description": "Agent preferences (issue #682). `defaultMode` is how an agent session\nstarts when the caller sends no mode: `gui` in a chat pane, `tui` as the\nagent's CLI in a terminal. Browsers keep their own per-device mode and\nalways send it, so this applies to the CLI, cronjobs and MCP. Replaces\n`cli.defaultVia`, which boot migrates once."
+          },
+          "plugins": {
+            "type": "object",
+            "properties": {
+              "disabled": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "additionalProperties": {},
+            "description": "Bundled plugins (`plugins/<id>/`). A plugin whose id is in `disabled`\nnever activates and its UI is hidden. Read once at boot."
           }
         },
         "additionalProperties": {}
@@ -13201,6 +14306,49 @@
         },
         "additionalProperties": false
       },
+      "ClientStateEntry": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "desktop",
+              "mobile",
+              "all"
+            ],
+            "description": "Client-state types shared by the server and the dashboard.\n\nClient state is small UI state (open center tabs, panel widths, drafts, …)\nthat the dashboard keeps on the Band server so every device shows the same\nthing. Each entry has a scope: `all` is one value for every device, and\n`desktop` / `mobile` hold a separate value per device type.\n\nEvery write names the version it was based on. The server refuses a write\nwhose base is not the current version, so a client that missed another\ndevice's change (offline, reconnecting) can never overwrite it."
+          },
+          "workspaceId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The workspace the key belongs to, or null for a global key."
+          },
+          "value": {
+            "description": "The stored JSON value, or null once the key has been deleted."
+          },
+          "version": {
+            "type": "number",
+            "description": "Starts at 1 and goes up by one on every write, including a delete."
+          },
+          "updatedAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "key",
+          "scope",
+          "workspaceId",
+          "value",
+          "version",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
       "SubmitResult": {
         "type": "object",
         "properties": {