@uluops/core 0.5.0

package/dist/executor/WorkflowExecutor.d.ts

@@ -0,0 +1,55 @@
+import type { CommandExecutor } from './CommandExecutor.js';
+import type { RegistryClient } from '../registry/RegistryClient.js';
+import type { ResolvedDefinition } from '../types/registry.js';
+import type { WorkflowResult } from '../types/workflow.js';
+import type { ExecutionInput } from '../types/execution.js';
+/**
+ * Executes workflows as quality-gated directed acyclic graphs.
+ *
+ * Phases are topologically sorted into execution levels based on declared
+ * dependencies. Independent phases (those in the same topological level)
+ * execute in parallel. Quality gates evaluate continuous AI judgment scores
+ * against declared thresholds, with four distinct failure behaviors:
+ *
+ * - stop:  do not start subsequent levels; let running phases finish
+ * - abort: cancel running phases immediately; skip all remaining
+ * - continue: proceed past failure; dependent phases still check deps
+ * - warn:  proceed with warning annotation; no blocking
+ */
+export declare class WorkflowExecutor {
+    private commandExecutor;
+    private registry;
+    constructor(commandExecutor: CommandExecutor, registry: RegistryClient);
+    /**
+     * Execute a workflow with DAG-based phase orchestration.
+     *
+     * Phases are grouped into topological levels. All phases in a level
+     * whose dependencies are satisfied execute in parallel. Gate evaluation
+     * occurs after each phase completes, and failure behavior determines
+     * whether subsequent levels proceed.
+     */
+    execute(resolved: ResolvedDefinition, input: ExecutionInput): Promise<WorkflowResult>;
+    /**
+     * Execute a set of independent phases in parallel.
+     *
+     * Respects max_parallel concurrency limit if set. Uses Promise.allSettled
+     * to ensure partial failures don't reject the entire level.
+     */
+    private executePhasesParallel;
+    /**
+     * Execute phases with a concurrency semaphore.
+     */
+    private executePhasesWithLimit;
+    private executePhase;
+    private executeCommand;
+    private aggregatePhaseScore;
+    private evaluateGate;
+    private aggregate;
+    private createBlockedPhase;
+    private createSkippedPhase;
+    private checkDependencies;
+    private evaluateCondition;
+    private deduplicateRecommendations;
+    private buildPartialResult;
+}
+//# sourceMappingURL=WorkflowExecutor.d.ts.map

package/dist/executor/WorkflowExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/WorkflowExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAsB,cAAc,EAAgC,MAAM,sBAAsB,CAAC;AAE7G,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,uBAAuB,CAAC;AAM5E;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;gBADR,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,cAAc;IAGlC;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA2I3F;;;;;OAKG;YACW,qBAAqB;IAiCnC;;OAEG;YACW,sBAAsB;YAyBtB,YAAY;YA4DZ,cAAc;IAK5B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAiCjB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/executor/WorkflowExecutor.js

