@band-app/server 0.19.0 → 0.20.0

package/dist/openapi.json

@@ -1291,16 +1291,18 @@
                             "models": {
                               "type": "array",
                               "items": {
-                                "$ref": "#/components/schemas/AgentModel"
+                                "$ref": "#/components/schemas/CachedAgentModel"
                               }
                             },
                             "defaultModel": {
                               "type": "string"
+                            },
+                            "updatedAt": {
+                              "type": "number"
                             }
                           },
                           "required": [
-                            "models",
-                            "defaultModel"
+                            "models"
                           ],
                           "additionalProperties": false
                         }
@@ -1347,7 +1349,7 @@
     "/models.listAll": {
       "get": {
         "operationId": "models.listAll",
-        "description": "List all agents with their models — used by the combined agent/model selector.",
+        "description": "List all agents with their cached models — used by the combined\nagent/model selector in the chat UI. The service loads settings.json\nonce and resolves the effective default-agent id.",
         "tags": [
           "models"
         ],
@@ -1368,35 +1370,7 @@
                             "agents": {
                               "type": "array",
                               "items": {
-                                "type": "object",
-                                "properties": {
-                                  "agentId": {
-                                    "type": "string"
-                                  },
-                                  "agentType": {
-                                    "type": "string"
-                                  },
-                                  "agentLabel": {
-                                    "type": "string"
-                                  },
-                                  "models": {
-                                    "type": "array",
-                                    "items": {
-                                      "$ref": "#/components/schemas/AgentModel"
-                                    }
-                                  },
-                                  "defaultModel": {
-                                    "type": "string"
-                                  }
-                                },
-                                "required": [
-                                  "agentId",
-                                  "agentType",
-                                  "agentLabel",
-                                  "models",
-                                  "defaultModel"
-                                ],
-                                "additionalProperties": false
+                                "$ref": "#/components/schemas/AgentModelsEntry"
                               }
                             },
                             "defaultAgentId": {
@@ -1428,6 +1402,74 @@
         }
       }
     },
+    "/models.refresh": {
+      "post": {
+        "operationId": "models.refresh",
+        "description": "Refresh the cached model list for the given agent (or every\nconfigured agent when `agentId` is omitted). Surfaces the live SDK\nlist to the persisted cache so subsequent `list` / `listAll` calls\nreturn the latest models. Failures on individual agents do not\nabort the batch — each result carries an optional `error` field.\n\nLatency: this awaits the refresh synchronously. Each agent's\n`refreshModels()` is capped at a ~10 s adapter-side timeout, and the\nno-`agentId` batch path refreshes agents sequentially, so worst-case\nwall-clock is roughly `N agents × 10 s`. The Settings UI only ever\ncalls this with a single `agentId` (one ~10 s ceiling, with a button\nspinner), so the batch ceiling is reached only by an explicit\nall-agents API call. Size any client-side tRPC timeout accordingly.\n\nIf the supported-agent list ever grows past the current 5 entries\n(claude-code, codex, gemini-cli, cursor-cli, opencode), reconsider:\n(a) parallelising the per-agent loop in `refreshAll` (the only\nthing that prevents it today is the `settings.json` RMW interleave,\nwhich a single load-merge-save at the end would let us bypass), or\n(b) flipping the batch path to fire-and-forget with an SSE notice\nso the HTTP response returns immediately.",
+        "tags": [
+          "models"
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "result": {
+                      "type": "object",
+                      "properties": {
+                        "data": {
+                          "type": "object",
+                          "properties": {
+                            "results": {
+                              "type": "array",
+                              "items": {
+                                "$ref": "#/components/schemas/ModelRefreshResult"
+                              }
+                            }
+                          },
+                          "required": [
+                            "results"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "data"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "result"
+                  ]
+                }
+              }
+            }
+          },
+          "default": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "agentId": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      }
+    },
     "/statuses.get": {
       "get": {
         "operationId": "statuses.get",
@@ -4221,6 +4263,19 @@
                   },
                   "usagePollingEnabled": {
                     "type": "boolean"
+                  },
+                  "cli": {
+                    "type": "object",
+                    "properties": {
+                      "defaultVia": {
+                        "type": "string",
+                        "enum": [
+                          "chat",
+                          "terminal"
+                        ]
+                      }
+                    },
+                    "additionalProperties": {}
                   }
                 },
                 "additionalProperties": {}
