@atom8n/ai-workflow-builder 1.2.0

package/dist/validation/checks/nodes.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNodes = validateNodes;
+const node_type_map_1 = require("../../validation/utils/node-type-map");
+function validateNodes(workflow, nodeTypes) {
+    const violations = [];
+    if (!workflow.nodes || workflow.nodes.length === 0) {
+        violations.push({
+            name: 'workflow-has-no-nodes',
+            type: 'critical',
+            description: 'Workflow has no nodes',
+            pointsDeducted: 50,
+        });
+        return violations;
+    }
+    const { nodeTypeMap, nodeTypesByName } = (0, node_type_map_1.createNodeTypeMaps)(nodeTypes);
+    const nodeCountByType = new Map();
+    for (const node of workflow.nodes) {
+        const currentCount = nodeCountByType.get(node.type) ?? 0;
+        nodeCountByType.set(node.type, currentCount + 1);
+    }
+    const checkedTypes = new Set();
+    for (const node of workflow.nodes) {
+        if (checkedTypes.has(node.type)) {
+            continue;
+        }
+        checkedTypes.add(node.type);
+        const nodeType = (0, node_type_map_1.getNodeTypeForNode)(node, nodeTypeMap, nodeTypesByName);
+        if (!nodeType?.maxNodes) {
+            continue;
+        }
+        const count = nodeCountByType.get(node.type) ?? 0;
+        if (count > nodeType.maxNodes) {
+            violations.push({
+                name: 'workflow-exceeds-max-nodes-limit',
+                type: 'critical',
+                description: `Workflow can only have ${nodeType.maxNodes} ${nodeType.displayName} node(s), but found ${count}`,
+                pointsDeducted: 50,
+            });
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=nodes.js.map

package/dist/validation/checks/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/validation/checks/nodes.ts"],"names":[],"mappings":";;AAOA,sCAwDC;AA5DD,oEAA0F;AAI1F,SAAgB,aAAa,CAC5B,QAAwB,EACxB,SAAiC;IAEjC,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uBAAuB;YACpC,cAAc,EAAE,EAAE;SAClB,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAA,kCAAkB,EAAC,SAAS,CAAC,CAAC;IAGvE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAID,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,SAAS;QACV,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5B,MAAM,QAAQ,GAAG,IAAA,kCAAkB,EAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QAExE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACzB,SAAS;QACV,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,kCAAkC;gBACxC,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,0BAA0B,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,uBAAuB,KAAK,EAAE;gBAC9G,cAAc,EAAE,EAAE;aAClB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/validation/checks/tools.d.ts

@@ -0,0 +1,4 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { SimpleWorkflow } from '../../types';
+import type { SingleEvaluatorResult } from '../types';
+export declare function validateTools(workflow: SimpleWorkflow, nodeTypes: INodeTypeDescription[]): SingleEvaluatorResult['violations'];

package/dist/validation/checks/tools.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTools = validateTools;
+const node_type_map_1 = require("../../validation/utils/node-type-map");
+const is_tool_1 = require("../utils/is-tool");
+const toolsWithoutParameters = [
+    '@n8n/n8n-nodes-langchain.toolCalculator',
+    '@n8n/n8n-nodes-langchain.toolVectorStore',
+    '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
+    '@n8n/n8n-nodes-langchain.mcpClientTool',
+    '@n8n/n8n-nodes-langchain.toolWikipedia',
+    '@n8n/n8n-nodes-langchain.toolSerpApi',
+];
+function validateTools(workflow, nodeTypes) {
+    const violations = [];
+    if (!workflow.nodes || workflow.nodes.length === 0) {
+        return violations;
+    }
+    const { nodeTypeMap, nodeTypesByName } = (0, node_type_map_1.createNodeTypeMaps)(nodeTypes);
+    for (const node of workflow.nodes) {
+        const nodeType = (0, node_type_map_1.getNodeTypeForNode)(node, nodeTypeMap, nodeTypesByName);
+        if (!nodeType) {
+            continue;
+        }
+        if ((0, is_tool_1.isTool)(nodeType) && !toolsWithoutParameters.includes(node.type)) {
+            if (!node.parameters || Object.keys(node.parameters).length === 0) {
+                violations.push({
+                    name: 'tool-node-has-no-parameters',
+                    type: 'major',
+                    description: `Tool node "${node.name}" has no parameters set.`,
+                    pointsDeducted: 20,
+                });
+            }
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=tools.js.map

package/dist/validation/checks/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/validation/checks/tools.ts"],"names":[],"mappings":";;AAiBA,sCA+BC;AA7CD,oEAA0F;AAG1F,8CAA0C;AAE1C,MAAM,sBAAsB,GAAG;IAC9B,yCAAyC;IACzC,0CAA0C;IAC1C,8CAA8C;IAC9C,wCAAwC;IACxC,wCAAwC;IACxC,sCAAsC;CACtC,CAAC;AAEF,SAAgB,aAAa,CAC5B,QAAwB,EACxB,SAAiC;IAEjC,MAAM,UAAU,GAAwC,EAAE,CAAC;IAE3D,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAA,kCAAkB,EAAC,SAAS,CAAC,CAAC;IAEvE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAA,kCAAkB,EAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QAED,IAAI,IAAA,gBAAM,EAAC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnE,UAAU,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,6BAA6B;oBACnC,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,cAAc,IAAI,CAAC,IAAI,0BAA0B;oBAC9D,cAAc,EAAE,EAAE;iBAClB,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/validation/checks/trigger.d.ts

@@ -0,0 +1,8 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { SimpleWorkflow } from '../../types';
+import type { ProgrammaticViolation, SingleEvaluatorResult } from '../types';
+export interface TriggerEvaluationResult extends SingleEvaluatorResult {
+    hasTrigger: boolean;
+    triggerNodes: string[];
+}
+export declare function validateTrigger(workflow: SimpleWorkflow, nodeTypes: INodeTypeDescription[]): ProgrammaticViolation[];

package/dist/validation/checks/trigger.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTrigger = validateTrigger;
+const node_type_map_1 = require("../../validation/utils/node-type-map");
+const isTriggerNode = (nodeType) => nodeType.group.includes('trigger');
+function validateTrigger(workflow, nodeTypes) {
+    const violations = [];
+    const triggerNodes = [];
+    if (!workflow.nodes || workflow.nodes.length === 0) {
+        return violations;
+    }
+    const { nodeTypeMap, nodeTypesByName } = (0, node_type_map_1.createNodeTypeMaps)(nodeTypes);
+    for (const node of workflow.nodes) {
+        const nodeType = (0, node_type_map_1.getNodeTypeForNode)(node, nodeTypeMap, nodeTypesByName);
+        if (!nodeType) {
+            continue;
+        }
+        if (isTriggerNode(nodeType)) {
+            triggerNodes.push(node.name);
+        }
+    }
+    const hasTrigger = triggerNodes.length > 0;
+    if (!hasTrigger) {
+        violations.push({
+            name: 'workflow-has-no-trigger',
+            type: 'critical',
+            description: 'Workflow must have at least one trigger node to start execution',
+            pointsDeducted: 50,
+        });
+    }
+    return violations;
+}
+//# sourceMappingURL=trigger.js.map

package/dist/validation/checks/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../../src/validation/checks/trigger.ts"],"names":[],"mappings":";;AAcA,0CAqCC;AAhDD,oEAA0F;AAS1F,MAAM,aAAa,GAAG,CAAC,QAA8B,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAE7F,SAAgB,eAAe,CAC9B,QAAwB,EACxB,SAAiC;IAEjC,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAA,kCAAkB,EAAC,SAAS,CAAC,CAAC;IAEvE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAA,kCAAkB,EAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QAExE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QAED,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE3C,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,iEAAiE;YAC9E,cAAc,EAAE,EAAE;SAClB,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/validation/programmatic.d.ts

@@ -0,0 +1,3 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { ProgrammaticChecksResult, ProgrammaticEvaluationInput } from './types';
+export declare function programmaticValidation(input: ProgrammaticEvaluationInput, nodeTypes: INodeTypeDescription[]): ProgrammaticChecksResult;

package/dist/validation/programmatic.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.programmaticValidation = programmaticValidation;
+const checks_1 = require("../validation/checks");
+function programmaticValidation(input, nodeTypes) {
+    const { generatedWorkflow } = input;
+    const connectionsValidationResult = (0, checks_1.validateConnections)(generatedWorkflow, nodeTypes);
+    const nodesValidationResult = (0, checks_1.validateNodes)(generatedWorkflow, nodeTypes);
+    const triggerValidationResult = (0, checks_1.validateTrigger)(generatedWorkflow, nodeTypes);
+    const agentPromptValidationResult = (0, checks_1.validateAgentPrompt)(generatedWorkflow);
+    const toolsValidationResult = (0, checks_1.validateTools)(generatedWorkflow, nodeTypes);
+    const fromAiValidationResult = (0, checks_1.validateFromAi)(generatedWorkflow, nodeTypes);
+    const credentialsValidationResult = (0, checks_1.validateCredentials)(generatedWorkflow);
+    return {
+        connections: connectionsValidationResult,
+        nodes: nodesValidationResult,
+        trigger: triggerValidationResult,
+        agentPrompt: agentPromptValidationResult,
+        tools: toolsValidationResult,
+        fromAi: fromAiValidationResult,
+        credentials: credentialsValidationResult,
+    };
+}
+//# sourceMappingURL=programmatic.js.map

package/dist/validation/programmatic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmatic.js","sourceRoot":"","sources":["../../src/validation/programmatic.ts"],"names":[],"mappings":";;AAcA,wDAuBC;AAnCD,gDAQ6B;AAI7B,SAAgB,sBAAsB,CACrC,KAAkC,EAClC,SAAiC;IAEjC,MAAM,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC;IAEpC,MAAM,2BAA2B,GAAG,IAAA,4BAAmB,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACtF,MAAM,qBAAqB,GAAG,IAAA,sBAAa,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,uBAAuB,GAAG,IAAA,wBAAe,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC9E,MAAM,2BAA2B,GAAG,IAAA,4BAAmB,EAAC,iBAAiB,CAAC,CAAC;IAC3E,MAAM,qBAAqB,GAAG,IAAA,sBAAa,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,sBAAsB,GAAG,IAAA,uBAAc,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,2BAA2B,GAAG,IAAA,4BAAmB,EAAC,iBAAiB,CAAC,CAAC;IAE3E,OAAO;QACN,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,2BAA2B;KACxC,CAAC;AACH,CAAC"}

package/dist/validation/types.d.ts

@@ -0,0 +1,52 @@
+import type { INodeTypeDescription, NodeConnectionType } from 'n8n-workflow';
+import type { SimpleWorkflow } from '../types';
+export type ProgrammaticViolationType = 'critical' | 'major' | 'minor';
+export declare const PROGRAMMATIC_VIOLATION_NAMES: readonly ["tool-node-has-no-parameters", "tool-node-static-parameters", "agent-static-prompt", "agent-no-system-prompt", "non-tool-node-uses-fromai", "workflow-has-no-nodes", "workflow-has-no-trigger", "workflow-exceeds-max-nodes-limit", "node-missing-required-input", "node-unsupported-connection-input", "node-merge-single-input", "node-merge-incorrect-num-inputs", "node-merge-missing-input", "sub-node-not-connected", "node-type-not-found", "failed-to-resolve-connections", "workflow-similarity-node-insert", "workflow-similarity-node-delete", "workflow-similarity-node-substitute", "workflow-similarity-edge-insert", "workflow-similarity-edge-delete", "workflow-similarity-edge-substitute", "workflow-similarity-evaluation-failed", "http-request-hardcoded-credentials", "set-node-credential-field"];
+export type ProgrammaticViolationName = (typeof PROGRAMMATIC_VIOLATION_NAMES)[number];
+export type TelemetryValidationStatus = Record<ProgrammaticViolationName, 'pass' | 'fail'>;
+export interface ProgrammaticViolation {
+    name: ProgrammaticViolationName;
+    type: ProgrammaticViolationType;
+    description: string;
+    pointsDeducted: number;
+}
+export interface SingleEvaluatorResult {
+    violations: ProgrammaticViolation[];
+    score: number;
+}
+export interface ProgrammaticChecksResult {
+    connections: ProgrammaticViolation[];
+    nodes: ProgrammaticViolation[];
+    trigger: ProgrammaticViolation[];
+    agentPrompt: ProgrammaticViolation[];
+    tools: ProgrammaticViolation[];
+    fromAi: ProgrammaticViolation[];
+    credentials: ProgrammaticViolation[];
+}
+export interface ProgrammaticEvaluationResult {
+    overallScore: number;
+    connections: SingleEvaluatorResult;
+    nodes: SingleEvaluatorResult;
+    trigger: SingleEvaluatorResult;
+    agentPrompt: SingleEvaluatorResult;
+    tools: SingleEvaluatorResult;
+    fromAi: SingleEvaluatorResult;
+    credentials: SingleEvaluatorResult;
+    similarity: SingleEvaluatorResult | null;
+}
+export interface ProgrammaticEvaluationInput {
+    generatedWorkflow: SimpleWorkflow;
+    userPrompt?: string;
+    referenceWorkflow?: SimpleWorkflow;
+    referenceWorkflows?: SimpleWorkflow[];
+    preset?: 'strict' | 'standard' | 'lenient';
+}
+export interface NodeResolvedConnectionTypesInfo {
+    node: SimpleWorkflow['nodes'][0];
+    nodeType: INodeTypeDescription;
+    resolvedInputs?: Array<{
+        type: NodeConnectionType;
+        required: boolean;
+    }>;
+    resolvedOutputs?: Set<NodeConnectionType>;
+}

package/dist/validation/types.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROGRAMMATIC_VIOLATION_NAMES = void 0;
+exports.PROGRAMMATIC_VIOLATION_NAMES = [
+    'tool-node-has-no-parameters',
+    'tool-node-static-parameters',
+    'agent-static-prompt',
+    'agent-no-system-prompt',
+    'non-tool-node-uses-fromai',
+    'workflow-has-no-nodes',
+    'workflow-has-no-trigger',
+    'workflow-exceeds-max-nodes-limit',
+    'node-missing-required-input',
+    'node-unsupported-connection-input',
+    'node-merge-single-input',
+    'node-merge-incorrect-num-inputs',
+    'node-merge-missing-input',
+    'sub-node-not-connected',
+    'node-type-not-found',
+    'failed-to-resolve-connections',
+    'workflow-similarity-node-insert',
+    'workflow-similarity-node-delete',
+    'workflow-similarity-node-substitute',
+    'workflow-similarity-edge-insert',
+    'workflow-similarity-edge-delete',
+    'workflow-similarity-edge-substitute',
+    'workflow-similarity-evaluation-failed',
+    'http-request-hardcoded-credentials',
+    'set-node-credential-field',
+];
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":";;;AAMa,QAAA,4BAA4B,GAAG;IAC3C,6BAA6B;IAE7B,6BAA6B;IAC7B,qBAAqB;IACrB,wBAAwB;IACxB,2BAA2B;IAC3B,uBAAuB;IACvB,yBAAyB;IACzB,kCAAkC;IAClC,6BAA6B;IAC7B,mCAAmC;IACnC,yBAAyB;IACzB,iCAAiC;IACjC,0BAA0B;IAC1B,wBAAwB;IACxB,qBAAqB;IACrB,+BAA+B;IAC/B,iCAAiC;IACjC,iCAAiC;IACjC,qCAAqC;IACrC,iCAAiC;IACjC,iCAAiC;IACjC,qCAAqC;IACrC,uCAAuC;IACvC,oCAAoC;IACpC,2BAA2B;CAClB,CAAC"}

package/dist/validation/utils/expressions.d.ts

@@ -0,0 +1,3 @@
+import type { INodeParameters } from 'n8n-workflow';
+export declare function containsExpression(value: unknown): boolean;
+export declare function nodeParametersContainExpression(parameters: INodeParameters): boolean;

package/dist/validation/utils/expressions.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.containsExpression = containsExpression;
+exports.nodeParametersContainExpression = nodeParametersContainExpression;
+const n8n_workflow_1 = require("n8n-workflow");
+function containsExpression(value) {
+    if (!(0, n8n_workflow_1.isExpression)(value)) {
+        return false;
+    }
+    return /\{\{.*(\$\(.*?\))|(\$\w+).*}}/.test(value);
+}
+function nodeParametersContainExpression(parameters) {
+    for (const value of Object.values(parameters)) {
+        if (containsExpression(value)) {
+            return true;
+        }
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            if (nodeParametersContainExpression(value)) {
+                return true;
+            }
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (containsExpression(item)) {
+                    return true;
+                }
+                if (item && typeof item === 'object') {
+                    if (nodeParametersContainExpression(item)) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=expressions.js.map

package/dist/validation/utils/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../../src/validation/utils/expressions.ts"],"names":[],"mappings":";;AAGA,gDAMC;AAED,0EA4BC;AAtCD,+CAA4C;AAE5C,SAAgB,kBAAkB,CAAC,KAAc;IAChD,IAAI,CAAC,IAAA,2BAAY,EAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,+BAA+B,CAAC,UAA2B;IAC1E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,IAAI,+BAA+B,CAAC,KAAwB,CAAC,EAAE,CAAC;gBAC/D,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,OAAO,IAAI,CAAC;gBACb,CAAC;gBAED,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtC,IAAI,+BAA+B,CAAC,IAAuB,CAAC,EAAE,CAAC;wBAC9D,OAAO,IAAI,CAAC;oBACb,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/validation/utils/is-tool.d.ts

@@ -0,0 +1,2 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+export declare function isTool(nodeType: INodeTypeDescription): boolean;

package/dist/validation/utils/is-tool.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTool = isTool;
+function isTool(nodeType) {
+    return nodeType.codex?.subcategories?.AI?.includes('Tools') ?? false;
+}
+//# sourceMappingURL=is-tool.js.map

package/dist/validation/utils/is-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-tool.js","sourceRoot":"","sources":["../../../src/validation/utils/is-tool.ts"],"names":[],"mappings":";;AAEA,wBAEC;AAFD,SAAgB,MAAM,CAAC,QAA8B;IACpD,OAAO,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;AACtE,CAAC"}

package/dist/validation/utils/node-type-map.d.ts

@@ -0,0 +1,8 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { SimpleWorkflow } from '../../types';
+export declare function createNodeTypeMap(nodeTypes: INodeTypeDescription[]): Map<string, INodeTypeDescription>;
+export declare function getNodeTypeForNode(node: SimpleWorkflow['nodes'][number], nodeTypeMap: Map<string, INodeTypeDescription>, nodeTypesByName: Map<string, INodeTypeDescription>): INodeTypeDescription | undefined;
+export declare function createNodeTypeMaps(nodeTypes: INodeTypeDescription[]): {
+    nodeTypeMap: Map<string, INodeTypeDescription>;
+    nodeTypesByName: Map<string, INodeTypeDescription>;
+};

package/dist/validation/utils/node-type-map.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeTypeMap = createNodeTypeMap;
+exports.getNodeTypeForNode = getNodeTypeForNode;
+exports.createNodeTypeMaps = createNodeTypeMaps;
+function getNodeTypeVersions(nodeType) {
+    const version = nodeType.version;
+    if (typeof version === 'number') {
+        return [version];
+    }
+    if (Array.isArray(version) && version.length > 0 && typeof version[0] === 'number') {
+        return version;
+    }
+    return [1];
+}
+function getDefaultVersion(nodeType) {
+    const defaultVersion = nodeType.defaultVersion;
+    if (typeof defaultVersion === 'number') {
+        return defaultVersion;
+    }
+    const versions = getNodeTypeVersions(nodeType);
+    return Math.max(...versions);
+}
+function createNodeTypeMap(nodeTypes) {
+    return new Map(nodeTypes.flatMap((nodeType) => {
+        const versions = getNodeTypeVersions(nodeType);
+        return versions.map((version) => [`${nodeType.name}-${version}`, nodeType]);
+    }));
+}
+function resolveNodeVersion(node, nodeTypesByName) {
+    if (node.typeVersion !== undefined) {
+        return node.typeVersion;
+    }
+    const nodeType = nodeTypesByName.get(node.type);
+    if (nodeType) {
+        return getDefaultVersion(nodeType);
+    }
+    return 1;
+}
+function getNodeTypeForNode(node, nodeTypeMap, nodeTypesByName) {
+    const version = resolveNodeVersion(node, nodeTypesByName);
+    return nodeTypeMap.get(`${node.type}-${version}`);
+}
+function createNodeTypeMaps(nodeTypes) {
+    const nodeTypesArray = Array.from(nodeTypes);
+    const nodeTypeMap = createNodeTypeMap(nodeTypesArray);
+    const nodeTypesByName = new Map(nodeTypesArray.map((type) => [type.name, type]));
+    return { nodeTypeMap, nodeTypesByName };
+}
+//# sourceMappingURL=node-type-map.js.map

package/dist/validation/utils/node-type-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-type-map.js","sourceRoot":"","sources":["../../../src/validation/utils/node-type-map.ts"],"names":[],"mappings":";;AA+CA,8CASC;AA4BD,gDAOC;AAQD,gDAYC;AArGD,SAAS,mBAAmB,CAAC,QAA8B;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAEjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpF,OAAO,OAAO,CAAC;IAChB,CAAC;IAGD,OAAO,CAAC,CAAC,CAAC,CAAC;AACZ,CAAC;AAOD,SAAS,iBAAiB,CAAC,QAA8B;IACxD,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;IAE/C,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAQD,SAAgB,iBAAiB,CAChC,SAAiC;IAEjC,OAAO,IAAI,GAAG,CACb,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,QAAQ,CAAU,CAAC,CAAC;IACtF,CAAC,CAAC,CACF,CAAC;AACH,CAAC;AAQD,SAAS,kBAAkB,CAC1B,IAAqC,EACrC,eAAkD;IAElD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,CAAC;AACV,CAAC;AAMD,SAAgB,kBAAkB,CACjC,IAAqC,EACrC,WAA8C,EAC9C,eAAkD;IAElD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC;AAQD,SAAgB,kBAAkB,CAAC,SAAiC;IAKnE,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC,CACxD,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACzC,CAAC"}

package/dist/validation/utils/resolve-connections.d.ts

@@ -0,0 +1,8 @@
+import type { ExpressionString, INodeInputConfiguration, NodeConnectionType } from 'n8n-workflow';
+import type { NodeResolvedConnectionTypesInfo } from '../types';
+export declare function resolveConnections<T = INodeInputConfiguration>(connections: Array<NodeConnectionType | T> | ExpressionString, parameters: Record<string, unknown>, nodeVersion: number): Array<NodeConnectionType | T>;
+export declare function resolveNodeOutputs(nodeInfo: NodeResolvedConnectionTypesInfo): Set<NodeConnectionType>;
+export declare function resolveNodeInputs(nodeInfo: NodeResolvedConnectionTypesInfo): Array<{
+    type: NodeConnectionType;
+    required: boolean;
+}>;

package/dist/validation/utils/resolve-connections.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConnections = resolveConnections;
+exports.resolveNodeOutputs = resolveNodeOutputs;
+exports.resolveNodeInputs = resolveNodeInputs;
+const n8n_workflow_1 = require("n8n-workflow");
+function isDynamicConnectionsExpression(connections) {
+    return (typeof connections === 'string' && connections.startsWith('={{') && connections.endsWith('}}'));
+}
+function resolveConnections(connections, parameters, nodeVersion) {
+    if (Array.isArray(connections)) {
+        return connections;
+    }
+    if (isDynamicConnectionsExpression(connections)) {
+        const context = {};
+        n8n_workflow_1.Expression.initializeGlobalContext(context);
+        Object.assign(context, {
+            $parameter: parameters,
+            $nodeVersion: nodeVersion,
+        });
+        const result = n8n_workflow_1.Expression.resolveWithoutWorkflow(connections.substring(1), context);
+        if (!Array.isArray(result)) {
+            throw new Error('Expression did not resolve to an array');
+        }
+        return result;
+    }
+    throw new Error('Unable to resolve connections');
+}
+function resolveNodeOutputs(nodeInfo) {
+    const outputTypes = new Set();
+    if (!nodeInfo.nodeType.outputs) {
+        return outputTypes;
+    }
+    const resolvedOutputs = resolveConnections(nodeInfo.nodeType.outputs, nodeInfo.node.parameters, nodeInfo.node.typeVersion || 1);
+    for (const output of resolvedOutputs) {
+        if (typeof output === 'string') {
+            outputTypes.add(output);
+        }
+        else if (typeof output === 'object' && 'type' in output) {
+            outputTypes.add(output.type);
+        }
+    }
+    return outputTypes;
+}
+function resolveNodeInputs(nodeInfo) {
+    const requiredInputs = [];
+    if (!nodeInfo.nodeType.inputs) {
+        return requiredInputs;
+    }
+    const resolvedInputs = resolveConnections(nodeInfo.nodeType.inputs, nodeInfo.node.parameters, nodeInfo.node.typeVersion || 1);
+    for (const input of resolvedInputs) {
+        if (typeof input === 'string') {
+            requiredInputs.push({ type: input, required: input === 'main' });
+        }
+        else if (typeof input === 'object' && 'type' in input) {
+            requiredInputs.push({
+                type: input.type,
+                required: input.type === 'main' ? true : (input.required ?? false),
+            });
+        }
+    }
+    return requiredInputs;
+}
+//# sourceMappingURL=resolve-connections.js.map

package/dist/validation/utils/resolve-connections.js.map

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

package/dist/workflow-builder-agent.d.ts

@@ -0,0 +1,72 @@
+import type { Callbacks } from '@langchain/core/callbacks/manager';
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { LangChainTracer } from '@langchain/core/tracers/tracer_langchain';
+import type { MemorySaver, StateSnapshot } from '@langchain/langgraph';
+import type { Logger } from '@n8n/backend-common';
+import { type INodeTypeDescription, type IRunExecutionData, type IWorkflowBase, type NodeExecutionSchema } from 'n8n-workflow';
+import { WorkflowState } from './workflow-state';
+export type TypedStateSnapshot = Omit<StateSnapshot, 'values'> & {
+    values: typeof WorkflowState.State;
+};
+export declare function shouldModifyState(state: typeof WorkflowState.State, autoCompactThresholdTokens: number): 'compact_messages' | 'delete_messages' | 'create_workflow_name' | 'auto_compact_messages' | 'agent';
+export interface WorkflowBuilderAgentConfig {
+    parsedNodeTypes: INodeTypeDescription[];
+    llmSimpleTask: BaseChatModel;
+    llmComplexTask: BaseChatModel;
+    logger?: Logger;
+    checkpointer: MemorySaver;
+    tracer?: LangChainTracer;
+    autoCompactThresholdTokens?: number;
+    instanceUrl?: string;
+    onGenerationSuccess?: () => Promise<void>;
+    runMetadata?: Record<string, unknown>;
+    featureFlags?: BuilderFeatureFlags;
+}
+export interface ExpressionValue {
+    expression: string;
+    resolvedValue: unknown;
+    nodeType?: string;
+}
+export interface BuilderFeatureFlags {
+    templateExamples?: boolean;
+    multiAgent?: boolean;
+}
+export interface ChatPayload {
+    id: string;
+    message: string;
+    workflowContext?: {
+        executionSchema?: NodeExecutionSchema[];
+        currentWorkflow?: Partial<IWorkflowBase>;
+        executionData?: IRunExecutionData['resultData'];
+        expressionValues?: Record<string, ExpressionValue[]>;
+    };
+    featureFlags?: BuilderFeatureFlags;
+    versionId?: string;
+}
+export declare class WorkflowBuilderAgent {
+    private checkpointer;
+    private parsedNodeTypes;
+    private llmSimpleTask;
+    private llmComplexTask;
+    private logger?;
+    private tracer?;
+    private autoCompactThresholdTokens;
+    private instanceUrl?;
+    private onGenerationSuccess?;
+    private runMetadata?;
+    constructor(config: WorkflowBuilderAgentConfig);
+    private getBuilderTools;
+    private createMultiAgentGraph;
+    private createLegacyWorkflow;
+    private createWorkflow;
+    getState(workflowId?: string, userId?: string): Promise<TypedStateSnapshot>;
+    private getDefaultWorkflowJSON;
+    chat(payload: ChatPayload, userId?: string, abortSignal?: AbortSignal, externalCallbacks?: Callbacks): AsyncGenerator<import("./types").StreamOutput, void, unknown>;
+    private validateMessageLength;
+    private setupAgentAndConfigs;
+    private createAgentStream;
+    private handleStreamError;
+    private processAgentStream;
+    private handleAgentStreamError;
+    private getInvalidRequestError;
+}