@band-app/server 0.32.0 → 0.34.0

package/dist/openapi.json

@@ -2169,6 +2169,104 @@
         }
       }
     },
+    "/history.import": {
+      "post": {
+        "operationId": "history.import",
+        "tags": [
+          "history"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "imported": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "imported"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "entries": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "url": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "visitCount": {
+                          "type": "number"
+                        },
+                        "lastVisitedAt": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "url",
+                        "title",
+                        "visitCount",
+                        "lastVisitedAt"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "workspaceId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "entries",
+                  "workspaceId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/history.clear": {
       "post": {
         "operationId": "history.clear",
@@ -2228,10 +2326,10 @@
                   "range": {
                     "type": "string",
                     "enum": [
+                      "all",
                       "hour",
                       "day",
-                      "week",
-                      "all"
+                      "week"
                     ]
                   }
                 },
@@ -2933,15 +3031,306 @@
                     }
                   },
                   "required": [
-                    "fromMs",
-                    "toMs"
-                  ],
-                  "additionalProperties": false
+                    "fromMs",
+                    "toMs"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/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": {
@@ -3919,6 +4308,54 @@
         }
       }
     },
+    "/terminal.restartDaemon": {
+      "post": {
+        "operationId": "terminal.restartDaemon",
+        "tags": [
+          "terminal"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "killedCount": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "killedCount"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        }
+      }
+    },
     "/settings.get": {
       "get": {
         "operationId": "settings.get",
@@ -4134,6 +4571,19 @@
                       }
                     },
                     "additionalProperties": {}
+                  },
+                  "agents": {
+                    "type": "object",
+                    "properties": {
+                      "defaultMode": {
+                        "type": "string",
+                        "enum": [
+                          "gui",
+                          "tui"
+                        ]
+                      }
+                    },
+                    "additionalProperties": {}
                   }
                 },
                 "additionalProperties": {}
@@ -4855,6 +5305,13 @@
                   "codingAgentId": {
                     "type": "string"
                   },
+                  "agentMode": {
+                    "type": "string",
+                    "enum": [
+                      "gui",
+                      "tui"
+                    ]
+                  },
                   "via": {
                     "type": "string",
                     "enum": [
@@ -5873,9 +6330,9 @@
         ]
       }
     },
-    "/workspace.getDiffSummary": {
+    "/workspace.getChanges": {
       "get": {
-        "operationId": "workspace.getDiffSummary",
+        "operationId": "workspace.getChanges",
         "tags": [
           "workspace"
         ],
@@ -5891,7 +6348,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/DiffSummaryResult"
+                          "$ref": "#/components/schemas/ChangesResult"
                         }
                       },
                       "required": [
@@ -5924,31 +6381,197 @@
                     "workspaceId": {
                       "type": "string"
                     },
-                    "diffMode": {
+                    "compareBranch": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/workspace.getFileDiff": {
+      "get": {
+        "operationId": "workspace.getFileDiff",
+        "tags": [
+          "workspace"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "diff": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "diff"
+                          ],
+                          "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"
+                    },
+                    "filePath": {
+                      "type": "string"
+                    },
+                    "section": {
                       "type": "string",
                       "enum": [
                         "branch",
-                        "uncommitted"
+                        "conflicts",
+                        "unstaged",
+                        "staged",
+                        "untracked"
                       ]
                     },
-                    "compareBranch": {
-                      "type": "string"
+                    "contextLines": {
+                      "type": "number"
+                    },
+                    "mergeBase": {
+                      "type": "string",
+                      "description": "Required for the `branch` section."
+                    },
+                    "oldPath": {
+                      "type": "string",
+                      "description": "The path before a rename, so git pairs the two sides."
                     }
                   },
                   "required": [
-                    "workspaceId"
+                    "workspaceId",
+                    "filePath",
+                    "section"
                   ],
                   "additionalProperties": false
                 }
               }
             }
           }
-        ]
+        ]
+      }
+    },
+    "/workspace.stageFiles": {
+      "post": {
+        "operationId": "workspace.stageFiles",
+        "tags": [
+          "workspace"
+        ],
+        "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"
+                  },
+                  "paths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "required": [
+                  "workspaceId",
+                  "paths"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
       }
     },
