@blade-hq/agent-client 2610.0.0-beta.87 → 2610.0.0-beta.89

package/README.md

@@ -85,6 +85,10 @@ new BladeClient({
 })
 ```
 
+高级宿主可通过 `BladeClientOptions.commandTransport(event, payload, send)` 接管带回执的命令传输，例如浏览器插件让后台持有发送请求，面板关闭后仍能等待请求结束并停止任务。返回原始服务端 ack，失败时抛错；不接管的命令调用 `send()` 使用默认 Socket.IO。事件订阅仍使用原 socket。`client.requestCommand(event, payload, timeoutMs)` 是同一通道的低层入口，普通应用继续使用类型化的 `AgentSession` 方法。
+
+底层 `createSocket` 允许指定 `transports`；MV3 service worker 没有 XMLHttpRequest，可使用 `["websocket"]`。不指定时保持 Socket.IO 默认选择。
+
 SDK 会固定订阅普通聊天所需的完整实时事件。产品内置 Web 的精简/开发者展示模式不属于
 公共 SDK 契约，也没有对应的构造参数或 Socket.IO 字段。
 

package/dist/blade-client.d.ts

@@ -25,6 +25,8 @@ export interface BladeClientOptions {
     socketToken?: string | (() => string | null | undefined);
     /** login() 取得的令牌存放位置，默认 "local"（localStorage，刷新页面不掉登录）。 */
     tokenStorage?: TokenStorageMode;
+    /** Host-owned command transport; event subscriptions stay on the normal socket. */
+    commandTransport?: (event: string, payload: Record<string, unknown>, send: () => Promise<Record<string, unknown>>) => Promise<Record<string, unknown>>;
     fetchImpl?: typeof fetch;
     onRefreshSuccess?: () => void | Promise<void>;
 }
@@ -81,6 +83,7 @@ export declare class BladeClient {
     /** 底层 Socket.IO 实例因后端地址变化而被替换时通知高级集成层。 */
     onSocketReplaced(listener: () => void): () => void;
     socket(): TypedSocket;
+    requestCommand(event: string, payload: Record<string, unknown>, timeoutMs: number): Promise<Record<string, unknown>>;
     json<T>(method: HttpMethod, path: string, body?: unknown): Promise<T>;
     jsonFromInit<T>(path: string, init?: RequestInit): Promise<T>;
     text(method: HttpMethod, path: string): Promise<string>;

package/dist/index.js

@@ -6096,16 +6096,7 @@ var SessionHub = class {
         ;
         this.client.socket().emit(event, data);
       },
-      emitWithAck: (event, data, timeoutMs) => new Promise((resolve, reject) => {
-        ;
-        this.client.socket().timeout(timeoutMs).emit(event, data, (err, response) => {
-          if (err) {
-            reject(err);
-            return;
-          }
-          resolve(response);
-        });
-      }),
+      emitWithAck: (event, data, timeoutMs) => this.client.requestCommand(event, data, timeoutMs),
       ensureConnected: () => this.ensureConnected(),
       fetchTurnsPage: (sessionId, query, init) => this.client.sessions.getSessionTurnsPage(sessionId, query, init),
       fetchTurnIndex: (sessionId) => this.client.sessions.getSessionTurnIndex(sessionId),
@@ -6386,6 +6377,7 @@ function createSocket(options) {
   return io(options.baseUrl, {
     path: options.path ?? "/socket.io",
     withCredentials: true,
+    ...options.transports ? { transports: options.transports } : {},
     query: token ? { token } : void 0,
     auth: typeof options.token === "function" ? (cb) => cb(buildSocketAuth(options) ?? {}) : buildSocketAuth(options) ?? {},
     autoConnect: false
@@ -6523,6 +6515,16 @@ var BladeClient = class {
     }
     return this.socketInstance;
   }
+  requestCommand(event, payload, timeoutMs) {
+    const send = () => new Promise((resolve, reject) => {
+      ;
+      this.socket().timeout(timeoutMs).emit(event, payload, (error, ack) => {
+        if (error) reject(error);
+        else resolve(ack ?? {});
+      });
+    });
+    return this.options.commandTransport?.(event, payload, send) ?? send();
+  }
   async json(method, path, body) {
     const response = await this.fetch(method, path, {
       body: body === void 0 ? void 0 : JSON.stringify(body),
@@ -6917,7 +6919,7 @@ function resolveServiceUrl(endpoints, name, path = "") {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.87" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.89" : "1.1.1";
 
 // src/commands/protocol.ts
 function isCommandEnvelope(value) {