@n8n/workflow-sdk 0.25.1 → 0.27.0

package/dist/mock-data/prompt.js

@@ -10,7 +10,7 @@ exports.PIN_DATA_SYSTEM_PROMPT = `You are a test data generator for n8n workflow
 
 RULES:
 1. Data must be consistent across nodes. If node A creates an entity with id "abc-123", downstream nodes referencing that entity must use "abc-123". When a node's "Direct downstream consumers" are listed, emit EXACTLY the field names their parameters/expressions/code read (e.g. a Code node reading item.json.last_details requires a field named "last_details") — never rename or synonymize them.
-2. Generate 1-2 items per node.
+2. Generate 1-2 items per node — UNLESS the Test Scenario calls for zero items for a node (no stored data, empty list, nothing new, all already seen): then that node's value MUST be an empty array []. NEVER represent "no data" as a single item with no fields ({}): a phantom empty item flows downstream and corrupts the run; the empty array IS the correct representation.
 3. When a JSON Schema is provided, follow its structure exactly.
 4. When no schema is provided, generate a realistic response based on the node type, resource, and operation.
 5. Use realistic but clearly fake values (e.g., "jane@example.com", "proj_abc123").
@@ -18,7 +18,7 @@ RULES:
 7. AI root nodes (Agent/Chain) have NODE-TYPE-SPECIFIC output shapes — follow each node's schema or "AI ROOT OUTPUT SHAPE" instruction exactly and never invent a different envelope key. Summary: agent wraps in { "output": ... } (a parsed object matching the parser schema when one is attached, otherwise a plain text string — never a JSON-encoded string); chainLlm uses { "text": "<string>" } without a parser, or { "output": <parsed object> } like agent when a parser is attached; chainRetrievalQa uses { "response": "<string>" }; chainSummarization uses { "output": { "output_text": "<summary>" } }; informationExtractor wraps the extracted fields in { "output": <object> }; textClassifier passes the input item through unchanged; sentimentAnalysis is the input item plus a "sentimentAnalysis" object.
 8. CRITICAL: If a "Test Scenario" section is provided, it is the authoritative test state and OVERRIDES everything else, including the general data context and your own sense of realism. When it describes stored/previous records (e.g. "the store already holds a record with status X"), exact values, counts, literal substrings, or that stored data matches current data, reproduce those constraints EXACTLY — never substitute more "interesting" or more typical data. A boring no-change/empty/matching case is usually the point of the test.
 9. Return ONLY a valid JSON object, no explanation or markdown fencing.
-10. CRITICAL: You MUST generate data for EVERY node listed in "Nodes Requiring Mock Data". Never skip a node, even if the test scenario describes an empty or error response. An empty response is still valid data.`;
+10. CRITICAL: You MUST generate data for EVERY node listed in "Nodes Requiring Mock Data". Never skip a node, even if the test scenario describes an empty or error response. An empty response is still valid data — represent it as an empty array [], never as [{}].`;
 const MAX_EMBEDDED_SCHEMA_CHARS = 3000;
 function buildNodeSchemaSection(ctx) {
     const lines = [];
@@ -36,7 +36,7 @@ function buildNodeSchemaSection(ctx) {
             lines.push(`- AI ROOT OUTPUT SHAPE: every item MUST be ${(0, ai_root_shapes_1.describeAiRootShape)(ctx.nodeType)}`);
         }
         if (ctx.outputParser?.schemaText) {
-            const envelopeKey = (0, ai_root_shapes_1.findEnvelopeKey)(ctx.schema);
+            const envelopeKey = (0, context_1.resolveEnvelopeKey)(ctx.nodeType, ctx.schema);
             const target = envelopeKey ? `The \`${envelopeKey}\` object` : 'The top-level `json` fields';
             const label = ctx.outputParser.schemaIsExample
                 ? `- ${target} must have the same shape and field names as this example:`
@@ -51,6 +51,14 @@ function buildNodeSchemaSection(ctx) {
             lines.push('```');
         }
     }