@@ -4863,6 +4918,16 @@
                             },
                             "path": {
                               "type": "string"
+                            },
+                            "via": {
+                              "type": "string",
+                              "enum": [
+                                "chat",
+                                "terminal"
+                              ]
+                            },
+                            "terminalId": {
+                              "type": "string"
                             }
                           },
                           "required": [
@@ -4910,14 +4975,18 @@
                   "prompt": {
                     "type": "string"
                   },
-                  "maxTurns": {
-                    "type": "number"
-                  },
                   "mode": {
                     "type": "string"
                   },
                   "codingAgentId": {
                     "type": "string"
+                  },
+                  "via": {
+                    "type": "string",
+                    "enum": [
+                      "chat",
+                      "terminal"
+                    ]
                   }
                 },
                 "required": [
@@ -9118,9 +9187,6 @@
                                   "completedAt": {
                                     "type": "number"
                                   },
-                                  "maxTurns": {
-                                    "type": "number"
-                                  },
                                   "mode": {
                                     "type": "string"
                                   },
@@ -9263,9 +9329,6 @@
                   "model": {
                     "type": "string"
                   },
-                  "maxTurns": {
-                    "type": "number"
-                  },
                   "mode": {
                     "type": "string"
                   },
@@ -9772,7 +9835,7 @@
         ],
         "additionalProperties": false
       },
