n8n-nodes-tembory 1.1.24 → 1.1.26

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

@@ -1723,6 +1723,56 @@ const buildCurrentTurnFocus = ({ query = '', recentMessages = [], operationalSta
     });
     return focus;
 };
+const turnBriefGuidanceForIntent = (intent = '') => {
+    if (intent === 'conversation_recall')
+        return 'Answer from the chronological conversation frame. Do not call tools for recall-only requests.';
+    if (intent === 'operational_status_question')
+        return 'Answer from tool_state, tool_history and action_ledger. Do not call tools just to inspect prior calls.';
+    if (['tool_action_candidate', 'selection_or_slot', 'affirm', 'commit_or_continue'].includes(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.';
+};
+const buildTurnBriefForAgent = ({ query = '', recentMessages = [], toolHistory = [], operationalState = {}, workingMemory = {}, decisionState = {}, diagnostics = {} }) => {
+    const currentIntent = (decisionState || {}).current_intent || (workingMemory || {}).last_user_intent || inferUserIntent(query, recentMessages);
+    const toolState = (operationalState || {}).tool_state || {};
+    const lastTool = (toolState.last_successful_tool || (operationalState || {}).last_tool || (Array.isArray(toolHistory) && toolHistory.length ? toolHistory[toolHistory.length - 1] : null));
+    const toolNames = Array.from(new Set([]
+        .concat(toolState.names || [])
+        .concat((Array.isArray(toolHistory) ? toolHistory : []).map((tool) => tool && (tool.name || tool.tool_name || tool.tool)).filter(Boolean))));
+    const userMessages = (recentMessages || []).filter((msg) => /^(user|human)$/i.test(String(msg.role || '')));
+    const lastSave = (diagnostics || {}).captureState || {};
+    return cleanContextValue({
+        current_intent: currentIntent,
+        current_request: truncate(query || ((userMessages[userMessages.length - 1] || {}).content || ''), 300),
+        memory_status: {
+            messages: Array.isArray(recentMessages) ? recentMessages.length : 0,
+            users: userMessages.length,
+            tools: Array.isArray(toolHistory) ? toolHistory.length : 0,
+            last_save_at: lastSave.last_save_at,
+            last_save_tool_calls_captured: lastSave.last_save_tool_calls_captured,
+        },
+        tool_names: toolNames.slice(0, 8),
+        last_tool: lastTool ? {
+            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: ((decisionState || {}).do_not_repeat_tools || []).slice(0, 12),
+        guidance: turnBriefGuidanceForIntent(currentIntent),
+    });
+};
+const compactTurnBriefForAgent = (brief = {}) => {
+    const status = brief.memory_status || {};
+    const parts = [
+        brief.current_intent ? `intent=${brief.current_intent}` : '',
+        brief.current_request ? `request=${truncate(brief.current_request, 80)}` : '',
+        status.tools !== undefined ? `tools=${status.tools}` : '',
+        'prior tools are evidence; new side effects need current tool',
+    ].filter(Boolean);
+    return parts.join('; ');
+};
 const SIDE_EFFECT_SAFETY_INSTRUCTION = 'Previous tool calls are evidence only. Never tell the user that a new side-effect action is done, confirmed, booked, created, updated, cancelled, sent, charged, assigned, or executed from memory alone. If the current user turn asks to commit a side-effect and the agent prompt requires a tool, call the appropriate tool in the current turn before saying it is done. Use prior tool outputs only to avoid repeating prerequisite lookup tools and to fill inputs for the required tool call.';
 const intentConfidence = (intent = '') => {
     if (['conversation_recall', 'operational_status_question'].includes(intent))
@@ -1789,7 +1839,7 @@ const inferUserIntent = (query = '', recentMessages = []) => {
         return 'selection_or_slot';
     if (hasCommitIntent(text))
         return 'commit_or_continue';
-    if (/\b(buscar|busca|criar|cria|atualizar|atualiza|consultar|consulta|reservar|reserva|agendar|agenda|abrir|abre|cancelar|cancela|enviar|envia|gerar|gera|validar|valida|processar|processa|executar|executa)\b/.test(text))
+    if (/\b(buscar|busca|criar|cria|atualizar|atualiza|consultar|consulta|reservar|reserva|agendar|agenda|abrir|abre|cancelar|cancela|enviar|envia|gerar|gera|validar|valida|processar|processa|executar|executa|registrar|registra|salvar|salva|gravar|grava|cadastrar|cadastra|inserir|insere)\b/.test(text))
         return 'tool_action_candidate';
     if (/\b(meu nome|email|telefone|empresa|prefiro|preferencia)\b/.test(text))
         return 'profile_update';
@@ -1809,21 +1859,73 @@ const deriveNextExpectedAction = (intent, operationalState = {}) => {
     return 'continue according to the agent prompt using retrieved context; call tools when the agent prompt or tool policy requires them';
 };
 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 shouldCarryPreviousGoal = (intent = '', previousGoal = '') => {
+    if (!previousGoal || isGenericMemoryNextAction(previousGoal))
+        return false;
+    return ['general_message', 'profile_update', 'unknown'].includes(intent);
+};
 const deriveWorkingMemory = ({ query = '', profileFacts = {}, recentMessages = [], toolHistory = [], operationalState = {}, previous = {} }) => {
     const intent = inferUserIntent(query, recentMessages);
-    const lastUser = [...(recentMessages || [])].reverse().find((msg) => /^(user|human)$/i.test(String(msg.role || '')));
+    const chronological = sortConversationChronological(recentMessages || []);
+    const userMessages = chronological.filter((msg) => /^(user|human)$/i.test(String(msg.role || '')));
+    const assistantMessages = chronological.filter((msg) => /^(assistant|ai|agent)$/i.test(String(msg.role || '')));
+    const normalizedQuery = normalizeIntentText(query).trim();
+    const lastUser = [...userMessages].reverse().find((msg) => /^(user|human)$/i.test(String(msg.role || '')));
+    const priorUser = [...userMessages].reverse().find((msg) => normalizeIntentText(msg.content).trim() !== normalizedQuery);
+    const lastAssistant = assistantMessages[assistantMessages.length - 1] || null;
     const activeEntities = [];
     for (const key of ['name', 'company', 'email', 'phone']) {
         if (profileFacts && profileFacts[key])
             activeEntities.push({ type: key, value: profileFacts[key] });
     }
     const lastTool = toolHistory && toolHistory.length ? toolHistory[toolHistory.length - 1] : null;
+    const toolState = (operationalState || {}).tool_state || {};
     const nextExpectedAction = deriveNextExpectedAction(intent, operationalState);
+    const carryPreviousGoal = shouldCarryPreviousGoal(intent, previous.current_goal);
+    const currentGoal = carryPreviousGoal ? previous.current_goal : nextExpectedAction;
+    const toolNames = Array.from(new Set((toolHistory || []).map((tool) => tool.name || tool.tool_name || tool.tool).filter(Boolean)));
+    const currentTurnMayNeedTool = ['affirm', 'commit_or_continue', 'tool_action_candidate', 'selection_or_slot'].includes(intent);
     return {
-        current_goal: previous.current_goal && !isGenericMemoryNextAction(previous.current_goal) ? previous.current_goal : nextExpectedAction,
+        current_goal: currentGoal,
+        current_goal_reason: carryPreviousGoal ? 'carried_from_previous_non_generic_goal' : 'derived_from_current_turn_intent',
         current_task: nextExpectedAction,
         last_user_intent: intent,
         last_user_message: lastUser ? truncate(lastUser.content, 500) : truncate(query, 500),
+        conversation_digest: cleanContextValue({
+            messages: chronological.length,
+            user_messages: userMessages.length,
+            assistant_messages: assistantMessages.length,
+            current_user: truncate(query, 220),
+            prior_user: priorUser ? { content: truncate(priorUser.content, 180), at: priorUser.at } : undefined,
+            last_assistant: lastAssistant ? { content: truncate(lastAssistant.content, 180), at: lastAssistant.at } : undefined,
+        }),
+        tool_digest: cleanContextValue({
+            total: Array.isArray(toolHistory) ? toolHistory.length : 0,
+            ok: (operationalState || {}).tool_counts?.ok,
+            failed: (operationalState || {}).tool_counts?.failed,
+            names: toolNames.slice(0, 12),
+            last_successful: toolState.last_successful_tool ? {
+                name: toolState.last_successful_tool.name,
+                at: toolState.last_successful_tool.at,
+                status: toolState.last_successful_tool.status || 'ok',
+            } : undefined,
+            failed_by_name: toolState.failed_by_name,
+        }),
+        turn_flags: cleanContextValue({
+            recall_only: intent === 'conversation_recall',
+            status_question: intent === 'operational_status_question',
+            current_turn_may_need_tool: currentTurnMayNeedTool,
+            has_prior_tools: Array.isArray(toolHistory) && toolHistory.length > 0,
+            has_profile_facts: activeEntities.length > 0,
+            carry_previous_goal: carryPreviousGoal,
+        }),
+        context_sources: cleanContextValue({
+            conversation: chronological.length > 0,
+            tool_history: Array.isArray(toolHistory) && toolHistory.length > 0,
+            operational_state: Boolean((operationalState || {}).tool_state || (operationalState || {}).tool_counts),
+            profile_facts: activeEntities.length > 0,
+        }),
+        agent_guidance: nextExpectedAction,
         active_entities: activeEntities,
         open_decisions: previous.open_decisions || [],
         last_error: lastTool && lastTool.ok === false ? { tool: lastTool.name, at: lastTool.at, result: lastTool.result } : null,
@@ -2098,9 +2200,15 @@ const cleanContextValue = (value) => {
 };
 const compactWorkingMemoryForAgent = (memory = {}) => cleanContextValue({
     current_goal: memory.current_goal,
+    current_goal_reason: memory.current_goal_reason,
     current_task: memory.current_task,
     last_user_intent: memory.last_user_intent,
     last_user_message: truncate(memory.last_user_message, 220),
+    conversation_digest: memory.conversation_digest,
+    tool_digest: memory.tool_digest,
+    turn_flags: memory.turn_flags,
+    context_sources: memory.context_sources,
+    agent_guidance: memory.agent_guidance,
     active_entities: memory.active_entities,
     open_decisions: memory.open_decisions,
     last_error: memory.last_error,
@@ -2355,13 +2463,22 @@ const compactConversationTimelineForSideChannel = (conversation = {}, maxItems =
     return pruneByLimit(chronological, maxItems).map((message, index) => {
         const role = normalizeConversationRoleForSideChannel(message.role || message.type);
         const content = String(message.content || message.text || message.message || '');
+        const at = message.at || message.timestamp || message.created_at || message.createdAt;
+        const preview = role === 'system' ? '[system context hidden]' : truncate(content, 180);
         return cleanContextValue({
             index,
             role,
             speaker: role,
-            at: message.at || message.timestamp || message.created_at || message.createdAt,
+            at,
             chars: content.length,
-            content: truncate(content, 700),
+            preview,
+            content: preview,
+            message: {
+                role,
+                at,
+                content: role === 'system' ? '[system context hidden]' : truncate(content, 2000),
+                truncated: content.length > 2000,
+            },
         });
     });
 };
@@ -2427,6 +2544,7 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
         summary.payloadFormat = parsed.payloadFormat;
         summary.options = cleanContextValue(parsed.options || {});
         summary.intent = parsed.observations?.inferred_intent?.label || parsed.workingMemory?.last_user_intent || parsed.decisionState?.current_intent || undefined;
+        const parsedTurnBrief = parsed.turnBrief || parsed.turn_brief || undefined;
         summary.currentUserMessage = conversation.current_user_message ? truncate(conversation.current_user_message, 180) : undefined;
         summary.recentMessages = Array.isArray(conversation.conversation_history_chronological) ? conversation.conversation_history_chronological.length : undefined;
         summary.conversationTimeline = compactConversationTimelineForSideChannel(conversation, 12);
@@ -2442,6 +2560,16 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
                 at: tools.last_successful_tool.at,
             }
             : (toolItems.length ? { name: toolItems[toolItems.length - 1].name, at: toolItems[toolItems.length - 1].at } : undefined);
+        summary.turnBrief = typeof parsedTurnBrief === 'string'
+            ? cleanContextValue({
+                brief: parsedTurnBrief,
+                intent: summary.intent,
+                currentUserMessage: summary.currentUserMessage,
+                messages: summary.recentMessages,
+                toolCount: summary.toolCount,
+                lastTool: summary.lastTool,
+            })
+            : parsedTurnBrief;
         summary.counts = cleanContextValue({
             conversationMessages: Array.isArray(conversation.conversation_history_chronological) ? conversation.conversation_history_chronological.length : undefined,
             userMessages: Array.isArray(conversation.all_user_messages_chronological) ? conversation.all_user_messages_chronological.length : undefined,
@@ -2463,6 +2591,7 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
             memoryCompression: Boolean(parsed.memoryCompression),
             operationalState: Boolean(parsed.operationalState),
             actionLedger: Array.isArray(parsed.actionLedger),
+            turnBrief: Boolean(parsed.turnBrief || parsed.turn_brief),
             memoryAudit: Boolean(memoryAudit && Object.keys(memoryAudit).length),
             entityTimeline: Array.isArray(parsed.entityTimeline),
             vectorMemories: Array.isArray(parsed.vectorMemories),
@@ -2472,10 +2601,16 @@ const summarizeMemoryMessagesForSideChannel = (messages = []) => {
         });
         summary.workingMemory = cleanContextValue({
             currentGoal: parsed.workingMemory?.current_goal,
+            currentGoalReason: parsed.workingMemory?.current_goal_reason,
             currentTask: parsed.workingMemory?.current_task,
             nextExpectedAction: parsed.workingMemory?.next_expected_action,
             lastUserIntent: parsed.workingMemory?.last_user_intent,
             lastUserMessage: parsed.workingMemory?.last_user_message ? truncate(parsed.workingMemory.last_user_message, 220) : undefined,
+            conversation: parsed.workingMemory?.conversation_digest,
+            tools: parsed.workingMemory?.tool_digest,
+            turnFlags: parsed.workingMemory?.turn_flags,
+            contextSources: parsed.workingMemory?.context_sources,
+            agentGuidance: parsed.workingMemory?.agent_guidance,
         });
         summary.decisionState = cleanContextValue({
             currentIntent: parsed.decisionState?.current_intent,
@@ -2582,6 +2717,12 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
             value: currentTurnFocus,
         });
     }
+    const turnBrief = buildTurnBriefForAgent({ query, recentMessages, toolHistory, operationalState, workingMemory, decisionState, diagnostics });
+    sections.push({
+        section: 'turn_brief',
+        title: 'Turn brief',
+        value: turnBrief,
+    });
     const actionDirective = buildActionDirective({ workingMemory, operationalState });
     if (actionDirective) {
         sections.push({
@@ -2679,6 +2820,10 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
         const directive = sectionValue('action_directive');
         const inferredIntent = deriveUserIntentObservation({ query, workingMemory, decisionState, recentMessages });
         const memoryAudit = sectionValue('memory_audit');
+        const compactSummary = cleanContextValue({
+            vector_facts: vectorFacts,
+            slm: hasToolLedger ? undefined : slmSummary,
+        });
         const minimalState = cleanContextValue({
             next_expected_action: directive ? undefined : workingMemory.next_expected_action,
             context_quality_score: diagnostics?.contextHealth?.quality_score || diagnostics?.quality_score,
@@ -2697,13 +2842,11 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
                 next_expected_action: directive.next_expected_action,
                 instruction: directive.instruction,
             }) : undefined,
+            turnBrief: compactTurnBriefForAgent(sectionValue('turn_brief')),
             observations: {
                 inferred_intent: inferredIntent,
             },
-            summary: {
-                vector_facts: vectorFacts,
-                slm: hasToolLedger ? undefined : slmSummary,
-            },
+            summary: Object.keys(compactSummary).length ? compactSummary : undefined,
             state: minimalState,
             workingMemory: sectionValue('working_memory'),
             decisionState: sectionValue('decision_state'),
@@ -4340,6 +4483,7 @@ exports.__private = {
     buildContextMessages,
     inferToolGuard,
     inferUserIntent,
+    buildTurnBriefForAgent,
     deriveUserIntentObservation,
     deriveWorkingMemory,
     deriveDecisionState,

package/package.json

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