@blade-hq/agent-client 2612.0.0-beta.20 → 2612.0.0-beta.21

package/README.md

@@ -162,17 +162,17 @@ const index = await client.sessions.getSessionTurnIndex(id) // SessionTurnIndex
 const first = index.items[0] // SessionTurnIndexItem
 ```
 
-创建会话时可以绑定 Streamable HTTP MCP 来源；BA 会在创建成功前读取并保存工具列表，
-来源此时必须可访问且接受创建请求中的 Bearer 凭据。之后沿用已发现的工具目录，
-刷新来源时更新目录。默认 `exposure: "lazy"` 通过 `lazy_tool_list`、`lazy_tool_inspect`、
-`lazy_tool_run` 发现和调用工具；`exposure: "eager"` 会将 `include_tools` 允许的工具和完整
-参数 schema 直接加入执行模式的模型工具列表，无需先 inspect。`eager_tools` 可在 lazy
-来源中选出直接暴露的工具，也可指定 eager 来源中的优先工具。主运行和子智能体使用相同
-策略，计划模式不加载。直接工具的名称为 `mcp_<来源>__<工具>_<hash>`，调用仍经 Go MCP
-dispatcher。会话 MCP 的可用工具名称按来源注入 `lazy_tool_catalog`，lazy 工具完整 schema
-由 `lazy_tool_inspect({tool: "session:<source>/<tool>"})` 按需读取。每个运行最多直接加载 32 个工具、64 KiB 完整工具定义；
-超预算的工具仍可通过
-`lazy_tool_inspect/lazy_tool_run` 使用。
+创建会话时可以绑定 Streamable HTTP MCP 来源，并用可选 `description` 提供用途说明。
+默认 `exposure: "lazy"` 只保存来源配置，创建时不连接 MCP；模型初始只看到来源名称和说明。
+通过 `lazy_tool_search({query: "所需能力", limit: 8})` 全局搜索并获得命中工具的完整标识、
+说明和参数 schema，再用 `lazy_tool_run` 调用。
+首次搜索发现工具，同一执行内复用成功目录；下一次执行重新发现。失败不缓存，也不返回部分成功。
+
+`exposure: "eager"` 以及非空 `eager_tools` 保持创建时发现并保存目录：eager 将 `include_tools`
+允许的工具和完整 schema 直接加入执行模式的模型工具列表；`eager_tools` 可在 lazy 来源中选出
+直接暴露的工具，也可指定 eager 来源中的优先工具。主运行和子智能体使用相同策略，计划模式不加载。
+每个运行最多直接加载 32 个工具、64 KiB 完整工具定义；超预算的工具仍可通过搜索后 run 使用。
+显式会话 refresh 只重新发现 eager 来源目录。调用始终经 Go MCP dispatcher，继续校验当前身份和工具权限。
 Bearer 凭据只在创建或轮换时提交，查询不会返回它：
 
 ```ts

package/dist/blade-client.d.ts

