@band-app/server 0.31.0 → 0.32.0

package/dist/openapi.json

@@ -5496,6 +5496,12 @@
                   "properties": {
                     "workspaceId": {
                       "type": "string"
+                    },
+                    "query": {
+                      "type": "string"
+                    },
+                    "limit": {
+                      "type": "number"
                     }
                   },
                   "required": [
@@ -5509,9 +5515,9 @@
         ]
       }
     },
-    "/workspace.getDiff": {
+    "/workspace.getCommitHistory": {
       "get": {
-        "operationId": "workspace.getDiff",
+        "operationId": "workspace.getCommitHistory",
         "tags": [
           "workspace"
         ],
@@ -5527,7 +5533,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/DiffResult"
+                          "$ref": "#/components/schemas/CommitHistoryResult"
                         }
                       },
                       "required": [
@@ -5560,17 +5566,73 @@
                     "workspaceId": {
                       "type": "string"
                     },
-                    "contextLines": {
+                    "limit": {
                       "type": "number"
                     },
-                    "diffMode": {
-                      "type": "string",
-                      "enum": [
-                        "branch",
-                        "uncommitted"
+                    "skip": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/workspace.getCommitHistorySignature": {
+      "get": {
+        "operationId": "workspace.getCommitHistorySignature",
+        "tags": [
+          "workspace"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "data"
                       ]
-                    },
-                    "compareBranch": {
+                    }
+                  },
+                  "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"
                     }
                   },
@@ -5585,9 +5647,9 @@
         ]
       }
     },
-    "/workspace.getDiffSummary": {
+    "/workspace.getCommitDetails": {
       "get": {
-        "operationId": "workspace.getDiffSummary",
+        "operationId": "workspace.getCommitDetails",
         "tags": [
           "workspace"
         ],
@@ -5603,7 +5665,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "$ref": "#/components/schemas/DiffSummaryResult"
+                          "$ref": "#/components/schemas/CommitDetails"
                         }
                       },
                       "required": [
@@ -5636,19 +5698,13 @@
                     "workspaceId": {
                       "type": "string"
                     },
-                    "diffMode": {
-                      "type": "string",
-                      "enum": [
-                        "branch",
-                        "uncommitted"
-                      ]
-                    },
-                    "compareBranch": {
+                    "sha": {
                       "type": "string"
                     }
                   },
                   "required": [
-                    "workspaceId"
+                    "workspaceId",
+                    "sha"
                   ],
                   "additionalProperties": false
                 }
@@ -5658,9 +5714,9 @@
         ]
       }
     },
-    "/workspace.getFileDiff": {
+    "/workspace.getCommitFileDiff": {
       "get": {
-        "operationId": "workspace.getFileDiff",
+        "operationId": "workspace.getCommitFileDiff",
         "tags": [
           "workspace"
         ],
@@ -5721,7 +5777,7 @@
                     "filePath": {
                       "type": "string"
                     },
-                    "mergeBase": {
+                    "sha": {
                       "type": "string"
                     },
                     "contextLines": {
@@ -5731,7 +5787,7 @@
                   "required": [
                     "workspaceId",
                     "filePath",
-                    "mergeBase"
+                    "sha"
                   ],
                   "additionalProperties": false
                 }
@@ -5741,9 +5797,9 @@
         ]
       }
     },
-    "/workspace.revertFile": {
-      "post": {
-        "operationId": "workspace.revertFile",
+    "/workspace.getDiff": {
+      "get": {
+        "operationId": "workspace.getDiff",
         "tags": [
           "workspace"
         ],
@@ -5759,17 +5815,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
-                            }
-                          },
-                          "required": [
-                            "ok"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/DiffResult"
                         }
                       },
                       "required": [
@@ -5788,45 +5834,48 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "workspaceId": {
-                    "type": "string"
-                  },
-                  "filePath": {
-                    "type": "string"
-                  },
-                  "diffMode": {
-                    "type": "string",
-                    "enum": [
-                      "branch",
-                      "uncommitted"
-                    ]
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "workspaceId": {
+                      "type": "string"
+                    },
+                    "contextLines": {
+                      "type": "number"
+                    },
+                    "diffMode": {
+                      "type": "string",
+                      "enum": [
+                        "branch",
+                        "uncommitted"
+                      ]
+                    },
+                    "compareBranch": {
+                      "type": "string"
+                    }
                   },
-                  "compareBranch": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "workspaceId",
-                  "filePath",
-                  "diffMode"
-                ],
-                "additionalProperties": false
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
               }
             }
           }
