@defai.digital/workflow-engine 13.0.3

package/dist/step-guard.js

@@ -0,0 +1,496 @@
+/**
+ * Workflow Step Guard Implementation
+ *
+ * Enforces governance checks at workflow step boundaries.
+ *
+ * Invariants:
+ * - INV-WF-GUARD-001: Before guards run before step execution starts
+ * - INV-WF-GUARD-002: After guards run after step completes
+ * - INV-WF-GUARD-003: Block failures prevent step execution/continuation
+ * - INV-WF-GUARD-004: Guard results included in trace events
+ */
+import { createStepGuardResult, createProgressEvent, } from '@defai.digital/contracts';
+/**
+ * Default step guard engine configuration
+ */
+export const DEFAULT_STEP_GUARD_ENGINE_CONFIG = {
+    enabled: true,
+    defaultOnFail: 'warn',
+};
+/**
+ * Step Guard Engine
+ *
+ * Manages step guards and executes them at appropriate times.
+ */
+export class StepGuardEngine {
+    config;
+    gateRegistry;
+    policies = new Map();
+    onProgressEvent;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_STEP_GUARD_ENGINE_CONFIG, ...config };
+        this.gateRegistry = config.gateRegistry ?? createGateRegistry();
+        this.onProgressEvent = config.onProgressEvent;
+        // Register default gates
+        this.registerDefaultGates();
+    }
+    /**
+     * Register a guard policy
+     */
+    registerPolicy(policy) {
+        this.policies.set(policy.policyId, policy);
+    }
+    /**
+     * Remove a guard policy
+     */
+    removePolicy(policyId) {
+        return this.policies.delete(policyId);
+    }
+    /**
+     * Get all registered policies
+     */
+    getPolicies() {
+        return Array.from(this.policies.values());
+    }
+    /**
+     * Register a custom gate
+     */
+    registerGate(gateId, check) {
+        this.gateRegistry.register(gateId, check);
+    }
+    /**
+     * Run before guards for a step
+     * INV-WF-GUARD-001: Runs before step execution
+     */
+    async runBeforeGuards(context) {
+        return this.runGuards(context, 'before');
+    }
+    /**
+     * Run after guards for a step
+     * INV-WF-GUARD-002: Runs after step completes
+     */
+    async runAfterGuards(context) {
+        return this.runGuards(context, 'after');
+    }
+    /**
+     * Check if step should be blocked
+     * INV-WF-GUARD-003: Block failures prevent execution
+     */
+    shouldBlock(results) {
+        return results.some((r) => r.blocked);
+    }
+    /**
+     * Emit progress event
+     * INV-PROG-001, INV-PROG-002: Progress events emitted
+     */
+    emitProgress(executionId, agentId, stageIndex, stageTotal, stageName, stageType, status, options = {}) {
+        if (this.onProgressEvent) {
+            const event = createProgressEvent(executionId, agentId, stageIndex, stageTotal, stageName, stageType, status, options);
+            this.onProgressEvent(event);
+        }
+    }
+    /**
+     * Run guards at a position
+     */
+    async runGuards(context, position) {
+        if (!this.config.enabled) {
+            return [];
+        }
+        const results = [];
+        const applicablePolicies = this.getApplicablePolicies(context);
+        // Sort by priority (highest first)
+        // INV-POL-001: Priority ordering
+        applicablePolicies.sort((a, b) => b.priority - a.priority);
+        for (const policy of applicablePolicies) {
+            for (const guard of policy.guards) {
+                if (!guard.enabled)
+                    continue;
+                if (guard.position !== position)
+                    continue;
+                if (!this.matchesStep(guard.stepId, context.stepId))
+                    continue;
+                const result = await this.runGuard(guard, context);
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Run a single guard
+     */
+    async runGuard(guard, context) {
+        const startTime = Date.now();
+        const gateResults = [];
+        // INV-GATE-001: Gates execute independently
+        for (const gateId of guard.gates) {
+            const gateFn = this.gateRegistry.get(gateId);
+            if (!gateFn) {
+                gateResults.push({
+                    gateId,
+                    status: 'WARN',
+                    message: `Gate "${gateId}" not found`,
+                });
+                continue;
+            }
+            try {
+                const result = await gateFn(context);
+                gateResults.push(result);
+            }
+            catch (error) {
+                gateResults.push({
+                    gateId,
+                    status: 'FAIL',
+                    message: error instanceof Error ? error.message : 'Gate check failed',
+                });
+            }
+        }
+        // Determine if should block
+        const hasFailure = gateResults.some((g) => g.status === 'FAIL');
+        const blocked = hasFailure && guard.onFail === 'block';
+        const result = createStepGuardResult(guard.guardId, context.stepId, guard.position, gateResults, blocked);
+        // Set duration
+        result.durationMs = Date.now() - startTime;
+        return result;
+    }
+    /**
+     * Get policies applicable to context
+     */
+    getApplicablePolicies(context) {
+        const applicable = [];
+        for (const policy of this.policies.values()) {
+            if (!policy.enabled)
+                continue;
+            if (!this.matchesPatterns(policy.agentPatterns, context.agentId))
+                continue;
+            if (policy.stepTypes && !policy.stepTypes.includes(context.stepType))
+                continue;
+            if (context.workflowId && !this.matchesPatterns(policy.workflowPatterns, context.workflowId))
+                continue;
+            applicable.push(policy);
+        }
+        return applicable;
+    }
+    /**
+     * Check if step ID matches pattern
+     */
+    matchesStep(pattern, stepId) {
+        if (pattern === '*')
+            return true;
+        return this.globMatch(pattern, stepId);
+    }
+    /**
+     * Check if any pattern matches value
+     */
+    matchesPatterns(patterns, value) {
+        return patterns.some((p) => p === '*' || this.globMatch(p, value));
+    }
+    /**
+     * Simple glob matching (* only)
+     */
+    globMatch(pattern, value) {
+        const regex = new RegExp('^' + pattern.split('*').map(this.escapeRegex).join('.*') + '$');
+        return regex.test(value);
+    }
+    /**
+     * Escape regex special characters
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Register default gates
+     */
+    registerDefaultGates() {
+        // Validation gate - validates step configuration based on step type
+        this.gateRegistry.register('validation', async (context) => {
+            const config = context.stepConfig;
+            const errors = [];
+            const warnings = [];
+            // Only validate step config if it's provided
+            // When stepConfig is undefined, the step is assumed to be configured elsewhere
+            if (config !== undefined && Object.keys(config).length > 0) {
+                // Validate based on step type
+                switch (context.stepType) {
+                    case 'prompt':
+                        // Prompt steps require a prompt field
+                        if (!config.prompt && !config.template) {
+                            errors.push('Prompt step requires "prompt" or "template" in config');
+                        }
+                        break;
+                    case 'tool':
+                        // Tool steps require a tool name
+                        if (!config.toolName && !config.tool) {
+                            errors.push('Tool step requires "toolName" or "tool" in config');
+                        }
+                        break;
+                    case 'conditional':
+                        // Conditional steps require a condition
+                        if (!config.condition && !config.when) {
+                            errors.push('Conditional step requires "condition" or "when" in config');
+                        }
+                        break;
+                    case 'loop':
+                        // Loop steps require items or count
+                        if (!config.items && !config.count && !config.until) {
+                            errors.push('Loop step requires "items", "count", or "until" in config');
+                        }
+                        break;
+                    case 'discuss':
+                        // Discuss steps require a topic/prompt and providers
+                        if (!config.prompt && !config.topic) {
+                            errors.push('Discuss step requires "prompt" or "topic" in config');
+                        }
+                        break;
+                    case 'delegate':
+                        // Delegate steps require target agent
+                        if (!config.agentId && !config.targetAgent) {
+                            errors.push('Delegate step requires "agentId" or "targetAgent" in config');
+                        }
+                        break;
+                }
+            }
+            // Check step ID format (should be kebab-case) - warn but don't fail
+            if (!/^[a-z][a-z0-9-]*$/.test(context.stepId)) {
+                warnings.push(`Step ID "${context.stepId}" should be kebab-case (lowercase letters, numbers, hyphens)`);
+            }
+            if (errors.length > 0) {
+                return {
+                    gateId: 'validation',
+                    status: 'FAIL',
+                    message: `Validation failed: ${errors.join('; ')}`,
+                    details: { errors, warnings },
+                };
+            }
+            if (warnings.length > 0) {
+                return {
+                    gateId: 'validation',
+                    status: 'WARN',
+                    message: `Validation passed with warnings: ${warnings.join('; ')}`,
+                    details: { warnings },
+                };
+            }
+            return {
+                gateId: 'validation',
+                status: 'PASS',
+                message: 'Step configuration is valid',
+                details: { stepType: context.stepType },
+            };
+        });
+        // Capability gate - checks if infrastructure is available for step type
+        this.gateRegistry.register('capability', async (context) => {
+            const warnings = [];
+            // Check capabilities based on step type
+            switch (context.stepType) {
+                case 'prompt':
+                case 'discuss':
+                    // These require LLM provider access
+                    // In a full implementation, we'd check if providers are configured
+                    break;
+                case 'tool':
+                    // Check if the tool is available
+                    const toolName = (context.stepConfig)?.toolName ??
+                        (context.stepConfig)?.tool;
+                    if (toolName && typeof toolName === 'string') {
+                        // Could check tool registry here
+                        // For now, warn if it's an unknown tool type
+                        const knownTools = ['read', 'write', 'search', 'execute', 'fetch'];
+                        if (!knownTools.includes(toolName.toLowerCase())) {
+                            warnings.push(`Tool "${toolName}" may require custom executor`);
+                        }
+                    }
+                    break;
+                case 'delegate':
+                    // Delegation requires agent registry
+                    const targetAgent = (context.stepConfig)?.agentId ??
+                        (context.stepConfig)?.targetAgent;
+                    if (!targetAgent) {
+                        warnings.push('Delegate step has no target agent specified');
+                    }
+                    break;
+            }
+            if (warnings.length > 0) {
+                return {
+                    gateId: 'capability',
+                    status: 'WARN',
+                    message: `Capability warnings: ${warnings.join('; ')}`,
+                    details: { warnings, agentId: context.agentId },
+                };
+            }
+            return {
+                gateId: 'capability',
+                status: 'PASS',
+                message: `Agent ${context.agentId} has required capabilities for ${context.stepType} step`,
+                details: { stepType: context.stepType },
+            };
+        });
+        // Resource gate - checks resource limits and thresholds
+        this.gateRegistry.register('resource', async (context) => {
+            const issues = [];
+            // Check step limit thresholds
+            const MAX_STEPS_WARNING = 50;
+            const MAX_STEPS_LIMIT = 100;
+            if (context.totalSteps > MAX_STEPS_LIMIT) {
+                return {
+                    gateId: 'resource',
+                    status: 'FAIL',
+                    message: `Workflow exceeds maximum step limit (${context.totalSteps} > ${MAX_STEPS_LIMIT})`,
+                    details: {
+                        totalSteps: context.totalSteps,
+                        limit: MAX_STEPS_LIMIT,
+                    },
+                };
+            }
+            if (context.totalSteps > MAX_STEPS_WARNING) {
+                issues.push(`Workflow has ${context.totalSteps} steps (warning threshold: ${MAX_STEPS_WARNING})`);
+            }
+            // Check if we're past the halfway point (useful for long workflows)
+            const progress = (context.stepIndex + 1) / context.totalSteps;
+            if (progress > 0.9 && context.totalSteps > 10) {
+                // Nearing completion - just informational
+            }
+            // Check for potential infinite loops (same step appearing in outputs)
+            const outputKeys = Object.keys(context.previousOutputs);
+            const currentStepOutputCount = outputKeys.filter(k => k.startsWith(context.stepId)).length;
+            if (currentStepOutputCount > 5) {
+                issues.push(`Step "${context.stepId}" has run ${currentStepOutputCount} times - possible loop`);
+            }
+            if (issues.length > 0) {
+                return {
+                    gateId: 'resource',
+                    status: 'WARN',
+                    message: `Resource warnings: ${issues.join('; ')}`,
+                    details: {
+                        stepIndex: context.stepIndex,
+                        totalSteps: context.totalSteps,
+                        warnings: issues,
+                    },
+                };
+            }
+            return {
+                gateId: 'resource',
+                status: 'PASS',
+                message: 'Resource limits not exceeded',
+                details: {
+                    stepIndex: context.stepIndex,
+                    totalSteps: context.totalSteps,
+                    remainingSteps: context.totalSteps - context.stepIndex - 1,
+                },
+            };
+        });
+        // Progress gate - checks execution progress
+        this.gateRegistry.register('progress', async (context) => {
+            const progress = ((context.stepIndex + 1) / context.totalSteps) * 100;
+            return {
+                gateId: 'progress',
+                status: 'PASS',
+                message: `Execution at ${progress.toFixed(0)}%`,
+                details: {
+                    stepIndex: context.stepIndex,
+                    totalSteps: context.totalSteps,
+                    percentComplete: progress,
+                },
+            };
+        });
+    }
+}
+// ============================================================================
+// Gate Registry Implementation
+// ============================================================================
+/**
+ * Create a gate registry
+ */
+export function createGateRegistry() {
+    const gates = new Map();
+    return {
+        register(gateId, check) {
+            gates.set(gateId, check);
+        },
+        get(gateId) {
+            return gates.get(gateId);
+        },
+        has(gateId) {
+            return gates.has(gateId);
+        },
+        list() {
+            return Array.from(gates.keys());
+        },
+    };
+}
+/**
+ * Create a step guard engine
+ */
+export function createStepGuardEngine(config) {
+    return new StepGuardEngine(config);
+}
+// ============================================================================
+// Progress Tracker
+// ============================================================================
+/**
+ * Progress tracker for workflow execution
+ *
+ * Tracks stage progress and emits events.
+ */
+export class ProgressTracker {
+    executionId;
+    agentId;
+    sessionId;
+    totalSteps;
+    onEvent;
+    constructor(executionId, agentId, totalSteps, onEvent, sessionId) {
+        this.executionId = executionId;
+        this.agentId = agentId;
+        this.sessionId = sessionId;
+        this.totalSteps = totalSteps;
+        this.onEvent = onEvent;
+    }
+    /**
+     * Emit starting event
+     * INV-PROG-001: Every stage emits starting event
+     */
+    starting(stepIndex, stepId, stepType) {
+        this.emit(stepIndex, stepId, stepType, 'starting');
+    }
+    /**
+     * Emit completed event
+     * INV-PROG-002: Every stage emits terminal event
+     */
+    completed(stepIndex, stepId, stepType, durationMs) {
+        this.emit(stepIndex, stepId, stepType, 'completed', { durationMs });
+    }
+    /**
+     * Emit failed event
+     */
+    failed(stepIndex, stepId, stepType, error, durationMs) {
+        this.emit(stepIndex, stepId, stepType, 'failed', { durationMs, error });
+    }
+    /**
+     * Emit skipped event
+     */
+    skipped(stepIndex, stepId, stepType) {
+        this.emit(stepIndex, stepId, stepType, 'skipped');
+    }
+    /**
+     * Emit blocked event
+     */
+    blocked(stepIndex, stepId, stepType, guardResult) {
+        this.emit(stepIndex, stepId, stepType, 'blocked', { guardResult });
+    }
+    /**
+     * Emit event
+     */
+    emit(stepIndex, stepId, stepType, status, options = {}) {
+        const eventOptions = { ...options };
+        if (this.sessionId !== undefined) {
+            eventOptions.sessionId = this.sessionId;
+        }
+        const event = createProgressEvent(this.executionId, this.agentId, stepIndex, this.totalSteps, stepId, stepType, status, eventOptions);
+        this.onEvent(event);
+    }
+}
+/**
+ * Create a progress tracker
+ */
+export function createProgressTracker(executionId, agentId, totalSteps, onEvent, sessionId) {
+    return new ProgressTracker(executionId, agentId, totalSteps, onEvent, sessionId);
+}
+//# sourceMappingURL=step-guard.js.map

package/dist/step-guard.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+import type { Workflow, WorkflowStep, RetryPolicy } from '@defai.digital/contracts';
+/**
+ * Result of a step execution
+ */
+export interface StepResult {
+    stepId: string;
+    success: boolean;
+    output?: unknown;
+    error?: StepError | undefined;
+    durationMs: number;
+    retryCount: number;
+}
+/**
+ * Error from step execution
+ */
+export interface StepError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    details?: Record<string, unknown> | undefined;
+}
+/**
+ * Result of a workflow execution
+ */
+export interface WorkflowResult {
+    workflowId: string;
+    success: boolean;
+    stepResults: StepResult[];
+    output?: unknown;
+    error?: WorkflowError | undefined;
+    totalDurationMs: number;
+}
+/**
+ * Error from workflow execution
+ */
+export interface WorkflowError {
+    code: string;
+    message: string;
+    failedStepId?: string | undefined;
+    details?: Record<string, unknown> | undefined;
+}
+/**
+ * Context passed to step executors
+ */
+export interface StepContext {
+    workflowId: string;
+    stepIndex: number;
+    previousResults: StepResult[];
+    input?: unknown;
+}
+/**
+ * Function that executes a single step
+ */
+export type StepExecutor = (step: WorkflowStep, context: StepContext) => Promise<StepResult>;
+/**
+ * Configuration for the workflow runner
+ */
+export interface WorkflowRunnerConfig {
+    /**
+     * Custom step executor (for dependency injection)
+     */
+    stepExecutor?: StepExecutor | undefined;
+    /**
+     * Default retry policy if step doesn't specify one
+     */
+    defaultRetryPolicy?: RetryPolicy | undefined;
+    /**
+     * Called before each step executes
+     */
+    onStepStart?: ((step: WorkflowStep, context: StepContext) => void) | undefined;
+    /**
+     * Called after each step completes
+     */
+    onStepComplete?: ((step: WorkflowStep, result: StepResult) => void) | undefined;
+}
+/**
+ * Validated and frozen workflow ready for execution
+ */
+export interface PreparedWorkflow {
+    readonly workflow: Readonly<Workflow>;
+    readonly stepIds: ReadonlySet<string>;
+}
+/**
+ * Error codes for workflow engine
+ */
+export declare const WorkflowErrorCodes: {
+    readonly VALIDATION_ERROR: "WORKFLOW_VALIDATION_ERROR";
+    readonly DUPLICATE_STEP_ID: "WORKFLOW_DUPLICATE_STEP_ID";
+    readonly STEP_EXECUTION_FAILED: "WORKFLOW_STEP_EXECUTION_FAILED";
+    readonly STEP_TIMEOUT: "WORKFLOW_STEP_TIMEOUT";
+    readonly MAX_RETRIES_EXCEEDED: "WORKFLOW_MAX_RETRIES_EXCEEDED";
+    readonly UNKNOWN_STEP_TYPE: "WORKFLOW_UNKNOWN_STEP_TYPE";
+};
+export type WorkflowErrorCode = (typeof WorkflowErrorCodes)[keyof typeof WorkflowErrorCodes];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAExC;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAE/E;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * Error codes for workflow engine
+ */
+export const WorkflowErrorCodes = {
+    VALIDATION_ERROR: 'WORKFLOW_VALIDATION_ERROR',
+    DUPLICATE_STEP_ID: 'WORKFLOW_DUPLICATE_STEP_ID',
+    STEP_EXECUTION_FAILED: 'WORKFLOW_STEP_EXECUTION_FAILED',
+    STEP_TIMEOUT: 'WORKFLOW_STEP_TIMEOUT',
+    MAX_RETRIES_EXCEEDED: 'WORKFLOW_MAX_RETRIES_EXCEEDED',
+    UNKNOWN_STEP_TYPE: 'WORKFLOW_UNKNOWN_STEP_TYPE',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqGA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB,EAAE,2BAA2B;IAC7C,iBAAiB,EAAE,4BAA4B;IAC/C,qBAAqB,EAAE,gCAAgC;IACvD,YAAY,EAAE,uBAAuB;IACrC,oBAAoB,EAAE,+BAA+B;IACrD,iBAAiB,EAAE,4BAA4B;CACvC,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,29 @@
+import { type Workflow } from '@defai.digital/contracts';
+import type { PreparedWorkflow, StepResult } from './types.js';
+/**
+ * Validation error for workflows
+ */
+export declare class WorkflowValidationError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Validates a workflow definition and checks invariants
+ * INV-WF-003: Schema strictness - unknown fields rejected
+ * INV-WF-004: Step ID uniqueness
+ */
+export declare function validateWorkflow(data: unknown): Workflow;
+/**
+ * Prepares a workflow for execution by validating and freezing it
+ * INV-WF-003: Schema strictness
+ * INV-WF-004: Step ID uniqueness
+ * INV-WF-005: Immutable definition
+ */
+export declare function prepareWorkflow(data: unknown): PreparedWorkflow;
+/**
+ * Deep freezes a step result to ensure immutability
+ * This prevents subsequent steps from accidentally modifying previous results
+ */
+export declare function deepFreezeStepResult(result: StepResult): Readonly<StepResult>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/D;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CA6BxD;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAa/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAE7E"}