-      "AgentModel": {
+      "CachedAgentModel": {
         "type": "object",
         "properties": {
           "id": {
@@ -9785,8 +9848,7 @@
             "type": "string"
           },
           "contextWindow": {
-            "type": "number",
-            "description": "Approximate max input context window in tokens (e.g. 200000, 1_000_000)."
+            "type": "number"
           }
         },
         "required": [
@@ -9795,6 +9857,66 @@
         ],
         "additionalProperties": false
       },
+      "AgentModelsEntry": {
+        "type": "object",
+        "properties": {
+          "agentId": {
+            "type": "string"
+          },
+          "agentType": {
+            "type": "string"
+          },
+          "agentLabel": {
+            "type": "string"
+          },
+          "models": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CachedAgentModel"
+            }
+          },
+          "updatedAt": {
+            "type": "number"
+          },
+          "defaultModel": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "agentId",
+          "agentType",
+          "agentLabel",
+          "models"
+        ],
+        "additionalProperties": false
+      },
+      "ModelRefreshResult": {
+        "type": "object",
+        "properties": {
+          "agentId": {
+            "type": "string"
+          },
+          "models": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CachedAgentModel"
+            }
+          },
+          "updatedAt": {
+            "type": "number"
+          },
+          "error": {
+            "type": "string",
+            "description": "When refresh failed, the prior cached list (or the adapter defaults)\nis still returned and `error` is populated with the failure reason."
+          }
+        },
+        "required": [
+          "agentId",
+          "models",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
       "WorkspaceStatusSnapshot": {
         "type": "object",
         "properties": {
@@ -10148,6 +10270,20 @@
           "usagePollingEnabled": {
             "type": "boolean",
             "description": "Whether the Reports usage scanner runs (issue #425). When `false`,\n`UsageScannerService.tick()` is a no-op — the periodic 5-minute\nsweep and the fire-and-forget tick triggered by opening the\nReports dialog are both skipped. Useful for users who don't care\nabout cost reporting and want to claw back the per-tick CPU /\nsubprocess churn (Codex/OpenCode adapters spawn helpers).\nDefaults to `true` (treat `undefined` as enabled)."
+          },
+          "cli": {
+            "type": "object",
+            "properties": {
+              "defaultVia": {
+                "type": "string",
+                "enum": [
+                  "chat",
+                  "terminal"
+                ]
+              }
+            },
+            "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."
           }
         },
         "additionalProperties": {}
@@ -10169,6 +10305,17 @@
           },
           "model": {
             "type": "string"
+          },
+          "cachedModels": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CachedAgentModel"
+            },
+            "description": "Cached list of models the agent's SDK / binary reports. Refreshed by\n`ModelRefreshService.refresh()` — explicitly from the Settings UI's\n\"Refresh models\" button, and fire-and-forget at server boot.\n\nThe picker UI (Settings + Chat) reads from this cache directly so it\nstays populated across server restarts and across fresh chats without\nneeding a live SDK call. When the field is absent (fresh install,\nsettings.json from an older version, refresh has never succeeded),\ncallers fall back to the adapter's built-in default list — see\n`ModelRefreshService.getCachedOrDefaults()` and the comments on\neach adapter's `listModels()` method."
+          },
+          "cachedModelsUpdatedAt": {
+            "type": "number",
+            "description": "Epoch ms when `cachedModels` was last refreshed (success or attempt).\nSurfaced in the UI so users can see staleness. Unset until the first\nrefresh completes."
           }
         },
         "required": [
@@ -10751,9 +10898,6 @@
           "prompt": {
             "type": "string"
           },
-          "maxTurns": {
-            "type": "number"
-          },
           "mode": {
             "type": "string"
           },

package/dist/server/assets/{DockviewBrowserContainer-MBbRqrFN.js → DockviewBrowserContainer-DaEHL7rU.js}

@@ -1,5 +1,5 @@
 import { r as reactExports, j as jsxRuntimeExports, R as React } from "../server.js";
-import { m as createLucideIcon, bR as isDesktop, cj as invoke, ck as listen, p as trpc, cl as reactDomExports, cm as Globe, ce as SearchBar, cn as Popover, co as PopoverTrigger, cp as PopoverContent, cq as Search, cr as Trash2, cs as DropdownMenu, ct as DropdownMenuTrigger, cu as ChevronDown, cv as DropdownMenuContent, cw as DropdownMenuItem, cx as TriangleAlert, bX as ArrowLeft, c7 as ArrowRight, X, cy as RotateCw, u as useAdapter, n as useQueryClient, o as useQuery, q as selectNeighbourBeforeRemove, r as centralPanelPosition, v as ensureEdgeGroups, w as attachEdgeGroupDragVisibility, x as registerInnerDockview, y as PanelVisibilityContext, z as DockviewReact, F as cycleTabsInActiveGroup, G as cycleGridGroups, C as Columns2, A as Rows2, B as Plus, E as usePanelVisibility } from "./router-Cne-GWAI.js";
+import { m as createLucideIcon, bR as isDesktop, cl as invoke, cm as listen, p as trpc, cn as reactDomExports, co as Globe, cj as SearchBar, cp as Popover, cq as PopoverTrigger, cr as PopoverContent, cs as Search, ct as Trash2, cu as DropdownMenu, cv as DropdownMenuTrigger, cw as ChevronDown, cx as DropdownMenuContent, cy as DropdownMenuItem, cz as TriangleAlert, bX as ArrowLeft, ce as ArrowRight, X, cA as RotateCw, u as useAdapter, n as useQueryClient, o as useQuery, q as selectNeighbourBeforeRemove, r as centralPanelPosition, v as ensureEdgeGroups, w as attachEdgeGroupDragVisibility, x as registerInnerDockview, y as PanelVisibilityContext, z as DockviewReact, F as cycleTabsInActiveGroup, G as cycleGridGroups, C as Columns2, A as Rows2, B as Plus, E as usePanelVisibility } from "./router-V4X9DgJt.js";
 import "node:async_hooks";
 import "node:stream";
 import "util";

package/dist/server/assets/{DockviewTerminalContainer-CbiPuY7W.js → DockviewTerminalContainer-QeRuw498.js}

@@ -1,6 +1,6 @@
 import { r as reactExports, j as jsxRuntimeExports, R as React } from "../server.js";
-import { u as useAdapter, n as useQueryClient, o as useQuery, p as trpc, q as selectNeighbourBeforeRemove, r as centralPanelPosition, v as ensureEdgeGroups, w as attachEdgeGroupDragVisibility, x as registerInnerDockview, y as PanelVisibilityContext, z as DockviewReact, C as Columns2, A as Rows2, B as Plus, X, E as usePanelVisibility, F as cycleTabsInActiveGroup, G as cycleGridGroups } from "./router-Cne-GWAI.js";
-import { S as SquareTerminal } from "./square-terminal-Dq10fSle.js";
+import { u as useAdapter, n as useQueryClient, o as useQuery, p as trpc, q as selectNeighbourBeforeRemove, r as centralPanelPosition, v as ensureEdgeGroups, w as attachEdgeGroupDragVisibility, x as registerInnerDockview, y as PanelVisibilityContext, z as DockviewReact, C as Columns2, A as Rows2, B as Plus, X, E as usePanelVisibility, F as cycleTabsInActiveGroup, G as cycleGridGroups } from "./router-V4X9DgJt.js";
+import { S as SquareTerminal } from "./square-terminal-Dcy5Z6a4.js";
 import "node:async_hooks";
 import "node:stream";
 import "util";
@@ -12,7 +12,7 @@ import "node:process";
 import "node:path";
 import "node:url";
 const TerminalPanel = reactExports.lazy(
-  () => import("./TerminalPanel-r3EgkGO2.js").then((m) => ({ default: m.TerminalPanel }))
+  () => import("./TerminalPanel-CIQVz_Z4.js").then((m) => ({ default: m.TerminalPanel }))
 );
 function uuid() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {