@plolink/sdk 0.0.10 → 0.0.11

package/dist/modules/preset-agent-task/index.js

@@ -0,0 +1,358 @@
+// src/modules/preset-agent-task/index.ts
+var PresetAgentTask = class {
+  constructor(client) {
+    this.baseUrl = "/api/v1/preset-agent-tasks";
+    this.client = client;
+  }
+  /**
+   * 创建预设
+   * 
+   * @param params - 创建参数
+   * @returns 预设ID和code
+   * @throws {PlolinkError} 当参数无效或创建失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await presetAgentTask.create({
+   *   code: 'talent-resume-parse',
+   *   name: '简历解析预设',
+   *   description: '自动解析简历并提取关键信息',
+   *   prompt: '请解析上传的简历文件，提取候选人的基本信息、教育背景、工作经历等关键数据',
+   *   model: 'doubao-seed-1-6-lite-251015',
+   *   selectedSkills: ['talent/resume-parse', 'common/file-extract'],
+   *   timeoutMs: 1800000,
+   *   businessKey: 'talent-resume-parse'
+   * });
+   * 
+   * console.log('预设ID:', result.id);
+   * console.log('预设标识:', result.code);
+   * ```
+   */
+  async create(params) {
+    return this.client.axiosInstance.post(this.baseUrl, params);
+  }
+  /**
+   * 获取预设列表
+   * 
+   * @param options - 查询选项
+   * @returns 分页的预设列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 获取所有启用的预设
+   * const result = await presetAgentTask.list({
+   *   enabled: true,
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log('总数:', result.total);
+   * result.list.forEach(preset => {
+   *   console.log(`${preset.code}: ${preset.name}`);
+   * });
+   * ```
+   */
+  async list(options) {
+    return this.client.axiosInstance.get(this.baseUrl, {
+      params: options
+    });
+  }
+  /**
+   * 获取预设详情
+   * 
+   * @param id - 预设ID
+   * @returns 预设详细信息
+   * @throws {PlolinkError} 当预设不存在时抛出
+   * 
+   * @example
+   * ```typescript
+   * const preset = await presetAgentTask.getById('clx_preset_123');
+   * console.log('预设名称:', preset.name);
+   * console.log('预设指令:', preset.prompt);
+   * console.log('AI模型:', preset.model);
+   * ```
+   */
+  async getById(id) {
+    return this.client.axiosInstance.get(`${this.baseUrl}/${id}`);
+  }
+  /**
+   * 通过code获取预设
+   * 
+   * @param code - 预设唯一标识
+   * @returns 预设详细信息
+   * @throws {PlolinkError} 当预设不存在时抛出
+   * 
+   * @example
+   * ```typescript
+   * const preset = await presetAgentTask.getByCode('talent-resume-parse');
+   * console.log('预设ID:', preset.id);
+   * console.log('预设名称:', preset.name);
+   * ```
+   */
+  async getByCode(code) {
+    const result = await this.list({ enabled: true, pageSize: 100 });
+    const preset = result.list.find((p) => p.code === code);
+    if (!preset) {
+      throw new Error(`Preset not found with code: ${code}`);
+    }
+    return this.getById(preset.id);
+  }
+  /**
+   * 更新预设
+   * 
+   * @param id - 预设ID
+   * @param params - 更新参数
+   * @throws {PlolinkError} 当预设不存在或更新失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * await presetAgentTask.update('clx_preset_123', {
+   *   name: '简历解析预设（更新）',
+   *   enabled: false
+   * });
+   * 
+   * console.log('预设更新成功');
+   * ```
+   */
+  async update(id, params) {
+    await this.client.axiosInstance.put(`${this.baseUrl}/${id}`, params);
+  }
+  /**
+   * 删除预设
+   * 
+   * @param id - 预设ID
+   * @throws {PlolinkError} 当预设不存在或删除失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * await presetAgentTask.delete('clx_preset_123');
+   * console.log('预设删除成功');
+   * ```
+   */
+  async delete(id) {
+    await this.client.axiosInstance.delete(`${this.baseUrl}/${id}`);
+  }
+  /**
+   * 执行预设（核心方法）
+   * 
+   * @description
+   * 通过预设code执行预设任务。可以附加额外指令和输入文件。
+   * 
+   * 执行后可以通过以下方式获取结果：
+   * - 方式1：轮询查询 - 使用 getExecutionById() 定期查询执行状态
+   * - 方式2：Webhook推送 - 配置Webhook接收执行完成通知
+   * 
+   * @param params - 执行参数
+   * @returns 执行ID和初始状态
+   * @throws {PlolinkError} 当预设不存在或执行失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 执行预设
+   * const result = await presetAgentTask.execute({
+   *   code: 'talent-resume-parse',
+   *   additionalPrompt: '请特别关注技能匹配度',
+   *   inputFileId: 'file-resume-123'
+   * });
+   * 
+   * console.log('执行ID:', result.executionId);
+   * console.log('初始状态:', result.status); // 'INITIALIZING'
+   * 
+   * // 方式1：轮询查询结果
+   * let execution;
+   * do {
+   *   await new Promise(resolve => setTimeout(resolve, 5000)); // 等待5秒
+   *   execution = await presetAgentTask.getExecutionById(result.executionId);
+   *   console.log('当前状态:', execution.status);
+   * } while (execution.status === 'INITIALIZING' || execution.status === 'RUNNING');
+   * 
+   * console.log('执行完成！');
+   * console.log('输出文件:', execution.outputFileId);
+   * console.log('Token消耗:', execution.metrics.inputTokens);
+   * console.log('费用:', execution.metrics.totalCost);
+   * 
+   * // 方式2：通过Webhook接收结果（需要在系统中配置）
+   * // Webhook URL会收到POST请求：
+   * // {
+   * //   module: "preset-agent-task",
+   * //   action: "execution.completed",
+   * //   data: {
+   * //     executionId: "...",
+   * //     outputFileId: "...",
+   * //     metrics: {...}
+   * //   }
+   * // }
+   * ```
+   */
+  async execute(params) {
+    return this.client.axiosInstance.post(`${this.baseUrl}/execute`, params);
+  }
+  /**
+   * 获取执行记录列表
+   * 
+   * @param options - 查询选项
+   * @returns 分页的执行记录列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 查询特定预设的执行记录
+   * const result = await presetAgentTask.listExecutions({
+   *   presetId: 'clx_preset_123',
+   *   status: 'COMPLETED',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log('总数:', result.total);
+   * result.list.forEach(execution => {
+   *   console.log(`执行ID: ${execution.id}, 状态: ${execution.status}`);
+   * });
+   * ```
+   */
+  async listExecutions(options) {
+    return this.client.axiosInstance.get(
+      `${this.baseUrl}/executions`,
+      { params: options }
+    );
+  }
+  /**
+   * 获取执行详情
+   * 
+   * @description
+   * 获取执行记录的完整信息，包括输出文件ID、Token消耗、费用等。
+   * 注意：不包含agentTaskId、runId（完全隐藏Agent Task细节）
+   * 
+   * @param executionId - 执行ID
+   * @returns 执行详细信息
+   * @throws {PlolinkError} 当执行记录不存在时抛出
+   * 
+   * @example
+   * ```typescript
+   * const execution = await presetAgentTask.getExecutionById('clx_exec_789');
+   * 
+   * console.log('执行状态:', execution.status);
+   * console.log('预设名称:', execution.presetName);
+   * console.log('输入文件:', execution.inputFileId);
+   * console.log('输出文件:', execution.outputFileId);
+   * console.log('执行时长:', execution.duration, 'ms');
+   * console.log('Token消耗:', execution.metrics.inputTokens, '+', execution.metrics.outputTokens);
+   * console.log('总费用:', execution.metrics.totalCost, 'USD');
+   * 
+   * if (execution.status === 'FAILED') {
+   *   console.error('错误信息:', execution.errorMessage);
+   * }
+   * ```
+   */
+  async getExecutionById(executionId) {
+    return this.client.axiosInstance.get(`${this.baseUrl}/executions/${executionId}`);
+  }
+  /**
+   * 取消执行
+   * 
+   * @param executionId - 执行ID
+   * @param reason - 取消原因（可选）
+   * @throws {PlolinkError} 当执行不存在或取消失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * await presetAgentTask.cancelExecution('clx_exec_789', '用户主动取消');
+   * console.log('执行已取消');
+   * ```
+   */
+  async cancelExecution(executionId, reason) {
+    await this.client.axiosInstance.post(`${this.baseUrl}/executions/${executionId}/cancel`, { reason });
+  }
+  /**
+   * 重新执行
+   * 
+   * @description
+   * 使用相同的参数重新执行预设任务。
+   * 
+   * @param executionId - 原执行ID
+   * @returns 新的执行ID和状态
+   * @throws {PlolinkError} 当原执行不存在或重试失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await presetAgentTask.retryExecution('clx_exec_789');
+   * console.log('新执行ID:', result.executionId);
+   * console.log('初始状态:', result.status);
+   * ```
+   */
+  async retryExecution(executionId) {
+    return this.client.axiosInstance.post(`${this.baseUrl}/executions/${executionId}/retry`);
+  }
+  /**
+   * 导出预设配置
+   * 
+   * @description
+   * 导出选中的预设配置为JSON格式，可用于跨团队/环境迁移。
+   * 注意：extendedSkillsFileId需要手动处理（文件不跨团队）
+   * 
+   * @param presetIds - 预设ID数组
+   * @returns 导出的配置（JSON格式）
+   * @throws {PlolinkError} 当预设不存在或导出失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const config = await presetAgentTask.export(['clx_preset_123', 'clx_preset_456']);
+   * 
+   * console.log('配置版本:', config.version);
+   * console.log('导出时间:', config.exportedAt);
+   * console.log('预设数量:', config.presets.length);
+   * 
+   * // 保存到文件（Node.js环境）
+   * const fs = require('fs');
+   * fs.writeFileSync('presets.json', JSON.stringify(config, null, 2));
+   * ```
+   */
+  async export(presetIds) {
+    return this.client.axiosInstance.post(`${this.baseUrl}/export`, { presetIds });
+  }
+  /**
+   * 导入预设配置
+   * 
+   * @description
+   * 从导出的JSON配置导入预设到当前团队。
+   * 支持冲突处理策略：skip（跳过已存在）或 overwrite（覆盖已存在）
+   * 
+   * @param config - 导出的配置
+   * @param conflictStrategy - 冲突策略（'skip' 或 'overwrite'），默认 'skip'
+   * @returns 导入结果
+   * @throws {PlolinkError} 当配置无效或导入失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 从文件读取（Node.js环境）
+   * const fs = require('fs');
+   * const config = JSON.parse(fs.readFileSync('presets.json', 'utf-8'));
+   * 
+   * // 导入（跳过已存在的code）
+   * const result = await presetAgentTask.import(config, 'skip');
+   * console.log('导入成功:', result.imported);
+   * console.log('跳过:', result.skipped);
+   * console.log('失败:', result.failed);
+   * 
+   * result.details.forEach(detail => {
+   *   console.log(`${detail.code}: ${detail.status}`);
+   *   if (detail.status === 'imported') {
+   *     console.log('  新预设ID:', detail.presetId);
+   *   } else if (detail.status === 'failed') {
+   *     console.log('  错误:', detail.error);
+   *   }
+   * });
+   * ```
+   */
+  async import(config, conflictStrategy = "skip") {
+    return this.client.axiosInstance.post(`${this.baseUrl}/import`, {
+      ...config,
+      conflictStrategy
+    });
+  }
+};
+
+export { PresetAgentTask };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/preset-agent-task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/preset-agent-task/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 预设Agent任务模块\n * \n * @description\n * 预设Agent任务是对Agent Task能力的封装，提供开箱即用的业务能力。\n * \n * 核心功能：\n * - 预设配置管理（CRUD）\n * - 预设执行（通过code调用）\n * - 执行记录查询\n * - 执行管理（取消、重试）\n * - 配置导出/导入\n * \n * 注意：完全隐藏Agent Task实现细节，不暴露agentTaskId、runId\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { PresetAgentTask } from '@plolink/sdk/preset-agent-task';\n * \n * const client = new PlolinkClient({\n *   mode: 'apiKey',\n *   apiKey: 'your-api-key'\n * });\n * \n * const presetAgentTask = new PresetAgentTask(client);\n * \n * // 执行预设\n * const result = await presetAgentTask.execute({\n *   code: 'talent-resume-parse',\n *   additionalPrompt: '请特别关注技能匹配度',\n *   inputFileId: 'file-resume-123'\n * });\n * \n * console.log('执行ID:', result.executionId);\n * console.log('初始状态:', result.status);\n * \n * // 方式1：轮询查询结果\n * const execution = await presetAgentTask.getExecutionById(result.executionId);\n * console.log('输出文件:', execution.outputFileId);\n * \n * // 方式2：通过Webhook接收结果（需要在系统中配置Webhook）\n * // POST /your-webhook-url\n * // { module: \"preset-agent-task\", action: \"execution.completed\", data: {...} }\n * ```\n * \n * @module preset-agent-task\n */\n\nimport type { PlolinkClient } from '../../core/client';\nimport type {\n  PresetConfig,\n  PresetListItem,\n  CreatePresetParams,\n  UpdatePresetParams,\n  ExecutePresetParams,\n  PresetExecution,\n  PresetExecutionListItem,\n  PresetListQuery,\n  ExecutionListQuery,\n  PaginatedResult,\n  ExecutionResult,\n  ExportedConfig,\n  ImportResult,\n  ConflictStrategy,\n} from '../../types/preset-agent-task';\n\n// Re-export types\nexport type {\n  PresetConfig,\n  PresetListItem,\n  CreatePresetParams,\n  UpdatePresetParams,\n  ExecutePresetParams,\n  PresetExecution,\n  PresetExecutionListItem,\n  PresetListQuery,\n  ExecutionListQuery,\n  PaginatedResult,\n  ExecutionResult,\n  ExportedConfig,\n  ImportResult,\n  ConflictStrategy,\n  PresetExecutionStatus,\n  ExecutionMetrics,\n  PresetConfigForExport,\n  ImportResultDetail,\n  PresetExecutionWebhookPayload,\n} from '../../types/preset-agent-task';\n\n/**\n * 预设Agent任务模块\n */\nexport class PresetAgentTask {\n  private client: PlolinkClient;\n  private baseUrl = '/api/v1/preset-agent-tasks';\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 创建预设\n   * \n   * @param params - 创建参数\n   * @returns 预设ID和code\n   * @throws {PlolinkError} 当参数无效或创建失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await presetAgentTask.create({\n   *   code: 'talent-resume-parse',\n   *   name: '简历解析预设',\n   *   description: '自动解析简历并提取关键信息',\n   *   prompt: '请解析上传的简历文件，提取候选人的基本信息、教育背景、工作经历等关键数据',\n   *   model: 'doubao-seed-1-6-lite-251015',\n   *   selectedSkills: ['talent/resume-parse', 'common/file-extract'],\n   *   timeoutMs: 1800000,\n   *   businessKey: 'talent-resume-parse'\n   * });\n   * \n   * console.log('预设ID:', result.id);\n   * console.log('预设标识:', result.code);\n   * ```\n   */\n  public async create(params: CreatePresetParams): Promise<{ id: string; code: string }> {\n    return this.client.axiosInstance.post(this.baseUrl, params);\n  }\n\n  /**\n   * 获取预设列表\n   * \n   * @param options - 查询选项\n   * @returns 分页的预设列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 获取所有启用的预设\n   * const result = await presetAgentTask.list({\n   *   enabled: true,\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log('总数:', result.total);\n   * result.list.forEach(preset => {\n   *   console.log(`${preset.code}: ${preset.name}`);\n   * });\n   * ```\n   */\n  public async list(options?: PresetListQuery): Promise<PaginatedResult<PresetListItem>> {\n    return this.client.axiosInstance.get(this.baseUrl, {\n      params: options,\n    });\n  }\n\n  /**\n   * 获取预设详情\n   * \n   * @param id - 预设ID\n   * @returns 预设详细信息\n   * @throws {PlolinkError} 当预设不存在时抛出\n   * \n   * @example\n   * ```typescript\n   * const preset = await presetAgentTask.getById('clx_preset_123');\n   * console.log('预设名称:', preset.name);\n   * console.log('预设指令:', preset.prompt);\n   * console.log('AI模型:', preset.model);\n   * ```\n   */\n  public async getById(id: string): Promise<PresetConfig> {\n    return this.client.axiosInstance.get(`${this.baseUrl}/${id}`);\n  }\n\n  /**\n   * 通过code获取预设\n   * \n   * @param code - 预设唯一标识\n   * @returns 预设详细信息\n   * @throws {PlolinkError} 当预设不存在时抛出\n   * \n   * @example\n   * ```typescript\n   * const preset = await presetAgentTask.getByCode('talent-resume-parse');\n   * console.log('预设ID:', preset.id);\n   * console.log('预设名称:', preset.name);\n   * ```\n   */\n  public async getByCode(code: string): Promise<PresetConfig> {\n    // 通过列表查找匹配的code\n    const result = await this.list({ enabled: true, pageSize: 100 });\n    const preset = result.list.find((p) => p.code === code);\n    \n    if (!preset) {\n      throw new Error(`Preset not found with code: ${code}`);\n    }\n    \n    return this.getById(preset.id);\n  }\n\n  /**\n   * 更新预设\n   * \n   * @param id - 预设ID\n   * @param params - 更新参数\n   * @throws {PlolinkError} 当预设不存在或更新失败时抛出\n   * \n   * @example\n   * ```typescript\n   * await presetAgentTask.update('clx_preset_123', {\n   *   name: '简历解析预设（更新）',\n   *   enabled: false\n   * });\n   * \n   * console.log('预设更新成功');\n   * ```\n   */\n  public async update(id: string, params: UpdatePresetParams): Promise<void> {\n    await this.client.axiosInstance.put(`${this.baseUrl}/${id}`, params);\n  }\n\n  /**\n   * 删除预设\n   * \n   * @param id - 预设ID\n   * @throws {PlolinkError} 当预设不存在或删除失败时抛出\n   * \n   * @example\n   * ```typescript\n   * await presetAgentTask.delete('clx_preset_123');\n   * console.log('预设删除成功');\n   * ```\n   */\n  public async delete(id: string): Promise<void> {\n    await this.client.axiosInstance.delete(`${this.baseUrl}/${id}`);\n  }\n\n  /**\n   * 执行预设（核心方法）\n   * \n   * @description\n   * 通过预设code执行预设任务。可以附加额外指令和输入文件。\n   * \n   * 执行后可以通过以下方式获取结果：\n   * - 方式1：轮询查询 - 使用 getExecutionById() 定期查询执行状态\n   * - 方式2：Webhook推送 - 配置Webhook接收执行完成通知\n   * \n   * @param params - 执行参数\n   * @returns 执行ID和初始状态\n   * @throws {PlolinkError} 当预设不存在或执行失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 执行预设\n   * const result = await presetAgentTask.execute({\n   *   code: 'talent-resume-parse',\n   *   additionalPrompt: '请特别关注技能匹配度',\n   *   inputFileId: 'file-resume-123'\n   * });\n   * \n   * console.log('执行ID:', result.executionId);\n   * console.log('初始状态:', result.status); // 'INITIALIZING'\n   * \n   * // 方式1：轮询查询结果\n   * let execution;\n   * do {\n   *   await new Promise(resolve => setTimeout(resolve, 5000)); // 等待5秒\n   *   execution = await presetAgentTask.getExecutionById(result.executionId);\n   *   console.log('当前状态:', execution.status);\n   * } while (execution.status === 'INITIALIZING' || execution.status === 'RUNNING');\n   * \n   * console.log('执行完成！');\n   * console.log('输出文件:', execution.outputFileId);\n   * console.log('Token消耗:', execution.metrics.inputTokens);\n   * console.log('费用:', execution.metrics.totalCost);\n   * \n   * // 方式2：通过Webhook接收结果（需要在系统中配置）\n   * // Webhook URL会收到POST请求：\n   * // {\n   * //   module: \"preset-agent-task\",\n   * //   action: \"execution.completed\",\n   * //   data: {\n   * //     executionId: \"...\",\n   * //     outputFileId: \"...\",\n   * //     metrics: {...}\n   * //   }\n   * // }\n   * ```\n   */\n  public async execute(params: ExecutePresetParams): Promise<ExecutionResult> {\n    return this.client.axiosInstance.post(`${this.baseUrl}/execute`, params);\n  }\n\n  /**\n   * 获取执行记录列表\n   * \n   * @param options - 查询选项\n   * @returns 分页的执行记录列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 查询特定预设的执行记录\n   * const result = await presetAgentTask.listExecutions({\n   *   presetId: 'clx_preset_123',\n   *   status: 'COMPLETED',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log('总数:', result.total);\n   * result.list.forEach(execution => {\n   *   console.log(`执行ID: ${execution.id}, 状态: ${execution.status}`);\n   * });\n   * ```\n   */\n  public async listExecutions(options?: ExecutionListQuery): Promise<PaginatedResult<PresetExecutionListItem>> {\n    return this.client.axiosInstance.get(\n      `${this.baseUrl}/executions`,\n      { params: options }\n    );\n  }\n\n  /**\n   * 获取执行详情\n   * \n   * @description\n   * 获取执行记录的完整信息，包括输出文件ID、Token消耗、费用等。\n   * 注意：不包含agentTaskId、runId（完全隐藏Agent Task细节）\n   * \n   * @param executionId - 执行ID\n   * @returns 执行详细信息\n   * @throws {PlolinkError} 当执行记录不存在时抛出\n   * \n   * @example\n   * ```typescript\n   * const execution = await presetAgentTask.getExecutionById('clx_exec_789');\n   * \n   * console.log('执行状态:', execution.status);\n   * console.log('预设名称:', execution.presetName);\n   * console.log('输入文件:', execution.inputFileId);\n   * console.log('输出文件:', execution.outputFileId);\n   * console.log('执行时长:', execution.duration, 'ms');\n   * console.log('Token消耗:', execution.metrics.inputTokens, '+', execution.metrics.outputTokens);\n   * console.log('总费用:', execution.metrics.totalCost, 'USD');\n   * \n   * if (execution.status === 'FAILED') {\n   *   console.error('错误信息:', execution.errorMessage);\n   * }\n   * ```\n   */\n  public async getExecutionById(executionId: string): Promise<PresetExecution> {\n    return this.client.axiosInstance.get(`${this.baseUrl}/executions/${executionId}`);\n  }\n\n  /**\n   * 取消执行\n   * \n   * @param executionId - 执行ID\n   * @param reason - 取消原因（可选）\n   * @throws {PlolinkError} 当执行不存在或取消失败时抛出\n   * \n   * @example\n   * ```typescript\n   * await presetAgentTask.cancelExecution('clx_exec_789', '用户主动取消');\n   * console.log('执行已取消');\n   * ```\n   */\n  public async cancelExecution(executionId: string, reason?: string): Promise<void> {\n    await this.client.axiosInstance.post(`${this.baseUrl}/executions/${executionId}/cancel`, { reason });\n  }\n\n  /**\n   * 重新执行\n   * \n   * @description\n   * 使用相同的参数重新执行预设任务。\n   * \n   * @param executionId - 原执行ID\n   * @returns 新的执行ID和状态\n   * @throws {PlolinkError} 当原执行不存在或重试失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await presetAgentTask.retryExecution('clx_exec_789');\n   * console.log('新执行ID:', result.executionId);\n   * console.log('初始状态:', result.status);\n   * ```\n   */\n  public async retryExecution(executionId: string): Promise<ExecutionResult> {\n    return this.client.axiosInstance.post(`${this.baseUrl}/executions/${executionId}/retry`);\n  }\n\n  /**\n   * 导出预设配置\n   * \n   * @description\n   * 导出选中的预设配置为JSON格式，可用于跨团队/环境迁移。\n   * 注意：extendedSkillsFileId需要手动处理（文件不跨团队）\n   * \n   * @param presetIds - 预设ID数组\n   * @returns 导出的配置（JSON格式）\n   * @throws {PlolinkError} 当预设不存在或导出失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const config = await presetAgentTask.export(['clx_preset_123', 'clx_preset_456']);\n   * \n   * console.log('配置版本:', config.version);\n   * console.log('导出时间:', config.exportedAt);\n   * console.log('预设数量:', config.presets.length);\n   * \n   * // 保存到文件（Node.js环境）\n   * const fs = require('fs');\n   * fs.writeFileSync('presets.json', JSON.stringify(config, null, 2));\n   * ```\n   */\n  public async export(presetIds: string[]): Promise<ExportedConfig> {\n    return this.client.axiosInstance.post(`${this.baseUrl}/export`, { presetIds });\n  }\n\n  /**\n   * 导入预设配置\n   * \n   * @description\n   * 从导出的JSON配置导入预设到当前团队。\n   * 支持冲突处理策略：skip（跳过已存在）或 overwrite（覆盖已存在）\n   * \n   * @param config - 导出的配置\n   * @param conflictStrategy - 冲突策略（'skip' 或 'overwrite'），默认 'skip'\n   * @returns 导入结果\n   * @throws {PlolinkError} 当配置无效或导入失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 从文件读取（Node.js环境）\n   * const fs = require('fs');\n   * const config = JSON.parse(fs.readFileSync('presets.json', 'utf-8'));\n   * \n   * // 导入（跳过已存在的code）\n   * const result = await presetAgentTask.import(config, 'skip');\n   * console.log('导入成功:', result.imported);\n   * console.log('跳过:', result.skipped);\n   * console.log('失败:', result.failed);\n   * \n   * result.details.forEach(detail => {\n   *   console.log(`${detail.code}: ${detail.status}`);\n   *   if (detail.status === 'imported') {\n   *     console.log('  新预设ID:', detail.presetId);\n   *   } else if (detail.status === 'failed') {\n   *     console.log('  错误:', detail.error);\n   *   }\n   * });\n   * ```\n   */\n  public async import(config: ExportedConfig, conflictStrategy: ConflictStrategy = 'skip'): Promise<ImportResult> {\n    return this.client.axiosInstance.post(`${this.baseUrl}/import`, {\n      ...config,\n      conflictStrategy,\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plolink/sdk",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Plolink 开放平台官方 SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -56,6 +56,16 @@
       "import": "./dist/modules/report-writer/index.js",
       "require": "./dist/modules/report-writer/index.cjs"
     },
+    "./preset-agent-task": {
+      "types": "./dist/modules/preset-agent-task/index.d.ts",
+      "import": "./dist/modules/preset-agent-task/index.js",
+      "require": "./dist/modules/preset-agent-task/index.cjs"
+    },
+    "./llm": {
+      "types": "./dist/modules/llm/index.d.ts",
+      "import": "./dist/modules/llm/index.js",
+      "require": "./dist/modules/llm/index.cjs"
+    },
     "./common": {
       "types": "./dist/common/index.d.ts",
       "import": "./dist/common/index.js",