@relayflows/core 0.0.1 → 1.0.1

package/dist/step-executor.d.ts.map

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

package/dist/step-executor.js

@@ -0,0 +1,393 @@
+import { ChannelMessenger } from './channel-messenger.js';
+import { TemplateResolver } from './template-resolver.js';
+import { runVerification, } from './verification.js';
+export class StepExecutor {
+    deps;
+    templateResolver;
+    channelMessenger;
+    verificationRunner;
+    constructor(deps) {
+        this.deps = deps;
+        this.templateResolver = deps.templateResolver ?? new TemplateResolver();
+        this.channelMessenger = deps.channelMessenger ?? new ChannelMessenger({ postFn: deps.postToChannel });
+        this.verificationRunner = deps.verificationRunner ?? runVerification;
+    }
+    findReady(steps, statuses) {
+        return steps.filter((step) => {
+            const state = statuses.get(step.name);
+            const status = this.getStatus(state);
+            if (status !== 'pending')
+                return false;
+            return (step.dependsOn ?? []).every((dependency) => {
+                const depState = statuses.get(dependency);
+                const depStatus = this.getStatus(depState);
+                return depStatus === 'completed' || depStatus === 'skipped';
+            });
+        });
+    }
+    /** @deprecated Use {@link findReady} instead. This is an alias kept for backward compatibility. */
+    findReadySteps(steps, statuses) {
+        return this.findReady(steps, statuses);
+    }
+    scheduleStep(step, options = {}) {
+        return {
+            step,
+            readyAt: options.readyAt ?? Date.now(),
+            staggerDelay: options.staggerDelay ?? 0,
+        };
+    }
+    async startStep(step, state, startMessage) {
+        const startedAt = new Date().toISOString();
+        state.row.status = 'running';
+        state.row.error = undefined;
+        state.row.completionReason = undefined;
+        state.row.startedAt = startedAt;
+        await this.deps.persistStepRow?.(state.row.id, {
+            status: 'running',
+            error: undefined,
+            completionReason: undefined,
+            startedAt,
+            updatedAt: new Date().toISOString(),
+        });
+        if (startMessage) {
+            this.deps.postToChannel?.(startMessage);
+        }
+        await this.deps.onStepStarted?.(step, state);
+    }
+    async retryStep(step, state, attempt, maxRetries) {
+        state.row.retryCount = attempt;
+        await this.deps.persistStepRow?.(state.row.id, {
+            retryCount: attempt,
+            updatedAt: new Date().toISOString(),
+        });
+        await this.deps.onStepRetried?.(step, state, attempt, maxRetries);
+    }
+    async completeStep(step, state, result) {
+        const completedAt = new Date().toISOString();
+        const finalResult = {
+            status: result.status ?? 'completed',
+            output: result.output ?? '',
+            exitCode: result.exitCode,
+            exitSignal: result.exitSignal,
+            duration: result.duration ?? 0,
+            retries: result.retries ?? state.row.retryCount,
+            completionReason: result.completionReason,
+            error: result.error,
+        };
+        state.row.status = finalResult.status;
+        state.row.output = finalResult.output;
+        state.row.error = finalResult.error;
+        state.row.completionReason = finalResult.completionReason;
+        state.row.completedAt = completedAt;
+        await this.deps.persistStepRow?.(state.row.id, {
+            status: finalResult.status,
+            output: finalResult.output,
+            error: finalResult.error,
+            completionReason: finalResult.completionReason,
+            completedAt,
+            updatedAt: new Date().toISOString(),
+        });
+        if (finalResult.status === 'completed' && this.deps.runId && finalResult.output) {
+            await this.deps.persistStepOutput?.(this.deps.runId, step.name, finalResult.output);
+        }
+        if (finalResult.status === 'failed') {
+            await this.deps.onStepFailed?.(step, state, finalResult);
+        }
+        else {
+            await this.deps.onStepCompleted?.(step, state, finalResult);
+        }
+        return finalResult;
+    }
+    async monitorStep(step, state, options) {
+        const maxRetries = options.maxRetries ?? 0;
+        const retryDelayMs = options.retryDelayMs ?? 1000;
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+            this.deps.checkAborted?.();
+            await this.deps.waitIfPaused?.();
+            if (attempt > 0) {
+                await this.retryStep(step, state, attempt, maxRetries);
+                await options.onRetry?.(attempt, maxRetries, state);
+                if (retryDelayMs > 0) {
+                    await delay(retryDelayMs);
+                }
+            }
+            const attemptStartedAt = Date.now();
+            await this.startStep(step, state, options.startMessage);
+            await options.onStart?.(attempt, state);
+            try {
+                const rawResult = await options.execute(attempt, state);
+                const completion = options.toCompletionResult(rawResult, attempt, state);
+                return await this.completeStep(step, state, {
+                    ...completion,
+                    duration: completion.duration ?? Date.now() - attemptStartedAt,
+                    retries: completion.retries ?? attempt,
+                });
+            }
+            catch (error) {
+                lastError = error;
+                await options.onAttemptFailed?.(error, attempt, state);
+            }
+        }
+        const failure = options.getFailureResult?.(lastError, maxRetries, state) ?? {
+            status: 'failed',
+            output: '',
+            error: lastError instanceof Error ? lastError.message : String(lastError ?? 'Unknown error'),
+            retries: maxRetries,
+        };
+        return this.completeStep(step, state, {
+            ...failure,
+            status: 'failed',
+        });
+    }
+    async executeAll(steps, agentMap, errorHandling, providedStates) {
+        const states = providedStates ?? this.createEphemeralStates(steps);
+        const strategy = normalizeStrategy(errorHandling?.strategy ?? 'fail-fast');
+        const results = new Map();
+        while (true) {
+            this.deps.checkAborted?.();
+            await this.deps.waitIfPaused?.();
+            const readySteps = this.findReady(steps, states);
+            if (readySteps.length === 0)
+                break;
+            const schedules = readySteps.map((step, index) => this.scheduleStep(step, {
+                readyAt: Date.now(),
+                staggerDelay: readySteps.length > 3 ? index * 2_000 : 0,
+            }));
+            if (schedules.length > 1) {
+                await this.deps.onBeginTrack?.(readySteps);
+            }
+            const settled = await Promise.allSettled(schedules.map(async (schedule) => {
+                if (schedule.staggerDelay > 0) {
+                    await delay(schedule.staggerDelay);
+                }
+                return this.executeScheduledStep(schedule.step, states, agentMap, errorHandling);
+            }));
+            const batchOutcomes = [];
+            for (let index = 0; index < settled.length; index += 1) {
+                const settledResult = settled[index];
+                const step = readySteps[index];
+                const state = states.get(step.name);
+                if (settledResult.status === 'fulfilled') {
+                    const result = settledResult.value;
+                    const outcomeStatus = result.status === 'completed' || result.status === 'skipped' ? result.status : 'failed';
+                    results.set(step.name, result);
+                    batchOutcomes.push({
+                        name: step.name,
+                        agent: step.agent ?? 'deterministic',
+                        status: outcomeStatus,
+                        attempts: result.retries + 1,
+                        output: result.output,
+                        error: result.error,
+                        verificationPassed: outcomeStatus === 'completed' && step.verification !== undefined,
+                        completionMode: result.completionReason !== undefined
+                            ? this.deps.buildCompletionMode?.(step.name, result.completionReason)
+                            : undefined,
+                    });
+                    if (result.status === 'failed') {
+                        await this.deps.markDownstreamSkipped?.(step.name);
+                        if (strategy === 'fail-fast') {
+                            throw new Error(`Step "${step.name}" failed: ${result.error ?? 'unknown error'}`);
+                        }
+                    }
+                    continue;
+                }
+                const error = settledResult.reason instanceof Error ? settledResult.reason.message : String(settledResult.reason);
+                if (state) {
+                    const failed = state.row.status === 'failed'
+                        ? {
+                            status: 'failed',
+                            output: state.row.output ?? '',
+                            duration: 0,
+                            retries: state.row.retryCount,
+                            completionReason: state.row.completionReason,
+                            error: state.row.error ?? error,
+                        }
+                        : await this.completeStep(step, state, {
+                            status: 'failed',
+                            output: '',
+                            error,
+                            retries: state.row.retryCount,
+                        });
+                    results.set(step.name, failed);
+                }
+                batchOutcomes.push({
+                    name: step.name,
+                    agent: step.agent ?? 'deterministic',
+                    status: 'failed',
+                    attempts: (state?.row.retryCount ?? 0) + 1,
+                    error,
+                });
+                await this.deps.markDownstreamSkipped?.(step.name);
+                if (strategy === 'fail-fast') {
+                    throw new Error(`Step "${step.name}" failed: ${error}`);
+                }
+            }
+            if (readySteps.length > 1 && batchOutcomes.length > 0) {
+                await this.deps.onConverge?.(readySteps, batchOutcomes);
+            }
+        }
+        return results;
+    }
+    async executeOne(step, agentMap, errorHandling, providedState) {
+        const state = providedState ?? this.createEphemeralState(step);
+        if (this.deps.executeStep) {
+            const result = await this.deps.executeStep(step, state, agentMap, errorHandling);
+            if (state.row.status !== 'pending' && state.row.status !== 'running') {
+                return {
+                    status: state.row.status,
+                    output: state.row.output ?? '',
+                    duration: result?.duration ?? 0,
+                    retries: result?.retries ?? state.row.retryCount,
+                    exitCode: result?.exitCode,
+                    exitSignal: result?.exitSignal,
+                    completionReason: state.row.completionReason ?? result?.completionReason,
+                    error: state.row.error ?? result?.error,
+                };
+            }
+            return this.completeStep(step, state, {
+                status: result?.status ?? 'completed',
+                output: result?.output ?? '',
+                exitCode: result?.exitCode,
+                exitSignal: result?.exitSignal,
+                completionReason: result?.completionReason,
+                retries: result?.retries ?? state.row.retryCount,
+                duration: result?.duration ?? 0,
+                error: result?.error,
+            });
+        }
+        return this.executeWithProcessSpawner(step, state, agentMap, errorHandling);
+    }
+    async markFailed(stepName, error) {
+        this.deps.postToChannel?.(`**[${stepName}]** Failed: ${error}`);
+    }
+    buildStepOutputContext(stepStates) {
+        const steps = {};
+        for (const [name, state] of stepStates) {
+            if (state.row.status === 'completed' && state.row.output !== undefined) {
+                steps[name] = { output: state.row.output };
+                continue;
+            }
+            if (state.row.status === 'completed' && this.deps.runId) {
+                const persisted = this.deps.loadStepOutput?.(this.deps.runId, name);
+                if (persisted !== undefined) {
+                    state.row.output = persisted;
+                    steps[name] = { output: persisted };
+                }
+            }
+        }
+        return steps;
+    }
+    resolveStepTemplate(template, context) {
+        if (this.deps.resolveTemplate) {
+            return this.deps.resolveTemplate(template, context);
+        }
+        return this.templateResolver.interpolateStepTask(template, context);
+    }
+    getChannelMessenger() {
+        return this.channelMessenger;
+    }
+    runVerification(check, output, stepName, injectedTaskText, options) {
+        return this.verificationRunner(check, output, stepName, injectedTaskText, {
+            ...options,
+            cwd: options?.cwd ?? this.deps.cwd,
+        });
+    }
+    async executeScheduledStep(step, states, agentMap, errorHandling) {
+        const state = states.get(step.name) ?? this.createEphemeralState(step);
+        if (!states.has(step.name)) {
+            states.set(step.name, state);
+        }
+        return this.executeOne(step, agentMap, errorHandling, state);
+    }
+    async executeWithProcessSpawner(step, state, agentMap, errorHandling) {
+        const spawner = this.deps.processSpawner;
+        if (!spawner) {
+            throw new Error(`No step execution callback or process spawner configured for step "${step.name}"`);
+        }
+        const maxRetries = step.retries ?? errorHandling?.maxRetries ?? 0;
+        return this.monitorStep(step, state, {
+            maxRetries,
+            retryDelayMs: errorHandling?.retryDelayMs ?? 1000,
+            startMessage: `**[${step.name}]** Started`,
+            onRetry: (attempt, total) => {
+                this.deps.postToChannel?.(`**[${step.name}]** Retrying (attempt ${attempt + 1}/${total + 1})`);
+            },
+            execute: async () => {
+                if (step.type === 'deterministic') {
+                    const command = step.command ?? '';
+                    return spawner.spawnShell(command, { cwd: this.deps.cwd, timeoutMs: step.timeoutMs });
+                }
+                const agent = step.agent ? agentMap.get(step.agent) : undefined;
+                if (!agent) {
+                    throw new Error(`Agent "${step.agent ?? '(missing)'}" not found in config`);
+                }
+                const task = step.task ?? '';
+                if (agent.interactive === false) {
+                    return spawner.spawnAgent(agent, task, { cwd: this.deps.cwd, timeoutMs: step.timeoutMs });
+                }
+                return spawner.spawnInteractive(agent, task, { cwd: this.deps.cwd, timeoutMs: step.timeoutMs });
+            },
+            toCompletionResult: (spawnResult, attempt) => {
+                const failOnError = step.failOnError !== false;
+                const failed = failOnError &&
+                    ((spawnResult.exitCode ?? 0) !== 0 ||
+                        (spawnResult.exitCode === undefined && spawnResult.exitSignal !== undefined));
+                const output = step.captureOutput === false
+                    ? `Command completed (exit code ${spawnResult.exitCode ?? 0})`
+                    : spawnResult.output;
+                if (failed) {
+                    return {
+                        status: 'failed',
+                        output,
+                        exitCode: spawnResult.exitCode,
+                        exitSignal: spawnResult.exitSignal,
+                        retries: attempt,
+                        error: spawnResult.output || `Command failed with exit code ${spawnResult.exitCode ?? 'unknown'}`,
+                    };
+                }
+                return {
+                    status: 'completed',
+                    output,
+                    exitCode: spawnResult.exitCode,
+                    exitSignal: spawnResult.exitSignal,
+                    retries: attempt,
+                };
+            },
+        });
+    }
+    createEphemeralStates(steps) {
+        return new Map(steps.map((step) => [step.name, this.createEphemeralState(step)]));
+    }
+    createEphemeralState(step) {
+        return {
+            row: {
+                id: `step-${step.name}`,
+                runId: this.deps.runId ?? 'run',
+                stepName: step.name,
+                agentName: step.agent ?? null,
+                stepType: step.type ?? 'agent',
+                status: 'pending',
+                task: step.task ?? step.command ?? step.branch ?? '',
+                dependsOn: step.dependsOn ?? [],
+                retryCount: 0,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            },
+        };
+    }
+    getStatus(state) {
+        if (typeof state === 'string')
+            return state;
+        return state?.row.status;
+    }
+}
+function normalizeStrategy(strategy) {
+    if (strategy === 'continue')
+        return 'continue';
+    return 'fail-fast';
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=step-executor.js.map

package/dist/step-executor.js.map

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

package/dist/template-resolver.d.ts

@@ -0,0 +1,33 @@
+import type { RelayYamlConfig } from './types.js';
+/**
+ * Escape a string for safe inclusion in a shell command passed to `sh -c`.
+ * Wraps the value in single quotes and escapes any embedded single quotes.
+ */
+export declare function shellEscape(value: string): string;
+/**
+ * Variable context for template resolution.
+ * Values are typed as `unknown` to accommodate dynamic step-output contexts;
+ * only scalar values (string | number | boolean) are interpolated — complex
+ * objects are coerced via String(). Shell-bound templates are escaped by
+ * {@link resolveTemplateForShell}.
+ */
+export interface VariableContext {
+    [key: string]: unknown;
+}
+export declare function resolveVariables(config: RelayYamlConfig, vars: VariableContext): RelayYamlConfig;
+export declare function resolveTemplate(template: string, context: VariableContext): string;
+/**
+ * Like resolveTemplate but shell-escapes interpolated values.
+ * Use this when the result will be passed to `sh -c` to prevent injection.
+ */
+export declare function resolveTemplateForShell(template: string, context: VariableContext): string;
+export declare function resolveDotPath(key: string, context: VariableContext): string | number | boolean | undefined;
+export declare function resolveStepOutputRef(ref: string, stepOutputs: Map<string, string>): string;
+export declare function interpolateStepTask(template: string, context: VariableContext): string;
+export declare class TemplateResolver {
+    resolveVariables(config: RelayYamlConfig, vars: VariableContext): RelayYamlConfig;
+    interpolate(template: string, vars: VariableContext): string;
+    resolveDotPath(key: string, vars: VariableContext): string | number | boolean | undefined;
+    interpolateStepTask(template: string, context: VariableContext): string;
+}
+//# sourceMappingURL=template-resolver.d.ts.map

package/dist/template-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-resolver.d.ts","sourceRoot":"","sources":["../src/template-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,GAAG,eAAe,CA+BhG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAYlF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAY1F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAe3G;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAa1F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAStF;AAgCD,qBAAa,gBAAgB;IAC3B,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,GAAG,eAAe;IAIjF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM;IAI5D,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS;IAIzF,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM;CAGxE"}

package/dist/template-resolver.js

@@ -0,0 +1,144 @@
+/**
+ * Escape a string for safe inclusion in a shell command passed to `sh -c`.
+ * Wraps the value in single quotes and escapes any embedded single quotes.
+ */
+export function shellEscape(value) {
+    return "'" + value.replace(/'/g, "'\\''") + "'";
+}
+const TEMPLATE_VARIABLE_PATTERN = /\{\{([\w][\w.\-]*)\}\}/g;
+const STEP_OUTPUT_TEMPLATE_PATTERN = /\{\{(steps\.[\w\-]+\.output)\}\}/g;
+const STEP_OUTPUT_REF_PATTERN = /^steps\.([\w\-]+)\.output$/;
+export function resolveVariables(config, vars) {
+    const resolved = structuredClone(config);
+    for (const agent of resolved.agents) {
+        if (agent.task) {
+            agent.task = resolveTemplate(agent.task, vars);
+        }
+    }
+    if (resolved.workflows) {
+        for (const workflow of resolved.workflows) {
+            for (const step of workflow.steps) {
+                if (step.task) {
+                    step.task = resolveTemplate(step.task, vars);
+                }
+                if (step.command) {
+                    step.command = resolveTemplateForShell(step.command, vars);
+                }
+                if (step.params && typeof step.params === 'object') {
+                    for (const key of Object.keys(step.params)) {
+                        const value = step.params[key];
+                        if (typeof value === 'string') {
+                            step.params[key] = resolveTemplate(value, vars);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return resolved;
+}
+export function resolveTemplate(template, context) {
+    return template.replace(TEMPLATE_VARIABLE_PATTERN, (match, key) => {
+        if (key.startsWith('steps.')) {
+            return match;
+        }
+        const value = resolveDotPath(key, context);
+        if (value === undefined) {
+            throw new Error(`Unresolved variable: {{${key}}}`);
+        }
+        return String(value);
+    });
+}
+/**
+ * Like resolveTemplate but shell-escapes interpolated values.
+ * Use this when the result will be passed to `sh -c` to prevent injection.
+ */
+export function resolveTemplateForShell(template, context) {
+    return template.replace(TEMPLATE_VARIABLE_PATTERN, (match, key) => {
+        if (key.startsWith('steps.')) {
+            return match;
+        }
+        const value = resolveDotPath(key, context);
+        if (value === undefined) {
+            throw new Error(`Unresolved variable: {{${key}}}`);
+        }
+        return shellEscape(String(value));
+    });
+}
+export function resolveDotPath(key, context) {
+    if (!key.includes('.')) {
+        return toTemplateScalar(context[key]);
+    }
+    const parts = key.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return toTemplateScalar(current);
+}
+export function resolveStepOutputRef(ref, stepOutputs) {
+    const normalizedRef = ref.startsWith('{{') && ref.endsWith('}}') ? ref.slice(2, -2).trim() : ref;
+    const match = STEP_OUTPUT_REF_PATTERN.exec(normalizedRef);
+    if (!match) {
+        throw new Error(`Invalid step output reference: ${ref}`);
+    }
+    const stepOutput = stepOutputs.get(match[1]);
+    if (stepOutput === undefined) {
+        throw new Error(`Unresolved step output reference: ${ref}`);
+    }
+    return stepOutput;
+}
+export function interpolateStepTask(template, context) {
+    const stepOutputs = buildStepOutputMap(context);
+    return template.replace(STEP_OUTPUT_TEMPLATE_PATTERN, (match, ref) => {
+        try {
+            return resolveStepOutputRef(ref, stepOutputs);
+        }
+        catch {
+            return match;
+        }
+    });
+}
+function buildStepOutputMap(context) {
+    const stepOutputs = new Map();
+    const steps = context.steps;
+    if (!steps || typeof steps !== 'object') {
+        return stepOutputs;
+    }
+    for (const [stepName, stepState] of Object.entries(steps)) {
+        if (!stepState || typeof stepState !== 'object') {
+            continue;
+        }
+        const output = toTemplateScalar(stepState.output);
+        if (output !== undefined) {
+            stepOutputs.set(stepName, String(output));
+        }
+    }
+    return stepOutputs;
+}
+function toTemplateScalar(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    return String(value);
+}
+export class TemplateResolver {
+    resolveVariables(config, vars) {
+        return resolveVariables(config, vars);
+    }
+    interpolate(template, vars) {
+        return resolveTemplate(template, vars);
+    }
+    resolveDotPath(key, vars) {
+        return resolveDotPath(key, vars);
+    }
+    interpolateStepTask(template, context) {
+        return interpolateStepTask(template, context);
+    }
+}
+//# sourceMappingURL=template-resolver.js.map

package/dist/template-resolver.js.map

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