+    if (ctx.dataTableColumns && ctx.dataTableColumns.length > 0) {
+        const columnList = ctx.dataTableColumns.map((c) => `${c.name} (${c.type})`).join(', ');
+        lines.push('- REAL Data Table columns — every pinned row MUST contain exactly these keys plus ' +
+            '`id` (a NUMBER, auto-incremented: 1, 2, 3…), `createdAt`, `updatedAt` (ISO ' +
+            'timestamps), and no others (values may be empty/null when the scenario calls ' +
+            `for it): ${columnList}`);
+        return lines;
+    }
     if (ctx.schema) {
         const schemaStr = JSON.stringify(ctx.schema, null, 2);
         const truncated = schemaStr.length > MAX_EMBEDDED_SCHEMA_CHARS

package/dist/mock-data/prompt.js.map

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

package/dist/mock-data/types.d.ts

@@ -10,6 +10,16 @@ export interface OutputParserContext {
     schemaText?: string;
     schemaIsExample: boolean;
 }
+export interface DataTableColumnInfo {
+    name: string;
+    type: string;
+}
+export interface DeclaredFieldContract {
+    keys: string[];
+    envelopeKey?: string;
+    exact: boolean;
+    source: 'declared-schema' | 'data-table-columns';
+}
 export interface NodeSchemaContext {
     nodeName: string;
     nodeType: string;
@@ -18,6 +28,8 @@ export interface NodeSchemaContext {
     operation?: string;
     schema?: Record<string, unknown>;
     outputParser?: OutputParserContext;
+    dataTableColumns?: DataTableColumnInfo[];
+    declaredFields?: DeclaredFieldContract;
 }
 export interface PinDataGenerationInstructions {
     dataDescription: string;

package/dist/mock-data/validate.d.ts

@@ -0,0 +1,10 @@
+import type { NodeSchemaContext, PinData } from './types';
+export interface PinFieldViolation {
+    nodeName: string;
+    unknownKeys: string[];
+    missingKeys: string[];
+    declaredKeys: string[];
+    envelopeKey?: string;
+}
+export declare function collectPinFieldViolations(pinData: PinData, contexts: NodeSchemaContext[]): PinFieldViolation[];
+export declare function buildFieldViolationRetryMessage(violations: PinFieldViolation[]): string;

package/dist/mock-data/validate.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectPinFieldViolations = collectPinFieldViolations;
+exports.buildFieldViolationRetryMessage = buildFieldViolationRetryMessage;
+function collectPinFieldViolations(pinData, contexts) {
+    const violations = [];
+    for (const ctx of contexts) {
+        const contract = ctx.declaredFields;
+        if (!contract)
+            continue;
+        const items = pinData[ctx.nodeName];
+        if (!items || items.length === 0)
+            continue;
+        const declared = new Set(contract.keys);
+        const unknownKeys = new Set();
+        const missingKeySet = new Set();
+        for (const item of items) {
+            const json = item.json;
+            if (typeof json !== 'object' || json === null || Array.isArray(json)) {
+                if (contract.exact)
+                    for (const key of contract.keys)
+                        missingKeySet.add(key);
+                continue;
+            }
+            let fields = json;
+            if (contract.envelopeKey) {
+                const enveloped = fields[contract.envelopeKey];
+                if (typeof enveloped !== 'object' || enveloped === null || Array.isArray(enveloped)) {
+                    continue;
+                }
+                fields = enveloped;
+            }
+            for (const key of Object.keys(fields)) {
+                if (!declared.has(key))
+                    unknownKeys.add(key);
+            }
+            if (contract.exact) {
+                for (const key of contract.keys) {
+                    if (!(key in fields))
+                        missingKeySet.add(key);
+                }
+            }
+        }
+        const missingKeys = [...missingKeySet];
+        if (unknownKeys.size > 0 || missingKeys.length > 0) {
+            violations.push({
+                nodeName: ctx.nodeName,
+                unknownKeys: [...unknownKeys],
+                missingKeys,
+                declaredKeys: contract.keys,
+                envelopeKey: contract.envelopeKey,
+            });
+        }
+    }
+    return violations;
+}
+function buildFieldViolationRetryMessage(violations) {
+    const lines = [
+        'Your previous response used field names that do not exist on the nodes below.',
+        'Regenerate the COMPLETE JSON object (every node, same format), keeping all values scenario-consistent, but use EXACTLY the declared field names — do not rename, synonymize, or invent fields.',
+        'Keep the SAME number of items per node as before — do not satisfy a correction by dropping items or returning an empty array unless the scenario itself requires zero items:',
+        '',
+    ];
+    for (const v of violations) {
+        const location = v.envelopeKey ? ` (inside the \`${v.envelopeKey}\` object)` : '';
+        lines.push(`- ${v.nodeName}${location}:`);
+        if (v.unknownKeys.length > 0) {
+            lines.push(`  - remove/rename these unknown fields: ${v.unknownKeys.join(', ')}`);
+        }
+        if (v.missingKeys.length > 0) {
+            lines.push(`  - every item must also carry: ${v.missingKeys.join(', ')}`);
+        }
+        lines.push(`  - the ONLY valid field names are: ${v.declaredKeys.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=validate.js.map

package/dist/mock-data/validate.js.map

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

package/dist/prompts/sdk-reference/index.d.ts

@@ -3,4 +3,4 @@ export { ADDITIONAL_FUNCTIONS } from './additional-functions';
 export { WORKFLOW_RULES } from './workflow-rules';
 export { WORKFLOW_SDK_PATTERNS } from './workflow-patterns';
 export { WORKFLOW_PATTERNS_DETAILED } from './workflow-patterns-detailed';
-export { SDK_LANGUAGE_REFERENCE } from './sdk-language';
+export { NODE_GROUPS_REFERENCE, SDK_LANGUAGE_REFERENCE } from './sdk-language';

package/dist/prompts/sdk-reference/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_LANGUAGE_REFERENCE = exports.WORKFLOW_PATTERNS_DETAILED = exports.WORKFLOW_SDK_PATTERNS = exports.WORKFLOW_RULES = exports.ADDITIONAL_FUNCTIONS = exports.EXPRESSION_REFERENCE = void 0;
+exports.SDK_LANGUAGE_REFERENCE = exports.NODE_GROUPS_REFERENCE = exports.WORKFLOW_PATTERNS_DETAILED = exports.WORKFLOW_SDK_PATTERNS = exports.WORKFLOW_RULES = exports.ADDITIONAL_FUNCTIONS = exports.EXPRESSION_REFERENCE = void 0;
 var expressions_1 = require("./expressions");
 Object.defineProperty(exports, "EXPRESSION_REFERENCE", { enumerable: true, get: function () { return expressions_1.EXPRESSION_REFERENCE; } });
 var additional_functions_1 = require("./additional-functions");
@@ -12,5 +12,6 @@ Object.defineProperty(exports, "WORKFLOW_SDK_PATTERNS", { enumerable: true, get:
 var workflow_patterns_detailed_1 = require("./workflow-patterns-detailed");
 Object.defineProperty(exports, "WORKFLOW_PATTERNS_DETAILED", { enumerable: true, get: function () { return workflow_patterns_detailed_1.WORKFLOW_PATTERNS_DETAILED; } });
 var sdk_language_1 = require("./sdk-language");
+Object.defineProperty(exports, "NODE_GROUPS_REFERENCE", { enumerable: true, get: function () { return sdk_language_1.NODE_GROUPS_REFERENCE; } });
 Object.defineProperty(exports, "SDK_LANGUAGE_REFERENCE", { enumerable: true, get: function () { return sdk_language_1.SDK_LANGUAGE_REFERENCE; } });
 //# sourceMappingURL=index.js.map

package/dist/prompts/sdk-reference/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/sdk-reference/index.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAC7B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,yDAA4D;AAAnD,0HAAA,qBAAqB,OAAA;AAC9B,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/sdk-reference/index.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAC7B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,yDAA4D;AAAnD,0HAAA,qBAAqB,OAAA;AAC9B,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,+CAA+E;AAAtE,qHAAA,qBAAqB,OAAA;AAAE,sHAAA,sBAAsB,OAAA"}

package/dist/prompts/sdk-reference/sdk-language.d.ts

@@ -1 +1,2 @@
+export declare const NODE_GROUPS_REFERENCE: string;
 export declare const SDK_LANGUAGE_REFERENCE: string;

package/dist/prompts/sdk-reference/sdk-language.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_LANGUAGE_REFERENCE = void 0;
+exports.SDK_LANGUAGE_REFERENCE = exports.NODE_GROUPS_REFERENCE = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
 const ast_interpreter_1 = require("../../ast-interpreter");
 const GROUP_LABELS = {
     workflow: 'Workflow builder',
@@ -9,6 +10,16 @@ const GROUP_LABELS = {
     connection: 'Connection',
 };
 const PUBLIC_METHODS = ast_interpreter_1.SDK_METHODS.filter((m) => m.public);
+function renderRulesLines() {
+    return [
+        ...Object.values(n8n_workflow_1.NODE_GROUPING_RULES).map((r) => `- ${r.sdkReference}`),
+        '- **Unique identity.** Group names and ids must be unique within the workflow.',
+        '- **Non-empty.** A group needs at least one node.',
+        '',
+        'Prefer grouping a linear range of nodes — they read most clearly — but that is a',
+        'readability guideline, not a rule the server enforces.',
+    ].join('\n');
+}
 function renderMethodLines() {
     return Object.keys(GROUP_LABELS)
         .map((group) => {
@@ -32,6 +43,36 @@ function renderInlineConstraintLines() {
 const SAFE_METHODS_SENTENCE = `The only non-builder methods available are ${ast_interpreter_1.SAFE_JSON_METHOD_NAMES.map((n) => `\`JSON.${n}\``).join(', ')} ` +
     `and the string methods ${ast_interpreter_1.SAFE_STRING_METHOD_NAMES.map((n) => `\`.${n}()\``).join(', ')}. ` +
     'Native array/string methods such as `.join()`, `.map()`, `.filter()`, `.reduce()`, and `.split()` are NOT available.';
+exports.NODE_GROUPS_REFERENCE = `## Node groups
+
+A node group is a named, visual grouping of nodes (a frame on the canvas). It is
+purely organisational — nothing about execution depends on it. Declare one with
+\`.group(name, members, options?)\` on the workflow. Members are the node handles (the
+\`const\` from \`node(...)\`) — the same way connections reference nodes:
+
+\`\`\`typescript
+const fetch = node({ /* ... name: 'Fetch data' */ });
+const transform = node({ /* ... name: 'Transform' */ });
+export default workflow('id', 'My workflow')
+  .add(fetch)
+  .to(transform)
+  .group('Ingestion', [fetch, transform], {
+    description: 'Pulls the CRM contacts and normalizes them',
+  });
+\`\`\`
+
+\`description\` is optional and shown when the group is collapsed. Keep it to one
+sentence — anything past ${n8n_workflow_1.GROUP_DESCRIPTION_MAX_LENGTH} characters is cut off.
+
+When editing an existing workflow, **keep the \`.group(...)\` calls and their descriptions
+intact** unless the change is specifically about grouping.
+
+An invalid group is rejected on save, so these following rules MUST be followed when
+creating or editing groups.
+
+Rules:
+${renderRulesLines()}
+`;
 exports.SDK_LANGUAGE_REFERENCE = `# Workflow SDK language reference
 
 SDK builder code is a **restricted subset of TypeScript**, not a Code node and
@@ -45,25 +86,7 @@ ${renderMethodLines()}
 
 ${SAFE_METHODS_SENTENCE}
 
-## Node groups
-
-A node group is a named, visual grouping of nodes (a frame on the canvas).
-Declare one with \`.group(name, members)\` on the workflow. Members are the node
-handles (the \`const\` from \`node(...)\`) — the same way connections reference nodes:
-
-\`\`\`typescript
-const fetch = node({ /* ... name: 'Fetch data' */ });
-const transform = node({ /* ... name: 'Transform' */ });
-export default workflow('id', 'My workflow')
-  .add(fetch)
-  .to(transform)
-  .group('Ingestion', [fetch, transform]);
-\`\`\`
-
-When editing an existing workflow, **keep the \`.group(...)\` calls intact** unless
-the change is specifically about grouping. Group members must form a single
-connected section of the graph and cannot be trigger nodes; an invalid group is
-rejected on save.
+${exports.NODE_GROUPS_REFERENCE}
 
 ## Forbidden constructs
 

package/dist/prompts/sdk-reference/sdk-language.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-language.js","sourceRoot":"","sources":["../../../src/prompts/sdk-reference/sdk-language.ts"],"names":[],"mappings":";;;AAIA,2DAQ+B;AAE/B,MAAM,YAAY,GAAwD;IACzE,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,cAAc;IACpB,cAAc,EAAE,cAAc;IAC9B,UAAU,EAAE,YAAY;CACxB,CAAC;AAEF,MAAM,cAAc,GAAG,6BAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,SAAS,iBAAiB;IACzB,OAAQ,MAAM,CAAC,IAAI,CAAC,YAAY,CAAsC;SACpE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,sCAAoB,CAAC;SACxC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC;SAChC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB;IACjC,OAAO,yCAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,2BAA2B;IACnC,OAAO,wCAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,qBAAqB,GAC1B,8CAA8C,wCAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;IAC9G,0BAA0B,0CAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IAC3F,sHAAsH,CAAC;AAG3G,QAAA,sBAAsB,GAAG;;;;;;;;;EASpC,iBAAiB,EAAE;;EAEnB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAwBrB,oBAAoB,EAAE;;;;EAItB,2BAA2B,EAAE;;;;;;EAM7B,yBAAyB,EAAE;;;;;;;;;;;CAW5B,CAAC"}
+{"version":3,"file":"sdk-language.js","sourceRoot":"","sources":["../../../src/prompts/sdk-reference/sdk-language.ts"],"names":[],"mappings":"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"}

package/dist/types/base.d.ts

@@ -285,6 +285,14 @@ export interface ToJSONOptions {
     existingGroupIdsByName?: Map<string, string>;
 }
 export type GroupMember = NodeInstance<string, string, unknown>;
+export type GroupOptions = {
+    description?: string;
+};
+export type AuthoredNodeGroup = GroupOptions & {
+    id?: string;
+    name: string;
+    members: GroupMember[];
+};
 export interface WorkflowBuilder {
     readonly id: string;
     readonly name: string;
@@ -303,7 +311,7 @@ export interface WorkflowBuilder {
     settings(settings: WorkflowSettings): WorkflowBuilder;
     connect(source: NodeInstance<string, string, unknown>, sourceOutput: number, target: NodeInstance<string, string, unknown>, targetInput: number): WorkflowBuilder;
     getNode(name: string): NodeInstance<string, string, unknown> | undefined;
-    group(name: string, members: GroupMember[]): WorkflowBuilder;
+    group(name: string, members: GroupMember[], options?: GroupOptions): WorkflowBuilder;
     validate(options?: ValidationOptions): ValidationResult;
     toJSON(options?: ToJSONOptions): WorkflowJSON;
     toFormat<T>(format: string): T;

package/dist/validation/index.d.ts

@@ -1,34 +1,7 @@
-import type { INodeTypes } from 'n8n-workflow';
-import type { WorkflowBuilder, WorkflowJSON } from '../types/base';
-export { getSchemaBaseDirs, setSchemaBaseDirs, validateNodeConfig, type SchemaValidationResult, } from './schema-validator';
-export type ValidationErrorCode = 'NO_NODES' | 'MISSING_TRIGGER' | 'DISCONNECTED_NODE' | 'MISSING_PARAMETER' | 'INVALID_CONNECTION' | 'CIRCULAR_REFERENCE' | 'INVALID_EXPRESSION' | 'AGENT_STATIC_PROMPT' | 'AGENT_NO_SYSTEM_MESSAGE' | 'HARDCODED_CREDENTIALS' | 'SET_CREDENTIAL_FIELD' | 'MERGE_SINGLE_INPUT' | 'TOOL_NO_PARAMETERS' | 'FROM_AI_IN_NON_TOOL' | 'MISSING_EXPRESSION_PREFIX' | 'INVALID_PARAMETER' | 'INVALID_INPUT_INDEX' | 'INVALID_OUTPUT_INDEX' | 'SUBNODE_NOT_CONNECTED' | 'SUBNODE_PARAMETER_MISMATCH' | 'UNSUPPORTED_SUBNODE_INPUT' | 'MISSING_REQUIRED_INPUT' | 'INVALID_OUTPUT_FOR_MODE' | 'SWITCH_NO_OUTPUT_CONNECTIONS' | 'SWITCH_FALLBACK_OUTPUT_DISABLED' | 'MAX_NODES_EXCEEDED' | 'INVALID_EXPRESSION_PATH' | 'PARTIAL_EXPRESSION_PATH' | 'INVALID_DATE_METHOD' | 'UNKNOWN_CONFIG_KEY';
-export declare class ValidationError {
-    readonly code: ValidationErrorCode;
-    readonly message: string;
-    readonly nodeName?: string;
-    readonly parameterName?: string;
-    readonly violationLevel?: 'critical' | 'major' | 'minor';
-    constructor(code: ValidationErrorCode, message: string, nodeName?: string, parameterName?: string, violationLevel?: 'critical' | 'major' | 'minor');
-}
-export declare class ValidationWarning {
-    readonly code: ValidationErrorCode;
-    readonly message: string;
-    readonly nodeName?: string;
-    readonly parameterPath?: string;
-    readonly originalName?: string;
-    readonly violationLevel?: 'critical' | 'major' | 'minor';
-    constructor(code: ValidationErrorCode, message: string, nodeName?: string, parameterPath?: string, originalName?: string, violationLevel?: 'critical' | 'major' | 'minor');
-}
-export interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-    warnings: ValidationWarning[];
-}
-export interface ValidationOptions {
-    strictMode?: boolean;
-    allowDisconnectedNodes?: boolean;
-    allowNoTrigger?: boolean;
-    validateSchema?: boolean;
-    nodeTypesProvider?: INodeTypes;
-}
-export declare function validateWorkflow(workflowOrJson: WorkflowBuilder | WorkflowJSON, options?: ValidationOptions): ValidationResult;
+export { validateWorkflow, ValidationError, ValidationWarning, type ValidationResult, type ValidationOptions, type ValidationErrorCode, } from './validate-workflow';
+export { getSchemaBaseDirs, setSchemaBaseDirs, validateNodeConfig, type SchemaValidationResult, } from './node-parameter-schema/schema-validator';
+export { type IssueSeverity, isInformationalIssue, partitionValidationIssues, } from './issue-severity';
+export { validateWorkflowBuilder, buildUncheckedNotes, type ValidateWorkflowBuilderOptions, type ValidateWorkflowBuilderResult, type CollectedValidationIssue, type ValidationIssueSource, } from './validate-workflow-builder';
+export { matchesDisplayOptions, checkConditions, type DisplayOptions, type DisplayOptionsContext, } from './display-options';
+export { resolveMainInputCount } from './node-port-resolvers/resolve-main-input-count';
+export { resolveMainOutputCount } from './node-port-resolvers/resolve-main-output-count';