n8n-nodes-tembory 1.3.5 → 1.3.7

package/README.md

@@ -2,7 +2,15 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.3.5`.
+Versao atual: `1.3.6`.
+
+## 1.3.6
+
+- Fortalece o default recomendado para agentes mini/SLM em workflows reais.
+- `Memoria Inteligente (Recomendado)` agora usa `productionBalanced` com contexto de 20000 caracteres, entrada do SLM em 12000 caracteres, resumo SLM em 3000 caracteres e active summary em 3500 caracteres.
+- Mantem 30 tools recentes no contexto operacional e TTL de tool history em 86400 segundos.
+- Alinha os defaults visiveis em `Ajustes Tecnicos` para nao mostrar configuracao mais fraca quando o usuario abre os grupos.
+- Esclarece que o cache tecnico SLM usa segundos; 300 segundos equivalem a 5 minutos.
 
 ## 1.3.5
 
@@ -220,13 +228,18 @@ No modo simples, o node aplica automaticamente:
 
 - `Modo de Recuperacao`: operacional estruturado.
 - `Formato do Contexto`: producao estruturado.
-- `Preset Operacional`: producao rapida.
-- `Fonte do Resumo do SLM`: contexto ativo.
+- `Preset Operacional`: producao balanceada.
+- `Fonte do Resumo do SLM`: automatica.
+- `Maximo de Caracteres do Contexto`: 20000.
+- `Maximo de Caracteres de Entrada do SLM`: 12000.
+- `Maximo de Caracteres do Resumo do SLM`: 3000.
+- `Maximo de Caracteres do Active Summary`: 3500.
 - Tool history, resultados de tools, action ledger, working memory, decision state, operational state e memory compression ligados.
 - Persistencia no backend e active summary ligados.
 - Diagnostico pesado, scores, semantic fallback e tool facts desligados.
-- TTL de tool history em 36000 segundos.
-- Ultimas tools mantidas no contexto compacto: 50.
+- Cache tecnico do SLM em 300 segundos.
+- TTL de tool history em 86400 segundos.
+- Ultimas tools mantidas no contexto compacto: 30.
 
 ## Uso com `$fromAI()`
 
@@ -234,6 +247,27 @@ Em tools conectadas ao AI Agent, o n8n permite que o modelo preencha parametros
 
 Referencia oficial do n8n: https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/
 
+## Prompt recomendado para AI Agent
+
+O Tembory entrega memoria operacional, mas o Agent ainda precisa de politica clara para decidir quando usar memoria e quando chamar tool. Em workflows com muitas tools, adicione um bloco como este no `System Message` do AI Agent:
+
+```text
+Antes de chamar uma ferramenta, consulte a memoria Tembory: tool_state, tool_history, action_ledger, decision_state, operational_state, active_summary e conversation_frame.
+Use a memoria para evitar repeticao, mas nao substitua verificacao operacional nova por inferencia.
+Se o usuario pedir para verificar, validar, consultar, checar, confirmar status, criar, atualizar, registrar ou acionar algo que ainda nao esteja confirmado por uma tool recente no tool_history, chame a tool correta.
+Nao repita uma tool se a memoria ja trouxer evidencia suficiente para a pergunta atual.
+Nunca declare uma acao como confirmada, criada, atualizada, enviada ou reservada sem uma tool de side effect bem-sucedida no turno atual.
+Se uma tool retornar dado incoerente com a pergunta, aponte a inconsistencia em vez de inventar.
+Quando responder sobre historico operacional, use os outputs e timestamps das tools salvas pela memoria.
+```
+
+Regras praticas:
+
+- Perguntas de recall/status podem usar memoria sem chamar tools.
+- Pedidos novos de verificacao, consulta, atualizacao ou registro devem chamar a tool correta quando ainda nao houver evidencia recente.
+- Acoes laterais como confirmar, reservar, enviar, criar ou atualizar so podem ser declaradas como concluidas depois de uma tool de side effect bem-sucedida.
+- Outputs incoerentes de tools devem ser tratados como inconsistencia, nao como fato confirmado.
+
 ## Payload visual do n8n
 
 No output do node durante uma execucao, o Tembory mostra um resumo compacto para humano:
@@ -252,8 +286,8 @@ Exemplo de budget:
 {
   "agentContextBudget": {
     "messages": 1,
-    "chars": 4200,
-    "approxTokens": 1050,
+    "chars": 12000,
+    "approxTokens": 3000,
     "largestSections": [
       { "section": "tools", "chars": 1600, "approxTokens": 400 }
     ]

package/dist/nodes/Tembory/TemboryMemory.node.js

@@ -1250,32 +1250,18 @@ const extractToolCalls = (outputValues = {}) => {
     return Array.from(byKey.values());
 };
 const getMemoryStore = (ctx) => {
-    try {
-        const data = ctx.getWorkflowStaticData('global');
-        data.tembory = data.tembory || {};
-        data.tembory.toolHistory = data.tembory.toolHistory || {};
-        data.tembory.recentMessages = data.tembory.recentMessages || {};
-        data.tembory.profileFacts = data.tembory.profileFacts || {};
-        data.tembory.workingMemory = data.tembory.workingMemory || {};
-        data.tembory.decisionState = data.tembory.decisionState || {};
-        data.tembory.memoryCompression = data.tembory.memoryCompression || {};
-        data.tembory.activeSummary = data.tembory.activeSummary || {};
-        data.tembory.connectedModelSummaryCache = data.tembory.connectedModelSummaryCache || {};
-        data.tembory.captureState = data.tembory.captureState || {};
-        data.tembory.memoryDedupe = data.tembory.memoryDedupe || {};
-        return data.tembory;
-    }
-    catch {
-        global.__temboryMemory = global.__temboryMemory || { toolHistory: {}, recentMessages: {}, profileFacts: {}, workingMemory: {}, decisionState: {}, memoryCompression: {}, activeSummary: {}, connectedModelSummaryCache: {}, captureState: {}, memoryDedupe: {} };
-        global.__temboryMemory.workingMemory = global.__temboryMemory.workingMemory || {};
-        global.__temboryMemory.decisionState = global.__temboryMemory.decisionState || {};
-        global.__temboryMemory.memoryCompression = global.__temboryMemory.memoryCompression || {};
-        global.__temboryMemory.activeSummary = global.__temboryMemory.activeSummary || {};
-        global.__temboryMemory.connectedModelSummaryCache = global.__temboryMemory.connectedModelSummaryCache || {};
-        global.__temboryMemory.captureState = global.__temboryMemory.captureState || {};
-        global.__temboryMemory.memoryDedupe = global.__temboryMemory.memoryDedupe || {};
-        return global.__temboryMemory;
-    }
+    global.__temboryMemory = global.__temboryMemory || { toolHistory: {}, recentMessages: {}, profileFacts: {}, workingMemory: {}, decisionState: {}, memoryCompression: {}, activeSummary: {}, connectedModelSummaryCache: {}, captureState: {}, memoryDedupe: {} };
+    global.__temboryMemory.toolHistory = global.__temboryMemory.toolHistory || {};
+    global.__temboryMemory.recentMessages = global.__temboryMemory.recentMessages || {};
+    global.__temboryMemory.profileFacts = global.__temboryMemory.profileFacts || {};
+    global.__temboryMemory.workingMemory = global.__temboryMemory.workingMemory || {};
+    global.__temboryMemory.decisionState = global.__temboryMemory.decisionState || {};
+    global.__temboryMemory.memoryCompression = global.__temboryMemory.memoryCompression || {};
+    global.__temboryMemory.activeSummary = global.__temboryMemory.activeSummary || {};
+    global.__temboryMemory.connectedModelSummaryCache = global.__temboryMemory.connectedModelSummaryCache || {};
+    global.__temboryMemory.captureState = global.__temboryMemory.captureState || {};
+    global.__temboryMemory.memoryDedupe = global.__temboryMemory.memoryDedupe || {};
+    return global.__temboryMemory;
 };
 const namespacePart = (value) => String(value || '').trim().replace(/\s+/g, '_').replace(/[:|]+/g, '-');
 const userKeyFrom = (threadId, adv, project = '') => {
@@ -1333,8 +1319,8 @@ const mergeRemoteThreadState = (store, key, state) => {
         store.activeSummary[key] = state.activeSummary;
 };
 const SIMPLE_MODE_OVERRIDES = {
-    operationPreset: 'productionFast',
-    summarySource: 'activeContext',
+    operationPreset: 'productionBalanced',
+    summarySource: 'auto',
     includeContextHeader: true,
     compactStateSections: true,
     includeSummary: true,
@@ -1357,13 +1343,13 @@ const SIMPLE_MODE_OVERRIDES = {
     includeDiagnostics: false,
     persistToolFactsToTembory: false,
     includeToolHistorySemanticFallback: false,
-    contextMaxChars: 10000,
-    toolHistoryLastN: 50,
-    toolHistoryTTLSeconds: 36000,
+    contextMaxChars: 20000,
+    toolHistoryLastN: 30,
+    toolHistoryTTLSeconds: 86400,
     recentMessagesLastN: 50,
-    connectedModelSummaryInputMaxChars: 4200,
-    connectedModelSummaryMaxChars: 1200,
-    activeSummaryMaxChars: 1800,
+    connectedModelSummaryInputMaxChars: 12000,
+    connectedModelSummaryMaxChars: 3000,
+    activeSummaryMaxChars: 3500,
     activeSummaryRetentionDays: 30,
 };
 const applyOperationalPreset = (advanced = {}) => {
@@ -1445,7 +1431,7 @@ const applyOperationalPreset = (advanced = {}) => {
             includeConnectedModelSummary: true,
             includeActiveSummary: true,
             persistActiveSummary: true,
-            activeSummaryMaxChars: 1800,
+            activeSummaryMaxChars: 3500,
             activeSummaryRetentionDays: 30,
             enableTransientSummaryCache: true,
             transientSummaryCacheTTLSeconds: 300,
@@ -1471,12 +1457,14 @@ const applyOperationalPreset = (advanced = {}) => {
             includeRecentHighlights: true,
             topK: 6,
             lastN: 8,
-            toolHistoryLastN: 10,
+            toolHistoryLastN: 30,
+            toolHistoryTTLSeconds: 86400,
             recentMessagesLastN: 50,
             vectorMemoryMaxChars: 360,
-            contextMaxChars: 10000,
-            connectedModelSummaryMaxChars: 1200,
-            connectedModelSummaryInputMaxChars: 4200,
+            contextMaxChars: 20000,
+            connectedModelSummaryMaxChars: 3000,
+            connectedModelSummaryInputMaxChars: 12000,
+            summaryMaxFacts: 8,
         },
         productionCheap: {
             summarySource: 'activeContext',
@@ -4513,18 +4501,18 @@ class TemboryMemory {
                                     options: [
                                         { name: 'Custom', value: 'custom' },
                                         { name: 'Diagnóstico Completo', value: 'diagnostic' },
-                                        { name: 'Produção Rápida (Thread + SLM)', value: 'productionFast' },
-                                        { name: 'Produção Balanceada', value: 'productionBalanced' },
+	                                        { name: 'Produção Balanceada (Recomendado)', value: 'productionBalanced' },
+	                                        { name: 'Produção Rápida (Thread + SLM)', value: 'productionFast' },
                                         { name: 'Produção Econômica', value: 'productionCheap' },
                                         { name: 'Produção Nano/SLM', value: 'productionNano' },
                                         { name: 'Auditoria', value: 'audit' },
                                     ],
-                                    default: 'productionFast',
-                                    description: 'Preenche defaults seguros para contexto, historico de tools e memoria ativa.',
-                                },
+	                                    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: 'Máximo de Caracteres do Contexto', name: 'contextMaxChars', type: 'number', default: 20000 },
                                 { 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 },
@@ -4562,16 +4550,16 @@ class TemboryMemory {
                                     ],
                                     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: 'Máximo de Caracteres de Entrada do SLM', name: 'connectedModelSummaryInputMaxChars', type: 'number', default: 12000 },
+	                                { displayName: 'Máximo de Caracteres do Resumo do SLM', name: 'connectedModelSummaryMaxChars', type: 'number', default: 3000 },
                                 { 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: 'Máximo de Caracteres do Active Summary', name: 'activeSummaryMaxChars', type: 'number', default: 3500 },
                                 { 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 },
+	                                { displayName: 'Máximo de Fatos no Resumo', name: 'summaryMaxFacts', type: 'number', default: 8 },
                             ],
                         },
                         {
@@ -4580,8 +4568,8 @@ class TemboryMemory {
                             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: 'Últimas N Tools Mantidas no Contexto', name: 'toolHistoryLastN', type: 'number', default: 30 },
+	                                { displayName: 'TTL Das Tools (Segundos)', name: 'toolHistoryTTLSeconds', type: 'number', default: 86400 },
                                 { displayName: 'Persistir Tool Facts no Backend', name: 'persistToolFactsToTembory', type: 'boolean', default: false },
                                 { displayName: 'Fallback Semântico Para Tools', name: 'includeToolHistorySemanticFallback', type: 'boolean', default: false },
                             ],
@@ -4821,20 +4809,10 @@ class TemboryMemory {
         const profileFromTurn = extractProfileFactsFromText(input, 'user_message', nowIso());
         if (Object.keys(profileFromTurn).length) {
             store.profileFacts[key] = mergeProfileFacts(store.profileFacts[key], profileFromTurn);
-            try {
-                const globalData = this.getWorkflowStaticData('global');
-                globalData.__dataChanged = true;
-            }
-            catch { }
         }
         if (toolCalls.length) {
             const existing = store.toolHistory[key] || [];
             store.toolHistory[key] = applyToolHistoryWindow(existing.concat(toolCalls), adv.toolHistoryTTLSeconds, adv.toolHistoryLastN || 15);
-            try {
-                const globalData = this.getWorkflowStaticData('global');
-                globalData.__dataChanged = true;
-            }
-            catch { }
         }
         if (adv.includeRecentMessages !== false) {
             const recent = store.recentMessages[key] || [];
@@ -4849,11 +4827,6 @@ class TemboryMemory {
                 recentForTembory.push(item);
             }
             store.recentMessages[key] = pruneByLimit(recent, adv.recentMessagesLastN || 8);
-            try {
-                const globalData = this.getWorkflowStaticData('global');
-                globalData.__dataChanged = true;
-            }
-            catch { }
         }
         const renderedProfileForTurn = renderProfileFacts(store.profileFacts[key] || {});
         const recentForTurn = store.recentMessages[key] || [];
@@ -4884,11 +4857,6 @@ class TemboryMemory {
         store.workingMemory[key] = workingMemoryForTurn;
         store.decisionState[key] = decisionStateForTurn;
         store.memoryCompression[key] = compressionForTurn;
-        try {
-            const globalData = this.getWorkflowStaticData('global');
-            globalData.__dataChanged = true;
-        }
-        catch { }
         const messages = [];
         if (input)
             messages.push({ role: 'user', content: input });
@@ -4938,11 +4906,6 @@ class TemboryMemory {
             ...nextCaptureState,
             last_save_thread_state_saved: threadStateSaved,
         });
-        try {
-            const globalData = this.getWorkflowStaticData('global');
-            globalData.__dataChanged = true;
-        }
-        catch { }
         if (adv.persistBackendMemories === false) {
             await finalizeDedupeSummary();
             return;
@@ -5597,11 +5560,6 @@ class TemboryMemory {
         const profileFacts = adv.includeProfileFacts === false ? {} : mergeProfileFacts(store.profileFacts[key], profileFactsFromMessages(allRecentMessages), profileFactsFromMemories(vectorMemories));
         if (adv.includeProfileFacts !== false && Object.keys(profileFacts).length) {
             store.profileFacts[key] = mergeProfileFacts(store.profileFacts[key], profileFacts);
-            try {
-                const globalData = this.getWorkflowStaticData('global');
-                globalData.__dataChanged = true;
-            }
-            catch { }
         }
         const includeToolResults = adv.includeToolResults !== false;
         const operationalState = deriveOperationalState(toolHistory, renderProfileFacts(profileFacts), recentMessages, includeToolResults);
@@ -5741,11 +5699,6 @@ class TemboryMemory {
         store.workingMemory[key] = workingMemory;
         store.decisionState[key] = decisionState;
         store.memoryCompression[key] = memoryCompression;
-        try {
-            const globalData = this.getWorkflowStaticData('global');
-            globalData.__dataChanged = true;
-        }
-        catch { }
         payload = buildContextMessages({
             payloadFormat,
             query,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-tembory",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Tembory node for n8n AI Agents with operational memory, tool history and decision state",
   "license": "MIT",
   "homepage": "https://tembory.com",