@blade-hq/agent-client 2612.0.0-beta.11 → 2612.0.0-beta.13

package/README.md

@@ -181,14 +181,63 @@ const { session_id } = await client.sessions.createSessionWithRequest({
     id: "feishu",
     url: "https://adapter.example.com/mcp",
     bearer_token: sessionToken,
-    eager_tools: ["send_files"],
+    include_tools: ["send_files"],
   }],
 })
 ```
 
-工具集合由创建请求确定，后续 `session.send()` 沿用它。查询来源和轮换凭据的 REST 接口见 Swagger；轮换时传入 `null` 可撤销某来源凭据。
+来源与白名单由创建或配置升级请求确定。查询来源和轮换凭据的 REST 接口见 Swagger；轮换时传入 `null` 可撤销某来源凭据。
 `skip_confirmations: true` 会让该会话的普通轮次直接执行工具，适合由接入方自行承接交互的渠道会话。
 
+### 升级已有会话的全套配置
+
+会话所有者可通过 `GET/PATCH /api/sessions/{id}/configuration` 查询和升级已有沙盒会话，
+保留 ID、对话历史、压缩摘要、用户文件及非方案技能。升级不重跑初始化或初始消息。
+请求类型为 `UpdateSessionConfigurationRequest`，查询和升级返回 `SessionConfiguration`。
+
+```ts
+const current = await client.sessions.getSessionConfiguration(id)
+const applied = await client.sessions.updateSessionConfiguration(id, {
+  version: "pa-2026-10-12",
+  expected_revision: current.revision,
+  session_solution_asset_id: newSolutionAssetId,
+  biz_role_id: "main",
+  model: "your-model-id",
+  enable_thinking: false,
+  memory_enabled: true,
+  disable_tools: [],
+  env: {},
+  skip_confirmations: true,
+  compaction_ratio: 0.75,
+  mcp_sources: [{
+    id: "personal-assistant",
+    url: "https://adapter.example.com/mcp",
+    include_tools: ["send_user_message", "delegate_task"],
+  }],
+})
+console.log(applied.version, applied.revision)
+```
+
+Solution 来源用 `solution_ref`、`solution_id` 或 `session_solution_asset_id` 三选一；只更新
+`biz_role_id` 时使用当前方案。其他可升级字段如示例。省略字段保持旧值；数组和对象整体
+替换，`[]`/`{}` 清空。只有 `enable_thinking`、`compaction_ratio` 接受 null，表示恢复默认。
+角色省略时保留原角色，新方案不包含它则报错。MCP 同 ID 的来源省略 bearer_token 保留旧
+凭据；新来源省略则匿名访问，显式 null 也表示匿名访问。已撤销来源必须显式提供凭据。
+被删除的来源和被移出白名单的工具不能继续调用，查询不返回凭据。
+
+全部校验（含 MCP 发现）成功后一起提交，失败继续使用旧配置。执行、压缩或轮次交接中
+返回 409，请在轮次结束后重试；成功后下一轮生效。同一 version 同一请求重复提交安全且
+revision 不增加，同 version 不同请求返回 409。`expected_revision` 可选，用于避免覆盖
+另一份升级。首次查询未升级的会话返回 version=null、revision=0；version/revision 记录
+本接口成功提交的升级，其他既有独立修改接口仍可使用，实际字段以查询的 configuration 为准。
+
+配置升级只追加当前规则快照或撤回说明，不改写或过滤已有模型消息，保持对话消息前缀。
+更换模型或修改 eager 工具 schema 时允许缓存失效。
+
+daemon/native 和回放会话不支持该接口。runtime_type、daemon_id、agent_runtime_id、父子
+关系、聊天分组、template_id、primary_skill_id 等创建或绑定字段提交后返回 422，未知字段
+也返回 422。方案技能与用户已有技能同路径冲突时拒绝升级，用户文件不会被覆盖。
+
 `SessionTurnsQuery` 的 `before` 与 `fromEntryId` 互斥；定位命中不了当前分支时服务端返回
 404 / 409，而不是空窗口。目录的 `entryId` 与 `/turns` 的 `turn_id` 同源，可直接当 `before` 游标。
 
@@ -731,3 +780,11 @@ chat.renderers = {
 `session.send(text, { refs })` 选择本轮条目；不传 refs 继承上一轮选择，`refs: []` 清除，新的数组替换。AskUser 和暂停续跑沿用本轮冻结内容，下一条新消息才重新读取。流式消息和历史消息都保留 `message.refs`。
 
 `ToolEvidence` 是工具调用的原文快照类型。`ToolCallInfo.evidence` 保存引用编号、原文、插件包摘要及具体调用身份；历史查看直接使用该字段，插件停用或卸载后仍可核查当时内容。
+
+Solution 的 `skill_tools_enabled`、是否为 `solution-app`、是否采用 `night_build` 安全策略会影响 system 前缀，属于创建时策略；升级时跨值修改返回 422，其他字段也不会部分提交。角色规则和方案技能可正常升级。
+
+非默认模板绑定的会话不能通过 Solution selector 转换为方案会话（422）；普通运行配置仍可升级，模板绑定保持原样。
+
+已应用的版本 ID 持久保留：当前版本相同请求幂等返回；被后续升级覆盖的版本返回 409，禁止延迟重试回滚配置。主动回退配置应提交新的版本 ID。
+
+分组会话复用现有 validate_group_session 约束，只允许通用助手；切换到业务 Solution 返回 422，普通运行设置可升级，分组绑定保留。

package/dist/{chunk-SCG5SRXE.js → chunk-KPS6X6QX.js}

@@ -1,6 +1,6 @@
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2612.0.0-beta.11" : "1.1.1";
+var SDK_VERSION = true ? "2612.0.0-beta.13" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -3114,7 +3114,6 @@ var SessionInfo = type({
   "initiator?": "'ui' | 'sdk' | 'unknown' | null",
   "is_headless?": "boolean",
   "viewer_role?": "'owner' | 'viewer'",
-  "template_id?": "string | null",
   "model?": "string | null",
   "enable_thinking?": "boolean | null",
   "solution_id?": "string | null",
@@ -3122,10 +3121,6 @@ var SessionInfo = type({
   "biz_role_id?": "string | null",
   "solution?": "unknown",
   "plan_summary?": "string | null",
-  "primary_skill_id?": "string | null",
-  // ship-attack v2：后端 engine.set_bound_skill 写入的"绑定 skill id"。
-  // 未绑定 / 非 ship-attack session 为 null。
-  "bound_skill_id?": "string | null",
   "replay_state?": "unknown",
   "is_pinned?": "boolean",
   "pinned_at?": "string | null",
@@ -3165,14 +3160,12 @@ function toCreateSessionPayload(request) {
   const solutionRef = request.solution_ref ?? externalSolutionRef(request.solution_id);
   return {
     intent: request.intent ?? "",
-    template_id: request.template_id,
     solution_id: solutionRef ? void 0 : request.solution_id,
     solution_ref: solutionRef,
     biz_role_id: request.biz_role_id ?? null,
     model: request.model ?? null,
     enable_thinking: request.enable_thinking ?? null,
     memory_enabled: request.memory_enabled ?? null,
-    primary_skill_id: request.primary_skill_id ?? null,
     env: request.env,
     disable_tools: request.disable_tools ?? null,
     mcp_sources: request.mcp_sources,
@@ -3412,7 +3405,6 @@ var SessionsResource = class {
   fetchSessionsPage({
     limit,
     offset,
-    template_id_prefix,
     solution_id,
     solution_registry_id,
     q,
@@ -3421,7 +3413,6 @@ var SessionsResource = class {
     const searchParams = new URLSearchParams();
     searchParams.set("limit", String(limit));
     searchParams.set("offset", String(offset));
-    if (template_id_prefix) searchParams.set("template_id_prefix", template_id_prefix);
     if (solution_registry_id) {
       searchParams.set("solution_registry_id", solution_registry_id);
     } else if (solution_id) {
@@ -3432,12 +3423,12 @@ var SessionsResource = class {
     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) {
+  async listSessions(solution_id) {
     const pageSize = 100;
     const sessions = [];
     let offset = 0;
     while (true) {
-      const page = await this.fetchSessionsPage({ limit: pageSize, offset, template_id_prefix, solution_id });
+      const page = await this.fetchSessionsPage({ limit: pageSize, offset, solution_id });
       sessions.push(...page.items);
       if (sessions.length >= page.total || page.items.length === 0) return sessions;
       offset += page.items.length;
@@ -3454,8 +3445,8 @@ var SessionsResource = class {
     if (params.limit !== void 0) searchParams.set("limit", String(params.limit));
     return this.client.json("GET", `/api/search?${searchParams.toString()}`);
   }
-  createSession(intent, template_id, primary_skill_id) {
-    return this.createSessionWithRequest({ intent, template_id, primary_skill_id });
+  createSession(intent) {
+    return this.createSessionWithRequest({ intent });
   }
   createSessionWithRequest(request) {
     return this.client.json("POST", "/api/sessions", toCreateSessionPayload(request));
@@ -3473,6 +3464,13 @@ var SessionsResource = class {
   updateSession(sessionId, payload) {
     return this.client.json("PATCH", `/api/sessions/${sessionId}`, payload);
   }
+  getSessionConfiguration(sessionId, init) {
+    return this.client.jsonFromInit(`/api/sessions/${encodeURIComponent(sessionId)}/configuration`, init);
+  }
+  /** Updates atomically between turns. A running/handoff session returns HTTP 409. */
+  updateSessionConfiguration(sessionId, request) {
+    return this.client.json("PATCH", `/api/sessions/${encodeURIComponent(sessionId)}/configuration`, request);
+  }
   setSessionEnv(sessionId, env) {
     return this.client.json("PUT", `/api/sessions/${sessionId}/env`, { env });
   }
@@ -6568,7 +6566,6 @@ var AgentSession = class _AgentSession {
       intent: data.intent,
       status: data.status,
       model: data.model,
-      boundSkillId: data.bound_skill_id,
       replayState: data.replay_state
     });
   }
@@ -8267,4 +8264,4 @@ export {
   createSocket,
   BladeClient
 };
-//# sourceMappingURL=chunk-SCG5SRXE.js.map
+//# sourceMappingURL=chunk-KPS6X6QX.js.map