@@ -39,6 +39,7 @@ export declare class BladeClient {
     private readonly anonymousClients;
     private readonly toolProviders;
     private refreshPromise;
+    private cookieLogoutPending;
     private socketInstance;
     private readonly socketReplacementListeners;
     /** login() / setToken() 热挂载的令牌，优先级高于构造参数。 */

package/dist/{chunk-2VIJBVAC.js → chunk-J3XXTHHK.js}

@@ -213,7 +213,7 @@ var ToolProvider = class {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2612.0.0-beta.20" : "1.1.1";
+var SDK_VERSION = true ? "2612.0.0-beta.21" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -379,8 +379,8 @@ var AuthResource = class {
   getProviders() {
     return this.client.json("GET", "/api/auth/providers");
   }
-  getMe() {
-    return this.client.json("GET", "/api/auth/me");
+  getMe(options = {}) {
+    return this.client.jsonFromInit("/api/auth/me", { signal: options.signal });
   }
   logout() {
     return this.client.json("POST", "/api/auth/logout");
@@ -1105,8 +1105,8 @@ function snapshot(state, sequence, status) {
     first_token_ms: state.firstTokenMs,
     stream_duration_ms: state.streamDurationMs,
     first_token_delivery_ms: state.firstTokenDeliveryMs,
-    started_at: state.modelStartedAt ?? new Date(state.startedAt).toISOString(),
-    // 没有 payload 上报时用的是 loop:turn 的浏览器事件时间，标记出来供瀑布区分。
+    started_at: state.modelStartedAt,
+    // 未上报时不伪造服务器起点；浏览器时钟不能与服务器时钟混用。
     has_reported_timing: state.modelStartedAtReported,
     context_window: state.contextWindow,
     memory_refs: state.memoryRefs,
@@ -1859,6 +1859,7 @@ var ClientProjectionBuilder = class {
     return this.syncPatch(state);
   }
   applyFirstTokenDelivery(state, payload) {
+    this.applyStreamTiming(state, payload);
     const firstTokenMs = payload.first_token_ms;
     if (state.firstTokenMs === null && typeof firstTokenMs === "number" && firstTokenMs >= 0) {
       state.firstTokenMs = Math.round(firstTokenMs);
@@ -2600,7 +2601,7 @@ function projectHistory(entries) {
       let content = isRecord(entry.message) ? entry.message.content : void 0;
       if (kind === "tool_result_archive") {
         const archivedCount = Array.isArray(data.archived_files) ? data.archived_files.length : 0;
-        content = `<compaction-summary>
+        content = typeof data.summary === "string" && data.summary ? data.summary : `<compaction-summary>
 \u5DF2\u5F52\u6863 ${archivedCount} \u4E2A\u5927\u578B\u5DE5\u5177\u7ED3\u679C\u3002
 </compaction-summary>`;
       }
@@ -3300,8 +3301,8 @@ var ModelsResource = class {
     this.client = client;
   }
   client;
-  list() {
-    return this.client.json("GET", "/api/config/models");
+  list(options = {}) {
+    return this.client.jsonFromInit("/api/config/models", { signal: options.signal });
   }
 };
 
@@ -4254,6 +4255,20 @@ var SiteVisitsResource = class {
   }
 };
 
+// src/server-clock.ts
+var clocks = /* @__PURE__ */ new WeakMap();
+function syncServerTime(client, timestamp, receivedAt = performance.now()) {
+  if (typeof timestamp !== "string") return;
+  const serverTime = Date.parse(timestamp);
+  if (!Number.isFinite(serverTime)) return;
+  const current = getServerTime(client, receivedAt);
+  clocks.set(client, { serverTime: Math.max(serverTime, current ?? serverTime), receivedAt });
+}
+function getServerTime(client, now = performance.now()) {
+  const clock = client ? clocks.get(client) : void 0;
+  return clock ? clock.serverTime + Math.max(0, now - clock.receivedAt) : null;
+}
+
 // src/session/background.ts
 var BACKGROUND_STATUSES = [
   "starting",
@@ -7857,6 +7872,7 @@ var SessionHub = class {
     socket.on(
       "turn:events",
       (data, acknowledge) => {
+        syncServerTime(this.client, data.server_time);
         acknowledgeTurnEvents(acknowledge);
         if (data.session_id && (this.statusWatchCounts.has(data.session_id) || this.sessions.has(data.session_id)) && data.events?.some((event) => event.type === "log:record")) {
           const delivery = this.statusCursor(data.session_id).consume(data.events ?? []);
@@ -8062,6 +8078,7 @@ var BladeClient = class _BladeClient {
   anonymousClients = /* @__PURE__ */ new Map();
   toolProviders = /* @__PURE__ */ new Set();
   refreshPromise = null;
+  cookieLogoutPending = 0;
   socketInstance = null;
   socketReplacementListeners = /* @__PURE__ */ new Set();
   /** login() / setToken() 热挂载的令牌，优先级高于构造参数。 */
@@ -8287,24 +8304,31 @@ var BladeClient = class _BladeClient {
   }
   async fetch(method, path, init = {}, isRetry = false) {
     const url = this.buildUrl(path);
-    const response = await (this.options.fetchImpl ?? fetch)(url.toString(), {
-      method,
-      body: init.body,
-      credentials: init.credentials ?? "include",
-      headers: this.buildHeaders(url, init.headers),
-      signal: init.signal
-    });
-    if (response.status === 401 && !isRetry && this.shouldRefreshFor401(url)) {
-      const refreshed = await this.tryRefreshUnlessAborted(init.signal);
-      if (refreshed) {
-        return this.fetch(method, path, init, true);
+    const isLogout = method === "POST" && url.pathname === this.buildUrl("/api/auth/logout").pathname && this.isSameBackendUrl(url);
+    if (isLogout) this.cookieLogoutPending += 1;
+    try {
+      if (isLogout) await this.refreshPromise;
+      const response = await (this.options.fetchImpl ?? fetch)(url.toString(), {
+        method,
+        body: init.body,
+        credentials: init.credentials ?? "include",
+        headers: this.buildHeaders(url, init.headers),
+        signal: init.signal
+      });
+      if (response.status === 401 && !isRetry && this.shouldRefreshFor401(url)) {
+        const refreshed = await this.tryRefreshUnlessAborted(init.signal);
+        if (refreshed) {
+          return this.fetch(method, path, init, true);
+        }
       }
+      if (init.expectOk !== false && !response.ok) {
+        const detail = await extractErrorDetail(response);
+        throw decorateAuthError(new BladeApiError(response, detail));
+      }
+      return response;
+    } finally {
+      if (isLogout) this.cookieLogoutPending -= 1;
     }
-    if (init.expectOk !== false && !response.ok) {
-      const detail = await extractErrorDetail(response);
-      throw decorateAuthError(new BladeApiError(response, detail));
-    }
-    return response;
   }
   buildAuthedUrl(path) {
     const url = buildBackendUrl(this.options.baseUrl, path);
@@ -8372,7 +8396,7 @@ var BladeClient = class _BladeClient {
     }
   }
   async tryRefresh() {
-    if (this.options.anonymousSessionId) return false;
+    if (this.options.anonymousSessionId || this.cookieLogoutPending > 0) return false;
     if (this.refreshPromise) {
       return this.refreshPromise;
     }
@@ -8554,6 +8578,8 @@ export {
   isEntryGoneError,
   PluginsResource,
   ChatGroupsResource,
+  syncServerTime,
+  getServerTime,
   authBusyRetryDelayMs,
   AuthBusyReconnect,
   prependOlder,
@@ -8600,4 +8626,4 @@ export {
   createSocket,
   BladeClient
 };
-//# sourceMappingURL=chunk-2VIJBVAC.js.map
+//# sourceMappingURL=chunk-J3XXTHHK.js.map