n8n-nodes-tembory 1.1.37 → 1.1.39

package/README.md

@@ -2,7 +2,19 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.1.37`.
+Versao atual: `1.1.39`.
+
+## 1.1.39
+
+- Ajusta a semantica de repeticao de tools: `do_not_repeat_tools` fica restrito a turnos de recall, status operacional ou pedido explicito para nao chamar tools.
+- Em turnos normais, o Agent recebe `repeat_tool_policy` e `avoid_repeating_tools_unless_needed`, deixando claro que tools anteriores sao evidencia reutilizavel, nao ferramentas proibidas.
+- Compacta `decisionState.tool_decision_state` para evitar duplicar outputs longos de tools no contexto balanceado.
+
+## 1.1.38
+
+- Torna o resumo visual independente do tipo da mensagem LangChain, procurando o contexto Tembory em qualquer mensagem carregada.
+- Enriquece eventos `chatHistory.addMessage(s)` com `savedMessages`, input/output resumidos e tool events quando esse for o caminho usado pelo Agent.
+- Mantem a separacao entre contexto interno do Agent e output compacto para humano.
 
 ## 1.1.37
 

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

@@ -2046,6 +2046,8 @@ const buildTurnBriefForAgent = ({ query = '', recentMessages = [], toolHistory =
             status: lastTool.status || (lastTool.ok === false ? 'failed' : 'ok'),
             at: lastTool.at || lastTool.timestamp,
         } : undefined,
+        repeat_tool_policy: (decisionState || {}).repeat_tool_policy,
+        avoid_repeating_tools_unless_needed: ((decisionState || {}).avoid_repeating_tools_unless_needed || []).slice(0, 12),
         do_not_repeat_tools: ((decisionState || {}).do_not_repeat_tools || []).slice(0, 12),
         guidance: turnBriefGuidanceForIntent(currentIntent),
     });
@@ -2151,6 +2153,19 @@ const shouldCarryPreviousGoal = (intent = '', previousGoal = '') => {
         return false;
     return ['general_message', 'profile_update', 'unknown'].includes(intent);
 };
+const toolNameSuggestsSideEffect = (name = '') => /(?:^|[_\-. ])(book|booking|reserv\w*|agend\w*|confirm\w*|cancel\w*|cri\w*|create|update|upsert|set|send|enviar|registr\w*|cadastr\w*|charge|cobran\w*|pagamento|ticket)(?:$|[_\-. ])/i.test(String(name || ''));
+const deriveToolRepeatPolicy = ({ intent = '', query = '', executedTools = [], toolState = {} }) => {
+    const tools = Array.from(new Set(executedTools.filter(Boolean)));
+    const strictMemoryOnlyTurn = intent === 'conversation_recall' || intent === 'operational_status_question' || hasNoToolRequested(query);
+    const sideEffectToolCandidates = tools.filter(toolNameSuggestsSideEffect);
+    return cleanContextValue({
+        mode: strictMemoryOnlyTurn ? 'answer_from_memory_when_possible' : 'conditional_reuse',
+        avoid_repeating_tools_unless_needed: tools,
+        legacy_do_not_repeat_applies: strictMemoryOnlyTurn,
+        side_effect_tool_candidates: sideEffectToolCandidates,
+        instruction: 'Prior tools are evidence, not forbidden tools. Reuse outputs when sufficient; call tools for fresh data, new scope, or current side effects.',
+    });
+};
 const deriveWorkingMemory = ({ query = '', profileFacts = {}, recentMessages = [], toolHistory = [], operationalState = {}, previous = {} }) => {
     const intent = inferUserIntent(query, recentMessages);
     const chronological = sortConversationChronological(recentMessages || []);
@@ -2225,7 +2240,6 @@ const deriveWorkingMemory = ({ query = '', profileFacts = {}, recentMessages = [
 };
 const deriveDecisionState = ({ query = '', toolHistory = [], operationalState = {}, workingMemory = {} }) => {
     const decisions = [];
-    const doNotRepeatTools = [];
     const intent = workingMemory.last_user_intent || inferUserIntent(query, []);
     const now = nowIso();
     const toolState = operationalState.tool_state || {};
@@ -2244,9 +2258,9 @@ const deriveDecisionState = ({ query = '', toolHistory = [], operationalState =
             tool: extra.tool,
         });
     };
-    for (const name of Object.keys(toolState.counts_by_name || {})) {
-        doNotRepeatTools.push(name);
-    }
+    const executedTools = Array.from(new Set(Object.keys(toolState.counts_by_name || {})));
+    const toolRepeatPolicy = deriveToolRepeatPolicy({ intent, query, executedTools, toolState });
+    const doNotRepeatTools = toolRepeatPolicy.legacy_do_not_repeat_applies ? executedTools : [];
     if (toolState.last_successful_tool)
         pushDecision('last_successful_tool_recorded', `latest successful tool is ${toolState.last_successful_tool.name}`, 'tool_state records successful tool execution', 'tool_orchestration', { confidence: 0.9, tool: toolState.last_successful_tool.name });
     for (const [name, count] of Object.entries(toolState.failed_by_name || {}))
@@ -2254,15 +2268,18 @@ const deriveDecisionState = ({ query = '', toolHistory = [], operationalState =
     return {
         active_decisions: decisions,
         do_not_repeat_tools: Array.from(new Set(doNotRepeatTools)),
+        repeat_tool_policy: toolRepeatPolicy,
+        avoid_repeating_tools_unless_needed: toolRepeatPolicy.avoid_repeating_tools_unless_needed,
         current_intent: intent,
         tool_decision_state: {
-            executed_tools: Object.keys(toolState.counts_by_name || {}),
+            executed_tools: executedTools,
             failed_tools: Object.keys(toolState.failed_by_name || {}),
             last_successful_tool: toolState.last_successful_tool || null,
             do_not_repeat_tools: Array.from(new Set(doNotRepeatTools)),
+            repeat_tool_policy: toolRepeatPolicy,
             evaluated_at: now,
         },
-        conflict_policy: 'prefer active decisions with newer timestamps; ignore superseded or expired memories unless auditing',
+        conflict_policy: 'prefer newer active decisions; ignore superseded or expired memories unless auditing',
         decision_count: decisions.length,
         latest_tool: toolHistory && toolHistory.length ? {
             name: toolHistory[toolHistory.length - 1].name,
@@ -2580,6 +2597,26 @@ const compactWorkingMemoryForAgent = (memory = {}) => cleanContextValue({
     next_expected_action: memory.next_expected_action,
     updated_at: memory.updated_at,
 });
+const compactToolDecisionStateForAgent = (toolDecisionState = {}) => {
+    const lastTool = toolDecisionState.last_successful_tool || null;
+    return cleanContextValue({
+        executed_tools: (toolDecisionState.executed_tools || []).slice(0, 12),
+        failed_tools: (toolDecisionState.failed_tools || []).slice(0, 12),
+        last_successful_tool: lastTool ? cleanContextValue({
+            name: lastTool.name || lastTool.tool_name || lastTool.tool,
+            status: lastTool.status || (lastTool.ok === false ? 'failed' : 'ok'),
+            at: lastTool.at || lastTool.timestamp,
+        }) : undefined,
+        do_not_repeat_tools: (toolDecisionState.do_not_repeat_tools || []).slice(0, 12),
+        evaluated_at: toolDecisionState.evaluated_at,
+    });
+};
+const compactRepeatToolPolicyForAgent = (policy = {}) => cleanContextValue({
+    mode: policy.mode,
+    legacy_do_not_repeat_applies: policy.legacy_do_not_repeat_applies,
+    side_effect_tool_candidates: (policy.side_effect_tool_candidates || []).slice(0, 12),
+    instruction: policy.instruction,
+});
 const compactDecisionStateForAgent = (state = {}) => cleanContextValue({
     current_intent: state.current_intent,
     active_decisions: (state.active_decisions || []).slice(-4).map((decision) => cleanContextValue({
@@ -2592,13 +2629,14 @@ const compactDecisionStateForAgent = (state = {}) => cleanContextValue({
         at: decision.at || decision.updated_at,
     })),
     do_not_repeat_tools: state.do_not_repeat_tools,
-    tool_decision_state: state.tool_decision_state,
+    repeat_tool_policy: state.repeat_tool_policy ? compactRepeatToolPolicyForAgent(state.repeat_tool_policy) : undefined,
+    avoid_repeating_tools_unless_needed: state.avoid_repeating_tools_unless_needed,
+    tool_decision_state: state.tool_decision_state ? compactToolDecisionStateForAgent(state.tool_decision_state) : undefined,
     latest_tool: state.latest_tool ? cleanContextValue({
         name: state.latest_tool.name,
         status: state.latest_tool.status || (state.latest_tool.ok === false ? 'failed' : 'ok'),
         at: state.latest_tool.at,
     }) : undefined,
-    conflict_policy: state.conflict_policy,
 });
 const compactOperationalStateForAgent = (state = {}) => {
     const counts = state.tool_counts || {};
@@ -3027,10 +3065,11 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
         const type = messageTypeOf(message);
         return type === 'system' || /system/i.test(String(message?.role || ''));
     });
-    if (!firstSystem)
+    const contextMessage = firstSystem || list.find((message) => messageContentOf(message).includes('tembory.agent_context.v1')) || list[0];
+    if (!contextMessage)
         return summary;
     try {
-        const rawContent = messageContentOf(firstSystem);
+        const rawContent = messageContentOf(contextMessage);
         let parsed;
         try {
             parsed = JSON.parse(rawContent);
@@ -3137,6 +3176,12 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
             decisionCount: parsed.decisionState?.decision_count,
             latestTool: parsed.decisionState?.latest_tool,
             doNotRepeatTools: parsed.decisionState?.do_not_repeat_tools,
+            avoidRepeatingToolsUnlessNeeded: parsed.decisionState?.avoid_repeating_tools_unless_needed,
+            repeatToolPolicy: parsed.decisionState?.repeat_tool_policy ? {
+                mode: parsed.decisionState.repeat_tool_policy.mode,
+                legacyDoNotRepeatApplies: parsed.decisionState.repeat_tool_policy.legacy_do_not_repeat_applies,
+                sideEffectToolCandidates: parsed.decisionState.repeat_tool_policy.side_effect_tool_candidates,
+            } : undefined,
         });
         summary.quality = parsed.contextHealth?.quality_score || parsed.contextQualityScore || undefined;
         summary.debug = includeDebug ? cleanContextValue({
@@ -3150,7 +3195,7 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
         return Object.fromEntries(Object.entries(summary).filter(([, value]) => value !== undefined));
     }
     catch {
-        const content = messageContentOf(firstSystem);
+        const content = messageContentOf(contextMessage);
         return cleanContextValue({
             ...summary,
             contextChars: content.length || undefined,
@@ -3337,7 +3382,9 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
             value: cleanContextValue({
                 current_intent: (decisionState || {}).current_intent || workingMemory.last_user_intent,
                 latest_tool: ((decisionState || {}).latest_tool || (operationalState || {}).last_tool || undefined),
-                do_not_repeat_tools: ((decisionState || {}).do_not_repeat_tools || []).slice(0, 12),
+                repeat_tool_policy: (decisionState || {}).repeat_tool_policy,
+                avoid_repeating_tools_unless_needed: ((decisionState || {}).avoid_repeating_tools_unless_needed || []).slice(0, 12),
+                do_not_repeat_tools_legacy: ((decisionState || {}).do_not_repeat_tools || []).slice(0, 12),
                 instruction: actionDirective || workingMemory.next_expected_action || 'Continue according to the agent prompt.',
             }),
         });
@@ -3852,24 +3899,40 @@ class TemboryMemory {
                 addMessage: async (message) => {
                     currentMessages.push(message);
                     const saved = await TemboryMemory.prototype.saveMessagesForItem.call(this, itemIndex, [message]);
-                    recordMemoryEvent('chatHistory.addMessage', { saved: Boolean(saved && saved.saved), toolCalls: (saved && saved.toolCalls) || [], messages: 1 });
+                    recordMemoryEvent('chatHistory.addMessage', {
+                        saved: Boolean(saved && saved.saved),
+                        messages: 1,
+                        ...summarizeSaveContextForSideChannel((saved && saved.input) || {}, (saved && saved.output) || {}, currentMessages),
+                    });
                 },
                 addUserMessage: async (message) => {
                     const baseMessage = toBaseMessage({ role: 'user', content: message });
                     currentMessages.push(baseMessage);
                     const saved = await TemboryMemory.prototype.saveMessagesForItem.call(this, itemIndex, [baseMessage]);
-                    recordMemoryEvent('chatHistory.addUserMessage', { saved: Boolean(saved && saved.saved), toolCalls: (saved && saved.toolCalls) || [], messages: 1 });
+                    recordMemoryEvent('chatHistory.addUserMessage', {
+                        saved: Boolean(saved && saved.saved),
+                        messages: 1,
+                        ...summarizeSaveContextForSideChannel((saved && saved.input) || {}, (saved && saved.output) || {}, currentMessages),
+                    });
                 },
                 addAIChatMessage: async (message) => {
                     const baseMessage = toBaseMessage({ role: 'assistant', content: message });
                     currentMessages.push(baseMessage);
                     const saved = await TemboryMemory.prototype.saveMessagesForItem.call(this, itemIndex, [baseMessage]);
-                    recordMemoryEvent('chatHistory.addAIChatMessage', { saved: Boolean(saved && saved.saved), toolCalls: (saved && saved.toolCalls) || [], messages: 1 });
+                    recordMemoryEvent('chatHistory.addAIChatMessage', {
+                        saved: Boolean(saved && saved.saved),
+                        messages: 1,
+                        ...summarizeSaveContextForSideChannel((saved && saved.input) || {}, (saved && saved.output) || {}, currentMessages),
+                    });
                 },
                 addMessages: async (messages) => {
                     currentMessages.push(...messages);
                     const saved = await TemboryMemory.prototype.saveMessagesForItem.call(this, itemIndex, messages);
-                    recordMemoryEvent('chatHistory.addMessages', { saved: Boolean(saved && saved.saved), toolCalls: (saved && saved.toolCalls) || [], messages: Array.isArray(messages) ? messages.length : 0 });
+                    recordMemoryEvent('chatHistory.addMessages', {
+                        saved: Boolean(saved && saved.saved),
+                        messages: Array.isArray(messages) ? messages.length : 0,
+                        ...summarizeSaveContextForSideChannel((saved && saved.input) || {}, (saved && saved.output) || {}, currentMessages),
+                    });
                 },
                 clear: async () => {
                     currentMessages = [];

package/package.json

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