n8n-nodes-berget-mk 0.4.7 → 0.4.9

package/README.md

@@ -2,11 +2,12 @@
 
 n8n community nodes for [Berget AI](https://berget.ai), packaged as a single installable module. Maintained by Micke Kring.
 
-Three nodes:
+Four nodes:
 
-- **Berget AI** — multi-resource action node for one-shot calls: **Chat** (completions, classification), **Rerank** (document reranking), and **Speech to Text** (Swedish-tuned KB-Whisper). Can also be exposed as a tool to an AI Agent. (OCR is temporarily hidden — see [CHANGELOG.md](CHANGELOG.md) for `0.4.4` for details.)
+- **Berget AI** — multi-resource action node for one-shot calls: **Chat** (completions, classification), **Image Analysis** (vision models), **Rerank** (document reranking), and **Speech to Text** (Swedish-tuned KB-Whisper). Can also be exposed as a tool to an AI Agent. (OCR is temporarily hidden — see [CHANGELOG.md](CHANGELOG.md) for `0.4.4` for details.)
 - **Berget AI Chat Model** — sub-node that plugs into n8n's built-in **AI Agent**, **Basic LLM Chain**, and other LangChain-based nodes. Exposes `reasoning_effort` and the full standard LLM parameter set.
 - **Berget AI Embeddings Model** — sub-node that plugs into n8n's **Vector Store** nodes (Supabase, Qdrant, Pinecone, PGVector, etc.) and **Question and Answer Chain**.
+- **Berget AI Reranker** — sub-node that plugs into Vector Store retrievers to reorder candidate documents by relevance before handing them to the chain or agent.
 
 > ⚠️ **Experimental — actively developed.** This package is pre-1.0 and may break between minor releases. Pin a specific version in production workflows until `1.0.0`. See [CHANGELOG.md](CHANGELOG.md) for breaking changes.
 

package/dist/nodes/BergetAi/rerank.js

@@ -67,8 +67,8 @@ exports.rerankProperties = [
         default: {},
         options: [
             {
-                displayName: 'Top K',
-                name: 'top_k',
+                displayName: 'Top N',
+                name: 'top_n',
                 type: 'number',
                 typeOptions: { minValue: 1 },
                 default: 10,

package/dist/nodes/BergetAiEmbeddingsModel/BergetAiEmbeddingsModel.node.js

@@ -63,9 +63,9 @@ class BergetAiEmbeddingsModel {
                             displayName: 'Dimensions',
                             name: 'dimensions',
                             type: 'number',
-                            typeOptions: { minValue: 1 },
-                            default: 1024,
-                            description: "The number of dimensions the resulting embedding vectors should have. When omitted or left at the model's native size, the full embedding is returned. Berget's default embedding model intfloat/multilingual-e5-large-instruct produces 1024-dimensional vectors natively. Lower values produce smaller vectors at some cost to retrieval quality — useful when storing many embeddings or when your vector store has a fixed dimension. Must match the dimension your Vector Store is configured for, or indexing will fail.",
+                            typeOptions: { minValue: 0 },
+                            default: 0,
+                            description: "⚠️ CURRENTLY BROKEN ON BERGET'S API. Leave at 0 (default) to omit the parameter entirely — this is the only reliable mode as of 2026-04. Setting any positive value causes Berget to return HTTP 503 EMBEDDING_CREATION_ERROR for every request, even when the value matches the model's native dimension (e.g. 1024 for intfloat/multilingual-e5-large-instruct). Berget's OpenAPI spec documents the dimensions parameter but the backend currently rejects it for all embedding models we've tested. The field is kept here so that when Berget fixes their backend, you can set a dimension without a package update. Default behaviour (dimensions=0) returns the model's native vector size.",
                         },
                         {
                             displayName: 'Strip New Lines',
@@ -114,6 +114,12 @@ class BergetAiEmbeddingsModel {
         const credentials = await this.getCredentials('bergetAiApi');
         const modelName = this.getNodeParameter('model', itemIndex);
         const options = this.getNodeParameter('options', itemIndex, {});
+        // Dimensions is intentionally only passed through when > 0. Berget's
+        // backend currently returns HTTP 503 EMBEDDING_CREATION_ERROR for any
+        // request that includes the dimensions field (verified 2026-04-11),
+        // despite their OpenAPI spec documenting it. The field is kept in the
+        // UI so users can opt in once Berget fixes the backend without a
+        // package update. See CHANGELOG 0.4.8 for details.
         const embeddings = new openai_1.OpenAIEmbeddings({
             apiKey: credentials.apiKey,
             model: modelName,
@@ -123,7 +129,9 @@ class BergetAiEmbeddingsModel {
             batchSize: (_a = options.batchSize) !== null && _a !== void 0 ? _a : 512,
             stripNewLines: (_b = options.stripNewLines) !== null && _b !== void 0 ? _b : true,
             timeout: (_c = options.timeout) !== null && _c !== void 0 ? _c : 60000,
-            ...(options.dimensions ? { dimensions: options.dimensions } : {}),
+            ...(options.dimensions && options.dimensions > 0
+                ? { dimensions: options.dimensions }
+                : {}),
         });
         return { response: embeddings };
     }

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

@@ -0,0 +1,10 @@
+import { type ILoadOptionsFunctions, type INodePropertyOptions, type INodeType, type INodeTypeDescription, type ISupplyDataFunctions, type SupplyData } from 'n8n-workflow';
+export declare class BergetAiReranker implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getRerankModels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    supplyData(this: ISupplyDataFunctions, itemIndex: number): Promise<SupplyData>;
+}

package/dist/nodes/BergetAiReranker/BergetAiReranker.node.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BergetAiReranker = void 0;
+const documents_1 = require("@langchain/core/documents");
+const document_compressors_1 = require("@langchain/core/retrievers/document_compressors");
+const axios_1 = __importDefault(require("axios"));
+const n8n_workflow_1 = require("n8n-workflow");
+const BERGET_API_BASE_URL = 'https://api.berget.ai/v1';
+/**
+ * LangChain-compatible document compressor that calls Berget AI's `/v1/rerank`
+ * endpoint to reorder a list of documents by relevance to a query. Plugs into
+ * any n8n node that accepts an AiReranker connection type (Vector Store
+ * retrievers, QA Chain, etc.).
+ *
+ * Berget's API returns results with 0-based indices into the input documents
+ * array. We preserve the original LangChain Document metadata across the round
+ * trip so downstream consumers don't lose pageContent source references.
+ */
+class BergetReranker extends document_compressors_1.BaseDocumentCompressor {
+    constructor(params) {
+        super();
+        this.apiKey = params.apiKey;
+        this.model = params.model;
+        this.topN = params.topN;
+        this.timeoutMs = params.timeoutMs;
+    }
+    async compressDocuments(documents, query, _callbacks) {
+        var _a, _b;
+        if (documents.length === 0)
+            return [];
+        const documentStrings = documents.map((d) => d.pageContent);
+        const response = await axios_1.default.post(`${BERGET_API_BASE_URL}/rerank`, {
+            model: this.model,
+            query,
+            documents: documentStrings,
+            top_n: Math.min(this.topN, documents.length),
+            return_documents: false,
+        }, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            timeout: this.timeoutMs,
+        });
+        const results = (_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.data) !== null && _b !== void 0 ? _b : [];
+        return results.map((result) => {
+            var _a, _b, _c;
+            const original = documents[result.index];
+            return new documents_1.Document({
+                pageContent: (_b = (_a = original === null || original === void 0 ? void 0 : original.pageContent) !== null && _a !== void 0 ? _a : result.document) !== null && _b !== void 0 ? _b : '',
+                metadata: {
+                    ...((_c = original === null || original === void 0 ? void 0 : original.metadata) !== null && _c !== void 0 ? _c : {}),
+                    relevance_score: result.relevance_score,
+                },
+            });
+        });
+    }
+}
+class BergetAiReranker {
+    constructor() {
+        this.description = {
+            displayName: 'Berget AI Reranker',
+            name: 'bergetAiReranker',
+            icon: 'file:bergetai.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Rerank documents retrieved from a Vector Store using a Berget AI reranker model. Plugs into Vector Store retrievers and other nodes that accept an AiReranker connection.',
+            defaults: { name: 'Berget AI Reranker' },
+            codex: {
+                categories: ['AI'],
+                subcategories: {
+                    AI: ['Rerankers'],
+                },
+            },
+            credentials: [{ name: 'bergetAiApi', required: true }],
+            inputs: [],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.AiReranker],
+            outputNames: ['Reranker'],
+            properties: [
+                {
+                    displayName: 'This node must be connected to a Vector Store retriever or a similar parent node that accepts a reranker. It cannot be executed on its own.',
+                    name: 'notice',
+                    type: 'notice',
+                    default: '',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'options',
+                    typeOptions: { loadOptionsMethod: 'getRerankModels' },
+                    default: '',
+                    required: true,
+                    description: 'The Berget AI reranker model to use. Fetched live from the Berget API.',
+                },
+                {
+                    displayName: 'Top N',
+                    name: 'topN',
+                    type: 'number',
+                    typeOptions: { minValue: 1 },
+                    default: 3,
+                    description: 'Maximum number of documents to keep after reranking. The parent node still passes the reranker a larger candidate set; this controls how many survive the rerank step.',
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Timeout (Ms)',
+                            name: 'timeout',
+                            type: 'number',
+                            typeOptions: { minValue: 1 },
+                            default: 60000,
+                            description: 'Maximum time in milliseconds to wait for the rerank API',
+                        },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                async getRerankModels() {
+                    var _a, _b;
+                    const credentials = await this.getCredentials('bergetAiApi');
+                    const response = await axios_1.default.get(`${BERGET_API_BASE_URL}/models`, {
+                        headers: {
+                            Authorization: `Bearer ${credentials.apiKey}`,
+                            'Content-Type': 'application/json',
+                        },
+                    });
+                    const models = (_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.data) !== null && _b !== void 0 ? _b : [];
+                    return models
+                        .filter((m) => m.model_type === 'rerank')
+                        .map((m) => ({ name: m.id, value: m.id }))
+                        .sort((a, b) => a.name.localeCompare(b.name));
+                },
+            },
+        };
+    }
+    async supplyData(itemIndex) {
+        var _a;
+        const credentials = await this.getCredentials('bergetAiApi');
+        const model = this.getNodeParameter('model', itemIndex);
+        const topN = this.getNodeParameter('topN', itemIndex, 3);
+        const options = this.getNodeParameter('options', itemIndex, {});
+        const reranker = new BergetReranker({
+            apiKey: credentials.apiKey,
+            model,
+            topN,
+            timeoutMs: (_a = options.timeout) !== null && _a !== void 0 ? _a : 60000,
+        });
+        return { response: reranker };
+    }
+}
+exports.BergetAiReranker = BergetAiReranker;

package/dist/nodes/BergetAiReranker/bergetai.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 463 419">
+  <path fill="#10b981" d="M208.739 17L255.261 17L446 403L398 403L313.5 255L261.5 176L233.163 96.1677L237.815 98.6522H226.185L230.837 96.1677L113 331L64.5 403L18 403L208.739 17Z"/>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-berget-mk",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "n8n community node for Berget AI. Multi-resource action node (chat, OCR, rerank, speech-to-text) plus Chat Model and Embeddings Model sub-nodes that plug into n8n's built-in AI Agent and Vector Store nodes.",
   "keywords": [
     "n8n-community-node-package",
@@ -63,7 +63,8 @@
     "nodes": [
       "dist/nodes/BergetAi/BergetAi.node.js",
       "dist/nodes/BergetAiChatModel/BergetAiChatModel.node.js",
-      "dist/nodes/BergetAiEmbeddingsModel/BergetAiEmbeddingsModel.node.js"
+      "dist/nodes/BergetAiEmbeddingsModel/BergetAiEmbeddingsModel.node.js",
+      "dist/nodes/BergetAiReranker/BergetAiReranker.node.js"
     ]
   }
 }