@n8n/workflow-sdk 0.9.0 → 0.10.1

package/dist/prompts/sdk-reference/workflow-patterns-detailed.d.ts

@@ -0,0 +1 @@
+export declare const WORKFLOW_PATTERNS_DETAILED = "<linear_chain>\n```javascript\nimport { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, reranker, fromAi, expr } from '@n8n/workflow-sdk';\n\n// 1. Define all nodes first\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start', position: [240, 300] },\n  output: [{}]\n});\n\nconst fetchData = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Fetch Data', parameters: { method: 'GET', url: '...' }, position: [540, 300] },\n  output: [{ id: 1, title: 'Item 1' }]\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Data', parameters: {}, position: [840, 300] },\n  output: [{ id: 1, title: 'Item 1', processed: true }]\n});\n\n// 2. Compose workflow\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchData)\n  .to(processData);\n```\n\n</linear_chain>\n\n<independent_sources>\nWhen nodes return more than 1 item, chaining causes item multiplication: if Source A returns N items, a chained Source B runs N times instead of once.\n\nFix with `executeOnce: true` (simplest) or parallel branches + Merge (when combining results):\n\n```javascript\n// sourceA outputs 10 items. sourceB outputs 10 items.\n// sourceB runs once per item from sourceA.\n// WRONG - processResults runs 100 times\n// startTrigger.to(sourceA.to(sourceB.to(processResults)))\n\n// FIX 1 - executeOnce: sourceB runs once regardless of input items\nconst sourceB = node({ ..., config: { ..., executeOnce: true } });\nstartTrigger.to(sourceA.to(sourceB.to(processResults)));\n\n// FIX 2 - parallel branches + Merge (combine by position)\n// Pairs items by index, merging fields from both inputs into one item.\n// @example input0: [{ a: 1 }, { a: 2 }] input1: [{ b: 10, c: 'x' }, { b: 20 }]\n//   output: [{ a: 1, b: 10, c: 'x' }, { a: 2, b: 20, c: undefined }]\nconst combineResults = merge({\n  version: 3.2,\n  config: { name: 'Combine Results', parameters: { mode: 'combine', combineBy: 'combineByPosition' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(combineResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(combineResults.input(1)))\n  .add(combineResults)\n  .to(processResults);\n\n// FIX 3 - parallel branches + Merge (append)\n// Concatenates all items from all inputs into one list sequentially.\n// @example input0: [{ a: 1 }, { a: 2 }] input1: [{ b: 10 }]\n//   output: [{ a: 1 }, { a: 2 }, { b: 10 }]\nconst allResults = merge({\n  version: 3.2,\n  config: { name: 'All Results', parameters: { mode: 'append' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(allResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(allResults.input(1)))\n  .add(allResults)\n  .to(processResults);\n```\n\n</independent_sources>\n\n<conditional_branching>\n\n**CRITICAL:** Each branch defines a COMPLETE processing path. Chain multiple steps INSIDE the branch using .to().\n\n```javascript\n// Assume other nodes are declared\nconst checkValid = ifElse({ version: 2.2, config: { name: 'Check Valid', parameters: {...} } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(checkValid\n    .onTrue(formatData.to(enrichData.to(saveToDb)))  // Chain 3 nodes on true branch\n    .onFalse(logError));\n```\n\n</conditional_branching>\n\n<multi_way_routing>\n\n```javascript\n// Assume other nodes are declared\nconst routeByPriority = switchCase({ version: 3.2, config: { name: 'Route by Priority', parameters: {...} } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(routeByPriority\n    .onCase(0, processUrgent.to(notifyTeam.to(escalate)))  // Chain of 3 nodes\n    .onCase(1, processNormal)\n    .onCase(2, archive));\n```\n\n</multi_way_routing>\n\n<parallel_execution>\n```javascript\nconst combineResults = merge({\n  version: 3.2,\n  config: {\n    name: 'Combine Results',\n    parameters: { mode: 'combine' },\n    position: [840, 300]\n  }\n});\n\nconst branch1 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst branch2 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst processResults = node({ type: 'n8n-nodes-base.set', ... });\n\n// Connect branches to specific merge inputs using .input(n)\nexport default workflow('id', 'name')\n  .add(trigger({ ... }))\n  .to(branch1.to(combineResults.input(0)))\n  .add(trigger({ ... }))\n  .to(branch2.to(combineResults.input(1)))\n  .add(combineResults)\n  .to(processResults);\n```\n\n</parallel_execution>\n\n<batch_processing>\n```javascript\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger', version: 1,\n  config: { name: 'Start', position: [240, 300] },\n  output: [{}]\n});\n\nconst fetchRecords = node({\n  type: 'n8n-nodes-base.httpRequest', version: 4.3,\n  config: { name: 'Fetch Records', parameters: { method: 'GET', url: '...' }, position: [540, 300] },\n  output: [{ id: 1 }, { id: 2 }, { id: 3 }]\n});\n\nconst finalizeResults = node({\n  type: 'n8n-nodes-base.set', version: 3.4,\n  config: { name: 'Finalize', parameters: {}, position: [1140, 200] },\n  output: [{ summary: 'Processed 3 records' }]\n});\n\nconst processRecord = node({\n  type: 'n8n-nodes-base.httpRequest', version: 4.3,\n  config: { name: 'Process Record', parameters: { method: 'POST', url: '...' }, position: [1140, 400] },\n  output: [{ id: 1, status: 'processed' }]\n});\n\nconst sibNode = splitInBatches({ version: 3, config: { name: 'Batch Process', parameters: { batchSize: 10 }, position: [840, 300] } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchRecords)\n  .to(sibNode\n    .onDone(finalizeResults)\n    .onEachBatch(processRecord.to(nextBatch(sibNode)))\n  );\n```\n\n</batch_processing>\n\n<multiple_triggers>\n```javascript\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook', version: 2.1,\n  config: { name: 'Webhook', position: [240, 200] },\n  output: [{ body: { data: 'webhook payload' } }]\n});\n\nconst processWebhook = node({\n  type: 'n8n-nodes-base.set', version: 3.4,\n  config: { name: 'Process Webhook', parameters: {}, position: [540, 200] },\n  output: [{ data: 'webhook payload', processed: true }]\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger', version: 1.3,\n  config: { name: 'Daily Schedule', parameters: {}, position: [240, 500] },\n  output: [{}]\n});\n\nconst processSchedule = node({\n  type: 'n8n-nodes-base.set', version: 3.4,\n  config: { name: 'Process Schedule', parameters: {}, position: [540, 500] },\n  output: [{ scheduled: true }]\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processWebhook)\n  .add(scheduleTrigger)\n  .to(processSchedule);\n```\n\n</multiple_triggers>\n\n<fan_in>\n```javascript\n// Each trigger's execution runs in COMPLETE ISOLATION.\n// Different branches have no effect on each other.\n// Never duplicate chains for \"isolation\" - it's already guaranteed.\n\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook', version: 2.1,\n  config: { name: 'Webhook Trigger', position: [240, 200] },\n  output: [{ source: 'webhook' }]\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger', version: 1.3,\n  config: { name: 'Daily Schedule', position: [240, 500] },\n  output: [{ source: 'schedule' }]\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set', version: 3.4,\n  config: { name: 'Process Data', parameters: {}, position: [540, 350] },\n  output: [{ processed: true }]\n});\n\nconst sendNotification = node({\n  type: 'n8n-nodes-base.slack', version: 2.3,\n  config: { name: 'Notify Slack', parameters: {}, position: [840, 350] },\n  output: [{ ok: true }]\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processData)\n  .to(sendNotification)\n  .add(scheduleTrigger)\n  .to(processData);\n```\n\n</fan_in>\n\n<ai_agent_basic>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi', version: 1.3,\n  config: { name: 'OpenAI Model', parameters: {}, position: [540, 500] }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger', version: 1,\n  config: { name: 'Start', position: [240, 300] },\n  output: [{}]\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,\n  config: {\n    name: 'AI Assistant',\n    parameters: { promptType: 'define', text: 'You are a helpful assistant' },\n    subnodes: { model: openAiModel },\n    position: [540, 300]\n  },\n  output: [{ output: 'AI response text' }]\n});\n\nexport default workflow('ai-assistant', 'AI Assistant')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_basic>\n\n<ai_agent_with_tools>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi', version: 1.3,\n  config: {\n    name: 'OpenAI Model', parameters: {},\n    credentials: { openAiApi: newCredential('OpenAI') },\n    position: [540, 500]\n  }\n});\n\nconst calculatorTool = tool({\n  type: '@n8n/n8n-nodes-langchain.toolCalculator', version: 1,\n  config: { name: 'Calculator', parameters: {}, position: [700, 500] }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger', version: 1,\n  config: { name: 'Start', position: [240, 300] },\n  output: [{}]\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,\n  config: {\n    name: 'Math Agent',\n    parameters: { promptType: 'define', text: 'You can use tools to help users' },\n    subnodes: { model: openAiModel, tools: [calculatorTool] },\n    position: [540, 300]\n  },\n  output: [{ output: '42' }]\n});\n\nexport default workflow('ai-calculator', 'AI Calculator')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_with_tools>\n\n<ai_agent_with_from_ai>\n```javascript\nconst gmailTool = tool({\n  type: 'n8n-nodes-base.gmailTool', version: 1,\n  config: {\n    name: 'Gmail Tool',\n    parameters: {\n      sendTo: fromAi('recipient', 'Email address'),\n      subject: fromAi('subject', 'Email subject'),\n      message: fromAi('body', 'Email content')\n    },\n    credentials: { gmailOAuth2: newCredential('Gmail') },\n    position: [700, 500]\n  }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,\n  config: {\n    name: 'Email Agent',\n    parameters: { promptType: 'define', text: 'You can send emails' },\n    subnodes: { model: openAiModel, tools: [gmailTool] },\n    position: [540, 300]\n  },\n  output: [{ output: 'Email sent successfully' }]\n});\n\nexport default workflow('ai-email', 'AI Email Sender')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_from_ai>\n\n<ai_agent_with_structured_output>\n```javascript\nconst structuredParser = outputParser({\n  type: '@n8n/n8n-nodes-langchain.outputParserStructured', version: 1.3,\n  config: {\n    name: 'Structured Output Parser',\n    parameters: {\n      schemaType: 'fromJson',\n      jsonSchemaExample: '{ \"sentiment\": \"positive\", \"confidence\": 0.95, \"summary\": \"brief summary\" }'\n    },\n    position: [700, 500]\n  }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,\n  config: {\n    name: 'Sentiment Analyzer',\n    parameters: { promptType: 'define', text: 'Analyze the sentiment of the input text', hasOutputParser: true },\n    subnodes: { model: openAiModel, outputParser: structuredParser },\n    position: [540, 300]\n  },\n  output: [{ sentiment: 'positive', confidence: 0.95, summary: 'The text expresses satisfaction' }]\n});\n\nexport default workflow('ai-sentiment', 'AI Sentiment Analyzer')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_structured_output>";

