n8n-nodes-evolution-message-search 2.0.2 → 2.0.4

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

@@ -5,6 +5,71 @@ exports.SearchMessages = void 0;
 
 const n8n_workflow_1 = require('n8n-workflow');
 
+async function performSearch(ctx, itemIndex) {
+	const credentials = await ctx.getCredentials('evolutionApi');
+	const serverUrl = credentials['server-url'];
+	const apiKey = credentials.apikey;
+
+	const instanceName = ctx.getNodeParameter('instanceName', itemIndex);
+	const userConversationId = ctx.getNodeParameter('conversationId', itemIndex) || '';
+	const keywords = ctx.getNodeParameter('keywords', itemIndex) || '';
+	const dateFrom = ctx.getNodeParameter('dateFrom', itemIndex) || '';
+	const dateTo = ctx.getNodeParameter('dateTo', itemIndex) || '';
+	const pageSize = ctx.getNodeParameter('pageSize', itemIndex) || 10;
+	const page = ctx.getNodeParameter('page', itemIndex) || 1;
+
+	const skip = (page - 1) * pageSize;
+
+	const whereClause = {};
+	if (userConversationId) {
+		whereClause['key.remote'] = userConversationId;
+	}
+	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 body = {
+		where: whereClause,
+		take: pageSize,
+		skip: skip,
+		orderBy: { timestamp: 'desc' },
+	};
+
+	const cleanUrl = serverUrl.replace(/\/$/, '');
+	const response = await ctx.helpers.request({
+		method: 'POST',
+		uri: `${cleanUrl}/chat/findMessages/${instanceName}`,
+		body,
+		headers: {
+			'Content-Type': 'application/json',
+			Accept: 'application/json',
+			apikey: apiKey,
+		},
+		json: true,
+	});
+
+	const messages = response.messages || response;
+	const total = messages.total || messages.length || 0;
+	const totalPages = Math.ceil(total / pageSize);
+
+	return {
+		total,
+		pages: totalPages,
+		currentPage: page,
+		pageSize,
+		records: Array.isArray(messages.records) ? messages.records : messages,
+	};
+}
+
 class SearchMessages {
 	constructor() {
 		this.description = {
@@ -28,6 +93,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\nExamples:\n- "Did we talk about payment?" → use keywords="payment"\n- "What did we discuss last month?" → use dateFrom and dateTo only\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',
@@ -42,7 +117,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',
 				},
 				{
@@ -58,7 +133,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',
@@ -66,8 +142,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 (ISO format). Use when user mentions a time period. Leave empty to search all time.',
+					placeholder: '={{ $fromAI("Date_From", "", "string") }}',
 				},
 				{
 					displayName: 'Date To',
@@ -75,8 +151,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 (ISO format). Use when user mentions a time period. Leave empty to search all time.',
+					placeholder: '={{ $fromAI("Date_To", "", "string") }}',
 				},
 				{
 					displayName: 'Items per Page',
@@ -97,102 +173,35 @@ 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") }}',
 				},
 			],
 		};
 	}
 
 	async execute() {
-		const items = this.getInputData ? this.getInputData() : [];
+		const items = typeof this.getInputData === 'function' ? this.getInputData() : [];
 		const returnData = [];
+		const max = items.length > 0 ? items.length : 1;
 
-		for (let itemIndex = 0; itemIndex < (items.length || 1); itemIndex++) {
+		for (let itemIndex = 0; itemIndex < max; itemIndex++) {
 			try {
-				const result = await this.executeSingle.call(this, itemIndex);
+				const result = await performSearch(this, itemIndex);
 				returnData.push({
 					json: result,
 					pairedItem: { item: itemIndex },
 				});
 			} catch (err) {
-				if (this.continueOnFail && this.continueOnFail()) {
-					returnData.push({
-						json: { error: err.message },
-						pairedItem: { item: itemIndex },
-					});
-				} else {
-					throw err;
-				}
+				returnData.push({
+					json: { error: err.message },
+					pairedItem: { item: itemIndex },
+				});
 			}
 		}
 
 		return [returnData];
 	}
-
-	async executeSingle(itemIndex) {
-		const credentials = await this.getCredentials('evolutionApi');
-		const serverUrl = credentials['server-url'];
-		const apiKey = credentials.apikey;
-
-		const instanceName = this.getNodeParameter('instanceName', itemIndex);
-		const userConversationId = this.getNodeParameter('conversationId', itemIndex) || '';
-		const keywords = this.getNodeParameter('keywords', itemIndex) || '';
-		const dateFrom = this.getNodeParameter('dateFrom', itemIndex) || '';
-		const dateTo = this.getNodeParameter('dateTo', itemIndex) || '';
-		const pageSize = this.getNodeParameter('pageSize', itemIndex) || 10;
-		const page = this.getNodeParameter('page', itemIndex) || 1;
-
-		const skip = (page - 1) * pageSize;
-
-		const whereClause = {};
-		if (userConversationId) {
-			whereClause['key.remote'] = userConversationId;
-		}
-		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 body = {
-			where: whereClause,
-			take: pageSize,
-			skip: skip,
-			orderBy: { timestamp: 'desc' },
-		};
-
-		const cleanUrl = serverUrl.replace(/\/$/, '');
-		const response = await this.helpers.request({
-			method: 'POST',
-			uri: `${cleanUrl}/chat/findMessages/${instanceName}`,
-			body,
-			headers: {
-				'Content-Type': 'application/json',
-				Accept: 'application/json',
-				apikey: apiKey,
-			},
-			json: true,
-		});
-
-		const messages = response.messages || response;
-		const total = messages.total || messages.length || 0;
-		const totalPages = Math.ceil(total / pageSize);
-
-		return {
-			total,
-			pages: totalPages,
-			currentPage: page,
-			pageSize,
-			records: Array.isArray(messages.records) ? messages.records : messages,
-		};
-	}
 }
 
 exports.SearchMessages = SearchMessages;

package/package.json

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