n8n-nodes-elefaibrain-memory-lab 0.1.0-lab.0

package/README.md

@@ -0,0 +1,65 @@
+# n8n-nodes-elefaibrain-memory-lab
+
+Fork de laboratorio para testar o node de memoria do ElefAI Brain no n8n sem mexer no pacote local antigo em `elefaibrain-project/node/@elefai/n8n-nodes-elefaibrain`.
+
+## Origem
+
+Este pacote foi reconstruido a partir do tarball publico `@surreal7/n8n-nodes-mem0@1.3.7`, porque o pacote local atual estava incompleto e continha apenas `index.js`/`index.d.ts` vazios.
+
+## Objetivo do fork
+
+- Manter um pacote instalavel no n8n para testes.
+- Renomear o node de memoria para `ElefAI Brain Memory Lab`.
+- Expor a saida `ai_memory` para conectar no AI Agent.
+- Expor entradas experimentais `ai_languageModel` e `ai_embedding` para validar o desenho visual do node no canvas do n8n.
+- Preparar a evolucao em que o LLM e o embedder serao fornecidos pelo proprio n8n do cliente, deixando o custo de tokens na conta conectada pelo cliente.
+
+## Estado atual
+
+Este fork agora entrega um conector de Chat Memory pela porta `ai_memory`, com:
+
+- `loadMemoryVariables()` para carregar memorias do ElefAI Brain/Mem0.
+- `saveContext()` para persistir pares usuario/assistente no Mem0.
+- entradas `ai_languageModel` e `ai_embedding` no canvas para validar o formato de cluster com modelos conectados no n8n.
+
+As entradas de modelo ainda sao tratadas como contrato de interface. A proxima etapa funcional e usar esses modelos conectados para extracao/sumarizacao/embedding antes de enviar ao backend, ou criar endpoints ElefAI no Mem0 para aceitar fatos/vetores pre-processados.
+
+## Teste local
+
+```bash
+cd elefaibrain-project/node-forks/n8n-nodes-elefaibrain-memory-lab
+npm pack
+```
+
+Depois instale o `.tgz` gerado no ambiente de teste do n8n.
+
+## Instalacao via npm publico
+
+No n8n Community Nodes, use:
+
+```text
+n8n-nodes-elefaibrain-memory-lab
+```
+
+Ou via terminal:
+
+```bash
+npm install n8n-nodes-elefaibrain-memory-lab@0.1.0-lab.0
+```
+
+## Instalacao via GitLab Package Registry
+
+O pacote esta publicado no GitLab Package Registry do projeto:
+
+```bash
+npm install @elefai/n8n-nodes-elefaibrain-memory-lab@0.1.0-lab.0 \
+  --registry https://gitlab.elefai.com.br/api/v4/projects/53/packages/npm/
+```
+
+Em ambiente privado, configure antes um token com permissao de leitura de pacotes:
+
+```bash
+npm config set @elefai:registry https://gitlab.elefai.com.br/api/v4/projects/53/packages/npm/
+npm config set //gitlab.elefai.com.br/api/v4/projects/53/packages/npm/:_authToken SEU_TOKEN
+npm install @elefai/n8n-nodes-elefaibrain-memory-lab@0.1.0-lab.0
+```

package/dist/credentials/Mem0Api.credentials.d.ts

@@ -0,0 +1,10 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class Mem0Api implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=Mem0Api.credentials.d.ts.map

package/dist/credentials/Mem0Api.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mem0Api.credentials.d.ts","sourceRoot":"","sources":["../../credentials/Mem0Api.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,OAAQ,YAAW,eAAe;IAC9C,IAAI,SAAa;IACjB,WAAW,SAAc;IACzB,gBAAgB,SAAwC;IACxD,UAAU,EAAE,eAAe,EAAE,CAwB3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAM1B;CACF"}

