@n8n/workflow-sdk 0.8.0 → 0.10.0

package/dist/prompts/best-practices/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/prompts/best-practices/types.ts"],"names":[],"mappings":";;;AAGa,QAAA,iBAAiB,GAAG;IAChC,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,qBAAqB,EAAE,uBAAuB;IAC9C,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;CAC7B,CAAC;AAIE,QAAA,oBAAoB,GAA0C;IAC1E,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAAE,kDAAkD;IAClF,CAAC,yBAAiB,CAAC,OAAO,CAAC,EAC1B,uFAAuF;IACxF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAAE,qCAAqC;IACrE,CAAC,yBAAiB,CAAC,qBAAqB,CAAC,EACxC,sFAAsF;IACvF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAC7B,sFAAsF;IACvF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAC7B,iFAAiF;IAClF,CAAC,yBAAiB,CAAC,MAAM,CAAC,EAAE,gDAAgD;IAC5E,CAAC,yBAAiB,CAAC,kBAAkB,CAAC,EAAE,2CAA2C;IACnF,CAAC,yBAAiB,CAAC,mBAAmB,CAAC,EACtC,iEAAiE;IAClE,CAAC,yBAAiB,CAAC,eAAe,CAAC,EAClC,qEAAqE;IACtE,CAAC,yBAAiB,CAAC,aAAa,CAAC,EAChC,iEAAiE;IAClE,CAAC,yBAAiB,CAAC,mBAAmB,CAAC,EACtC,uEAAuE;IACxE,CAAC,yBAAiB,CAAC,gBAAgB,CAAC,EACnC,kHAAkH;IACnH,CAAC,yBAAiB,CAAC,YAAY,CAAC,EAC/B,kEAAkE;IACnE,CAAC,yBAAiB,CAAC,cAAc,CAAC,EACjC,8FAA8F;IAC/F,CAAC,yBAAiB,CAAC,iBAAiB,CAAC,EAAE,kDAAkD;CACzF,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+export { EXPRESSION_REFERENCE, ADDITIONAL_FUNCTIONS, WORKFLOW_RULES, WORKFLOW_SDK_PATTERNS, } from './sdk-reference';
+export * from './node-guidance';
+export * from './best-practices';

package/dist/prompts/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_SDK_PATTERNS = exports.WORKFLOW_RULES = exports.ADDITIONAL_FUNCTIONS = exports.EXPRESSION_REFERENCE = void 0;
+var sdk_reference_1 = require("./sdk-reference");
+Object.defineProperty(exports, "EXPRESSION_REFERENCE", { enumerable: true, get: function () { return sdk_reference_1.EXPRESSION_REFERENCE; } });
+Object.defineProperty(exports, "ADDITIONAL_FUNCTIONS", { enumerable: true, get: function () { return sdk_reference_1.ADDITIONAL_FUNCTIONS; } });
+Object.defineProperty(exports, "WORKFLOW_RULES", { enumerable: true, get: function () { return sdk_reference_1.WORKFLOW_RULES; } });
+Object.defineProperty(exports, "WORKFLOW_SDK_PATTERNS", { enumerable: true, get: function () { return sdk_reference_1.WORKFLOW_SDK_PATTERNS; } });
+__exportStar(require("./node-guidance"), exports);
+__exportStar(require("./best-practices"), exports);
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAKyB;AAJxB,qHAAA,oBAAoB,OAAA;AACpB,qHAAA,oBAAoB,OAAA;AACpB,+GAAA,cAAc,OAAA;AACd,sHAAA,qBAAqB,OAAA;AAGtB,kDAAgC;AAChC,mDAAiC"}

package/dist/prompts/node-guidance/index.d.ts

@@ -0,0 +1,3 @@
+export * from './parameter-guides';
+export * from './node-tips';
+export * from './node-recommendations';

package/dist/prompts/node-guidance/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./parameter-guides"), exports);
+__exportStar(require("./node-tips"), exports);
+__exportStar(require("./node-recommendations"), exports);
+//# sourceMappingURL=index.js.map

