machinaos 0.0.1 → 0.0.7

package/client/src/nodeDefinitions/whatsappNodes.ts

@@ -1,865 +1,821 @@
-// 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'];
+// 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 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', 'whatsappReceive', 'whatsappDb'];