@winspan/claude-forge 1.79.0 → 1.81.0

package/dist/pipeline/completion-detector.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CompletionDetector — 节点完成检测器
+ *
+ * 实现三层检测机制：
+ * 1. 精准检测：显式信号、关键词、文件模式
+ * 2. 智能推断：语义分析、行为模式识别
+ * 3. 强制保护：超时检测、停滞检测
+ */
+import type { ForgeEvent } from '../types/index.js';
+import type { DynamicNode } from './dynamic-node-types.js';
+export declare class CompletionDetector {
+    /**
+     * 第一层：精准检测 - 显式信号
+     * 检查 user_prompt 和 Bash 工具输出中的完成信号
+     */
+    detectExplicitSignal(event: ForgeEvent, signal: string): boolean;
+    /**
+     * 第一层：精准检测 - 关键词匹配
+     * 扩展检测范围：user_prompt + tool_input + tool_output
+     */
+    detectKeywords(event: ForgeEvent, keywords: string[]): boolean;
+    /**
+     * 第一层：精准检测 - 文件模式匹配
+     * 支持 Write/Edit 和 Bash 创建的文件
+     */
+    detectFilePatterns(event: ForgeEvent, patterns: string[]): boolean;
+    /**
+     * 第二层：智能推断 - 语义完成检测
+     * 检测用户输入中的完成语义
+     */
+    detectSemanticCompletion(event: ForgeEvent): boolean;
+    /**
+     * 第二层：智能推断 - 验证阶段模式
+     * 连续 Read 且无 Write/Edit = 可能在验证
+     */
+    detectVerificationPhase(recentEvents: ForgeEvent[]): boolean;
+    /**
+     * 第三层：强制保护 - 绝对超时
+     * 节点运行超过最大时间限制
+     */
+    checkAbsoluteTimeout(node: DynamicNode, maxMinutes?: number): boolean;
+    /**
+     * 第三层：强制保护 - 停滞检测
+     * 节点长时间无工具调用活动
+     */
+    checkStagnation(lastActivityAt: number | undefined, maxMinutes?: number): boolean;
+    /**
+     * 第三层：强制保护 - 产物停滞检测
+     * 节点长时间无新产物生成
+     */
+    checkArtifactStagnation(lastArtifactAt: number | undefined, maxMinutes?: number): boolean;
+    /**
+     * Glob 模式匹配（支持 * 和 ** 通配符）
+     */
+    private matchGlob;
+}
+//# sourceMappingURL=completion-detector.d.ts.map

package/dist/pipeline/completion-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-detector.d.ts","sourceRoot":"","sources":["../../src/pipeline/completion-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAsBhE;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAgB9D;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAgClE;;;OAGG;IACH,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAkBpD;;;OAGG;IACH,uBAAuB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO;IAgB5D;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO;IAezE;;;OAGG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO;IAcpF;;;OAGG;IACH,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO;IAc5F;;OAEG;IACH,OAAO,CAAC,SAAS;CAWlB"}

package/dist/pipeline/completion-detector.js

