@blade-hq/agent-client 2610.0.0-beta.54 → 2610.0.0-beta.55

package/README.md

@@ -174,6 +174,32 @@ await client.sessions.getSessionTurnsPage(id, { before: page.nextBefore! })
 会话插件可通过 `client.sessions.listSessionPlugins(id)` 查询，并用
 `client.sessions.setSessionPluginActivation(id, name, active)` 切换当前会话。列表项为 `SessionPlugin`；修改结果为 `SessionPluginActivation`，只返回选择和准备状态，安装事实需从列表获取。
 
+账号级目录是 `client.plugins.catalog()`（`PluginsResource` 是 `client.plugins`
+的类型）。它**不依赖任何会话**，返回 `PluginCatalogEntry[]`：`name`、`display_name`、
+`icon`、`installed`。没有会话也要展示插件名称与图标的界面（例如首页的输入框连接器）
+用它，而不是先建一个会话。
+
+`icon` 是不透明的缓存 token（当前是包内容摘要），**不是路径**：把它交给
+`client.plugins.fetchIcon(name)` 取字节再转 object URL，不要拿它拼 URL，也不要把
+`<img>` 指向接口路径（token 用户会拿到 401/403）。
+
+```ts
+const { plugins } = await client.plugins.catalog()
+// plugins: PluginCatalogEntry[]
+//   name          技术 ID：路径、授权、缓存与调用一律用它
+//   display_name  包声明的业务名；null 时界面回退到 name
+//   icon          包内图标的 opaque token；null 表示没有可用图标
+//   installed     当前用户是否安装了它
+
+const blob = await client.plugins.fetchIcon(plugins[0].name)
+const url = URL.createObjectURL(blob)
+```
+
+账号电脑目录是 `client.computers.listAccount()`，返回 `AccountComputerList`。它只回答
+账号事实（登记过哪些电脑、此刻在不在线，`AccountComputer`），**不含**"本次会话能不能
+用它"——那是会话接口 (`client.computers.list`) 的回答。两者混着说，用户就会把在线当成
+已授权。
+
 插件可以在包内 `cn.com.bladeai.agent/config.schema.json` 用标准 JSON Schema
 （Draft 2020-12）声明账号、token 或任意业务配置。声明了配置的插件用
 `client.sessions.getSessionPluginConfig(id, name)` 读取声明与当前值，用
@@ -706,7 +732,9 @@ HTML 一律判无效）；`isInternalStatusToolUiCard` 识别内部「阶段进
 - **SDK 身份**：`SDK_NAME`、`SDK_VERSION`
 - **声明式会话**：`SessionDefinition`、`SolutionDefinition`、`SkillDefinition`、`SessionConfig`、`TextFile`、`SessionSetupError`、`SessionSetupStage`
 - **模型目录**：`ModelsResource`、`ModelCatalog`、`ModelOption`
-- **聊天项目资源（REST）**：`ChatProjectsResource`、`ChatProject`（含 `delete` 永久删除）
+- **聊天分组资源（REST）**：`ChatGroupsResource`、`ChatGroup`（含 `delete` 永久删除）；`client.chatGroups`。旧名 `ChatProjectsResource`、`ChatProject`、`client.chatProjects` 与 `chat_project_id` 字段已随分组改名一并移除，接入方请改用 `chatGroups` 与 `chat_group_id`
+- **插件目录（REST，无会话）**：`PluginsResource`、`PluginCatalogEntry`（`client.plugins`）。首页这类还没有会话的界面用它读名称、业务名与图标 token
+- **账号电脑目录**：`AccountComputer`、`AccountComputerList`（`client.computers.listAccount()`，只读账号事实，不含会话授权）
 - **全站访问统计（REST）**：`SiteVisitsResource`、`SiteVisitsSummary`（`client.siteVisits.record()` 上报一次页面访问、`client.siteVisits.summary()` 只读快照）。这两个操作走独立匿名传输：不带 bearer、不触发 401 登录刷新，只依赖匿名访客 Cookie，供内置 Web 同源使用。
 - **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`ImportSessionOptions`、`AppCliDefinition`、`AppCliAttachment`、`AttachAppOptions`、`PaginatedSessionsResult`、`GlobalSearchResult`、`GlobalSearchResultItem`、`GlobalSearchConversationResult`、`GlobalSearchFileResult`、`SessionHistory`、`SessionContextStats`、`ResultFeedback`、`ResultFeedbackReason`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
 - **会话回放**：`ReplayState`、`ReplaySpeed`、`ReplayPreview`、`ReplaySnapshot`、`toReplaySnapshot`、`DEFAULT_REPLAY_SPEED`