-        }
+        ]
       }
     },
-    "/workspace.gitPull": {
-      "post": {
-        "operationId": "workspace.gitPull",
+    "/workspace.getDiffSummary": {
+      "get": {
+        "operationId": "workspace.getDiffSummary",
         "tags": [
           "workspace"
         ],
@@ -5842,17 +5891,7 @@
                       "type": "object",
                       "properties": {
                         "data": {
-                          "type": "object",
-                          "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
-                            }
-                          },
-                          "required": [
-                            "ok"
-                          ],
-                          "additionalProperties": false
+                          "$ref": "#/components/schemas/DiffSummaryResult"
                         }
                       },
                       "required": [
@@ -5871,30 +5910,45 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "workspaceId": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "workspaceId"
-                ],
-                "additionalProperties": false
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "workspaceId": {
+                      "type": "string"
+                    },
+                    "diffMode": {
+                      "type": "string",
+                      "enum": [
+                        "branch",
+                        "uncommitted"
+                      ]
+                    },
+                    "compareBranch": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "workspaceId"
+                  ],
+                  "additionalProperties": false
+                }
               }
             }
           }
-        }
+        ]
       }
     },
-    "/workspace.gitPush": {
-      "post": {
-        "operationId": "workspace.gitPush",
+    "/workspace.getFileDiff": {
+      "get": {
+        "operationId": "workspace.getFileDiff",
         "tags": [
           "workspace"
         ],
@@ -5912,13 +5966,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "ok": {
-                              "type": "boolean",
-                              "const": true
+                            "diff": {
+                              "type": "string"
                             }
                           },
                           "required": [
-                            "ok"
+                            "diff"
                           ],
                           "additionalProperties": false
                         }
@@ -5939,8 +5992,243 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "workspaceId": {
+                      "type": "string"
+                    },
+                    "filePath": {
+                      "type": "string"
+                    },
+                    "mergeBase": {
+                      "type": "string"
+                    },
+                    "contextLines": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "workspaceId",
+                    "filePath",
+                    "mergeBase"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/workspace.revertFile": {
+      "post": {
+        "operationId": "workspace.revertFile",
+        "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"
+                  },
+                  "filePath": {
+                    "type": "string"
+                  },
+                  "diffMode": {
+                    "type": "string",
+                    "enum": [
+                      "branch",
+                      "uncommitted"
+                    ]
+                  },
+                  "compareBranch": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "workspaceId",
+                  "filePath",
+                  "diffMode"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/workspace.gitPull": {
+      "post": {
+        "operationId": "workspace.gitPull",
+        "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"
+                  }
+                },
+                "required": [
+                  "workspaceId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/workspace.gitPush": {
+      "post": {
+        "operationId": "workspace.gitPush",
+        "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": {
@@ -8388,42 +8676,603 @@
                     }
                   },
                   "required": [
-                    "result"
-                  ]
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "chatId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "chatId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/chats.resume": {
+      "post": {
+        "operationId": "chats.resume",
+        "tags": [
+          "chats"
+        ],
+        "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": {
+                  "chatId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "chatId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/chats.continueInTerminal": {
+      "post": {
+        "operationId": "chats.continueInTerminal",
+        "description": "Continue this chat's coding-agent session in a terminal pane.\n\nResolves the chat's underlying agent session ID (`activeSessionId`) and\nthe adapter for whichever coding agent it ran, asks the adapter for the\nvendor CLI's *resume* invocation (`claude --resume <id>`,\n`codex resume <id>`, `opencode --session <id>`), composes it into a\nshell-safe command, and spawns a fresh terminal pane running it — so the\nuser keeps working in the very session the web chat was running.\n\nMirrors the spawn+emit pair in `WorkspaceService.create`'s\n`via=terminal` branch (issue #551), and resolves the agent inline the\nsame way `setActiveSession` above does. Errors surface to the client so\nthe UI can keep the menu item disabled for agents that can't resume\n(Gemini CLI / Cursor CLI) or chats with no session yet.",
+        "tags": [
+          "chats"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "terminalId": {
+                              "type": "string"
+                            },
+                            "workspaceId": {
+                              "type": "string"
+                            },
+                            "sessionId": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "terminalId",
+                            "workspaceId",
+                            "sessionId"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "chatId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "chatId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/chat.answer": {
+      "post": {
+        "operationId": "chat.answer",
+        "description": "Answers `session/request_permission` with one of its options, or\n`null` to cancel it.",
+        "tags": [
+          "chat"
+        ],
+        "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": {
+                  "chatId": {
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "type": "string"
+                  },
+                  "optionId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "chatId",
+                  "requestId",
+                  "optionId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/chat.answerElicitation": {
+      "post": {
+        "operationId": "chat.answerElicitation",
+        "description": "Answers a form `elicitation/create` (e.g. Claude Code's\nAskUserQuestion).",
+        "tags": [
+          "chat"
+        ],
+        "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": {
+                  "chatId": {
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "type": "string"
+                  },
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "accept",
+                      "decline",
+                      "cancel"
+                    ]
+                  },
+                  "content": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "oneOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "type": "boolean"
+                        }
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "chatId",
+                  "requestId",
+                  "action"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/browsers.list": {
+      "get": {
+        "operationId": "browsers.list",
+        "tags": [
+          "browsers"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "browsers": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/BrowserRow"
+                              }
+                            }
+                          },
+                          "required": [
+                            "browsers"
+                          ],
+                          "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
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "/browsers.create": {
+      "post": {
+        "operationId": "browsers.create",
+        "tags": [
+          "browsers"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "browser": {
+                              "$ref": "#/components/schemas/BrowserRow"
+                            }
+                          },
+                          "required": [
+                            "browser"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "workspaceId": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "profileId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "workspaceId"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
+    "/browsers.get": {
+      "get": {
+        "operationId": "browsers.get",
+        "tags": [
+          "browsers"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "browser": {
+                              "oneOf": [
+                                {
+                                  "$ref": "#/components/schemas/BrowserRow"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            }
+                          },
+                          "required": [
+                            "browser"
+                          ],
+                          "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": {
+                    "browserId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "browserId"
+                  ],
+                  "additionalProperties": false
                 }
               }
             }
-          },
-          "default": {
-            "$ref": "#/components/responses/Error"
-          }
-        },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "chatId": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "chatId"
-                ],
-                "additionalProperties": false
-              }
-            }
           }
-        }
+        ]
       }
     },
-    "/chats.resume": {
+    "/browsers.update": {
       "post": {
-        "operationId": "chats.resume",
+        "operationId": "browsers.update",
         "tags": [
-          "chats"
+          "browsers"
         ],
         "responses": {
           "200": {
@@ -8439,12 +9288,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "ok": {
-                              "type": "boolean"
+                            "browser": {
+                              "$ref": "#/components/schemas/BrowserRow"
                             }
                           },
                           "required": [
-                            "ok"
+                            "browser"
                           ],
                           "additionalProperties": false
                         }
@@ -8472,12 +9321,18 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "chatId": {
+                  "browserId": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "url": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "chatId"
+                  "browserId"
                 ],
                 "additionalProperties": false
               }
@@ -8486,12 +9341,12 @@
         }
       }
     },
-    "/chats.continueInTerminal": {
+    "/browsers.setProfile": {
       "post": {
-        "operationId": "chats.continueInTerminal",
-        "description": "Continue this chat's coding-agent session in a terminal pane.\n\nResolves the chat's underlying agent session ID (`activeSessionId`) and\nthe adapter for whichever coding agent it ran, asks the adapter for the\nvendor CLI's *resume* invocation (`claude --resume <id>`,\n`codex resume <id>`, `opencode --session <id>`), composes it into a\nshell-safe command, and spawns a fresh terminal pane running it — so the\nuser keeps working in the very session the web chat was running.\n\nMirrors the spawn+emit pair in `WorkspaceService.create`'s\n`via=terminal` branch (issue #551), and resolves the agent inline the\nsame way `setActiveSession` above does. Errors surface to the client so\nthe UI can keep the menu item disabled for agents that can't resume\n(Gemini CLI / Cursor CLI) or chats with no session yet.",
+        "operationId": "browsers.setProfile",
+        "description": "Switch a tab to another profile (`null` is Default). Also makes it the\ndefault profile of the tab's project, so new tabs in any workspace of\nthat project open with it.",
         "tags": [
-          "chats"
+          "browsers"
         ],
         "responses": {
           "200": {
@@ -8507,20 +9362,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "terminalId": {
-                              "type": "string"
-                            },
-                            "workspaceId": {
-                              "type": "string"
-                            },
-                            "sessionId": {
-                              "type": "string"
+                            "browser": {
+                              "$ref": "#/components/schemas/BrowserRow"
                             }
                           },
                           "required": [
-                            "terminalId",
-                            "workspaceId",
-                            "sessionId"
+                            "browser"
                           ],
                           "additionalProperties": false
                         }
@@ -8548,12 +9395,19 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "chatId": {
+                  "profileId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "browserId": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "chatId"
+                  "profileId",
+                  "browserId"
                 ],
                 "additionalProperties": false
               }
@@ -8562,12 +9416,11 @@
         }
       }
     },
-    "/chat.answer": {
+    "/browsers.navigate": {
       "post": {
-        "operationId": "chat.answer",
-        "description": "Answers `session/request_permission` with one of its options, or\n`null` to cancel it.",
+        "operationId": "browsers.navigate",
         "tags": [
-          "chat"
+          "browsers"
         ],
         "responses": {
           "200": {
@@ -8616,23 +9469,16 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "chatId": {
+                  "url": {
                     "type": "string"
                   },
-                  "requestId": {
+                  "browserId": {
                     "type": "string"
-                  },
-                  "optionId": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
                   }
                 },
                 "required": [
-                  "chatId",
-                  "requestId",
-                  "optionId"
+                  "url",
+                  "browserId"
                 ],
                 "additionalProperties": false
               }
@@ -8641,12 +9487,11 @@
         }
       }
     },
-    "/chat.answerElicitation": {
+    "/browsers.remove": {
       "post": {
-        "operationId": "chat.answerElicitation",
-        "description": "Answers a form `elicitation/create` (e.g. Claude Code's\nAskUserQuestion).",
+        "operationId": "browsers.remove",
         "tags": [
-          "chat"
+          "browsers"
         ],
         "responses": {
           "200": {
@@ -8695,47 +9540,12 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "chatId": {
-                    "type": "string"
-                  },
-                  "requestId": {
+                  "browserId": {
                     "type": "string"
-                  },
-                  "action": {
-                    "type": "string",
-                    "enum": [
-                      "accept",
-                      "decline",
-                      "cancel"
-                    ]
-                  },
-                  "content": {
-                    "type": "object",
-                    "additionalProperties": {
-                      "oneOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "array",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        {
-                          "type": "boolean"
-                        }
-                      ]
-                    }
                   }
                 },
                 "required": [
-                  "chatId",
-                  "requestId",
-                  "action"
+                  "browserId"
                 ],
                 "additionalProperties": false
               }
@@ -8744,11 +9554,11 @@
         }
       }
     },
-    "/browsers.list": {
+    "/browserProfiles.list": {
       "get": {
-        "operationId": "browsers.list",
+        "operationId": "browserProfiles.list",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -8764,15 +9574,15 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "browsers": {
+                            "profiles": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/BrowserRow"
+                                "$ref": "#/components/schemas/BrowserProfileRow"
                               }
                             }
                           },
                           "required": [
-                            "browsers"
+                            "profiles"
                           ],
                           "additionalProperties": false
                         }
@@ -8792,38 +9602,14 @@
           "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
-                }
-              }
-            }
-          }
-        ]
+        }
       }
     },