package/dist/prompts/node-guidance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/node-guidance/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,8CAA4B;AAC5B,yDAAuC"}

package/dist/prompts/node-guidance/node-recommendations/audio-generation.d.ts

@@ -0,0 +1,2 @@
+import { type NodeRecommendationDocument } from './types';
+export declare const audioGenerationRecommendation: NodeRecommendationDocument;

package/dist/prompts/node-guidance/node-recommendations/audio-generation.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.audioGenerationRecommendation = void 0;
+const types_1 = require("./types");
+exports.audioGenerationRecommendation = {
+    category: types_1.RecommendationCategory.AUDIO_GENERATION,
+    version: '1.0.0',
+    recommendation: {
+        defaultNode: '@n8n/n8n-nodes-langchain.openAi',
+        operations: [
+            'Generate Audio: Create speech from text using OpenAI TTS',
+            'Transcribe a Recording: Convert audio to text using Whisper',
+            'Translate a Recording: Transcribe and translate audio to English using Whisper',
+        ],
+        reasoning: "OpenAI provides comprehensive audio capabilities: TTS for speech generation, Whisper for transcription and translation. Prefer OpenAI when user doesn't specify a provider.",
+    },
+};
+//# sourceMappingURL=audio-generation.js.map

package/dist/prompts/node-guidance/node-recommendations/audio-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-generation.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/audio-generation.ts"],"names":[],"mappings":";;;AAAA,mCAAkF;AAErE,QAAA,6BAA6B,GAA+B;IACxE,QAAQ,EAAE,8BAAsB,CAAC,gBAAgB;IACjD,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE;QACf,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE;YACX,0DAA0D;YAC1D,6DAA6D;YAC7D,gFAAgF;SAChF;QACD,SAAS,EACR,6KAA6K;KAC9K;CACD,CAAC"}

package/dist/prompts/node-guidance/node-recommendations/format-recommendation.d.ts

@@ -0,0 +1,2 @@
+import type { NodeRecommendation } from './types';
+export declare function formatRecommendation(rec: NodeRecommendation): string;

