machinaos 0.0.1

package/client/src/nodeDefinitions/whatsappNodes.ts

@@ -0,0 +1,865 @@
+// WhatsApp Node Definitions - Messaging integration via whatsmeow
+import {
+  INodeTypeDescription,
+  NodeConnectionType
+} from '../types/INodeProperties';
+import { API_CONFIG } from '../config/api';
+
+// Get WebSocket URL dynamically based on environment
+const getWebSocketUrl = (): string => {
+  const baseUrl = API_CONFIG.PYTHON_BASE_URL;
+
+  // Production: empty base URL means use current origin
+  if (!baseUrl) {
+    const wsProtocol = window.location.protocol === 'https:' ? 'wss' : 'ws';
+    return `${wsProtocol}://${window.location.host}/ws/status`;
+  }
+
+  // Development: convert http(s) to ws(s)
+  const wsProtocol = baseUrl.startsWith('https') ? 'wss' : 'ws';
+  const wsUrl = baseUrl.replace(/^https?/, wsProtocol);
+  return `${wsUrl}/ws/status`;
+};
+
+// Helper to make WebSocket requests
+async function wsRequest(type: string, data: Record<string, unknown> = {}): Promise<unknown> {
+  return new Promise((resolve, reject) => {
+    const ws = new WebSocket(getWebSocketUrl());
+    const timeout = setTimeout(() => {
+      ws.close();
+      reject(new Error('WebSocket request timeout'));
+    }, 10000);
+
+    ws.onopen = () => {
+      ws.send(JSON.stringify({ type, ...data }));
+    };
+
+    ws.onmessage = (event) => {
+      clearTimeout(timeout);
+      try {
+        const response = JSON.parse(event.data);
+        ws.close();
+        resolve(response);
+      } catch (e) {
+        ws.close();
+        reject(e);
+      }
+    };
+
+    ws.onerror = (error) => {
+      clearTimeout(timeout);
+      ws.close();
+      reject(error);
+    };
+  });
+}
+
+// ============================================================================
+// WHATSAPP ICONS (SVG Data URIs)
+// ============================================================================
+
+// WhatsApp Send - Paper plane (send message)
+const WHATSAPP_SEND_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M2.01 21L23 12 2.01 3 2 10l15 2-15 2z'/%3E%3C/svg%3E";
+
+// WhatsApp Connect - Official WhatsApp logo (exported for use in skill nodes)
+export const WHATSAPP_CONNECT_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z'/%3E%3C/svg%3E";
+
+// WhatsApp Receive - Notification bell with dot (trigger node)
+const WHATSAPP_RECEIVE_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M12 22c1.1 0 2-.9 2-2h-4c0 1.1.9 2 2 2zm6-6v-5c0-3.07-1.63-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.64 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2zm-2 1H8v-6c0-2.48 1.51-4.5 4-4.5s4 2.02 4 4.5v6z'/%3E%3Ccircle cx='18' cy='6' r='4'/%3E%3C/svg%3E";
+
+// WhatsApp DB - Database icon (query contacts, groups, messages)
+const WHATSAPP_DB_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M12 3C7.58 3 4 4.79 4 7v10c0 2.21 3.58 4 8 4s8-1.79 8-4V7c0-2.21-3.58-4-8-4zm0 2c3.87 0 6 1.5 6 2s-2.13 2-6 2-6-1.5-6-2 2.13-2 6-2zm6 12c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V17zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V13zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2V6.77C7.61 7.55 9.72 8 12 8s4.39-.45 6-1.23V9z'/%3E%3C/svg%3E";
+
+// ============================================================================
+// WHATSAPP NODES
+// ============================================================================
+
+export const whatsappNodes: Record<string, INodeTypeDescription> = {
+  // WhatsApp Send Message Node - Enhanced with full schema support
+  whatsappSend: {
+    displayName: 'WhatsApp Send',
+    name: 'whatsappSend',
+    icon: WHATSAPP_SEND_ICON,
+    group: ['whatsapp', 'tool'],
+    version: 1,
+    subtitle: 'Send WhatsApp Message',
+    description: 'Send text, media, location, or contact messages via WhatsApp',
+    defaults: { name: 'WhatsApp Send', color: '#25D366' },
+    inputs: [{
+      name: 'main',
+      displayName: 'Input',
+      type: 'main' as NodeConnectionType,
+      description: 'Message input'
+    }],
+    outputs: [
+      {
+        name: 'main',
+        displayName: 'Output',
+        type: 'main' as NodeConnectionType,
+        description: 'Message output'
+      },
+      {
+        name: 'tool',
+        displayName: 'Tool',
+        type: 'main' as NodeConnectionType,
+        description: 'Connect to AI Agent tool handle'
+      }
+    ],
+    properties: [
+      // ===== RECIPIENT =====
+      {
+        displayName: 'Send To',
+        name: 'recipient_type',
+        type: 'options',
+        options: [
+          { name: 'Phone Number', value: 'phone' },
+          { name: 'Group', value: 'group' }
+        ],
+        default: 'phone',
+        description: 'Send to individual or group'
+      },
+      {
+        displayName: 'Phone Number',
+        name: 'phone',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '1234567890',
+        description: 'Recipient phone number (without + prefix)',
+        displayOptions: {
+          show: { recipient_type: ['phone'] }
+        }
+      },
+      {
+        displayName: 'Group',
+        name: 'group_id',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '123456789@g.us',
+        description: 'Group JID to send message to (use Load button to select)',
+        displayOptions: {
+          show: { recipient_type: ['group'] }
+        }
+      },
+
+      // ===== MESSAGE TYPE =====
+      {
+        displayName: 'Message Type',
+        name: 'message_type',
+        type: 'options',
+        options: [
+          { name: 'Text', value: 'text' },
+          { name: 'Image', value: 'image' },
+          { name: 'Video', value: 'video' },
+          { name: 'Audio', value: 'audio' },
+          { name: 'Document', value: 'document' },
+          { name: 'Sticker', value: 'sticker' },
+          { name: 'Location', value: 'location' },
+          { name: 'Contact', value: 'contact' }
+        ],
+        default: 'text',
+        description: 'Type of message to send'
+      },
+
+      // ===== TEXT MESSAGE =====
+      {
+        displayName: 'Message',
+        name: 'message',
+        type: 'string',
+        default: '',
+        required: true,
+        typeOptions: { rows: 4 },
+        description: 'Text message content',
+        placeholder: 'Enter your message...',
+        displayOptions: {
+          show: { message_type: ['text'] }
+        }
+      },
+
+      // ===== MEDIA MESSAGES (image, video, audio, document, sticker) =====
+      {
+        displayName: 'Media Source',
+        name: 'media_source',
+        type: 'options',
+        options: [
+          { name: 'Base64 Data', value: 'base64' },
+          { name: 'File Path', value: 'file' },
+          { name: 'URL', value: 'url' }
+        ],
+        default: 'base64',
+        description: 'Source of media data',
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'audio', 'document', 'sticker'] }
+        }
+      },
+      {
+        displayName: 'Media Data (Base64)',
+        name: 'media_data',
+        type: 'string',
+        default: '',
+        required: true,
+        typeOptions: { rows: 3 },
+        description: 'Base64-encoded media data',
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'audio', 'document', 'sticker'], media_source: ['base64'] }
+        }
+      },
+      {
+        displayName: 'File',
+        name: 'file_path',
+        type: 'file',
+        default: '',
+        required: true,
+        placeholder: '/path/to/file.jpg',
+        description: 'Upload a file or enter server path',
+        typeOptions: {
+          accept: '*/*'
+        },
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'audio', 'document', 'sticker'], media_source: ['file'] }
+        }
+      },
+      {
+        displayName: 'Media URL',
+        name: 'media_url',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: 'https://example.com/image.jpg',
+        description: 'URL to download media from',
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'audio', 'document', 'sticker'], media_source: ['url'] }
+        }
+      },
+      {
+        displayName: 'MIME Type',
+        name: 'mime_type',
+        type: 'string',
+        default: '',
+        placeholder: 'image/jpeg, video/mp4, audio/ogg',
+        description: 'MIME type of the media (auto-detected if empty)',
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'audio', 'document', 'sticker'] }
+        }
+      },
+      {
+        displayName: 'Caption',
+        name: 'caption',
+        type: 'string',
+        default: '',
+        typeOptions: { rows: 2 },
+        description: 'Optional caption for media',
+        displayOptions: {
+          show: { message_type: ['image', 'video', 'document'] }
+        }
+      },
+      {
+        displayName: 'Filename',
+        name: 'filename',
+        type: 'string',
+        default: '',
+        placeholder: 'document.pdf',
+        description: 'Filename for document',
+        displayOptions: {
+          show: { message_type: ['document'] }
+        }
+      },
+
+      // ===== LOCATION MESSAGE =====
+      {
+        displayName: 'Latitude',
+        name: 'latitude',
+        type: 'number',
+        default: 0,
+        required: true,
+        description: 'Location latitude',
+        displayOptions: {
+          show: { message_type: ['location'] }
+        }
+      },
+      {
+        displayName: 'Longitude',
+        name: 'longitude',
+        type: 'number',
+        default: 0,
+        required: true,
+        description: 'Location longitude',
+        displayOptions: {
+          show: { message_type: ['location'] }
+        }
+      },
+      {
+        displayName: 'Location Name',
+        name: 'location_name',
+        type: 'string',
+        default: '',
+        placeholder: 'San Francisco',
+        description: 'Display name for location',
+        displayOptions: {
+          show: { message_type: ['location'] }
+        }
+      },
+      {
+        displayName: 'Address',
+        name: 'address',
+        type: 'string',
+        default: '',
+        placeholder: 'California, USA',
+        description: 'Address text',
+        displayOptions: {
+          show: { message_type: ['location'] }
+        }
+      },
+
+      // ===== CONTACT MESSAGE =====
+      {
+        displayName: 'Contact Name',
+        name: 'contact_name',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: 'John Doe',
+        description: 'Display name for contact',
+        displayOptions: {
+          show: { message_type: ['contact'] }
+        }
+      },
+      {
+        displayName: 'Contact vCard',
+        name: 'vcard',
+        type: 'string',
+        default: '',
+        required: true,
+        typeOptions: { rows: 4 },
+        placeholder: 'BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD',
+        description: 'vCard 3.0 format string',
+        displayOptions: {
+          show: { message_type: ['contact'] }
+        }
+      },
+
+      // ===== REPLY (QUOTE) =====
+      {
+        displayName: 'Reply To Message',
+        name: 'is_reply',
+        type: 'boolean',
+        default: false,
+        description: 'Quote an existing message'
+      },
+      {
+        displayName: 'Reply Message ID',
+        name: 'reply_message_id',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: 'ABC123DEF456',
+        description: 'ID of message to reply to',
+        displayOptions: {
+          show: { is_reply: [true] }
+        }
+      },
+      {
+        displayName: 'Reply Sender',
+        name: 'reply_sender',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '1234567890@s.whatsapp.net',
+        description: 'Sender JID of quoted message',
+        displayOptions: {
+          show: { is_reply: [true] }
+        }
+      },
+      {
+        displayName: 'Reply Preview',
+        name: 'reply_content',
+        type: 'string',
+        default: '',
+        placeholder: 'Original message text...',
+        description: 'Text preview of quoted message',
+        displayOptions: {
+          show: { is_reply: [true] }
+        }
+      }
+    ]
+  },
+
+  // WhatsApp Connection/Auth Node
+  whatsappConnect: {
+    displayName: 'WhatsApp Connect',
+    name: 'whatsappConnect',
+    icon: WHATSAPP_CONNECT_ICON,
+    group: ['whatsapp'],
+    version: 1,
+    subtitle: 'WhatsApp Status',
+    description: 'Check WhatsApp connection status (QR code authentication removed - use external WhatsApp service)',
+    defaults: { name: 'WhatsApp Connect', color: '#128C7E' },
+    inputs: [],
+    outputs: [{
+      name: 'main',
+      displayName: 'Output',
+      type: 'main' as NodeConnectionType,
+      description: 'Connection output'
+    }],
+    properties: [
+      {
+        displayName: 'Connection Type',
+        name: 'connectionType',
+        type: 'options',
+        options: [
+          {
+            name: 'Scan QR Code',
+            value: 'qr_code'
+          },
+          {
+            name: 'Use Existing Session',
+            value: 'existing'
+          }
+        ],
+        default: 'qr_code',
+        description: 'How to connect to WhatsApp'
+      },
+      {
+        displayName: 'Session Info',
+        name: 'sessionInfo',
+        type: 'notice',
+        default: 'Session will persist across workflow runs. Re-authentication required approximately every 20 days.'
+      }
+    ]
+  },
+
+  // WhatsApp Receive Message - triggers workflow on incoming messages
+  whatsappReceive: {
+    displayName: 'WhatsApp Receive',
+    name: 'whatsappReceive',
+    icon: WHATSAPP_RECEIVE_ICON,
+    group: ['whatsapp', 'trigger'],
+    version: 1,
+    subtitle: 'On Message Received',
+    description: 'Trigger workflow when WhatsApp message is received. Outputs message data including sender, content, and metadata.',
+    defaults: { name: 'WhatsApp Receive', color: '#075E54' },
+    inputs: [],
+    outputs: [{
+      name: 'main',
+      displayName: 'Message',
+      type: 'main' as NodeConnectionType,
+      description: 'Received message data (message_id, sender, sender_phone, chat_id, message_type, text, timestamp, is_group, is_from_me, group_info.sender_jid, group_info.sender_phone, group_info.sender_name)'
+    }],
+    properties: [
+      // ===== MESSAGE TYPE FILTER =====
+      {
+        displayName: 'Message Type',
+        name: 'messageTypeFilter',
+        type: 'options',
+        options: [
+          { name: 'All Types', value: 'all' },
+          { name: 'Text Only', value: 'text' },
+          { name: 'Image Only', value: 'image' },
+          { name: 'Video Only', value: 'video' },
+          { name: 'Audio Only', value: 'audio' },
+          { name: 'Document Only', value: 'document' },
+          { name: 'Location Only', value: 'location' },
+          { name: 'Contact Only', value: 'contact' }
+        ],
+        default: 'all',
+        description: 'Filter by message content type'
+      },
+
+      // ===== SENDER FILTER =====
+      {
+        displayName: 'Sender Filter',
+        name: 'filter',
+        type: 'options',
+        options: [
+          { name: 'All Messages', value: 'all' },
+          { name: 'From Any Contact (Non-Group)', value: 'any_contact' },
+          { name: 'From Specific Contact', value: 'contact' },
+          { name: 'From Specific Group', value: 'group' },
+          { name: 'Contains Keywords', value: 'keywords' }
+        ],
+        default: 'all',
+        description: 'Filter which messages trigger the workflow'
+      },
+      {
+        displayName: 'Contact Phone',
+        name: 'contactPhone',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+          show: { filter: ['contact'] }
+        },
+        placeholder: '1234567890',
+        description: 'Phone number to filter messages from (without + prefix)'
+      },
+      {
+        displayName: 'Group',
+        name: 'group_id',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+          show: { filter: ['group'] }
+        },
+        placeholder: '123456789@g.us',
+        description: 'Group JID to filter messages from (use Load button to select)'
+      },
+      {
+        displayName: 'Sender Number',
+        name: 'senderNumber',
+        type: 'string',
+        default: '',
+        displayOptions: {
+          show: { filter: ['group'] }
+        },
+        placeholder: '1234567890',
+        description: 'Optional: Filter by sender phone number (use Load button to select from group members)'
+      },
+      {
+        displayName: 'Keywords',
+        name: 'keywords',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+          show: { filter: ['keywords'] }
+        },
+        placeholder: 'help, support, info',
+        description: 'Comma-separated keywords to trigger on (case-insensitive)'
+      },
+
+      // ===== OPTIONS =====
+      {
+        displayName: 'Ignore Own Messages',
+        name: 'ignoreOwnMessages',
+        type: 'boolean',
+        default: true,
+        description: 'Do not trigger on messages sent by this device'
+      },
+      {
+        displayName: 'Forwarded Messages',
+        name: 'forwardedFilter',
+        type: 'options',
+        options: [
+          { name: 'Include All', value: 'all' },
+          { name: 'Only Forwarded', value: 'only_forwarded' },
+          { name: 'Ignore Forwarded', value: 'ignore_forwarded' }
+        ],
+        default: 'all',
+        description: 'Filter messages based on forwarded status'
+      },
+      {
+        displayName: 'Include Media Data',
+        name: 'includeMediaData',
+        type: 'boolean',
+        default: false,
+        description: 'Include base64 media data in output (increases memory usage)'
+      }
+    ],
+    methods: {
+      loadOptions: {
+        async getWhatsAppGroups(): Promise<Array<{name: string, value: string, description?: string}>> {
+          try {
+            const response = await wsRequest('whatsapp_groups') as { success: boolean; groups?: Array<{ jid: string; name: string; participant_count?: number; is_community?: boolean }> };
+
+            if (response.success && response.groups) {
+              // Filter out communities - they don't have regular chat history
+              const regularGroups = response.groups.filter((group) => !group.is_community);
+              if (regularGroups.length === 0) {
+                return [{ name: 'No groups found', value: '', description: 'Only communities found (no chat history)' }];
+              }
+              return regularGroups.map((group) => ({
+                name: group.name || group.jid,
+                value: group.jid,
+                description: group.participant_count ? `${group.participant_count} members` : undefined
+              }));
+            }
+            return [{ name: 'No groups found', value: '', description: 'Connect WhatsApp first' }];
+          } catch (error) {
+            console.error('Error loading WhatsApp groups:', error);
+            return [{ name: 'Error loading groups', value: '', description: 'Check WhatsApp connection' }];
+          }
+        },
+
+        async getGroupMembers(this: { getCurrentNodeParameter: (name: string) => string }): Promise<Array<{name: string, value: string, description?: string}>> {
+          try {
+            const groupId = this.getCurrentNodeParameter('group_id');
+            if (!groupId) {
+              return [{ name: 'Select a group first', value: '', description: 'Choose a group above' }];
+            }
+
+            const response = await wsRequest('whatsapp_group_info', { group_id: groupId }) as {
+              success: boolean;
+              participants?: Array<{ phone: string; name: string; jid: string; is_admin?: boolean }>;
+              name?: string;
+            };
+
+            if (response.success && response.participants && response.participants.length > 0) {
+              // Add "All Members" option first
+              const options: Array<{name: string, value: string, description?: string}> = [
+                { name: 'All Members', value: '', description: 'Receive from anyone in group' }
+              ];
+
+              // Add each participant
+              for (const p of response.participants) {
+                const displayName = p.name || p.phone;
+                const adminLabel = p.is_admin ? ' (Admin)' : '';
+                options.push({
+                  name: `${displayName}${adminLabel}`,
+                  value: p.phone,
+                  description: p.phone
+                });
+              }
+
+              return options;
+            }
+
+            return [{ name: 'No members found', value: '', description: 'Could not load group members' }];
+          } catch (error) {
+            console.error('Error loading group members:', error);
+            return [{ name: 'Error loading members', value: '', description: 'Check WhatsApp connection' }];
+          }
+        }
+      }
+    }
+  },
+
+  // WhatsApp DB Node - Query contacts, groups, messages
+  // Can be used as workflow node OR as AI Agent tool (group includes 'tool')
+  whatsappDb: {
+    displayName: 'WhatsApp DB',
+    name: 'whatsappDb',
+    icon: WHATSAPP_DB_ICON,
+    group: ['whatsapp', 'tool'],
+    version: 1,
+    subtitle: 'Query WhatsApp',
+    description: 'Query WhatsApp database - contacts, groups, messages, contact info',
+    defaults: { name: 'WhatsApp DB', color: '#25D366' },
+    inputs: [{
+      name: 'main',
+      displayName: 'Input',
+      type: 'main' as NodeConnectionType,
+      description: 'Trigger input'
+    }],
+    outputs: [
+      {
+        name: 'main',
+        displayName: 'Output',
+        type: 'main' as NodeConnectionType,
+        description: 'Query result'
+      },
+      {
+        name: 'tool',
+        displayName: 'Tool',
+        type: 'main' as NodeConnectionType,
+        description: 'Connect to AI Agent tool handle'
+      }
+    ],
+    properties: [
+      // ===== OPERATION SELECTOR =====
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        options: [
+          { name: 'Chat History', value: 'chat_history' },
+          { name: 'Search Groups', value: 'search_groups' },
+          { name: 'Get Group Info', value: 'get_group_info' },
+          { name: 'Get Contact Info', value: 'get_contact_info' },
+          { name: 'List Contacts', value: 'list_contacts' },
+          { name: 'Check Contacts', value: 'check_contacts' }
+        ],
+        default: 'chat_history',
+        description: 'Operation to perform'
+      },
+
+      // ===== CHAT HISTORY PARAMETERS =====
+      {
+        displayName: 'Chat Type',
+        name: 'chat_type',
+        type: 'options',
+        options: [
+          { name: 'Individual Chat', value: 'individual' },
+          { name: 'Group Chat', value: 'group' }
+        ],
+        default: 'individual',
+        description: 'Type of chat to retrieve history from',
+        displayOptions: {
+          show: { operation: ['chat_history'] }
+        }
+      },
+      {
+        displayName: 'Phone Number',
+        name: 'phone',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '1234567890',
+        description: 'Phone number of the contact (without + prefix)',
+        displayOptions: {
+          show: { operation: ['chat_history'], chat_type: ['individual'] }
+        }
+      },
+      {
+        displayName: 'Group',
+        name: 'group_id',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '123456789@g.us',
+        description: 'Group JID',
+        displayOptions: {
+          show: { operation: ['chat_history', 'get_group_info'], chat_type: ['group'] }
+        }
+      },
+      {
+        displayName: 'Message Filter',
+        name: 'group_filter',
+        type: 'options',
+        options: [
+          { name: 'All Messages', value: 'all' },
+          { name: 'From Specific Contact', value: 'contact' }
+        ],
+        default: 'all',
+        description: 'Filter messages in group',
+        displayOptions: {
+          show: { operation: ['chat_history'], chat_type: ['group'] }
+        }
+      },
+      {
+        displayName: 'Sender Phone',
+        name: 'sender_phone',
+        type: 'string',
+        default: '',
+        placeholder: '1234567890',
+        description: 'Filter messages from specific group member',
+        displayOptions: {
+          show: { operation: ['chat_history'], chat_type: ['group'], group_filter: ['contact'] }
+        }
+      },
+      {
+        displayName: 'Message Type',
+        name: 'message_filter',
+        type: 'options',
+        options: [
+          { name: 'All Types', value: 'all' },
+          { name: 'Text Only', value: 'text_only' }
+        ],
+        default: 'all',
+        description: 'Filter by message type',
+        displayOptions: {
+          show: { operation: ['chat_history'] }
+        }
+      },
+      {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1, maxValue: 500 },
+        description: 'Maximum number of messages to retrieve (1-500)',
+        displayOptions: {
+          show: { operation: ['chat_history'] }
+        }
+      },
+      {
+        displayName: 'Offset',
+        name: 'offset',
+        type: 'number',
+        default: 0,
+        typeOptions: { minValue: 0 },
+        description: 'Number of messages to skip (for pagination)',
+        displayOptions: {
+          show: { operation: ['chat_history'] }
+        }
+      },
+
+      // ===== SEARCH GROUPS PARAMETERS =====
+      {
+        displayName: 'Search Query',
+        name: 'query',
+        type: 'string',
+        default: '',
+        placeholder: 'Family, Work, etc.',
+        description: 'Search groups by name (leave empty for all groups)',
+        displayOptions: {
+          show: { operation: ['search_groups', 'list_contacts'] }
+        }
+      },
+
+      // ===== GET GROUP INFO PARAMETERS =====
+      {
+        displayName: 'Group',
+        name: 'group_id_for_info',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '123456789@g.us',
+        description: 'Group JID to get info for',
+        displayOptions: {
+          show: { operation: ['get_group_info'] }
+        }
+      },
+
+      // ===== GET CONTACT INFO PARAMETERS =====
+      {
+        displayName: 'Phone Number',
+        name: 'contact_phone',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '1234567890',
+        description: 'Phone number to get contact info for',
+        displayOptions: {
+          show: { operation: ['get_contact_info'] }
+        }
+      },
+
+      // ===== CHECK CONTACTS PARAMETERS =====
+      {
+        displayName: 'Phone Numbers',
+        name: 'phones',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: '1234567890, 0987654321',
+        description: 'Comma-separated phone numbers to check WhatsApp registration',
+        displayOptions: {
+          show: { operation: ['check_contacts'] }
+        }
+      }
+    ],
+    methods: {
+      loadOptions: {
+        async getWhatsAppGroups(): Promise<Array<{name: string, value: string, description?: string}>> {
+          try {
+            const response = await wsRequest('whatsapp_groups') as { success: boolean; groups?: Array<{ jid: string; name: string; participant_count?: number; is_community?: boolean }> };
+
+            if (response.success && response.groups) {
+              const regularGroups = response.groups.filter((group) => !group.is_community);
+              if (regularGroups.length === 0) {
+                return [{ name: 'No groups found', value: '', description: 'Only communities found' }];
+              }
+              return regularGroups.map((group) => ({
+                name: group.name || group.jid,
+                value: group.jid,
+                description: group.participant_count ? `${group.participant_count} members` : undefined
+              }));
+            }
+            return [{ name: 'No groups found', value: '', description: 'Connect WhatsApp first' }];
+          } catch (error) {
+            console.error('Error loading WhatsApp groups:', error);
+            return [{ name: 'Error loading groups', value: '', description: 'Check WhatsApp connection' }];
+          }
+        }
+      }
+    }
+  }
+};
+
+// ============================================================================
+// EXPORTS
+// ============================================================================
+
+export const WHATSAPP_NODE_TYPES = ['whatsappSend', 'whatsappConnect', 'whatsappReceive', 'whatsappDb'];