-    "/workspace.getFileDiff": {
-      "get": {
-        "operationId": "workspace.getFileDiff",
+    "/workspace.unstageFiles": {
+      "post": {
+        "operationId": "workspace.unstageFiles",
         "tags": [
           "workspace"
         ],
@@ -5966,12 +6589,13 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "diff": {
-                              "type": "string"
+                            "ok": {
+                              "type": "boolean",
+                              "const": true
                             }
                           },
                           "required": [
-                            "diff"
+                            "ok"
                           ],
                           "additionalProperties": false
                         }
@@ -5992,46 +6616,37 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "parameters": [
-          {
-            "name": "input",
-            "in": "query",
-            "required": true,
-            "style": "deepObject",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "workspaceId": {
-                      "type": "string"
-                    },
-                    "filePath": {
-                      "type": "string"
-                    },
-                    "mergeBase": {
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "workspaceId": {
+                    "type": "string"
+                  },
+                  "paths": {
+                    "type": "array",
+                    "items": {
                       "type": "string"
-                    },
-                    "contextLines": {
-                      "type": "number"
                     }
-                  },
-                  "required": [
-                    "workspaceId",
-                    "filePath",
-                    "mergeBase"
-                  ],
-                  "additionalProperties": false
-                }
+                  }
+                },
+                "required": [
+                  "workspaceId",
+                  "paths"
+                ],
+                "additionalProperties": false
               }
             }
           }
-        ]
+        }
       }
     },
-    "/workspace.revertFile": {
+    "/workspace.discardChanges": {
       "post": {
-        "operationId": "workspace.revertFile",
+        "operationId": "workspace.discardChanges",
         "tags": [
           "workspace"
         ],
@@ -6086,24 +6701,25 @@
                   "workspaceId": {
                     "type": "string"
                   },
-                  "filePath": {
-                    "type": "string"
-                  },
-                  "diffMode": {
+                  "section": {
                     "type": "string",
                     "enum": [
-                      "branch",
-                      "uncommitted"
+                      "unstaged",
+                      "staged",
+                      "untracked"
                     ]
                   },
-                  "compareBranch": {
-                    "type": "string"
+                  "paths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
                   "workspaceId",
-                  "filePath",
-                  "diffMode"
+                  "section",
+                  "paths"
                 ],
                 "additionalProperties": false
               }
@@ -7321,81 +7937,6 @@
         ]
       }
     },
-    "/workspace.switchAgent": {
-      "post": {
-        "operationId": "workspace.switchAgent",
-        "tags": [
-          "workspace"
-        ],
-        "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"
-                  },
-                  "agentId": {
-                    "type": "string"
-                  },
-                  "chatId": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "workspaceId",
-                  "agentId"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
-        }
-      }
-    },
     "/cronjobs.list": {
       "get": {
         "operationId": "cronjobs.list",
@@ -8308,6 +8849,9 @@
                   },
                   "configId": {
                     "type": "string"
+                  },
+                  "workspaceId": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -8841,7 +9385,160 @@
                   }
                 },
                 "required": [
-                  "chatId"
+                  "chatId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agentSessions.list": {
+      "get": {
+        "operationId": "agentSessions.list",
+        "tags": [
+          "agentSessions"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "agentSessions": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/AgentSessionRecord"
+                              }
+                            }
+                          },
+                          "required": [
+                            "agentSessions"
+                          ],
+                          "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"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/agentSessions.launch": {
+      "post": {
+        "operationId": "agentSessions.launch",
+        "description": "Start an agent. `mode` is the calling device's choice; without it the\nserver's `agents.defaultMode` applies. The response carries the mode\nactually used, which is `gui` when the agent has no TUI invocation.",
+        "tags": [
+          "agentSessions"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "$ref": "#/components/schemas/result"
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "workspaceId": {
+                    "type": "string"
+                  },
+                  "prompt": {
+                    "type": "string"
+                  },
+                  "mode": {
+                    "type": "string",
+                    "enum": [
+                      "gui",
+                      "tui"
+                    ]
+                  },
+                  "chatId": {
+                    "type": "string"
+                  },
+                  "terminalId": {
+                    "type": "string"
+                  },
+                  "agentId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "workspaceId"
                 ],
                 "additionalProperties": false
               }
@@ -10005,37 +10702,317 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "parameters": [
-          {
-            "name": "input",
-            "in": "query",
-            "required": true,
-            "style": "deepObject",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "workspaceId": {
-                      "type": "string"
-                    }
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "workspaceId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/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"
                   },
-                  "required": [
-                    "workspaceId"
-                  ],
-                  "additionalProperties": false
-                }
+                  "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": {
@@ -10049,16 +11026,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": [
@@ -10084,25 +11090,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
               }
@@ -11082,33 +12092,269 @@
           "cacheReadTokens": {
             "type": "number"
           },
-          "cacheCreationTokens": {
-            "type": "number"
+          "cacheCreationTokens": {
+            "type": "number"
+          },
+          "reasoningOutputTokens": {
+            "type": "number"
+          },
+          "totalTokens": {
+            "type": "number"
+          },
+          "costUsd": {
+            "type": "number"
+          },
+          "sessionCount": {
+            "type": "number",
+            "description": "Distinct sessions contributing to this row. Sessions are the\nprovider-native unit (one chat thread per Claude/Codex/OpenCode\nsession id) — meaningful for both Band-driven turns and\nscanner-backfilled CLI sessions. The earlier \"taskCount\" using\n`task_id` was meaningless for disk-scanned rows because the\nscanner writes them with an empty task_id (no Band task), so\nCOUNT DISTINCT would just count `\"\"` as 1."
+          }
+        },
+        "required": [
+          "bucket",
+          "inputTokens",
+          "outputTokens",
+          "cacheReadTokens",
+          "cacheCreationTokens",
+          "reasoningOutputTokens",
+          "totalTokens",
+          "costUsd",
+          "sessionCount"
+        ],
+        "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."
           },
