@blade-hq/agent-client 1.1.1 → 1.1.2

package/dist/resources/models.d.ts

@@ -0,0 +1,15 @@
+import type { BladeClient } from "../blade-client";
+export interface ModelOption {
+    id: string;
+    label: string;
+}
+export interface ModelCatalog {
+    default: string;
+    models: ModelOption[];
+}
+/** Server 可供当前用户选择的模型目录。 */
+export declare class ModelsResource {
+    private client;
+    constructor(client: BladeClient);
+    list(): Promise<ModelCatalog>;
+}

package/dist/resources/sessions.d.ts

@@ -4,6 +4,7 @@ import type { SessionDetail, SessionInfo, TemplateId } from "../schemas/session"
 import type { Task } from "../schemas/task";
 import type { BladeClient, UploadProgress } from "../blade-client";
 import type { AgentSession } from "../session/agent-session";
+import { type SessionDefinition } from "../session/definition";
 import type { SessionProfile } from "../types/sdk-profile";
 export interface CreateSessionRequest {
     intent?: string;
@@ -143,7 +144,10 @@ export declare class SessionsResource {
      */
     connect(sessionId: string): Promise<AgentSession>;
     /** 创建新会话并直接连接，返回可收发消息的 AgentSession。 */
-    create(request?: CreateSessionRequest): Promise<AgentSession>;
+    create(request?: CreateSessionRequest | SessionDefinition): Promise<AgentSession>;
+    private createDeclared;
+    private prepareSolution;
+    private cleanupSolutionAsset;
     private fetchSessionsPage;
     listSessions(template_id_prefix?: string, solution_id?: string): Promise<SessionInfo[]>;
     listSessionsPaginated(params: {
@@ -236,6 +240,9 @@ export declare class SessionsResource {
         reachable: boolean;
     }>;
     listDir(sessionId: string, dirPath: string): Promise<FileEntry[]>;
+    countFiles(sessionId: string, dirPath?: string): Promise<number>;
+    /** 在浏览器中下载一个会话文件。 */
+    downloadFile(sessionId: string, filePath: string, downloadName?: string): Promise<void>;
     uploadFiles(sessionId: string, dirPath: string, files: FileList | File[] | UploadFileEntry[], options?: UploadFilesOptions): Promise<{
         uploaded: string[];
         failed: string[];

package/dist/session/agent-session.d.ts

@@ -4,6 +4,7 @@ import type { PatchEnvelope, TurnProjection } from "../schemas/projection";
 import type { SessionStatus } from "../schemas/session";
 import { type CommandHandler } from "../commands/registry";
 import { type AgentSessionEvents } from "./events";
+import type { FileEntry } from "../resources/sessions";
 import { type ConnectionStatus, type SessionState } from "./state";
 /** SessionHub 注入给 AgentSession 的运行时依赖（socket 收发 + REST 补数）。 */
 export interface SessionRuntime {
@@ -11,6 +12,9 @@ export interface SessionRuntime {
     emitWithAck(event: string, data: unknown, timeoutMs: number): Promise<Record<string, unknown> | undefined>;
     ensureConnected(): void;
     fetchTurns(sessionId: string): Promise<TurnProjection[]>;
+    listDir(sessionId: string, dirPath: string): Promise<FileEntry[]>;
+    countFiles(sessionId: string, dirPath?: string): Promise<number>;
+    downloadFile(sessionId: string, filePath: string, downloadName?: string): Promise<void>;
     onDispose(session: AgentSession): void;
 }
 export interface SendOptions {
@@ -95,6 +99,12 @@ export declare class AgentSession {
     attach(label: string, data: unknown): void;
     /** 往聊天输入框追加一段文字（不发送）。 */
     insertText(text: string): void;
+    /** 列出工作区的一层目录。 */
+    listDir(dirPath?: string): Promise<FileEntry[]>;
+    /** 递归统计工作区文件数（不含目录）。 */
+    countFiles(dirPath?: string): Promise<number>;
+    /** 在浏览器中下载一个工作区文件。 */
+    downloadFile(filePath: string, downloadName?: string): Promise<void>;
     /** 释放订阅与监听器。之后该实例不再接收任何事件。 */
     dispose(): void;
     get isDisposed(): boolean;

package/dist/session/definition.d.ts

@@ -0,0 +1,49 @@
+export type TextFile = {
+    path: string;
+    content: string;
+};
+export type SolutionDefinition = {
+    id: string;
+    role?: string;
+}
+/** 自定义 Solution：文本文件路径均相对于 Solution 根目录。 */
+ | {
+    files: TextFile[];
+    role?: string;
+};
+export interface SkillDefinition {
+    /** 会话内安装名，格式为 `组织/名称`。 */
+    name: string;
+    /** 必须包含根目录的 SKILL.md。 */
+    files: TextFile[];
+}
+export interface SessionConfig {
+    /** Server 模型目录中的 model ID。 */
+    model?: string;
+    enableThinking?: boolean;
+    memoryEnabled?: boolean;
+    compactionRatio?: number;
+    env?: Record<string, string>;
+    disableTools?: string[];
+}
+/**
+ * 声明一个待创建的会话。传给 `client.sessions.create(...)` 后，SDK 会先准备
+ * Solution，再创建会话并安装 Skill；Promise resolve 时会话已经可以使用。
+ */
+export interface SessionDefinition {
+    intent?: string;
+    solution?: SolutionDefinition;
+    skills?: SkillDefinition[];
+    config?: SessionConfig;
+}
+export type SessionSetupStage = "solution" | "session" | "skill" | "connection";
+/** 声明式会话准备失败；stage 和 sessionId 可直接用于界面提示或日志。 */
+export declare class SessionSetupError extends Error {
+    readonly stage: SessionSetupStage;
+    readonly sessionId?: string | undefined;
+    readonly name = "SessionSetupError";
+    readonly cause?: unknown;
+    constructor(message: string, stage: SessionSetupStage, sessionId?: string | undefined, options?: {
+        cause?: unknown;
+    });
+}

package/dist/shared/projection/helpers.d.ts

@@ -5,7 +5,7 @@ export declare function applyToolResult(state: TurnState, toolCallId: string, re
     loop_name: string;
     description: string;
 } | null): void;
-export declare function appendToolResultDelta(state: TurnState, toolCallId: string, delta: string): void;
+export declare function appendToolResultDelta(state: TurnState, toolCallId: string, delta: string, reset?: boolean): void;
 export declare function appendTextBlock(state: TurnState, blockType: ContentBlock["type"], content: unknown): void;
 export declare function appendToolCallArguments(state: TurnState, toolCallId: string, delta: string): void;
 export declare function buildSystemNotificationTurn(sequence: number, turnId: string, loopId: string, notificationType: string, status: string, title: string, detail: string | null, metadata: Record<string, unknown>): TurnProjection;

package/dist/types/rest.d.ts

@@ -63,9 +63,7 @@ export interface paths {
         };
         /**
          * Get Version
-         * @description SDK 建立连接前查询的版本接口（无需鉴权）。
-         *
-         *     SDK 用 `version` 判断该 Server 是否支持新协议，用 `min_sdk` 判断自身是否需要升级。
+         * @description 返回 Git Tag 注入的镜像版本与 1.1.1 SDK 断点（无需鉴权）。
          */
         get: operations["get_version_api_version_get"];
         put?: never;
@@ -1690,7 +1688,7 @@ export interface paths {
         put?: never;
         /**
          * Upload Solution Asset
-         * @description Upload a solution zip as a temporary session asset.
+         * @description Upload declarative UTF-8 solution files as a temporary session asset.
          */
         post: operations["upload_solution_asset_api_session_assets_solutions_post"];
         delete?: never;
@@ -1699,6 +1697,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/session-assets/solutions/{asset_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Solution Asset
+         * @description Release a temporary Solution asset owned by the current user.
+         */
+        delete: operations["delete_solution_asset_api_session_assets_solutions__asset_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sessions/{session_id}/browser/health": {
         parameters: {
             query?: never;
@@ -2983,6 +3001,106 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/deploy-to-os": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Deploy To Os */
+        post: operations["deploy_to_os_api_deploy_to_os_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/deploy-to-os/allocate-port": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Allocate Deploy Port
+         * @description 在 [start, end] 里挑一个当前真的能 bind 的宿主端口,给 deploy skill 生成
+         *     docker-compose.yaml 之前用——不用再靠 agent 自己瞎猜端口号、撞了再改。
+         *
+         *     这里跟老版 ``blade deploy`` CLI(``DeployManager``)复用同一份探测逻辑
+         *     ``_is_port_available``:真做 socket bind 测试,不是查数据库/内存记录。server
+         *     进程(box-ba)本身是 host 网络模式,直接坐在宿主机网络栈上——跟 blade-os 实际
+         *     发布容器端口时用的是同一台机器,这里测出来的结果才是准的(blade-os、
+         *     blade-agent、blade-hub 本来就部署在同一台机器上,不存在"测的是另一台机器"
+         *     这个问题)。
+         *
+         *     路由必须写在 ``/{session_id}`` 之前——不然 "allocate-port" 会被当成
+         *     session_id 吃掉。
+         */
+        get: operations["allocate_deploy_port_api_deploy_to_os_allocate_port_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/deploy-to-os/{session_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Deploy To Os */
+        get: operations["get_deploy_to_os_api_deploy_to_os__session_id__get"];
+        put?: never;
+        post?: never;
+        /** Delete Deploy To Os */
+        delete: operations["delete_deploy_to_os_api_deploy_to_os__session_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/deploy-to-os/{session_id}/logs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Deploy To Os Logs */
+        get: operations["get_deploy_to_os_logs_api_deploy_to_os__session_id__logs_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/deploy-to-os/{session_id}/{action}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Deploy To Os Action */
+        post: operations["deploy_to_os_action_api_deploy_to_os__session_id___action__post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/prod_solution": {
         parameters: {
             query?: never;
@@ -5081,11 +5199,6 @@ export interface components {
             /** File */
             file: string;
         };
-        /** Body_upload_solution_asset_api_session_assets_solutions_post */
-        Body_upload_solution_asset_api_session_assets_solutions_post: {
-            /** File */
-            file: string;
-        };
         /** BrowserCommand */
         BrowserCommand: {
             /** Session Id */
@@ -5427,6 +5540,24 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        /** DeleteSolutionResponse */
+        DeleteSolutionResponse: {
+            /** Deleted */
+            deleted: boolean;
+        };
+        /** DeployToOSRequest */
+        DeployToOSRequest: {
+            /** Session Id */
+            session_id: string;
+            /** App Name */
+            app_name: string;
+            /** App Dir */
+            app_dir?: string | null;
+            /** Working Dir */
+            working_dir?: string | null;
+            /** Title */
+            title?: string | null;
+        };
         /** EnsureFromRegistryRequest */
         EnsureFromRegistryRequest: {
             /** Registry Id */
@@ -6694,6 +6825,11 @@ export interface components {
             /** Cleared Memo */
             cleared_memo: number;
         };
+        /** UploadSolutionRequest */
+        UploadSolutionRequest: {
+            /** Files */
+            files: components["schemas"]["SessionSkillFile"][];
+        };
         /** UploadSolutionResponse */
         UploadSolutionResponse: {
             /** Asset Id */
@@ -9904,7 +10040,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "multipart/form-data": components["schemas"]["Body_upload_solution_asset_api_session_assets_solutions_post"];
+                "application/json": components["schemas"]["UploadSolutionRequest"];
             };
         };
         responses: {
@@ -9928,6 +10064,37 @@ export interface operations {
             };
         };
     };
+    delete_solution_asset_api_session_assets_solutions__asset_id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                asset_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeleteSolutionResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     browser_health_api_sessions__session_id__browser_health_get: {
         parameters: {
             query?: never;
@@ -12882,6 +13049,207 @@ export interface operations {
             };
         };
     };
+    deploy_to_os_api_deploy_to_os_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeployToOSRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    allocate_deploy_port_api_deploy_to_os_allocate_port_get: {
+        parameters: {
+            query?: {
+                start?: number;
+                end?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        [key: string]: number;
+                    };
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_deploy_to_os_api_deploy_to_os__session_id__get: {
+        parameters: {
+            query: {
+                app_name: string;
+            };
+            header?: never;
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_deploy_to_os_api_deploy_to_os__session_id__delete: {
+        parameters: {
+            query: {
+                app_name: string;
+            };
+            header?: never;
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_deploy_to_os_logs_api_deploy_to_os__session_id__logs_get: {
+        parameters: {
+            query: {
+                app_name: string;
+                tail?: number;
+            };
+            header?: never;
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    deploy_to_os_action_api_deploy_to_os__session_id___action__post: {
+        parameters: {
+            query: {
+                app_name: string;
+            };
+            header?: never;
+            path: {
+                session_id: string;
+                action: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_prod_solutions_api_prod_solution_get: {
         parameters: {
             query?: never;

package/dist/version.d.ts

@@ -1,45 +1,7 @@
+/** Socket.IO 握手使用的 SDK 身份。Server 只校验 1.1.1 这次破坏性变更。 */
 /**
- * SDK 与 Server 的版本握手。
- *
- * 本次 SDK 拆分是一次性破坏性升级：旧 agent-kit 与新 Server、新 SDK 与旧 Server
- * 都不能工作。握手的目的不是兼容，而是把「新旧组合失配」从难以理解的运行时异常
- * 变成一句明确的升级指引。
- *
- * 方向一（本文件）：SDK 在首次连接前查询 Server 版本，不匹配就拒绝连接。
- * 方向二（Server 侧）：Server 校验请求头 X-Blade-SDK，旧客户端收到结构化错误。
+ * 本 SDK 的 npm 包版本，随 Socket.IO 握手一并声明。
+ * Release 构建由 Git Tag 注入；本地开发回退到当前源码版本。
  */
-/** 本 SDK 的名称与版本，随请求头与 Socket.IO 握手一并声明。 */
 export declare const SDK_NAME = "agent-client";
-export declare const SDK_VERSION = "2.0.0";
-/** REST 请求与 Socket 握手中声明 SDK 身份的标头名。 */
-export declare const SDK_HEADER = "X-Blade-SDK";
-/** 新协议起始的 Server 版本；低于此版本的正式版 Server 只能配 agent-kit 1.1.0。 */
-export declare const MIN_SERVER_VERSION = "1.1.1";
-export interface ServerVersionInfo {
-    /** Server 自身版本号，如 "1.1.1"。 */
-    version: string;
-    /**
-     * Server 要求的最低 SDK 版本。未来再出现协议不兼容时，Server 抬高本字段即可，
-     * SDK 侧无需改判断逻辑——这是避免下一次破坏性升级再痛一遍的关键。
-     */
-    min_sdk?: string;
-}
-export declare class VersionMismatchError extends Error {
-    readonly serverVersion: string | null;
-    readonly sdkVersion: string;
-    readonly hint: string;
-    constructor(options: {
-        serverVersion: string | null;
-        hint: string;
-    });
-}
-/** 预发布/开发版（如 1.1.1-dev.3、0.0.0+local）不参与拦截，避免卡住开发环境。 */
-export declare function isPrerelease(version: string): boolean;
-/** a < b 返回负数，相等返回 0，a > b 返回正数。无法解析时返回 0。 */
-export declare function compareVersions(a: string, b: string): number;
-/**
- * 校验 Server 版本信息。不匹配抛 VersionMismatchError，匹配则正常返回。
- *
- * @param info Server /api/version 的响应；null 表示该接口不存在或不可达（旧 Server）。
- */
-export declare function assertVersionCompatible(info: ServerVersionInfo | null): void;
+export declare const SDK_VERSION: string;

package/node_modules/@ark/schema/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 ArkType
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/@ark/schema/README.md

@@ -0,0 +1,18 @@
+# @ark/schema
+
+Underlying schema language parsed from arktype syntax.
+
+The parts of ArkType's type system that exist in TS (i.e. not runtime-only constraints like bounds, divisors, custom predicates, morphs etc.) are structured like this:
+
+- Union: a set of intersections
+- Intersection: a set of a basis and constraints
+- Basis: this is the base type to which refinements like props are applied. It is one of three things, getting narrower as you move down the list:
+  - Domain: `"string" | "number" | "bigint" | "object" | "symbol"` parallels built-in TS keywords for non-enumerable value sets
+  - Proto: Must be an `instanceof` some class (implies domain `"object"`)
+  - Unit: Must `===` some value (can be intersected with any other constraint and reduced to itself or a disjoint)
+- Constraint: an individual condition that must be satisfied:
+  - Required: must have a specified literal string or symbol key and a value that conforms to a specified union or intersection
+  - Optional: Required conditions met or the specified key is not present
+  - Index: all keys that satisfy an index type must have values satisfying the corresponding value type
+
+In this system, `L` extends/subtypes/is assignable to `R` if and only if the intersection `L & R` is equal to `L`.