n8n-nodes-confirm8 0.22.0 → 0.23.0

package/dist/nodes/Confirm8Tool/Confirm8AgentTool.node.d.ts

@@ -5,5 +5,13 @@ export declare class Confirm8AgentTool implements INodeType {
      * Parse natural date queries into filter JSON
      */
     private parseDateQuery;
+    /**
+     * Validate ISO date string yyyy-mm-dd
+     */
+    private isIsoDate;
+    /**
+     * Enforce date filters format when present
+     */
+    private validateDateFilters;
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

package/dist/nodes/Confirm8Tool/Confirm8AgentTool.node.js

@@ -2,41 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Confirm8AgentTool = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-// -----------------------------------------------------------------------------
-// STRICT ALLOWED VALUES (used both for UI + for agent/tool schema guidance)
-// IMPORTANT: Any agent calling this tool MUST use ONLY these exact tokens.
-// -----------------------------------------------------------------------------
-const VALID_RESOURCES = [
-    "user",
-    "client",
-    "item",
-    "itemType",
-    "task",
-    "service",
-    "product",
-    "order",
-    "modality",
-    "ticket",
-    "property",
-];
-const VALID_OPERATIONS = [
-    "getAll",
-    "get",
-    "create",
-    "update",
-    "activate",
-    "deactivate",
-];
-const AGENT_USAGE_NOTE = `
-CRITICAL (Agents):
-- You MUST return ONLY the option *value* token (not the label).
-- Allowed resource values: ${VALID_RESOURCES.join(", ")}
-- Allowed operation values: ${VALID_OPERATIONS.join(", ")}
-Examples:
-- "Ordem de Serviço" / "OS" / "Work Order" => resource="order"
-- To list/search => operation="getAll"
-Anything outside these lists will throw a fatal error.
-`.trim();
 class Confirm8AgentTool {
     constructor() {
         this.description = {
@@ -45,7 +10,15 @@ class Confirm8AgentTool {
             icon: "file:tool.svg",
             group: ["transform"],
             version: 1,
-            description: 'AI tool for Confirm8. IMPORTANT: For "OS/ordem de serviço" use resource="order". For dates use filters with start_date/end_date. Example: {"start_date":{"gte":"2025-11-23"},"end_date":{"lte":"2025-11-25"}}',
+            description: `AI tool for Confirm8 (STRICT).
+
+CRITICAL FOR AGENTS:
+- "resource" MUST be exactly one of: user, client, item, itemType, task, service, product, order, modality, ticket, property
+- "operation" MUST be exactly one of: getAll, get, create, update, activate, deactivate
+- Use ONLY these tokens. Do NOT use labels like "OS", "Ordem de Serviço", "buscar".
+- For OS/ordem de serviço => resource="order"
+- To list/search => operation="getAll"
+- Date filters MUST be ISO yyyy-mm-dd.`,
             defaults: {
                 name: "Confirm8 AI Tool",
             },
@@ -92,55 +65,56 @@ class Confirm8AgentTool {
                     type: "options",
                     options: [
                         {
-                            name: "User",
+                            name: "user",
                             value: "user",
                             description: "Users/Employees/Funcionários",
                         },
                         {
-                            name: "Client",
+                            name: "client",
                             value: "client",
                             description: "Clients/Customers/Clientes",
                         },
-                        { name: "Item", value: "item", description: "Items/Itens" },
+                        { name: "item", value: "item", description: "Items/Itens" },
                         {
-                            name: "Item Type",
+                            name: "itemType",
                             value: "itemType",
                             description: "Item Types/Tipos",
                         },
                         {
-                            name: "Task",
+                            name: "task",
                             value: "task",
                             description: "Tasks/Tarefas/Checklists",
                         },
                         {
-                            name: "Service",
+                            name: "service",
                             value: "service",
                             description: "Services/Serviços",
                         },
                         {
-                            name: "Product",
+                            name: "product",
                             value: "product",
                             description: "Products/Produtos",
                         },
                         {
-                            name: "Order (OS)",
+                            name: "order",
                             value: "order",
                             description: "Work Orders/OS/Ordens de Serviço/WOS",
                         },
                         {
-                            name: "Modality",
+                            name: "modality",
                             value: "modality",
                             description: "Modalities/Modalidades",
                         },
-                        { name: "Ticket", value: "ticket", description: "Tickets/Chamados" },
+                        { name: "ticket", value: "ticket", description: "Tickets/Chamados" },
                         {
-                            name: "Property",
+                            name: "property",
                             value: "property",
                             description: "Properties/Propriedades",
                         },
                     ],
                     default: "user",
-                    description: AGENT_USAGE_NOTE,
+                    description: `CRITICAL (Agents): Resource MUST be EXACTLY one of: user, client, item, itemType, task, service, product, order, modality, ticket, property.
+Use ONLY the value token (example: order), never labels like OS.`,
                 },
                 {
                     displayName: "Operation",
@@ -148,38 +122,39 @@ class Confirm8AgentTool {
                     type: "options",
                     options: [
                         {
-                            name: "Get All (List)",
+                            name: "getAll",
                             value: "getAll",
-                            description: AGENT_USAGE_NOTE,
+                            description: "List/Listar/Buscar todos/Mostrar todos",
                         },
                         {
-                            name: "Get (Single)",
+                            name: "get",
                             value: "get",
-                            description: AGENT_USAGE_NOTE,
+                            description: "Get one/Buscar um/Obter",
                         },
                         {
-                            name: "Create",
+                            name: "create",
                             value: "create",
-                            description: AGENT_USAGE_NOTE,
+                            description: "Create/Criar/Adicionar",
                         },
                         {
-                            name: "Update",
+                            name: "update",
                             value: "update",
-                            description: AGENT_USAGE_NOTE,
+                            description: "Update/Atualizar/Modificar",
                         },
                         {
-                            name: "Activate",
+                            name: "activate",
                             value: "activate",
-                            description: AGENT_USAGE_NOTE,
+                            description: "Activate/Ativar",
                         },
                         {
-                            name: "Deactivate",
+                            name: "deactivate",
                             value: "deactivate",
-                            description: AGENT_USAGE_NOTE,
+                            description: "Deactivate/Desativar",
                         },
                     ],
                     default: "getAll",
-                    description: AGENT_USAGE_NOTE,
+                    description: `CRITICAL (Agents): Operation MUST be EXACTLY one of: getAll, get, create, update, activate, deactivate.
+Use ONLY the value token (example: getAll), never labels like buscar.`,
                 },
                 {
                     displayName: "Record ID",
@@ -200,7 +175,10 @@ class Confirm8AgentTool {
                     name: "filters",
                     type: "string",
                     default: "",
-                    description: 'Filters as JSON. For dates: {"start_date":{"gte":"YYYY-MM-DD"},"end_date":{"lte":"YYYY-MM-DD"}}. For status: {"status":{"eq":"complete"}}',
+                    description: `Filters as JSON ONLY.
+Dates MUST be ISO yyyy-mm-dd.
+Example (this week): {"start_date":{"gte":"2025-06-16"},"end_date":{"lte":"2025-06-22"}}
+Do NOT send expressions like "data >= start_of_week".`,
                 },
             ],
         };
@@ -273,6 +251,36 @@ class Confirm8AgentTool {
         }
         return null;
     }
+    /**
+     * Validate ISO date string yyyy-mm-dd
+     */
+    isIsoDate(value) {
+        if (typeof value !== "string")
+            return false;
+        return /^\d{4}-\d{2}-\d{2}$/.test(value);
+    }
+    /**
+     * Enforce date filters format when present
+     */
+    validateDateFilters(filters) {
+        const dateFields = ["start_date", "end_date", "date", "data"];
+        for (const field of dateFields) {
+            if (!filters[field])
+                continue;
+            const ops = filters[field];
+            if (!ops || typeof ops !== "object")
+                continue;
+            for (const op of Object.keys(ops)) {
+                const v = ops[op];
+                if (v == null)
+                    continue;
+                if (!this.isIsoDate(v)) {
+                    throw new Error(`Invalid date format in filters["${field}"]["${op}"]="${String(v)}". ` +
+                        `Dates MUST be yyyy-mm-dd (ISO), e.g. "2025-06-16".`);
+                }
+            }
+        }
+    }
     async execute() {
         const items = this.getInputData();
         const returnData = [];
@@ -311,6 +319,8 @@ class Confirm8AgentTool {
                             filters = parsedDate;
                         }
                     }
+                    // Enforce ISO date filters when present
+                    this.validateDateFilters(filters);
                 }
                 // Aggressive normalization - EXPAND THIS
                 const resourceMap = {
@@ -404,7 +414,7 @@ class Confirm8AgentTool {
                     disable: "deactivate",
                     desabilitar: "deactivate",
                 };
-                // Normalize - clean and map
+                // Normalize - clean and map (remove accents/punctuation)
                 const normalizeKey = (value) => value
                     .toLowerCase()
                     .normalize("NFD")
@@ -417,8 +427,27 @@ class Confirm8AgentTool {
                 resource = resourceMap[cleanResource] || resource;
                 operation = operationMap[cleanOperation] || operation;
                 // If still not valid, throw clear error
-                const validResources = VALID_RESOURCES;
-                const validOperations = VALID_OPERATIONS;
+                const validResources = [
+                    "user",
+                    "client",
+                    "item",
+                    "itemType",
+                    "task",
+                    "service",
+                    "product",
+                    "order",
+                    "modality",
+                    "ticket",
+                    "property",
+                ];
+                const validOperations = [
+                    "getAll",
+                    "get",
+                    "create",
+                    "update",
+                    "activate",
+                    "deactivate",
+                ];
                 if (!validResources.includes(resource)) {
                     throw new Error(`Invalid resource: "${resource}". Must be one of: ${validResources.join(", ")}. ` + `For OS/Ordem de Serviço use "order".`);
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-confirm8",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Simple n8n node for Confirm8 API - no credentials needed",
   "license": "MIT",
   "author": "Bill Hebert",