@@ -0,0 +1,179 @@
+/**
+ * CompletionDetector — 节点完成检测器
+ *
+ * 实现三层检测机制：
+ * 1. 精准检测：显式信号、关键词、文件模式
+ * 2. 智能推断：语义分析、行为模式识别
+ * 3. 强制保护：超时检测、停滞检测
+ */
+import { logger } from '../utils/logger.js';
+export class CompletionDetector {
+    /**
+     * 第一层：精准检测 - 显式信号
+     * 检查 user_prompt 和 Bash 工具输出中的完成信号
+     */
+    detectExplicitSignal(event, signal) {
+        const signalLower = signal.toLowerCase();
+        // 检查 user_prompt（新增）
+        const userPrompt = (event.user_prompt || '').toLowerCase();
+        if (userPrompt.includes(signalLower)) {
+            logger.info(`[CompletionDetector] 🔔 检测到 user_prompt 中的完成信号：${signal}`);
+            return true;
+        }
+        // 检查 Bash 输出（AI 通过 echo 发出信号时）
+        if (event.tool_name === 'Bash') {
+            const toolOutput = JSON.stringify(event.tool_output || '').toLowerCase();
+            if (toolOutput.includes(signalLower)) {
+                logger.info(`[CompletionDetector] 🔔 检测到 Bash 输出中的完成信号：${signal}`);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 第一层：精准检测 - 关键词匹配
+     * 扩展检测范围：user_prompt + tool_input + tool_output
+     */
+    detectKeywords(event, keywords) {
+        const searchText = [
+            event.user_prompt || '', // 新增：检查用户输入
+            JSON.stringify(event.tool_output || {}),
+            JSON.stringify(event.tool_input || {}),
+        ].join(' ').toLowerCase();
+        const matched = keywords.find(kw => searchText.includes(kw.toLowerCase()));
+        if (matched) {
+            logger.info(`[CompletionDetector] 🔑 检测到关键词匹配：${matched}`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 第一层：精准检测 - 文件模式匹配
+     * 支持 Write/Edit 和 Bash 创建的文件
+     */
+    detectFilePatterns(event, patterns) {
+        // 支持 Write/Edit
+        if (event.tool_name === 'Write' || event.tool_name === 'Edit') {
+            const filePath = event.tool_input?.file_path;
+            if (filePath && typeof filePath === 'string') {
+                const matched = patterns.some(p => this.matchGlob(filePath, p));
+                if (matched) {
+                    logger.info(`[CompletionDetector] 📁 检测到文件模式匹配（Write/Edit）：${filePath}`);
+                    return true;
+                }
+            }
+        }
+        // 支持 Bash 创建的文件（新增）
+        if (event.tool_name === 'Bash') {
+            const output = JSON.stringify(event.tool_output || '');
+            // 解析 Bash 输出中的文件路径（如 "Created file: src/test.ts"）
+            const fileMatches = output.match(/(?:created|wrote|generated|saved|writing)\s+(?:file:?\s+)?([^\s]+\.\w+)/gi);
+            if (fileMatches) {
+                for (const match of fileMatches) {
+                    const filePath = match.split(/\s+/).pop();
+                    if (filePath && patterns.some(p => this.matchGlob(filePath, p))) {
+                        logger.info(`[CompletionDetector] 📁 检测到文件模式匹配（Bash）：${filePath}`);
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * 第二层：智能推断 - 语义完成检测
+     * 检测用户输入中的完成语义
+     */
+    detectSemanticCompletion(event) {
+        const completionPhrases = [
+            '完成了', '好了', '搞定', '做完了', '已完成', '完工',
+            'done', 'finished', 'completed', 'ready',
+            '可以了', '没问题了', 'all set', 'good to go',
+            '结束了', 'over', 'end',
+        ];
+        const text = (event.user_prompt || '').toLowerCase();
+        const matched = completionPhrases.find(phrase => text.includes(phrase));
+        if (matched) {
+            logger.info(`[CompletionDetector] 💬 检测到语义完成信号：${matched}`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 第二层：智能推断 - 验证阶段模式
+     * 连续 Read 且无 Write/Edit = 可能在验证
+     */
+    detectVerificationPhase(recentEvents) {
+        if (recentEvents.length < 3)
+            return false;
+        const last3 = recentEvents.slice(-3);
+        const allReads = last3.every(e => e.tool_name === 'Read');
+        const last10 = recentEvents.slice(-10);
+        const noWrites = !last10.some(e => e.tool_name === 'Write' || e.tool_name === 'Edit');
+        if (allReads && noWrites) {
+            logger.info(`[CompletionDetector] 🔍 检测到验证阶段模式（连续 Read 无 Write）`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 第三层：强制保护 - 绝对超时
+     * 节点运行超过最大时间限制
+     */
+    checkAbsoluteTimeout(node, maxMinutes = 30) {
+        if (!node.startedAt)
+            return false;
+        const startTime = new Date(node.startedAt).getTime();
+        const elapsed = Date.now() - startTime;
+        const isTimeout = elapsed > maxMinutes * 60 * 1000;
+        if (isTimeout) {
+            const elapsedMin = Math.floor(elapsed / 60000);
+            logger.warn(`[CompletionDetector] ⏰ 节点绝对超时（${elapsedMin}/${maxMinutes} 分钟）`);
+        }
+        return isTimeout;
+    }
+    /**
+     * 第三层：强制保护 - 停滞检测
+     * 节点长时间无工具调用活动
+     */
+    checkStagnation(lastActivityAt, maxMinutes = 5) {
+        if (!lastActivityAt)
+            return false;
+        const elapsed = Date.now() - lastActivityAt;
+        const isStagnant = elapsed > maxMinutes * 60 * 1000;
+        if (isStagnant) {
+            const elapsedMin = Math.floor(elapsed / 60000);
+            logger.warn(`[CompletionDetector] 💤 节点停滞（${elapsedMin}/${maxMinutes} 分钟无活动）`);
+        }
+        return isStagnant;
+    }
+    /**
+     * 第三层：强制保护 - 产物停滞检测
+     * 节点长时间无新产物生成
+     */
+    checkArtifactStagnation(lastArtifactAt, maxMinutes = 5) {
+        if (!lastArtifactAt)
+            return false;
+        const elapsed = Date.now() - lastArtifactAt;
+        const isStagnant = elapsed > maxMinutes * 60 * 1000;
+        if (isStagnant) {
+            const elapsedMin = Math.floor(elapsed / 60000);
+            logger.warn(`[CompletionDetector] 📦 产物停滞（${elapsedMin}/${maxMinutes} 分钟无新产物）`);
+        }
+        return isStagnant;
+    }
+    /**
+     * Glob 模式匹配（支持 * 和 ** 通配符）
+     */
+    matchGlob(filePath, pattern) {
+        // 转义特殊字符
+        let regex = pattern
+            .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+            // ** 匹配任意路径
+            .replace(/\*\*/g, '.*')
+            // * 匹配单层路径
+            .replace(/\*/g, '[^/]*');
+        return new RegExp('^' + regex + '$').test(filePath);
+    }
+}
+//# sourceMappingURL=completion-detector.js.map

package/dist/pipeline/completion-detector.js.map

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

package/dist/pipeline/completion-engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CompletionEngine — 节点完成综合决策引擎
+ *
+ * 聚合所有检测层的结果，基于置信度综合决策是否推进节点。
+ */
+import type { ForgeEvent } from '../types/index.js';
+import type { DynamicNode } from './dynamic-node-types.js';
+import type { ConventionNodeType, Artifact } from '../convention/types.js';
+export interface CompletionDecision {
+    shouldAdvance: boolean;
+    confidence: number;
+    reasons: string[];
+    method: 'precise' | 'inferred' | 'forced';
+}
+export declare class CompletionEngine {
+    private detector;
+    private artifactValidator;
+    /**
+     * 综合决策：是否推进节点
+     *
+     * @param node - 当前节点
+     * @param nodeType - 节点类型定义
+     * @param event - 当前事件
+     * @param recentEvents - 最近的事件列表（用于模式识别）
+     * @param artifacts - 已收集的产物
+     * @param eventCount - 工具调用次数
+     * @param lastActivityAt - 最后活动时间戳
+     * @param lastArtifactAt - 最后产物生成时间戳
+     * @param complexity - Pipeline 复杂度
+     */
+    decide(node: DynamicNode, nodeType: ConventionNodeType, event: ForgeEvent, recentEvents: ForgeEvent[], artifacts: Artifact[], eventCount: number, lastActivityAt: number | undefined, lastArtifactAt: number | undefined, complexity?: 'simple' | 'moderate' | 'complex'): CompletionDecision;
+    /**
+     * 分类决策方法
+     */
+    private classifyMethod;
+}
+//# sourceMappingURL=completion-engine.d.ts.map

package/dist/pipeline/completion-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-engine.d.ts","sourceRoot":"","sources":["../../src/pipeline/completion-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAK3E,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC3C;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,iBAAiB,CAA2B;IAEpD;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,UAAU,EAAE,EAC1B,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAC7C,kBAAkB;IAsFrB;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/pipeline/completion-engine.js

@@ -0,0 +1,111 @@
+/**
+ * CompletionEngine — 节点完成综合决策引擎
+ *
+ * 聚合所有检测层的结果，基于置信度综合决策是否推进节点。
+ */
+import { CompletionDetector } from './completion-detector.js';
+import { ArtifactValidator } from './artifact-validator.js';
+import { logger } from '../utils/logger.js';
+export class CompletionEngine {
+    detector = new CompletionDetector();
+    artifactValidator = new ArtifactValidator();
+    /**
+     * 综合决策：是否推进节点
+     *
+     * @param node - 当前节点
+     * @param nodeType - 节点类型定义
+     * @param event - 当前事件
+     * @param recentEvents - 最近的事件列表（用于模式识别）
+     * @param artifacts - 已收集的产物
+     * @param eventCount - 工具调用次数
+     * @param lastActivityAt - 最后活动时间戳
+     * @param lastArtifactAt - 最后产物生成时间戳
+     * @param complexity - Pipeline 复杂度
+     */
+    decide(node, nodeType, event, recentEvents, artifacts, eventCount, lastActivityAt, lastArtifactAt, complexity) {
+        const reasons = [];
+        let confidence = 0; // 0-100
+        // 第一层：精准检测
+        if (nodeType.completion.explicit_signal) {
+            if (this.detector.detectExplicitSignal(event, nodeType.completion.explicit_signal)) {
+                reasons.push('显式信号');
+                confidence += 40;
+            }
+        }
+        if (nodeType.completion.heuristic?.keywords) {
+            if (this.detector.detectKeywords(event, nodeType.completion.heuristic.keywords)) {
+                reasons.push('关键词匹配');
+                confidence += 30;
+            }
+        }
+        if (nodeType.completion.heuristic?.file_patterns) {
+            if (this.detector.detectFilePatterns(event, nodeType.completion.heuristic.file_patterns)) {
+                reasons.push('文件模式匹配');
+                confidence += 25;
+            }
+        }
+        // 产物完整性
+        if (nodeType.expected_artifacts) {
+            const validation = this.artifactValidator.validate(artifacts, nodeType.expected_artifacts, complexity);
+            if (validation.passed) {
+                reasons.push('产物完整');
+                confidence += 30;
+            }
+        }
+        // 第二层：智能推断
+        if (this.detector.detectSemanticCompletion(event)) {
+            reasons.push('语义完成信号');
+            confidence += 20;
+        }
+        if (this.detector.detectVerificationPhase(recentEvents)) {
+            reasons.push('验证阶段模式');
+            confidence += 15;
+        }
+        // 第三层：强制保护
+        if (this.detector.checkAbsoluteTimeout(node, 30)) {
+            reasons.push('绝对超时（30 分钟）');
+            confidence = 100; // 强制完成
+        }
+        if (this.detector.checkStagnation(lastActivityAt, 5)) {
+            reasons.push('停滞超时（5 分钟无活动）');
+            confidence += 50;
+        }
+        if (this.detector.checkArtifactStagnation(lastArtifactAt, 5)) {
+            reasons.push('产物停滞（5 分钟无新产物）');
+            confidence += 30;
+        }
+        // 活动阈值
+        const threshold = nodeType.activity_threshold.min_tool_calls;
+        if (eventCount >= threshold) {
+            reasons.push(`活动阈值（${eventCount}/${threshold}）`);
+            confidence += 40;
+        }
+        // 决策：confidence >= 60 即推进
+        const shouldAdvance = confidence >= 60;
+        if (shouldAdvance) {
+            logger.info(`[CompletionEngine] ✅ 决策推进（置信度 ${confidence}%）：${reasons.join('、')}`);
+        }
+        else {
+            logger.debug(`[CompletionEngine] ⏸️  决策不推进（置信度 ${confidence}%）：${reasons.join('、')}`);
+        }
+        return {
+            shouldAdvance,
+            confidence,
+            reasons,
+            method: this.classifyMethod(reasons),
+        };
+    }
+    /**
+     * 分类决策方法
+     */
+    classifyMethod(reasons) {
+        if (reasons.some(r => r.includes('显式信号') || r.includes('产物完整'))) {
+            return 'precise';
+        }
+        if (reasons.some(r => r.includes('超时') || r.includes('阈值'))) {
+            return 'forced';
+        }
+        return 'inferred';
+    }
+}
+//# sourceMappingURL=completion-engine.js.map

package/dist/pipeline/completion-engine.js.map

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

package/dist/pipeline/dynamic-node-executor.d.ts

@@ -20,9 +20,17 @@ export declare class DynamicNodeExecutor implements INodeExecutor {
     private recentTools;
     /** 产物重试次数（key = pipelineId:nodeId） */
     private artifactRetryCount;
+    /** 最后活动时间戳（key = pipelineId:nodeId） */
+    private lastActivityAt;
+    /** 最后产物生成时间戳（key = pipelineId:nodeId） */
+    private lastArtifactAt;
+    /** 最近事件列表（key = pipelineId:nodeId，保留最近 10 条） */
+    private recentEvents;
     private static readonly MAX_ARTIFACT_RETRIES;
+    private static readonly MAX_RECENT_EVENTS;
     private artifactCollector;
     private artifactValidator;
+    private completionEngine;
     /**
      * 获取当前节点的指令
      */
@@ -55,20 +63,6 @@ export declare class DynamicNodeExecutor implements INodeExecutor {
      * 追踪工具调用
      */
     private trackToolCall;
-    /**
-     * 检查节点完成条件
-     */
-    private checkCompletion;
-    /**
-     * 检查文件模式匹配
-     * 从 Write/Edit 工具调用中提取文件路径，检查是否匹配 file_patterns
-     */
-    private checkFilePatterns;
-    /**
-     * 检查关键词匹配
-     * 只检查工具调用的输入/输出内容，不检查 user_prompt（避免因用户提问包含关键词而误判完成）
-     */
-    private checkKeywords;
     /**
      * 获取下一个节点 ID
      */

package/dist/pipeline/dynamic-node-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-node-executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/dynamic-node-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAS/D,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,aAAa,CAAoH;IACzI,OAAO,CAAC,eAAe,CAAsH;IAC7I,OAAO,CAAC,eAAe,CAAsH;IAC7I,OAAO,CAAC,mBAAmB,CAA0H;IACrJ,OAAO,CAAC,WAAW,CAAwH;IAC3I,sCAAsC;IACtC,OAAO,CAAC,kBAAkB,CAAwH;IAClJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAEjD,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,iBAAiB,CAA2B;IAEpD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAqBjD;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,OAAO,CAAC,aAAa,CAAC;IA+EzB;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBjC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAkBzD;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAW3C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE;IAoBvD;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}
+{"version":3,"file":"dynamic-node-executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/dynamic-node-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAU/D,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,aAAa,CAAoH;IACzI,OAAO,CAAC,eAAe,CAAsH;IAC7I,OAAO,CAAC,eAAe,CAAsH;IAC7I,OAAO,CAAC,mBAAmB,CAA0H;IACrJ,OAAO,CAAC,WAAW,CAAwH;IAC3I,sCAAsC;IACtC,OAAO,CAAC,kBAAkB,CAAwH;IAClJ,uCAAuC;IACvC,OAAO,CAAC,cAAc,CAAuH;IAC7I,yCAAyC;IACzC,OAAO,CAAC,cAAc,CAAuH;IAC7I,gDAAgD;IAChD,OAAO,CAAC,YAAY,CAA6H;IACjJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAM;IAE/C,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,gBAAgB,CAA0B;IAElD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAmCjD;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,OAAO,CAAC,aAAa,CAAC;IAyFzB;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBjC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAkBzD;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAW3C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE;IAoBvD;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}