package/dist/prompts/node-guidance/node-recommendations/format-recommendation.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRecommendation = formatRecommendation;
+function wrapSection(tag, content) {
+    return `<${tag}>\n${content}\n</${tag}>`;
+}
+function formatRecommendation(rec) {
+    const sections = [
+        wrapSection('default_node', rec.defaultNode),
+        wrapSection('operations', rec.operations.map((op) => `- ${op}`).join('\n')),
+        wrapSection('reasoning', rec.reasoning),
+    ];
+    if (rec.connectedNodes && rec.connectedNodes.length > 0) {
+        const connectedContent = rec.connectedNodes
+            .map((cn) => {
+            const desc = cn.description ? ` - ${cn.description}` : '';
+            return `- ${cn.nodeType} (connection: ${cn.connectionType})${desc}`;
+        })
+            .join('\n');
+        sections.push(wrapSection('connected_nodes', connectedContent));
+    }
+    if (rec.note) {
+        sections.push(wrapSection('note', rec.note));
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=format-recommendation.js.map

package/dist/prompts/node-guidance/node-recommendations/format-recommendation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-recommendation.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/format-recommendation.ts"],"names":[],"mappings":";;AAMA,oDAsBC;AA1BD,SAAS,WAAW,CAAC,GAAW,EAAE,OAAe;IAChD,OAAO,IAAI,GAAG,MAAM,OAAO,OAAO,GAAG,GAAG,CAAC;AAC1C,CAAC;AAED,SAAgB,oBAAoB,CAAC,GAAuB;IAC3D,MAAM,QAAQ,GAAa;QAC1B,WAAW,CAAC,cAAc,EAAE,GAAG,CAAC,WAAW,CAAC;QAC5C,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC;KACvC,CAAC;IAEF,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,gBAAgB,GAAG,GAAG,CAAC,cAAc;aACzC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACX,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,OAAO,KAAK,EAAE,CAAC,QAAQ,iBAAiB,EAAE,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;QACrE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/prompts/node-guidance/node-recommendations/image-generation.d.ts

@@ -0,0 +1,2 @@
+import { type NodeRecommendationDocument } from './types';
+export declare const imageGenerationRecommendation: NodeRecommendationDocument;

package/dist/prompts/node-guidance/node-recommendations/image-generation.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imageGenerationRecommendation = void 0;
+const types_1 = require("./types");
+exports.imageGenerationRecommendation = {
+    category: types_1.RecommendationCategory.IMAGE_GENERATION,
+    version: '1.0.0',
+    recommendation: {
+        defaultNode: '@n8n/n8n-nodes-langchain.openAi',
+        operations: [
+            'Analyze Image: Analyze and describe image content using GPT-4 Vision',
+            'Generate an Image: Create images from text prompts using DALL-E',
+            'Edit Image: Modify existing images using DALL-E',
+        ],
+        reasoning: "OpenAI provides comprehensive image capabilities: DALL-E for generation/editing, GPT-4 Vision for analysis. Prefer OpenAI when user doesn't specify a provider.",
+    },
+};
+//# sourceMappingURL=image-generation.js.map

package/dist/prompts/node-guidance/node-recommendations/image-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/image-generation.ts"],"names":[],"mappings":";;;AAAA,mCAAkF;AAErE,QAAA,6BAA6B,GAA+B;IACxE,QAAQ,EAAE,8BAAsB,CAAC,gBAAgB;IACjD,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE;QACf,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE;YACX,sEAAsE;YACtE,iEAAiE;YACjE,iDAAiD;SACjD;QACD,SAAS,EACR,iKAAiK;KAClK;CACD,CAAC"}

package/dist/prompts/node-guidance/node-recommendations/index.d.ts

@@ -0,0 +1,6 @@
+export { RecommendationCategory, RecommendationCategoryDescription, type RecommendationCategoryType, type NodeRecommendation, type NodeRecommendationDocument, type ConnectedNodeRecommendation, } from './types';
+export { formatRecommendation } from './format-recommendation';
+export { textManipulationRecommendation } from './text-manipulation';
+export { imageGenerationRecommendation } from './image-generation';
+export { videoGenerationRecommendation } from './video-generation';
+export { audioGenerationRecommendation } from './audio-generation';

package/dist/prompts/node-guidance/node-recommendations/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.audioGenerationRecommendation = exports.videoGenerationRecommendation = exports.imageGenerationRecommendation = exports.textManipulationRecommendation = exports.formatRecommendation = exports.RecommendationCategoryDescription = exports.RecommendationCategory = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "RecommendationCategory", { enumerable: true, get: function () { return types_1.RecommendationCategory; } });
+Object.defineProperty(exports, "RecommendationCategoryDescription", { enumerable: true, get: function () { return types_1.RecommendationCategoryDescription; } });
+var format_recommendation_1 = require("./format-recommendation");
+Object.defineProperty(exports, "formatRecommendation", { enumerable: true, get: function () { return format_recommendation_1.formatRecommendation; } });
+var text_manipulation_1 = require("./text-manipulation");
+Object.defineProperty(exports, "textManipulationRecommendation", { enumerable: true, get: function () { return text_manipulation_1.textManipulationRecommendation; } });
+var image_generation_1 = require("./image-generation");
+Object.defineProperty(exports, "imageGenerationRecommendation", { enumerable: true, get: function () { return image_generation_1.imageGenerationRecommendation; } });
+var video_generation_1 = require("./video-generation");
+Object.defineProperty(exports, "videoGenerationRecommendation", { enumerable: true, get: function () { return video_generation_1.videoGenerationRecommendation; } });
+var audio_generation_1 = require("./audio-generation");
+Object.defineProperty(exports, "audioGenerationRecommendation", { enumerable: true, get: function () { return audio_generation_1.audioGenerationRecommendation; } });
+//# sourceMappingURL=index.js.map

package/dist/prompts/node-guidance/node-recommendations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/index.ts"],"names":[],"mappings":";;;AAAA,iCAOiB;AANhB,+GAAA,sBAAsB,OAAA;AACtB,0HAAA,iCAAiC,OAAA;AAMlC,iEAA+D;AAAtD,6HAAA,oBAAoB,OAAA;AAC7B,yDAAqE;AAA5D,mIAAA,8BAA8B,OAAA;AACvC,uDAAmE;AAA1D,iIAAA,6BAA6B,OAAA;AACtC,uDAAmE;AAA1D,iIAAA,6BAA6B,OAAA;AACtC,uDAAmE;AAA1D,iIAAA,6BAA6B,OAAA"}

package/dist/prompts/node-guidance/node-recommendations/text-manipulation.d.ts

@@ -0,0 +1,2 @@
+import { type NodeRecommendationDocument } from './types';
+export declare const textManipulationRecommendation: NodeRecommendationDocument;

package/dist/prompts/node-guidance/node-recommendations/text-manipulation.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textManipulationRecommendation = void 0;
+const types_1 = require("./types");
+exports.textManipulationRecommendation = {
+    category: types_1.RecommendationCategory.TEXT_MANIPULATION,
+    version: '1.0.0',
+    recommendation: {
+        defaultNode: '@n8n/n8n-nodes-langchain.agent',
+        operations: [
+            'Text summarization',
+            'Content analysis and extraction',
+            'Classification and categorization',
+            'Chat and conversational AI',
+            'Content generation and writing',
+        ],
+        reasoning: 'The AI Agent node is the default for text manipulation tasks. New users receive free OpenAI credits. Do NOT use provider-specific nodes directly.',
+        connectedNodes: [
+            {
+                nodeType: '@n8n/n8n-nodes-langchain.lmChatOpenAi',
+                connectionType: 'ai_languageModel',
+                description: 'Required chat model for the AI Agent',
+            },
+        ],
+    },
+};
+//# sourceMappingURL=text-manipulation.js.map

package/dist/prompts/node-guidance/node-recommendations/text-manipulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-manipulation.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/text-manipulation.ts"],"names":[],"mappings":";;;AAAA,mCAAkF;AAErE,QAAA,8BAA8B,GAA+B;IACzE,QAAQ,EAAE,8BAAsB,CAAC,iBAAiB;IAClD,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE;QACf,WAAW,EAAE,gCAAgC;QAC7C,UAAU,EAAE;YACX,oBAAoB;YACpB,iCAAiC;YACjC,mCAAmC;YACnC,4BAA4B;YAC5B,gCAAgC;SAChC;QACD,SAAS,EACR,mJAAmJ;QACpJ,cAAc,EAAE;YACf;gBACC,QAAQ,EAAE,uCAAuC;gBACjD,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,sCAAsC;aACnD;SACD;KACD;CACD,CAAC"}

package/dist/prompts/node-guidance/node-recommendations/types.d.ts

@@ -0,0 +1,26 @@
+import type { NodeConnectionType } from 'n8n-workflow';
+export declare const RecommendationCategory: {
+    readonly TEXT_MANIPULATION: "text_manipulation";
+    readonly IMAGE_GENERATION: "image_generation";
+    readonly VIDEO_GENERATION: "video_generation";
+    readonly AUDIO_GENERATION: "audio_generation";
+};
+export type RecommendationCategoryType = (typeof RecommendationCategory)[keyof typeof RecommendationCategory];
+export declare const RecommendationCategoryDescription: Record<RecommendationCategoryType, string>;
+export interface ConnectedNodeRecommendation {
+    nodeType: string;
+    connectionType: NodeConnectionType;
+    description?: string;
+}
+export interface NodeRecommendation {
+    defaultNode: string;
+    operations: string[];
+    reasoning: string;
+    connectedNodes?: ConnectedNodeRecommendation[];
+    note?: string;
+}
+export interface NodeRecommendationDocument {
+    readonly category: RecommendationCategoryType;
+    readonly version: string;
+    readonly recommendation: NodeRecommendation;
+}

package/dist/prompts/node-guidance/node-recommendations/types.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecommendationCategoryDescription = exports.RecommendationCategory = void 0;
+exports.RecommendationCategory = {
+    TEXT_MANIPULATION: 'text_manipulation',
+    IMAGE_GENERATION: 'image_generation',
+    VIDEO_GENERATION: 'video_generation',
+    AUDIO_GENERATION: 'audio_generation',
+};
+exports.RecommendationCategoryDescription = {
+    [exports.RecommendationCategory.TEXT_MANIPULATION]: 'AI text tasks: summarization, analysis, extraction, classification, chat',
+    [exports.RecommendationCategory.IMAGE_GENERATION]: 'AI image tasks: generate, analyze, edit images',
+    [exports.RecommendationCategory.VIDEO_GENERATION]: 'AI video tasks: generate video from text/images',
+    [exports.RecommendationCategory.AUDIO_GENERATION]: 'AI audio tasks: generate speech, transcribe, translate audio',
+};
+//# sourceMappingURL=types.js.map

package/dist/prompts/node-guidance/node-recommendations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/types.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAG;IACrC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;CAC3B,CAAC;AAKE,QAAA,iCAAiC,GAA+C;IAC5F,CAAC,8BAAsB,CAAC,iBAAiB,CAAC,EACzC,0EAA0E;IAC3E,CAAC,8BAAsB,CAAC,gBAAgB,CAAC,EAAE,gDAAgD;IAC3F,CAAC,8BAAsB,CAAC,gBAAgB,CAAC,EAAE,iDAAiD;IAC5F,CAAC,8BAAsB,CAAC,gBAAgB,CAAC,EACxC,8DAA8D;CAC/D,CAAC"}

package/dist/prompts/node-guidance/node-recommendations/video-generation.d.ts

@@ -0,0 +1,2 @@
+import { type NodeRecommendationDocument } from './types';
+export declare const videoGenerationRecommendation: NodeRecommendationDocument;

package/dist/prompts/node-guidance/node-recommendations/video-generation.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.videoGenerationRecommendation = void 0;
+const types_1 = require("./types");
+exports.videoGenerationRecommendation = {
+    category: types_1.RecommendationCategory.VIDEO_GENERATION,
+    version: '1.0.0',
+    recommendation: {
+        defaultNode: '@n8n/n8n-nodes-langchain.openAi',
+        operations: ['Generate a Video: Create videos from text prompts using Sora'],
+        reasoning: "OpenAI Sora is the default for video generation. Prefer OpenAI when user doesn't specify a provider.",
+        note: 'Video generation may require async processing with Wait nodes due to longer generation times.',
+    },
+};
+//# sourceMappingURL=video-generation.js.map

package/dist/prompts/node-guidance/node-recommendations/video-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-generation.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-recommendations/video-generation.ts"],"names":[],"mappings":";;;AAAA,mCAAkF;AAErE,QAAA,6BAA6B,GAA+B;IACxE,QAAQ,EAAE,8BAAsB,CAAC,gBAAgB;IACjD,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE;QACf,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,CAAC,8DAA8D,CAAC;QAC5E,SAAS,EACR,sGAAsG;QACvG,IAAI,EAAE,+FAA+F;KACrG;CACD,CAAC"}

package/dist/prompts/node-guidance/node-tips/index.d.ts

@@ -0,0 +1,3 @@
+export type { NodeGuidance } from './types';
+export { webhook } from './webhook';
+export { structuredOutputParser } from './structured-output-parser';

package/dist/prompts/node-guidance/node-tips/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.structuredOutputParser = exports.webhook = void 0;
+var webhook_1 = require("./webhook");
+Object.defineProperty(exports, "webhook", { enumerable: true, get: function () { return webhook_1.webhook; } });
+var structured_output_parser_1 = require("./structured-output-parser");
+Object.defineProperty(exports, "structuredOutputParser", { enumerable: true, get: function () { return structured_output_parser_1.structuredOutputParser; } });
+//# sourceMappingURL=index.js.map

package/dist/prompts/node-guidance/node-tips/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-tips/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA"}

package/dist/prompts/node-guidance/node-tips/structured-output-parser.d.ts

@@ -0,0 +1,2 @@
+import type { NodeGuidance } from './types';
+export declare const structuredOutputParser: NodeGuidance;

package/dist/prompts/node-guidance/node-tips/structured-output-parser.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.structuredOutputParser = void 0;
+exports.structuredOutputParser = {
+    nodeType: '@n8n/n8n-nodes-langchain.outputParserStructured',
+    usage: `Search for "Structured Output Parser" (@n8n/n8n-nodes-langchain.outputParserStructured) when:
+- AI output will be used programmatically (conditions, formatting, database storage, API calls)
+- AI needs to extract specific fields (e.g., score, category, priority, action items)
+- AI needs to classify/categorize data into defined categories
+- Downstream nodes need to access specific fields from AI response (e.g., $json.score, $json.category)
+- Output will be displayed in a formatted way (e.g., HTML email with specific sections)
+- Data needs validation against a schema before processing
+
+- Always use search_nodes to find the exact node names and versions - NEVER guess versions`,
+    connections: `When Discovery results include AI Agent or Structured Output Parser:
+1. Create the Structured Output Parser node
+2. Set AI Agent's hasOutputParser: true in initialParameters
+3. Connect: Structured Output Parser → AI Agent (ai_outputParser connection)`,
+    configuration: `WHEN TO SET hasOutputParser: true on AI Agent:
+- Discovery found Structured Output Parser node → MUST set hasOutputParser: true
+- AI output will be used in conditions (IF/Switch nodes checking $json.field)
+- AI output will be formatted/displayed (HTML emails, reports with specific sections)
+- AI output will be stored in database/data tables with specific fields
+- AI is classifying, scoring, or extracting specific data fields`,
+    recommendation: `For AI-generated structured data, prefer Structured Output Parser nodes over Code nodes.
+Why: Purpose-built parsers are more reliable and handle edge cases better than custom code.
+
+For binary file data, use Extract From File node to extract content from files before processing.
+
+Use Code nodes only for:
+- Simple string manipulations
+- Already structured data (JSON, CSV)
+- Custom business logic beyond parsing`,
+};
+//# sourceMappingURL=structured-output-parser.js.map

package/dist/prompts/node-guidance/node-tips/structured-output-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output-parser.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-tips/structured-output-parser.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAiB;IACnD,QAAQ,EAAE,iDAAiD;IAE3D,KAAK,EAAE;;;;;;;;2FAQmF;IAE1F,WAAW,EAAE;;;6EAG+D;IAE5E,aAAa,EAAE;;;;;iEAKiD;IAEhE,cAAc,EAAE;;;;;;;;uCAQsB;CACtC,CAAC"}

package/dist/prompts/node-guidance/node-tips/types.d.ts

@@ -0,0 +1,7 @@
+export interface NodeGuidance {
+    nodeType: string;
+    usage: string;
+    connections: string;
+    configuration: string;
+    recommendation?: string;
+}

package/dist/prompts/node-guidance/node-tips/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/prompts/node-guidance/node-tips/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-tips/types.ts"],"names":[],"mappings":""}

package/dist/prompts/node-guidance/node-tips/webhook.d.ts

@@ -0,0 +1,2 @@
+import type { NodeGuidance } from './types';
+export declare const webhook: NodeGuidance;

package/dist/prompts/node-guidance/node-tips/webhook.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webhook = void 0;
+exports.webhook = {
+    nodeType: 'n8n-nodes-base.webhook',
+    usage: `Search for "Webhook" (n8n-nodes-base.webhook) when:
+- Workflow needs to receive HTTP requests from external services
+- API callbacks, webhooks, or HTTP endpoints are needed
+- Integration requires real-time event handling from external systems`,
+    connections: `WEBHOOK RESPONSE MODE RULES - CRITICAL:
+
+Response modes and their requirements:
+- "onReceived" (Immediately): Responds instantly when webhook is called. No RespondToWebhook node needed.
+- "lastNode" (When Last Node Finishes): Responds with data from last node. No RespondToWebhook node needed.
+- "responseNode" (Using Respond to Webhook Node): REQUIRES a RespondToWebhook node connected downstream.
+
+RULE 1: If responseMode='responseNode', you MUST add a RespondToWebhook node
+RULE 2: If RespondToWebhook node exists, responseMode MUST be 'responseNode'
+
+Pattern for custom response control:
+Webhook (responseMode: responseNode) → [Processing] → RespondToWebhook`,
+    configuration: `WEBHOOK RESPONSE MODE CONFIGURATION:
+
+Choose responseMode based on use case:
+- "onReceived": Quick acknowledgment, processing happens async
+- "lastNode": Return processed data, simple request-response flows
+- "responseNode": Full control over response timing, headers, status codes
+
+CRITICAL: When user needs to control response content/timing/headers, set responseMode='responseNode' AND add RespondToWebhook node.
+
+When NOT to use responseNode:
+- Simple acknowledgments (use 'onReceived')
+- Return last node output directly (use 'lastNode')`,
+    recommendation: `For webhook workflows requiring custom response handling (status codes, headers, delayed response), use responseMode='responseNode' with a RespondToWebhook node.
+
+For simple webhook acknowledgments or direct data return, use 'onReceived' or 'lastNode' modes respectively.`,
+};
+//# sourceMappingURL=webhook.js.map

package/dist/prompts/node-guidance/node-tips/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/node-tips/webhook.ts"],"names":[],"mappings":";;;AAEa,QAAA,OAAO,GAAiB;IACpC,QAAQ,EAAE,wBAAwB;IAElC,KAAK,EAAE;;;sEAG8D;IAErE,WAAW,EAAE;;;;;;;;;;;uEAWyD;IAEtE,aAAa,EAAE;;;;;;;;;;;oDAWoC;IAEnD,cAAc,EAAE;;6GAE4F;CAC5G,CAAC"}

package/dist/prompts/node-guidance/parameter-guides/embedding-nodes.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeGuide } from './types';
+export declare const EMBEDDING_NODES_GUIDE: NodeTypeGuide;

