@windagency/valora 2.0.1

package/dist/executor/escalation-detection.service.js

@@ -0,0 +1,219 @@
+/**
+ * Escalation Detection Service
+ *
+ * Parses LLM responses for escalation signals embedded as JSON blocks.
+ * Evaluates whether escalation should be triggered based on the signal
+ * and configured thresholds.
+ */
+import { getLogger } from '../output/logger.js';
+import { DEFAULT_ESCALATION_CONFIG } from '../types/escalation.types.js';
+/**
+ * Regex pattern to match the _escalation JSON block in LLM responses
+ * Matches both fenced code blocks and raw JSON objects containing _escalation
+ */
+const ESCALATION_BLOCK_PATTERN = /```(?:json)?\s*\n?\s*(\{[\s\S]*?"_escalation"[\s\S]*?\})\s*\n?```|(\{[\s\S]*?"_escalation"[\s\S]*?\})/;
+/**
+ * Alternative pattern for standalone _escalation object
+ */
+const ESCALATION_OBJECT_PATTERN = /"_escalation"\s*:\s*(\{[\s\S]*?\})\s*\}?\s*$/;
+export class EscalationDetectionService {
+    config;
+    logger = getLogger();
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_ESCALATION_CONFIG, ...config };
+    }
+    /**
+     * Parse LLM response content for escalation signal
+     * Returns the extracted signal and cleaned content
+     */
+    parseResponse(content) {
+        this.logger.debug('Parsing response for escalation signal', {
+            contentLength: content.length
+        });
+        try {
+            // Try to find escalation block using various patterns
+            const signal = this.extractEscalationSignal(content);
+            if (!signal) {
+                this.logger.debug('No escalation signal found in response');
+                return {
+                    cleanedContent: content,
+                    signal: null
+                };
+            }
+            // Remove the escalation block from content
+            const cleanedContent = this.removeEscalationBlock(content);
+            this.logger.debug('Extracted escalation signal', {
+                confidence: signal.confidence,
+                requiresEscalation: signal.requires_escalation,
+                riskLevel: signal.risk_level,
+                triggeredCriteria: signal.triggered_criteria.length
+            });
+            return {
+                cleanedContent,
+                signal
+            };
+        }
+        catch (error) {
+            this.logger.warn('Failed to parse escalation signal', {
+                error: error.message
+            });
+            return {
+                cleanedContent: content,
+                parseError: error.message,
+                signal: null
+            };
+        }
+    }
+    /**
+     * Evaluate if escalation should be triggered based on signal and config
+     */
+    shouldTriggerEscalation(signal) {
+        if (!signal) {
+            return false;
+        }
+        // Explicit escalation request from LLM
+        if (signal.requires_escalation) {
+            this.logger.debug('Escalation triggered: LLM explicitly requested escalation');
+            return true;
+        }
+        // Confidence below threshold
+        if (signal.confidence < this.config.confidenceThreshold) {
+            this.logger.debug('Escalation triggered: Confidence below threshold', {
+                confidence: signal.confidence,
+                threshold: this.config.confidenceThreshold
+            });
+            return true;
+        }
+        // High-risk levels should trigger escalation
+        if (this.isHighRisk(signal.risk_level)) {
+            this.logger.debug('Escalation triggered: High risk level', {
+                riskLevel: signal.risk_level
+            });
+            return true;
+        }
+        // Any triggered criteria means escalation
+        if (signal.triggered_criteria.length > 0) {
+            this.logger.debug('Escalation triggered: Criteria matched', {
+                triggeredCriteria: signal.triggered_criteria
+            });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Extract escalation signal from content
+     */
+    extractEscalationSignal(content) {
+        // Try full block pattern first (including wrapper object)
+        const blockMatch = content.match(ESCALATION_BLOCK_PATTERN);
+        if (blockMatch) {
+            const jsonStr = blockMatch[1] ?? blockMatch[2];
+            if (jsonStr) {
+                return this.parseEscalationJson(jsonStr);
+            }
+        }
+        // Try standalone _escalation object pattern
+        const objectMatch = content.match(ESCALATION_OBJECT_PATTERN);
+        if (objectMatch) {
+            return this.parseEscalationJson(`{"_escalation": ${objectMatch[1]}}`);
+        }
+        // Try to find any JSON block containing _escalation
+        const jsonBlocks = this.findJsonBlocks(content);
+        for (const block of jsonBlocks) {
+            if (block.includes('_escalation')) {
+                const signal = this.parseEscalationJson(block);
+                if (signal) {
+                    return signal;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Parse JSON string to extract EscalationSignal
+     */
+    parseEscalationJson(jsonStr) {
+        try {
+            const parsed = JSON.parse(jsonStr);
+            // Handle both { _escalation: {...} } and direct signal object
+            const signalData = (parsed['_escalation'] ?? parsed);
+            // Validate required fields
+            if (typeof signalData['requires_escalation'] !== 'boolean') {
+                return null;
+            }
+            return {
+                confidence: typeof signalData['confidence'] === 'number' ? signalData['confidence'] : 50,
+                proposed_action: typeof signalData['proposed_action'] === 'string' ? signalData['proposed_action'] : '',
+                reasoning: typeof signalData['reasoning'] === 'string' ? signalData['reasoning'] : '',
+                requires_escalation: signalData['requires_escalation'],
+                risk_level: this.parseRiskLevel(signalData['risk_level']),
+                triggered_criteria: Array.isArray(signalData['triggered_criteria'])
+                    ? signalData['triggered_criteria']
+                    : []
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parse and validate risk level
+     */
+    parseRiskLevel(value) {
+        const validLevels = ['low', 'medium', 'high', 'critical'];
+        if (typeof value === 'string' && validLevels.includes(value)) {
+            return value;
+        }
+        return 'medium';
+    }
+    /**
+     * Check if risk level is considered high
+     */
+    isHighRisk(riskLevel) {
+        return riskLevel === 'high' || riskLevel === 'critical';
+    }
+    /**
+     * Remove escalation block from content
+     */
+    removeEscalationBlock(content) {
+        // Remove fenced code block containing _escalation
+        let cleaned = content.replace(/```(?:json)?\s*\n?\s*\{[\s\S]*?"_escalation"[\s\S]*?\}\s*\n?```/g, '');
+        // Remove trailing raw JSON block with _escalation
+        cleaned = cleaned.replace(/\{[\s\S]*?"_escalation"[\s\S]*?\}\s*$/g, '');
+        // Clean up excess whitespace
+        cleaned = cleaned.replace(/\n{3,}/g, '\n\n').trim();
+        return cleaned;
+    }
+    /**
+     * Find all JSON blocks in content
+     */
+    findJsonBlocks(content) {
+        const blocks = [];
+        // Find fenced code blocks
+        const fencedPattern = /```(?:json)?\s*\n?([\s\S]*?)\n?```/g;
+        let match;
+        while ((match = fencedPattern.exec(content)) !== null) {
+            const innerContent = match[1];
+            if (innerContent?.trim().startsWith('{')) {
+                blocks.push(innerContent.trim());
+            }
+        }
+        // Find trailing JSON object
+        const trailingMatch = content.match(/\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}\s*$/);
+        if (trailingMatch) {
+            blocks.push(trailingMatch[0]);
+        }
+        return blocks;
+    }
+}
+/**
+ * Singleton instance
+ */
+let serviceInstance = null;
+export function getEscalationDetectionService(config) {
+    if (!serviceInstance || config) {
+        serviceInstance = new EscalationDetectionService(config);
+    }
+    return serviceInstance;
+}
+//# sourceMappingURL=escalation-detection.service.js.map

package/dist/executor/escalation-detection.service.js.map

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

package/dist/executor/escalation-handler.service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Escalation Handler Service
+ *
+ * Interactive handler for human confirmation when escalation is triggered.
+ * Displays escalation information and prompts for user decision.
+ * Follows the DocumentApprovalWorkflow pattern for consistent UX.
+ */
+import type { EscalationContext, EscalationResult } from '../types/escalation.types.js';
+export declare class EscalationHandlerService {
+    private readonly color;
+    private readonly console;
+    private readonly logger;
+    private readonly promptAdapter;
+    private readonly renderer;
+    /**
+     * Handle an escalation by displaying info and prompting for decision
+     */
+    handleEscalation(context: EscalationContext): Promise<EscalationResult>;
+    /**
+     * Display formatted escalation information
+     */
+    private displayEscalationInfo;
+    /**
+     * Get color function for risk level
+     */
+    private getRiskColor;
+    /**
+     * Format confidence with color
+     */
+    private formatConfidence;
+    /**
+     * Prompt user for escalation decision
+     */
+    private promptForDecision;
+    /**
+     * Process the user's decision and return result
+     */
+    private processDecision;
+    /**
+     * Display proceed confirmation message
+     */
+    private displayProceedMessage;
+    /**
+     * Display modify message with guidance
+     */
+    private displayModifyMessage;
+    /**
+     * Display abort message
+     */
+    private displayAbortMessage;
+    /**
+     * Display escalation summary for logging/events
+     */
+    displayEscalationSummary(context: EscalationContext, result: EscalationResult): void;
+}
+export declare function getEscalationHandlerService(): EscalationHandlerService;
+//# sourceMappingURL=escalation-handler.service.d.ts.map

package/dist/executor/escalation-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-handler.service.d.ts","sourceRoot":"","sources":["../../src/executor/escalation-handler.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,iBAAiB,EAGjB,gBAAgB,EAEhB,MAAM,wBAAwB,CAAC;AAmBhC,qBAAa,wBAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB7E;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2C7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;YACW,iBAAiB;IAsD/B;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;CAoBpF;AAOD,wBAAgB,2BAA2B,IAAI,wBAAwB,CAGtE"}

package/dist/executor/escalation-handler.service.js

@@ -0,0 +1,265 @@
+/**
+ * Escalation Handler Service
+ *
+ * Interactive handler for human confirmation when escalation is triggered.
+ * Displays escalation information and prompts for user decision.
+ * Follows the DocumentApprovalWorkflow pattern for consistent UX.
+ */
+import { HIGH_CONFIDENCE_THRESHOLD, MEDIUM_CONFIDENCE_THRESHOLD } from '../config/constants.js';
+import { getColorAdapter } from '../output/color-adapter.interface.js';
+import { getConsoleOutput } from '../output/console-output.js';
+import { getLogger } from '../output/logger.js';
+import { getRenderer } from '../output/markdown.js';
+import { getPromptAdapter } from '../ui/prompt-adapter.interface.js';
+/**
+ * Risk level display colors and icons
+ */
+const RISK_DISPLAY = {
+    critical: { color: 'red', icon: '!!!' },
+    high: { color: 'red', icon: '!!' },
+    low: { color: 'green', icon: '-' },
+    medium: { color: 'yellow', icon: '!' }
+};
+export class EscalationHandlerService {
+    color = getColorAdapter();
+    console = getConsoleOutput();
+    logger = getLogger();
+    promptAdapter = getPromptAdapter();
+    renderer = getRenderer();
+    /**
+     * Handle an escalation by displaying info and prompting for decision
+     */
+    async handleEscalation(context) {
+        this.logger.debug('Handling escalation', {
+            agentRole: context.agentRole,
+            riskLevel: context.signal.risk_level,
+            stageName: context.stageName,
+            triggeredCriteria: context.signal.triggered_criteria.length
+        });
+        // Display escalation information
+        this.displayEscalationInfo(context);
+        // Prompt for user decision
+        const decision = await this.promptForDecision(context);
+        // Handle the decision
+        return this.processDecision(decision, context);
+    }
+    /**
+     * Display formatted escalation information
+     */
+    displayEscalationInfo(context) {
+        const { agentRole, escalationCriteria, signal, stageName } = context;
+        const riskDisplay = RISK_DISPLAY[signal.risk_level];
+        // Format risk level with appropriate color
+        const riskColor = this.getRiskColor(signal.risk_level);
+        const formattedRisk = riskColor(`[${riskDisplay.icon}] ${signal.risk_level.toUpperCase()}`);
+        // Format triggered criteria
+        const triggeredList = signal.triggered_criteria.length > 0
+            ? signal.triggered_criteria.map((c) => `  ${this.color.yellow('*')} ${c}`)
+            : [`  ${this.color.gray('(none)')}`];
+        // Format configured criteria
+        const configuredList = escalationCriteria.map((c) => `  - ${c}`);
+        this.console.blank();
+        this.console.print(this.renderer.box('Human Review Required', 'ESCALATION'));
+        this.console.blank();
+        this.console.divider();
+        this.console.labelValue('Stage', stageName);
+        this.console.labelValue('Agent', agentRole);
+        this.console.labelValue('Risk Level', formattedRisk);
+        this.console.labelValue('Confidence', this.formatConfidence(signal.confidence));
+        this.console.divider();
+        this.console.blank();
+        this.console.bold('Triggered Criteria:');
+        triggeredList.forEach((item) => this.console.print(item));
+        this.console.blank();
+        this.console.bold('Reasoning:');
+        this.console.print(`  ${signal.reasoning || this.color.gray('(no reasoning provided)')}`);
+        this.console.blank();
+        this.console.bold('Proposed Action:');
+        this.console.print(`  ${signal.proposed_action || this.color.gray('(no action specified)')}`);
+        this.console.blank();
+        this.console.divider();
+        this.console.dim('Configured Escalation Criteria for this agent:');
+        configuredList.forEach((item) => this.console.print(item));
+        this.console.divider();
+        this.console.blank();
+    }
+    /**
+     * Get color function for risk level
+     */
+    getRiskColor(riskLevel) {
+        const riskColors = {
+            critical: this.color.red.bind(this.color),
+            high: this.color.red.bind(this.color),
+            low: this.color.green.bind(this.color),
+            medium: this.color.yellow.bind(this.color)
+        };
+        return riskColors[riskLevel] ?? this.color.gray.bind(this.color);
+    }
+    /**
+     * Format confidence with color
+     */
+    formatConfidence(confidence) {
+        const formatted = `${confidence}%`;
+        if (confidence >= HIGH_CONFIDENCE_THRESHOLD) {
+            return this.color.green(formatted);
+        }
+        if (confidence >= MEDIUM_CONFIDENCE_THRESHOLD) {
+            return this.color.yellow(formatted);
+        }
+        return this.color.red(formatted);
+    }
+    /**
+     * Prompt user for escalation decision
+     */
+    async promptForDecision(_context) {
+        const answers = await this.promptAdapter.prompt([
+            {
+                choices: [
+                    {
+                        name: 'Proceed - Continue with the proposed action',
+                        value: 'proceed'
+                    },
+                    {
+                        name: 'Modify - Provide additional guidance and retry',
+                        value: 'modify'
+                    },
+                    {
+                        name: 'Abort - Stop execution and cancel the pipeline',
+                        value: 'abort'
+                    }
+                ],
+                default: 'proceed',
+                message: 'How would you like to proceed?',
+                name: 'decision',
+                type: 'list'
+            }
+        ]);
+        const decisionType = answers['decision'];
+        let guidance;
+        // If user chooses to modify, ask for guidance
+        if (decisionType === 'modify') {
+            const guidanceAnswers = await this.promptAdapter.prompt([
+                {
+                    default: '',
+                    message: 'Enter additional guidance for the agent:',
+                    name: 'guidance',
+                    type: 'input',
+                    validate: (input) => {
+                        if (typeof input === 'string' && input.trim().length > 0) {
+                            return true;
+                        }
+                        return 'Please provide guidance for the modification';
+                    }
+                }
+            ]);
+            guidance = guidanceAnswers['guidance'];
+        }
+        return {
+            decision: decisionType,
+            guidance,
+            timestamp: Date.now()
+        };
+    }
+    /**
+     * Process the user's decision and return result
+     */
+    processDecision(decision, _context) {
+        switch (decision.decision) {
+            case 'abort':
+                this.displayAbortMessage();
+                return {
+                    decision,
+                    handled: true,
+                    shouldAbort: true,
+                    shouldProceed: false
+                };
+            case 'modify':
+                this.displayModifyMessage(decision.guidance);
+                return {
+                    decision,
+                    handled: true,
+                    modifiedGuidance: decision.guidance,
+                    shouldAbort: false,
+                    shouldProceed: false
+                };
+            case 'proceed':
+                this.displayProceedMessage();
+                return {
+                    decision,
+                    handled: true,
+                    shouldAbort: false,
+                    shouldProceed: true
+                };
+            default:
+                // Fallback to abort for safety
+                this.logger.warn('Unknown escalation decision, defaulting to abort', {
+                    decision: decision.decision
+                });
+                return {
+                    decision: { ...decision, decision: 'abort' },
+                    handled: true,
+                    shouldAbort: true,
+                    shouldProceed: false
+                };
+        }
+    }
+    /**
+     * Display proceed confirmation message
+     */
+    displayProceedMessage() {
+        this.console.blank();
+        this.console.success('Proceeding with proposed action...');
+        this.console.blank();
+    }
+    /**
+     * Display modify message with guidance
+     */
+    displayModifyMessage(guidance) {
+        this.console.blank();
+        this.console.info('Modification requested with guidance:');
+        this.console.print(`  ${guidance}`);
+        this.console.blank();
+        this.console.dim('The stage will be re-executed with the provided guidance.');
+        this.console.blank();
+    }
+    /**
+     * Display abort message
+     */
+    displayAbortMessage() {
+        this.console.blank();
+        this.console.error('Pipeline execution aborted by user.');
+        this.console.blank();
+        this.console.dim('No further stages will be executed.');
+        this.console.blank();
+    }
+    /**
+     * Display escalation summary for logging/events
+     */
+    displayEscalationSummary(context, result) {
+        const { signal, stageName } = context;
+        const { decision } = result;
+        const decisionDisplay = {
+            abort: this.color.red('ABORTED'),
+            modify: this.color.cyan('MODIFIED'),
+            proceed: this.color.green('PROCEEDED')
+        }[decision.decision];
+        this.console.blank();
+        this.console.divider(40);
+        this.console.bold('Escalation Summary:');
+        this.console.print(`  Stage: ${stageName}`);
+        this.console.print(`  Risk: ${signal.risk_level}`);
+        this.console.print(`  Decision: ${decisionDisplay}`);
+        this.console.print(`  Time: ${new Date(decision.timestamp).toISOString()}`);
+        this.console.divider(40);
+        this.console.blank();
+    }
+}
+/**
+ * Singleton instance
+ */
+let serviceInstance = null;
+export function getEscalationHandlerService() {
+    serviceInstance ??= new EscalationHandlerService();
+    return serviceInstance;
+}
+//# sourceMappingURL=escalation-handler.service.js.map

package/dist/executor/escalation-handler.service.js.map

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

package/dist/executor/execution-context.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Execution Context - Manages shared state between pipeline execution and variable resolution
+ *
+ * Separates concerns between:
+ * - PipelineExecutor: Orchestrates stage execution (Command)
+ * - VariableResolver: Resolves variables (Query)
+ * - ExecutionContext: Manages shared state and coordination
+ *
+ * This implements Command Query Separation by ensuring:
+ * - Commands (execution) don't perform queries (resolution)
+ * - Queries (resolution) don't modify state
+ * - State management is centralized in the context
+ */
+import type { AllowedTool, IsolatedExecutionOptions, StageOutput } from '../types/command.types.js';
+import type { LLMProvider } from '../types/llm.types.js';
+import { VariableResolutionService } from './variable-resolution.service.js';
+/**
+ * Session information for tracking execution mode
+ */
+export interface ExecutionContextOptions {
+    agentRole: string;
+    allowedTools?: AllowedTool[];
+    args: string[];
+    commandName: string;
+    flags: Record<string, boolean | string | undefined>;
+    initialStageOutputs?: Record<string, Record<string, unknown>>;
+    interactive?: boolean;
+    isolation?: IsolatedExecutionOptions;
+    /**
+     * Knowledge files to load from knowledge-base/ directory.
+     * These are command-specific and loaded selectively to save tokens.
+     */
+    knowledgeFiles?: string[];
+    mode?: string;
+    model?: string;
+    provider: LLMProvider;
+    sessionContext?: Record<string, unknown>;
+    /**
+     * Session information for tracking execution mode (live vs resumed)
+     */
+    sessionInfo?: SessionInfo;
+}
+export interface SessionInfo {
+    /** Whether this is a resumed session (vs newly created) */
+    isResumed: boolean;
+    /** The session ID */
+    sessionId: string;
+}
+/**
+ * Execution Context - Coordinates between pipeline execution and variable resolution
+ *
+ * Responsible for:
+ * - Maintaining execution state (stages, context, resolver)
+ * - Coordinating between PipelineExecutor and VariableResolver
+ * - Providing clean interfaces for both query and command operations
+ */
+export declare class ExecutionContext {
+    readonly agentRole: string;
+    readonly allowedTools?: AllowedTool[];
+    readonly args: string[];
+    readonly commandName: string;
+    readonly flags: Record<string, boolean | string | undefined>;
+    readonly interactive?: boolean;
+    readonly isolation?: IsolatedExecutionOptions;
+    readonly knowledgeFiles?: string[];
+    readonly mode?: string;
+    readonly model?: string;
+    readonly provider: LLMProvider;
+    readonly sessionInfo?: SessionInfo;
+    stages: Record<string, Record<string, unknown>>;
+    private completedStages;
+    private stageOutputs;
+    private variableResolutionService;
+    constructor(options: ExecutionContextOptions, variableResolutionService?: VariableResolutionService);
+    /**
+     * Get the variable resolution service for query operations
+     * This allows stages to resolve variables without modifying state
+     */
+    getVariableResolver(): VariableResolutionService;
+    /**
+     * Record a completed stage and update variable resolution context
+     * This is the command operation that modifies state
+     */
+    recordStageCompletion(stageOutput: StageOutput): void;
+    /**
+     * Get all stage outputs
+     */
+    getStageOutputs(): StageOutput[];
+    /**
+     * Check if a stage has been completed successfully
+     */
+    isStageCompleted(stageName: string): boolean;
+    /**
+     * Get execution summary
+     */
+    getExecutionSummary(): unknown;
+    /**
+     * Validate that all stage dependencies are satisfied
+     * This is a query operation that checks state without modifying it
+     */
+    validateStageDependencies(stageInputs?: Record<string, unknown>): string[];
+    /**
+     * Create the initial variable resolution service with context
+     */
+    private createVariableResolutionService;
+}
+//# sourceMappingURL=execution-context.d.ts.map