@blade-hq/agent-client 2612.0.0-beta.31 → 2612.0.0-beta.33

package/README.md

@@ -727,6 +727,12 @@ chat.renderers = {
 
 挂载节点位于 `<blade-chat>` 元素自己的子节点里（通过 `<slot>` 显示在对应位置），所以页面上的普通样式对它生效。可定制的区块与数据形状见 `BladeChatMountRenderers`（`toolCall`、`userMessage`、`assistantText`）；相关类型：`MountRenderer`、`MountRendererObject`、`MountResult`、`MountHandle`。Vue 项目用 `@blade-hq/agent-vue` 的 `defineMountRenderer` 直接包装 Vue 组件。
 
+## 账号连接器
+
+`client.connectors.list()` 列出当前用户沙盒中创建的连接器及随项目发布的内置连接器，来源分别为 `personal`、`builtin`，无需商店安装；`listForSession(sessionId)` 同时返回当前对话的启用状态。`read(name)` 获取认证表单与连接状态；`connect(name, update)` 保存个人配置并执行真实认证；`verify(name)` 验证已有连接；`disconnect(name)` 清除该连接和个人配置。每用户每连接器只有一个连接，修改账号更新原连接；密码与私有状态不通过读取接口返回。认证通过后，用 `sessions.setSessionPluginActivation(sessionId, name, true)` 在沙盒对话中启用；包内容变化后需要重新连接。
+
+相关类型：`ConnectorsResource`、`AccountConnector`、`ConnectorConnection`、`ConnectorConnectionView`。
+
 ## 第一方内部入口
 
 `@blade-hq/agent-client/internal` 是内置 Web、浏览器插件与 `@blade-hq/agent-react` 共用的内部件（状态机细节、判定逻辑、低层通道）。它随包发布，但**不属于公开面**：不写进本文档与 `public-api.md`，版本之间可以随时改动或删除。接入方只用主入口。
@@ -863,6 +869,11 @@ await session.sendPrepared(request)
 
 每条消息最多 20 份资料，ID 不重复，每份正文最多 64000 个 Unicode 字符，整个资料 JSON 最多 256 KiB，超限拒绝。文件沿用指定会话的鉴权与路径解析，不接受外部 URL；仅有 `name` 的文件显示不可用。带资料的可靠消息作为独立一轮排队，不能走只传正文的「立即补充」。原生智能体目前不支持此通道。
 
+## 连接器管理
+
+`ConnectorDraft` 描述连接器名称、说明、可选地址和访问密钥。`client.connectors.list()` 读取本人可用的内置与个人连接器，`create({ display_name, description, url, bearer_token? })` 保存已有 Streamable HTTP MCP 服务。`update(name, draft)` 修改个人连接器信息或地址，`delete(name)` 删除个人包并撤销连接配置；内置包不允许编辑或删除。访问密钥经当前身份的请求体发送并由服务端加密保存，不回传明文。保存后通过 `read` / `connect` 的现有配置流程连接；修改包后需要重新连接。
+
+
 ## 后端应用共享连接
 
 PA 等后端服务使用 `BladeApplicationClient`，全部用户共享两条按需建立的 WebSocket。
@@ -898,3 +909,7 @@ session.send("请处理新增工作", {
   ],
 })
 ```
+
+### 创建或修改连接器
+
+`client.connectors.startGeneration({ connector?, onCreated?, initiator? })` 统一创建生成会话并发送带技能引用的可见消息，返回 `{ session_id, sent }`。`connector` 传已有连接器的名称与展示名表示修改；`onCreated` 仅用于宿主登记缓存、导航。`initiator` 默认 `sdk`，内置 Web 使用 `ui`，保留历史列表和通知语义。选定连接器的名称与展示名通过标准 Context 附件传递，用户消息保持固定，包内文字不会被提升成用户指令。SDK 在发送前调用回调，并释放自身的会话引用。生成结束仍需用户到设置里的连接器正式连接。

package/dist/blade-client.d.ts

@@ -9,6 +9,7 @@ import { ComputersResource } from "./resources/computers";
 import { ModelsResource } from "./resources/models";
 import { SessionsResource } from "./resources/sessions";
 import { PluginsResource } from "./resources/plugins";
+import { ConnectorsResource } from "./resources/connectors";
 import { ChatGroupsResource } from "./resources/chat-groups";
 import { SiteVisitsResource } from "./resources/site-visits";
 import { SessionHub } from "./session/hub";
@@ -56,6 +57,7 @@ export declare class BladeClient {
     readonly sessions: SessionsResource;
     /** 按用户读取的插件目录与图标；没有会话时也能用。 */
     readonly plugins: PluginsResource;
+    readonly connectors: ConnectorsResource;
     readonly chatGroups: ChatGroupsResource;
     /**
      * 全站访问统计：匿名读写，不带 bearer 也不触发登录刷新。

package/dist/{chunk-UNMBNWLF.js → chunk-WZOHGJUO.js}

@@ -224,7 +224,7 @@ var ToolProvider = class {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2612.0.0-beta.31" : "1.1.1";
+var SDK_VERSION = true ? "2612.0.0-beta.33" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -3269,6 +3269,110 @@ var ModelsResource = class {
   }
 };
 
+// src/resources/connectors.ts
+function isLocalConnectorName(name) {
+  return name.startsWith("connector.personal.") || name.startsWith("connector.builtin.");
+}
+var ConnectorsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  create(draft) {
+    return this.client.json("POST", "/api/connectors", draft);
+  }
+  update(name, draft) {
+    return this.client.json("PATCH", `/api/connectors/${encodeURIComponent(name)}`, draft);
+  }
+  delete(name) {
+    return this.client.json("DELETE", `/api/connectors/${encodeURIComponent(name)}`);
+  }
+  /** Create a generation conversation and send its visible Skill request.
+   * Hosts use onCreated only to register caches and navigate before sending. */
+  async startGeneration({ connector, onCreated, initiator = "sdk" } = {}) {
+    const intent = connector ? "\u4FEE\u6539\u8FDE\u63A5\u5668" : "\u521B\u5EFA\u8FDE\u63A5\u5668";
+    const request = connector ? "\u4FEE\u6539\u9009\u5B9A\u7684\u8FDE\u63A5\u5668" : "\u521B\u5EFA\u8FDE\u63A5\u5668";
+    const { session_id } = await this.client.sessions.createSessionWithRequest({ intent, solution_id: "connector_generate", initiator });
+    await onCreated?.({ session_id, intent });
+    const session = await this.client.sessions.connect(session_id);
+    try {
+      const sent = await session.send(`\u8BF7\u4F7F\u7528\u8FDE\u63A5\u5668\u751F\u6210\u5668\uFF0C\u5E2E\u6211${request}\u3002\u5148\u786E\u8BA4\u6211\u5E0C\u671B\u8FDE\u63A5\u7684\u7CFB\u7EDF\u548C\u9700\u8981\u7684\u529F\u80FD\uFF0C\u518D\u6309\u6280\u80FD\u5F15\u5BFC\u6211\u5B8C\u6210\u3002`, {
+        mode: "executing",
+        refs: [{ provider: "skill", id: "generate-connector", label: "\u8FDE\u63A5\u5668\u751F\u6210\u5668" }],
+        ...connector ? { contextAttachments: [{
+          id: "connector-generation-target",
+          label: "\u9009\u5B9A\u7684\u8FDE\u63A5\u5668",
+          content: JSON.stringify({ name: connector.name, display_name: connector.display_name }),
+          update_format: "snapshot"
+        }] } : {}
+      });
+      return { session_id, sent };
+    } finally {
+      session.dispose();
+    }
+  }
+  list(init) {
+    return this.client.jsonFromInit("/api/connectors", init);
+  }
+  listForSession(sessionId, init) {
+    return this.client.jsonFromInit(`/api/connectors?session_id=${encodeURIComponent(sessionId)}`, init);
+  }
+  read(name, init) {
+    return this.client.jsonFromInit(`/api/connectors/${encodeURIComponent(name)}/connection`, init);
+  }
+  connect(name, update, init) {
+    return this.client.jsonFromInit(`/api/connectors/${encodeURIComponent(name)}/connection`, {
+      method: "PUT",
+      body: JSON.stringify(update),
+      ...init
+    });
+  }
+  browserAuthorizationUrl(name) {
+    return new URL(`connector-auth/${encodeURIComponent(name)}`, `${this.client.options.baseUrl.replace(/\/$/, "")}/`).toString();
+  }
+  /** One-use, one-minute identity handoff to this client's trusted Blade origin.
+   * Tokens travel only through a source/origin-bound message, never a URL/storage. */
+  bindBrowserAuthorizationFrame(frame, name) {
+    const nonce = Array.from(crypto.getRandomValues(new Uint8Array(32)), (value) => value.toString(16).padStart(2, "0")).join("");
+    const url = new URL(this.browserAuthorizationUrl(name), window.location.href);
+    url.searchParams.set("embedded", "1");
+    url.searchParams.set("handoff", nonce);
+    url.searchParams.set("parent_origin", window.location.origin);
+    const receive = (event) => {
+      if (event.origin !== url.origin || event.source !== frame.contentWindow || event.data?.type !== "blade:connector-auth-ready" || event.data?.nonce !== nonce) return;
+      cleanup();
+      frame.contentWindow?.postMessage({ type: "blade:connector-auth-identity", nonce, token: this.client.token }, url.origin);
+    };
+    const timeout = window.setTimeout(() => cleanup(), 6e4);
+    const cleanup = () => {
+      window.clearTimeout(timeout);
+      window.removeEventListener("message", receive);
+    };
+    window.addEventListener("message", receive);
+    frame.src = url.toString();
+    return cleanup;
+  }
+  async startBrowserAuthorization(name, sessionId) {
+    const view = await this.read(name);
+    if (view.authorization?.type !== "browser") throw new Error("\u8BE5\u8FDE\u63A5\u5668\u6CA1\u6709\u7F51\u9875\u767B\u5F55\u5165\u53E3");
+    const id = sessionId ?? (await this.client.sessions.createSessionWithRequest({
+      intent: `\u8FDE\u63A5 ${view.display_name || "\u4E1A\u52A1\u7CFB\u7EDF"}`,
+      memory_enabled: false
+    })).session_id;
+    await this.client.json("POST", `/api/sessions/${encodeURIComponent(id)}/browser/wake`, {});
+    const tabs = await this.client.json("GET", `/api/sessions/${encodeURIComponent(id)}/browser/tabs`);
+    const hasBusinessTab = tabs.data?.some(({ url }) => url && url !== "about:blank" && !/^http:\/\/(?:127\.0\.0\.1|localhost):9223\/home(?:[/?#]|$)/.test(url));
+    if (!sessionId || !hasBusinessTab) await this.client.json("POST", `/api/sessions/${encodeURIComponent(id)}/browser/tabs`, { url: view.authorization.url });
+    return { session_id: id, view };
+  }
+  verify(name) {
+    return this.client.json("POST", `/api/connectors/${encodeURIComponent(name)}/connection:verify`);
+  }
+  disconnect(name) {
+    return this.client.json("DELETE", `/api/connectors/${encodeURIComponent(name)}/connection`);
+  }
+};
+
 // src/schemas/session.ts
 import { type } from "arktype";
 var SessionStatus = type(
@@ -3433,7 +3537,8 @@ var SessionsResource = class {
     return this.client.jsonFromInit(`/api/sessions/${encodeURIComponent(sessionId)}/plugins`, init);
   }
   setSessionPluginActivation(sessionId, name, active, init) {
-    return this.client.jsonFromInit(`/api/sessions/${encodeURIComponent(sessionId)}/plugins/${encodeURIComponent(name)}:activation`, { method: "POST", body: JSON.stringify({ active }), ...init });
+    const kind = isLocalConnectorName(name) ? "connectors" : "plugins";
+    return this.client.jsonFromInit(`/api/sessions/${encodeURIComponent(sessionId)}/${kind}/${encodeURIComponent(name)}:activation`, { method: "POST", body: JSON.stringify({ active }), ...init });
   }
   /**
    * Fetch a plugin's package-local icon as bytes.
@@ -7891,6 +7996,7 @@ var BladeClient = class _BladeClient {
   sessions;
   /** 按用户读取的插件目录与图标；没有会话时也能用。 */
   plugins;
+  connectors;
   chatGroups;
   /**
    * 全站访问统计：匿名读写，不带 bearer 也不触发登录刷新。
@@ -7914,6 +8020,7 @@ var BladeClient = class _BladeClient {
     this.models = new ModelsResource(this);
     this.sessions = new SessionsResource(this);
     this.plugins = new PluginsResource(this);
+    this.connectors = new ConnectorsResource(this);
     this.chatGroups = new ChatGroupsResource(this);
     this.siteVisits = new SiteVisitsResource(this);
     this.hub = new SessionHub(this);
@@ -8950,6 +9057,8 @@ export {
   sortComputers,
   ComputersResource,
   ModelsResource,
+  isLocalConnectorName,
+  ConnectorsResource,
   SessionStatus,
   DEFAULT_REPLAY_SPEED,
   SessionInfo,
@@ -9006,4 +9115,4 @@ export {
   BladeClient,
   BladeApplicationClient
 };
-//# sourceMappingURL=chunk-UNMBNWLF.js.map
+//# sourceMappingURL=chunk-WZOHGJUO.js.map