-    "/browsers.create": {
+    "/browserProfiles.create": {
       "post": {
-        "operationId": "browsers.create",
+        "operationId": "browserProfiles.create",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -8839,12 +9625,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "browser": {
-                              "$ref": "#/components/schemas/BrowserRow"
+                            "profile": {
+                              "$ref": "#/components/schemas/BrowserProfileRow"
                             }
                           },
                           "required": [
-                            "browser"
+                            "profile"
                           ],
                           "additionalProperties": false
                         }
@@ -8872,21 +9658,26 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "workspaceId": {
+                  "name": {
                     "type": "string"
                   },
                   "id": {
                     "type": "string"
                   },
-                  "name": {
-                    "type": "string"
-                  },
-                  "url": {
-                    "type": "string"
+                  "source": {
+                    "oneOf": [
+                      {
+                        "type": "string",
+                        "const": "chrome"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
                   }
                 },
                 "required": [
-                  "workspaceId"
+                  "name"
                 ],
                 "additionalProperties": false
               }
@@ -8895,11 +9686,11 @@
         }
       }
     },
-    "/browsers.get": {
-      "get": {
-        "operationId": "browsers.get",
+    "/browserProfiles.remove": {
+      "post": {
+        "operationId": "browserProfiles.remove",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -8915,19 +9706,12 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "browser": {
-                              "oneOf": [
-                                {
-                                  "$ref": "#/components/schemas/BrowserRow"
-                                },
-                                {
-                                  "type": "null"
-                                }
-                              ]
+                            "ok": {
+                              "type": "boolean"
                             }
                           },
                           "required": [
-                            "browser"
+                            "ok"
                           ],
                           "additionalProperties": false
                         }
@@ -8948,37 +9732,33 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "parameters": [
-          {
-            "name": "input",
-            "in": "query",
-            "required": true,
-            "style": "deepObject",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "browserId": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "browserId"
-                  ],
-                  "additionalProperties": false
-                }
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "profileId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "profileId"
+                ],
+                "additionalProperties": false
               }
             }
           }
