n8n-nodes-tembory 1.2.1 → 1.3.0

package/README.md

@@ -2,7 +2,20 @@
 
 Node de memoria operacional da Tembory para agentes de IA no n8n.
 
-Versao atual: `1.2.1`.
+Versao atual: `1.3.0`.
+
+## 1.3.0
+
+- Adiciona um segundo node no pacote: `Tembory Agent Memory`, com internal name `temboryAgentMemory`.
+- Mantem o node atual `Tembory` com internal name `temboryMemory`, sem migracao automatica de workflows existentes.
+- O novo node nasce como caminho opt in para a experiencia v2: menos campos visiveis, controles avancados recolhidos e base para `tembory.visual.v2`.
+- Reaproveita o runtime estavel de memoria, captura de tools e persistencia enquanto a timeline v2 e a `slmAnalysis` incremental sao implementadas em cortes posteriores.
+
+## 1.2.2
+
+- No `Modo Simples Recomendado`, remove campos visuais redundantes do side channel: `toolEvents`, `toolNames` e `savedMessages`.
+- Mantem as mesmas informacoes em `toolLog`, `conversation`, `conversationTimeline`, `userInput`, `assistantOutput` e `toolCapture`.
+- O contexto interno do Agent e a persistencia das tools nao mudam; a alteracao e apenas na organizacao do JSON visual do n8n.
 
 ## 1.2.1
 

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

@@ -1583,7 +1583,8 @@ const applyOperationalPreset = (advanced = {}) => {
         },
     };
     const presetKey = preset === 'lab' ? 'diagnostic' : preset;
