agents / Exports / UniversalWorkflowValidator
Class: UniversalWorkflowValidator
Universal Workflow Validator
Provides comprehensive validation for UniversalWorkflowStructure:
- Structure integrity checking
- Node and edge validation
- Reference integrity verification
- Circular reference detection
- Position and layout validation
- Metadata completeness checking
Hierarchy
BaseWorkflowValidator<UniversalWorkflowStructure>↳
UniversalWorkflowValidator
Table of contents
Constructors
Properties
Methods
Constructors
constructor
• new UniversalWorkflowValidator(logger?): UniversalWorkflowValidator
Constructor with dependency injection
Parameters
| Name | Type | Description |
|---|---|---|
logger? | SimpleLogger | Logger instance (optional, defaults to SilentLogger) |
Returns
Overrides
BaseWorkflowValidator.constructor
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:56
Properties
enabled
• enabled: boolean
Enable/disable state following BaseModule pattern
Inherited from
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:84
name
• Readonly name: "UniversalWorkflowValidator"
Validator name for identification
Overrides
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:46
version
• Readonly version: "1.0.0"
Validator version
Overrides
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:47
dataFormat
• Readonly dataFormat: "universal-workflow"
Data format that this validator handles
Overrides
BaseWorkflowValidator.dataFormat
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:48
availableRules
• Readonly availableRules: ("structure-integrity" | "node-validity" | "edge-validity" | "id-uniqueness" | "reference-integrity" | "circular-references" | "position-validity" | "layout-consistency" | "metadata-completeness" | "dimension-validity")[]
Available validation rules
Overrides
BaseWorkflowValidator.availableRules
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:49
Methods
validate
▸ validate(data, options?): Promise<ValidationResult>
Main validation method with comprehensive error handling and metrics
Parameters
| Name | Type | Description |
|---|---|---|
data | UniversalWorkflowStructure | Workflow data to validate |
options | ValidationOptions | Validation options |
Returns
Promise<ValidationResult>
Promise resolving to validation result
Inherited from
BaseWorkflowValidator.validate
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:135
validateRule
▸ validateRule(data, rule, options?): Promise<ValidationResult>
Validate specific rule
Parameters
| Name | Type | Description |
|---|---|---|
data | UniversalWorkflowStructure | Workflow data to validate |
rule | string | Specific rule to apply |
options | ValidationOptions | Validation options |
Returns
Promise<ValidationResult>
Promise resolving to validation result for this rule
Inherited from
BaseWorkflowValidator.validateRule
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:228
getRuleDescriptions
▸ getRuleDescriptions(): Map<string, { description: string ; severity: ValidationSeverity ; category: string ; enabled: boolean }>
Get available validation rules with descriptions
Returns
Map<string, { description: string ; severity: ValidationSeverity ; category: string ; enabled: boolean }>
Map of rule names to descriptions
Inherited from
BaseWorkflowValidator.getRuleDescriptions
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:286
configureRules
▸ configureRules(rules): void
Enable or disable specific validation rules
Parameters
| Name | Type | Description |
|---|---|---|
rules | Map<string, boolean> | Map of rule names to enabled status |
Returns
void
Inherited from
BaseWorkflowValidator.configureRules
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:314
autoRecover
▸ autoRecover(data, issues): Promise<{ recoveredData: UniversalWorkflowStructure ; recoveryResult: { success: boolean ; issuesFixed: ValidationIssue[] ; remainingIssues: ValidationIssue[] ; appliedFixes: string[] } }>
Default auto-recovery implementation Can be overridden by subclasses for specific recovery strategies
Parameters
| Name | Type | Description |
|---|---|---|
data | UniversalWorkflowStructure | Original workflow data |
issues | ValidationIssue[] | Validation issues to recover from |
Returns
Promise<{ recoveredData: UniversalWorkflowStructure ; recoveryResult: { success: boolean ; issuesFixed: ValidationIssue[] ; remainingIssues: ValidationIssue[] ; appliedFixes: string[] } }>
Promise resolving to recovered data and recovery result
Inherited from
BaseWorkflowValidator.autoRecover
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:334
getStats
▸ getStats(): Object
Get validator statistics
Returns
Object
Validator performance metrics
| Name | Type |
|---|---|
totalValidations | number |
successfulValidations | number |
failedValidations | number |
averageProcessingTime | number |
averageIssueCount | number |
mostCommonIssues | { rule: string ; count: number ; severity: ValidationSeverity }[] |
lastValidationAt | undefined | Date |
Inherited from
BaseWorkflowValidator.getStats
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:361
resetStats
▸ resetStats(): void
Reset validator statistics
Returns
void
Inherited from
BaseWorkflowValidator.resetStats
Defined in
packages/agents/src/abstracts/base-workflow-validator.ts:392
canValidate
▸ canValidate(data): data is UniversalWorkflowStructure
Enhanced type checking for UniversalWorkflowStructure
Parameters
| Name | Type |
|---|---|
data | WorkflowData |
Returns
data is UniversalWorkflowStructure
Overrides
BaseWorkflowValidator.canValidate
Defined in
packages/agents/src/validators/universal-workflow-validator.ts:803