persona-core 1.0.0

package/dist/services/loaders/fileLoader.js

@@ -0,0 +1,161 @@
+/**
+ * File Loader
+ * 读取本地文件内容，用于 Template Loader 表达式
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * 敏感文件模式
+ * 禁止读取这些文件以保护安全
+ */
+const FORBIDDEN_PATTERNS = [
+    /\.env$/i,
+    /\.env\.\w+$/i, // .env.local, .env.production 等
+    /keys\.json$/i,
+    /\.pem$/i,
+    /\.key$/i,
+    /id_rsa$/i,
+    /id_ed25519$/i,
+    /\.p12$/i,
+    /\.pfx$/i,
+    /credentials\.json$/i,
+    /secrets?\.(json|ya?ml)$/i,
+];
+/**
+ * MIME 类型映射
+ */
+const MIME_TYPES = {
+    // 图片
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.bmp': 'image/bmp',
+    '.ico': 'image/x-icon',
+    '.tiff': 'image/tiff',
+    '.tif': 'image/tiff',
+    // 视频
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.avi': 'video/x-msvideo',
+    '.mov': 'video/quicktime',
+    '.mkv': 'video/x-matroska',
+    // 音频
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.flac': 'audio/flac',
+    // 文本
+    '.txt': 'text/plain',
+    '.html': 'text/html',
+    '.htm': 'text/html',
+    '.css': 'text/css',
+    '.csv': 'text/csv',
+    '.xml': 'text/xml',
+    '.md': 'text/markdown',
+    // 数据
+    '.json': 'application/json',
+    '.js': 'application/javascript',
+    '.ts': 'application/typescript',
+    '.pdf': 'application/pdf',
+    '.zip': 'application/zip',
+    '.tar': 'application/x-tar',
+    '.gz': 'application/gzip',
+};
+/**
+ * FileLoader 类
+ * 负责安全地读取本地文件
+ */
+export class FileLoader {
+    baseDir;
+    maxFileSize;
+    constructor(
+    /** 基础目录，所有相对路径都相对于此目录 */
+    baseDir, 
+    /** 最大文件大小（字节） */
+    maxFileSize = 50 * 1024 * 1024 // 50MB
+    ) {
+        this.baseDir = baseDir;
+        this.maxFileSize = maxFileSize;
+    }
+    /**
+     * 加载文件
+     *
+     * @param filePath 文件路径（相对或绝对）
+     * @param options 加载选项
+     * @returns 加载结果
+     */
+    async load(filePath, options = {}) {
+        // 解析完整路径
+        const fullPath = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(this.baseDir, filePath);
+        // 安全检查：路径遍历防护
+        const normalizedPath = path.normalize(fullPath);
+        const normalizedBase = path.normalize(this.baseDir);
+        if (!normalizedPath.startsWith(normalizedBase)) {
+            throw new Error(`File path must be within base directory: ${this.baseDir}. ` +
+                `Attempted path: ${filePath}`);
+        }
+        // 安全检查：敏感文件保护
+        if (this.isForbiddenPath(normalizedPath)) {
+            throw new Error(`Access to sensitive files is forbidden: ${path.basename(filePath)}`);
+        }
+        // 检查文件是否存在
+        try {
+            await fs.access(normalizedPath);
+        }
+        catch {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        // 获取文件信息
+        const stats = await fs.stat(normalizedPath);
+        // 检查文件大小
+        if (stats.size > this.maxFileSize) {
+            throw new Error(`File too large: ${stats.size} bytes (max: ${this.maxFileSize} bytes). ` +
+                `File: ${filePath}`);
+        }
+        // 确定 MIME 类型
+        const mimeType = this.detectMimeType(normalizedPath);
+        // 判断是否需要二进制模式
+        // 如果明确指定 binary 或者是二进制文件类型，使用二进制模式
+        const needsBinary = options.binary ?? this.isBinaryMimeType(mimeType);
+        // 读取文件
+        const buffer = await fs.readFile(normalizedPath);
+        return {
+            value: needsBinary ? buffer : buffer.toString('utf-8'),
+            mimeType,
+        };
+    }
+    /**
+     * 检测文件的 MIME 类型
+     */
+    detectMimeType(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        return MIME_TYPES[ext] ?? 'application/octet-stream';
+    }
+    /**
+     * 检查 MIME 类型是否为二进制类型
+     */
+    isBinaryMimeType(mimeType) {
+        // 文本类型不是二进制
+        if (mimeType.startsWith('text/')) {
+            return false;
+        }
+        // JSON 和 JavaScript 是文本
+        if (mimeType === 'application/json' || mimeType === 'application/javascript') {
+            return false;
+        }
+        // 其他都视为二进制
+        return true;
+    }
+    /**
+     * 检查路径是否是被禁止的敏感文件
+     */
+    isForbiddenPath(filePath) {
+        return FORBIDDEN_PATTERNS.some(pattern => pattern.test(filePath));
+    }
+}
+//# sourceMappingURL=fileLoader.js.map

package/dist/services/loaders/fileLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLoader.js","sourceRoot":"","sources":["../../../src/services/loaders/fileLoader.ts"],"names":[],"mappings":"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"}

package/dist/services/loaders/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Template Loaders 模块导出
+ */
+export { FileLoader, type LoaderResult, type FileLoadOptions } from './fileLoader.js';
+export { builtinTransformers, applyTransformers, type Transformer, type TransformerContext } from './transformers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/loaders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC"}

package/dist/services/loaders/index.js

@@ -0,0 +1,6 @@
+/**
+ * Template Loaders 模块导出
+ */
+export { FileLoader } from './fileLoader.js';
+export { builtinTransformers, applyTransformers } from './transformers.js';
+//# sourceMappingURL=index.js.map

package/dist/services/loaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/loaders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAA2C,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC"}

package/dist/services/loaders/transformers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Template Loader Transformers
+ * 用于在 Loader 处理后对数据进行转换
+ */
+/**
+ * Transformer 上下文
+ * 包含转换过程中需要的元数据
+ */
+export interface TransformerContext {
+    /** 文件的 MIME 类型 */
+    mimeType?: string;
+}
+/**
+ * Transformer 函数类型
+ * 接收值和上下文，返回转换后的值
+ */
+export type Transformer = (value: string | Buffer, context: TransformerContext) => string | Buffer;
+/**
+ * 内置 Transformer 集合
+ */
+export declare const builtinTransformers: Record<string, Transformer>;
+/**
+ * 应用转换器链
+ * 按顺序执行所有转换器
+ *
+ * @param value 初始值
+ * @param transformerNames 转换器名称数组
+ * @param context 转换上下文
+ * @returns 转换后的值
+ */
+export declare function applyTransformers(value: string | Buffer, transformerNames: string[], context: TransformerContext): string | Buffer;
+//# sourceMappingURL=transformers.d.ts.map

package/dist/services/loaders/transformers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.d.ts","sourceRoot":"","sources":["../../../src/services/loaders/transformers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,EAAE,kBAAkB,KACxB,MAAM,GAAG,MAAM,CAAC;AAErB;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAiD3D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,MAAM,GAAG,MAAM,CAgBjB"}

package/dist/services/loaders/transformers.js

@@ -0,0 +1,78 @@
+/**
+ * Template Loader Transformers
+ * 用于在 Loader 处理后对数据进行转换
+ */
+/**
+ * 内置 Transformer 集合
+ */
+export const builtinTransformers = {
+    /**
+     * Base64 编码转换器
+     * 将 Buffer 或字符串转换为 base64 编码的字符串
+     */
+    base64: (value, _ctx) => {
+        if (Buffer.isBuffer(value)) {
+            return value.toString('base64');
+        }
+        return Buffer.from(value).toString('base64');
+    },
+    /**
+     * Data URI 转换器
+     * 将 base64 字符串转换为 Data URI 格式
+     * 输入应为 base64 字符串，通常与 base64 transformer 配合使用
+     *
+     * 示例输出: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA..."
+     */
+    dataUri: (value, ctx) => {
+        if (typeof value !== 'string') {
+            throw new Error('dataUri transformer requires string input (base64). Use base64 transformer first.');
+        }
+        const mimeType = ctx.mimeType ?? 'application/octet-stream';
+        return `data:${mimeType};base64,${value}`;
+    },
+    /**
+     * JSON 序列化转换器
+     * 将值序列化为 JSON 字符串
+     */
+    json: (value, _ctx) => {
+        if (Buffer.isBuffer(value)) {
+            // 对于 Buffer，转换为 base64 后再序列化
+            return JSON.stringify(value.toString('base64'));
+        }
+        return JSON.stringify(value);
+    },
+    /**
+     * Trim 转换器
+     * 去除字符串首尾的空白字符
+     */
+    trim: (value, _ctx) => {
+        if (typeof value !== 'string') {
+            throw new Error('trim transformer requires string input');
+        }
+        return value.trim();
+    },
+};
+/**
+ * 应用转换器链
+ * 按顺序执行所有转换器
+ *
+ * @param value 初始值
+ * @param transformerNames 转换器名称数组
+ * @param context 转换上下文
+ * @returns 转换后的值
+ */
+export function applyTransformers(value, transformerNames, context) {
+    let result = value;
+    for (const transformerName of transformerNames) {
+        // 跳过 binary，它是 loader 内部选项
+        if (transformerName === 'binary')
+            continue;
+        const transformer = builtinTransformers[transformerName];
+        if (!transformer) {
+            throw new Error(`Unknown transformer: ${transformerName}. Available: ${Object.keys(builtinTransformers).join(', ')}`);
+        }
+        result = transformer(result, context);
+    }
+    return result;
+}
+//# sourceMappingURL=transformers.js.map

package/dist/services/loaders/transformers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.js","sourceRoot":"","sources":["../../../src/services/loaders/transformers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAsB,EAAE,IAAwB,EAAU,EAAE;QACnE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,KAAsB,EAAE,GAAuB,EAAU,EAAE;QACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACvG,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,0BAA0B,CAAC;QAC5D,OAAO,QAAQ,QAAQ,WAAW,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAsB,EAAE,IAAwB,EAAU,EAAE;QACjE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,6BAA6B;YAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAsB,EAAE,IAAwB,EAAU,EAAE;QACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,gBAA0B,EAC1B,OAA2B;IAE3B,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;QAC/C,2BAA2B;QAC3B,IAAI,eAAe,KAAK,QAAQ;YAAE,SAAS;QAE3C,MAAM,WAAW,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,eAAe,gBAAgB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxH,CAAC;QAED,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/mockAction.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Mock 动作节点服务
+ * 用于测试环境模拟 Action 执行
+ */
+import { ActionService, ActionContext, ActionResult, TaskStatus, MockService } from './interfaces.js';
+import { ActionNodeType } from '../types/index.js';
+/**
+ * Mock 动作配置
+ */
+export interface MockActionConfig {
+    /** 预定义的输出结果 */
+    outputs?: Record<string, unknown> | (() => Record<string, unknown>);
+    /** 模拟延迟 (ms) */
+    delayMs?: number;
+    /** 是否为异步任务 */
+    isAsync?: boolean;
+    /** 异步任务需要的轮询次数 */
+    pollCount?: number;
+    /** 是否模拟失败 */
+    shouldFail?: boolean;
+    /** 失败时机 */
+    failureType?: 'immediate' | 'after_submit' | 'after_polls' | 'timeout';
+    /** 失败错误信息 */
+    failureMessage?: string;
+    /** 进度模拟（异步任务） */
+    progressSteps?: number[];
+}
+/**
+ * Mock 动作服务实现
+ */
+export declare class MockActionService implements ActionService, MockService {
+    private configs;
+    private defaultConfig;
+    private asyncTasks;
+    private callHistory;
+    /**
+     * 配置特定动作类型的 Mock 行为
+     */
+    configureAction(actionTypeId: string, config: MockActionConfig): void;
+    /**
+     * 设置默认配置
+     */
+    setDefaultConfig(config: MockActionConfig): void;
+    /**
+     * 重置服务状态
+     */
+    reset(): void;
+    /**
+     * 获取调用历史
+     */
+    getCallHistory(): {
+        actionTypeId: string;
+        method: "executeSync" | "submitAsyncTask" | "checkTaskStatus" | "getTaskResult";
+        args: unknown[];
+    }[];
+    /**
+     * 获取活跃的异步任务数量
+     */
+    getActiveTaskCount(): number;
+    executeSync(actionType: ActionNodeType, context: ActionContext): Promise<ActionResult>;
+    submitAsyncTask(actionType: ActionNodeType, context: ActionContext): Promise<string>;
+    checkTaskStatus(taskId: string): Promise<TaskStatus>;
+    getTaskResult(taskId: string): Promise<ActionResult>;
+}
+//# sourceMappingURL=mockAction.d.ts.map

package/dist/services/mockAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockAction.d.ts","sourceRoot":"","sources":["../../src/services/mockAction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;IACvE,aAAa;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAkBD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa,EAAE,WAAW;IAClE,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,WAAW,CAIX;IAER;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIrE;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,cAAc;sBAhCE,MAAM;gBACZ,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe;cACzE,OAAO,EAAE;;IAkCjB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAItB,WAAW,CACf,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC;IA2BlB,eAAe,CACnB,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC;IAqCZ,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CpD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA2B3D"}

package/dist/services/mockAction.js

@@ -0,0 +1,153 @@
+/**
+ * Mock 动作节点服务
+ * 用于测试环境模拟 Action 执行
+ */
+/**
+ * Mock 动作服务实现
+ */
+export class MockActionService {
+    configs = new Map();
+    defaultConfig = {};
+    asyncTasks = new Map();
+    callHistory = [];
+    /**
+     * 配置特定动作类型的 Mock 行为
+     */
+    configureAction(actionTypeId, config) {
+        this.configs.set(actionTypeId, config);
+    }
+    /**
+     * 设置默认配置
+     */
+    setDefaultConfig(config) {
+        this.defaultConfig = config;
+    }
+    /**
+     * 重置服务状态
+     */
+    reset() {
+        this.configs.clear();
+        this.asyncTasks.clear();
+        this.callHistory = [];
+        this.defaultConfig = {};
+    }
+    /**
+     * 获取调用历史
+     */
+    getCallHistory() {
+        return [...this.callHistory];
+    }
+    /**
+     * 获取活跃的异步任务数量
+     */
+    getActiveTaskCount() {
+        return this.asyncTasks.size;
+    }
+    async executeSync(actionType, context) {
+        this.callHistory.push({
+            actionTypeId: actionType.id,
+            method: 'executeSync',
+            args: [actionType, context],
+        });
+        const config = this.configs.get(actionType.id) ?? this.defaultConfig;
+        // 模拟延迟
+        if (config.delayMs) {
+            await new Promise(resolve => setTimeout(resolve, config.delayMs));
+        }
+        // 模拟失败
+        if (config.shouldFail && config.failureType === 'immediate') {
+            throw new Error(config.failureMessage ?? `Action ${actionType.id} failed`);
+        }
+        // 获取输出
+        const outputs = typeof config.outputs === 'function'
+            ? config.outputs()
+            : (config.outputs ?? {});
+        return { outputs };
+    }
+    async submitAsyncTask(actionType, context) {
+        this.callHistory.push({
+            actionTypeId: actionType.id,
+            method: 'submitAsyncTask',
+            args: [actionType, context],
+        });
+        const config = this.configs.get(actionType.id) ?? this.defaultConfig;
+        // 模拟提交失败
+        if (config.shouldFail && config.failureType === 'after_submit') {
+            throw new Error(config.failureMessage ?? 'Failed to submit async task');
+        }
+        // 创建任务
+        const taskId = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const totalPolls = config.pollCount ?? 3;
+        const progressSteps = config.progressSteps ??
+            Array.from({ length: totalPolls }, (_, i) => Math.floor((100 / totalPolls) * (i + 1)));
+        this.asyncTasks.set(taskId, {
+            actionTypeId: actionType.id,
+            inputs: context.resolvedInputs,
+            currentPollIndex: 0,
+            totalPolls,
+            currentProgress: 0,
+            progressSteps,
+            config,
+            createdAt: Date.now(),
+        });
+        return taskId;
+    }
+    async checkTaskStatus(taskId) {
+        this.callHistory.push({
+            actionTypeId: '',
+            method: 'checkTaskStatus',
+            args: [taskId],
+        });
+        const task = this.asyncTasks.get(taskId);
+        if (!task) {
+            return {
+                completed: false,
+                failed: true,
+                error: 'Task not found',
+            };
+        }
+        // 递增轮询计数
+        task.currentPollIndex++;
+        // 更新进度
+        const progress = task.progressSteps[task.currentPollIndex - 1] ?? 100;
+        task.currentProgress = progress;
+        // 检查是否完成
+        const completed = task.currentPollIndex >= task.totalPolls;
+        // 模拟轮询后失败
+        if (task.config.shouldFail && task.config.failureType === 'after_polls' && completed) {
+            return {
+                completed: false,
+                failed: true,
+                error: task.config.failureMessage ?? 'Task failed after processing',
+                progress: task.currentProgress,
+            };
+        }
+        return {
+            completed,
+            failed: false,
+            progress: task.currentProgress,
+        };
+    }
+    async getTaskResult(taskId) {
+        this.callHistory.push({
+            actionTypeId: '',
+            method: 'getTaskResult',
+            args: [taskId],
+        });
+        const task = this.asyncTasks.get(taskId);
+        if (!task) {
+            throw new Error('Task not found');
+        }
+        if (task.currentPollIndex < task.totalPolls) {
+            throw new Error('Task not completed yet');
+        }
+        // 获取输出
+        const outputs = typeof task.config.outputs === 'function'
+            ? task.config.outputs()
+            : (task.config.outputs ?? {});
+        // 清理任务
+        this.asyncTasks.delete(taskId);
+        return { outputs };
+    }
+}
+//# sourceMappingURL=mockAction.js.map

package/dist/services/mockAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockAction.js","sourceRoot":"","sources":["../../src/services/mockAction.ts"],"names":[],"mappings":"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"}

package/dist/services/mockBranch.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Mock 分支决策服务
+ * 用于测试环境模拟分支决策
+ */
+import { BranchService, BranchResult, MockService } from './interfaces.js';
+import { BranchNodeInstance, SharedDataInstance } from '../types/index.js';
+/**
+ * Mock 分支配置
+ */
+export interface MockBranchConfig {
+    /** 预定义的分支选择结果 */
+    selectedBranchId?: string;
+    /** 动态决策函数 */
+    decisionFn?: (node: BranchNodeInstance, inputs: Record<string, unknown>) => string;
+    /** 模拟延迟 (ms) */
+    delayMs?: number;
+    /** 是否模拟失败 */
+    shouldFail?: boolean;
+    /** 失败错误信息 */
+    failureMessage?: string;
+}
+/**
+ * Mock 分支服务实现
+ */
+export declare class MockBranchService implements BranchService, MockService {
+    private configs;
+    private defaultConfig;
+    private callHistory;
+    /**
+     * 配置特定节点的 Mock 行为
+     */
+    configure(nodeId: string, config: MockBranchConfig): void;
+    /**
+     * 设置默认配置
+     */
+    setDefaultConfig(config: MockBranchConfig): void;
+    /**
+     * 重置服务状态
+     */
+    reset(): void;
+    /**
+     * 获取调用历史（用于断言）
+     */
+    getCallHistory(): Array<{
+        nodeId: string;
+        inputs: Record<string, unknown>;
+    }>;
+    evaluateBranch(node: BranchNodeInstance, inputs: Record<string, unknown>, _sharedData: SharedDataInstance): Promise<BranchResult>;
+}
+//# sourceMappingURL=mockBranch.d.ts.map

package/dist/services/mockBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockBranch.d.ts","sourceRoot":"","sources":["../../src/services/mockBranch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa;IACb,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACnF,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa,EAAE,WAAW;IAClE,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,WAAW,CAAkE;IAErF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIzD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,cAAc,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAItE,cAAc,CAClB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,YAAY,CAAC;CAwCzB"}