mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-03-17 07:53:08 +00:00
25b8a8145d
* feat(auto-fixer): add 5 connection structure fix types Add automatic repair for malformed workflow connections commonly generated by AI models: - connection-numeric-keys: "0","1" keys → main[0], main[1] - connection-invalid-type: type:"0" → type:"main" (or parent key) - connection-id-to-name: node ID refs → node name refs - connection-duplicate-removal: dedup identical connection entries - connection-input-index: out-of-bounds input index → clamped Includes collision-safe ID-to-name renames, medium confidence on merge conflicts and index clamping, shared CONNECTION_FIX_TYPES constant, and 24 unit tests. Concieved by Romuald Członkowski - www.aiadvisors.pl/en * feat(validator): detect IF/Switch/Filter conditional branch fan-out misuse Add CONDITIONAL_BRANCH_FANOUT warning when conditional nodes have all connections on main[0] with higher outputs empty, indicating both branches execute together instead of being split by condition. Extract getShortNodeType() and getConditionalOutputInfo() helpers to deduplicate conditional node detection logic. Conceived by Romuald Czlonkowski - https://www.aiadvisors.pl/en
112 lines
3.3 KiB
TypeScript
112 lines
3.3 KiB
TypeScript
import { NodeRepository } from '../database/node-repository';
|
|
import { EnhancedConfigValidator } from './enhanced-config-validator';
|
|
export declare const VALID_CONNECTION_TYPES: Set<string>;
|
|
interface WorkflowNode {
|
|
id: string;
|
|
name: string;
|
|
type: string;
|
|
position: [number, number];
|
|
parameters: any;
|
|
credentials?: any;
|
|
disabled?: boolean;
|
|
notes?: string;
|
|
notesInFlow?: boolean;
|
|
typeVersion?: number;
|
|
continueOnFail?: boolean;
|
|
onError?: 'continueRegularOutput' | 'continueErrorOutput' | 'stopWorkflow';
|
|
retryOnFail?: boolean;
|
|
maxTries?: number;
|
|
waitBetweenTries?: number;
|
|
alwaysOutputData?: boolean;
|
|
executeOnce?: boolean;
|
|
}
|
|
interface WorkflowConnection {
|
|
[sourceNode: string]: {
|
|
[outputType: string]: Array<Array<{
|
|
node: string;
|
|
type: string;
|
|
index: number;
|
|
}>>;
|
|
};
|
|
}
|
|
interface WorkflowJson {
|
|
name?: string;
|
|
nodes: WorkflowNode[];
|
|
connections: WorkflowConnection;
|
|
settings?: any;
|
|
staticData?: any;
|
|
pinData?: any;
|
|
meta?: any;
|
|
}
|
|
export interface ValidationIssue {
|
|
type: 'error' | 'warning';
|
|
nodeId?: string;
|
|
nodeName?: string;
|
|
message: string;
|
|
details?: any;
|
|
code?: string;
|
|
fix?: {
|
|
type: string;
|
|
currentType?: string;
|
|
suggestedType?: string;
|
|
description?: string;
|
|
};
|
|
}
|
|
export interface WorkflowValidationResult {
|
|
valid: boolean;
|
|
errors: ValidationIssue[];
|
|
warnings: ValidationIssue[];
|
|
statistics: {
|
|
totalNodes: number;
|
|
enabledNodes: number;
|
|
triggerNodes: number;
|
|
validConnections: number;
|
|
invalidConnections: number;
|
|
expressionsValidated: number;
|
|
};
|
|
suggestions: string[];
|
|
}
|
|
export declare class WorkflowValidator {
|
|
private nodeRepository;
|
|
private nodeValidator;
|
|
private currentWorkflow;
|
|
private similarityService;
|
|
constructor(nodeRepository: NodeRepository, nodeValidator: typeof EnhancedConfigValidator);
|
|
validateWorkflow(workflow: WorkflowJson, options?: {
|
|
validateNodes?: boolean;
|
|
validateConnections?: boolean;
|
|
validateExpressions?: boolean;
|
|
profile?: 'minimal' | 'runtime' | 'ai-friendly' | 'strict';
|
|
}): Promise<WorkflowValidationResult>;
|
|
private validateWorkflowStructure;
|
|
private validateAllNodes;
|
|
private validateConnections;
|
|
private validateConnectionOutputs;
|
|
private validateErrorOutputConfiguration;
|
|
private validateAIToolConnection;
|
|
private validateAIToolSource;
|
|
private getNodeOutputTypes;
|
|
private validateNotAISubNode;
|
|
private getShortNodeType;
|
|
private getConditionalOutputInfo;
|
|
private validateOutputIndexBounds;
|
|
private validateConditionalBranchUsage;
|
|
private validateInputIndexBounds;
|
|
private flagOrphanedNodes;
|
|
private validateTriggerReachability;
|
|
private hasCycle;
|
|
private validateExpressions;
|
|
private countExpressionsInObject;
|
|
private nodeHasInput;
|
|
private checkWorkflowPatterns;
|
|
private getLongestLinearChain;
|
|
private generateSuggestions;
|
|
private checkNodeErrorHandling;
|
|
private checkWebhookErrorHandling;
|
|
private generateErrorHandlingSuggestions;
|
|
private validateSplitInBatchesConnection;
|
|
private checkForLoopBack;
|
|
private addErrorRecoverySuggestions;
|
|
}
|
|
export {};
|
|
//# sourceMappingURL=workflow-validator.d.ts.map
|