-          "reasoningOutputTokens": {
-            "type": "number"
+          "state": {
+            "type": "string",
+            "enum": [
+              "running",
+              "cancelled",
+              "success",
+              "failure",
+              "pending",
+              "skipped",
+              "neutral"
+            ],
+            "description": "The state of one check or CI job."
           },
-          "totalTokens": {
-            "type": "number"
+          "url": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The job's page on the forge."
           },
-          "costUsd": {
-            "type": "number"
+          "startedAt": {
+            "type": [
+              "string",
+              "null"
+            ]
           },
-          "sessionCount": {
-            "type": "number",
-            "description": "Distinct sessions contributing to this row. Sessions are the\nprovider-native unit (one chat thread per Claude/Codex/OpenCode\nsession id) — meaningful for both Band-driven turns and\nscanner-backfilled CLI sessions. The earlier \"taskCount\" using\n`task_id` was meaningless for disk-scanned rows because the\nscanner writes them with an empty task_id (no Band task), so\nCOUNT DISTINCT would just count `\"\"` as 1."
+          "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": [
-          "bucket",
-          "inputTokens",
-          "outputTokens",
-          "cacheReadTokens",
-          "cacheCreationTokens",
-          "reasoningOutputTokens",
-          "totalTokens",
-          "costUsd",
-          "sessionCount"
+          "id",
+          "name",
+          "workflowName",
+          "state",
+          "url",
+          "startedAt",
+          "completedAt",
+          "description"
         ],
         "additionalProperties": false
       },
@@ -11232,6 +12478,33 @@
             },
             "additionalProperties": {},
             "description": "CLI-scoped preferences (issue #551). Today only `defaultVia` is\nrecognized — the user-level fallback for `band workspaces create\n--prompt` dispatch when no `--via` flag, `BAND_DISPATCH` env var,\nor repo `.band/config.json` value is set."
+          },
+          "agents": {
+            "type": "object",
+            "properties": {
+              "defaultMode": {
+                "type": "string",
+                "enum": [
+                  "gui",
+                  "tui"
+                ]
+              }
+            },
+            "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": {}
@@ -11740,38 +13013,127 @@
         ],
         "additionalProperties": false
       },
