@blade-hq/agent-client 1.1.1 → 1.1.3

package/README.md

@@ -6,7 +6,7 @@ Blade Agent 的框架无关客户端。浏览器和 Node.js 都能用；用 Vue
 
 1. **实时会话**（`AgentSession`）：把 Socket.IO 协议、历史加载、流式合流、断线重连全部封装掉，你只面对"状态快照 + 动作 + 事件"。
 2. **登录**：`client.auth.login()` 弹窗授权，用户点一下"许可授权"就拿到访问令牌，不用手工复制粘贴。
-3. **REST**：只类型化会话相关的少数接口（`client.sessions.*`）。长尾接口 SDK 不封装，对照 Swagger 用原生 `fetch` + `client.token` 自行调用。
+3. **REST**：类型化会话和模型目录（`client.sessions.*`、`client.models.list()`）。其他长尾接口对照 Swagger 用原生 `fetch` + `client.token` 调用。
 
 ```bash
 npm install @blade-hq/agent-client
@@ -91,6 +91,30 @@ const configured = await client.sessions.create({ intent: "数据分析", model:
 
 两者都返回 [`AgentSession`](#agentsession)。
 
+### 声明完整会话
+
+自定义 Solution、Skill 和模型无需手写上传步骤：
+
+```ts
+const chat = await client.sessions.create({
+  solution: {
+    role: "resume-writer",
+    files: [
+      { path: "solution.yaml", content: solutionYaml },
+      { path: "roles/resume-writer/role.yaml", content: roleYaml },
+      { path: "roles/resume-writer/AGENTS.md.j2", content: rolePrompt },
+    ],
+  },
+  skills: [{
+    name: "my/resume",
+    files: [{ path: "SKILL.md", content: "# 简历制作" }],
+  }],
+  config: { model: "qwen3.5-122b-int4" },
+})
+```
+
+Solution 和 Skill 都声明为 `{ path, content }[]` 文本文件；SDK 负责准备资源、创建会话和安装 Skill，成功返回时 `chat` 已可使用。已有 Solution 改传 `solution: { id, role }`。模型值是 Server 模型目录中的 ID，LLM 地址与密钥应由 Server 管理。
+
 > **`sessionId` 从哪来？** 三种，按需选：
 > 1. **不用管它** —— 首次接入最省事：`client.sessions.create()` 直接建一个新会话，用不着 ID。React 的 `<ChatView />` 不传 `sessionId` 也一样。
 > 2. **自己建、自己存**：`const { session_id } = await client.sessions.createSessionWithRequest({ intent: "季度报表分析" })`。把返回的 `session_id`（后端是蛇形命名）存进你的数据库或 URL，用户下次进来传给 `connect(sessionId)`（前端参数是驼峰），就能接着上次的对话。
@@ -116,6 +140,21 @@ await client.sessions.deleteFile(id, "notes.md")
 client.buildAuthedUrl(`/api/sessions/${id}/files/report.pdf`) // 带鉴权的下载/预览地址
 ```
 
+连接后的 `AgentSession` 提供最常用的短写法：
+
+```ts
+await chat.listDir("输出")
+await chat.countFiles()                         // 递归统计，不含目录
+await chat.downloadFile("输出/简历.md", "简历.md") // 浏览器下载
+```
+
+### 模型目录
+
+```ts
+const { default: defaultModel, models } = await client.models.list()
+// models: Array<{ id, label }>
+```
+
 ## AgentSession
 
 一个会话的实时状态机。**状态归属实例**：同一页面建多个会话互不干扰。