@@ -0,0 +1,368 @@
+import { WorkflowError } from '../errors/index.js';
+import { formatErrorMessage } from '../utils/formatError.js';
+import { sumTokenMetrics } from '../utils/sumTokenMetrics.js';
+import { topoGroupLevels } from '../utils/topoSort.js';
+/**
+ * Executes workflows as quality-gated directed acyclic graphs.
+ *
+ * Phases are topologically sorted into execution levels based on declared
+ * dependencies. Independent phases (those in the same topological level)
+ * execute in parallel. Quality gates evaluate continuous AI judgment scores
+ * against declared thresholds, with four distinct failure behaviors:
+ *
+ * - stop:  do not start subsequent levels; let running phases finish
+ * - abort: cancel running phases immediately; skip all remaining
+ * - continue: proceed past failure; dependent phases still check deps
+ * - warn:  proceed with warning annotation; no blocking
+ */
+export class WorkflowExecutor {
+    commandExecutor;
+    registry;
+    constructor(commandExecutor, registry) {
+        this.commandExecutor = commandExecutor;
+        this.registry = registry;
+    }
+    /**
+     * Execute a workflow with DAG-based phase orchestration.
+     *
+     * Phases are grouped into topological levels. All phases in a level
+     * whose dependencies are satisfied execute in parallel. Gate evaluation
+     * occurs after each phase completes, and failure behavior determines
+     * whether subsequent levels proceed.
+     */
+    async execute(resolved, input) {
+        const startTime = Date.now();
+        if (resolved.type !== 'workflow') {
+            throw new WorkflowError(`WorkflowExecutor received a '${resolved.type}' definition (expected 'workflow')`, { partialResult: undefined });
+        }
+        const def = resolved.definition;
+        const phaseResults = [];
+        const allRecommendations = [];
+        const completedPhases = new Map();
+        try {
+            const levels = topoGroupLevels(def.workflow.orchestration.phases);
+            const onFailure = def.workflow.orchestration.on_failure;
+            const maxParallel = def.workflow.orchestration.max_parallel;
+            let stopped = false;
+            let aborted = false;
+            for (const level of levels) {
+                if (stopped || aborted) {
+                    // Mark remaining phases as skipped
+                    for (const phase of level) {
+                        const skipped = this.createSkippedPhase(phase);
+                        phaseResults.push(skipped);
+                        completedPhases.set(phase.id, skipped);
+                    }
+                    continue;
+                }
+                // Filter level to phases whose dependencies are satisfied and skip_if is not met
+                const eligible = [];
+                for (const phase of level) {
+                    if (phase.skip_if && this.evaluateCondition(phase.skip_if, input, phaseResults)) {
+                        const skipped = this.createSkippedPhase(phase);
+                        phaseResults.push(skipped);
+                        completedPhases.set(phase.id, skipped);
+                        continue;
+                    }
+                    if (!this.checkDependencies(phase.depends_on, completedPhases)) {
+                        const skipped = this.createSkippedPhase(phase);
+                        phaseResults.push(skipped);
+                        completedPhases.set(phase.id, skipped);
+                        continue;
+                    }
+                    eligible.push(phase);
+                }
+                if (eligible.length === 0)
+                    continue;
+                // Execute eligible phases in parallel (with optional concurrency limit)
+                const levelResults = await this.executePhasesParallel(eligible, input, maxParallel);
+                // Process results and evaluate gates
+                for (const phaseResult of levelResults) {
+                    phaseResults.push(phaseResult);
+                    completedPhases.set(phaseResult.id, phaseResult);
+                    // Accumulate recommendations
+                    for (const cmd of phaseResult.commands) {
+                        allRecommendations.push(...cmd.recommendations);
+                    }
+                    // Apply failure behavior based on gate result
+                    if (phaseResult.decision === 'blocked') {
+                        switch (onFailure) {
+                            case 'stop':
+                                stopped = true;
+                                break;
+                            case 'abort':
+                                aborted = true;
+                                break;
+                            case 'warn':
+                                // Downgrade to warned — proceed without blocking
+                                phaseResult.decision = 'warned';
+                                break;
+                            case 'continue':
+                            default:
+                                // Continue — dependent phases will check deps naturally
+                                break;
+                        }
+                    }
+                }
+                // For abort: mark any phases from this level that haven't completed
+                // (in practice all completed since we awaited, but semantically distinct
+                // from stop in that we don't start the next level either)
+                if (aborted) {
+                    // Remaining levels will be skipped in the next iteration
+                    continue;
+                }
+            }
+        }
+        catch (error) {
+            throw new WorkflowError(`Workflow failed: ${formatErrorMessage(error)}`, { partialResult: this.buildPartialResult(def, phaseResults, allRecommendations, startTime, resolved.hash) });
+        }
+        const aggregated = this.aggregate(def.workflow.aggregation, phaseResults);
+        const durationMs = Date.now() - startTime;
+        const tokenTotals = sumTokenMetrics(phaseResults.flatMap(p => p.commands.map(c => c.metrics)));
+        return {
+            type: 'workflow',
+            name: def.workflow.interface.name,
+            version: def.workflow.interface.version,
+            definitionHash: resolved.hash,
+            decision: aggregated.decision,
+            score: aggregated.score,
+            phases: phaseResults,
+            recommendations: this.deduplicateRecommendations(allRecommendations),
+            durationMs,
+            metrics: {
+                ...tokenTotals,
+                durationMs,
+                model: 'mixed',
+                phasesExecuted: phaseResults.filter(p => p.decision !== 'skipped' && p.decision !== 'aborted').length,
+                phasesPassed: phaseResults.filter(p => p.decision === 'passed').length,
+                phasesWarned: phaseResults.filter(p => p.decision === 'warned').length,
+                phasesBlocked: phaseResults.filter(p => p.decision === 'blocked').length,
+                phasesSkipped: phaseResults.filter(p => p.decision === 'skipped').length,
+                phasesAborted: phaseResults.filter(p => p.decision === 'aborted').length,
+                commands: phaseResults.flatMap(p => p.commands.map(c => ({
+                    name: c.name,
+                    score: c.score ?? 0,
+                    decision: c.decision,
+                    inputTokens: c.metrics.inputTokens,
+                    outputTokens: c.metrics.outputTokens,
+                    durationMs: c.metrics.durationMs,
+                    costUsd: c.metrics.costUsd,
+                }))),
+            },
+        };
+    }
+    /**
+     * Execute a set of independent phases in parallel.
+     *
+     * Respects max_parallel concurrency limit if set. Uses Promise.allSettled
+     * to ensure partial failures don't reject the entire level.
+     */
+    async executePhasesParallel(phases, input, maxParallel) {
+        if (phases.length === 1) {
+            // Single phase — no need for concurrency machinery
+            return [await this.executePhase(phases[0], input)];
+        }
+        if (maxParallel && maxParallel > 0 && maxParallel < phases.length) {
+            // Semaphore-limited concurrency
+            return this.executePhasesWithLimit(phases, input, maxParallel);
+        }
+        // Unlimited parallel — all phases in this level run concurrently
+        const settled = await Promise.allSettled(phases.map(phase => this.executePhase(phase, input)));
+        const results = [];
+        for (let i = 0; i < settled.length; i++) {
+            const outcome = settled[i];
+            if (outcome.status === 'fulfilled') {
+                results.push(outcome.value);
+            }
+            else {
+                // Phase threw — create a blocked result preserving error context
+                results.push(this.createBlockedPhase(phases[i], outcome.reason));
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute phases with a concurrency semaphore.
+     */
+    async executePhasesWithLimit(phases, input, limit) {
+        const results = new Array(phases.length);
+        let nextIndex = 0;
+        async function runNext(executor) {
+            while (nextIndex < phases.length) {
+                const idx = nextIndex++;
+                const phase = phases[idx];
+                try {
+                    results[idx] = await executor.executePhase(phase, input);
+                }
+                catch (error) {
+                    results[idx] = executor.createBlockedPhase(phase, error);
+                }
+            }
+        }
+        const workers = Array.from({ length: Math.min(limit, phases.length) }, () => runNext(this));
+        await Promise.all(workers);
+        return results;
+    }
+    async executePhase(phase, input) {
+        const phaseStart = Date.now();
+        const commandResults = [];
+        if (phase.parallel) {
+            const settled = await Promise.allSettled(phase.commands.map(cmdName => this.executeCommand(cmdName, input)));
+            const errors = [];
+            for (let j = 0; j < settled.length; j++) {
+                const outcome = settled[j];
+                if (outcome.status === 'fulfilled') {
+                    commandResults.push(outcome.value);
+                }
+                else {
+                    const errorMsg = outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason);
+                    errors.push(errorMsg);
+                    // Failed commands contribute a zero-score result so they penalize the aggregate
+                    commandResults.push({
+                        type: 'command',
+                        name: phase.commands[j],
+                        version: '',
+                        definitionHash: '',
+                        agentType: 'validator',
+                        decision: 'FAIL',
+                        score: 0,
+                        maxScore: 100,
+                        recommendations: [],
+                        durationMs: 0,
+                        metrics: { inputTokens: 0, outputTokens: 0, totalEffectiveTokens: 0, durationMs: 0, model: 'unknown', toolCalls: 0 },
+                    });
+                }
+            }
+            if (errors.length > 0 && commandResults.length === errors.length) {
+                throw new Error(`All parallel commands in phase "${phase.name}" failed: ${errors.join('; ')}`);
+            }
+        }
+        else {
+            for (const cmdName of phase.commands) {
+                const result = await this.executeCommand(cmdName, input);
+                commandResults.push(result);
+            }
+        }
+        const aggregateScore = this.aggregatePhaseScore(commandResults, phase.gate?.aggregate ?? 'average');
+        const decision = this.evaluateGate(aggregateScore, phase.gate);
+        return {
+            id: phase.id,
+            name: phase.name,
+            decision,
+            commands: commandResults,
+            gateThreshold: phase.gate?.threshold ?? 70,
+            score: aggregateScore,
+            durationMs: Date.now() - phaseStart,
+        };
+    }
+    async executeCommand(cmdName, input) {
+        const resolved = await this.registry.resolve(cmdName);
+        return this.commandExecutor.execute(resolved, input);
+    }
+    aggregatePhaseScore(results, method) {
+        if (results.length === 0)
+            return 0;
+        const scores = results.map(r => r.score ?? 0);
+        switch (method) {
+            case 'min': return Math.min(...scores);
+            case 'max': return Math.max(...scores);
+            case 'average':
+            default:
+                return scores.reduce((a, b) => a + b, 0) / scores.length;
+        }
+    }
+    evaluateGate(score, gate) {
+        if (!gate)
+            return 'passed';
+        if (score >= gate.threshold)
+            return 'passed';
+        if (gate.on_fail === 'warn')
+            return 'warned';
+        return 'blocked';
+    }
+    aggregate(config, phases) {
+        const weights = config?.score?.weights ?? {};
+        let totalWeight = 0;
+        let weightedScore = 0;
+        for (const phase of phases) {
+            if (phase.decision === 'skipped' || phase.decision === 'aborted')
+                continue;
+            const weight = weights[phase.id] ?? 1;
+            totalWeight += weight;
+            weightedScore += phase.score * weight;
+        }
+        const score = totalWeight > 0 ? Math.round(weightedScore / totalWeight) : 0;
+        const hasBlocked = phases.some(p => p.decision === 'blocked');
+        const hasWarned = phases.some(p => p.decision === 'warned');
+        const hasAborted = phases.some(p => p.decision === 'aborted');
+        let decision;
+        if (hasBlocked || hasAborted) {
+            decision = config?.decision?.BLOCK ?? 'BLOCK';
+        }
+        else if (hasWarned) {
+            decision = config?.decision?.HOLD ?? 'HOLD';
+        }
+        else {
+            decision = config?.decision?.SHIP ?? 'SHIP';
+        }
+        return { decision, score };
+    }
+    createBlockedPhase(phase, error) {
+        return {
+            id: phase.id,
+            name: phase.name,
+            decision: 'blocked',
+            commands: [],
+            gateThreshold: phase.gate?.threshold ?? 70,
+            score: 0,
+            durationMs: 0,
+            ...(error ? { error: formatErrorMessage(error) } : {}),
+        };
+    }
+    createSkippedPhase(phase) {
+        return {
+            id: phase.id,
+            name: phase.name,
+            decision: 'skipped',
+            commands: [],
+            gateThreshold: phase.gate?.threshold ?? 70,
+            score: 0,
+            durationMs: 0,
+        };
+    }
+    checkDependencies(dependsOn, completedPhases) {
+        if (!dependsOn || dependsOn.length === 0)
+            return true;
+        return dependsOn.every(depId => {
+            const dep = completedPhases.get(depId);
+            return dep && dep.decision !== 'blocked' && dep.decision !== 'aborted';
+        });
+    }
+    evaluateCondition(condition, input, _phases) {
+        const match = condition.match(/\{\{\s*input\.(\w+)\s*\}\}/);
+        if (match?.[1])
+            return Boolean(input.options?.[match[1]]);
+        return false;
+    }
+    deduplicateRecommendations(recommendations) {
+        const seen = new Set();
+        return recommendations.filter(r => {
+            const key = `${r.title}|${r.filePath ?? ''}|${r.lineNumber ?? ''}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }
+    buildPartialResult(def, phases, recommendations, startTime, hash) {
+        return {
+            type: 'workflow',
+            name: def.workflow.interface.name,
+            definitionHash: hash,
+            phases,
+            recommendations,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=WorkflowExecutor.js.map

package/dist/executor/WorkflowExecutor.js.map

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

package/dist/executor/preflight.d.ts

@@ -0,0 +1,8 @@
+import type { PreflightCheck } from '../types/command.js';
+import type { ExecutionInput } from '../types/execution.js';
+/**
+ * Run a set of preflight checks before command execution.
+ * Throws PreflightError on first failure.
+ */
+export declare function runPreflightChecks(checks: PreflightCheck[], input: ExecutionInput): Promise<void>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/executor/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/executor/preflight.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/executor/preflight.js

@@ -0,0 +1,102 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { PreflightError } from '../errors/index.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Run a set of preflight checks before command execution.
+ * Throws PreflightError on first failure.
+ */
+export async function runPreflightChecks(checks, input) {
+    for (const check of checks) {
+        await runSingleCheck(check, input);
+    }
+}
+async function runSingleCheck(check, input) {
+    switch (check.check) {
+        case 'file_exists':
+            return checkFileExists(check, input);
+        case 'command':
+            return checkCommand(check);
+        case 'env_var':
+            return checkEnvVar(check);
+        case 'git_clean':
+            return checkGitClean(input);
+        default:
+            throw new PreflightError(`Unknown preflight check type: ${check.check}`, check.check);
+    }
+}
+async function checkFileExists(check, input) {
+    if (!check.path) {
+        throw new PreflightError('file_exists check requires a path', 'file_exists');
+    }
+    const targetRoot = path.resolve(input.target);
+    const fullPath = path.resolve(input.target, check.path);
+    if (!fullPath.startsWith(targetRoot + path.sep) && fullPath !== targetRoot) {
+        throw new PreflightError(`file_exists path escapes target directory: ${check.path}`, 'file_exists', { path: check.path });
+    }
+    try {
+        await fs.access(fullPath);
+    }
+    catch {
+        throw new PreflightError(check.message ?? `Required file not found: ${check.path}`, 'file_exists', { path: check.path });
+    }
+}
+/**
+ * Run a shell command from a CDL preflight definition.
+ *
+ * SECURITY: The command string comes from the definition YAML file, which is
+ * authored by the SDK user (not end-user input). It's passed to `sh -c` via
+ * execFile's argv array (not shell-expanded), but the inner command IS
+ * interpreted by sh. We reject commands that contain obvious injection
+ * patterns from untrusted YAML.
+ */
+async function checkCommand(check) {
+    if (!check.command) {
+        throw new PreflightError('command check requires a command', 'command');
+    }
+    // Reject commands with shell metacharacters that could be used for injection:
+    // backtick/process substitution (`cmd`, $(cmd)), chaining (; && || newlines),
+    // pipes (|), and redirections (>, <) which could exfiltrate data or chain commands.
+    if (/`|\$\(|;|&&|\|\||\|[^|]|(?<![|])>|<|\n|\r/.test(check.command)) {
+        throw new PreflightError(`Preflight command contains disallowed shell metacharacter: ${check.command}`, 'command', { command: check.command });
+    }
+    // Reject interpreter-based code execution that bypasses the metacharacter filter.
+    // Commands like `node -e "..."` or `python3 -c "..."` can execute arbitrary code
+    // without using any blocked metacharacters.
+    if (/\b(node|python[23]?|ruby|perl|php|lua|deno|bun)\s+(-e|--eval|-c)\b/.test(check.command)) {
+        throw new PreflightError(`Preflight command contains disallowed interpreter eval: ${check.command}`, 'command', { command: check.command });
+    }
+    try {
+        await execFileAsync('sh', ['-c', check.command], { timeout: 10_000 });
+    }
+    catch {
+        throw new PreflightError(check.message ?? `Command check failed: ${check.command}`, 'command', { command: check.command });
+    }
+}
+function checkEnvVar(check) {
+    if (!check.var) {
+        throw new PreflightError('env_var check requires a var name', 'env_var');
+    }
+    if (process.env[check.var] === undefined) {
+        throw new PreflightError(check.message ?? `Required environment variable not set: ${check.var}`, 'env_var', { var: check.var });
+    }
+}
+async function checkGitClean(input) {
+    try {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain'], {
+            cwd: input.target,
+            timeout: 10_000,
+        });
+        if (stdout.trim().length > 0) {
+            throw new PreflightError('Git working directory is not clean', 'git_clean');
+        }
+    }
+    catch (error) {
+        if (error instanceof PreflightError)
+            throw error;
+        throw new PreflightError(`Failed to check git status: ${error instanceof Error ? error.message : 'is this a git repository?'}`, 'git_clean');
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/executor/preflight.js.map

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

package/dist/executor/symbols.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Symbol extraction from source files.
+ * Extracts exported/private functions, classes, interfaces, types, constants.
+ */
+export interface SymbolInfo {
+    type: string;
+    name: string;
+    line: number;
+    exported: boolean;
+    signature?: string;
+}
+export declare function extractSymbols(lines: string[], ext: string, includePrivate: boolean): SymbolInfo[];
+//# sourceMappingURL=symbols.d.ts.map

package/dist/executor/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/executor/symbols.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,UAAU,EAAE,CAelG"}