@blade-hq/agent-client 2608.0.3 → 2608.0.4-beta.2

package/dist/resources/models.d.ts

@@ -2,6 +2,12 @@ import type { BladeClient } from "../blade-client";
 export interface ModelOption {
     id: string;
     label: string;
+    /**
+     * 把这个模型发给 `baseUrl` 时该用的名字。`id` 是平台内部标识，接了多个模型服务时
+     * 形如 `provider-xxx::name`，直接发过去会被拒。不在 `baseUrl` 那个服务上的模型
+     * 这里是空串——自己做模型选择器时据此过滤。
+     */
+    serviceModelId?: string;
 }
 export interface ModelCatalog {
     default: string;
@@ -10,8 +16,18 @@ export interface ModelCatalog {
      * 平台默认模型服务的 OpenAI 兼容地址（Server ≥ 提供 `baseUrl` 的版本才有，否则为空）。
      * 自建应用可以带用户的 PAT 直接调它，不必让用户自己填地址——网关端口各部署不同，
      * 推算不出来。
+     *
+     * 这是**服务端视角**的地址：平台可能配的是 `http://127.0.0.1:30000/v1`，从自己后端
+     * 转发没问题，直接丢给浏览器就指向用户自己的机器了。默认形态是后端透传（密钥也不该
+     * 进浏览器），浏览器直连只适合这个地址对浏览器同样可达的场景。
      */
     baseUrl?: string;
+    /**
+     * 直接调 `baseUrl` 时该用的默认模型名。**不要用 `default`**——那是平台内部标识，
+     * 平台默认模型来自额外接的模型服务时它带 `provider-xxx::` 前缀，发过去只会得到
+     * 「模型不存在」。没有可直调的模型时为空串。
+     */
+    defaultServiceModel?: string;
 }
 /** Server 可供当前用户选择的模型目录。 */
 export declare class ModelsResource {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-client",
-  "version": "2608.0.3",
+  "version": "2608.0.4-beta.2",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",
@@ -18,7 +18,9 @@
   "files": [
     "dist",
     "README.md",
-    "public-api.md"
+    "public-api.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": [
     "**/*.css"

package/public-api.md

@@ -598,6 +598,7 @@ export type ModeId = "planning" | "executing"
 ```ts
 baseUrl: string | undefined
 default: string
+defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -606,6 +607,7 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
+serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)