n8n-nodes-tembory 1.0.14 → 1.0.16

package/README.md

@@ -2,7 +2,22 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.0.14`.
+Versao atual: `1.0.16`.
+
+## 1.0.16
+
+- Corrige compatibilidade da UI agrupada com o processamento de parametros do n8n.
+- Mantem `Configuração Tembory` como `fixedCollection`, mas remove o default estrutural pre-preenchido que podia quebrar a renderizacao do editor em alguns runtimes.
+- Preserva os defaults de producao no runtime via `productionBalanced`, mesmo quando os grupos da UI ainda nao foram adicionados manualmente.
+- Adiciona validacao local com `NodeHelpers.getNodeParameters` do `n8n-workflow` para evitar regressao de tela em branco.
+
+## 1.0.15
+
+- Reorganiza a interface do node em `Configuração Tembory`, com grupos para Essenciais, Mais Inteligência, Controles Avançados de Busca, Resumo e Estado Persistente, e Diagnóstico e Auditoria.
+- Mantém a coleção legada `Avançado` para compatibilidade com workflows já existentes.
+- Define `Produção Balanceada` como preset padrão para novas configurações.
+- Prioriza IDs estáveis de thread/conversa/contato/cliente antes de `sessionId` na expressão padrão do `ID da Thread`.
+- Adiciona teste para validar a mesclagem dos grupos da nova UI com os presets operacionais.
 
 ## 1.0.14
 

package/dist/nodes/Mem0/Mem0Memory.node.js

@@ -883,7 +883,7 @@ const userKeyFrom = (threadId, adv, project = '') => {
     return namespace ? `${namespace}::${base}` : base;
 };
 const applyOperationalPreset = (advanced = {}) => {
-    const preset = String(advanced.operationPreset || 'custom');
+    const preset = String(advanced.operationPreset || 'productionBalanced');
     const presets = {
         diagnostic: {
             summarySource: 'auto',
@@ -1053,6 +1053,30 @@ const applyOperationalPreset = (advanced = {}) => {
     };
     return { ...(presets[preset === 'lab' ? 'diagnostic' : preset] || {}), ...advanced };
 };
+const flattenAdvancedGroups = (groups = {}) => {
+    const flattened = {};
+    const groupNames = ['essentials', 'intelligence', 'retrievalControls', 'summaryState', 'diagnosticsAudit'];
+    for (const groupName of groupNames) {
+        const value = groups === null || groups === void 0 ? void 0 : groups[groupName];
+        const groupValue = Array.isArray(value) ? value[0] : value;
+        if (groupValue && typeof groupValue === 'object')
+            Object.assign(flattened, groupValue);
+    }
+    return flattened;
+};
+const readAdvancedOptions = (ctx, itemIndex) => {
+    let legacy = {};
+    let grouped = {};
+    try {
+        legacy = ctx.getNodeParameter('advanced', itemIndex, {}) || {};
+    }
+    catch { }
+    try {
+        grouped = flattenAdvancedGroups(ctx.getNodeParameter('advancedGroups', itemIndex, {}) || {});
+    }
+    catch { }
+    return { ...legacy, ...grouped };
+};
 const pruneByLimit = (items, limit) => items.slice(Math.max(0, items.length - Math.max(1, Number(limit) || 1)));
 const dedupeRecentMessages = (items) => {
     const seen = new Set();
@@ -2058,7 +2082,7 @@ class Mem0Memory {
                     displayName: 'ID da Thread',
                     name: 'threadId',
                     type: 'string',
-                    default: '={{ $json.threadId || $json.sessionId || $json.body?.messages?.[0]?.contactId || $json.body?.contactId || $json.contactId || $json.from || $json.sender || $executionId }}',
+                    default: '={{ $json.threadId || $json.body?.threadId || $json.body?.conversationId || $json.conversationId || $json.body?.messages?.[0]?.contactId || $json.body?.contactId || $json.contactId || $json.customerId || $json.body?.customerId || $json.from || $json.sender || $json.sessionId || $executionId }}',
                     description: 'Identificador estável desta conversa/thread. Usado como user_id se nenhum User ID explícito for informado.',
                 },
                 {
@@ -2115,11 +2139,129 @@ class Mem0Memory {
                     description: 'Como o contexto recuperado será entregue ao agente antes da LLM.',
                 },
                 {
-                    displayName: 'Avançado',
+                    displayName: 'Configuração Tembory',
+                    name: 'advancedGroups',
+                    type: 'fixedCollection',
+                    placeholder: 'Adicionar Grupo',
+                    default: '',
+                    typeOptions: {
+                        multipleValues: false,
+                    },
+                    description: 'Grupos recomendados para producao. Todos os recursos continuam disponiveis, mas separados por finalidade.',
+                    options: [
+                        {
+                            name: 'essentials',
+                            displayName: 'Essenciais',
+                            values: [
+                                {
+                                    displayName: 'Preset Operacional',
+                                    name: 'operationPreset',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Custom', value: 'custom' },
+                                        { name: 'Diagnóstico Completo', value: 'diagnostic' },
+                                        { name: 'Produção Balanceada', value: 'productionBalanced' },
+                                        { name: 'Produção Econômica', value: 'productionCheap' },
+                                        { name: 'Produção Nano/SLM', value: 'productionNano' },
+                                        { name: 'Auditoria', value: 'audit' },
+                                    ],
+                                    default: 'productionBalanced',
+                                    description: 'Preenche defaults seguros para contexto, historico de tools e memoria ativa.',
+                                },
+                                { displayName: 'Incluir Cabeçalho de Contexto', name: 'includeContextHeader', type: 'boolean', default: true },
+                                { displayName: 'Organizar Seções de Produção', name: 'compactStateSections', type: 'boolean', default: true },
+                                { displayName: 'Máximo de Caracteres do Contexto', name: 'contextMaxChars', type: 'number', default: 10000 },
+                                { displayName: 'Incluir Tool History', name: 'includeToolHistory', type: 'boolean', default: true },
+                                { displayName: 'Incluir Resultado Das Tools', name: 'includeToolResults', type: 'boolean', default: true },
+                                { displayName: 'Incluir Working Memory', name: 'includeWorkingMemory', type: 'boolean', default: true },
+                                { displayName: 'Incluir Decision State', name: 'includeDecisionState', type: 'boolean', default: true },
+                                { displayName: 'Incluir Estado Operacional', name: 'includeOperationalState', type: 'boolean', default: true },
+                                { displayName: 'Incluir Compressão de Memória', name: 'includeMemoryCompression', type: 'boolean', default: true },
+                            ],
+                        },
+                        {
+                            name: 'intelligence',
+                            displayName: 'Mais Inteligência',
+                            values: [
+                                { displayName: 'Incluir Profile Facts', name: 'includeProfileFacts', type: 'boolean', default: true },
+                                { displayName: 'Incluir Mensagens Recentes', name: 'includeRecentMessages', type: 'boolean', default: true },
+                                { displayName: 'Últimas N Mensagens', name: 'recentMessagesLastN', type: 'number', default: 6 },
+                                { displayName: 'Incluir Highlights Recentes', name: 'includeRecentHighlights', type: 'boolean', default: true },
+                                { displayName: 'Máximo de Highlights', name: 'recentHighlightsMaxItems', type: 'number', default: 6 },
+                                { displayName: 'Incluir Grafo', name: 'includeRelations', type: 'boolean', default: true },
+                                { displayName: 'Máximo de Relações', name: 'maxRelations', type: 'number', default: 10 },
+                                { displayName: 'Incluir Action Ledger', name: 'includeActionLedger', type: 'boolean', default: true },
+                                { displayName: 'Incluir Entity Timeline', name: 'includeEntityTimeline', type: 'boolean', default: true },
+                            ],
+                        },
+                        {
+                            name: 'retrievalControls',
+                            displayName: 'Controles Avançados de Busca',
+                            values: [
+                                { displayName: 'Top K', name: 'topK', type: 'number', typeOptions: { minValue: 1 }, default: 6 },
+                                { displayName: 'Rerank', name: 'rerank', type: 'boolean', default: true },
+                                { displayName: 'Fields (lista separada por vírgula)', name: 'fields', type: 'string', default: '' },
+                                { displayName: 'Filters (JSON)', name: 'filters', type: 'json', default: '{}' },
+                                { displayName: 'Last N (recentes)', name: 'lastN', type: 'number', default: 8 },
+                                { displayName: 'Alpha (peso semântico)', name: 'alpha', type: 'number', typeOptions: { minValue: 0, maxValue: 1, numberPrecision: 2 }, default: 0.65 },
+                                { displayName: 'Half-life (horas)', name: 'halfLifeHours', type: 'number', typeOptions: { minValue: 1 }, default: 48 },
+                                { displayName: 'Máximo a retornar', name: 'maxReturn', type: 'number', typeOptions: { minValue: 1 }, default: 12 },
+                                { displayName: 'MMR (diversidade)', name: 'mmr', type: 'boolean', default: true },
+                                { displayName: 'MMR Lambda', name: 'mmrLambda', type: 'number', typeOptions: { minValue: 0, maxValue: 1, numberPrecision: 2 }, default: 0.5 },
+                                { displayName: 'Compactar Contexto Para Agente', name: 'compactForAgent', type: 'boolean', default: false },
+                            ],
+                        },
+                        {
+                            name: 'summaryState',
+                            displayName: 'Resumo e Estado Persistente',
+                            values: [
+                                { displayName: 'Incluir Resumo', name: 'includeSummary', type: 'boolean', default: true },
+                                { displayName: 'Incluir Resumo do SLM', name: 'includeConnectedModelSummary', type: 'boolean', default: true },
+                                {
+                                    displayName: 'Fonte do Resumo do SLM',
+                                    name: 'summarySource',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Automático', value: 'auto' },
+                                        { name: 'Contexto Ativo', value: 'activeContext' },
+                                        { name: 'Somente Vetores', value: 'vectorOnly' },
+                                        { name: 'Desligado', value: 'off' },
+                                    ],
+                                    default: 'auto',
+                                },
+                                { displayName: 'Máximo de Caracteres de Entrada do SLM', name: 'connectedModelSummaryInputMaxChars', type: 'number', default: 4200 },
+                                { displayName: 'Máximo de Caracteres do Resumo do SLM', name: 'connectedModelSummaryMaxChars', type: 'number', default: 1200 },
+                                { displayName: 'Incluir Active Summary', name: 'includeActiveSummary', type: 'boolean', default: true },
+                                { displayName: 'Persistir Active Summary', name: 'persistActiveSummary', type: 'boolean', default: true },
+                                { displayName: 'Máximo de Caracteres do Active Summary', name: 'activeSummaryMaxChars', type: 'number', default: 1800 },
+                                { displayName: 'Retenção do Active Summary (Dias)', name: 'activeSummaryRetentionDays', type: 'number', default: 30 },
+                                { displayName: 'Ativar Cache Técnico do Resumo SLM', name: 'enableTransientSummaryCache', type: 'boolean', default: true },
+                                { displayName: 'TTL do Cache Técnico SLM (Segundos)', name: 'transientSummaryCacheTTLSeconds', type: 'number', default: 300 },
+                                { displayName: 'Máximo de Itens no Cache Técnico SLM', name: 'transientSummaryCacheMaxItems', type: 'number', default: 50 },
+                                { displayName: 'Máximo de Fatos no Resumo', name: 'summaryMaxFacts', type: 'number', default: 4 },
+                            ],
+                        },
+                        {
+                            name: 'diagnosticsAudit',
+                            displayName: 'Diagnóstico e Auditoria',
+                            values: [
+                                { displayName: 'Incluir Scores', name: 'includeScores', type: 'boolean', default: false },
+                                { displayName: 'Incluir Diagnóstico', name: 'includeDiagnostics', type: 'boolean', default: false },
+                                { displayName: 'Últimas N Tools', name: 'toolHistoryLastN', type: 'number', default: 10 },
+                                { displayName: 'TTL Das Tools (Segundos)', name: 'toolHistoryTTLSeconds', type: 'number', default: 3600 },
+                                { displayName: 'Persistir Tool Facts no Backend', name: 'persistToolFactsToMem0', type: 'boolean', default: false },
+                                { displayName: 'Fallback Semântico Para Tools', name: 'includeToolHistorySemanticFallback', type: 'boolean', default: false },
+                            ],
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Avançado Legado (Compatibilidade)',
                     name: 'advanced',
                     type: 'collection',
                     placeholder: 'Opções',
                     default: {},
+                    description: 'Campos legados preservados para workflows existentes. Para novas configuracoes, use Configuração Tembory.',
                     options: [
                         { displayName: 'User ID', name: 'userId', type: 'string', default: '' },
                         {
@@ -2134,7 +2276,7 @@ class Mem0Memory {
                                 { name: 'Produção Nano/SLM', value: 'productionNano' },
                                 { name: 'Auditoria', value: 'audit' },
                             ],
-                            default: 'custom',
+                            default: 'productionBalanced',
                             description: 'Preenche defaults seguros para contexto, diagnostico, historico de tools e mensagens recentes. Valores definidos manualmente continuam tendo prioridade.',
                         },
                         { displayName: 'Agent ID', name: 'agentId', type: 'string', default: '' },
@@ -2332,7 +2474,7 @@ class Mem0Memory {
     async saveContextForItem(itemIndex, inputValues = {}, outputValues = {}) {
         const threadId = this.getNodeParameter('threadId', itemIndex);
         const project = this.getNodeParameter('project', itemIndex, '');
-        const adv = applyOperationalPreset(this.getNodeParameter('advanced', itemIndex, {}) || {});
+        const adv = applyOperationalPreset(readAdvancedOptions(this, itemIndex));
         const store = getMemoryStore(this);
         const key = userKeyFrom(threadId, adv, project);
         const input = pickText(inputValues, ['input', 'chatInput', 'text', 'query', 'question']);
@@ -2536,7 +2678,7 @@ class Mem0Memory {
         let payloadFormat = this.getNodeParameter('payloadFormat', itemIndex, 'structured');
         const threadId = this.getNodeParameter('threadId', itemIndex);
         const project = this.getNodeParameter('project', itemIndex, '');
-        const adv = applyOperationalPreset(this.getNodeParameter('advanced', itemIndex, {}) || {});
+        const adv = applyOperationalPreset(readAdvancedOptions(this, itemIndex));
         payloadFormat = adv.payloadFormat || payloadFormat;
         const store = getMemoryStore(this);
         const key = userKeyFrom(threadId, adv, project);
@@ -3080,7 +3222,7 @@ class Mem0Memory {
             const retrievalMode = this.getNodeParameter('retrievalMode', i);
             const threadId = this.getNodeParameter('threadId', i);
             const project = this.getNodeParameter('project', i, '');
-            const adv = applyOperationalPreset(this.getNodeParameter('advanced', i, {}) || {});
+            const adv = applyOperationalPreset(readAdvancedOptions(this, i));
             const key = userKeyFrom(threadId, adv, project);
             const query = asSearchQuery(this.getNodeParameter('query', i, ''));
             const connectedEmbedding = await getConnectedEmbedding(this, i);
@@ -3162,6 +3304,7 @@ exports.__private = {
     encodeRecentMessage,
     userKeyFrom,
     applyOperationalPreset,
+    flattenAdvancedGroups,
     asSearchQuery,
     canonicalToolInput,
     buildContextMessages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-tembory",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Tembory node for n8n AI Agents with profile, tools, timeline, graph and semantic memory",
   "license": "MIT",
   "homepage": "https://tembory.com",