n8n-nodes-evolution-message-search 2.0.3 → 2.0.5

package/dist/nodes/SearchMessages/SearchMessages.node.js

@@ -5,6 +5,40 @@ exports.SearchMessages = void 0;
 
 const n8n_workflow_1 = require('n8n-workflow');
 
+function parseDate(input) {
+	if (!input) return null;
+	if (typeof input === 'number') {
+		return input > 1e12 ? Math.floor(input / 1000) : input;
+	}
+	if (typeof input !== 'string') return null;
+
+	const str = input.trim();
+
+	if (/^\d{4}-\d{2}-\d{2}/.test(str)) {
+		const d = new Date(str);
+		if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+	}
+
+	if (/^\d{2}\/\d{2}\/\d{4}/.test(str)) {
+		const parts = str.split('/');
+		const iso = `${parts[2]}-${parts[1]}-${parts[0]}T00:00:00Z`;
+		const d = new Date(iso);
+		if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+	}
+
+	if (/^\d{2}-\d{2}-\d{4}/.test(str)) {
+		const parts = str.split('-');
+		const iso = `${parts[2]}-${parts[1]}-${parts[0]}T00:00:00Z`;
+		const d = new Date(iso);
+		if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+	}
+
+	const d = new Date(str);
+	if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+
+	return null;
+}
+
 async function performSearch(ctx, itemIndex) {
 	const credentials = await ctx.getCredentials('evolutionApi');
 	const serverUrl = credentials['server-url'];
@@ -27,13 +61,15 @@ async function performSearch(ctx, itemIndex) {
 	if (keywords) {
 		whereClause['message.conversationMessage.text'] = { contains: keywords };
 	}
-	if (dateFrom || dateTo) {
-		whereClause['timestamp'] = {};
-		if (dateFrom) {
-			whereClause['timestamp']['gte'] = new Date(dateFrom).getTime() / 1000;
-		}
-		if (dateTo) {
-			whereClause['timestamp']['lte'] = new Date(dateTo).getTime() / 1000;
+
+	const tsFrom = parseDate(dateFrom);
+	const tsTo = parseDate(dateTo);
+
+	if (tsFrom !== null || tsTo !== null) {
+		whereClause.timestamp = {};
+		if (tsFrom !== null) whereClause.timestamp.gte = tsFrom;
+		if (tsTo !== null) {
+			whereClause.timestamp.lte = tsTo + 86399;
 		}
 	}
 
@@ -93,6 +129,16 @@ class SearchMessages {
 				},
 			],
 			properties: [
+				{
+					displayName: 'Tool Description',
+					name: 'toolDescription',
+					type: 'string',
+					typeOptions: {
+						rows: 4,
+					},
+					default: 'Search the WhatsApp message history of a conversation. ALL parameters are OPTIONAL except when explicitly needed:\n\n- Use ONLY keywords when user wants to find specific words/topics\n- Use ONLY dateFrom/dateTo when user asks about a time period (e.g. "last month", "yesterday")\n- Use BOTH keywords AND dates to combine topic search with time period\n- Use NONE when user wants recent messages (uses page 1)\n\nDATE FORMAT (IMPORTANT): Always use ISO 8601 format: "YYYY-MM-DD" or "YYYY-MM-DDTHH:MM:SSZ"\n- "01/08/2026" → use "2026-08-01"\n- "last month" → use "2026-08-01" to "2026-08-31"\n- "yesterday" → use yesterday in YYYY-MM-DD format\n\nExamples:\n- "Did we talk about payment?" → use keywords="payment"\n- "What did we discuss last month?" → use dateFrom="2026-08-01" dateTo="2026-08-31"\n- "Anything about refund in January?" → use keywords="refund" + dateFrom/dateTo\n\nNavigation:\n- page: increase to see older messages (model can change)\n- pageSize: number of results per page (user-defined, do not change)',
+					description: 'Custom description shown to AI agent to help it understand how to use this tool',
+				},
 				{
 					displayName: 'Instance Name',
 					name: 'instanceName',
@@ -107,7 +153,7 @@ class SearchMessages {
 					type: 'string',
 					required: false,
 					default: '',
-					description: 'WhatsApp conversation ID (JID). If empty, searches all conversations.',
+					description: 'WhatsApp conversation ID (JID). Leave empty to search all conversations.',
 					placeholder: '5511999999999@s.whatsapp.net',
 				},
 				{
@@ -123,7 +169,8 @@ class SearchMessages {
 					type: 'string',
 					required: false,
 					default: '',
-					description: 'Search text in message content (model can set)',
+					description: 'OPTIONAL: Search text in message content. Leave empty to search by date only.',
+					placeholder: '={{ $fromAI("Keywords", "", "string") }}',
 				},
 				{
 					displayName: 'Date From',
@@ -131,8 +178,8 @@ class SearchMessages {
 					type: 'string',
 					required: false,
 					default: '',
-					description: 'Start date for message search (model can set)',
-					placeholder: '2024-01-01T00:00:00Z',
+					description: 'OPTIONAL: Start date in ISO format YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ. Use when user mentions a time period.',
+					placeholder: '={{ $fromAI("Date_From_ISO", "", "string") }}',
 				},
 				{
 					displayName: 'Date To',
@@ -140,8 +187,8 @@ class SearchMessages {
 					type: 'string',
 					required: false,
 					default: '',
-					description: 'End date for message search (model can set)',
-					placeholder: '2024-12-31T23:59:59Z',
+					description: 'OPTIONAL: End date in ISO format YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ. Use when user mentions a time period.',
+					placeholder: '={{ $fromAI("Date_To_ISO", "", "string") }}',
 				},
 				{
 					displayName: 'Items per Page',
@@ -162,7 +209,8 @@ class SearchMessages {
 					typeOptions: {
 						minValue: 1,
 					},
-					description: 'Page number to retrieve (model can navigate)',
+					description: 'Page to retrieve (model can navigate: increase to see older messages)',
+					placeholder: '={{ $fromAI("Page_Number", "1", "number") }}',
 				},
 			],
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-evolution-message-search",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Evolution API - Search Messages node for n8n. Search WhatsApp message history by keywords, dates, and conversation.",
   "keywords": [
     "n8n-community-node-package",