package/dist/prompts/node-guidance/parameter-guides/embedding-nodes.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMBEDDING_NODES_GUIDE = void 0;
+exports.EMBEDDING_NODES_GUIDE = {
+    patterns: ['@n8n/n8n-nodes-langchain.embeddings*'],
+    content: `
+## CRITICAL: Embedding Models vs Chat Models
+
+Embedding nodes (nodes with "embeddings" in their type name) MUST use embedding models, NOT chat/language models. Using a chat model in an embedding node will cause the workflow to fail.
+
+### Common Mistake to Avoid
+NEVER configure an embedding node with chat models like:
+- gpt-4, gpt-4o, gpt-4o-mini, gpt-3.5-turbo (OpenAI chat models)
+- claude-3-opus, claude-3-sonnet (Anthropic chat models)
+- gemini-pro, gemini-1.5-pro (Google chat models)
+- llama-3, mixtral (general LLM models)
+
+These are language/chat models designed for text generation, NOT for creating embeddings.
+
+### Correct Embedding Models by Provider
+
+#### OpenAI Embeddings
+- text-embedding-3-small (RECOMMENDED - default)
+- text-embedding-3-large
+- text-embedding-ada-002 (legacy)
+
+#### AWS Bedrock Embeddings
+- amazon.titan-embed-text-v1
+- amazon.titan-embed-text-v2:0
+- cohere.embed-english-v3
+- cohere.embed-multilingual-v3
+
+#### Google Gemini Embeddings
+- models/text-embedding-004 (RECOMMENDED - default)
+- models/embedding-001
+
+#### Cohere Embeddings
+- embed-english-v3.0 (1024 dimensions)
+- embed-multilingual-v3.0 (1024 dimensions)
+- embed-english-light-v3.0 (384 dimensions)
+- embed-multilingual-light-v3.0 (384 dimensions)
+- embed-english-v2.0 (4096 dimensions)
+
+#### Mistral Embeddings
+- mistral-embed (default)
+
+#### Ollama Embeddings
+- nomic-embed-text
+- mxbai-embed-large
+- all-minilm
+- snowflake-arctic-embed
+
+### How to Identify Embedding Models
+Embedding model names typically contain:
+- "embed" or "embedding" in the name
+- "e5", "bge", "gte" (common embedding model families)
+- "nomic", "minilm", "arctic" (embedding-specific models)
+
+### Key Rules
+1. ALWAYS check if the node type contains "embeddings" - if so, use an embedding model
+2. If the user mentions a chat model (gpt-4, claude, gemini-pro, etc.) for embeddings, do NOT use it
+3. Suggest the appropriate embedding model from the same provider instead
+4. When in doubt, use the provider's default embedding model
+
+### Parameter Names
+The model parameter may be named:
+- "model" (OpenAI, Bedrock, Mistral, Ollama, Azure)
+- "modelName" (Google Gemini, Cohere)`,
+};
+//# sourceMappingURL=embedding-nodes.js.map

