@mcp-abap-adt/sap-aicore-embedder 11.0.0

package/README.md

@@ -0,0 +1,45 @@
+# @mcp-abap-adt/sap-aicore-embedder
+
+SAP AI Core embedding provider (IEmbedderBatch) for @mcp-abap-adt/llm-agent.
+
+Generates text embeddings via SAP AI Core embedding model deployments using the @sap-ai-sdk/orchestration client.
+
+## Installation
+
+```bash
+npm install @mcp-abap-adt/sap-aicore-embedder
+```
+
+## Usage
+
+```typescript
+import { SapAiCoreEmbedder } from '@mcp-abap-adt/sap-aicore-embedder';
+
+const embedder = new SapAiCoreEmbedder({
+  model: 'text-embedding-3-small',
+  resourceGroup: 'default', // optional
+});
+
+// Embed a single text
+const result = await embedder.embed('Hello, world!');
+console.log(result.vector);
+
+// Batch embed multiple texts
+const results = await embedder.embedBatch(['Text 1', 'Text 2', 'Text 3']);
+console.log(results.map(r => r.vector));
+```
+
+## Configuration
+
+### SapAiCoreEmbedderConfig
+
+- `model` (required): Embedding model name (e.g., 'text-embedding-3-small')
+- `resourceGroup` (optional): SAP AI Core resource group
+
+## Authentication
+
+Authentication uses the `AICORE_SERVICE_KEY` environment variable, which is read automatically by the SAP AI SDK orchestration client.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { SapAiCoreEmbedderConfig } from './sap-ai-core-embedder.js';
+export { SapAiCoreEmbedder } from './sap-ai-core-embedder.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,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { SapAiCoreEmbedder } from './sap-ai-core-embedder.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,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/sap-ai-core-embedder.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SAP AI Core Embedder — IEmbedderBatch implementation using @sap-ai-sdk/orchestration.
+ *
+ * Generates text embeddings via SAP AI Core embedding model deployments.
+ * Authentication: reads AICORE_SERVICE_KEY env var automatically (same as LLM provider).
+ */
+import type { IEmbedderBatch, IEmbedResult } from '@mcp-abap-adt/llm-agent';
+import { type CallOptions } from '@mcp-abap-adt/llm-agent';
+export interface SapAiCoreEmbedderConfig {
+    /** Embedding model name (e.g. 'text-embedding-3-small') */
+    model: string;
+    /** SAP AI Core resource group (optional) */
+    resourceGroup?: string;
+}
+export declare class SapAiCoreEmbedder implements IEmbedderBatch {
+    private readonly model;
+    private readonly resourceGroup?;
+    constructor(config: SapAiCoreEmbedderConfig);
+    embed(text: string, _options?: CallOptions): Promise<IEmbedResult>;
+    embedBatch(texts: string[], _options?: CallOptions): Promise<IEmbedResult[]>;
+}
+//# sourceMappingURL=sap-ai-core-embedder.d.ts.map

package/dist/sap-ai-core-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sap-ai-core-embedder.d.ts","sourceRoot":"","sources":["../src/sap-ai-core-embedder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,uBAAuB;IAKrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAmClE,UAAU,CACd,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;CAmC3B"}

package/dist/sap-ai-core-embedder.js

@@ -0,0 +1,57 @@
+/**
+ * SAP AI Core Embedder — IEmbedderBatch implementation using @sap-ai-sdk/orchestration.
+ *
+ * Generates text embeddings via SAP AI Core embedding model deployments.
+ * Authentication: reads AICORE_SERVICE_KEY env var automatically (same as LLM provider).
+ */
+import { RagError } from '@mcp-abap-adt/llm-agent';
+export class SapAiCoreEmbedder {
+    model;
+    resourceGroup;
+    constructor(config) {
+        this.model = config.model;
+        this.resourceGroup = config.resourceGroup;
+    }
+    async embed(text, _options) {
+        const { OrchestrationEmbeddingClient } = await import('@sap-ai-sdk/orchestration');
+        const modelName = this
+            .model;
+        const client = new OrchestrationEmbeddingClient({ embeddings: { model: { name: modelName } } }, this.resourceGroup ? { resourceGroup: this.resourceGroup } : undefined);
+        const response = await client.embed({ input: text });
+        const embeddings = response.getEmbeddings();
+        if (!embeddings || embeddings.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core');
+        }
+        const embedding = embeddings[0].embedding;
+        // Handle base64-encoded embeddings
+        if (typeof embedding === 'string') {
+            const buffer = Buffer.from(embedding, 'base64');
+            const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
+            return { vector: Array.from(float32) };
+        }
+        return { vector: embedding };
+    }
+    async embedBatch(texts, _options) {
+        if (texts.length === 0)
+            return [];
+        const { OrchestrationEmbeddingClient } = await import('@sap-ai-sdk/orchestration');
+        const modelName = this
+            .model;
+        const client = new OrchestrationEmbeddingClient({ embeddings: { model: { name: modelName } } }, this.resourceGroup ? { resourceGroup: this.resourceGroup } : undefined);
+        const response = await client.embed({ input: texts });
+        const embeddings = response.getEmbeddings();
+        if (!embeddings || embeddings.length === 0) {
+            throw new RagError('No embeddings returned from SAP AI Core batch');
+        }
+        const sorted = [...embeddings].sort((a, b) => a.index - b.index);
+        return sorted.map((e) => {
+            if (typeof e.embedding === 'string') {
+                const buffer = Buffer.from(e.embedding, 'base64');
+                const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
+                return { vector: Array.from(float32) };
+            }
+            return { vector: e.embedding };
+        });
+    }
+}
+//# sourceMappingURL=sap-ai-core-embedder.js.map

package/dist/sap-ai-core-embedder.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@mcp-abap-adt/sap-aicore-embedder",
+  "version": "11.0.0",
+  "description": "SAP AI Core embedding provider (IEmbedder) 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": "*",
+    "@sap-ai-sdk/orchestration": "^2.9.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/llm-agent.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}