@mcp-abap-adt/ollama-embedder 11.0.0

package/README.md

@@ -0,0 +1,41 @@
+# @mcp-abap-adt/ollama-embedder
+
+Ollama embedding provider for @mcp-abap-adt/llm-agent. Implements `IEmbedderBatch`; uses native `fetch`.
+
+## Exports
+
+- `OllamaEmbedder` — implements IEmbedderBatch, calls Ollama /api/embeddings and /api/embed (batch).
+- `OllamaRag` — convenience wrapper combining OllamaEmbedder with VectorRag.
+- `OllamaEmbedderConfig` — configuration type.
+
+## Installation
+
+```bash
+npm install @mcp-abap-adt/ollama-embedder
+```
+
+## Usage
+
+```ts
+import { OllamaEmbedder, OllamaRag } from '@mcp-abap-adt/ollama-embedder';
+
+// Direct embedder usage
+const embedder = new OllamaEmbedder({
+  ollamaUrl: 'http://localhost:11434',
+  model: 'nomic-embed-text',
+});
+
+const result = await embedder.embed('Hello world');
+console.log(result.vector);
+
+// Convenience RAG wrapper
+const rag = new OllamaRag({
+  ollamaUrl: 'http://localhost:11434',
+  model: 'nomic-embed-text',
+});
+
+const searchResults = await rag.query('What is Ollama?', documents);
+console.log(searchResults);
+```
+
+Optional peer dependency of @mcp-abap-adt/llm-agent-server.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { OllamaEmbedderConfig } from './ollama.js';
+export { OllamaEmbedder, OllamaRag } from './ollama.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { OllamaEmbedder, OllamaRag } from './ollama.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/ollama.d.ts

@@ -0,0 +1,25 @@
+import type { IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
+import { type CallOptions, VectorRag, type VectorRagConfig } from '@mcp-abap-adt/llm-agent';
+export interface OllamaEmbedderConfig {
+    /** Default: 'http://localhost:11434' */
+    ollamaUrl?: string;
+    /** Default: 'nomic-embed-text' */
+    model?: string;
+    /** Per-request timeout in milliseconds. Default: 30 000 */
+    timeoutMs?: number;
+}
+export declare class OllamaEmbedder implements IEmbedderBatch {
+    private readonly ollamaUrl;
+    private readonly model;
+    private readonly timeoutMs;
+    constructor(config?: OllamaEmbedderConfig);
+    embed(text: string, options?: CallOptions): Promise<IEmbedResult>;
+    embedBatch(texts: string[], options?: CallOptions): Promise<IEmbedResult[]>;
+}
+/**
+ * OllamaRag — convenience adapter that combines OllamaEmbedder with VectorRag.
+ */
+export declare class OllamaRag extends VectorRag {
+    constructor(config?: OllamaEmbedderConfig & VectorRagConfig);
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../src/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EACL,KAAK,WAAW,EAEhB,SAAS,EACT,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAe,YAAW,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,oBAAyB;IAMvC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8CjE,UAAU,CACd,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC;CA4C3B;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,MAAM,GAAE,oBAAoB,GAAG,eAAoB;CAIhE"}

package/dist/ollama.js

@@ -0,0 +1,92 @@
+import { RagError, VectorRag, } from '@mcp-abap-adt/llm-agent';
+export class OllamaEmbedder {
+    ollamaUrl;
+    model;
+    timeoutMs;
+    constructor(config = {}) {
+        this.ollamaUrl = config.ollamaUrl ?? 'http://localhost:11434';
+        this.model = config.model ?? 'nomic-embed-text';
+        this.timeoutMs = config.timeoutMs ?? 30_000;
+    }
+    async embed(text, options) {
+        const url = `${this.ollamaUrl}/api/embeddings`;
+        let lastError;
+        const maxRetries = 3;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+                const signal = options?.signal
+                    ? AbortSignal.any([options.signal, timeoutSignal])
+                    : timeoutSignal;
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ model: this.model, prompt: text }),
+                    signal,
+                });
+                if (!res.ok) {
+                    const errorText = await res.text();
+                    throw new RagError(`Ollama embed error: HTTP ${res.status} - ${errorText}`, 'EMBED_ERROR');
+                }
+                const json = (await res.json());
+                return { vector: json.embedding };
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (err instanceof Error && err.name === 'AbortError')
+                    throw err;
+                // Exponential backoff: 500ms, 1000ms, 2000ms
+                const delay = 500 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw (lastError ||
+            new RagError('Ollama embed failed after retries', 'EMBED_ERROR'));
+    }
+    async embedBatch(texts, options) {
+        if (texts.length === 0)
+            return [];
+        const url = `${this.ollamaUrl}/api/embed`;
+        let lastError;
+        const maxRetries = 3;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+                const signal = options?.signal
+                    ? AbortSignal.any([options.signal, timeoutSignal])
+                    : timeoutSignal;
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ model: this.model, input: texts }),
+                    signal,
+                });
+                if (!res.ok) {
+                    const errorText = await res.text();
+                    throw new RagError(`Ollama batch embed error: HTTP ${res.status} - ${errorText}`, 'EMBED_ERROR');
+                }
+                const json = (await res.json());
+                return json.embeddings.map((vector) => ({ vector }));
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (err instanceof Error && err.name === 'AbortError')
+                    throw err;
+                const delay = 500 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw (lastError ||
+            new RagError('Ollama batch embed failed after retries', 'EMBED_ERROR'));
+    }
+}
+/**
+ * OllamaRag — convenience adapter that combines OllamaEmbedder with VectorRag.
+ */
+export class OllamaRag extends VectorRag {
+    constructor(config = {}) {
+        const embedder = new OllamaEmbedder(config);
+        super(embedder, config);
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../src/ollama.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mcp-abap-adt/ollama-embedder",
+  "version": "11.0.0",
+  "description": "Ollama embedding provider and OllamaRag convenience class for @mcp-abap-adt/llm-agent.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "tsc -p tsconfig.json --clean",
+    "test": "node --import tsx/esm --test --test-reporter=spec 'src/**/*.test.ts'"
+  },
+  "dependencies": {
+    "@mcp-abap-adt/llm-agent": "*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/llm-agent.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}