package/dist/blade-client.d.ts

@@ -5,7 +5,8 @@ import { HeadlessResource } from "./resources/headless";
 import { ComputersResource } from "./resources/computers";
 import { ModelsResource } from "./resources/models";
 import { SessionsResource } from "./resources/sessions";
-import { ChatProjectsResource } from "./resources/chat-projects";
+import { PluginsResource } from "./resources/plugins";
+import { ChatGroupsResource } from "./resources/chat-groups";
 import { SiteVisitsResource } from "./resources/site-visits";
 import { SessionHub } from "./session/hub";
 import { type TypedSocket } from "./socket";
@@ -39,7 +40,9 @@ export declare class BladeClient {
     readonly computers: ComputersResource;
     readonly models: ModelsResource;
     readonly sessions: SessionsResource;
-    readonly chatProjects: ChatProjectsResource;
+    /** 按用户读取的插件目录与图标；没有会话时也能用。 */
+    readonly plugins: PluginsResource;
+    readonly chatGroups: ChatGroupsResource;
     /**
      * 全站访问统计：匿名读写，不带 bearer 也不触发登录刷新。
      * 只有内置 Web 的同源页面使用，第三方宿主页面不会被自动统计。

package/dist/index.d.ts

@@ -28,14 +28,16 @@ export type { AuthResource, ExchangeCodeParams, ExchangeCodeResult, ProvidersRes
 export type { HeadlessResource } from "./resources/headless";
 export { ComputersResource } from "./resources/computers";
 export { canToggleComputer, computerDaemonVersion, computerOS, computerPlatformLabel, computerState, sortComputers, } from "./resources/computers";
-export type { ComputerOS, ComputerState, SessionComputer, SessionComputerList, } from "./resources/computers";
+export type { AccountComputer, AccountComputerList, ComputerOS, ComputerState, SessionComputer, SessionComputerList, } from "./resources/computers";
 export { ModelsResource } from "./resources/models";
 export type { ModelCatalog, ModelOption } from "./resources/models";
 export type { SessionsResource } from "./resources/sessions";
 export type { SessionPlugin, SessionPluginActivation } from "./resources/sessions";
 export type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState, SessionPluginConfigStateName, SessionPluginConfigSummary, SessionPluginConfigUpdate, } from "./resources/sessions";
-export { ChatProjectsResource } from "./resources/chat-projects";
-export type { ChatProject } from "./resources/chat-projects";
+export { ChatGroupsResource } from "./resources/chat-groups";
+export type { ChatGroup } from "./resources/chat-groups";
+export { PluginsResource } from "./resources/plugins";
+export type { PluginCatalogEntry } from "./resources/plugins";
 export type { SiteVisitsResource, SiteVisitsSummary } from "./resources/site-visits";
 export { hasChatRunEvent } from "./shared/projection";
 export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, GlobalSearchConversationResult, GlobalSearchFileResult, GlobalSearchResult, GlobalSearchResultItem, ResultFeedback, ResultFeedbackReason, HistoricalCommand, SessionContextStats, SessionHistory, SessionTurnsPage, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";

package/dist/index.js

@@ -467,6 +467,21 @@ var ComputersResource = class {
     this.client = client;
   }
   client;
+  /**
+   * 列出当前账号登记过的全部电脑及其在线状态。
+   *
+   * 首页还没有会话，也要能看到同一份清单——判定各写一份必然分叉，一边的兜底会把
+   * 另一边的错误盖住（#1597）。所以账号事实只从这一个接口读。
+   */
+  async listAccount() {
+    const data = await this.client.json("GET", "/api/daemon/instances");
+    return {
+      computers: (data.instances ?? []).map((instance) => ({
+        ...instance,
+        online: Boolean(instance.online)
+      }))
+    };
+  }
   /**
    * 列出当前用户的全部电脑，带上"在不在线"和"这次会话能不能用"。
    * 服务端只查库，电脑离线时同样返回，所以拿得到"它离线了"这个结论。
@@ -542,7 +557,7 @@ var SessionInfo = type({
   "workspace_path?": "string | null",
   "ba_version?": "string | null",
   "sandbox_version?": "string | null",
-  "chat_project_id?": "string | null",
+  "chat_group_id?": "string | null",
   "match?": "unknown"
 });
 
@@ -608,7 +623,7 @@ function upsertToolCall(state, toolCallId, toolName, displayName, args) {
     });
   }
 }
-function applyToolResult(state, toolCallId, result, status, durationMs, ranInParallel, sourceLoop) {
+function applyToolResult(state, toolCallId, result, status, durationMs, ranInParallel, sourceLoop, startedAt = null) {
   let toolName = "";
   let displayName = "";
   let finalResult = result;
@@ -621,6 +636,7 @@ function applyToolResult(state, toolCallId, result, status, durationMs, ranInPar
     const update = { status, result: finalResult };
     if (durationMs != null) update.duration_ms = durationMs;
     if (ranInParallel != null) update.ran_in_parallel = ranInParallel;
+    if (startedAt != null) update.started_at = startedAt;
     state.toolCalls[i] = { ...tc, ...update };
     toolName = tc.tool_name;
     displayName = tc.display_name;
@@ -1070,6 +1086,9 @@ function createTurnState(turnId, loopId, opts = {}) {
     firstTokenMs: null,
     streamDurationMs: null,
     firstTokenDeliveryMs: null,
+    modelStartedAt: null,
+    modelDurationMs: null,
+    modelStartedAtReported: false,
     memoryRefs: opts.memoryRefs ?? null,
     parentForkToolCallId: null
   };
@@ -1087,11 +1106,13 @@ function snapshot(state, sequence, status) {
     tool_calls: [...state.toolCalls],
     model: state.model,
     usage: state.usage ? { ...state.usage } : null,
-    duration_ms: Math.max(0, Date.now() - state.startedAt),
+    duration_ms: state.modelDurationMs,
     first_token_ms: state.firstTokenMs,
     stream_duration_ms: state.streamDurationMs,
     first_token_delivery_ms: state.firstTokenDeliveryMs,
-    started_at: new Date(state.startedAt).toISOString(),
+    started_at: state.modelStartedAt ?? new Date(state.startedAt).toISOString(),
+    // 没有 payload 上报时用的是 loop:turn 的浏览器事件时间，标记出来供瀑布区分。
+    has_reported_timing: state.modelStartedAtReported,
     context_window: state.contextWindow,
     memory_refs: state.memoryRefs,
     parent_fork_tool_call_id: state.parentForkToolCallId
@@ -1312,6 +1333,8 @@ var ClientProjectionBuilder = class {
   latestTurns = /* @__PURE__ */ new Map();
   turnsById = /* @__PURE__ */ new Map();
   loopDescriptions = /* @__PURE__ */ new Map();
+  /** loop_name → 正在运行的子智能体起点，agent:end 结算并挂到父工具调用上。 */
+  activeSubagentRuns = /* @__PURE__ */ new Map();
   pendingChildPauses = /* @__PURE__ */ new Map();
   pendingMemoryRefs = /* @__PURE__ */ new Map();
   activeCompactions = /* @__PURE__ */ new Map();
@@ -1455,6 +1478,7 @@ var ClientProjectionBuilder = class {
     this.latestTurns.clear();
     this.turnsById.clear();
     this.loopDescriptions.clear();
+    this.activeSubagentRuns.clear();
     this.pendingChildPauses.clear();
     this.pendingMemoryRefs.clear();
     this.activeCompactions.clear();
@@ -1596,6 +1620,13 @@ var ClientProjectionBuilder = class {
   onAgentStart(loopId, payload) {
     const description = optStr(payload.description);
     if (description) this.loopDescriptions.set(loopId, description);
+    const subagentStartedAt = optStr(payload.started_at);
+    if (subagentStartedAt) {
+      this.activeSubagentRuns.set(loopId, {
+        runId: optStr(payload.run_id) ?? loopId,
+        startedAt: subagentStartedAt
+      });
+    }
     const turn = buildSystemNotificationTurn(
       this.nextSeq(),
       this.nextTurnId("agent:start"),
@@ -1797,6 +1828,13 @@ var ClientProjectionBuilder = class {
     if (typeof payload.stream_duration_ms === "number" && payload.stream_duration_ms >= 0) {
       state.streamDurationMs = Math.round(payload.stream_duration_ms);
     }
+    if (typeof payload.started_at === "string" && payload.started_at) {
+      state.modelStartedAt = payload.started_at;
+      state.modelStartedAtReported = true;
+    }
+    if (typeof payload.duration_ms === "number" && payload.duration_ms >= 0) {
+      state.modelDurationMs = Math.round(payload.duration_ms);
+    }
   }
   onToolResultDone(state, loopId, payload) {
     const toolCallId = String(payload.tool_call_id ?? "");
@@ -1807,7 +1845,8 @@ var ClientProjectionBuilder = class {
     const durationMs = typeof rawDuration === "number" && rawDuration >= 0 ? Math.round(rawDuration) : null;
     const ranInParallel = typeof payload.ran_in_parallel === "boolean" ? payload.ran_in_parallel : null;
     const sl = sourceLoopFor(state.loopId, this.loopDescriptions);
-    applyToolResult(state, toolCallId, content, status, durationMs, ranInParallel, sl);
+    const startedAt = typeof payload.started_at === "string" && payload.started_at ? payload.started_at : null;
+    applyToolResult(state, toolCallId, content, status, durationMs, ranInParallel, sl, startedAt);
     const isNativeProviderResult = typeof payload.provider === "string" && payload.provider !== "";
     if (!isNativeProviderResult && this.shouldFinalizeAfterToolResults(state)) {
       return this.finalize(loopId, "completed");
@@ -1963,6 +2002,7 @@ var ClientProjectionBuilder = class {
   }
   onAgentEnd(state, loopId, payload) {
     const ok = payload.ok !== false;
+    this.settleSubagentRun(loopId, payload);
     const status = ok ? "done" : "error";
     const title = `Agent: ${payload.description ?? payload.skill_id ?? "agent"}`;
     const detail = optStr(payload.error);
@@ -1989,6 +2029,32 @@ var ClientProjectionBuilder = class {
     );
     return [{ kind: "upsert", turn }];
   }
+  settleSubagentRun(loopId, payload) {
+    const active = this.activeSubagentRuns.get(loopId);
+    this.activeSubagentRuns.delete(loopId);
+    const parentToolCallId = optStr(payload.parent_fork_tool_call_id);
+    if (!parentToolCallId) return;
+    const rawDuration = payload.run_duration_ms;
+    const durationMs = typeof rawDuration === "number" && rawDuration >= 0 ? Math.round(rawDuration) : null;
+    const rawStatus = optStr(payload.run_status);
+    const status = rawStatus === "failed" || rawStatus === "cancelled" || rawStatus === "paused" || rawStatus === "incomplete" ? rawStatus : payload.ok === false ? "failed" : "completed";
+    const run = {
+      run_id: active?.runId ?? optStr(payload.run_id) ?? loopId,
+      scope: "subagent",
+      loop_id: loopId,
+      started_at: active?.startedAt ?? optStr(payload.run_started_at),
+      duration_ms: durationMs,
+      status
+    };
+    const seen = /* @__PURE__ */ new Set();
+    for (const turn of [...this.latestTurns.values(), ...this.turnsById.values()]) {
+      if (seen.has(turn)) continue;
+      seen.add(turn);
+      const toolCall = turn.tool_calls.find((item) => item.id === parentToolCallId);
+      if (!toolCall) continue;
+      toolCall.subagent_runs = [...toolCall.subagent_runs ?? [], run];
+    }
+  }
   dropIncompleteToolCalls(state) {
     if (state.responseDone) return;
     state.toolCalls = [];
@@ -2129,6 +2195,32 @@ function projectHistory(entries) {
       if (target && duration !== null) target.first_token_delivery_ms = duration;
       continue;
     }
+    if (kind === "run_timing" && isRecord(entry.data)) {
+      const data = entry.data;
+      if (data.scope === "subagent") {
+        const parentToolCallId = String(data.parent_fork_tool_call_id ?? "");
+        const duration = numberOrNull(data.duration_ms);
+        const rawStatus = String(data.status ?? "completed");
+        const status = rawStatus === "failed" || rawStatus === "cancelled" || rawStatus === "paused" || rawStatus === "incomplete" ? rawStatus : "completed";
+        for (const turn of turns) {
+          const toolCall = turn.tool_calls.find((item) => item.id === parentToolCallId);
+          if (!toolCall) continue;
+          toolCall.subagent_runs = [
+            ...toolCall.subagent_runs ?? [],
+            {
+              run_id: String(data.run_id ?? ""),
+              scope: "subagent",
+              loop_id: loopId,
+              started_at: typeof data.started_at === "string" ? data.started_at : null,
+              duration_ms: duration,
+              status
+            }
+          ];
+          break;
+        }
+      }
+      continue;
+    }
     if (kind === "post_chat_followup" && isRecord(entry.data)) {
       const assistantEntryId = String(entry.data.assistant_entry_id ?? "");
       if (latestRootMessage?.role === "assistant" && latestRootMessage.turn_id === assistantEntryId) {
@@ -2157,6 +2249,9 @@ function projectHistory(entries) {
           toolCall.result = message.content ?? "";
           const duration = numberOrNull(message._duration_ms);
           if (duration !== null) toolCall.duration_ms = duration;
+          if (typeof message._started_at === "string") {
+            toolCall.started_at = message._started_at;
+          }
           if (message._ran_in_parallel === true) toolCall.ran_in_parallel = true;
           owner.blocks.push({
             type: "tool_result",
@@ -2181,10 +2276,12 @@ function projectHistory(entries) {
         tool_calls: toolCalls,
         model: stringOrNull(message.model),
         usage: isRecord(message._usage) ? { ...message._usage } : null,
-        duration_ms: numberOrZero(message._duration_ms),
+        // 模型请求区间来自持久化字段；旧会话缺失时为 null，不用落盘时刻冒充（#2581 A1）。
+        duration_ms: numberOrNull(message._duration_ms),
         first_token_ms: numberOrNull(message._first_token_ms),
         stream_duration_ms: numberOrNull(message._stream_duration_ms),
-        started_at: typeof entry.timestamp === "string" ? entry.timestamp : void 0,
+        started_at: typeof message._started_at === "string" ? message._started_at : typeof entry.timestamp === "string" ? entry.timestamp : void 0,
+        has_reported_timing: typeof message._started_at === "string",
         // fork 子会话的父锚点:历史里落在消息级 _parent_fork_tool_call_id。丢掉它,
         // 刷新后工作流步骤 fork 就配不回 workflow:run 工具调用(普通 Agent fork 有
         // root Agent 工具调用兜底配对,工作流 fork 没有,子智能体卡会整体消失)。
@@ -2201,10 +2298,15 @@ function projectHistory(entries) {
         previousTurn.status = turn.status;
         previousTurn.model = turn.model ?? previousTurn.model;
         previousTurn.usage = turn.usage ?? previousTurn.usage;
-        previousTurn.duration_ms = turn.duration_ms || previousTurn.duration_ms;
+        if (turn.duration_ms) previousTurn.duration_ms = turn.duration_ms;
         previousTurn.first_token_ms = turn.first_token_ms ?? previousTurn.first_token_ms;
         previousTurn.stream_duration_ms = turn.stream_duration_ms ?? previousTurn.stream_duration_ms;
-        if (turn.started_at) previousTurn.started_at = turn.started_at;
+        if (turn.has_reported_timing) {
+          previousTurn.started_at = turn.started_at;
+          previousTurn.has_reported_timing = true;
+        } else if (!previousTurn.has_reported_timing) {
+          previousTurn.started_at = previousTurn.started_at ?? turn.started_at;
+        }
         previousTurn.id = turn.id;
         previousTurn.turn_id = turn.turn_id;
         if (isNativeToolEntry) nativeToolTurns.add(previousTurn);
@@ -2482,9 +2584,6 @@ function markerTurn(id, sequence, loopId, type3, content, toolCallId = null) {
 function stringOrNull(value) {
   return typeof value === "string" ? value : null;
 }
-function numberOrZero(value) {
-  return typeof value === "number" ? value : 0;
-}
 function numberOrNull(value) {
   return typeof value === "number" && value >= 0 ? value : null;
 }
@@ -2517,7 +2616,7 @@ function toCreateSessionPayload(request) {
     ...request.runtime_type ? { runtime_type: request.runtime_type } : {},
     ...request.daemon_id ? { daemon_id: request.daemon_id } : {},
     ...request.agent_runtime_id ? { agent_runtime_id: request.agent_runtime_id } : {},
-    ...request.chat_project_id ? { chat_project_id: request.chat_project_id } : {}
+    ...request.chat_group_id ? { chat_group_id: request.chat_group_id } : {}
   };
 }
 var builtinSolutionIds = /* @__PURE__ */ new Set([
@@ -2602,6 +2701,18 @@ var SessionsResource = class {
   sessionPluginIconUrl(sessionId, name) {
     return this.client.buildAuthedUrl(`/api/sessions/${encodeURIComponent(sessionId)}/plugins/${encodeURIComponent(name)}/icon`);
   }
+  /**
+   * 准备一个插件的配置：把包准备好并读出用户的配置契约，**不启用**它。
+   *
+   * 开启插件前必须先走这一步：缺配置时用户只会看到配置表单，服务端不会先把
+   * active 持久化成 true 再靠补偿关掉。它不修改会话的插件选择、不连接 MCP。
+   */
+  prepareSessionPluginConfig(sessionId, name, init) {
+    return this.client.jsonFromInit(
+      `/api/sessions/${encodeURIComponent(sessionId)}/plugins/${encodeURIComponent(name)}:prepare-config`,
+      { method: "POST", ...init }
+    );
+  }
   /**
    * Read a plugin's configuration contract and the user's stored values.
    *
@@ -2717,7 +2828,7 @@ var SessionsResource = class {
     solution_id,
     solution_registry_id,
     q,
-    chat_project_id
+    chat_group_id
   }) {
     const searchParams = new URLSearchParams();
     searchParams.set("limit", String(limit));
@@ -2730,7 +2841,7 @@ var SessionsResource = class {
     }
     const trimmedQuery = q?.trim();
     if (trimmedQuery) searchParams.set("q", trimmedQuery);
-    if (chat_project_id) searchParams.set("chat_project_id", chat_project_id);
+    if (chat_group_id) searchParams.set("chat_group_id", chat_group_id);
     return this.client.json("GET", `/api/sessions?${searchParams.toString()}`);
   }
   async listSessions(template_id_prefix, solution_id) {
@@ -3115,23 +3226,48 @@ function profileToCreateSessionRequest(profile) {
   };
 }
 
-// src/resources/chat-projects.ts
-var ChatProjectsResource = class {
+// src/resources/plugins.ts
+var PluginsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * 列出当前用户安装的插件及其展示信息。
+   *
+   * 服务端可能为了补齐名称/图标惰性获取包内容，但绝不激活插件、不连 MCP；
+   * 单个插件的展示信息读不出来只会降级成占位，不会让整份目录失败。
+   */
+  catalog(init) {
+    return this.client.jsonFromInit("/api/plugins/catalog", init);
+  }
+  /** 取一个插件的包内图标字节（用户级，不需要会话）。 */
+  fetchIcon(name) {
+    return this.client.blob("GET", `/api/plugins/${encodeURIComponent(name)}/icon`);
+  }
+  /** 带凭据的图标地址；能直接用 blob URL 的地方优先用 `fetchIcon`。 */
+  iconUrl(name) {
+    return this.client.buildAuthedUrl(`/api/plugins/${encodeURIComponent(name)}/icon`);
+  }
+};
+
+// src/resources/chat-groups.ts
+var ChatGroupsResource = class {
   constructor(client) {
     this.client = client;
   }
   client;
   list() {
-    return this.client.json("GET", "/api/chat-projects");
+    return this.client.json("GET", "/api/chat-groups");
   }
   create(payload) {
-    return this.client.json("POST", "/api/chat-projects", payload);
+    return this.client.json("POST", "/api/chat-groups", payload);
   }
-  update(projectId, payload) {
-    return this.client.json("PATCH", `/api/chat-projects/${encodeURIComponent(projectId)}`, payload);
+  update(groupId, payload) {
+    return this.client.json("PATCH", `/api/chat-groups/${encodeURIComponent(groupId)}`, payload);
   }
-  delete(projectId) {
-    return this.client.json("DELETE", `/api/chat-projects/${encodeURIComponent(projectId)}`);
+  delete(groupId) {
+    return this.client.json("DELETE", `/api/chat-groups/${encodeURIComponent(groupId)}`);
   }
 };
 
@@ -5934,7 +6070,9 @@ var BladeClient = class {
   computers;
   models;
   sessions;
-  chatProjects;
+  /** 按用户读取的插件目录与图标；没有会话时也能用。 */
+  plugins;
+  chatGroups;
   /**
    * 全站访问统计：匿名读写，不带 bearer 也不触发登录刷新。
    * 只有内置 Web 的同源页面使用，第三方宿主页面不会被自动统计。
@@ -5952,7 +6090,8 @@ var BladeClient = class {
     this.computers = new ComputersResource(this);
     this.models = new ModelsResource(this);
     this.sessions = new SessionsResource(this);
-    this.chatProjects = new ChatProjectsResource(this);
+    this.plugins = new PluginsResource(this);
+    this.chatGroups = new ChatGroupsResource(this);
     this.siteVisits = new SiteVisitsResource(this);
     this.hub = new SessionHub(this);
     if (this.options.token === void 0) {
@@ -6421,7 +6560,7 @@ function resolveServiceUrl(endpoints, name, path = "") {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.54" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.55" : "1.1.1";
 
 // src/commands/protocol.ts
 function isCommandEnvelope(value) {
@@ -6526,7 +6665,7 @@ export {
   AuthBusyReconnect,
   BladeApiError,
   BladeClient,
-  ChatProjectsResource,
+  ChatGroupsResource,
   ClientProjectionBuilder,
   ComputersResource,
   DEFAULT_REPLAY_SPEED,
@@ -6534,6 +6673,7 @@ export {
   EMPTY_SESSION_QUEUE,
   LayoutType,
   ModelsResource,
+  PluginsResource,
   PollingBackoff,
   SDK_NAME,
   SDK_VERSION,