package/dist/prompts/sdk-reference/workflow-patterns-detailed.js

@@ -0,0 +1,398 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_PATTERNS_DETAILED = void 0;
+const SDK_IMPORT = "import { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, reranker, fromAi, expr } from '@n8n/workflow-sdk';";
+exports.WORKFLOW_PATTERNS_DETAILED = `<linear_chain>
+\`\`\`javascript
+${SDK_IMPORT}
+
+// 1. Define all nodes first
+const startTrigger = trigger({
+  type: 'n8n-nodes-base.manualTrigger',
+  version: 1,
+  config: { name: 'Start', position: [240, 300] },
+  output: [{}]
+});
+
+const fetchData = node({
+  type: 'n8n-nodes-base.httpRequest',
+  version: 4.3,
+  config: { name: 'Fetch Data', parameters: { method: 'GET', url: '...' }, position: [540, 300] },
+  output: [{ id: 1, title: 'Item 1' }]
+});
+
+const processData = node({
+  type: 'n8n-nodes-base.set',
+  version: 3.4,
+  config: { name: 'Process Data', parameters: {}, position: [840, 300] },
+  output: [{ id: 1, title: 'Item 1', processed: true }]
+});
+
+// 2. Compose workflow
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(fetchData)
+  .to(processData);
+\`\`\`
+
+</linear_chain>
+
+<independent_sources>
+When nodes return more than 1 item, chaining causes item multiplication: if Source A returns N items, a chained Source B runs N times instead of once.
+
+Fix with \`executeOnce: true\` (simplest) or parallel branches + Merge (when combining results):
+
+\`\`\`javascript
+// sourceA outputs 10 items. sourceB outputs 10 items.
+// sourceB runs once per item from sourceA.
+// WRONG - processResults runs 100 times
+// startTrigger.to(sourceA.to(sourceB.to(processResults)))
+
+// FIX 1 - executeOnce: sourceB runs once regardless of input items
+const sourceB = node({ ..., config: { ..., executeOnce: true } });
+startTrigger.to(sourceA.to(sourceB.to(processResults)));
+
+// FIX 2 - parallel branches + Merge (combine by position)
+// Pairs items by index, merging fields from both inputs into one item.
+// @example input0: [{ a: 1 }, { a: 2 }] input1: [{ b: 10, c: 'x' }, { b: 20 }]
+//   output: [{ a: 1, b: 10, c: 'x' }, { a: 2, b: 20, c: undefined }]
+const combineResults = merge({
+  version: 3.2,
+  config: { name: 'Combine Results', parameters: { mode: 'combine', combineBy: 'combineByPosition' } }
+});
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(sourceA.to(combineResults.input(0)))
+  .add(startTrigger)
+  .to(sourceB.to(combineResults.input(1)))
+  .add(combineResults)
+  .to(processResults);
+
+// FIX 3 - parallel branches + Merge (append)
+// Concatenates all items from all inputs into one list sequentially.
+// @example input0: [{ a: 1 }, { a: 2 }] input1: [{ b: 10 }]
+//   output: [{ a: 1 }, { a: 2 }, { b: 10 }]
+const allResults = merge({
+  version: 3.2,
+  config: { name: 'All Results', parameters: { mode: 'append' } }
+});
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(sourceA.to(allResults.input(0)))
+  .add(startTrigger)
+  .to(sourceB.to(allResults.input(1)))
+  .add(allResults)
+  .to(processResults);
+\`\`\`
+
+</independent_sources>
+
+<conditional_branching>
+
+**CRITICAL:** Each branch defines a COMPLETE processing path. Chain multiple steps INSIDE the branch using .to().
+
+\`\`\`javascript
+// Assume other nodes are declared
+const checkValid = ifElse({ version: 2.2, config: { name: 'Check Valid', parameters: {...} } });
+
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(checkValid
+    .onTrue(formatData.to(enrichData.to(saveToDb)))  // Chain 3 nodes on true branch
+    .onFalse(logError));
+\`\`\`
+
+</conditional_branching>
+
+<multi_way_routing>
+
+\`\`\`javascript
+// Assume other nodes are declared
+const routeByPriority = switchCase({ version: 3.2, config: { name: 'Route by Priority', parameters: {...} } });
+
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(routeByPriority
+    .onCase(0, processUrgent.to(notifyTeam.to(escalate)))  // Chain of 3 nodes
+    .onCase(1, processNormal)
+    .onCase(2, archive));
+\`\`\`
+
+</multi_way_routing>
+
+<parallel_execution>
+\`\`\`javascript
+const combineResults = merge({
+  version: 3.2,
+  config: {
+    name: 'Combine Results',
+    parameters: { mode: 'combine' },
+    position: [840, 300]
+  }
+});
+
+const branch1 = node({ type: 'n8n-nodes-base.httpRequest', ... });
+const branch2 = node({ type: 'n8n-nodes-base.httpRequest', ... });
+const processResults = node({ type: 'n8n-nodes-base.set', ... });
+
+// Connect branches to specific merge inputs using .input(n)
+export default workflow('id', 'name')
+  .add(trigger({ ... }))
+  .to(branch1.to(combineResults.input(0)))
+  .add(trigger({ ... }))
+  .to(branch2.to(combineResults.input(1)))
+  .add(combineResults)
+  .to(processResults);
+\`\`\`
+
+</parallel_execution>
+
+<batch_processing>
+\`\`\`javascript
+const startTrigger = trigger({
+  type: 'n8n-nodes-base.manualTrigger', version: 1,
+  config: { name: 'Start', position: [240, 300] },
+  output: [{}]
+});
+
+const fetchRecords = node({
+  type: 'n8n-nodes-base.httpRequest', version: 4.3,
+  config: { name: 'Fetch Records', parameters: { method: 'GET', url: '...' }, position: [540, 300] },
+  output: [{ id: 1 }, { id: 2 }, { id: 3 }]
+});
+
+const finalizeResults = node({
+  type: 'n8n-nodes-base.set', version: 3.4,
+  config: { name: 'Finalize', parameters: {}, position: [1140, 200] },
+  output: [{ summary: 'Processed 3 records' }]
+});
+
+const processRecord = node({
+  type: 'n8n-nodes-base.httpRequest', version: 4.3,
+  config: { name: 'Process Record', parameters: { method: 'POST', url: '...' }, position: [1140, 400] },
+  output: [{ id: 1, status: 'processed' }]
+});
+
+const sibNode = splitInBatches({ version: 3, config: { name: 'Batch Process', parameters: { batchSize: 10 }, position: [840, 300] } });
+
+export default workflow('id', 'name')
+  .add(startTrigger)
+  .to(fetchRecords)
+  .to(sibNode
+    .onDone(finalizeResults)
+    .onEachBatch(processRecord.to(nextBatch(sibNode)))
+  );
+\`\`\`
+
+</batch_processing>
+
+<multiple_triggers>
+\`\`\`javascript
+const webhookTrigger = trigger({
+  type: 'n8n-nodes-base.webhook', version: 2.1,
+  config: { name: 'Webhook', position: [240, 200] },
+  output: [{ body: { data: 'webhook payload' } }]
+});
+
+const processWebhook = node({
+  type: 'n8n-nodes-base.set', version: 3.4,
+  config: { name: 'Process Webhook', parameters: {}, position: [540, 200] },
+  output: [{ data: 'webhook payload', processed: true }]
+});
+
+const scheduleTrigger = trigger({
+  type: 'n8n-nodes-base.scheduleTrigger', version: 1.3,
+  config: { name: 'Daily Schedule', parameters: {}, position: [240, 500] },
+  output: [{}]
+});
+
+const processSchedule = node({
+  type: 'n8n-nodes-base.set', version: 3.4,
+  config: { name: 'Process Schedule', parameters: {}, position: [540, 500] },
+  output: [{ scheduled: true }]
+});
+
+export default workflow('id', 'name')
+  .add(webhookTrigger)
+  .to(processWebhook)
+  .add(scheduleTrigger)
+  .to(processSchedule);
+\`\`\`
+
+</multiple_triggers>
+
+<fan_in>
+\`\`\`javascript
+// Each trigger's execution runs in COMPLETE ISOLATION.
+// Different branches have no effect on each other.
+// Never duplicate chains for "isolation" - it's already guaranteed.
+
+const webhookTrigger = trigger({
+  type: 'n8n-nodes-base.webhook', version: 2.1,
+  config: { name: 'Webhook Trigger', position: [240, 200] },
+  output: [{ source: 'webhook' }]
+});
+
+const scheduleTrigger = trigger({
+  type: 'n8n-nodes-base.scheduleTrigger', version: 1.3,
+  config: { name: 'Daily Schedule', position: [240, 500] },
+  output: [{ source: 'schedule' }]
+});
+
+const processData = node({
+  type: 'n8n-nodes-base.set', version: 3.4,
+  config: { name: 'Process Data', parameters: {}, position: [540, 350] },
+  output: [{ processed: true }]
+});
+
+const sendNotification = node({
+  type: 'n8n-nodes-base.slack', version: 2.3,
+  config: { name: 'Notify Slack', parameters: {}, position: [840, 350] },
+  output: [{ ok: true }]
+});
+
+export default workflow('id', 'name')
+  .add(webhookTrigger)
+  .to(processData)
+  .to(sendNotification)
+  .add(scheduleTrigger)
+  .to(processData);
+\`\`\`
+
+</fan_in>
+
+<ai_agent_basic>
+\`\`\`javascript
+const openAiModel = languageModel({
+  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi', version: 1.3,
+  config: { name: 'OpenAI Model', parameters: {}, position: [540, 500] }
+});
+
+const startTrigger = trigger({
+  type: 'n8n-nodes-base.manualTrigger', version: 1,
+  config: { name: 'Start', position: [240, 300] },
+  output: [{}]
+});
+
+const aiAgent = node({
+  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,
+  config: {
+    name: 'AI Assistant',
+    parameters: { promptType: 'define', text: 'You are a helpful assistant' },
+    subnodes: { model: openAiModel },
+    position: [540, 300]
+  },
+  output: [{ output: 'AI response text' }]
+});
+
+export default workflow('ai-assistant', 'AI Assistant')
+  .add(startTrigger)
+  .to(aiAgent);
+\`\`\`
+
+</ai_agent_basic>
+
+<ai_agent_with_tools>
+\`\`\`javascript
+const openAiModel = languageModel({
+  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi', version: 1.3,
+  config: {
+    name: 'OpenAI Model', parameters: {},
+    credentials: { openAiApi: newCredential('OpenAI') },
+    position: [540, 500]
+  }
+});
+
+const calculatorTool = tool({
+  type: '@n8n/n8n-nodes-langchain.toolCalculator', version: 1,
+  config: { name: 'Calculator', parameters: {}, position: [700, 500] }
+});
+
+const startTrigger = trigger({
+  type: 'n8n-nodes-base.manualTrigger', version: 1,
+  config: { name: 'Start', position: [240, 300] },
+  output: [{}]
+});
+
+const aiAgent = node({
+  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,
+  config: {
+    name: 'Math Agent',
+    parameters: { promptType: 'define', text: 'You can use tools to help users' },
+    subnodes: { model: openAiModel, tools: [calculatorTool] },
+    position: [540, 300]
+  },
+  output: [{ output: '42' }]
+});
+
+export default workflow('ai-calculator', 'AI Calculator')
+  .add(startTrigger)
+  .to(aiAgent);
+\`\`\`
+
+</ai_agent_with_tools>
+
+<ai_agent_with_from_ai>
+\`\`\`javascript
+const gmailTool = tool({
+  type: 'n8n-nodes-base.gmailTool', version: 1,
+  config: {
+    name: 'Gmail Tool',
+    parameters: {
+      sendTo: fromAi('recipient', 'Email address'),
+      subject: fromAi('subject', 'Email subject'),
+      message: fromAi('body', 'Email content')
+    },
+    credentials: { gmailOAuth2: newCredential('Gmail') },
+    position: [700, 500]
+  }
+});
+
+const aiAgent = node({
+  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,
+  config: {
+    name: 'Email Agent',
+    parameters: { promptType: 'define', text: 'You can send emails' },
+    subnodes: { model: openAiModel, tools: [gmailTool] },
+    position: [540, 300]
+  },
+  output: [{ output: 'Email sent successfully' }]
+});
+
+export default workflow('ai-email', 'AI Email Sender')
+  .add(startTrigger)
+  .to(aiAgent);
+\`\`\`
+</ai_agent_with_from_ai>
+
+<ai_agent_with_structured_output>
+\`\`\`javascript
+const structuredParser = outputParser({
+  type: '@n8n/n8n-nodes-langchain.outputParserStructured', version: 1.3,
+  config: {
+    name: 'Structured Output Parser',
+    parameters: {
+      schemaType: 'fromJson',
+      jsonSchemaExample: '{ "sentiment": "positive", "confidence": 0.95, "summary": "brief summary" }'
+    },
+    position: [700, 500]
+  }
+});
+
+const aiAgent = node({
+  type: '@n8n/n8n-nodes-langchain.agent', version: 3.1,
+  config: {
+    name: 'Sentiment Analyzer',
+    parameters: { promptType: 'define', text: 'Analyze the sentiment of the input text', hasOutputParser: true },
+    subnodes: { model: openAiModel, outputParser: structuredParser },
+    position: [540, 300]
+  },
+  output: [{ sentiment: 'positive', confidence: 0.95, summary: 'The text expresses satisfaction' }]
+});
+
+export default workflow('ai-sentiment', 'AI Sentiment Analyzer')
+  .add(startTrigger)
+  .to(aiAgent);
+\`\`\`
+</ai_agent_with_structured_output>`;
+//# sourceMappingURL=workflow-patterns-detailed.js.map

