n8n-mcp 2.7.10 → 2.7.12

package/dist/services/task-templates.js

@@ -13,6 +13,9 @@ class TaskTemplates {
     static getTaskTemplate(task) {
         return this.templates[task];
     }
+    static getTemplate(task) {
+        return this.getTaskTemplate(task);
+    }
     static searchTasks(keyword) {
         const lower = keyword.toLowerCase();
         return Object.entries(this.templates)
@@ -23,13 +26,14 @@ class TaskTemplates {
     }
     static getTaskCategories() {
         return {
-            'HTTP/API': ['get_api_data', 'post_json_request', 'call_api_with_auth'],
-            'Webhooks': ['receive_webhook', 'webhook_with_response'],
-            'Database': ['query_postgres', 'insert_postgres_data'],
-            'AI/LangChain': ['chat_with_ai', 'ai_agent_workflow', 'multi_tool_ai_agent'],
-            'Data Processing': ['transform_data', 'filter_data'],
+            'HTTP/API': ['get_api_data', 'post_json_request', 'call_api_with_auth', 'api_call_with_retry'],
+            'Webhooks': ['receive_webhook', 'webhook_with_response', 'webhook_with_error_handling', 'process_webhook_data'],
+            'Database': ['query_postgres', 'insert_postgres_data', 'database_transaction_safety'],
+            'AI/LangChain': ['chat_with_ai', 'ai_agent_workflow', 'multi_tool_ai_agent', 'ai_rate_limit_handling'],
+            'Data Processing': ['transform_data', 'filter_data', 'fault_tolerant_processing', 'process_webhook_data'],
             'Communication': ['send_slack_message', 'send_email'],
-            'AI Tool Usage': ['use_google_sheets_as_tool', 'use_slack_as_tool', 'multi_tool_ai_agent']
+            'AI Tool Usage': ['use_google_sheets_as_tool', 'use_slack_as_tool', 'multi_tool_ai_agent'],
+            'Error Handling': ['modern_error_handling_patterns', 'api_call_with_retry', 'fault_tolerant_processing', 'webhook_with_error_handling', 'database_transaction_safety', 'ai_rate_limit_handling']
         };
     }
 }
@@ -42,7 +46,12 @@ TaskTemplates.templates = {
         configuration: {
             method: 'GET',
             url: '',
-            authentication: 'none'
+            authentication: 'none',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 1000,
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -61,6 +70,11 @@ TaskTemplates.templates = {
                 property: 'sendHeaders',
                 description: 'Add custom headers if needed',
                 when: 'API requires specific headers'
+            },
+            {
+                property: 'alwaysOutputData',
+                description: 'Set to true to capture error responses',
+                when: 'Need to debug API errors'
             }
         ]
     },
@@ -74,7 +88,12 @@ TaskTemplates.templates = {
             sendBody: true,
             contentType: 'json',
             specifyBody: 'json',
-            jsonBody: ''
+            jsonBody: '',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 2,
+            waitBetweenTries: 1000,
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -92,11 +111,17 @@ TaskTemplates.templates = {
             {
                 property: 'authentication',
                 description: 'Add authentication if required'
+            },
+            {
+                property: 'onError',
+                description: 'Set to "continueRegularOutput" for non-critical operations',
+                when: 'Failure should not stop the workflow'
             }
         ],
         notes: [
             'Make sure jsonBody contains valid JSON',
-            'Content-Type header is automatically set to application/json'
+            'Content-Type header is automatically set to application/json',
+            'Be careful with retries on non-idempotent operations'
         ]
     },
     'call_api_with_auth': {
@@ -109,6 +134,11 @@ TaskTemplates.templates = {
             authentication: 'genericCredentialType',
             genericAuthType: 'headerAuth',
             sendHeaders: true,
+            onError: 'continueErrorOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 2000,
+            alwaysOutputData: true,
             headerParameters: {
                 parameters: [
                     {
@@ -149,7 +179,9 @@ TaskTemplates.templates = {
             httpMethod: 'POST',
             path: 'webhook',
             responseMode: 'lastNode',
-            responseData: 'allEntries'
+            responseData: 'allEntries',
+            onError: 'continueRegularOutput',
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -182,7 +214,9 @@ TaskTemplates.templates = {
             path: 'webhook',
             responseMode: 'responseNode',
             responseData: 'firstEntryJson',
-            responseCode: 200
+            responseCode: 200,
+            onError: 'continueRegularOutput',
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -195,13 +229,104 @@ TaskTemplates.templates = {
             'responseMode: responseNode requires a Respond to Webhook node'
         ]
     },
+    'process_webhook_data': {
+        task: 'process_webhook_data',
+        description: 'Process incoming webhook data with Code node (shows correct data access)',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// ⚠️ CRITICAL: Webhook data is nested under 'body' property!
+// Connect this Code node after a Webhook node
+
+// Access webhook payload data - it's under .body, not directly under .json
+const webhookData = items[0].json.body;  // ✅ CORRECT
+const headers = items[0].json.headers;   // HTTP headers
+const query = items[0].json.query;       // Query parameters
+
+// Common mistake to avoid:
+// const command = items[0].json.testCommand;  // ❌ WRONG - will be undefined!
+// const command = items[0].json.body.testCommand;  // ✅ CORRECT
+
+// Process the webhook data
+try {
+  // Validate required fields
+  if (!webhookData.command) {
+    throw new Error('Missing required field: command');
+  }
+  
+  // Process based on command
+  let result = {};
+  switch (webhookData.command) {
+    case 'process':
+      result = {
+        status: 'processed',
+        data: webhookData.data,
+        processedAt: DateTime.now().toISO()
+      };
+      break;
+      
+    case 'validate':
+      result = {
+        status: 'validated',
+        isValid: true,
+        validatedFields: Object.keys(webhookData.data || {})
+      };
+      break;
+      
+    default:
+      result = {
+        status: 'unknown_command',
+        command: webhookData.command
+      };
+  }
+  
+  // Return processed data
+  return [{
+    json: {
+      ...result,
+      requestId: headers['x-request-id'] || crypto.randomUUID(),
+      source: query.source || 'webhook',
+      originalCommand: webhookData.command,
+      metadata: {
+        httpMethod: items[0].json.httpMethod,
+        webhookPath: items[0].json.webhookPath,
+        timestamp: DateTime.now().toISO()
+      }
+    }
+  }];
+  
+} catch (error) {
+  // Return error response
+  return [{
+    json: {
+      status: 'error',
+      error: error.message,
+      timestamp: DateTime.now().toISO()
+    }
+  }];
+}`,
+            onError: 'continueRegularOutput'
+        },
+        userMustProvide: [],
+        notes: [
+            '⚠️ WEBHOOK DATA IS AT items[0].json.body, NOT items[0].json',
+            'This is the most common webhook processing mistake',
+            'Headers are at items[0].json.headers',
+            'Query parameters are at items[0].json.query',
+            'Connect this Code node directly after a Webhook node'
+        ]
+    },
     'query_postgres': {
         task: 'query_postgres',
         description: 'Query data from PostgreSQL database',
         nodeType: 'nodes-base.postgres',
         configuration: {
             operation: 'executeQuery',
-            query: ''
+            query: '',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 1000
         },
         userMustProvide: [
             {
@@ -230,7 +355,11 @@ TaskTemplates.templates = {
             operation: 'insert',
             table: '',
             columns: '',
-            returnFields: '*'
+            returnFields: '*',
+            onError: 'stopWorkflow',
+            retryOnFail: true,
+            maxTries: 2,
+            waitBetweenTries: 1000
         },
         userMustProvide: [
             {
@@ -264,7 +393,12 @@ TaskTemplates.templates = {
                         content: ''
                     }
                 ]
-            }
+            },
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 5000,
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -386,7 +520,11 @@ return results;`
             resource: 'message',
             operation: 'post',
             channel: '',
-            text: ''
+            text: '',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 2,
+            waitBetweenTries: 2000
         },
         userMustProvide: [
             {
@@ -419,7 +557,12 @@ return results;`
             fromEmail: '',
             toEmail: '',
             subject: '',
-            text: ''
+            text: '',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 3000,
+            alwaysOutputData: true
         },
         userMustProvide: [
             {
@@ -550,6 +693,705 @@ return results;`
             'Test each tool individually before combining',
             'Set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true for community nodes'
         ]
+    },
+    'api_call_with_retry': {
+        task: 'api_call_with_retry',
+        description: 'Resilient API call with automatic retry on failure',
+        nodeType: 'nodes-base.httpRequest',
+        configuration: {
+            method: 'GET',
+            url: '',
+            retryOnFail: true,
+            maxTries: 5,
+            waitBetweenTries: 2000,
+            alwaysOutputData: true,
+            sendHeaders: true,
+            headerParameters: {
+                parameters: [
+                    {
+                        name: 'X-Request-ID',
+                        value: '={{ $workflow.id }}-{{ $itemIndex }}'
+                    }
+                ]
+            }
+        },
+        userMustProvide: [
+            {
+                property: 'url',
+                description: 'The API endpoint to call',
+                example: 'https://api.example.com/resource/{{ $json.id }}'
+            }
+        ],
+        optionalEnhancements: [
+            {
+                property: 'authentication',
+                description: 'Add API authentication'
+            },
+            {
+                property: 'onError',
+                description: 'Change to "stopWorkflow" for critical API calls',
+                when: 'This is a critical API call that must succeed'
+            }
+        ],
+        notes: [
+            'Retries help with rate limits and transient network issues',
+            'waitBetweenTries prevents hammering the API',
+            'alwaysOutputData captures error responses for debugging',
+            'Consider exponential backoff for production use'
+        ]
+    },
+    'fault_tolerant_processing': {
+        task: 'fault_tolerant_processing',
+        description: 'Data processing that continues despite individual item failures',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// Process items with error handling
+const results = [];
+
+for (const item of items) {
+  try {
+    // Your processing logic here
+    const processed = {
+      ...item.json,
+      processed: true,
+      timestamp: new Date().toISOString()
+    };
+    
+    results.push({ json: processed });
+  } catch (error) {
+    // Log error but continue processing
+    console.error('Processing failed for item:', item.json.id, error);
+    
+    // Add error item to results
+    results.push({
+      json: {
+        ...item.json,
+        error: error.message,
+        processed: false
+      }
+    });
+  }
+}
+
+return results;`,
+            onError: 'continueRegularOutput',
+            alwaysOutputData: true
+        },
+        userMustProvide: [
+            {
+                property: 'Processing logic',
+                description: 'Replace the comment with your data transformation logic'
+            }
+        ],
+        optionalEnhancements: [
+            {
+                property: 'Error notification',
+                description: 'Add IF node after to handle error items separately'
+            }
+        ],
+        notes: [
+            'Individual item failures won\'t stop processing of other items',
+            'Error items are marked and can be handled separately',
+            'continueOnFail ensures workflow continues even on total failure'
+        ]
+    },
+    'webhook_with_error_handling': {
+        task: 'webhook_with_error_handling',
+        description: 'Webhook that gracefully handles processing errors',
+        nodeType: 'nodes-base.webhook',
+        configuration: {
+            httpMethod: 'POST',
+            path: 'resilient-webhook',
+            responseMode: 'responseNode',
+            responseData: 'firstEntryJson',
+            onError: 'continueRegularOutput',
+            alwaysOutputData: true
+        },
+        userMustProvide: [
+            {
+                property: 'path',
+                description: 'Unique webhook path',
+                example: 'order-processor'
+            },
+            {
+                property: 'Respond to Webhook node',
+                description: 'Add node to send appropriate success/error responses'
+            }
+        ],
+        optionalEnhancements: [
+            {
+                property: 'Validation',
+                description: 'Add IF node to validate webhook payload'
+            },
+            {
+                property: 'Error logging',
+                description: 'Add error handler node for failed requests'
+            }
+        ],
+        notes: [
+            'onError: continueRegularOutput ensures webhook always sends a response',
+            'Use Respond to Webhook node to send appropriate status codes',
+            'Log errors but don\'t expose internal errors to webhook callers',
+            'Consider rate limiting for public webhooks'
+        ]
+    },
+    'modern_error_handling_patterns': {
+        task: 'modern_error_handling_patterns',
+        description: 'Examples of modern error handling using onError property',
+        nodeType: 'nodes-base.httpRequest',
+        configuration: {
+            method: 'GET',
+            url: '',
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 3,
+            waitBetweenTries: 2000,
+            alwaysOutputData: true
+        },
+        userMustProvide: [
+            {
+                property: 'url',
+                description: 'The API endpoint'
+            },
+            {
+                property: 'onError',
+                description: 'Choose error handling strategy',
+                example: 'continueRegularOutput'
+            }
+        ],
+        notes: [
+            'onError replaces the deprecated continueOnFail property',
+            'continueRegularOutput: Continue with normal output on error',
+            'continueErrorOutput: Route errors to error output for special handling',
+            'stopWorkflow: Stop the entire workflow on error',
+            'Combine with retryOnFail for resilient workflows'
+        ]
+    },
+    'database_transaction_safety': {
+        task: 'database_transaction_safety',
+        description: 'Database operations with proper error handling',
+        nodeType: 'nodes-base.postgres',
+        configuration: {
+            operation: 'executeQuery',
+            query: 'BEGIN; INSERT INTO orders ...; COMMIT;',
+            onError: 'continueErrorOutput',
+            retryOnFail: false,
+            alwaysOutputData: true
+        },
+        userMustProvide: [
+            {
+                property: 'query',
+                description: 'Your SQL query or transaction'
+            }
+        ],
+        notes: [
+            'Transactions should not be retried automatically',
+            'Use continueErrorOutput to handle errors separately',
+            'Consider implementing compensating transactions',
+            'Always log transaction failures for audit'
+        ]
+    },
+    'ai_rate_limit_handling': {
+        task: 'ai_rate_limit_handling',
+        description: 'AI API calls with rate limit handling',
+        nodeType: 'nodes-base.openAi',
+        configuration: {
+            resource: 'chat',
+            operation: 'message',
+            modelId: 'gpt-4',
+            messages: {
+                values: [
+                    {
+                        role: 'user',
+                        content: ''
+                    }
+                ]
+            },
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 5,
+            waitBetweenTries: 5000,
+            alwaysOutputData: true
+        },
+        userMustProvide: [
+            {
+                property: 'messages.values[0].content',
+                description: 'The prompt for the AI'
+            }
+        ],
+        notes: [
+            'AI APIs often have rate limits',
+            'Longer wait times help avoid hitting limits',
+            'Consider implementing exponential backoff in Code node',
+            'Monitor usage to stay within quotas'
+        ]
+    },
+    'custom_ai_tool': {
+        task: 'custom_ai_tool',
+        description: 'Create a custom tool for AI agents using Code node',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            mode: 'runOnceForEachItem',
+            jsCode: `// Custom AI Tool - Example: Text Analysis
+// This code will be called by AI agents with $json containing the input
+
+// Access the input from the AI agent
+const text = $json.text || '';
+const operation = $json.operation || 'analyze';
+
+// Perform the requested operation
+let result = {};
+
+switch (operation) {
+  case 'wordCount':
+    result = {
+      wordCount: text.split(/\\s+/).filter(word => word.length > 0).length,
+      characterCount: text.length,
+      lineCount: text.split('\\n').length
+    };
+    break;
+    
+  case 'extract':
+    // Extract specific patterns (emails, URLs, etc.)
+    result = {
+      emails: text.match(/[\\w.-]+@[\\w.-]+\\.\\w+/g) || [],
+      urls: text.match(/https?:\\/\\/[^\\s]+/g) || [],
+      numbers: text.match(/\\b\\d+\\b/g) || []
+    };
+    break;
+    
+  default:
+    result = {
+      error: 'Unknown operation',
+      availableOperations: ['wordCount', 'extract']
+    };
+}
+
+return [{
+  json: {
+    ...result,
+    originalText: text,
+    operation: operation,
+    processedAt: DateTime.now().toISO()
+  }
+}];`,
+            onError: 'continueRegularOutput'
+        },
+        userMustProvide: [],
+        notes: [
+            'Connect this to AI Agent node\'s tool input',
+            'AI will pass data in $json',
+            'Use "Run Once for Each Item" mode for AI tools',
+            'Return structured data the AI can understand'
+        ]
+    },
+    'aggregate_data': {
+        task: 'aggregate_data',
+        description: 'Aggregate data from multiple items into summary statistics',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// Aggregate data from all items
+const stats = {
+  count: 0,
+  sum: 0,
+  min: Infinity,
+  max: -Infinity,
+  values: [],
+  categories: {},
+  errors: []
+};
+
+// Process each item
+for (const item of items) {
+  try {
+    const value = item.json.value || item.json.amount || 0;
+    const category = item.json.category || 'uncategorized';
+    
+    stats.count++;
+    stats.sum += value;
+    stats.min = Math.min(stats.min, value);
+    stats.max = Math.max(stats.max, value);
+    stats.values.push(value);
+    
+    // Count by category
+    stats.categories[category] = (stats.categories[category] || 0) + 1;
+    
+  } catch (error) {
+    stats.errors.push({
+      item: item.json,
+      error: error.message
+    });
+  }
+}
+
+// Calculate additional statistics
+const average = stats.count > 0 ? stats.sum / stats.count : 0;
+const sorted = [...stats.values].sort((a, b) => a - b);
+const median = sorted.length > 0 
+  ? sorted[Math.floor(sorted.length / 2)] 
+  : 0;
+
+return [{
+  json: {
+    totalItems: stats.count,
+    sum: stats.sum,
+    average: average,
+    median: median,
+    min: stats.min === Infinity ? 0 : stats.min,
+    max: stats.max === -Infinity ? 0 : stats.max,
+    categoryCounts: stats.categories,
+    errorCount: stats.errors.length,
+    errors: stats.errors,
+    processedAt: DateTime.now().toISO()
+  }
+}];`,
+            onError: 'continueRegularOutput'
+        },
+        userMustProvide: [],
+        notes: [
+            'Assumes items have "value" or "amount" field',
+            'Groups by "category" field if present',
+            'Returns single item with all statistics',
+            'Handles errors gracefully'
+        ]
+    },
+    'batch_process_with_api': {
+        task: 'batch_process_with_api',
+        description: 'Process items in batches with API calls',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// Batch process items with API calls
+const BATCH_SIZE = 10;
+const API_URL = 'https://api.example.com/batch-process'; // USER MUST UPDATE
+const results = [];
+
+// Process items in batches
+for (let i = 0; i < items.length; i += BATCH_SIZE) {
+  const batch = items.slice(i, i + BATCH_SIZE);
+  
+  try {
+    // Prepare batch data
+    const batchData = batch.map(item => ({
+      id: item.json.id,
+      data: item.json
+    }));
+    
+    // Make API request for batch
+    const response = await $helpers.httpRequest({
+      method: 'POST',
+      url: API_URL,
+      body: {
+        items: batchData
+      },
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    });
+    
+    // Add results
+    if (response.results && Array.isArray(response.results)) {
+      response.results.forEach((result, index) => {
+        results.push({
+          json: {
+            ...batch[index].json,
+            ...result,
+            batchNumber: Math.floor(i / BATCH_SIZE) + 1,
+            processedAt: DateTime.now().toISO()
+          }
+        });
+      });
+    }
+    
+    // Add delay between batches to avoid rate limits
+    if (i + BATCH_SIZE < items.length) {
+      await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+    
+  } catch (error) {
+    // Add failed batch items with error
+    batch.forEach(item => {
+      results.push({
+        json: {
+          ...item.json,
+          error: error.message,
+          status: 'failed',
+          batchNumber: Math.floor(i / BATCH_SIZE) + 1
+        }
+      });
+    });
+  }
+}
+
+return results;`,
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 2
+        },
+        userMustProvide: [
+            {
+                property: 'jsCode',
+                description: 'Update API_URL in the code',
+                example: 'https://your-api.com/batch'
+            }
+        ],
+        notes: [
+            'Processes items in batches of 10',
+            'Includes delay between batches',
+            'Handles batch failures gracefully',
+            'Update API_URL and adjust BATCH_SIZE as needed'
+        ]
+    },
+    'error_safe_transform': {
+        task: 'error_safe_transform',
+        description: 'Transform data with comprehensive error handling',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// Safe data transformation with validation
+const results = [];
+const errors = [];
+
+for (const item of items) {
+  try {
+    // Validate required fields
+    const required = ['id', 'name']; // USER SHOULD UPDATE
+    const missing = required.filter(field => !item.json[field]);
+    
+    if (missing.length > 0) {
+      throw new Error(\`Missing required fields: \${missing.join(', ')}\`);
+    }
+    
+    // Transform data with type checking
+    const transformed = {
+      // Ensure ID is string
+      id: String(item.json.id),
+      
+      // Clean and validate name
+      name: String(item.json.name).trim(),
+      
+      // Parse numbers safely
+      amount: parseFloat(item.json.amount) || 0,
+      
+      // Parse dates safely
+      date: item.json.date 
+        ? DateTime.fromISO(item.json.date).isValid 
+          ? DateTime.fromISO(item.json.date).toISO()
+          : null
+        : null,
+      
+      // Boolean conversion
+      isActive: Boolean(item.json.active || item.json.isActive),
+      
+      // Array handling
+      tags: Array.isArray(item.json.tags) 
+        ? item.json.tags.filter(tag => typeof tag === 'string')
+        : [],
+      
+      // Nested object handling
+      metadata: typeof item.json.metadata === 'object' 
+        ? item.json.metadata 
+        : {},
+      
+      // Add processing info
+      processedAt: DateTime.now().toISO(),
+      originalIndex: items.indexOf(item)
+    };
+    
+    results.push({
+      json: transformed
+    });
+    
+  } catch (error) {
+    errors.push({
+      json: {
+        error: error.message,
+        originalData: item.json,
+        index: items.indexOf(item),
+        status: 'failed'
+      }
+    });
+  }
+}
+
+// Add summary at the end
+results.push({
+  json: {
+    _summary: {
+      totalProcessed: results.length - errors.length,
+      totalErrors: errors.length,
+      successRate: ((results.length - errors.length) / items.length * 100).toFixed(2) + '%',
+      timestamp: DateTime.now().toISO()
+    }
+  }
+});
+
+// Include errors at the end
+return [...results, ...errors];`,
+            onError: 'continueRegularOutput'
+        },
+        userMustProvide: [
+            {
+                property: 'jsCode',
+                description: 'Update required fields array',
+                example: "const required = ['id', 'email', 'name'];"
+            }
+        ],
+        notes: [
+            'Validates all data types',
+            'Handles missing/invalid data gracefully',
+            'Returns both successful and failed items',
+            'Includes processing summary'
+        ]
+    },
+    'async_data_processing': {
+        task: 'async_data_processing',
+        description: 'Process data with async operations and proper error handling',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'javaScript',
+            jsCode: `// Async processing with concurrent limits
+const CONCURRENT_LIMIT = 5;
+const results = [];
+
+// Process items with concurrency control
+async function processItem(item, index) {
+  try {
+    // Simulate async operation (replace with actual logic)
+    // Example: API call, database query, file operation
+    await new Promise(resolve => setTimeout(resolve, 100));
+    
+    // Actual processing logic here
+    const processed = {
+      ...item.json,
+      processed: true,
+      index: index,
+      timestamp: DateTime.now().toISO()
+    };
+    
+    // Example async operation - external API call
+    if (item.json.needsEnrichment) {
+      const enrichment = await $helpers.httpRequest({
+        method: 'GET',
+        url: \`https://api.example.com/enrich/\${item.json.id}\`
+      });
+      processed.enrichment = enrichment;
+    }
+    
+    return { json: processed };
+    
+  } catch (error) {
+    return {
+      json: {
+        ...item.json,
+        error: error.message,
+        status: 'failed',
+        index: index
+      }
+    };
+  }
+}
+
+// Process in batches with concurrency limit
+for (let i = 0; i < items.length; i += CONCURRENT_LIMIT) {
+  const batch = items.slice(i, i + CONCURRENT_LIMIT);
+  const batchPromises = batch.map((item, batchIndex) => 
+    processItem(item, i + batchIndex)
+  );
+  
+  const batchResults = await Promise.all(batchPromises);
+  results.push(...batchResults);
+}
+
+return results;`,
+            onError: 'continueRegularOutput',
+            retryOnFail: true,
+            maxTries: 2
+        },
+        userMustProvide: [],
+        notes: [
+            'Processes 5 items concurrently',
+            'Prevents overwhelming external services',
+            'Each item processed independently',
+            'Errors don\'t affect other items'
+        ]
+    },
+    'python_data_analysis': {
+        task: 'python_data_analysis',
+        description: 'Analyze data using Python with statistics',
+        nodeType: 'nodes-base.code',
+        configuration: {
+            language: 'python',
+            pythonCode: `# Python data analysis - use underscore prefix for built-in variables
+import json
+from datetime import datetime
+import statistics
+
+# Collect data for analysis
+values = []
+categories = {}
+dates = []
+
+# Use _input.all() to get items in Python
+for item in _input.all():
+    # Convert JsProxy to Python dict for safe access
+    item_data = item.json.to_py()
+    
+    # Extract numeric values
+    if 'value' in item_data or 'amount' in item_data:
+        value = item_data.get('value', item_data.get('amount', 0))
+        if isinstance(value, (int, float)):
+            values.append(value)
+    
+    # Count categories
+    category = item_data.get('category', 'uncategorized')
+    categories[category] = categories.get(category, 0) + 1
+    
+    # Collect dates
+    if 'date' in item_data:
+        dates.append(item_data['date'])
+
+# Calculate statistics
+result = {
+    'itemCount': len(_input.all()),
+    'values': {
+        'count': len(values),
+        'sum': sum(values) if values else 0,
+        'mean': statistics.mean(values) if values else 0,
+        'median': statistics.median(values) if values else 0,
+        'min': min(values) if values else 0,
+        'max': max(values) if values else 0,
+        'stdev': statistics.stdev(values) if len(values) > 1 else 0
+    },
+    'categories': categories,
+    'dateRange': {
+        'earliest': min(dates) if dates else None,
+        'latest': max(dates) if dates else None,
+        'count': len(dates)
+    },
+    'analysis': {
+        'hasNumericData': len(values) > 0,
+        'hasCategoricalData': len(categories) > 0,
+        'hasTemporalData': len(dates) > 0,
+        'dataQuality': 'good' if len(values) > len(items) * 0.8 else 'partial'
+    },
+    'processedAt': datetime.now().isoformat()
+}
+
+# Return single summary item
+return [{'json': result}]`,
+            onError: 'continueRegularOutput'
+        },
+        userMustProvide: [],
+        notes: [
+            'Uses Python statistics module',
+            'Analyzes numeric, categorical, and date data',
+            'Returns comprehensive summary',
+            'Handles missing data gracefully'
+        ]
     }
 };
 //# sourceMappingURL=task-templates.js.map