-        ]
+        }
       }
     },
-    "/browsers.update": {
-      "post": {
-        "operationId": "browsers.update",
+    "/browserProfiles.projectDefaults": {
+      "get": {
+        "operationId": "browserProfiles.projectDefaults",
+        "description": "Every project's default profile. Projects with no row use Default.",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -8994,12 +9774,28 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "browser": {
-                              "$ref": "#/components/schemas/BrowserRow"
+                            "defaults": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "projectName": {
+                                    "type": "string"
+                                  },
+                                  "profileId": {
+                                    "type": "string"
+                                  }
+                                },
+                                "required": [
+                                  "projectName",
+                                  "profileId"
+                                ],
+                                "additionalProperties": false
+                              }
                             }
                           },
                           "required": [
-                            "browser"
+                            "defaults"
                           ],
                           "additionalProperties": false
                         }
@@ -9019,39 +9815,14 @@
           "default": {
             "$ref": "#/components/responses/Error"
           }
-        },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "browserId": {
-                    "type": "string"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "url": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "browserId"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
         }
       }
     },
-    "/browsers.navigate": {
-      "post": {
-        "operationId": "browsers.navigate",
+    "/browserProfiles.getProjectDefault": {
+      "get": {
+        "operationId": "browserProfiles.getProjectDefault",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -9067,12 +9838,15 @@
                         "data": {
                           "type": "object",
                           "properties": {
-                            "ok": {
-                              "type": "boolean"
+                            "profileId": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
                             }
                           },
                           "required": [
-                            "ok"
+                            "profileId"
                           ],
                           "additionalProperties": false
                         }
@@ -9093,36 +9867,38 @@
             "$ref": "#/components/responses/Error"
           }
         },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "url": {
-                    "type": "string"
+        "parameters": [
+          {
+            "name": "input",
+            "in": "query",
+            "required": true,
+            "style": "deepObject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "projectName": {
+                      "type": "string"
+                    }
                   },
-                  "browserId": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "url",
-                  "browserId"
-                ],
-                "additionalProperties": false
+                  "required": [
+                    "projectName"
+                  ],
+                  "additionalProperties": false
+                }
               }
             }
           }