@@ -254,30 +293,13 @@ PATCH / query / FormData / AbortSignal 等完整 HTTP 语义（否则不够用
 await client.headless.run("统计上月订单量", { schema })
 ```
 
-## 版本握手
-
-本 SDK 与 Server 是配套的：`@blade-hq/agent-client` 2.x 需要 Server 1.1.1 及以上。
-
-SDK 在首次建立会话前会查询 `GET /api/version`。版本不匹配时抛出
-`VersionMismatchError`，报错文案里写清楚双方版本号和该升级哪一端，
-而不是让你对着一个莫名其妙的运行时异常发呆：
-
-```ts
-import { VersionMismatchError } from "@blade-hq/agent-client"
-
-try {
-  const chat = await client.sessions.create()
-} catch (error) {
-  if (error instanceof VersionMismatchError) {
-    console.error(error.message) // 含双方版本号与建议动作
-  }
-}
-```
+## 版本
 
-旧接入方的选择：继续用 `@blade-hq/agent-kit` 1.1.0 对接 1.1.0 及以下的 Server，
-或升级到本包对接 1.1.1 及以上的 Server。**不支持交叉组合**，两个方向都会被明确拦截。
+Git Release Tag 是唯一版本来源：发布 `v1.2.0` 时，镜像和两个 NPM 包均为
+`1.2.0`，SDK 在 Socket.IO 握手中也声明 `1.2.0`。应用代码不需要处理版本。
 
-开发环境不受影响：预发布版本号（如 `1.1.1-dev.3`）一律放行。
+只有一个兼容性断点：Server `1.1.1` 及以上要求
+`@blade-hq/agent-client` `1.1.1` 及以上；未声明 SDK 身份或版本的旧客户端也会被拒绝。
 
 ## 自己渲染消息
 
@@ -331,7 +353,6 @@ function Message({ message }: { message: ChatMessage }) {
 | login() 报"弹窗被拦截" | 浏览器设置里允许该站点弹窗，或改用 PAT |
 | login() 报 403 来源未允许 | 让管理员把你的页面 origin 加进后端 `BLADE_SDK_AUTH_ALLOWED_ORIGINS` |
 | socket 一直 connecting | 检查 baseUrl 是否可达、跨域时后端是否允许你的 origin |
-| VersionMismatchError | SDK 与 Server 版本不配套，按报错提示升级其中一端，见「版本握手」 |
 | onCommand 收不到指令 | 确认技能工具返回值里写了 `_meta.bridge`，action 拼写与注册一致 |
 
 更多接入教程（Vue 完整示例、GIS 协作闭环、AI 助手接入指南）见 [public-skills 文档站](https://github.com/blade-hq/public-skills)。
@@ -341,7 +362,9 @@ function Message({ message }: { message: ChatMessage }) {
 完整签名见 [public-api.md](./public-api.md)（由 `scripts/public-api-report.mjs` 生成并在 CI 校验）。
 
 - **客户端与登录**：`BladeClientOptions`、`LoginOptions`、`LoginResult`、`TokenStorageMode`、`UploadProgress`、`BladeApiError`、`AuthResource`、`ProvidersResponse`、`UserInfo`
-- **版本握手**：`ServerVersionInfo`、`SDK_NAME`、`SDK_VERSION`、`MIN_SERVER_VERSION`
+- **SDK 身份**：`SDK_NAME`、`SDK_VERSION`
+- **声明式会话**：`SessionDefinition`、`SolutionDefinition`、`SkillDefinition`、`SessionConfig`、`TextFile`、`SessionSetupError`、`SessionSetupStage`
+- **模型目录**：`ModelsResource`、`ModelCatalog`、`ModelOption`
 - **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`PaginatedSessionsResult`、`SessionHistory`、`SessionContextStats`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
 - **会话状态机**：`SessionHub`、`SessionState`、`SendOptions`、`ConnectionStatus`、`AskUserAnswerData`、`AgentLoopInfo`、`ActiveCompactionState`、`createInitialSessionState`、`AgentSessionEventName`
 - **页面协作**：`EmbeddedChat`、`EmbeddedChatOptions`、`CommandHandler`、`CommandEnvelope`、`InboundAction`、`InboundEnvelope`、`isCommandEnvelope`、`isInboundEnvelope`

package/dist/blade-client.d.ts

@@ -2,6 +2,7 @@ import { type LoginOptions, type LoginResult, type TokenStorageMode } from "./au
 import { type BladeFetchInit, type HttpMethod } from "./rest";
 import { AuthResource } from "./resources/auth";
 import { HeadlessResource } from "./resources/headless";
+import { ModelsResource } from "./resources/models";
 import { SessionsResource } from "./resources/sessions";
 import { SessionHub } from "./session/hub";
 import { type TypedSocket } from "./socket";
@@ -32,11 +33,10 @@ export declare class BladeClient {
     readonly options: BladeClientOptions;
     readonly auth: AuthResource;
     readonly headless: HeadlessResource;
+    readonly models: ModelsResource;
     readonly sessions: SessionsResource;
     /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */
     readonly hub: SessionHub;
-    /** 版本握手结果缓存：每个 client 实例只探测一次，不逐请求重复。 */
-    private versionCheck;
     constructor(options: BladeClientOptions);
     /**
      * 弹窗授权登录：用户在弹出的授权页点击"许可授权"后自动取得 PAT，
@@ -64,18 +64,6 @@ export declare class BladeClient {
      * 安全约束：该令牌只应发往 baseUrl 同源接口，不要附加到第三方域名的请求上。
      */
     get token(): string | null;
-    /**
-     * 版本握手：首次连接前查询 Server 版本，不匹配则抛 VersionMismatchError。
-     * 结果缓存在实例上，失败的探测不缓存以便重试。
-     */
-    ensureVersionCompatible(): Promise<void>;
-    /**
-     * 读取 /api/version。接口存在但 404/响应不合法 → null（按旧 Server 处理）；
-     * 网络层不可达（后端没启动、端口不通、代理配错）→ 抛连接错误。
-     * 两者必须区分：把「后端没起」误报成「版本不匹配，请改用 agent-kit」
-     * 会把开发者引向完全错误的排查方向。
-     */
-    private fetchServerVersion;
     setBaseUrl(baseUrl: string): void;
     /** 底层 Socket.IO 实例因后端地址变化而被替换时通知高级集成层。 */
     onSocketReplaced(listener: () => void): () => void;

package/dist/index.d.ts

@@ -2,12 +2,13 @@ export { BladeClient } from "./blade-client";
 export type { BladeClientOptions, UploadProgress } from "./blade-client";
 export { BladeApiError } from "./rest";
 export type { LoginOptions, LoginResult, TokenStorageMode } from "./auth-login";
-export { VersionMismatchError, SDK_NAME, SDK_VERSION, MIN_SERVER_VERSION } from "./version";
-export type { ServerVersionInfo } from "./version";
+export { SDK_NAME, SDK_VERSION } from "./version";
 export { AgentSession } from "./session/agent-session";
 export type { SendOptions } from "./session/agent-session";
 export { SessionHub } from "./session/hub";
 export type { AgentSessionEvents, AgentSessionEventName } from "./session/events";
+export { SessionSetupError } from "./session/definition";
+export type { SessionConfig, SessionDefinition, SessionSetupStage, SkillDefinition, TextFile, SolutionDefinition, } from "./session/definition";
 export { createInitialSessionState } from "./session/state";
 export type { AskUserAnswerData, AgentLoopInfo, ActiveCompactionState, ConnectionStatus, SessionState, } from "./session/state";
 export { connectEmbedded } from "./commands/embedded";
@@ -17,6 +18,8 @@ export type { CommandEnvelope, InboundAction, InboundEnvelope } from "./commands
 export { isCommandEnvelope, isInboundEnvelope } from "./commands/protocol";
 export type { AuthResource, ProvidersResponse, UserInfo } from "./resources/auth";
 export type { HeadlessResource } from "./resources/headless";
+export { ModelsResource } from "./resources/models";
+export type { ModelCatalog, ModelOption } from "./resources/models";
 export type { SessionsResource } from "./resources/sessions";
 export type { CreateSessionRequest, FileEntry, PaginatedSessionsResult, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
 export type { ArchivedFileInfo, ArchivedToolCallInfo, ChatMessage, CompactionInfo, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolBridgeContent, ToolCallInfo, } from "./schemas/message";

package/dist/index.js

@@ -380,6 +380,31 @@ function ensureSocketConnected(socket, timeoutMs, detail) {
   });
 }
 
+// src/resources/models.ts
+var ModelsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list() {
+    return this.client.json("GET", "/api/config/models");
+  }
+};
+
+// src/session/definition.ts
+var SessionSetupError = class extends Error {
+  constructor(message, stage, sessionId, options) {
+    super(message);
+    this.stage = stage;
+    this.sessionId = sessionId;
+    this.cause = options?.cause;
+  }
+  stage;
+  sessionId;
+  name = "SessionSetupError";
+  cause;
+};
+
 // src/shared/projection/helpers.ts
 function upsertToolCall(state, toolCallId, toolName, displayName, args) {
   if (!toolCallId) return;
@@ -447,7 +472,7 @@ function applyToolResult(state, toolCallId, result, status, durationMs, sourceLo
   }
   upsertToolResultBlock(state, toolCallId, finalResult, toolName, displayName);
 }
-function appendToolResultDelta(state, toolCallId, delta) {
+function appendToolResultDelta(state, toolCallId, delta, reset = false) {
   if (!toolCallId || !delta) return;
   let toolName = "";
   let displayName = "";
@@ -457,13 +482,13 @@ function appendToolResultDelta(state, toolCallId, delta) {
     if (tc.id !== toolCallId) continue;
     toolName = tc.tool_name;
     displayName = tc.display_name;
-    if (typeof tc.result === "string") currentResult = tc.result;
+    if (!reset && typeof tc.result === "string") currentResult = tc.result;
     state.toolCalls[i] = { ...tc, result: currentResult + delta };
     break;
   }
   for (const block of state.blocks) {
     if (block.type !== "tool_result" || block.tool_call_id !== toolCallId) continue;
-    if (typeof block.content === "string") currentResult = block.content;
+    if (!reset && typeof block.content === "string") currentResult = block.content;
     break;
   }
   upsertToolResultBlock(state, toolCallId, currentResult + delta, toolName, displayName);
@@ -1200,7 +1225,8 @@ var ClientProjectionBuilder = class {
   }
   onToolResultDone(state, loopId, payload) {
     const toolCallId = String(payload.tool_call_id ?? "");
-    const content = payload.content ?? "";
+    const streamedResult = state.toolCalls.find((toolCall) => toolCall.id === toolCallId)?.result;
+    const content = payload.content_from_deltas === true ? streamedResult ?? "" : payload.content ?? "";
     const status = toolStatusFromResult(content);
     const rawDuration = payload.duration_ms;
     const durationMs = typeof rawDuration === "number" && rawDuration >= 0 ? Math.round(rawDuration) : null;
@@ -1215,7 +1241,8 @@ var ClientProjectionBuilder = class {
     appendToolResultDelta(
       state,
       String(payload.tool_call_id ?? ""),
-      String(payload.content ?? "")
+      String(payload.content ?? ""),
+      payload.content_reset === true
     );
     return this.syncPatch(state);
   }
@@ -1736,10 +1763,94 @@ var SessionsResource = class {
   }
   /** 创建新会话并直接连接，返回可收发消息的 AgentSession。 */
   async create(request = {}) {
-    await this.client.ensureVersionCompatible();
+    if (isSessionDefinition(request)) {
+      return this.createDeclared(request);
+    }
     const { session_id } = await this.createSessionWithRequest(request);
     return this.connect(session_id);
   }
+  async createDeclared(definition) {
+    const { intent, solution, skills = [], config } = definition;
+    validateDefinition(definition);
+    let solutionRequest = {};
+    try {
+      solutionRequest = solution ? await this.prepareSolution(solution) : {};
+    } catch (error) {
+      throw setupError("solution", "Solution \u51C6\u5907\u5931\u8D25", error);
+    }
+    let session_id;
+    try {
+      const created = await this.createSessionWithRequest({
+        intent,
+        ...solutionRequest,
+        model: config?.model,
+        enable_thinking: config?.enableThinking,
+        memory_enabled: config?.memoryEnabled,
+        compaction_ratio: config?.compactionRatio,
+        env: config?.env,
+        disable_tools: config?.disableTools
+      });
+      session_id = created.session_id;
+    } catch (error) {
+      const assetId = solutionRequest.session_solution_asset_id;
+      const assetCleaned = await this.cleanupSolutionAsset(assetId);
+      const cleanupMessage = assetId ? assetCleaned ? "\uFF1B\u4E34\u65F6 Solution \u5DF2\u6E05\u7406" : `\uFF1B\u4E34\u65F6 Solution ${assetId} \u6E05\u7406\u5931\u8D25` : "";
+      throw setupError("session", `\u4F1A\u8BDD\u521B\u5EFA\u5931\u8D25${cleanupMessage}`, error);
+    }
+    let installingSkill = "";
+    try {
+      for (const skill of skills) {
+        installingSkill = skill.name;
+        await this.client.json("POST", `/api/sessions/${encodeURIComponent(session_id)}/skills:upload`, {
+          name: skill.name,
+          files: skill.files
+        });
+      }
+    } catch (error) {
+      const sessionCleaned = await this.deleteSession(session_id).then(
+        () => true,
+        () => false
+      );
+      const assetCleaned = await this.cleanupSolutionAsset(solutionRequest.session_solution_asset_id);
+      const cleanupMessage = sessionCleaned ? "\u672A\u5B8C\u6210\u7684\u4F1A\u8BDD\u5DF2\u6E05\u7406" : `\u8BF7\u624B\u52A8\u5220\u9664\u4F1A\u8BDD ${session_id}`;
+      const assetCleanupMessage = assetCleaned ? "" : "\uFF1B\u4E34\u65F6 Solution \u6E05\u7406\u5931\u8D25";
+      throw setupError(
+        "skill",
+        `Skill "${installingSkill}" \u5B89\u88C5\u5931\u8D25\uFF1B${cleanupMessage}${assetCleanupMessage}`,
+        error,
+        session_id
+      );
+    }
+    await this.cleanupSolutionAsset(solutionRequest.session_solution_asset_id);
+    try {
+      return await this.connect(session_id);
+    } catch (error) {
+      throw setupError("connection", `\u4F1A\u8BDD\u8FDE\u63A5\u5931\u8D25\uFF1B\u53EF\u4F7F\u7528 sessionId ${session_id} \u91CD\u8BD5`, error, session_id);
+    }
+  }
+  async prepareSolution(solution) {
+    if ("id" in solution) {
+      return { solution_id: solution.id, biz_role_id: solution.role ?? null };
+    }
+    const prepared = await this.client.json(
+      "POST",
+      "/api/session-assets/solutions",
+      { files: solution.files }
+    );
+    return {
+      session_solution_asset_id: prepared.asset_id,
+      biz_role_id: solution.role ?? null
+    };
+  }
+  async cleanupSolutionAsset(assetId) {
+    if (!assetId) return true;
+    try {
+      await this.client.json("DELETE", `/api/session-assets/solutions/${encodeURIComponent(assetId)}`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
   fetchSessionsPage({
     limit,
     offset,
@@ -1894,6 +2005,33 @@ var SessionsResource = class {
   listDir(sessionId, dirPath) {
     return this.client.json("GET", `/api/sessions/${sessionId}/ls/${encodeURIComponent(dirPath)}`);
   }
+  async countFiles(sessionId, dirPath = "") {
+    const entries = await this.listDir(sessionId, dirPath);
+    let count = 0;
+    for (const entry of entries) {
+      count += entry.is_dir ? await this.countFiles(sessionId, entry.path) : 1;
+    }
+    return count;
+  }
+  /** 在浏览器中下载一个会话文件。 */
+  async downloadFile(sessionId, filePath, downloadName) {
+    if (typeof document === "undefined") {
+      throw new Error("downloadFile \u53EA\u80FD\u5728\u6D4F\u89C8\u5668\u4E2D\u4F7F\u7528");
+    }
+    const response = await this.client.fetch(
+      "GET",
+      `/api/sessions/${encodeURIComponent(sessionId)}/files/${encodeURIComponent(filePath)}`
+    );
+    const objectUrl = URL.createObjectURL(await response.blob());
+    const anchor = document.createElement("a");
+    anchor.href = objectUrl;
+    anchor.download = downloadName || filePath.split("/").pop() || "download";
+    anchor.style.display = "none";
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    globalThis.setTimeout(() => URL.revokeObjectURL(objectUrl), 1e3);
+  }
   async uploadFiles(sessionId, dirPath, files, options = {}) {
     const formData = new FormData();
     const entries = Array.from(files).map(
@@ -1964,6 +2102,51 @@ var SessionsResource = class {
     return res.json();
   }
 };
+function isSessionDefinition(request) {
+  return "solution" in request || "skills" in request || "config" in request;
+}
+function validateDefinition(definition) {
+  if (definition.solution) {
+    if ("id" in definition.solution) {
+      if (!definition.solution.id.trim()) {
+        throw new SessionSetupError("Solution id \u4E0D\u80FD\u4E3A\u7A7A", "solution");
+      }
+    } else {
+      validateTextFiles(definition.solution.files, "solution", "Solution");
+      if (!definition.solution.files.some((file) => file.path === "solution.yaml")) {
+        throw new SessionSetupError("Solution \u7F3A\u5C11\u6839\u76EE\u5F55 solution.yaml", "solution");
+      }
+    }
+  }
+  for (const skill of definition.skills ?? []) validateSkill(skill);
+}
+function validateSkill(skill) {
+  if (!/^[a-z0-9-]+\/[a-z0-9-]+$/.test(skill.name)) {
+    throw new SessionSetupError(`Skill name "${skill.name}" \u5FC5\u987B\u662F\u5C0F\u5199\u7684 \u7EC4\u7EC7/\u540D\u79F0`, "skill");
+  }
+  validateTextFiles(skill.files, "skill", `Skill "${skill.name}"`);
+  if (!skill.files.some((file) => file.path === "SKILL.md")) {
+    throw new SessionSetupError(`Skill "${skill.name}" \u7F3A\u5C11\u6839\u76EE\u5F55 SKILL.md`, "skill");
+  }
+}
+function validateTextFiles(files, stage, label) {
+  if (files.length === 0) throw new SessionSetupError(`${label} files \u4E0D\u80FD\u4E3A\u7A7A`, stage);
+  const paths = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    const path = file.path;
+    if (!path || path !== path.trim() || path.startsWith("/") || path.includes("\\") || path.split("/").some((part) => !part || part === "." || part === "..") || /^[a-zA-Z]:/.test(path)) {
+      throw new SessionSetupError(`${label} \u6587\u4EF6\u8DEF\u5F84\u4E0D\u5B89\u5168\uFF1A"${path}"`, stage);
+    }
+    if (paths.has(path)) {
+      throw new SessionSetupError(`${label} \u6587\u4EF6\u8DEF\u5F84\u91CD\u590D\uFF1A"${path}"`, stage);
+    }
+    paths.add(path);
+  }
+}
+function setupError(stage, message, cause, sessionId) {
+  const detail = cause instanceof Error ? cause.message : String(cause);
+  return new SessionSetupError(`${message}\uFF1A${detail}`, stage, sessionId, { cause });
+}
 function profileToCreateSessionRequest(profile) {
   const solution = profile.solution;
   return {
@@ -2708,6 +2891,9 @@ var AgentSession = class _AgentSession {
         emitWithAck: async () => readonlyError(),
         ensureConnected: readonlyError,
         fetchTurns: async () => turns,
+        listDir: async () => readonlyError(),
+        countFiles: async () => readonlyError(),
+        downloadFile: async () => readonlyError(),
         onDispose: () => void 0
       },
       "connected"
@@ -2840,6 +3026,18 @@ var AgentSession = class _AgentSession {
   insertText(text) {
     this.emitter.emit("insertTextRequested", { text });
   }
+  /** 列出工作区的一层目录。 */
+  listDir(dirPath = "") {
+    return this.runtime.listDir(this.sessionId, dirPath);
+  }
+  /** 递归统计工作区文件数（不含目录）。 */
+  countFiles(dirPath = "") {
+    return this.runtime.countFiles(this.sessionId, dirPath);
+  }
+  /** 在浏览器中下载一个工作区文件。 */
+  downloadFile(filePath, downloadName) {
+    return this.runtime.downloadFile(this.sessionId, filePath, downloadName);
+  }
   /** 释放订阅与监听器。之后该实例不再接收任何事件。 */
   dispose() {
     if (this.disposed) return;
@@ -3287,7 +3485,6 @@ var SessionHub = class {
   }
   /** 取得（或复用）一个会话的 AgentSession，并完成历史加载 + 房间订阅。 */
   async connect(sessionId) {
-    await this.client.ensureVersionCompatible();
     const existing = this.sessions.get(sessionId);
     if (existing && !existing.isDisposed) {
       return this.bootstrapPending.get(sessionId) ?? existing;
@@ -3365,6 +3562,9 @@ var SessionHub = class {
       }),
       ensureConnected: () => this.ensureConnected(),
       fetchTurns: (sessionId) => this.client.sessions.getSessionTurns(sessionId),
+      listDir: (sessionId, dirPath) => this.client.sessions.listDir(sessionId, dirPath),
+      countFiles: (sessionId, dirPath) => this.client.sessions.countFiles(sessionId, dirPath),
+      downloadFile: (sessionId, filePath, downloadName) => this.client.sessions.downloadFile(sessionId, filePath, downloadName),
       onDispose: (session) => {
         if (this.sessions.get(session.sessionId) === session) {
           this.sessions.delete(session.sessionId);
@@ -3557,63 +3757,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = "2.0.0";
-var MIN_SERVER_VERSION = "1.1.1";
-var LEGACY_SDK = "@blade-hq/agent-kit@1.1.0";
-var VersionMismatchError = class extends Error {
-  serverVersion;
-  sdkVersion;
-  hint;
-  constructor(options) {
-    super(
-      `SDK \u4E0E Server \u7248\u672C\u4E0D\u5339\u914D\uFF08SDK ${SDK_NAME}@${SDK_VERSION}\uFF0CServer ${options.serverVersion ?? "\u7248\u672C\u672A\u77E5\uFF08\u4E0D\u652F\u6301 /api/version\uFF09"}\uFF09\uFF1A${options.hint}`
-    );
-    this.name = "VersionMismatchError";
-    this.serverVersion = options.serverVersion;
-    this.sdkVersion = SDK_VERSION;
-    this.hint = options.hint;
-  }
-};
-function parseCoreVersion(version) {
-  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
-  if (!match) return null;
-  return [Number(match[1]), Number(match[2]), Number(match[3])];
-}
-function isPrerelease(version) {
-  const trimmed = version.trim();
-  if (!parseCoreVersion(trimmed)) return true;
-  return /[-+]/.test(trimmed);
-}
-function compareVersions(a, b) {
-  const left = parseCoreVersion(a);
-  const right = parseCoreVersion(b);
-  if (!left || !right) return 0;
-  for (let i = 0; i < 3; i++) {
-    if (left[i] !== right[i]) return left[i] - right[i];
-  }
-  return 0;
-}
-function assertVersionCompatible(info) {
-  if (info === null) {
-    throw new VersionMismatchError({
-      serverVersion: null,
-      hint: `\u8BE5 Server \u4E0D\u63D0\u4F9B /api/version\uFF0C\u8BF4\u660E\u7248\u672C\u4F4E\u4E8E ${MIN_SERVER_VERSION}\u3002\u8BF7\u6539\u7528 ${LEGACY_SDK} \u63A5\u5165\uFF0C\u6216\u628A Server \u5347\u7EA7\u5230 ${MIN_SERVER_VERSION} \u53CA\u4EE5\u4E0A\u3002`
-    });
-  }
-  if (!isPrerelease(info.version) && compareVersions(info.version, MIN_SERVER_VERSION) < 0) {
-    throw new VersionMismatchError({
-      serverVersion: info.version,
-      hint: `\u672C SDK \u9700\u8981 Server ${MIN_SERVER_VERSION} \u53CA\u4EE5\u4E0A\u3002\u8BF7\u6539\u7528 ${LEGACY_SDK} \u63A5\u5165\u8BE5 Server\uFF0C\u6216\u628A Server \u5347\u7EA7\u5230 ${MIN_SERVER_VERSION} \u53CA\u4EE5\u4E0A\u3002`
-    });
-  }
-  const minSdk = info.min_sdk;
-  if (minSdk && !isPrerelease(SDK_VERSION) && compareVersions(SDK_VERSION, minSdk) < 0) {
-    throw new VersionMismatchError({
-      serverVersion: info.version,
-      hint: `\u8BE5 Server \u8981\u6C42 SDK ${minSdk} \u53CA\u4EE5\u4E0A\uFF0C\u8BF7\u628A ${SDK_NAME} \u5347\u7EA7\u5230 ${minSdk} \u53CA\u4EE5\u4E0A\u3002`
-    });
-  }
-}
+var SDK_VERSION = true ? "1.1.3" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -3641,11 +3785,10 @@ var BladeClient = class {
   options;
   auth;
   headless;
+  models;
   sessions;
   /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */
   hub;
-  /** 版本握手结果缓存：每个 client 实例只探测一次，不逐请求重复。 */
-  versionCheck = null;
   constructor(options) {
     this.options = {
       ...options,
@@ -3653,6 +3796,7 @@ var BladeClient = class {
     };
     this.auth = new AuthResource(this);
     this.headless = new HeadlessResource(this);
+    this.models = new ModelsResource(this);
     this.sessions = new SessionsResource(this);
     this.hub = new SessionHub(this);
     if (this.options.token === void 0) {
@@ -3711,43 +3855,6 @@ var BladeClient = class {
   get token() {
     return this.resolveRestToken();
   }
-  /**
-   * 版本握手：首次连接前查询 Server 版本，不匹配则抛 VersionMismatchError。
-   * 结果缓存在实例上，失败的探测不缓存以便重试。
-   */
-  async ensureVersionCompatible() {
-    if (!this.versionCheck) {
-      this.versionCheck = this.fetchServerVersion().then(assertVersionCompatible).catch((error) => {
-        this.versionCheck = null;
-        throw error;
-      });
-    }
-    return this.versionCheck;
-  }
-  /**
-   * 读取 /api/version。接口存在但 404/响应不合法 → null（按旧 Server 处理）；
-   * 网络层不可达（后端没启动、端口不通、代理配错）→ 抛连接错误。
-   * 两者必须区分：把「后端没起」误报成「版本不匹配，请改用 agent-kit」
-   * 会把开发者引向完全错误的排查方向。
-   */
-  async fetchServerVersion() {
-    let response;
-    try {
-      response = await this.fetch("GET", "/api/version", { expectOk: false });
-    } catch (error) {
-      throw new Error(
-        `\u65E0\u6CD5\u8FDE\u63A5\u5230 Server\uFF08${this.options.baseUrl || "\u5F53\u524D\u57DF\u540D"}\uFF09\u3002\u8BF7\u786E\u8BA4\u540E\u7AEF\u5DF2\u542F\u52A8\u3001\u5730\u5740\u4E0E\u7AEF\u53E3\u6B63\u786E\u3002`,
-        { cause: error }
-      );
-    }
-    if (!response.ok) return null;
-    try {
-      const info = await response.json();
-      return typeof info?.version === "string" ? info : null;
-    } catch {
-      return null;
-    }
-  }
   setBaseUrl(baseUrl) {
     const nextBaseUrl = normalizeBaseUrl(baseUrl);
     if (nextBaseUrl === this.options.baseUrl) {
@@ -3755,7 +3862,6 @@ var BladeClient = class {
     }
     this.hub.disposeAll();
     this.options.baseUrl = nextBaseUrl;
-    this.versionCheck = null;
     if (this.socketInstance) {
       this.socketInstance.removeAllListeners();
       this.socketInstance.disconnect();
@@ -4154,15 +4260,15 @@ export {
   BladeClient,
   ClientProjectionBuilder,
   LayoutType,
-  MIN_SERVER_VERSION,
+  ModelsResource,
   SDK_NAME,
   SDK_VERSION,
   SessionHub,
   SessionInfo,
+  SessionSetupError,
   SessionStatus,
   Task,
   TaskStatus,
-  VersionMismatchError,
   buildMessageContent,
   connectEmbedded,
   contentPreview,