n8n-nodes-tembory 1.3.1 → 1.3.3

package/README.md

@@ -2,7 +2,20 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.3.1`.
+Versao atual: `1.3.3`.
+
+## 1.3.3
+
+- Remove texto generico de trabalho como `continue according to the agent prompt...` quando a memoria nao inferiu uma acao concreta.
+- Para mensagens gerais, a memoria registra conversa e contexto, mas nao inventa `currentGoal`, `currentTask` ou `nextExpectedAction`.
+- Para turnos que podem exigir tool, o debug visual passa a mostrar uma orientacao objetiva: avaliar se precisa de tool e consultar `conversation_frame`, `tool_state`, `tool_history` e `action_ledger` antes de executar algo novo.
+
+## 1.3.2
+
+- Remodela o output visual para debug simples no n8n com `sentToAgent`, `slm`, `memory`, `conversation`, `tools`, `io` e `save`.
+- Remove duplicacoes visuais de `saveContext`: `savedMessages`, `conversationTimeline`, `toolNames` e `toolEvents` deixam de aparecer como blocos paralelos no topo.
+- Expõe o status real da SLM no visual: fonte, geração no load atual, cache técnico, active summary carregado/atualizado, chars e preview.
+- Mantem o contexto enviado ao Agent como `tembory.agent_context.v2`; a mudança é no side channel visual e na instrução da SLM para resumir objetivo, próxima ação e evidências operacionais.
 
 ## 1.3.1
 

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

@@ -2054,7 +2054,7 @@ const turnBriefGuidanceForIntent = (intent = '') => {
         return 'May require a tool. Use prompt policy. Prior tools are evidence only; do not claim new side effects without a current required tool call.';
     if (intent === 'profile_update')
         return 'Likely stable profile data. Save useful facts and continue; call tools only when prompt requires.';
-    return 'Continue according to the agent prompt using conversation, tool history and operational state as read-only context.';
+    return 'No specific memory action inferred for this turn; use conversation, tool history and operational state only as read-only context.';
 };
 const buildTurnBriefForAgent = ({ query = '', recentMessages = [], toolHistory = [], operationalState = {}, workingMemory = {}, decisionState = {}, diagnostics = {} }) => {
     const currentIntent = (decisionState || {}).current_intent || (workingMemory || {}).last_user_intent || inferUserIntent(query, recentMessages);
@@ -2182,16 +2182,16 @@ const inferUserIntent = (query = '', recentMessages = []) => {
 };
 const deriveNextExpectedAction = (intent, operationalState = {}) => {
     if (['affirm', 'commit_or_continue', 'tool_action_candidate', 'selection_or_slot'].includes(intent))
-        return 'continue according to the agent prompt using conversation_frame, tool_state, tool_history and action_ledger; do not apply domain-specific memory rules';
+        return 'evaluate whether the current turn needs a tool; reuse conversation_frame, tool_state, tool_history and action_ledger before executing anything new';
     if (intent === 'profile_update')
         return 'save stable profile facts and continue the conversation';
     if (intent === 'conversation_recall')
         return 'answer directly using conversation_history_chronological/all_user_messages_chronological; do not call tools for recall-only questions';
     if (intent === 'operational_status_question')
         return 'answer status questions from tool_state, tool_history and action_ledger; do not call tools unless the agent prompt requires it';
-    return 'continue according to the agent prompt using retrieved context; call tools when the agent prompt or tool policy requires them';
+    return undefined;
 };
-const isGenericMemoryNextAction = (value = '') => /answer using retrieved context and avoid unnecessary tool calls|continue according to the agent prompt using retrieved context/i.test(String(value || ''));
+const isGenericMemoryNextAction = (value = '') => /answer using retrieved context and avoid unnecessary tool calls|continue according to the agent prompt using retrieved context|continue according to the agent prompt/i.test(String(value || ''));
 const shouldCarryPreviousGoal = (intent = '', previousGoal = '') => {
     if (!previousGoal || isGenericMemoryNextAction(previousGoal))
         return false;
@@ -3231,6 +3231,14 @@ const buildAgentContextV2 = ({ query = '', userId = '', payloadFormat = 'structu
         memory: cleanContextValue({
             slmSummary: connectedModelSummary ? truncate(connectedModelSummary, Number(adv.connectedModelSummaryMaxChars || 900)) : undefined,
             activeSummary: !connectedModelSummary && activeSummary ? truncate(activeSummary, Number(adv.activeSummaryMaxChars || 900)) : undefined,
+            summaryStatus: diagnostics?.activeSummary ? cleanContextValue({
+                source: diagnostics.activeSummary.source,
+                generated: Boolean(connectedModelSummary),
+                activeSummaryLoaded: Boolean(diagnostics.activeSummary.activeSummaryLoaded),
+                activeSummaryUpdated: Boolean(diagnostics.activeSummary.activeSummaryUpdated),
+                transientCacheHit: Boolean(diagnostics.activeSummary.transientCacheHit),
+                chars: diagnostics.activeSummary.summaryChars,
+            }) : undefined,
             referenceFacts,
             compression: adv.includeMemoryCompression === false ? undefined : compactMemoryCompressionForAgent(memoryCompression || {}),
         }),
@@ -3352,13 +3360,13 @@ const invokeConnectedModelSummary = async (connectedLanguageModel, summaryInput,
     const response = await connectedLanguageModel.invoke([
         toBaseMessage({
             role: 'user',
-                            content: `Update the Tembory active summary for the next agent turn. Return only concise Portuguese bullets, no JSON and no markdown table. Preserve IDs, dates, tool names, confirmed decisions, explicit pending actions, constraints, contradictions, and do-not-repeat instructions. Prefer durable useful context over raw logs. Do not invent facts. Treat inferred gaps or missing details as read-only observations, not action requirements, unless they are explicitly present in tool_state, action_ledger, working_memory.next_expected_action, or the current user message. Do not convert observations, guesses, or helpful suggestions into blocking pending actions. Do-not-repeat means avoiding duplicate prerequisite lookup calls; it never means a current side-effect action is completed without a successful tool call in the current turn.\n\nContext:\n${summaryInput}`,
+                            content: `Update the Tembory active summary for the next agent turn. Return only concise Portuguese bullets, no JSON and no markdown table. Include what the agent is doing now, the current objective, the next expected action, useful tool evidence, pending confirmations, durable user facts, constraints, contradictions, and do-not-repeat guidance when present. Preserve IDs, dates, tool names, confirmed decisions, explicit pending actions, constraints, contradictions, and do-not-repeat instructions. Prefer durable useful context over raw logs. Do not invent facts. Treat inferred gaps or missing details as read-only observations, not action requirements, unless they are explicitly present in tool_state, action_ledger, working_memory.next_expected_action, or the current user message. Do not convert observations, guesses, or helpful suggestions into blocking pending actions. Do-not-repeat means avoiding duplicate prerequisite lookup calls; it never means a current side-effect action is completed without a successful tool call in the current turn.\n\nContext:\n${summaryInput}`,
         }),
     ]);
     return cleanModelSummaryText(response, Number(adv.connectedModelSummaryMaxChars || 1200));
 };
-const VISUAL_SCHEMA_VERSION = 'tembory.visual.v1';
-const TOOL_LOG_VISUAL_SCHEMA_VERSION = 'tembory.visual.v1.toolLog';
+const VISUAL_SCHEMA_VERSION = 'tembory.visual.v2';
+const TOOL_LOG_VISUAL_SCHEMA_VERSION = 'tembory.visual.v2.toolLog';
 const SIDE_CHANNEL_TOOL_EVENT_MAX = 12;
 const SIDE_CHANNEL_SAVE_TOOL_EVENT_MAX = 20;
 const compactParsedToolInputForSideChannel = (input) => {
@@ -3538,22 +3546,35 @@ const summarizeSaveContextForSideChannel = (input = {}, output = {}, chatHistory
     const outputMessage = output?.output || output?.response || output?.text || output?.message || output?.answer || '';
     const toolCalls = extractToolCalls(output || {});
     const toolEvents = compactToolEventsForSideChannel(toolCalls, SIDE_CHANNEL_SAVE_TOOL_EVENT_MAX);
-    return keepVisibleToolLogArrays(cleanContextValue({
+    const conversation = conversationDigestFromMessagesForSideChannel(chatHistory);
+    const timeline = conversationTimelineFromMessagesForSideChannel(chatHistory, 16);
+    return cleanContextValue({
         visualSchema: VISUAL_SCHEMA_VERSION,
-        messagesAfterSave: Array.isArray(chatHistory) ? chatHistory.length : 0,
-        conversation: conversationDigestFromMessagesForSideChannel(chatHistory),
-        conversationTimeline: conversationTimelineFromMessagesForSideChannel(chatHistory, 16),
-        savedMessages: Array.isArray(chatHistory)
-            ? chatHistory.slice(-6).map((message) => compactMessageForSideChannel(message))
-            : undefined,
-        userInput: inputMessage ? truncate(String(inputMessage), 500) : undefined,
-        assistantOutput: outputMessage ? truncate(String(outputMessage), 700) : undefined,
-        toolCallsCaptured: toolCalls.length,
-        toolNames: toolEvents.map((tool) => tool.name).filter(Boolean),
-        toolCapture: summarizeToolCaptureForSideChannel(output, toolCalls),
-        toolLog: buildToolLogForSideChannel(toolEvents, toolCalls.length, SIDE_CHANNEL_SAVE_TOOL_EVENT_MAX),
-        toolEvents,
-    }));
+        summary: cleanContextValue({
+            action: 'saveContext',
+            messagesAfterSave: Array.isArray(chatHistory) ? chatHistory.length : 0,
+            userInputPreview: inputMessage ? truncate(String(inputMessage), 220) : undefined,
+            assistantOutputPreview: outputMessage ? truncate(String(outputMessage), 260) : undefined,
+            toolCallsCaptured: toolCalls.length,
+        }),
+        conversation: cleanContextValue({
+            ...conversation,
+            timeline,
+        }),
+        io: cleanContextValue({
+            userInput: inputMessage ? truncate(String(inputMessage), 500) : undefined,
+            assistantOutput: outputMessage ? truncate(String(outputMessage), 700) : undefined,
+        }),
+        tools: cleanContextValue({
+            captured: toolCalls.length,
+            capture: summarizeToolCaptureForSideChannel(output, toolCalls),
+            log: buildToolLogForSideChannel(toolEvents, toolCalls.length, SIDE_CHANNEL_SAVE_TOOL_EVENT_MAX),
+        }),
+        save: cleanContextValue({
+            messagesAfterSave: Array.isArray(chatHistory) ? chatHistory.length : 0,
+            status: 'saved_to_memory_contract',
+        }),
+    });
 };
 const compactMemoryEventPayload = (payload = {}) => {
     const compact = { ...(payload || {}) };
@@ -3771,10 +3792,20 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
             toolCallsCaptured: parsed.captureHealth?.toolCallsCapturedLastSave,
             captureSources: parsed.captureHealth?.captureSources,
         } : {}));
+        const summaryStatus = parsed.memory?.summaryStatus || parsed.diagnostics?.activeSummary || {};
+        const slmPreview = parsed.memory?.slmSummary || parsed.memory?.activeSummary || summaryText || '';
         const fullDedupeSummary = parsed.dedupeSummary || parsed.diagnostics?.dedupeSummary || undefined;
         const loadedSections = loadedSectionsForSideChannel(parsed, memoryAudit);
         const agentContextBudget = agentContextBudgetForSideChannel(list, parsed);
         summary.visualSchema = VISUAL_SCHEMA_VERSION;
+        summary.sentToAgent = cleanContextValue({
+            messages: list.length,
+            contextKind: parsed.kind,
+            schemaVersion: parsed.schemaVersion,
+            chars: agentContextBudget.chars,
+            approxTokens: agentContextBudget.approxTokens,
+            largestSections: agentContextBudget.largestSections,
+        });
         summary.userId = parsed.userId;
         summary.project = parsed.project || undefined;
         summary.retrievalMode = parsed.retrievalMode;
@@ -3796,6 +3827,7 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
                 at: lastAgent.at || lastAgent.timestamp || lastAgent.created_at || lastAgent.createdAt,
                 preview: truncate(String(lastAgent.content || lastAgent.text || lastAgent.message || ''), 240),
             } : undefined,
+            timeline: compactConversationTimelineForSideChannel(conversation, 16),
         });
         summary.conversationTimeline = compactConversationTimelineForSideChannel(conversation, 16);
         const visibleToolEvents = compactToolEventsForSideChannel(toolItems, SIDE_CHANNEL_TOOL_EVENT_MAX);
@@ -3831,6 +3863,30 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
         });
         summary.loadedSections = loadedSections;
         summary.agentContextBudget = agentContextBudget;
+        summary.slm = cleanContextValue({
+            status: slmPreview ? 'available' : 'empty',
+            source: summaryStatus.source || (parsed.memory?.slmSummary ? 'slm_summary' : parsed.memory?.activeSummary ? 'active_summary' : 'none'),
+            generatedThisLoad: summaryStatus.source === 'fresh_slm',
+            activeSummaryLoaded: summaryStatus.activeSummaryLoaded,
+            activeSummaryUpdated: summaryStatus.activeSummaryUpdated,
+            transientCacheHit: summaryStatus.transientCacheHit,
+            chars: summaryStatus.chars || summaryStatus.summaryChars || (slmPreview ? String(slmPreview).length : 0),
+            preview: slmPreview ? truncate(String(slmPreview), 500) : undefined,
+        });
+        summary.memory = cleanContextValue({
+            conversation: summary.conversation,
+            tools: {
+                count: toolItems.length || summary.toolCount || 0,
+                names: summary.toolNames,
+                last: summary.lastTool,
+                log: summary.toolLog,
+            },
+            compression: parsed.memory?.compression || parsed.memoryCompression,
+            referenceFacts: parsed.memory?.referenceFacts,
+            canonicalFacts: parsed.canonicalFacts,
+            captureHealth: parsed.captureHealth,
+        });
+        summary.tools = summary.memory?.tools;
         summary.lastSave = Object.keys(lastSave).length ? lastSave : undefined;
         summary.dedupe = fullDedupeSummary ? compactDedupeForSideChannel(fullDedupeSummary) : undefined;
         summary.workingMemory = cleanContextValue({
@@ -3875,6 +3931,13 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
             dedupeSummary: fullDedupeSummary,
             conversationTimelineFull: compactConversationTimelineForSideChannel(conversation, 12, true),
         }) : undefined;
+        delete summary.currentUserMessage;
+        delete summary.toolNames;
+        delete summary.toolEvents;
+        delete summary.toolLog;
+        delete summary.lastTool;
+        delete summary.agentContextBudget;
+        delete summary.conversationTimeline;
         return Object.fromEntries(Object.entries(summary).filter(([, value]) => value !== undefined));
     }
     catch {
@@ -4068,7 +4131,7 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
                 latest_tool: ((decisionState || {}).latest_tool || (operationalState || {}).last_tool || undefined),
                 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.',
+                instruction: actionDirective || workingMemory.next_expected_action || undefined,
             }),
         });
         const audit = {

package/package.json

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