@lark-apaas/client-capability 0.0.1-alpha.0 → 0.0.1-alpha.1

package/README.md

@@ -14,18 +14,18 @@ npm install @lark-apaas/client-capability
 
 - 封装 `/api/capability/:id` HTTP 调用
 - 流式调用支持（SSE）
-- 运行时能力发现和验证
 - 统一的错误处理
+- 与服务端 API 一致的链式调用风格
 
 ## 快速开始
 
 ### 基础使用
 
 ```typescript
-import { client } from '@lark-apaas/client-capability';
+import { capabilityClient } from '@lark-apaas/client-capability';
 
-// 调用能力（自动初始化）
-const result = await client.call('create_feishu_group', 'run', {
+// 加载能力并调用
+const result = await capabilityClient.load('create_feishu_group').call('run', {
   group_name: '项目讨论群',
   members: ['user_001', 'user_002'],
 });
@@ -33,37 +33,20 @@ const result = await client.call('create_feishu_group', 'run', {
 console.log(result);
 ```
 
-### 手动初始化
-
-```typescript
-import { client } from '@lark-apaas/client-capability';
-
-// 手动初始化
-await client.init();
-
-// 检查能力是否存在
-if (client.hasCapability('create_feishu_group')) {
-  const result = await client.call('create_feishu_group', 'run', params);
-}
-```
+### 流式调用
 
-### 获取能力列表
+用于 LLM 对话等流式输出场景：
 
 ```typescript
-import { client } from '@lark-apaas/client-capability';
-
-await client.init();
+import { capabilityClient } from '@lark-apaas/client-capability';
 
-// 获取所有能力
-const capabilities = await client.listCapabilities();
-console.log(capabilities);
-// [
-//   { id: 'create_feishu_group', name: '创建飞书群', ... },
-//   { id: 'send_message', name: '发送消息', ... },
-// ]
+const stream = capabilityClient.load('ai_chat').callStream<{ content: string }>('chat', {
+  message: 'hello',
+});
 
-// 获取单个能力信息
-const info = await client.getCapability('create_feishu_group');
+for await (const chunk of stream) {
+  console.log(chunk.content);
+}
 ```
 
 ### 自定义配置
@@ -72,31 +55,28 @@ const info = await client.getCapability('create_feishu_group');
 import { createClient } from '@lark-apaas/client-capability';
 
 const client = createClient({
-  baseURL: 'https://api.example.com',
   fetchOptions: {
     credentials: 'include',
     headers: {
       'X-Custom-Header': 'value',
     },
   },
-  autoInit: false,
 });
 