-    const resolved = { ...(presets[presetKey] || {}), ...advanced, ...simpleOverrides, configurationMode };
+    const resolved = { ...(presets[presetKey] || {}), ...advanced, ...simpleOverrides, ...(advanced.__topLevelOverrides || {}), configurationMode };
+    delete resolved.__topLevelOverrides;
     if (/^production/i.test(presetKey)) {
         resolved.compactForAgent = true;
         resolved.compactStateSections = true;
@@ -1618,6 +1619,7 @@ const flattenAdvancedGroups = (groups = {}) => {
 const readAdvancedOptions = (ctx, itemIndex) => {
     let legacy = {};
     let grouped = {};
+    const topLevelOverrides = {};
     try {
         legacy = ctx.getNodeParameter('advanced', itemIndex, {}) || {};
     }
@@ -1631,7 +1633,30 @@ const readAdvancedOptions = (ctx, itemIndex) => {
         configurationMode = String(ctx.getNodeParameter('configurationMode', itemIndex, 'simple') || 'simple');
     }
     catch { }
-    return { ...legacy, ...grouped, configurationMode };
+    try {
+        if (ctx.getNodeParameter('showAdvanced', itemIndex, false))
+            configurationMode = 'advanced';
+    }
+    catch { }
+    const readTopLevelOverride = (parameterName, optionName = parameterName) => {
+        try {
+            const value = ctx.getNodeParameter(parameterName, itemIndex, undefined);
+            if (value !== undefined && value !== '')
+                topLevelOverrides[optionName] = value;
+        }
+        catch { }
+    };
+    readTopLevelOverride('contextMaxChars');
+    readTopLevelOverride('recentMessagesLastN');
+    try {
+        const debugVisualOutput = ctx.getNodeParameter('debugVisualOutput', itemIndex, undefined);
+        if (debugVisualOutput !== undefined) {
+            topLevelOverrides.includeDiagnostics = Boolean(debugVisualOutput);
+            topLevelOverrides.includeContextHealth = Boolean(debugVisualOutput);
+        }
+    }
+    catch { }
+    return { ...legacy, ...grouped, ...topLevelOverrides, __topLevelOverrides: topLevelOverrides, configurationMode };
 };
 const pruneByLimit = (items, limit) => items.slice(Math.max(0, items.length - Math.max(1, Number(limit) || 1)));
 const dedupeRecentMessages = (items) => {
@@ -3553,6 +3578,15 @@ const compactMemoryEventPayload = (payload = {}) => {
     }
     return keepVisibleToolLogArrays(compact);
 };
+const compactVisualSummaryForMode = (summary = {}, configurationMode = 'advanced') => {
+    const compact = { ...(summary || {}) };
+    if (String(configurationMode || 'advanced') !== 'simple')
+        return compact;
+    delete compact.toolNames;
+    delete compact.toolEvents;
+    delete compact.savedMessages;
+    return compact;
+};
 const compactLastSaveForSideChannel = (lastSave = {}) => cleanContextValue({
     saved: lastSave.saved,
     status: lastSave.status,
@@ -4543,6 +4577,7 @@ class TemboryMemory {
     // memory-like object, not raw JSON, so expose the LangChain memory contract.
     async supplyData(itemIndex) {
         const memoryKey = resolveRuntimeMemoryKey(this, itemIndex);
+        const visualMode = applyOperationalPreset(readAdvancedOptions(this, itemIndex)).configurationMode;
         let currentMessages = [];
         const loadCache = new Map();
         const recordMemoryEvent = (action, payload = {}, error) => {
@@ -4553,7 +4588,7 @@ class TemboryMemory {
                 this.addOutputData(n8n_workflow_1.NodeConnectionTypes.AiMemory, index, error);
                 return;
             }
-            const compactPayload = compactMemoryEventPayload(payload);
+            const compactPayload = compactVisualSummaryForMode(compactMemoryEventPayload(payload), visualMode);
             this.addOutputData(n8n_workflow_1.NodeConnectionTypes.AiMemory, index, [
                 [{ json: { action, visualSchema: VISUAL_SCHEMA_VERSION, memorySummary: compactPayload } }],
             ]);
@@ -5893,7 +5928,7 @@ class TemboryMemory {
                 action: 'loadMemoryVariables',
                 visualSchema: VISUAL_SCHEMA_VERSION,
                 messages: Array.isArray(payload) ? payload.length : 0,
-                memorySummary: summarizeMemoryMessagesForSideChannel(payload),
+                memorySummary: compactVisualSummaryForMode(summarizeMemoryMessagesForSideChannel(payload), adv.configurationMode),
             };
             if (adv.includeDiagnostics === true) {
                 json.contextMessages = payload;
@@ -5976,6 +6011,7 @@ exports.__private = {
     isConversationEchoMemory,
     compactOperationalStateForAgent,
     compactSaveAuditForAgent,
+    compactVisualSummaryForMode,
     activeSummaryIsFresh,
     readActiveSummary,
     writeActiveSummary,

package/dist/nodes/TemboryAgentMemory/TemboryAgentMemory.node.d.ts

@@ -0,0 +1,4 @@
+import { TemboryMemory } from '../Tembory/TemboryMemory.node';
+export declare class TemboryAgentMemory extends TemboryMemory {
+    constructor();
+}

package/dist/nodes/TemboryAgentMemory/TemboryAgentMemory.node.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemboryAgentMemory = void 0;
+const TemboryMemory_node_1 = require("../Tembory/TemboryMemory.node");
+const deepClone = (value) => {
+    if (Array.isArray(value))
+        return value.map(deepClone);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [key, child] of Object.entries(value))
+            out[key] = deepClone(child);
+        return out;
+    }
+    return value;
+};
+const displayWhenAdvanced = {
+    show: {
+        showAdvanced: [true],
+    },
+};
+const cloneProperty = (properties, name) => {
+    const property = properties.find((item) => item.name === name);
+    if (!property)
+        throw new Error(`Missing base Tembory property: ${name}`);
+    return deepClone(property);
+};
+const advancedOnly = (property) => ({
+    ...property,
+    displayOptions: displayWhenAdvanced,
+});
+const buildAgentMemoryDescription = () => {
+    const base = new TemboryMemory_node_1.TemboryMemory().description;
+    const baseProperties = base.properties || [];
+    const threadId = cloneProperty(baseProperties, 'threadId');
+    const project = cloneProperty(baseProperties, 'project');
+    const query = cloneProperty(baseProperties, 'query');
+    const retrievalMode = advancedOnly(cloneProperty(baseProperties, 'retrievalMode'));
+    const memoryKey = advancedOnly(cloneProperty(baseProperties, 'memoryKey'));
+    const payloadFormat = advancedOnly(cloneProperty(baseProperties, 'payloadFormat'));
+    const advancedGroups = advancedOnly(cloneProperty(baseProperties, 'advancedGroups'));
+    retrievalMode.description = 'Opcional. No v2 recomendado, o Tembory usa contexto operacional estruturado por padrão.';
+    advancedGroups.displayName = 'Configuração Avançada Tembory';
+    advancedGroups.description = 'Controles brutos para debug e casos avançados. O uso recomendado já ativa timeline, toolLog, SLM analysis, dedupe e retenção segura.';
+    return {
+        ...deepClone(base),
+        displayName: 'Tembory Agent Memory',
+        name: 'temboryAgentMemory',
+        version: 1,
+        description: 'Recommended Tembory memory for n8n AI Agents with stable node identity for the v2 experience',
+        defaults: {
+            name: 'Tembory Agent Memory',
+        },
+        codex: {
+            ...(base.codex || {}),
+            categories: ['AI', 'Memory'],
+            subcategories: {
+                AI: ['Memory', 'Agents & LLMs'],
+                Memory: ['AI Memory'],
+            },
+        },
+        properties: [
+            threadId,
+            project,
+            query,
+            {
+                displayName: 'Context Budget',
+                name: 'contextMaxChars',
+                type: 'number',
+                default: 20000,
+                description: 'Máximo aproximado de caracteres do contexto enviado ao agente. No v2 recomendado, isso substitui o toggle avançado equivalente.',
+            },
+            {
+                displayName: 'Recent Messages',
+                name: 'recentMessagesLastN',
+                type: 'number',
+                default: 30,
+                description: 'Quantidade de mensagens recentes consideradas na timeline e no contexto operacional.',
+            },
+            {
+                displayName: 'Debug Visual Output',
+                name: 'debugVisualOutput',
+                type: 'boolean',
+                default: true,
+                description: 'Inclui mais material visual e diagnóstico no output de execução. A memória operacional continua preservada independentemente deste valor.',
+            },
+            {
+                displayName: 'Advanced Settings',
+                name: 'showAdvanced',
+                type: 'boolean',
+                default: false,
+                description: 'Mostra controles brutos de memória, auditoria, TTL e payload. Use apenas para debug ou ajuste fino.',
+            },
+            retrievalMode,
+            memoryKey,
+            payloadFormat,
+            advancedGroups,
+        ],
+    };
+};
+class TemboryAgentMemory extends TemboryMemory_node_1.TemboryMemory {
+    constructor() {
+        super();
+        this.description = buildAgentMemoryDescription();
+    }
+}
+exports.TemboryAgentMemory = TemboryAgentMemory;

package/dist/nodes/TemboryAgentMemory/tembory-brain.svg

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" 
+	 viewBox="0 0 460 460" xml:space="preserve">
+<g>
+	<path style="fill:#FF926E;" d="M230,203.06h-29.375v50h-31.25v-50H85.04v-30H120V133.1h30v39.96h109.375v50h31.25v-50h84.335v-30
+		H340V103.1h-30v39.96h-80v-36h-49.96v-30H230V0c-23.02,0-42.99,12.97-53.06,31.99c-18.22-11.44-42.01-12.68-61.94-1.18
+		C95.07,42.32,84.25,63.54,85.04,85.04C63.54,84.25,42.32,95.07,30.81,115c-11.5,19.93-10.26,43.72,1.18,61.94
+		C12.97,187.01,0,206.98,0,230s12.97,42.99,31.99,53.06H230V203.06z"/>
+	<path style="fill:#F46A1A;" d="M428.01,176.94c11.44-18.22,12.68-42.01,1.18-61.94c-11.51-19.93-32.73-30.75-54.23-29.96
+		c0.79-21.5-10.03-42.72-29.96-54.23c-19.93-11.5-43.72-10.26-61.94,1.18C272.99,12.97,253.02,0,230,0v77.06h50.04v30H230v36h80
+		V103.1h30v39.96h34.96v30h-84.335v50h-31.25v-50H230v110h198.01C447.03,272.99,460,253.02,460,230S447.03,187.01,428.01,176.94z
+		 M393.51,253.06h-30v-30h30V253.06z"/>
+	<path style="fill:#FFB76E;" d="M329.01,283.06h-99c0,47.828,33.909,87.729,79,96.979V460h40v-79.961
+		c-6.459,1.325-13.148,2.021-20,2.021V283.06z"/>
+	<rect x="180.04" y="77.06" style="fill:#FFB76E;" width="50" height="30"/>
+	<polygon style="fill:#FFB76E;" points="150,133.1 120,133.1 120,173.06 85.04,173.06 85.04,203.06 169.375,203.06 169.375,253.06 
+		200.625,253.06 200.625,203.06 230,203.06 230,173.06 150,173.06 	"/>
+	<rect x="230.04" y="77.06" style="fill:#FF926E;" width="50" height="30"/>
+	<rect x="363.51" y="223.06" style="fill:#FF926E;" width="30" height="30"/>
+	<path style="fill:#FF926E;" d="M329.01,382.06c6.852,0,13.54-0.697,20-2.021c45.091-9.249,79-49.15,79-96.979h-99V382.06z"/>
+</g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-tembory",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Tembory node for n8n AI Agents with operational memory, tool history and decision state",
   "license": "MIT",
   "homepage": "https://tembory.com",
@@ -17,7 +17,7 @@
   },
   "main": "index.js",
   "scripts": {
-    "build": "node --check index.js && node --check dist/credentials/TemboryApi.credentials.js && node --check dist/nodes/Tembory/GenericFunctions.js && node --check dist/nodes/Tembory/TemboryMemory.node.js",
+    "build": "node --check index.js && node --check dist/credentials/TemboryApi.credentials.js && node --check dist/nodes/Tembory/GenericFunctions.js && node --check dist/nodes/Tembory/TemboryMemory.node.js && node --check dist/nodes/TemboryAgentMemory/TemboryAgentMemory.node.js",
     "dev": "tsc --watch",
     "format": "prettier nodes credentials --write",
     "lint": "tslint -p tsconfig.json -c tslint.json",
@@ -41,7 +41,8 @@
       "dist/credentials/TemboryApi.credentials.js"
     ],
     "nodes": [
-      "dist/nodes/Tembory/TemboryMemory.node.js"
+      "dist/nodes/Tembory/TemboryMemory.node.js",
+      "dist/nodes/TemboryAgentMemory/TemboryAgentMemory.node.js"
     ]
   },
   "keywords": [