package/dist/prompts/sdk-reference/workflow-patterns-detailed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-patterns-detailed.js","sourceRoot":"","sources":["../../../src/prompts/sdk-reference/workflow-patterns-detailed.ts"],"names":[],"mappings":";;;AASA,MAAM,UAAU,GACf,wSAAwS,CAAC;AAE7R,QAAA,0BAA0B,GAAG;;EAExC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAsYuB,CAAC"}

package/dist/prompts/sdk-reference/workflow-patterns.d.ts

@@ -0,0 +1,2 @@
+export declare const WORKFLOW_SDK_PATTERNS = "<linear_chain>\n```javascript\nimport { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, fromAi, expr } from '@n8n/workflow-sdk';\n\n// 1. Define all nodes first\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst fetchData = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Fetch Data', parameters: { method: 'GET', url: '...' } }\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Data', parameters: {} }\n});\n\n// 2. Compose workflow\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchData)\n  .to(processData);\n```\n\n</linear_chain>\n\n<independent_sources>\nWhen nodes return more than 1 item, chaining causes item multiplication: if Source A returns N items, a chained Source B runs N times instead of once.\n\n**When to use `executeOnce: true`:**\n- A node fetches data independently but is chained after another data source (prevents N\u00D7M multiplication)\n- A node should summarize/aggregate all upstream items in a single call (e.g., AI summary, send one notification)\n- A node calls an API that doesn't vary per input item\n\nFix with `executeOnce: true` (simplest) or parallel branches + Merge (when combining results):\n\n```javascript\n// sourceA outputs 10 items. sourceB outputs 10 items.\n// WRONG - processResults runs 100 times\n// startTrigger.to(sourceA.to(sourceB.to(processResults)))\n\n// FIX 1 - executeOnce: sourceB runs once regardless of input items\nconst sourceB = node({ ..., config: { ..., executeOnce: true } });\nstartTrigger.to(sourceA.to(sourceB.to(processResults)));\n\n// FIX 2 - parallel branches + Merge (combine by position)\nconst combineResults = merge({\n  version: 3.2,\n  config: { name: 'Combine Results', parameters: { mode: 'combine', combineBy: 'combineByPosition' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(combineResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(combineResults.input(1)))\n  .add(combineResults)\n  .to(processResults);\n\n// FIX 3 - parallel branches + Merge (append)\nconst allResults = merge({\n  version: 3.2,\n  config: { name: 'All Results', parameters: { mode: 'append' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(allResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(allResults.input(1)))\n  .add(allResults)\n  .to(processResults);\n```\n\n</independent_sources>\n\n<zero_item_safety>\nNodes that fetch or filter data may return 0 items, which stops the entire downstream chain.\nUse `alwaysOutputData: true` on data-fetching nodes to ensure the chain continues with an empty item `{json: {}}`.\n\n```javascript\n// Data Table might be empty (fresh table, no matching rows)\nconst getReflections = node({\n  type: 'n8n-nodes-base.dataTable',\n  version: 1.1,\n  config: {\n    name: 'Get Reflections',\n    alwaysOutputData: true,  // Chain continues even if table is empty\n    parameters: { resource: 'row', operation: 'get', returnAll: true }\n  }\n});\n\n// Downstream Code node handles the empty case\nconst processData = node({\n  type: 'n8n-nodes-base.code',\n  version: 2,\n  config: {\n    name: 'Process Data',\n    parameters: {\n      mode: 'runOnceForAllItems',\n      jsCode: \\`\nconst items = $input.all();\n// items will be [{json: {}}] if upstream had no data\nconst hasData = items.length > 0 && Object.keys(items[0].json).length > 0;\n// ... handle both cases\n\\`.trim()\n    }\n  }\n});\n```\n\n**When to use `alwaysOutputData: true`:**\n- Data Table with `operation: 'get'` (table may be empty or freshly created)\n- Any lookup/search/filter node whose result feeds into downstream processing\n- HTTP Request that may return an empty array\n\n**When NOT to use it:**\n- Trigger nodes (they always produce output)\n- Code nodes (handle empty input in your code logic instead)\n- Nodes at the end of the chain (no downstream to protect)\n\n</zero_item_safety>\n\n<conditional_branching>\n\n**CRITICAL:** Each branch defines a COMPLETE processing path. Chain multiple steps INSIDE the branch using .to().\n\nEvery IF/Filter `conditions` parameter MUST include `options`, `conditions`, and `combinator`:\n```javascript\nconst checkValid = ifElse({\n  version: 2.2,\n  config: {\n    name: 'Check Valid',\n    parameters: {\n      conditions: {\n        options: { caseSensitive: true, leftValue: '', typeValidation: 'strict' },\n        conditions: [{ leftValue: '={{ $json.status }}', operator: { type: 'string', operation: 'equals' }, rightValue: 'active' }],\n        combinator: 'and'\n      }\n    }\n  }\n});\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(checkValid\n    .onTrue(formatData.to(enrichData.to(saveToDb)))  // Chain 3 nodes on true branch\n    .onFalse(logError));\n```\n\n</conditional_branching>\n\n<multi_way_routing>\n\nSwitch rules use `rules.values` (NOT `rules.rules`). Each rule needs `outputKey` and a complete `conditions` object:\n```javascript\nconst routeByPriority = switchCase({\n  version: 3.2,\n  config: {\n    name: 'Route by Priority',\n    parameters: {\n      rules: {\n        values: [\n          { outputKey: 'urgent', conditions: { options: { caseSensitive: true, leftValue: '', typeValidation: 'strict' }, conditions: [{ leftValue: '={{ $json.priority }}', operator: { type: 'string', operation: 'equals' }, rightValue: 'urgent' }], combinator: 'and' } },\n          { outputKey: 'normal', conditions: { options: { caseSensitive: true, leftValue: '', typeValidation: 'strict' }, conditions: [{ leftValue: '={{ $json.priority }}', operator: { type: 'string', operation: 'equals' }, rightValue: 'normal' }], combinator: 'and' } },\n        ]\n      }\n    }\n  }\n});\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(routeByPriority\n    .onCase('urgent', processUrgent.to(notifyTeam.to(escalate)))\n    .onCase('normal', processNormal)\n    .onDefault(archive));\n```\n\n</multi_way_routing>\n\n<parallel_execution>\n```javascript\n// First declare the Merge node using merge()\nconst combineResults = merge({\n  version: 3.2,\n  config: { name: 'Combine Results', parameters: { mode: 'combine' } }\n});\n\n// Declare branch nodes\nconst branch1 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst branch2 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst processResults = node({ type: 'n8n-nodes-base.set', ... });\n\n// Connect branches to specific merge inputs using .input(n)\nexport default workflow('id', 'name')\n  .add(trigger({ ... }))\n  .to(branch1.to(combineResults.input(0)))  // Connect to input 0\n  .add(trigger({ ... }))\n  .to(branch2.to(combineResults.input(1)))  // Connect to input 1\n  .add(combineResults)\n  .to(processResults);  // Process merged results\n```\n\n</parallel_execution>\n\n<batch_processing>\n```javascript\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst fetchRecords = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Fetch Records', parameters: { method: 'GET', url: '...' } }\n});\n\nconst finalizeResults = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Finalize', parameters: {} }\n});\n\nconst processRecord = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Process Record', parameters: { method: 'POST', url: '...' } }\n});\n\nconst sibNode = splitInBatches({ version: 3, config: { name: 'Batch Process', parameters: { batchSize: 10 } } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchRecords)\n  .to(sibNode\n    .onDone(finalizeResults)\n    .onEachBatch(processRecord.to(nextBatch(sibNode)))\n  );\n```\n\n</batch_processing>\n\n<multiple_triggers>\n```javascript\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook',\n  version: 2.1,\n  config: { name: 'Webhook' }\n});\n\nconst processWebhook = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Webhook', parameters: {} }\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger',\n  version: 1.3,\n  config: { name: 'Daily Schedule', parameters: {} }\n});\n\nconst processSchedule = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Schedule', parameters: {} }\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processWebhook)\n  .add(scheduleTrigger)\n  .to(processSchedule);\n```\n\n</multiple_triggers>\n\n<fan_in>\n```javascript\n// Each trigger's execution runs in COMPLETE ISOLATION.\n// Different branches have no effect on each other.\n// Never duplicate chains for \"isolation\" - it's already guaranteed.\n\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook',\n  version: 2.1,\n  config: { name: 'Webhook Trigger' }\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger',\n  version: 1.3,\n  config: { name: 'Daily Schedule' }\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Data', parameters: {} }\n});\n\nconst sendNotification = node({\n  type: 'n8n-nodes-base.slack',\n  version: 2.3,\n  config: { name: 'Notify Slack', parameters: {} }\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processData)\n  .to(sendNotification)\n  .add(scheduleTrigger)\n  .to(processData);\n```\n\n</fan_in>\n\n<ai_agent_basic>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: { name: 'OpenAI Model', parameters: {} }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'AI Assistant',\n    parameters: { promptType: 'define', text: 'You are a helpful assistant' },\n    subnodes: { model: openAiModel }\n  }\n});\n\nexport default workflow('ai-assistant', 'AI Assistant')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_basic>\n\n<ai_agent_with_tools>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: {\n    name: 'OpenAI Model',\n    parameters: {},\n    credentials: { openAiApi: newCredential('OpenAI') }\n  }\n});\n\nconst calculatorTool = tool({\n  type: '@n8n/n8n-nodes-langchain.toolCalculator',\n  version: 1,\n  config: { name: 'Calculator', parameters: {} }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Math Agent',\n    parameters: { promptType: 'define', text: 'You can use tools to help users' },\n    subnodes: { model: openAiModel, tools: [calculatorTool] }\n  }\n});\n\nexport default workflow('ai-calculator', 'AI Calculator')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_with_tools>\n\n<ai_agent_with_from_ai>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: {\n    name: 'OpenAI Model',\n    parameters: {},\n    credentials: { openAiApi: newCredential('OpenAI') }\n  }\n});\n\nconst gmailTool = tool({\n  type: 'n8n-nodes-base.gmailTool',\n  version: 1,\n  config: {\n    name: 'Gmail Tool',\n    parameters: {\n      sendTo: fromAi('recipient', 'Email address'),\n      subject: fromAi('subject', 'Email subject'),\n      message: fromAi('body', 'Email content')\n    },\n    credentials: { gmailOAuth2: newCredential('Gmail') }\n  }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Email Agent',\n    parameters: { promptType: 'define', text: 'You can send emails' },\n    subnodes: { model: openAiModel, tools: [gmailTool] }\n  }\n});\n\nexport default workflow('ai-email', 'AI Email Sender')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_from_ai>\n\n<ai_agent_with_structured_output>\n```javascript\nconst structuredParser = outputParser({\n  type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n  version: 1.3,\n  config: {\n    name: 'Structured Output Parser',\n    parameters: {\n      schemaType: 'fromJson',\n      jsonSchemaExample: '{ \"sentiment\": \"positive\", \"confidence\": 0.95, \"summary\": \"brief summary\" }'\n    }\n  }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Sentiment Analyzer',\n    parameters: { promptType: 'define', text: 'Analyze the sentiment of the input text', hasOutputParser: true },\n    subnodes: { model: openAiModel, outputParser: structuredParser }\n  }\n});\n\nexport default workflow('ai-sentiment', 'AI Sentiment Analyzer')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_structured_output>";
+export { WORKFLOW_SDK_PATTERNS as WORKFLOW_PATTERNS_CONCISE };