-await client.init();
-const result = await client.call('xxx', 'run', params);
+const result = await client.load('xxx').call('run', params);
 ```
 
 ### 错误处理
 
 ```typescript
 import {
-  client,
+  capabilityClient,
   CapabilityNotFoundError,
   ExecutionError
 } from '@lark-apaas/client-capability';
 
 try {
-  const result = await client.call('create_feishu_group', 'run', params);
+  const result = await capabilityClient.load('create_feishu_group').call('run', params);
 } catch (error) {
   if (error instanceof CapabilityNotFoundError) {
     console.error('能力不存在:', error.message);
@@ -108,29 +88,13 @@ try {
 }
 ```
 
-### 流式调用
-
-用于 LLM 对话等流式输出场景：
+### 流式调用错误处理
 
 ```typescript
-import { client } from '@lark-apaas/client-capability';
-
-const stream = client.callStream<{ content: string }>('ai_chat', 'chat', {
-  message: 'hello',
-});
-
-for await (const chunk of stream) {
-  console.log(chunk.content);
-}
-```
-
-流式调用错误处理：
-
-```typescript
-import { client, NetworkError, ExecutionError } from '@lark-apaas/client-capability';
+import { capabilityClient, NetworkError, ExecutionError } from '@lark-apaas/client-capability';
 
 try {
-  const stream = client.callStream('ai_chat', 'chat', { message: 'hello' });
+  const stream = capabilityClient.load('ai_chat').callStream('chat', { message: 'hello' });
   for await (const chunk of stream) {
     process(chunk);
   }
@@ -149,34 +113,40 @@ try {
 
 ```typescript
 class CapabilityClient {
-  // 是否已初始化
-  readonly initialized: boolean;
+  /**
+   * 加载能力，返回执行器
+   * @param capabilityId - 能力 ID
+   * @returns 能力执行器
+   */
+  load(capabilityId: string): CapabilityExecutor;
+}
+```
 
-  // 初始化客户端，获取能力列表
-  init(): Promise<void>;
+### CapabilityExecutor
 
-  // 调用能力
+```typescript
+interface CapabilityExecutor {
+  /**
+   * 调用能力
+   * @param action - Action 名称
+   * @param params - 输入参数
+   * @returns Action 执行结果
+   */
   call<T = unknown>(
-    capabilityId: string,
     action: string,
     params?: Record<string, unknown>
   ): Promise<T>;
 
-  // 流式调用能力
+  /**
+   * 流式调用能力
+   * @param action - Action 名称
+   * @param params - 输入参数
+   * @returns AsyncIterable，逐个 yield chunk
+   */
   callStream<T = unknown>(
-    capabilityId: string,
     action: string,
     params?: Record<string, unknown>
   ): AsyncIterable<T>;
-
-  // 检查能力是否存在
-  hasCapability(capabilityId: string): boolean;
-
-  // 获取所有可用能力
-  listCapabilities(): Promise<CapabilityInfo[]>;
-
-  // 获取单个能力信息
-  getCapability(capabilityId: string): Promise<CapabilityInfo | null>;
 }
 ```
 
@@ -184,26 +154,8 @@ class CapabilityClient {
 
 ```typescript
 interface CapabilityClientOptions {
-  // API 基础路径，默认 ''（相对路径）
-  baseURL?: string;
-
-  // 自定义 fetch 配置
+  /** 自定义 fetch 配置 */
   fetchOptions?: RequestInit;
-
-  // 是否在创建时自动初始化，默认 true
-  autoInit?: boolean;
-}
-```
-
-### CapabilityInfo
-
-```typescript
-interface CapabilityInfo {
-  id: string;          // 能力 ID
-  name: string;        // 能力名称
-  description: string; // 能力描述
-  pluginID: string;    // 关联的插件 ID
-  pluginVersion: string; // 关联的插件版本
 }
 ```
 
@@ -212,7 +164,6 @@ interface CapabilityInfo {
 | 错误类型 | 错误码 | 描述 |
 |---------|--------|------|
 | `CapabilityError` | - | 错误基类 |
-| `ClientNotInitializedError` | CLIENT_NOT_INITIALIZED | 客户端未初始化 |
 | `CapabilityNotFoundError` | CAPABILITY_NOT_FOUND | 能力不存在 |
 | `ActionNotFoundError` | ACTION_NOT_FOUND | Action 不存在 |
 | `NetworkError` | NETWORK_ERROR | 网络错误 |
@@ -222,18 +173,17 @@ interface CapabilityInfo {
 
 ```typescript
 // 默认客户端实例
-export { client } from '@lark-apaas/client-capability';
+export { capabilityClient } from '@lark-apaas/client-capability';
 
 // 创建自定义客户端
 export { createClient, CapabilityClient } from '@lark-apaas/client-capability';
 
 // 类型
-export type { CapabilityClientOptions, CapabilityInfo } from '@lark-apaas/client-capability';
+export type { CapabilityClientOptions, CapabilityExecutor } from '@lark-apaas/client-capability';
 
 // 错误类型
 export {
   CapabilityError,
-  ClientNotInitializedError,
   CapabilityNotFoundError,
   ActionNotFoundError,
   NetworkError,
@@ -241,6 +191,20 @@ export {
 } from '@lark-apaas/client-capability';
 ```
 
+## 与服务端 API 对比
+
+客户端与服务端使用一致的链式调用风格：
+
+```typescript
+// 客户端
+import { capabilityClient } from '@lark-apaas/client-capability';
+const result = await capabilityClient.load('xxx').call('run', params);
+
+// 服务端
+import { CapabilityService } from '@lark-apaas/nestjs-capability';
+const result = await capabilityService.load('xxx').call('run', params);
+```
+
 ## 许可证
 
 MIT

package/dist/index.cjs

@@ -27,14 +27,23 @@ __export(index_exports, {
   CapabilityClient: () => CapabilityClient,
   CapabilityError: () => CapabilityError,
   CapabilityNotFoundError: () => CapabilityNotFoundError,
-  ClientNotInitializedError: () => ClientNotInitializedError,
   ExecutionError: () => ExecutionError,
   NetworkError: () => NetworkError,
-  client: () => client,
+  capabilityClient: () => capabilityClient,
   createClient: () => createClient
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/types.ts
+var ErrorCodes = {
+  SUCCESS: "0",
+  CAPABILITY_NOT_FOUND: "k_ec_cap_001",
+  PLUGIN_NOT_FOUND: "k_ec_cap_002",
+  ACTION_NOT_FOUND: "k_ec_cap_003",
+  PARAMS_VALIDATION_ERROR: "k_ec_cap_004",
+  EXECUTION_ERROR: "k_ec_cap_005"
+};
+
 // src/errors.ts
 var _CapabilityError = class _CapabilityError extends Error {
   constructor(message, code, statusCode) {
@@ -50,14 +59,6 @@ var _CapabilityError = class _CapabilityError extends Error {
 };
 __name(_CapabilityError, "CapabilityError");
 var CapabilityError = _CapabilityError;
-var _ClientNotInitializedError = class _ClientNotInitializedError extends CapabilityError {
-  constructor() {
-    super("Client not initialized. Call init() first or enable autoInit.", "CLIENT_NOT_INITIALIZED");
-    this.name = "ClientNotInitializedError";
-  }
-};
-__name(_ClientNotInitializedError, "ClientNotInitializedError");
-var ClientNotInitializedError = _ClientNotInitializedError;
 var _CapabilityNotFoundError = class _CapabilityNotFoundError extends CapabilityError {
   constructor(capabilityId, statusCode) {
     super(`Capability not found: ${capabilityId}`, "CAPABILITY_NOT_FOUND", statusCode);
@@ -92,103 +93,38 @@ __name(_ExecutionError, "ExecutionError");
 var ExecutionError = _ExecutionError;
 
 // src/client.ts
-var DEFAULT_OPTIONS = {
-  baseURL: "",
-  fetchOptions: {},
-  autoInit: true
-};
 var _CapabilityClient = class _CapabilityClient {
   constructor(options) {
     __publicField(this, "options");
-    __publicField(this, "capabilities", /* @__PURE__ */ new Map());
-    __publicField(this, "_initialized", false);
-    __publicField(this, "initPromise", null);
-    this.options = {
-      ...DEFAULT_OPTIONS,
-      ...options
-    };
-  }
-  /**
-  * 是否已初始化
-  */
-  get initialized() {
-    return this._initialized;
-  }
-  /**
-  * 初始化客户端，获取能力列表
-  */
-  async init() {
-    if (this._initialized) {
-      return;
-    }
-    if (this.initPromise) {
-      return this.initPromise;
-    }
-    this.initPromise = this.doInit();
-    try {
-      await this.initPromise;
-    } finally {
-      this.initPromise = null;
-    }
-  }
-  async doInit() {
-    const url = `${this.options.baseURL}/api/capability/list`;
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        ...this.options.fetchOptions,
-        headers: {
-          "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
-        }
-      });
-      if (!response.ok) {
-        throw new NetworkError(`Failed to fetch capabilities: ${response.status} ${response.statusText}`);
-      }
-      const data = await response.json();
-      if (data.code !== 0) {
-        throw new ExecutionError(data.message);
-      }
-      this.capabilities.clear();
-      for (const capability of data.data) {
-        this.capabilities.set(capability.id, capability);
-      }
-      this._initialized = true;
-    } catch (error) {
-      if (error instanceof CapabilityError) {
-        throw error;
-      }
-      throw new NetworkError(error instanceof Error ? error.message : String(error));
-    }
+    this.options = options ?? {};
   }
   /**
-  * 确保已初始化
-  */
-  async ensureInitialized() {
-    if (!this._initialized && this.options.autoInit) {
-      await this.init();
-    }
-  }
-  /**
-  * 调用能力
+  * 加载能力，返回执行器
   * @param capabilityId - 能力 ID
-  * @param action - Action 名称
-  * @param params - 输入参数
-  * @returns Action 执行结果
+  * @returns 能力执行器
   */
-  async call(capabilityId, action, params) {
-    await this.ensureInitialized();
-    if (this._initialized && !this.capabilities.has(capabilityId)) {
-      throw new CapabilityNotFoundError(capabilityId);
-    }
-    const url = `${this.options.baseURL}/api/capability/${capabilityId}`;
+  load(capabilityId) {
+    return this.createExecutor(capabilityId);
+  }
+  createExecutor(capabilityId) {
+    return {
+      call: /* @__PURE__ */ __name((action, params) => {
+        return this.executeCall(capabilityId, action, params);
+      }, "call"),
+      callStream: /* @__PURE__ */ __name((action, params) => {
+        return this.executeCallStream(capabilityId, action, params);
+      }, "callStream")
+    };
+  }
+  async executeCall(capabilityId, action, params) {
+    const url = `/api/capability/${capabilityId}`;
     try {
       const response = await fetch(url, {
         method: "POST",
         ...this.options.fetchOptions,
         headers: {
           "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
+          ...this.options.fetchOptions?.headers
         },
         body: JSON.stringify({
           action,
@@ -196,21 +132,21 @@ var _CapabilityClient = class _CapabilityClient {
         })
       });
       const data = await response.json();
-      if (!response.ok || data.code !== 0) {
+      if (!response.ok || data.status_code !== ErrorCodes.SUCCESS) {
         const errorResponse = data;
-        const errorCode = errorResponse.error ?? "UNKNOWN_ERROR";
+        const errorCode = errorResponse.status_code;
         switch (errorCode) {
-          case "CAPABILITY_NOT_FOUND":
+          case ErrorCodes.CAPABILITY_NOT_FOUND:
             throw new CapabilityNotFoundError(capabilityId, response.status);
-          case "ACTION_NOT_FOUND":
-            throw new ActionNotFoundError(errorResponse.message, response.status);
-          case "PLUGIN_NOT_FOUND":
-          case "EXECUTION_ERROR":
+          case ErrorCodes.ACTION_NOT_FOUND:
+            throw new ActionNotFoundError(errorResponse.error_msg, response.status);
+          case ErrorCodes.PLUGIN_NOT_FOUND:
+          case ErrorCodes.EXECUTION_ERROR:
           default:
-            throw new ExecutionError(errorResponse.message, response.status);
+            throw new ExecutionError(errorResponse.error_msg, response.status);
         }
       }
-      return data.data;
+      return data.data.output;
     } catch (error) {
       if (error instanceof CapabilityError) {
         throw error;
@@ -218,39 +154,8 @@ var _CapabilityClient = class _CapabilityClient {
       throw new NetworkError(error instanceof Error ? error.message : String(error));
     }
   }
-  /**
-  * 检查能力是否存在
-  */
-  hasCapability(capabilityId) {
-    return this.capabilities.has(capabilityId);
-  }
-  /**
-  * 获取所有可用能力
-  */
-  async listCapabilities() {
-    await this.ensureInitialized();
-    return Array.from(this.capabilities.values());
-  }
-  /**
-  * 获取单个能力信息
-  */
-  async getCapability(capabilityId) {
-    await this.ensureInitialized();
-    return this.capabilities.get(capabilityId) ?? null;
-  }
-  /**
-  * 流式调用能力
-  * @param capabilityId - 能力 ID
-  * @param action - Action 名称
-  * @param params - 输入参数
-  * @returns AsyncIterable，逐个 yield chunk
-  */
-  async *callStream(capabilityId, action, params) {
-    await this.ensureInitialized();
-    if (this._initialized && !this.capabilities.has(capabilityId)) {
-      throw new CapabilityNotFoundError(capabilityId);
-    }
-    const url = `${this.options.baseURL}/api/capability/${capabilityId}/stream`;
+  async *executeCallStream(capabilityId, action, params) {
+    const url = `/api/capability/${capabilityId}/stream`;
     let response;
     try {
       response = await fetch(url, {
@@ -258,7 +163,7 @@ var _CapabilityClient = class _CapabilityClient {
         ...this.options.fetchOptions,
         headers: {
           "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
+          ...this.options.fetchOptions?.headers
         },
         body: JSON.stringify({
           action,
@@ -289,23 +194,18 @@ var _CapabilityClient = class _CapabilityClient {
         for (const line of lines) {
           if (line.startsWith("data: ")) {
             const data = line.slice(6);
-            if (data === "[DONE]") {
-              return;
-            }
             try {
               const parsed = JSON.parse(data);
-              if (parsed.error) {
-                const errorCode = parsed.code ?? "EXECUTION_ERROR";
-                switch (errorCode) {
-                  case "CAPABILITY_NOT_FOUND":
-                    throw new CapabilityNotFoundError(capabilityId);
-                  case "ACTION_NOT_FOUND":
-                    throw new ActionNotFoundError(parsed.error);
-                  default:
-                    throw new ExecutionError(parsed.error);
+              if (parsed.status_code === ErrorCodes.SUCCESS && parsed.data) {
+                if (parsed.data.type === "content") {
+                  yield parsed.data.delta.content;
+                  if (parsed.data.finished) {
+                    return;
+                  }
+                } else if (parsed.data.type === "error") {
+                  throw new ExecutionError(parsed.data.error.message);
                 }
               }
-              yield parsed;
             } catch (parseError) {
               if (parseError instanceof CapabilityError) {
                 throw parseError;
@@ -330,5 +230,5 @@ function createClient(options) {
   return new CapabilityClient(options);
 }
 __name(createClient, "createClient");
-var client = new CapabilityClient();
+var capabilityClient = new CapabilityClient();
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["// 默认客户端实例\nexport { client, createClient, CapabilityClient } from './client';\n\n// 类型\nexport type { CapabilityClientOptions, CapabilityInfo } from './types';\n\n// 错误类型\nexport {\n  CapabilityError,\n  ClientNotInitializedError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n","/**\n * 能力调用错误基类\n */\nexport class CapabilityError extends Error {\n  /** 错误码 */\n  code: string;\n  /** HTTP 状态码 */\n  statusCode?: number;\n\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'CapabilityError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * 客户端未初始化错误\n */\nexport class ClientNotInitializedError extends CapabilityError {\n  constructor() {\n    super('Client not initialized. Call init() first or enable autoInit.', 'CLIENT_NOT_INITIALIZED');\n    this.name = 'ClientNotInitializedError';\n  }\n}\n\n/**\n * 能力不存在错误\n */\nexport class CapabilityNotFoundError extends CapabilityError {\n  constructor(capabilityId: string, statusCode?: number) {\n    super(`Capability not found: ${capabilityId}`, 'CAPABILITY_NOT_FOUND', statusCode);\n    this.name = 'CapabilityNotFoundError';\n  }\n}\n\n/**\n * Action 不存在错误\n */\nexport class ActionNotFoundError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'ACTION_NOT_FOUND', statusCode);\n    this.name = 'ActionNotFoundError';\n  }\n}\n\n/**\n * 网络错误\n */\nexport class NetworkError extends CapabilityError {\n  constructor(message: string) {\n    super(message, 'NETWORK_ERROR');\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 执行错误\n */\nexport class ExecutionError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'EXECUTION_ERROR', statusCode);\n    this.name = 'ExecutionError';\n  }\n}\n","import type { CapabilityClientOptions, CapabilityInfo, ApiResponse } from './types';\nimport {\n  CapabilityError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n\nconst DEFAULT_OPTIONS: Required<CapabilityClientOptions> = {\n  baseURL: '',\n  fetchOptions: {},\n  autoInit: true,\n};\n\n/**\n * 能力客户端\n */\nexport class CapabilityClient {\n  private options: Required<CapabilityClientOptions>;\n  private capabilities: Map<string, CapabilityInfo> = new Map();\n  private _initialized = false;\n  private initPromise: Promise<void> | null = null;\n\n  /**\n   * 是否已初始化\n   */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  constructor(options?: CapabilityClientOptions) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  /**\n   * 初始化客户端，获取能力列表\n   */\n  async init(): Promise<void> {\n    if (this._initialized) {\n      return;\n    }\n\n    // 防止并发初始化\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = this.doInit();\n    try {\n      await this.initPromise;\n    } finally {\n      this.initPromise = null;\n    }\n  }\n\n  private async doInit(): Promise<void> {\n    const url = `${this.options.baseURL}/api/capability/list`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n      });\n\n      if (!response.ok) {\n        throw new NetworkError(`Failed to fetch capabilities: ${response.status} ${response.statusText}`);\n      }\n\n      const data = (await response.json()) as ApiResponse<CapabilityInfo[]>;\n\n      if (data.code !== 0) {\n        throw new ExecutionError((data as { message: string }).message);\n      }\n\n      this.capabilities.clear();\n      for (const capability of (data as { data: CapabilityInfo[] }).data) {\n        this.capabilities.set(capability.id, capability);\n      }\n\n      this._initialized = true;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * 确保已初始化\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (!this._initialized && this.options.autoInit) {\n      await this.init();\n    }\n  }\n\n  /**\n   * 调用能力\n   * @param capabilityId - 能力 ID\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns Action 执行结果\n   */\n  async call<T = unknown>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    await this.ensureInitialized();\n\n    // 检查能力是否存在（如果已初始化）\n    if (this._initialized && !this.capabilities.has(capabilityId)) {\n      throw new CapabilityNotFoundError(capabilityId);\n    }\n\n    const url = `${this.options.baseURL}/api/capability/${capabilityId}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n\n      const data = (await response.json()) as ApiResponse<T>;\n\n      if (!response.ok || data.code !== 0) {\n        const errorResponse = data as { code: number; message: string; error?: string };\n        const errorCode = errorResponse.error ?? 'UNKNOWN_ERROR';\n\n        switch (errorCode) {\n          case 'CAPABILITY_NOT_FOUND':\n            throw new CapabilityNotFoundError(capabilityId, response.status);\n          case 'ACTION_NOT_FOUND':\n            throw new ActionNotFoundError(errorResponse.message, response.status);\n          case 'PLUGIN_NOT_FOUND':\n          case 'EXECUTION_ERROR':\n          default:\n            throw new ExecutionError(errorResponse.message, response.status);\n        }\n      }\n\n      return (data as { data: T }).data;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * 检查能力是否存在\n   */\n  hasCapability(capabilityId: string): boolean {\n    return this.capabilities.has(capabilityId);\n  }\n\n  /**\n   * 获取所有可用能力\n   */\n  async listCapabilities(): Promise<CapabilityInfo[]> {\n    await this.ensureInitialized();\n    return Array.from(this.capabilities.values());\n  }\n\n  /**\n   * 获取单个能力信息\n   */\n  async getCapability(capabilityId: string): Promise<CapabilityInfo | null> {\n    await this.ensureInitialized();\n    return this.capabilities.get(capabilityId) ?? null;\n  }\n\n  /**\n   * 流式调用能力\n   * @param capabilityId - 能力 ID\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns AsyncIterable，逐个 yield chunk\n   */\n  async *callStream<T = unknown>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T> {\n    await this.ensureInitialized();\n\n    // 检查能力是否存在（如果已初始化）\n    if (this._initialized && !this.capabilities.has(capabilityId)) {\n      throw new CapabilityNotFoundError(capabilityId);\n    }\n\n    const url = `${this.options.baseURL}/api/capability/${capabilityId}/stream`;\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n    } catch (error) {\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n\n    if (!response.ok) {\n      throw new NetworkError(`HTTP ${response.status} ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new NetworkError('Response body is null');\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            const data = line.slice(6);\n\n            // 流结束标记\n            if (data === '[DONE]') {\n              return;\n            }\n\n            try {\n              const parsed = JSON.parse(data) as { error?: string; code?: string } & T;\n\n              // 服务端错误\n              if (parsed.error) {\n                const errorCode = parsed.code ?? 'EXECUTION_ERROR';\n                switch (errorCode) {\n                  case 'CAPABILITY_NOT_FOUND':\n                    throw new CapabilityNotFoundError(capabilityId);\n                  case 'ACTION_NOT_FOUND':\n                    throw new ActionNotFoundError(parsed.error);\n                  default:\n                    throw new ExecutionError(parsed.error);\n                }\n              }\n\n              yield parsed as T;\n            } catch (parseError) {\n              // JSON 解析错误，跳过此行\n              if (parseError instanceof CapabilityError) {\n                throw parseError;\n              }\n              // 忽略非 JSON 行\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\n/**\n * 创建自定义客户端\n */\nexport function createClient(options?: CapabilityClientOptions): CapabilityClient {\n  return new CapabilityClient(options);\n}\n\n/**\n * 默认客户端实例\n */\nexport const client = new CapabilityClient();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;ACGO,IAAMA,mBAAN,MAAMA,yBAAwBC,MAAAA;EAMnC,YAAYC,SAAiBC,MAAcC,YAAqB;AAC9D,UAAMF,OAAAA;AALRC;;AAEAC;;AAIE,SAAKC,OAAO;AACZ,SAAKF,OAAOA;AACZ,SAAKC,aAAaA;EACpB;AACF;AAZqCH;AAA9B,IAAMD,kBAAN;AAiBA,IAAMM,6BAAN,MAAMA,mCAAkCN,gBAAAA;EAC7C,cAAc;AACZ,UAAM,iEAAiE,wBAAA;AACvE,SAAKK,OAAO;EACd;AACF;AAL+CL;AAAxC,IAAMM,4BAAN;AAUA,IAAMC,2BAAN,MAAMA,iCAAgCP,gBAAAA;EAC3C,YAAYQ,cAAsBJ,YAAqB;AACrD,UAAM,yBAAyBI,YAAAA,IAAgB,wBAAwBJ,UAAAA;AACvE,SAAKC,OAAO;EACd;AACF;AAL6CL;AAAtC,IAAMO,0BAAN;AAUA,IAAME,uBAAN,MAAMA,6BAA4BT,gBAAAA;EACvC,YAAYE,SAAiBE,YAAqB;AAChD,UAAMF,SAAS,oBAAoBE,UAAAA;AACnC,SAAKC,OAAO;EACd;AACF;AALyCL;AAAlC,IAAMS,sBAAN;AAUA,IAAMC,gBAAN,MAAMA,sBAAqBV,gBAAAA;EAChC,YAAYE,SAAiB;AAC3B,UAAMA,SAAS,eAAA;AACf,SAAKG,OAAO;EACd;AACF;AALkCL;AAA3B,IAAMU,eAAN;AAUA,IAAMC,kBAAN,MAAMA,wBAAuBX,gBAAAA;EAClC,YAAYE,SAAiBE,YAAqB;AAChD,UAAMF,SAAS,mBAAmBE,UAAAA;AAClC,SAAKC,OAAO;EACd;AACF;AALoCL;AAA7B,IAAMW,iBAAN;;;ACnDP,IAAMC,kBAAqD;EACzDC,SAAS;EACTC,cAAc,CAAC;EACfC,UAAU;AACZ;AAKO,IAAMC,oBAAN,MAAMA,kBAAAA;EAaX,YAAYC,SAAmC;AAZvCA;AACAC,wCAA4C,oBAAIC,IAAAA;AAChDC,wCAAe;AACfC,uCAAoC;AAU1C,SAAKJ,UAAU;MAAE,GAAGL;MAAiB,GAAGK;IAAQ;EAClD;;;;EANA,IAAIK,cAAuB;AACzB,WAAO,KAAKF;EACd;;;;EASA,MAAMG,OAAsB;AAC1B,QAAI,KAAKH,cAAc;AACrB;IACF;AAGA,QAAI,KAAKC,aAAa;AACpB,aAAO,KAAKA;IACd;AAEA,SAAKA,cAAc,KAAKG,OAAM;AAC9B,QAAI;AACF,YAAM,KAAKH;IACb,UAAA;AACE,WAAKA,cAAc;IACrB;EACF;EAEA,MAAcG,SAAwB;AACpC,UAAMC,MAAM,GAAG,KAAKR,QAAQJ,OAAO;AAEnC,QAAI;AACF,YAAMa,WAAW,MAAMC,MAAMF,KAAK;QAChCG,QAAQ;QACR,GAAG,KAAKX,QAAQH;QAChBe,SAAS;UACP,gBAAgB;UAChB,GAAG,KAAKZ,QAAQH,aAAae;QAC/B;MACF,CAAA;AAEA,UAAI,CAACH,SAASI,IAAI;AAChB,cAAM,IAAIC,aAAa,iCAAiCL,SAASM,MAAM,IAAIN,SAASO,UAAU,EAAE;MAClG;AAEA,YAAMC,OAAQ,MAAMR,SAASS,KAAI;AAEjC,UAAID,KAAKE,SAAS,GAAG;AACnB,cAAM,IAAIC,eAAgBH,KAA6BI,OAAO;MAChE;AAEA,WAAKpB,aAAaqB,MAAK;AACvB,iBAAWC,cAAeN,KAAoCA,MAAM;AAClE,aAAKhB,aAAauB,IAAID,WAAWE,IAAIF,UAAAA;MACvC;AAEA,WAAKpB,eAAe;IACtB,SAASuB,OAAO;AACd,UAAIA,iBAAiBC,iBAAiB;AACpC,cAAMD;MACR;AACA,YAAM,IAAIZ,aAAaY,iBAAiBE,QAAQF,MAAML,UAAUQ,OAAOH,KAAAA,CAAAA;IACzE;EACF;;;;EAKA,MAAcI,oBAAmC;AAC/C,QAAI,CAAC,KAAK3B,gBAAgB,KAAKH,QAAQF,UAAU;AAC/C,YAAM,KAAKQ,KAAI;IACjB;EACF;;;;;;;;EASA,MAAMyB,KACJC,cACAC,QACAC,QACY;AACZ,UAAM,KAAKJ,kBAAiB;AAG5B,QAAI,KAAK3B,gBAAgB,CAAC,KAAKF,aAAakC,IAAIH,YAAAA,GAAe;AAC7D,YAAM,IAAII,wBAAwBJ,YAAAA;IACpC;AAEA,UAAMxB,MAAM,GAAG,KAAKR,QAAQJ,OAAO,mBAAmBoC,YAAAA;AAEtD,QAAI;AACF,YAAMvB,WAAW,MAAMC,MAAMF,KAAK;QAChCG,QAAQ;QACR,GAAG,KAAKX,QAAQH;QAChBe,SAAS;UACP,gBAAgB;UAChB,GAAG,KAAKZ,QAAQH,aAAae;QAC/B;QACAyB,MAAMC,KAAKC,UAAU;UACnBN;UACAC,QAAQA,UAAU,CAAC;QACrB,CAAA;MACF,CAAA;AAEA,YAAMjB,OAAQ,MAAMR,SAASS,KAAI;AAEjC,UAAI,CAACT,SAASI,MAAMI,KAAKE,SAAS,GAAG;AACnC,cAAMqB,gBAAgBvB;AACtB,cAAMwB,YAAYD,cAAcd,SAAS;AAEzC,gBAAQe,WAAAA;UACN,KAAK;AACH,kBAAM,IAAIL,wBAAwBJ,cAAcvB,SAASM,MAAM;UACjE,KAAK;AACH,kBAAM,IAAI2B,oBAAoBF,cAAcnB,SAASZ,SAASM,MAAM;UACtE,KAAK;UACL,KAAK;UACL;AACE,kBAAM,IAAIK,eAAeoB,cAAcnB,SAASZ,SAASM,MAAM;QACnE;MACF;AAEA,aAAQE,KAAqBA;IAC/B,SAASS,OAAO;AACd,UAAIA,iBAAiBC,iBAAiB;AACpC,cAAMD;MACR;AACA,YAAM,IAAIZ,aAAaY,iBAAiBE,QAAQF,MAAML,UAAUQ,OAAOH,KAAAA,CAAAA;IACzE;EACF;;;;EAKAiB,cAAcX,cAA+B;AAC3C,WAAO,KAAK/B,aAAakC,IAAIH,YAAAA;EAC/B;;;;EAKA,MAAMY,mBAA8C;AAClD,UAAM,KAAKd,kBAAiB;AAC5B,WAAOe,MAAMC,KAAK,KAAK7C,aAAa8C,OAAM,CAAA;EAC5C;;;;EAKA,MAAMC,cAAchB,cAAsD;AACxE,UAAM,KAAKF,kBAAiB;AAC5B,WAAO,KAAK7B,aAAagD,IAAIjB,YAAAA,KAAiB;EAChD;;;;;;;;EASA,OAAOkB,WACLlB,cACAC,QACAC,QACkB;AAClB,UAAM,KAAKJ,kBAAiB;AAG5B,QAAI,KAAK3B,gBAAgB,CAAC,KAAKF,aAAakC,IAAIH,YAAAA,GAAe;AAC7D,YAAM,IAAII,wBAAwBJ,YAAAA;IACpC;AAEA,UAAMxB,MAAM,GAAG,KAAKR,QAAQJ,OAAO,mBAAmBoC,YAAAA;AAEtD,QAAIvB;AACJ,QAAI;AACFA,iBAAW,MAAMC,MAAMF,KAAK;QAC1BG,QAAQ;QACR,GAAG,KAAKX,QAAQH;QAChBe,SAAS;UACP,gBAAgB;UAChB,GAAG,KAAKZ,QAAQH,aAAae;QAC/B;QACAyB,MAAMC,KAAKC,UAAU;UACnBN;UACAC,QAAQA,UAAU,CAAC;QACrB,CAAA;MACF,CAAA;IACF,SAASR,OAAO;AACd,YAAM,IAAIZ,aAAaY,iBAAiBE,QAAQF,MAAML,UAAUQ,OAAOH,KAAAA,CAAAA;IACzE;AAEA,QAAI,CAACjB,SAASI,IAAI;AAChB,YAAM,IAAIC,aAAa,QAAQL,SAASM,MAAM,IAAIN,SAASO,UAAU,EAAE;IACzE;AAEA,QAAI,CAACP,SAAS4B,MAAM;AAClB,YAAM,IAAIvB,aAAa,uBAAA;IACzB;AAEA,UAAMqC,SAAS1C,SAAS4B,KAAKe,UAAS;AACtC,UAAMC,UAAU,IAAIC,YAAAA;AACpB,QAAIC,SAAS;AAEb,QAAI;AACF,aAAO,MAAM;AACX,cAAM,EAAEC,MAAMC,MAAK,IAAK,MAAMN,OAAOO,KAAI;AACzC,YAAIF,KAAM;AAEVD,kBAAUF,QAAQM,OAAOF,OAAO;UAAEG,QAAQ;QAAK,CAAA;AAC/C,cAAMC,QAAQN,OAAOO,MAAM,IAAA;AAC3BP,iBAASM,MAAME,IAAG,KAAM;AAExB,mBAAWC,QAAQH,OAAO;AACxB,cAAIG,KAAKC,WAAW,QAAA,GAAW;AAC7B,kBAAMhD,OAAO+C,KAAKE,MAAM,CAAA;AAGxB,gBAAIjD,SAAS,UAAU;AACrB;YACF;AAEA,gBAAI;AACF,oBAAMkD,SAAS7B,KAAK8B,MAAMnD,IAAAA;AAG1B,kBAAIkD,OAAOzC,OAAO;AAChB,sBAAMe,YAAY0B,OAAOhD,QAAQ;AACjC,wBAAQsB,WAAAA;kBACN,KAAK;AACH,0BAAM,IAAIL,wBAAwBJ,YAAAA;kBACpC,KAAK;AACH,0BAAM,IAAIU,oBAAoByB,OAAOzC,KAAK;kBAC5C;AACE,0BAAM,IAAIN,eAAe+C,OAAOzC,KAAK;gBACzC;cACF;AAEA,oBAAMyC;YACR,SAASE,YAAY;AAEnB,kBAAIA,sBAAsB1C,iBAAiB;AACzC,sBAAM0C;cACR;YAEF;UACF;QACF;MACF;IACF,SAAS3C,OAAO;AACd,UAAIA,iBAAiBC,iBAAiB;AACpC,cAAMD;MACR;AACA,YAAM,IAAIZ,aAAaY,iBAAiBE,QAAQF,MAAML,UAAUQ,OAAOH,KAAAA,CAAAA;IACzE,UAAA;AACEyB,aAAOmB,YAAW;IACpB;EACF;AACF;AAlRavE;AAAN,IAAMA,mBAAN;AAuRA,SAASwE,aAAavE,SAAiC;AAC5D,SAAO,IAAID,iBAAiBC,OAAAA;AAC9B;AAFgBuE;AAOT,IAAMC,SAAS,IAAIzE,iBAAAA;","names":["CapabilityError","Error","message","code","statusCode","name","ClientNotInitializedError","CapabilityNotFoundError","capabilityId","ActionNotFoundError","NetworkError","ExecutionError","DEFAULT_OPTIONS","baseURL","fetchOptions","autoInit","CapabilityClient","options","capabilities","Map","_initialized","initPromise","initialized","init","doInit","url","response","fetch","method","headers","ok","NetworkError","status","statusText","data","json","code","ExecutionError","message","clear","capability","set","id","error","CapabilityError","Error","String","ensureInitialized","call","capabilityId","action","params","has","CapabilityNotFoundError","body","JSON","stringify","errorResponse","errorCode","ActionNotFoundError","hasCapability","listCapabilities","Array","from","values","getCapability","get","callStream","reader","getReader","decoder","TextDecoder","buffer","done","value","read","decode","stream","lines","split","pop","line","startsWith","slice","parsed","parse","parseError","releaseLock","createClient","client"]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["// 默认客户端实例\nexport { capabilityClient, createClient, CapabilityClient } from './client';\n\n// 类型\nexport type { CapabilityClientOptions, CapabilityExecutor } from './types';\n\n// 错误类型\nexport {\n  CapabilityError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n","/**\n * 客户端配置选项\n */\nexport interface CapabilityClientOptions {\n  /** 自定义 fetch 配置 */\n  fetchOptions?: RequestInit;\n}\n\n/**\n * 能力执行器接口\n */\nexport interface CapabilityExecutor {\n  /**\n   * 调用能力\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns Action 执行结果\n   */\n  call<T = unknown>(\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T>;\n\n  /**\n   * 流式调用能力\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns AsyncIterable，逐个 yield chunk\n   */\n  callStream<T = unknown>(\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T>;\n}\n\n// ========== API 响应类型 ==========\n\n/**\n * 成功响应\n */\nexport interface SuccessResponse<T> {\n  status_code: '0';\n  data: T;\n}\n\n/**\n * 错误响应\n */\nexport interface ErrorResponse {\n  status_code: string;\n  error_msg: string;\n}\n\n/**\n * API 响应类型\n */\nexport type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;\n\n// ========== 具体响应 data 结构 ==========\n\n/**\n * 执行接口响应 data 结构\n */\nexport interface ExecuteResponseData {\n  output: unknown;\n}\n\n// ========== 流式响应结构 ==========\n\n/**\n * 流式内容响应\n */\nexport interface StreamContentResponse {\n  status_code: '0';\n  data: {\n    type: 'content';\n    delta: {\n      content: unknown;\n    };\n    finished?: boolean;\n  };\n}\n\n/**\n * 流式错误响应\n */\nexport interface StreamErrorResponse {\n  status_code: '0';\n  data: {\n    type: 'error';\n    error: {\n      code: number;\n      message: string;\n    };\n  };\n}\n\n/**\n * 流式响应类型\n */\nexport type StreamResponse = StreamContentResponse | StreamErrorResponse;\n\n// ========== 错误码 ==========\n\n/**\n * 后端错误码\n */\nexport const ErrorCodes = {\n  SUCCESS: '0',\n  CAPABILITY_NOT_FOUND: 'k_ec_cap_001',\n  PLUGIN_NOT_FOUND: 'k_ec_cap_002',\n  ACTION_NOT_FOUND: 'k_ec_cap_003',\n  PARAMS_VALIDATION_ERROR: 'k_ec_cap_004',\n  EXECUTION_ERROR: 'k_ec_cap_005',\n} as const;\n","/**\n * 能力调用错误基类\n */\nexport class CapabilityError extends Error {\n  /** 错误码 */\n  code: string;\n  /** HTTP 状态码 */\n  statusCode?: number;\n\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'CapabilityError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * 能力不存在错误\n */\nexport class CapabilityNotFoundError extends CapabilityError {\n  constructor(capabilityId: string, statusCode?: number) {\n    super(`Capability not found: ${capabilityId}`, 'CAPABILITY_NOT_FOUND', statusCode);\n    this.name = 'CapabilityNotFoundError';\n  }\n}\n\n/**\n * Action 不存在错误\n */\nexport class ActionNotFoundError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'ACTION_NOT_FOUND', statusCode);\n    this.name = 'ActionNotFoundError';\n  }\n}\n\n/**\n * 网络错误\n */\nexport class NetworkError extends CapabilityError {\n  constructor(message: string) {\n    super(message, 'NETWORK_ERROR');\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 执行错误\n */\nexport class ExecutionError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'EXECUTION_ERROR', statusCode);\n    this.name = 'ExecutionError';\n  }\n}\n","import type {\n  CapabilityClientOptions,\n  CapabilityExecutor,\n  ApiResponse,\n  ExecuteResponseData,\n  StreamResponse,\n} from './types';\nimport { ErrorCodes } from './types';\nimport {\n  CapabilityError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n\n/**\n * 能力客户端\n */\nexport class CapabilityClient {\n  private options: CapabilityClientOptions;\n\n  constructor(options?: CapabilityClientOptions) {\n    this.options = options ?? {};\n  }\n\n  /**\n   * 加载能力，返回执行器\n   * @param capabilityId - 能力 ID\n   * @returns 能力执行器\n   */\n  load(capabilityId: string): CapabilityExecutor {\n    return this.createExecutor(capabilityId);\n  }\n\n  private createExecutor(capabilityId: string): CapabilityExecutor {\n    return {\n      call: <T = unknown>(action: string, params?: Record<string, unknown>) => {\n        return this.executeCall<T>(capabilityId, action, params);\n      },\n      callStream: <T = unknown>(action: string, params?: Record<string, unknown>) => {\n        return this.executeCallStream<T>(capabilityId, action, params);\n      },\n    };\n  }\n\n  private async executeCall<T>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `/api/capability/${capabilityId}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions?.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n\n      const data = (await response.json()) as ApiResponse<ExecuteResponseData>;\n\n      if (!response.ok || data.status_code !== ErrorCodes.SUCCESS) {\n        const errorResponse = data as { status_code: string; error_msg: string };\n        const errorCode = errorResponse.status_code;\n\n        switch (errorCode) {\n          case ErrorCodes.CAPABILITY_NOT_FOUND:\n            throw new CapabilityNotFoundError(capabilityId, response.status);\n          case ErrorCodes.ACTION_NOT_FOUND:\n            throw new ActionNotFoundError(errorResponse.error_msg, response.status);\n          case ErrorCodes.PLUGIN_NOT_FOUND:\n          case ErrorCodes.EXECUTION_ERROR:\n          default:\n            throw new ExecutionError(errorResponse.error_msg, response.status);\n        }\n      }\n\n      return (data as { data: ExecuteResponseData }).data.output as T;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  private async *executeCallStream<T>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T> {\n    const url = `/api/capability/${capabilityId}/stream`;\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions?.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n    } catch (error) {\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n\n    if (!response.ok) {\n      throw new NetworkError(`HTTP ${response.status} ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new NetworkError('Response body is null');\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            const data = line.slice(6);\n\n            try {\n              const parsed = JSON.parse(data) as StreamResponse;\n\n              if (parsed.status_code === ErrorCodes.SUCCESS && parsed.data) {\n                if (parsed.data.type === 'content') {\n                  yield parsed.data.delta.content as T;\n\n                  if (parsed.data.finished) {\n                    return;\n                  }\n                } else if (parsed.data.type === 'error') {\n                  throw new ExecutionError(parsed.data.error.message);\n                }\n              }\n            } catch (parseError) {\n              if (parseError instanceof CapabilityError) {\n                throw parseError;\n              }\n              // 忽略非 JSON 行\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\n/**\n * 创建自定义客户端\n */\nexport function createClient(options?: CapabilityClientOptions): CapabilityClient {\n  return new CapabilityClient(options);\n}\n\n/**\n * 默认客户端实例\n */\nexport const capabilityClient = new CapabilityClient();\n"],"mappings":"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","names":["ErrorCodes","SUCCESS","CAPABILITY_NOT_FOUND","PLUGIN_NOT_FOUND","ACTION_NOT_FOUND","PARAMS_VALIDATION_ERROR","EXECUTION_ERROR","CapabilityError","Error","message","code","statusCode","name","CapabilityNotFoundError","capabilityId","ActionNotFoundError","NetworkError","ExecutionError","CapabilityClient","options","load","capabilityId","createExecutor","call","action","params","executeCall","callStream","executeCallStream","url","response","fetch","method","fetchOptions","headers","body","JSON","stringify","data","json","ok","status_code","ErrorCodes","SUCCESS","errorResponse","errorCode","CAPABILITY_NOT_FOUND","CapabilityNotFoundError","status","ACTION_NOT_FOUND","ActionNotFoundError","error_msg","PLUGIN_NOT_FOUND","EXECUTION_ERROR","ExecutionError","output","error","CapabilityError","NetworkError","Error","message","String","statusText","reader","getReader","decoder","TextDecoder","buffer","done","value","read","decode","stream","lines","split","pop","line","startsWith","slice","parsed","parse","type","delta","content","finished","parseError","releaseLock","createClient","capabilityClient"]}

package/dist/index.d.cts

@@ -2,74 +2,44 @@
  * 客户端配置选项
  */
 interface CapabilityClientOptions {
-    /** API 基础路径，默认 '' （相对路径） */
-    baseURL?: string;
     /** 自定义 fetch 配置 */
     fetchOptions?: RequestInit;
-    /** 是否在创建时自动初始化，默认 true */
-    autoInit?: boolean;
 }
 /**
- * 能力信息
+ * 能力执行器接口
  */
-interface CapabilityInfo {
-    id: string;
-    name: string;
-    description: string;
-    pluginID: string;
-    pluginVersion: string;
-}
-
-/**
- * 能力客户端
- */
-declare class CapabilityClient {
-    private options;
-    private capabilities;
-    private _initialized;
-    private initPromise;
-    /**
-     * 是否已初始化
-     */
-    get initialized(): boolean;
-    constructor(options?: CapabilityClientOptions);
-    /**
-     * 初始化客户端，获取能力列表
-     */
-    init(): Promise<void>;
-    private doInit;
-    /**
-     * 确保已初始化
-     */
-    private ensureInitialized;
+interface CapabilityExecutor {
     /**
      * 调用能力
-     * @param capabilityId - 能力 ID
      * @param action - Action 名称
      * @param params - 输入参数
      * @returns Action 执行结果
      */
-    call<T = unknown>(capabilityId: string, action: string, params?: Record<string, unknown>): Promise<T>;
-    /**
-     * 检查能力是否存在
-     */
-    hasCapability(capabilityId: string): boolean;
-    /**
-     * 获取所有可用能力
-     */
-    listCapabilities(): Promise<CapabilityInfo[]>;
-    /**
-     * 获取单个能力信息
-     */
-    getCapability(capabilityId: string): Promise<CapabilityInfo | null>;
+    call<T = unknown>(action: string, params?: Record<string, unknown>): Promise<T>;
     /**
      * 流式调用能力
-     * @param capabilityId - 能力 ID
      * @param action - Action 名称
      * @param params - 输入参数
      * @returns AsyncIterable，逐个 yield chunk
      */
-    callStream<T = unknown>(capabilityId: string, action: string, params?: Record<string, unknown>): AsyncIterable<T>;
+    callStream<T = unknown>(action: string, params?: Record<string, unknown>): AsyncIterable<T>;
+}
+
+/**
+ * 能力客户端
+ */
+declare class CapabilityClient {
+    private options;
+    constructor(options?: CapabilityClientOptions);
+    /**
+     * 加载能力，返回执行器
+     * @param capabilityId - 能力 ID
+     * @returns 能力执行器
+     */
+    load(capabilityId: string): CapabilityExecutor;
+    private createExecutor;
+    private executeCall;
+    private executeCallStream;
 }
 /**
  * 创建自定义客户端
@@ -78,7 +48,7 @@ declare function createClient(options?: CapabilityClientOptions): CapabilityClie
 /**
  * 默认客户端实例
  */
-declare const client: CapabilityClient;
+declare const capabilityClient: CapabilityClient;
 
 /**
  * 能力调用错误基类
@@ -90,12 +60,6 @@ declare class CapabilityError extends Error {
     statusCode?: number;
     constructor(message: string, code: string, statusCode?: number);
 }
-/**
- * 客户端未初始化错误
- */
-declare class ClientNotInitializedError extends CapabilityError {
-    constructor();
-}
 /**
  * 能力不存在错误
  */
@@ -121,4 +85,4 @@ declare class ExecutionError extends CapabilityError {
     constructor(message: string, statusCode?: number);
 }
 
-export { ActionNotFoundError, CapabilityClient, type CapabilityClientOptions, CapabilityError, type CapabilityInfo, CapabilityNotFoundError, ClientNotInitializedError, ExecutionError, NetworkError, client, createClient };
+export { ActionNotFoundError, CapabilityClient, type CapabilityClientOptions, CapabilityError, type CapabilityExecutor, CapabilityNotFoundError, ExecutionError, NetworkError, capabilityClient, createClient };

package/dist/index.d.ts

@@ -2,74 +2,44 @@
  * 客户端配置选项
  */
 interface CapabilityClientOptions {
-    /** API 基础路径，默认 '' （相对路径） */
-    baseURL?: string;
     /** 自定义 fetch 配置 */
     fetchOptions?: RequestInit;
-    /** 是否在创建时自动初始化，默认 true */
-    autoInit?: boolean;
 }
 /**
- * 能力信息
+ * 能力执行器接口
  */
-interface CapabilityInfo {
-    id: string;
-    name: string;
-    description: string;
-    pluginID: string;
-    pluginVersion: string;
-}
-
-/**
- * 能力客户端
- */
-declare class CapabilityClient {
-    private options;
-    private capabilities;
-    private _initialized;
-    private initPromise;
-    /**
-     * 是否已初始化
-     */
-    get initialized(): boolean;
-    constructor(options?: CapabilityClientOptions);
-    /**
-     * 初始化客户端，获取能力列表
-     */
-    init(): Promise<void>;
-    private doInit;
-    /**
-     * 确保已初始化
-     */
-    private ensureInitialized;
+interface CapabilityExecutor {
     /**
      * 调用能力
-     * @param capabilityId - 能力 ID
      * @param action - Action 名称
      * @param params - 输入参数
      * @returns Action 执行结果
      */
-    call<T = unknown>(capabilityId: string, action: string, params?: Record<string, unknown>): Promise<T>;
-    /**
-     * 检查能力是否存在
-     */
-    hasCapability(capabilityId: string): boolean;
-    /**
-     * 获取所有可用能力
-     */
-    listCapabilities(): Promise<CapabilityInfo[]>;
-    /**
-     * 获取单个能力信息
-     */
-    getCapability(capabilityId: string): Promise<CapabilityInfo | null>;
+    call<T = unknown>(action: string, params?: Record<string, unknown>): Promise<T>;
     /**
      * 流式调用能力
-     * @param capabilityId - 能力 ID
      * @param action - Action 名称
      * @param params - 输入参数
      * @returns AsyncIterable，逐个 yield chunk
      */
-    callStream<T = unknown>(capabilityId: string, action: string, params?: Record<string, unknown>): AsyncIterable<T>;
+    callStream<T = unknown>(action: string, params?: Record<string, unknown>): AsyncIterable<T>;
+}
+
+/**
+ * 能力客户端
+ */
+declare class CapabilityClient {
+    private options;
+    constructor(options?: CapabilityClientOptions);
+    /**
+     * 加载能力，返回执行器
+     * @param capabilityId - 能力 ID
+     * @returns 能力执行器
+     */
+    load(capabilityId: string): CapabilityExecutor;
+    private createExecutor;
+    private executeCall;
+    private executeCallStream;
 }
 /**
  * 创建自定义客户端
@@ -78,7 +48,7 @@ declare function createClient(options?: CapabilityClientOptions): CapabilityClie
 /**
  * 默认客户端实例
  */
-declare const client: CapabilityClient;
+declare const capabilityClient: CapabilityClient;
 
 /**
  * 能力调用错误基类
@@ -90,12 +60,6 @@ declare class CapabilityError extends Error {
     statusCode?: number;
     constructor(message: string, code: string, statusCode?: number);
 }
-/**
- * 客户端未初始化错误
- */
-declare class ClientNotInitializedError extends CapabilityError {
-    constructor();
-}
 /**
  * 能力不存在错误
  */
@@ -121,4 +85,4 @@ declare class ExecutionError extends CapabilityError {
     constructor(message: string, statusCode?: number);
 }
 
-export { ActionNotFoundError, CapabilityClient, type CapabilityClientOptions, CapabilityError, type CapabilityInfo, CapabilityNotFoundError, ClientNotInitializedError, ExecutionError, NetworkError, client, createClient };
+export { ActionNotFoundError, CapabilityClient, type CapabilityClientOptions, CapabilityError, type CapabilityExecutor, CapabilityNotFoundError, ExecutionError, NetworkError, capabilityClient, createClient };

package/dist/index.js

@@ -3,6 +3,16 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// src/types.ts
+var ErrorCodes = {
+  SUCCESS: "0",
+  CAPABILITY_NOT_FOUND: "k_ec_cap_001",
+  PLUGIN_NOT_FOUND: "k_ec_cap_002",
+  ACTION_NOT_FOUND: "k_ec_cap_003",
+  PARAMS_VALIDATION_ERROR: "k_ec_cap_004",
+  EXECUTION_ERROR: "k_ec_cap_005"
+};
+
 // src/errors.ts
 var _CapabilityError = class _CapabilityError extends Error {
   constructor(message, code, statusCode) {
@@ -18,14 +28,6 @@ var _CapabilityError = class _CapabilityError extends Error {
 };
 __name(_CapabilityError, "CapabilityError");
 var CapabilityError = _CapabilityError;
-var _ClientNotInitializedError = class _ClientNotInitializedError extends CapabilityError {
-  constructor() {
-    super("Client not initialized. Call init() first or enable autoInit.", "CLIENT_NOT_INITIALIZED");
-    this.name = "ClientNotInitializedError";
-  }
-};
-__name(_ClientNotInitializedError, "ClientNotInitializedError");
-var ClientNotInitializedError = _ClientNotInitializedError;
 var _CapabilityNotFoundError = class _CapabilityNotFoundError extends CapabilityError {
   constructor(capabilityId, statusCode) {
     super(`Capability not found: ${capabilityId}`, "CAPABILITY_NOT_FOUND", statusCode);
@@ -60,103 +62,38 @@ __name(_ExecutionError, "ExecutionError");
 var ExecutionError = _ExecutionError;
 
 // src/client.ts
-var DEFAULT_OPTIONS = {
-  baseURL: "",
-  fetchOptions: {},
-  autoInit: true
-};
 var _CapabilityClient = class _CapabilityClient {
   constructor(options) {
     __publicField(this, "options");
-    __publicField(this, "capabilities", /* @__PURE__ */ new Map());
-    __publicField(this, "_initialized", false);
-    __publicField(this, "initPromise", null);
-    this.options = {
-      ...DEFAULT_OPTIONS,
-      ...options
-    };
-  }
-  /**
-  * 是否已初始化
-  */
-  get initialized() {
-    return this._initialized;
-  }
-  /**
-  * 初始化客户端，获取能力列表
-  */
-  async init() {
-    if (this._initialized) {
-      return;
-    }
-    if (this.initPromise) {
-      return this.initPromise;
-    }
-    this.initPromise = this.doInit();
-    try {
-      await this.initPromise;
-    } finally {
-      this.initPromise = null;
-    }
-  }
-  async doInit() {
-    const url = `${this.options.baseURL}/api/capability/list`;
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        ...this.options.fetchOptions,
-        headers: {
-          "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
-        }
-      });
-      if (!response.ok) {
-        throw new NetworkError(`Failed to fetch capabilities: ${response.status} ${response.statusText}`);
-      }
-      const data = await response.json();
-      if (data.code !== 0) {
-        throw new ExecutionError(data.message);
-      }
-      this.capabilities.clear();
-      for (const capability of data.data) {
-        this.capabilities.set(capability.id, capability);
-      }
-      this._initialized = true;
-    } catch (error) {
-      if (error instanceof CapabilityError) {
-        throw error;
-      }
-      throw new NetworkError(error instanceof Error ? error.message : String(error));
-    }
+    this.options = options ?? {};
   }
   /**
-  * 确保已初始化
-  */
-  async ensureInitialized() {
-    if (!this._initialized && this.options.autoInit) {
-      await this.init();
-    }
-  }
-  /**
-  * 调用能力
+  * 加载能力，返回执行器
   * @param capabilityId - 能力 ID
-  * @param action - Action 名称
-  * @param params - 输入参数
-  * @returns Action 执行结果
+  * @returns 能力执行器
   */
-  async call(capabilityId, action, params) {
-    await this.ensureInitialized();
-    if (this._initialized && !this.capabilities.has(capabilityId)) {
-      throw new CapabilityNotFoundError(capabilityId);
-    }
-    const url = `${this.options.baseURL}/api/capability/${capabilityId}`;
+  load(capabilityId) {
+    return this.createExecutor(capabilityId);
+  }
+  createExecutor(capabilityId) {
+    return {
+      call: /* @__PURE__ */ __name((action, params) => {
+        return this.executeCall(capabilityId, action, params);
+      }, "call"),
+      callStream: /* @__PURE__ */ __name((action, params) => {
+        return this.executeCallStream(capabilityId, action, params);
+      }, "callStream")
+    };
+  }
+  async executeCall(capabilityId, action, params) {
+    const url = `/api/capability/${capabilityId}`;
     try {
       const response = await fetch(url, {
         method: "POST",
         ...this.options.fetchOptions,
         headers: {
           "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
+          ...this.options.fetchOptions?.headers
         },
         body: JSON.stringify({
           action,
@@ -164,21 +101,21 @@ var _CapabilityClient = class _CapabilityClient {
         })
       });
       const data = await response.json();
-      if (!response.ok || data.code !== 0) {
+      if (!response.ok || data.status_code !== ErrorCodes.SUCCESS) {
         const errorResponse = data;
-        const errorCode = errorResponse.error ?? "UNKNOWN_ERROR";
+        const errorCode = errorResponse.status_code;
         switch (errorCode) {
-          case "CAPABILITY_NOT_FOUND":
+          case ErrorCodes.CAPABILITY_NOT_FOUND:
             throw new CapabilityNotFoundError(capabilityId, response.status);
-          case "ACTION_NOT_FOUND":
-            throw new ActionNotFoundError(errorResponse.message, response.status);
-          case "PLUGIN_NOT_FOUND":
-          case "EXECUTION_ERROR":
+          case ErrorCodes.ACTION_NOT_FOUND:
+            throw new ActionNotFoundError(errorResponse.error_msg, response.status);
+          case ErrorCodes.PLUGIN_NOT_FOUND:
+          case ErrorCodes.EXECUTION_ERROR:
           default:
-            throw new ExecutionError(errorResponse.message, response.status);
+            throw new ExecutionError(errorResponse.error_msg, response.status);
         }
       }
-      return data.data;
+      return data.data.output;
     } catch (error) {
       if (error instanceof CapabilityError) {
         throw error;
@@ -186,39 +123,8 @@ var _CapabilityClient = class _CapabilityClient {
       throw new NetworkError(error instanceof Error ? error.message : String(error));
     }
   }
-  /**
-  * 检查能力是否存在
-  */
-  hasCapability(capabilityId) {
-    return this.capabilities.has(capabilityId);
-  }
-  /**
-  * 获取所有可用能力
-  */
-  async listCapabilities() {
-    await this.ensureInitialized();
-    return Array.from(this.capabilities.values());
-  }
-  /**
-  * 获取单个能力信息
-  */
-  async getCapability(capabilityId) {
-    await this.ensureInitialized();
-    return this.capabilities.get(capabilityId) ?? null;
-  }
-  /**
-  * 流式调用能力
-  * @param capabilityId - 能力 ID
-  * @param action - Action 名称
-  * @param params - 输入参数
-  * @returns AsyncIterable，逐个 yield chunk
-  */
-  async *callStream(capabilityId, action, params) {
-    await this.ensureInitialized();
-    if (this._initialized && !this.capabilities.has(capabilityId)) {
-      throw new CapabilityNotFoundError(capabilityId);
-    }
-    const url = `${this.options.baseURL}/api/capability/${capabilityId}/stream`;
+  async *executeCallStream(capabilityId, action, params) {
+    const url = `/api/capability/${capabilityId}/stream`;
     let response;
     try {
       response = await fetch(url, {
@@ -226,7 +132,7 @@ var _CapabilityClient = class _CapabilityClient {
         ...this.options.fetchOptions,
         headers: {
           "Content-Type": "application/json",
-          ...this.options.fetchOptions.headers
+          ...this.options.fetchOptions?.headers
         },
         body: JSON.stringify({
           action,
@@ -257,23 +163,18 @@ var _CapabilityClient = class _CapabilityClient {
         for (const line of lines) {
           if (line.startsWith("data: ")) {
             const data = line.slice(6);
-            if (data === "[DONE]") {
-              return;
-            }
             try {
               const parsed = JSON.parse(data);
-              if (parsed.error) {
-                const errorCode = parsed.code ?? "EXECUTION_ERROR";
-                switch (errorCode) {
-                  case "CAPABILITY_NOT_FOUND":
-                    throw new CapabilityNotFoundError(capabilityId);
-                  case "ACTION_NOT_FOUND":
-                    throw new ActionNotFoundError(parsed.error);
-                  default:
-                    throw new ExecutionError(parsed.error);
+              if (parsed.status_code === ErrorCodes.SUCCESS && parsed.data) {
+                if (parsed.data.type === "content") {
+                  yield parsed.data.delta.content;
+                  if (parsed.data.finished) {
+                    return;
+                  }
+                } else if (parsed.data.type === "error") {
+                  throw new ExecutionError(parsed.data.error.message);
                 }
               }
-              yield parsed;
             } catch (parseError) {
               if (parseError instanceof CapabilityError) {
                 throw parseError;
@@ -298,16 +199,15 @@ function createClient(options) {
   return new CapabilityClient(options);
 }
 __name(createClient, "createClient");
-var client = new CapabilityClient();
+var capabilityClient = new CapabilityClient();
 export {
   ActionNotFoundError,
   CapabilityClient,
   CapabilityError,
   CapabilityNotFoundError,
-  ClientNotInitializedError,
   ExecutionError,
   NetworkError,
-  client,
+  capabilityClient,
   createClient
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * 能力调用错误基类\n */\nexport class CapabilityError extends Error {\n  /** 错误码 */\n  code: string;\n  /** HTTP 状态码 */\n  statusCode?: number;\n\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'CapabilityError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * 客户端未初始化错误\n */\nexport class ClientNotInitializedError extends CapabilityError {\n  constructor() {\n    super('Client not initialized. Call init() first or enable autoInit.', 'CLIENT_NOT_INITIALIZED');\n    this.name = 'ClientNotInitializedError';\n  }\n}\n\n/**\n * 能力不存在错误\n */\nexport class CapabilityNotFoundError extends CapabilityError {\n  constructor(capabilityId: string, statusCode?: number) {\n    super(`Capability not found: ${capabilityId}`, 'CAPABILITY_NOT_FOUND', statusCode);\n    this.name = 'CapabilityNotFoundError';\n  }\n}\n\n/**\n * Action 不存在错误\n */\nexport class ActionNotFoundError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'ACTION_NOT_FOUND', statusCode);\n    this.name = 'ActionNotFoundError';\n  }\n}\n\n/**\n * 网络错误\n */\nexport class NetworkError extends CapabilityError {\n  constructor(message: string) {\n    super(message, 'NETWORK_ERROR');\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 执行错误\n */\nexport class ExecutionError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'EXECUTION_ERROR', statusCode);\n    this.name = 'ExecutionError';\n  }\n}\n","import type { CapabilityClientOptions, CapabilityInfo, ApiResponse } from './types';\nimport {\n  CapabilityError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n\nconst DEFAULT_OPTIONS: Required<CapabilityClientOptions> = {\n  baseURL: '',\n  fetchOptions: {},\n  autoInit: true,\n};\n\n/**\n * 能力客户端\n */\nexport class CapabilityClient {\n  private options: Required<CapabilityClientOptions>;\n  private capabilities: Map<string, CapabilityInfo> = new Map();\n  private _initialized = false;\n  private initPromise: Promise<void> | null = null;\n\n  /**\n   * 是否已初始化\n   */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  constructor(options?: CapabilityClientOptions) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  /**\n   * 初始化客户端，获取能力列表\n   */\n  async init(): Promise<void> {\n    if (this._initialized) {\n      return;\n    }\n\n    // 防止并发初始化\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = this.doInit();\n    try {\n      await this.initPromise;\n    } finally {\n      this.initPromise = null;\n    }\n  }\n\n  private async doInit(): Promise<void> {\n    const url = `${this.options.baseURL}/api/capability/list`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n      });\n\n      if (!response.ok) {\n        throw new NetworkError(`Failed to fetch capabilities: ${response.status} ${response.statusText}`);\n      }\n\n      const data = (await response.json()) as ApiResponse<CapabilityInfo[]>;\n\n      if (data.code !== 0) {\n        throw new ExecutionError((data as { message: string }).message);\n      }\n\n      this.capabilities.clear();\n      for (const capability of (data as { data: CapabilityInfo[] }).data) {\n        this.capabilities.set(capability.id, capability);\n      }\n\n      this._initialized = true;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * 确保已初始化\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (!this._initialized && this.options.autoInit) {\n      await this.init();\n    }\n  }\n\n  /**\n   * 调用能力\n   * @param capabilityId - 能力 ID\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns Action 执行结果\n   */\n  async call<T = unknown>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    await this.ensureInitialized();\n\n    // 检查能力是否存在（如果已初始化）\n    if (this._initialized && !this.capabilities.has(capabilityId)) {\n      throw new CapabilityNotFoundError(capabilityId);\n    }\n\n    const url = `${this.options.baseURL}/api/capability/${capabilityId}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n\n      const data = (await response.json()) as ApiResponse<T>;\n\n      if (!response.ok || data.code !== 0) {\n        const errorResponse = data as { code: number; message: string; error?: string };\n        const errorCode = errorResponse.error ?? 'UNKNOWN_ERROR';\n\n        switch (errorCode) {\n          case 'CAPABILITY_NOT_FOUND':\n            throw new CapabilityNotFoundError(capabilityId, response.status);\n          case 'ACTION_NOT_FOUND':\n            throw new ActionNotFoundError(errorResponse.message, response.status);\n          case 'PLUGIN_NOT_FOUND':\n          case 'EXECUTION_ERROR':\n          default:\n            throw new ExecutionError(errorResponse.message, response.status);\n        }\n      }\n\n      return (data as { data: T }).data;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * 检查能力是否存在\n   */\n  hasCapability(capabilityId: string): boolean {\n    return this.capabilities.has(capabilityId);\n  }\n\n  /**\n   * 获取所有可用能力\n   */\n  async listCapabilities(): Promise<CapabilityInfo[]> {\n    await this.ensureInitialized();\n    return Array.from(this.capabilities.values());\n  }\n\n  /**\n   * 获取单个能力信息\n   */\n  async getCapability(capabilityId: string): Promise<CapabilityInfo | null> {\n    await this.ensureInitialized();\n    return this.capabilities.get(capabilityId) ?? null;\n  }\n\n  /**\n   * 流式调用能力\n   * @param capabilityId - 能力 ID\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns AsyncIterable，逐个 yield chunk\n   */\n  async *callStream<T = unknown>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T> {\n    await this.ensureInitialized();\n\n    // 检查能力是否存在（如果已初始化）\n    if (this._initialized && !this.capabilities.has(capabilityId)) {\n      throw new CapabilityNotFoundError(capabilityId);\n    }\n\n    const url = `${this.options.baseURL}/api/capability/${capabilityId}/stream`;\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n    } catch (error) {\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n\n    if (!response.ok) {\n      throw new NetworkError(`HTTP ${response.status} ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new NetworkError('Response body is null');\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            const data = line.slice(6);\n\n            // 流结束标记\n            if (data === '[DONE]') {\n              return;\n            }\n\n            try {\n              const parsed = JSON.parse(data) as { error?: string; code?: string } & T;\n\n              // 服务端错误\n              if (parsed.error) {\n                const errorCode = parsed.code ?? 'EXECUTION_ERROR';\n                switch (errorCode) {\n                  case 'CAPABILITY_NOT_FOUND':\n                    throw new CapabilityNotFoundError(capabilityId);\n                  case 'ACTION_NOT_FOUND':\n                    throw new ActionNotFoundError(parsed.error);\n                  default:\n                    throw new ExecutionError(parsed.error);\n                }\n              }\n\n              yield parsed as T;\n            } catch (parseError) {\n              // JSON 解析错误，跳过此行\n              if (parseError instanceof CapabilityError) {\n                throw parseError;\n              }\n              // 忽略非 JSON 行\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\n/**\n * 创建自定义客户端\n */\nexport function createClient(options?: CapabilityClientOptions): CapabilityClient {\n  return new CapabilityClient(options);\n}\n\n/**\n * 默认客户端实例\n */\nexport const client = new CapabilityClient();\n"],"mappings":"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","names":["CapabilityError","Error","message","code","statusCode","name","ClientNotInitializedError","CapabilityNotFoundError","capabilityId","ActionNotFoundError","NetworkError","ExecutionError","DEFAULT_OPTIONS","baseURL","fetchOptions","autoInit","CapabilityClient","options","capabilities","Map","_initialized","initPromise","initialized","init","doInit","url","response","fetch","method","headers","ok","NetworkError","status","statusText","data","json","code","ExecutionError","message","clear","capability","set","id","error","CapabilityError","Error","String","ensureInitialized","call","capabilityId","action","params","has","CapabilityNotFoundError","body","JSON","stringify","errorResponse","errorCode","ActionNotFoundError","hasCapability","listCapabilities","Array","from","values","getCapability","get","callStream","reader","getReader","decoder","TextDecoder","buffer","done","value","read","decode","stream","lines","split","pop","line","startsWith","slice","parsed","parse","parseError","releaseLock","createClient","client"]}
+{"version":3,"sources":["../src/types.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * 客户端配置选项\n */\nexport interface CapabilityClientOptions {\n  /** 自定义 fetch 配置 */\n  fetchOptions?: RequestInit;\n}\n\n/**\n * 能力执行器接口\n */\nexport interface CapabilityExecutor {\n  /**\n   * 调用能力\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns Action 执行结果\n   */\n  call<T = unknown>(\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T>;\n\n  /**\n   * 流式调用能力\n   * @param action - Action 名称\n   * @param params - 输入参数\n   * @returns AsyncIterable，逐个 yield chunk\n   */\n  callStream<T = unknown>(\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T>;\n}\n\n// ========== API 响应类型 ==========\n\n/**\n * 成功响应\n */\nexport interface SuccessResponse<T> {\n  status_code: '0';\n  data: T;\n}\n\n/**\n * 错误响应\n */\nexport interface ErrorResponse {\n  status_code: string;\n  error_msg: string;\n}\n\n/**\n * API 响应类型\n */\nexport type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;\n\n// ========== 具体响应 data 结构 ==========\n\n/**\n * 执行接口响应 data 结构\n */\nexport interface ExecuteResponseData {\n  output: unknown;\n}\n\n// ========== 流式响应结构 ==========\n\n/**\n * 流式内容响应\n */\nexport interface StreamContentResponse {\n  status_code: '0';\n  data: {\n    type: 'content';\n    delta: {\n      content: unknown;\n    };\n    finished?: boolean;\n  };\n}\n\n/**\n * 流式错误响应\n */\nexport interface StreamErrorResponse {\n  status_code: '0';\n  data: {\n    type: 'error';\n    error: {\n      code: number;\n      message: string;\n    };\n  };\n}\n\n/**\n * 流式响应类型\n */\nexport type StreamResponse = StreamContentResponse | StreamErrorResponse;\n\n// ========== 错误码 ==========\n\n/**\n * 后端错误码\n */\nexport const ErrorCodes = {\n  SUCCESS: '0',\n  CAPABILITY_NOT_FOUND: 'k_ec_cap_001',\n  PLUGIN_NOT_FOUND: 'k_ec_cap_002',\n  ACTION_NOT_FOUND: 'k_ec_cap_003',\n  PARAMS_VALIDATION_ERROR: 'k_ec_cap_004',\n  EXECUTION_ERROR: 'k_ec_cap_005',\n} as const;\n","/**\n * 能力调用错误基类\n */\nexport class CapabilityError extends Error {\n  /** 错误码 */\n  code: string;\n  /** HTTP 状态码 */\n  statusCode?: number;\n\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'CapabilityError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * 能力不存在错误\n */\nexport class CapabilityNotFoundError extends CapabilityError {\n  constructor(capabilityId: string, statusCode?: number) {\n    super(`Capability not found: ${capabilityId}`, 'CAPABILITY_NOT_FOUND', statusCode);\n    this.name = 'CapabilityNotFoundError';\n  }\n}\n\n/**\n * Action 不存在错误\n */\nexport class ActionNotFoundError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'ACTION_NOT_FOUND', statusCode);\n    this.name = 'ActionNotFoundError';\n  }\n}\n\n/**\n * 网络错误\n */\nexport class NetworkError extends CapabilityError {\n  constructor(message: string) {\n    super(message, 'NETWORK_ERROR');\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 执行错误\n */\nexport class ExecutionError extends CapabilityError {\n  constructor(message: string, statusCode?: number) {\n    super(message, 'EXECUTION_ERROR', statusCode);\n    this.name = 'ExecutionError';\n  }\n}\n","import type {\n  CapabilityClientOptions,\n  CapabilityExecutor,\n  ApiResponse,\n  ExecuteResponseData,\n  StreamResponse,\n} from './types';\nimport { ErrorCodes } from './types';\nimport {\n  CapabilityError,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n  NetworkError,\n  ExecutionError,\n} from './errors';\n\n/**\n * 能力客户端\n */\nexport class CapabilityClient {\n  private options: CapabilityClientOptions;\n\n  constructor(options?: CapabilityClientOptions) {\n    this.options = options ?? {};\n  }\n\n  /**\n   * 加载能力，返回执行器\n   * @param capabilityId - 能力 ID\n   * @returns 能力执行器\n   */\n  load(capabilityId: string): CapabilityExecutor {\n    return this.createExecutor(capabilityId);\n  }\n\n  private createExecutor(capabilityId: string): CapabilityExecutor {\n    return {\n      call: <T = unknown>(action: string, params?: Record<string, unknown>) => {\n        return this.executeCall<T>(capabilityId, action, params);\n      },\n      callStream: <T = unknown>(action: string, params?: Record<string, unknown>) => {\n        return this.executeCallStream<T>(capabilityId, action, params);\n      },\n    };\n  }\n\n  private async executeCall<T>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `/api/capability/${capabilityId}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions?.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n\n      const data = (await response.json()) as ApiResponse<ExecuteResponseData>;\n\n      if (!response.ok || data.status_code !== ErrorCodes.SUCCESS) {\n        const errorResponse = data as { status_code: string; error_msg: string };\n        const errorCode = errorResponse.status_code;\n\n        switch (errorCode) {\n          case ErrorCodes.CAPABILITY_NOT_FOUND:\n            throw new CapabilityNotFoundError(capabilityId, response.status);\n          case ErrorCodes.ACTION_NOT_FOUND:\n            throw new ActionNotFoundError(errorResponse.error_msg, response.status);\n          case ErrorCodes.PLUGIN_NOT_FOUND:\n          case ErrorCodes.EXECUTION_ERROR:\n          default:\n            throw new ExecutionError(errorResponse.error_msg, response.status);\n        }\n      }\n\n      return (data as { data: ExecuteResponseData }).data.output as T;\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  private async *executeCallStream<T>(\n    capabilityId: string,\n    action: string,\n    params?: Record<string, unknown>\n  ): AsyncIterable<T> {\n    const url = `/api/capability/${capabilityId}/stream`;\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: 'POST',\n        ...this.options.fetchOptions,\n        headers: {\n          'Content-Type': 'application/json',\n          ...this.options.fetchOptions?.headers,\n        },\n        body: JSON.stringify({\n          action,\n          params: params ?? {},\n        }),\n      });\n    } catch (error) {\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    }\n\n    if (!response.ok) {\n      throw new NetworkError(`HTTP ${response.status} ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new NetworkError('Response body is null');\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            const data = line.slice(6);\n\n            try {\n              const parsed = JSON.parse(data) as StreamResponse;\n\n              if (parsed.status_code === ErrorCodes.SUCCESS && parsed.data) {\n                if (parsed.data.type === 'content') {\n                  yield parsed.data.delta.content as T;\n\n                  if (parsed.data.finished) {\n                    return;\n                  }\n                } else if (parsed.data.type === 'error') {\n                  throw new ExecutionError(parsed.data.error.message);\n                }\n              }\n            } catch (parseError) {\n              if (parseError instanceof CapabilityError) {\n                throw parseError;\n              }\n              // 忽略非 JSON 行\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (error instanceof CapabilityError) {\n        throw error;\n      }\n      throw new NetworkError(error instanceof Error ? error.message : String(error));\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\n/**\n * 创建自定义客户端\n */\nexport function createClient(options?: CapabilityClientOptions): CapabilityClient {\n  return new CapabilityClient(options);\n}\n\n/**\n * 默认客户端实例\n */\nexport const capabilityClient = new CapabilityClient();\n"],"mappings":"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","names":["ErrorCodes","SUCCESS","CAPABILITY_NOT_FOUND","PLUGIN_NOT_FOUND","ACTION_NOT_FOUND","PARAMS_VALIDATION_ERROR","EXECUTION_ERROR","CapabilityError","Error","message","code","statusCode","name","CapabilityNotFoundError","capabilityId","ActionNotFoundError","NetworkError","ExecutionError","CapabilityClient","options","load","capabilityId","createExecutor","call","action","params","executeCall","callStream","executeCallStream","url","response","fetch","method","fetchOptions","headers","body","JSON","stringify","data","json","ok","status_code","ErrorCodes","SUCCESS","errorResponse","errorCode","CAPABILITY_NOT_FOUND","CapabilityNotFoundError","status","ACTION_NOT_FOUND","ActionNotFoundError","error_msg","PLUGIN_NOT_FOUND","EXECUTION_ERROR","ExecutionError","output","error","CapabilityError","NetworkError","Error","message","String","statusText","reader","getReader","decoder","TextDecoder","buffer","done","value","read","decode","stream","lines","split","pop","line","startsWith","slice","parsed","parse","type","delta","content","finished","parseError","releaseLock","createClient","capabilityClient"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-capability",
-  "version": "0.0.1-alpha.0",
+  "version": "0.0.1-alpha.1",
   "description": "Client SDK for calling capabilities",
   "type": "module",
   "main": "./dist/index.cjs",