-      "DiffSummaryResult": {
+      "ChangesResult": {
         "type": "object",
         "properties": {
-          "stats": {
-            "$ref": "#/components/schemas/DiffStats"
-          },
-          "compareBranch": {
+          "headBranch": {
             "type": "string"
           },
           "defaultBranch": {
             "type": "string"
           },
-          "headBranch": {
-            "type": "string"
+          "compareBranch": {
+            "type": "string",
+            "description": "The branch the `branch` section compares against."
           },
-          "fileStatuses": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
+          "mergeBase": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Where HEAD forked from `compareBranch`; null unless `branchStatus` is ready."
+          },
+          "branchStatus": {
+            "type": "string",
+            "enum": [
+              "ready",
+              "invalid-base",
+              "no-merge-base",
+              "unborn-head"
+            ],
+            "description": "Why the `branch` section is empty when it isn't `ready`: the compare\nbranch doesn't resolve (`invalid-base`), it shares no history with HEAD\n(`no-merge-base`), or there are no commits yet (`unborn-head`)."
+          },
+          "conflicts": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangeEntry"
             }
           },
-          "mergeBase": {
-            "type": "string"
+          "unstaged": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangeEntry"
+            }
+          },
+          "staged": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangeEntry"
+            }
+          },
+          "untracked": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangeEntry"
+            }
+          },
+          "branch": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChangeEntry"
+            }
           }
         },
         "required": [
-          "stats",
-          "compareBranch",
-          "defaultBranch",
           "headBranch",
-          "fileStatuses",
-          "mergeBase"
+          "defaultBranch",
+          "compareBranch",
+          "mergeBase",
+          "branchStatus",
+          "conflicts",
+          "unstaged",
+          "staged",
+          "untracked",
+          "branch"
+        ],
+        "additionalProperties": false
+      },
+      "ChangeEntry": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "oldPath": {
+            "type": "string",
+            "description": "The path before a rename or copy."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "A",
+              "M",
+              "D",
+              "R",
+              "C",
+              "U"
+            ],
+            "description": "`A`dded, `M`odified, `D`eleted, `R`enamed, `C`opied, `U`ntracked."
+          },
+          "additions": {
+            "type": "number",
+            "description": "Lines added / deleted; unset for binary files."
+          },
+          "deletions": {
+            "type": "number"
+          },
+          "conflict": {
+            "type": "string",
+            "enum": [
+              "both_modified",
+              "both_added",
+              "both_deleted",
+              "added_by_us",
+              "added_by_them",
+              "deleted_by_us",
+              "deleted_by_them"
+            ],
+            "description": "Set on `conflicts` entries only."
+          }
+        },
+        "required": [
+          "path",
+          "status"
         ],
         "additionalProperties": false
       },
@@ -12507,6 +13869,107 @@
         ],
         "additionalProperties": false
       },
+      "AgentSessionRecord": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "workspaceId": {
+            "type": "string"
+          },
+          "agentDefinitionId": {
+            "type": "string"
+          },
+          "providerSessionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The agent's own session id (e.g. Claude's `session_id`), null until known."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "gui",
+              "tui"
+            ],
+            "description": "Agent session types shared by the server and the dashboard (issue #682).\n\nAn agent session is one run of a coding agent. Its `mode` says how it is\ndisplayed: `gui` in a chat pane, `tui` as the agent's CLI in a terminal.\nThe mode is fixed for the life of the session."
+          },
+          "chatId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Set for `gui` sessions."
+          },
+          "terminalId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Set for `tui` sessions."
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "running",
+              "starting",
+              "ended"
+            ]
+          },
+          "createdAt": {
+            "type": "number"
+          },
+          "updatedAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "id",
+          "workspaceId",
+          "agentDefinitionId",
+          "providerSessionId",
+          "mode",
+          "chatId",
+          "terminalId",
+          "state",
+          "createdAt",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "result": {
+        "type": "object",
+        "properties": {
+          "agentSession": {
+            "$ref": "#/components/schemas/AgentSessionRecord"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "gui",
+              "tui"
+            ],
+            "description": "Agent session types shared by the server and the dashboard (issue #682).\n\nAn agent session is one run of a coding agent. Its `mode` says how it is\ndisplayed: `gui` in a chat pane, `tui` as the agent's CLI in a terminal.\nThe mode is fixed for the life of the session."
+          },
+          "chatId": {
+            "type": "string"
+          },
+          "terminalId": {
+            "type": "string"
+          },
+          "notice": {
+            "type": "string",
+            "description": "Why the requested mode wasn't used, e.g. an agent without a TUI invocation."
+          }
+        },
+        "required": [
+          "agentSession",
+          "mode"
+        ],
+        "additionalProperties": false
+      },
       "BrowserRow": {
         "type": "object",
         "properties": {
@@ -12591,6 +14054,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": {