package/dist/prompts/node-guidance/parameter-guides/embedding-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-nodes.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/parameter-guides/embedding-nodes.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAkB;IACnD,QAAQ,EAAE,CAAC,sCAAsC,CAAC;IAClD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA8D4B;CACrC,CAAC"}

package/dist/prompts/node-guidance/parameter-guides/gmail.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeGuide } from './types';
+export declare const GMAIL_GUIDE: NodeTypeGuide;

package/dist/prompts/node-guidance/parameter-guides/gmail.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GMAIL_GUIDE = void 0;
+exports.GMAIL_GUIDE = {
+    patterns: ['n8n-nodes-base.gmail', 'n8n-nodes-base.gmailTrigger'],
+    content: `
+### Gmail Node Updates
+
+#### Common Parameters
+- **resource**: message, draft, label, thread
+- **operation**: send, get, list, etc.
+- **to**: Recipient email address
+- **subject**: Email subject line
+- **message**: Email body/content
+- **authentication**: OAuth2 or Service Account
+
+#### Simplify Option (CRITICAL)
+- **simplify: false** - Returns FULL email with body, attachments, headers
+- **simplify: true** - Returns LIMITED data (subject, snippet only, NO body)
+
+ALWAYS set simplify to FALSE when:
+- Workflow needs to analyze email content/body
+- AI Agent will process or summarize emails
+- Email content is used for decision making
+- Attachments need to be accessed
+
+#### Gmail Filter Queries
+For Gmail Trigger nodes, use comprehensive search filters with OR operators:
+- Multiple keywords: "subject:(delivery OR shipment OR package OR tracking)"
+- From specific senders: "from:example@domain.com"
+- With attachments: "has:attachment"
+- Unread only: "is:unread"
+
+Example for package tracking: "subject:(delivery OR shipment OR package OR tracking OR shipped)"
+NOT just: "subject:delivery" (misses many relevant emails)
+
+#### Common Patterns
+1. **Sending Email**:
+   - Set resource to "message"
+   - Set operation to "send"
+   - Configure to, subject, and message fields
+
+2. **Reading Emails for AI Analysis**:
+   - Set simplify to false (required for full email body)
+   - Configure appropriate filter query
+   - Pass full email data to AI Agent
+
+3. **Using Expressions**:
+   - Can use expressions: "={{ $('Previous Node').item.json.email }}"
+   - Can reference previous node data for dynamic values
+`,
+};
+//# sourceMappingURL=gmail.js.map

package/dist/prompts/node-guidance/parameter-guides/gmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.js","sourceRoot":"","sources":["../../../../src/prompts/node-guidance/parameter-guides/gmail.ts"],"names":[],"mappings":";;;AAEa,QAAA,WAAW,GAAkB;IACzC,QAAQ,EAAE,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;IACjE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CT;CACA,CAAC"}

package/dist/prompts/node-guidance/parameter-guides/http-request.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeGuide } from './types';
+export declare const HTTP_REQUEST_GUIDE: NodeTypeGuide;