-        }
+        ]
       }
     },
-    "/browsers.remove": {
+    "/browserProfiles.setProjectDefault": {
       "post": {
-        "operationId": "browsers.remove",
+        "operationId": "browserProfiles.setProjectDefault",
+        "description": "`profileId: null` resets the project to the Default profile.",
         "tags": [
-          "browsers"
+          "browserProfiles"
         ],
         "responses": {
           "200": {
@@ -9171,12 +9947,19 @@
               "schema": {
                 "type": "object",
                 "properties": {
-                  "browserId": {
+                  "profileId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "projectName": {
                     "type": "string"
                   }
                 },
                 "required": [
-                  "browserId"
+                  "profileId",
+                  "projectName"
                 ],
                 "additionalProperties": false
               }
@@ -10713,12 +11496,192 @@
           },
           "headBranch": {
             "type": "string"
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "More branches matched than `limit` allowed through."
           }
         },
         "required": [
           "branches",
           "defaultBranch",
-          "headBranch"
+          "headBranch",
+          "truncated"
+        ],
+        "additionalProperties": false
+      },
+      "CommitHistoryResult": {
+        "type": "object",
+        "properties": {
+          "commits": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/HistoryCommit"
+            }
+          },
+          "head": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "HEAD's SHA, or null when the repo has no commits yet."
+          },
+          "hasMore": {
+            "type": "boolean",
+            "description": "True when older commits exist past this page."
+          },
+          "signature": {
+            "type": "string",
+            "description": "`getCommitHistorySignature` at the time this page was read."
+          }
+        },
+        "required": [
+          "commits",
+          "head",
+          "hasMore",
+          "signature"
+        ],
+        "additionalProperties": false
+      },
+      "HistoryCommit": {
+        "type": "object",
+        "properties": {
+          "sha": {
+            "type": "string"
+          },
+          "parents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "author": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "ts": {
+            "type": "number",
+            "description": "Author date, unix seconds."
+          },
+          "subject": {
+            "type": "string"
+          },
+          "refs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CommitRef"
+            }
+          }
+        },
+        "required": [
+          "sha",
+          "parents",
+          "author",
+          "email",
+          "ts",
+          "subject",
+          "refs"
+        ],
+        "additionalProperties": false
+      },
+      "CommitRef": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Short name: `main`, `origin/main`, `v1.0.0`."
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "branch",
+              "head",
+              "remote",
+              "tag"
+            ],
+            "description": "`head` is the branch HEAD is on; the rest are other refs."
+          }
+        },
+        "required": [
+          "name",
+          "kind"
+        ],
+        "additionalProperties": false
+      },
+      "CommitDetails": {
+        "type": "object",
+        "properties": {
+          "sha": {
+            "type": "string"
+          },
+          "parents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "author": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "authorTs": {
+            "type": "number"
+          },
+          "committer": {
+            "type": "string"
+          },
+          "committerTs": {
+            "type": "number"
+          },
+          "subject": {
+            "type": "string"
+          },
+          "body": {
+            "type": "string"
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CommitFileChange"
+            }
+          }
+        },
+        "required": [
+          "sha",
+          "parents",
+          "author",
+          "email",
+          "authorTs",
+          "committer",
+          "committerTs",
+          "subject",
+          "body",
+          "files"
+        ],
+        "additionalProperties": false
+      },
+      "CommitFileChange": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "description": "git name-status code: A, M, D, R, C, T."
+          },
+          "oldPath": {
+            "type": "string",
+            "description": "Source path of a rename or copy."
+          }
+        },
+        "required": [
+          "path",
+          "status"
         ],
         "additionalProperties": false
       },
@@ -11567,6 +12530,13 @@
               "loading"
             ],
             "description": "Browser tab status as persisted in the `state` JSON blob's `status` field.\n\nMirrors the runtime status the browser-service hands the dashboard.\nStored on disk so a server restart can deterministically reset every\nbrowser to `\"idle\"` (see `resetAllToIdle`)."
+          },
+          "profileId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Band browser profile the tab's session runs in (see\n`browser-profiles.ts`). `null` is the built-in Default profile."
           }
         },
         "required": [
@@ -11574,7 +12544,35 @@
           "workspaceId",
           "name",
           "url",
-          "status"
+          "status",
+          "profileId"
+        ],
+        "additionalProperties": false
+      },
+      "BrowserProfileRow": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "createdAt": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "source",
+          "createdAt"
         ],
         "additionalProperties": false
       },