package/dist/credentials/Mem0Api.credentials.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mem0Api = void 0;
+class Mem0Api {
+    constructor() {
+        this.name = 'mem0Api';
+        this.displayName = 'Mem0 API';
+        this.documentationUrl = 'https://docs.mem0.ai/api-reference';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Mem0 API key. Get it from https://app.mem0.ai/dashboard/api-keys.',
+            },
+            {
+                displayName: 'Organization ID',
+                name: 'orgId',
+                type: 'string',
+                default: '',
+                description: 'Optional: Your Mem0 Organization ID',
+            },
+            {
+                displayName: 'Project ID',
+                name: 'projectId',
+                type: 'string',
+                default: '',
+                description: 'Optional: Your Mem0 Project ID',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Authorization': '=Token {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://api.mem0.ai',
+                url: '/v1/entities/',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.Mem0Api = Mem0Api;
+//# sourceMappingURL=Mem0Api.credentials.js.map

package/dist/credentials/Mem0Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mem0Api.credentials.js","sourceRoot":"","sources":["../../credentials/Mem0Api.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,OAAO;IAApB;QACC,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,UAAU,CAAC;QACzB,qBAAgB,GAAG,oCAAoC,CAAC;QACxD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wEAAwE;aACrF;YACD;gBACC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,qCAAqC;aAClD;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,gCAAgC;aAC7C;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,eAAe,EAAE,gCAAgC;iBACjD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,qBAAqB;gBAC9B,GAAG,EAAE,eAAe;gBACpB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA9CD,0BA8CC"}

package/dist/credentials/Mem0SelfHostedApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class Mem0SelfHostedApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=Mem0SelfHostedApi.credentials.d.ts.map

package/dist/credentials/Mem0SelfHostedApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mem0SelfHostedApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/Mem0SelfHostedApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,iBAAkB,YAAW,eAAe;IACxD,IAAI,SAAuB;IAC3B,WAAW,SAA0B;IACrC,gBAAgB,SAAsC;IACtD,UAAU,EAAE,eAAe,EAAE,CAiB3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAM1B;CACF"}

package/dist/credentials/Mem0SelfHostedApi.credentials.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mem0SelfHostedApi = void 0;
+class Mem0SelfHostedApi {
+    constructor() {
+        this.name = 'mem0SelfHostedApi';
+        this.displayName = 'Mem0 Self-Hosted API';
+        this.documentationUrl = 'https://docs.mem0.ai/open-source';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'http://localhost:8000',
+                required: true,
+                description: 'The base URL of your self-hosted Mem0 instance',
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'API key if authentication enabled',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Authorization': '={{$credentials.apiKey ? "Token " + $credentials.apiKey : ""}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/entities/',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.Mem0SelfHostedApi = Mem0SelfHostedApi;
+//# sourceMappingURL=Mem0SelfHostedApi.credentials.js.map

package/dist/credentials/Mem0SelfHostedApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mem0SelfHostedApi.credentials.js","sourceRoot":"","sources":["../../credentials/Mem0SelfHostedApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,iBAAiB;IAA9B;QACC,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,sBAAsB,CAAC;QACrC,qBAAgB,GAAG,kCAAkC,CAAC;QACtD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,gDAAgD;aAC7D;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,mCAAmC;aAChD;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,eAAe,EAAE,gEAAgE;iBACjF;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,eAAe;gBACpB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAvCD,8CAuCC"}

package/dist/nodes/Mem0/GenericFunctions.d.ts

@@ -0,0 +1,3 @@
+import { IExecuteFunctions, ILoadOptionsFunctions, IHookFunctions, IWebhookFunctions, IHttpRequestMethods } from 'n8n-workflow';
+export declare function mem0ApiRequest(this: IExecuteFunctions | ILoadOptionsFunctions | IHookFunctions | IWebhookFunctions, method: IHttpRequestMethods, endpoint: string, body?: any, qs?: any): Promise<any>;
+//# sourceMappingURL=GenericFunctions.d.ts.map

package/dist/nodes/Mem0/GenericFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.d.ts","sourceRoot":"","sources":["../../../nodes/Mem0/GenericFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EAGnB,MAAM,cAAc,CAAC;AAEtB,wBAAsB,cAAc,CACnC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,GAAG,cAAc,GAAG,iBAAiB,EACpF,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,GAAQ,EACd,EAAE,GAAE,GAAQ,GACV,OAAO,CAAC,GAAG,CAAC,CAyCd"}

package/dist/nodes/Mem0/GenericFunctions.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mem0ApiRequest = mem0ApiRequest;
+const n8n_workflow_1 = require("n8n-workflow");
+async function mem0ApiRequest(method, endpoint, body = {}, qs = {}) {
+    // Support both Portuguese parameter name used in CRUD node and English used in Memory node
+    let authenticationType;
+    try {
+        authenticationType = this.getNodeParameter('tipoAutenticacao', 0);
+    }
+    catch (e) {
+        authenticationType = this.getNodeParameter('authType', 0) || 'nuvem';
+        // Map to legacy values used below
+        if (authenticationType === 'cloud')
+            authenticationType = 'nuvem';
+        if (authenticationType === 'selfHosted')
+            authenticationType = 'selfHosted';
+    }
+    let credentials;
+    let baseUrl;
+    if (authenticationType === 'nuvem') {
+        credentials = await this.getCredentials('mem0Api');
+        baseUrl = 'https://api.mem0.ai';
+    }
+    else {
+        credentials = await this.getCredentials('mem0SelfHostedApi');
+        baseUrl = credentials.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+    }
+    const options = {
+        method,
+        body,
+        qs,
+        url: `${baseUrl}${endpoint}`,
+        json: true,
+    };
+    if (credentials.apiKey) {
+        options.headers = {
+            'Authorization': `Token ${credentials.apiKey}`,
+        };
+    }
+    try {
+        return await this.helpers.request(options);
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+    }
+}
+//# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/Mem0/GenericFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/Mem0/GenericFunctions.ts"],"names":[],"mappings":";;AAUA,wCA+CC;AAzDD,+CAQsB;AAEf,KAAK,UAAU,cAAc,CAEnC,MAA2B,EAC3B,QAAgB,EAChB,OAAY,EAAE,EACd,KAAU,EAAE;IAEZ,2FAA2F;IAC3F,IAAI,kBAA0B,CAAC;IAC/B,IAAI,CAAC;QACJ,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAW,CAAC;IAC7E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,kBAAkB,GAAI,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAY,IAAI,OAAO,CAAC;QACjF,kCAAkC;QAClC,IAAI,kBAAkB,KAAK,OAAO;YAAE,kBAAkB,GAAG,OAAO,CAAC;QACjE,IAAI,kBAAkB,KAAK,YAAY;YAAE,kBAAkB,GAAG,YAAY,CAAC;IAC5E,CAAC;IACD,IAAI,WAAW,CAAC;IAChB,IAAI,OAAO,CAAC;IAEZ,IAAI,kBAAkB,KAAK,OAAO,EAAE,CAAC;QACpC,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,GAAG,qBAAqB,CAAC;IACjC,CAAC;SAAM,CAAC;QACP,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QAC7D,OAAO,GAAI,WAAW,CAAC,OAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB;IACvF,CAAC;IAED,MAAM,OAAO,GAAoB;QAChC,MAAM;QACN,IAAI;QACJ,EAAE;QACF,GAAG,EAAE,GAAG,OAAO,GAAG,QAAQ,EAAE;QAC5B,IAAI,EAAE,IAAI;KACV,CAAC;IAEF,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,OAAO,GAAG;YACjB,eAAe,EAAE,SAAS,WAAW,CAAC,MAAM,EAAE;SAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACrB,MAAM,IAAI,2BAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Mem0 implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=Mem0.node.d.ts.map

package/dist/nodes/Mem0/Mem0.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mem0.node.d.ts","sourceRoot":"","sources":["../../../nodes/Mem0/Mem0.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAiBtB,qBAAa,IAAK,YAAW,SAAS;IACrC,WAAW,EAAE,oBAAoB,CA6yB/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAkVvE"}