n8n-nodes-tembory 1.0.28 → 1.0.30

package/README.md

@@ -2,7 +2,19 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.0.28`.
+Versao atual: `1.0.30`.
+
+## 1.0.30
+
+- Adiciona `Action directive` quando a memoria conclui que uma tool deve ser chamada no turno atual.
+- Torna `next_expected_action` mais coercitivo para agenda: usa `MUST call ...` e proibe respostas como "se quiser/posso" no lugar da tool obrigatoria.
+- Reduz o peso instrucional de `first_user_message`; o foco passa a ser mensagem atual, mensagem anterior e transcript cronologico recente.
+
+## 1.0.29
+
+- Considera disponibilidade recente no transcript como contexto operacional valido quando `tool_history` ainda nao foi recuperado no turno.
+- Evita repetir `agenda_consultar_disponibilidade` apos o agente ja ter respondido vagas no historico recente.
+- Direciona selecao de horario como "quero dia 13" para `agenda_pre_reservar_horario` quando ha vagas recentes, mesmo sem marker estruturado no contexto atual.
 
 ## 1.0.28
 

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

@@ -408,11 +408,32 @@ const safeParseToolPayload = (value) => {
 const compactToolPayload = (value) => truncate(typeof value === 'string' ? value : safeStringify(value), 900);
 const maybeToolResult = (tool, includeResults = true) => includeResults === false ? undefined : compactToolPayload(safeParseToolPayload(tool === null || tool === void 0 ? void 0 : tool.result));
 const containsSelectedSlot = (text = '') => /\b(?:às|as|das|para)?\s*\d{1,2}(?::\d{2}|h\d{0,2})?\b/i.test(String(text || '')) || /\b\d{1,2}\/\d{1,2}(?:\/\d{2,4})?\b/.test(String(text || ''));
+const availabilityFromRecentMessages = (recentMessages = []) => {
+    const messages = Array.isArray(recentMessages) ? recentMessages : [];
+    const candidates = [...messages].reverse().filter((message) => {
+        const role = String(message.role || '').toLowerCase();
+        const text = String(message.content || message.text || message.memory || '');
+        if (role && role !== 'assistant' && role !== 'ai' && role !== 'system')
+            return false;
+        return /\b(?:tem|tenho|há|ha)\s+vagas?\b|\bop[cç][oõ]es?\s+dispon[ií]veis\b|\bavailable_slots\b/i.test(text)
+            && (/\b\d{1,2}\/\d{1,2}(?:\/\d{2,4})?\b/.test(text) || /\b\d{1,2}:\d{2}\b/.test(text));
+    });
+    const latest = candidates[0];
+    if (!latest)
+        return null;
+    return {
+        text: truncate(String(latest.content || latest.text || latest.memory || ''), 900),
+        at: latest.at || latest.created_at || latest.createdAt || nowIso(),
+        source: latest.source || 'recent_message',
+    };
+};
 const deriveOperationalState = (toolHistory = [], profileFacts = {}, recentMessages = [], includeResults = true) => {
     const tools = Array.isArray(toolHistory) ? toolHistory : [];
     const successfulTools = tools.filter((tool) => tool.ok !== false);
     const byName = (name) => successfulTools.filter((tool) => tool.name === name);
     const availability = byName('agenda_consultar_disponibilidade');
+    const recentAvailability = availability.length ? null : availabilityFromRecentMessages(recentMessages);
+    const hasAvailability = availability.length > 0 || Boolean(recentAvailability);
     const reservations = byName('agenda_pre_reservar_horario');
     const confirmations = byName('agenda_confirmar_agendamento');
     const lastTool = tools[tools.length - 1] || null;
@@ -420,18 +441,18 @@ const deriveOperationalState = (toolHistory = [], profileFacts = {}, recentMessa
     const lastConfirmation = confirmations[confirmations.length - 1] || null;
     const hasPendingReservation = Boolean(lastReservation && (!lastConfirmation || String(lastReservation.at || '') > String(lastConfirmation.at || '')));
     const blockedWithoutContext = [];
-    if (!availability.length)
+    if (!hasAvailability)
         blockedWithoutContext.push('agenda_pre_reservar_horario');
     if (!reservations.length)
         blockedWithoutContext.push('agenda_confirmar_agendamento');
     const guidance = [];
-    if (!availability.length)
+    if (!hasAvailability)
         guidance.push('No availability result is known for this session; consult availability before reserving or confirming.');
     else if (hasPendingReservation)
         guidance.push('A pre-reservation exists after the latest confirmation; confirmation can use the latest pre-reservation context.');
     else if (lastConfirmation)
         guidance.push('The latest reservation appears confirmed; do not confirm again unless the user explicitly asks to repeat or change it.');
-    else if (availability.length)
+    else if (hasAvailability)
         guidance.push('Availability is known; if the user chooses one listed slot, reserve without repeating availability.');
     return {
         profile_complete: Boolean(profileFacts && profileFacts.name && profileFacts.company && profileFacts.email && profileFacts.phone),
@@ -445,11 +466,12 @@ const deriveOperationalState = (toolHistory = [], profileFacts = {}, recentMessa
             agenda_confirmar_agendamento: confirmations.length,
         },
         agenda_state: {
-            has_availability: availability.length > 0,
+            has_availability: hasAvailability,
             has_pre_reservation: reservations.length > 0,
             has_confirmation: confirmations.length > 0,
             has_pending_pre_reservation: hasPendingReservation,
-            latest_availability_result: availability.length ? maybeToolResult(availability[availability.length - 1], includeResults) : null,
+            latest_availability_result: availability.length ? maybeToolResult(availability[availability.length - 1], includeResults) : (recentAvailability && includeResults !== false ? recentAvailability.text : null),
+            latest_availability_source: availability.length ? 'tool_history' : (recentAvailability ? recentAvailability.source : null),
             latest_pre_reservation_result: lastReservation ? maybeToolResult(lastReservation, includeResults) : null,
             latest_confirmation_result: lastConfirmation ? maybeToolResult(lastConfirmation, includeResults) : null,
         },
@@ -1284,7 +1306,7 @@ const buildConversationFrame = ({ query = '', recentMessages = [], workingMemory
             .filter((msg) => normalizeIntentText(msg.content).trim() !== normalizedQuery)
             .slice(0, 5)
             .map((msg) => ({ role: msg.role, content: truncate(msg.content, 500), at: msg.at })),
-        instruction: 'This is the authoritative short-term conversation frame. If the user asks about first/current/previous/last client messages or what they already said, answer from first_user_message/current_user_message/previous_user_message/conversation_history_chronological/all_user_messages_chronological before using vector memories, summaries, operational state, or tool history.',
+        instruction: 'This is the authoritative short-term conversation frame. If the user asks about current/previous/last client messages or what they already said, answer from current_user_message/previous_user_message/conversation_history_chronological/all_user_messages_chronological before using vector memories, summaries, operational state, or tool history.',
     });
     if (!previousUserMessage)
         frame.previous_user_message = null;
@@ -1324,13 +1346,33 @@ const buildCurrentTurnFocus = ({ query = '', recentMessages = [], operationalSta
             has_availability: Boolean(agenda.has_availability),
         } : undefined,
         instruction: recall
-            ? 'Answer the user meta-question from first_user_message/previous_user_message/recent_user_messages. Do not answer with agenda availability unless the user asks for availability.'
+            ? 'Answer the user meta-question from previous_user_message/recent_user_messages and the chronological transcript. Do not answer with agenda availability unless the user asks for availability.'
             : 'Answer whether the appointment/reservation is already scheduled using agenda_status. Do not offer availability as the main answer unless there is no schedule/reservation state.',
     });
     if (!previousUserMessage)
         focus.previous_user_message = null;
     return focus;
 };
+const buildActionDirective = ({ workingMemory = {}, operationalState = {} }) => {
+    const next = String((workingMemory || {}).next_expected_action || '');
+    const match = /\bagenda_(consultar_disponibilidade|pre_reservar_horario|confirmar_agendamento)\b/.exec(next);
+    if (!match || !/\bcall\b|\bMUST\b/i.test(next))
+        return null;
+    const tool = match[0];
+    const agenda = (operationalState || {}).agenda_state || {};
+    return cleanContextValue({
+        required_tool: tool,
+        next_expected_action: next,
+        agenda_state: {
+            has_availability: Boolean(agenda.has_availability),
+            latest_availability_source: agenda.latest_availability_source,
+            has_pre_reservation: Boolean(agenda.has_pre_reservation),
+            has_pending_pre_reservation: Boolean(agenda.has_pending_pre_reservation),
+            has_confirmation: Boolean(agenda.has_confirmation),
+        },
+        instruction: `You MUST call ${tool} now. Do not answer with "posso", "se quiser", "já posso" or ask for the same confirmation instead of calling the required tool. Only skip this tool if it is explicitly blocked in Tool guard.`,
+    });
+};
 const inferToolGuard = ({ query, recentMessages, toolHistory, vectorMemories }) => {
     const text = normalizeIntentText(query);
     const names = new Set((toolHistory || []).map((tool) => String(tool.name || '')));
@@ -1386,24 +1428,26 @@ const deriveNextExpectedAction = (intent, operationalState = {}) => {
     const agenda = operationalState.agenda_state || {};
     if (intent === 'affirm') {
         if (agenda.has_pending_pre_reservation)
-            return 'call agenda_confirmar_agendamento now; do not ask the same confirmation question again';
+            return 'MUST call agenda_confirmar_agendamento now; do not ask the same confirmation question again';
         if (agenda.has_availability)
-            return 'call agenda_pre_reservar_horario now using the selected or latest discussed slot; do not ask again';
+            return 'MUST call agenda_pre_reservar_horario now using the selected or latest discussed slot; do not ask again';
         return 'call agenda_consultar_disponibilidade before reserving';
     }
     if (intent === 'confirm') {
         if (agenda.has_pending_pre_reservation)
-            return 'call agenda_confirmar_agendamento now using the latest pre-reservation context; do not ask again';
-        return 'do not call agenda_confirmar_agendamento; call agenda_pre_reservar_horario first if a selected slot and availability are known, otherwise call agenda_consultar_disponibilidade';
+            return 'MUST call agenda_confirmar_agendamento now using the latest pre-reservation context; do not ask again';
+        if (agenda.has_availability)
+            return 'MUST call agenda_pre_reservar_horario first using the selected or latest discussed slot; do not ask for permission again';
+        return 'do not call agenda_confirmar_agendamento; call agenda_consultar_disponibilidade first because no availability is known';
     }
     if (intent === 'select_slot') {
         if (agenda.has_availability)
-            return 'call agenda_pre_reservar_horario now using the selected slot; do not ask for confirmation before pre-reserving';
+            return 'MUST call agenda_pre_reservar_horario now using the selected slot; do not ask for confirmation before pre-reserving';
         return 'call agenda_consultar_disponibilidade before pre-reserving';
     }
     if (intent === 'pre_reserve') {
         if (agenda.has_availability)
-            return 'call agenda_pre_reservar_horario now using one of the known available slots';
+            return 'MUST call agenda_pre_reservar_horario now using one of the known available slots';
         return 'call agenda_consultar_disponibilidade before pre-reserving';
     }
     if (intent === 'check_availability')
@@ -1988,8 +2032,8 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
     sections.push({
         section: 'conversation_frame',
         title: 'Conversation frame',
-        value: buildConversationFrame({ query, recentMessages, workingMemory }),
-    });
+            value: buildConversationFrame({ query, recentMessages, workingMemory }),
+        });
     const currentTurnFocus = buildCurrentTurnFocus({ query, recentMessages, operationalState, workingMemory });
     if (currentTurnFocus) {
         sections.push({
@@ -1998,6 +2042,14 @@ const buildContextMessages = ({ payloadFormat, query, userId, profileFacts, work
             value: currentTurnFocus,
         });
     }
+    const actionDirective = buildActionDirective({ workingMemory, operationalState });
+    if (actionDirective) {
+        sections.push({
+            section: 'action_directive',
+            title: 'Action directive',
+            value: actionDirective,
+        });
+    }
     if (compactForAgent) {
         if (includeSummary) {
             const summary = compactVectorMemoriesForAgent(vectorMemories, toolHistory, Number(adv.summaryMaxFacts || 3));
@@ -3638,6 +3690,8 @@ exports.__private = {
     explicitToolHistoryItemsFromMemory,
     toolHistoryFromMemory,
     cleanAssistantTranscriptText,
+    availabilityFromRecentMessages,
+    buildActionDirective,
     recentMessageFromMemory,
     previousUserFallbackFromWorkingMemory,
     firstUserMessageFromConversation,

package/package.json

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