@mcp-abap-adt/hana-vector-rag 11.0.0

package/README.md

@@ -0,0 +1,26 @@
+# @mcp-abap-adt/hana-vector-rag
+
+SAP HANA Cloud Vector Engine backend for [@mcp-abap-adt/llm-agent](https://www.npmjs.com/package/@mcp-abap-adt/llm-agent).
+
+Provides:
+- `HanaVectorRag` — `IRag` implementation backed by `REAL_VECTOR(dim)` columns.
+- `HanaVectorRagProvider` — `IRagProvider` for session/user/global collections.
+
+## Install
+
+```bash
+npm install @mcp-abap-adt/hana-vector-rag @sap/hana-client
+```
+
+## Minimal config
+
+```yaml
+rag:
+  type: hana-vector
+  connectionString: hdbsql://user:pass@host:443
+  collectionName: llm_agent_docs
+  dimension: 1536
+  autoCreateSchema: true
+```
+
+See the monorepo root README for full configuration surface.

package/dist/__tests__/connection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection.test.d.ts.map

package/dist/__tests__/connection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/connection.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/connection.test.js

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { resolveHanaConnectArgs } from '../connection.js';
+describe('resolveHanaConnectArgs', () => {
+    it('accepts explicit fields', () => {
+        const args = resolveHanaConnectArgs({
+            host: 'h.example.com',
+            port: 443,
+            user: 'U1',
+            password: 'pw',
+            collectionName: 't',
+        });
+        assert.equal(args.serverNode, 'h.example.com:443');
+        assert.equal(args.uid, 'U1');
+        assert.equal(args.pwd, 'pw');
+        assert.equal(args.encrypt, 'true');
+    });
+    it('parses hdbsql URL', () => {
+        const args = resolveHanaConnectArgs({
+            connectionString: 'hdbsql://u:p@host.example:443',
+            collectionName: 't',
+        });
+        assert.equal(args.serverNode, 'host.example:443');
+        assert.equal(args.uid, 'u');
+        assert.equal(args.pwd, 'p');
+    });
+    it('rejects missing host', () => {
+        assert.throws(() => resolveHanaConnectArgs({
+            user: 'u',
+            password: 'p',
+            collectionName: 't',
+        }), /host/i);
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/dist/__tests__/connection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.test.js","sourceRoot":"","sources":["../../src/__tests__/connection.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,sBAAsB,CAAC;YAClC,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,GAAG;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,IAAI,GAAG,sBAAsB,CAAC;YAClC,gBAAgB,EAAE,+BAA+B;YACjD,cAAc,EAAE,GAAG;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,sBAAsB,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,GAAG;YACb,cAAc,EAAE,GAAG;SACpB,CAAC,EACJ,OAAO,CACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/hana-vector-rag-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hana-vector-rag-provider.test.d.ts.map

package/dist/__tests__/hana-vector-rag-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hana-vector-rag-provider.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hana-vector-rag-provider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hana-vector-rag-provider.test.js

@@ -0,0 +1,127 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { HanaVectorRagProvider } from '../hana-vector-rag-provider.js';
+function makeEmbedder() {
+    return {
+        async embed() {
+            return { vector: [0, 0, 0] };
+        },
+    };
+}
+function makeFakeClient(rows = []) {
+    const calls = [];
+    return {
+        calls,
+        async exec(sql, params = []) {
+            calls.push({ sql, params });
+            return { rowCount: 1 };
+        },
+        async query(sql, params = []) {
+            calls.push({ sql, params });
+            return rows;
+        },
+        async close() { },
+    };
+}
+describe('HanaVectorRagProvider', () => {
+    it('createCollection returns rag + editor, runs schema bootstrap when autoCreateSchema=true', async () => {
+        const client = makeFakeClient();
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder: makeEmbedder(),
+            connection: {
+                collectionName: '__ignored',
+                host: 'h',
+                user: 'u',
+                password: 'p',
+            },
+            defaultDimension: 3,
+            autoCreateSchema: true,
+            clientFactory: () => client,
+        });
+        const r = await provider.createCollection('docs', {
+            scope: 'session',
+            sessionId: 's1',
+        });
+        assert.equal(r.ok, true);
+        if (!r.ok)
+            throw new Error('unreachable');
+        assert.ok(client.calls.some((c) => c.sql.includes('CREATE TABLE') && c.sql.includes('"docs"')));
+    });
+    it('createCollection skips DDL when autoCreateSchema=false', async () => {
+        const client = makeFakeClient();
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder: makeEmbedder(),
+            connection: {
+                collectionName: '__ignored',
+                host: 'h',
+                user: 'u',
+                password: 'p',
+            },
+            defaultDimension: 3,
+            autoCreateSchema: false,
+            clientFactory: () => client,
+        });
+        const r = await provider.createCollection('docs', { scope: 'global' });
+        assert.equal(r.ok, true);
+        assert.ok(!client.calls.some((c) => c.sql.includes('CREATE TABLE')));
+    });
+    it('deleteCollection emits DROP TABLE', async () => {
+        const client = makeFakeClient();
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder: makeEmbedder(),
+            connection: {
+                collectionName: '__ignored',
+                host: 'h',
+                user: 'u',
+                password: 'p',
+            },
+            clientFactory: () => client,
+        });
+        const r = await provider.deleteCollection('docs');
+        assert.equal(r.ok, true);
+        assert.ok(client.calls.some((c) => c.sql.startsWith('DROP TABLE')));
+    });
+    it('listCollections queries SYS.TABLES and returns names', async () => {
+        const client = makeFakeClient([
+            { TABLE_NAME: 'docs' },
+            { TABLE_NAME: 'other' },
+        ]);
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder: makeEmbedder(),
+            connection: {
+                collectionName: '__ignored',
+                host: 'h',
+                user: 'u',
+                password: 'p',
+            },
+            clientFactory: () => client,
+        });
+        const r = await provider.listCollections();
+        assert.equal(r.ok, true);
+        if (!r.ok)
+            throw new Error('unreachable');
+        assert.deepEqual(r.value, ['docs', 'other']);
+    });
+    it('rejects unsupported scope', async () => {
+        const client = makeFakeClient();
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder: makeEmbedder(),
+            connection: {
+                collectionName: '__ignored',
+                host: 'h',
+                user: 'u',
+                password: 'p',
+            },
+            clientFactory: () => client,
+            supportedScopes: ['global'],
+        });
+        const r = await provider.createCollection('docs', { scope: 'session' });
+        assert.equal(r.ok, false);
+    });
+});
+//# sourceMappingURL=hana-vector-rag-provider.test.js.map

package/dist/__tests__/hana-vector-rag-provider.test.js.map

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

package/dist/__tests__/hana-vector-rag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hana-vector-rag.test.d.ts.map

package/dist/__tests__/hana-vector-rag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hana-vector-rag.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hana-vector-rag.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hana-vector-rag.test.js

@@ -0,0 +1,108 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { HanaVectorRag } from '../hana-vector-rag.js';
+function makeEmbedder(dim = 3) {
+    return {
+        async embed(text) {
+            let h = 0;
+            for (const ch of text)
+                h = (h * 31 + ch.charCodeAt(0)) | 0;
+            return {
+                vector: Array.from({ length: dim }, (_, i) => ((h >> i) & 0xff) / 255),
+            };
+        },
+    };
+}
+function makeFakeClient(rows = []) {
+    const calls = [];
+    return {
+        calls,
+        async exec(sql, params = []) {
+            calls.push({ sql, params });
+            return { rowCount: 1 };
+        },
+        async query(sql, params = []) {
+            calls.push({ sql, params });
+            return rows;
+        },
+        async close() {
+            /* noop */
+        },
+    };
+}
+describe('HanaVectorRag', () => {
+    it('ensureSchema runs CREATE TABLE only once', async () => {
+        const client = makeFakeClient();
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        await rag.ensureSchema();
+        await rag.ensureSchema();
+        const creates = client.calls.filter((c) => c.sql.includes('CREATE TABLE'));
+        assert.equal(creates.length, 1);
+    });
+    it('query returns results mapped from rows', async () => {
+        const rows = [
+            { id: 'a', text: 'hello', metadata: '{"namespace":"n"}', score: 0.9 },
+        ];
+        const client = makeFakeClient(rows);
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const res = await rag.query({ text: 'test query', toVector: async () => [0.1, 0.2, 0.3] }, 5);
+        assert.equal(res.ok, true);
+        if (!res.ok)
+            throw new Error('unreachable');
+        assert.equal(res.value.length, 1);
+        assert.equal(res.value[0].text, 'hello');
+        assert.equal(res.value[0].metadata?.namespace, 'n');
+    });
+    it('upsertRaw issues UPSERT with vector literal', async () => {
+        const client = makeFakeClient();
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const r = await rag.writer().upsertRaw('id1', 'text', { namespace: 'n' });
+        assert.equal(r.ok, true);
+        const upsert = client.calls.find((c) => c.sql.startsWith('UPSERT'));
+        assert.ok(upsert, 'UPSERT should have been issued');
+    });
+    it('deleteByIdRaw issues DELETE', async () => {
+        const client = makeFakeClient();
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const r = await rag.writer().deleteByIdRaw('id1');
+        assert.equal(r.ok, true);
+        assert.ok(client.calls.some((c) => c.sql.includes('DELETE FROM')));
+    });
+    it('deleteByIdRaw reports false when no row matched', async () => {
+        const calls = [];
+        const client = {
+            async exec(sql, params = []) {
+                calls.push({ sql, params });
+                return { rowCount: 0 };
+            },
+            async query() {
+                return [];
+            },
+            async close() { },
+        };
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const r = await rag.writer().deleteByIdRaw('missing');
+        assert.equal(r.ok, true);
+        if (!r.ok)
+            throw new Error('unreachable');
+        assert.equal(r.value, false);
+    });
+    it('clearAll issues TRUNCATE', async () => {
+        const client = makeFakeClient();
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const r = await rag.writer().clearAll();
+        assert.equal(r.ok, true);
+        assert.ok(client.calls.some((c) => c.sql.startsWith('TRUNCATE')));
+    });
+    it('healthCheck runs SELECT 1 FROM DUMMY', async () => {
+        const client = makeFakeClient([{ '1': 1 }]);
+        const rag = new HanaVectorRag({ collectionName: 'docs', dimension: 3, embedder: makeEmbedder(3) }, client);
+        const r = await rag.healthCheck();
+        assert.equal(r.ok, true);
+        assert.ok(client.calls.some((c) => c.sql.includes('FROM DUMMY')));
+    });
+    it('rejects invalid collection name at construction', () => {
+        assert.throws(() => new HanaVectorRag({ collectionName: "bad'; DROP", embedder: makeEmbedder() }, makeFakeClient()), (err) => err.code === 'INVALID_COLLECTION_NAME');
+    });
+});
+//# sourceMappingURL=hana-vector-rag.test.js.map

package/dist/__tests__/hana-vector-rag.test.js.map

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

package/dist/__tests__/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/__tests__/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schema.test.js

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { assertCollectionName, createTableSql, dropTableSql, quoteIdent, } from '../schema.js';
+describe('hana schema', () => {
+    it('accepts a safe collection name', () => {
+        assertCollectionName('llm_agent_docs_2');
+    });
+    it('rejects collection name starting with digit', () => {
+        assert.throws(() => assertCollectionName('1bad'), (err) => err.code === 'INVALID_COLLECTION_NAME');
+    });
+    it('rejects collection name with special chars', () => {
+        assert.throws(() => assertCollectionName("x'); DROP"), (err) => err.code === 'INVALID_COLLECTION_NAME');
+    });
+    it('rejects names longer than 63 chars', () => {
+        assert.throws(() => assertCollectionName('a'.repeat(64)), (err) => err.code === 'INVALID_COLLECTION_NAME');
+    });
+    it('quotes HANA identifiers', () => {
+        assert.equal(quoteIdent('llm_docs'), '"llm_docs"');
+    });
+    it('emits CREATE TABLE DDL with REAL_VECTOR and NCLOB', () => {
+        const sql = createTableSql('llm_docs', 1536);
+        assert.match(sql, /CREATE TABLE IF NOT EXISTS "llm_docs"/);
+        assert.match(sql, /REAL_VECTOR\(1536\)/);
+        assert.match(sql, /metadata NCLOB/);
+    });
+    it('emits DROP TABLE DDL with IF EXISTS', () => {
+        assert.equal(dropTableSql('llm_docs'), 'DROP TABLE IF EXISTS "llm_docs"');
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/__tests__/schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../src/__tests__/schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAClC,CAAC,GAA8B,EAAE,EAAE,CACjC,GAAG,CAAC,IAAI,KAAK,yBAAyB,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,EACvC,CAAC,GAA8B,EAAE,EAAE,CACjC,GAAG,CAAC,IAAI,KAAK,yBAAyB,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAC1C,CAAC,GAA8B,EAAE,EAAE,CACjC,GAAG,CAAC,IAAI,KAAK,yBAAyB,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,iCAAiC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/connection.d.ts

@@ -0,0 +1,24 @@
+export interface HanaVectorRagConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    schema?: string;
+    collectionName: string;
+    dimension?: number;
+    autoCreateSchema?: boolean;
+    poolMax?: number;
+    connectTimeout?: number;
+}
+export interface HanaConnectArgs {
+    serverNode: string;
+    uid: string;
+    pwd: string;
+    encrypt: 'true' | 'false';
+    sslValidateCertificate?: 'true' | 'false';
+    currentSchema?: string;
+    communicationTimeout?: number;
+}
+export declare function resolveHanaConnectArgs(cfg: HanaVectorRagConfig): HanaConnectArgs;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,mBAAmB,GACvB,eAAe,CA6BjB"}

package/dist/connection.js

@@ -0,0 +1,30 @@
+export function resolveHanaConnectArgs(cfg) {
+    let host = cfg.host;
+    let port = cfg.port;
+    let user = cfg.user;
+    let password = cfg.password;
+    if (cfg.connectionString) {
+        const normalized = cfg.connectionString.replace(/^hdbsql:\/\//, 'https://');
+        const u = new URL(normalized);
+        host ??= u.hostname;
+        port ??= u.port ? Number(u.port) : 443;
+        user ??= decodeURIComponent(u.username);
+        password ??= decodeURIComponent(u.password);
+    }
+    if (!host)
+        throw new Error('HANA host is required (host or connectionString)');
+    if (!user)
+        throw new Error('HANA user is required');
+    if (!password)
+        throw new Error('HANA password is required');
+    return {
+        serverNode: `${host}:${port ?? 443}`,
+        uid: user,
+        pwd: password,
+        encrypt: 'true',
+        sslValidateCertificate: 'true',
+        currentSchema: cfg.schema,
+        communicationTimeout: cfg.connectTimeout ?? 30_000,
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,sBAAsB,CACpC,GAAwB;IAExB,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,IAAI,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAE5B,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC;QACpB,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACvC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,KAAK,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAE5D,OAAO;QACL,UAAU,EAAE,GAAG,IAAI,IAAI,IAAI,IAAI,GAAG,EAAE;QACpC,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,QAAQ;QACb,OAAO,EAAE,MAAM;QACf,sBAAsB,EAAE,MAAM;QAC9B,aAAa,EAAE,GAAG,CAAC,MAAM;QACzB,oBAAoB,EAAE,GAAG,CAAC,cAAc,IAAI,MAAM;KACnD,CAAC;AACJ,CAAC"}

package/dist/hana-vector-rag-provider.d.ts

@@ -0,0 +1,49 @@
+import type { IEmbedder, IIdStrategy, IRag, IRagEditor, RagCollectionScope, Result } from '@mcp-abap-adt/llm-agent';
+import { AbstractRagProvider, RagError } from '@mcp-abap-adt/llm-agent';
+import type { HanaVectorRagConfig } from './connection.js';
+import { type HanaClient } from './hana-vector-rag.js';
+export interface HanaVectorRagProviderConfig {
+    name: string;
+    embedder: IEmbedder;
+    connection: HanaVectorRagConfig | string;
+    defaultDimension?: number;
+    autoCreateSchema?: boolean;
+    editable?: boolean;
+    supportedScopes?: readonly RagCollectionScope[];
+    idStrategyFactory?: (opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }) => IIdStrategy;
+    /**
+     * Optional factory for driver clients used by deleteCollection / listCollections
+     * and (in tests) by createCollection. When omitted, deleteCollection and
+     * listCollections throw because schema-level operations require a shared client
+     * outside the per-collection HanaVectorRag lifecycle.
+     */
+    clientFactory?: () => HanaClient;
+}
+export declare class HanaVectorRagProvider extends AbstractRagProvider {
+    readonly name: string;
+    readonly kind = "vector";
+    readonly editable: boolean;
+    readonly supportedScopes: readonly RagCollectionScope[];
+    private readonly embedder;
+    private readonly connection;
+    private readonly defaultDimension;
+    private readonly autoCreateSchema;
+    private readonly clientFactory?;
+    constructor(cfg: HanaVectorRagProviderConfig);
+    createCollection(name: string, opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }): Promise<Result<{
+        rag: IRag;
+        editor: IRagEditor;
+    }, RagError>>;
+    deleteCollection(name: string): Promise<Result<void, RagError>>;
+    listCollections(): Promise<Result<string[], RagError>>;
+    private requireClient;
+}
+//# sourceMappingURL=hana-vector-rag-provider.d.ts.map

package/dist/hana-vector-rag-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hana-vector-rag-provider.d.ts","sourceRoot":"","sources":["../src/hana-vector-rag-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,UAAU,EACV,kBAAkB,EAClB,MAAM,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,sBAAsB,CAAC;AAGtE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE,kBAAkB,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,WAAW,CAAC;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;CAClC;AAWD,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAExD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAmB;gBAEtC,GAAG,EAAE,2BAA2B;IAatC,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,KAAK,EAAE,kBAAkB,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAyBzD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAa/D,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IAe5D,OAAO,CAAC,aAAa;CAQtB"}

package/dist/hana-vector-rag-provider.js

@@ -0,0 +1,89 @@
+import { AbstractRagProvider, RagError } from '@mcp-abap-adt/llm-agent';
+import { HanaVectorRag } from './hana-vector-rag.js';
+import { dropTableSql } from './schema.js';
+function normalizeConnection(c) {
+    if (typeof c === 'string') {
+        return { connectionString: c, collectionName: '__unused' };
+    }
+    return c;
+}
+export class HanaVectorRagProvider extends AbstractRagProvider {
+    name;
+    kind = 'vector';
+    editable;
+    supportedScopes;
+    embedder;
+    connection;
+    defaultDimension;
+    autoCreateSchema;
+    clientFactory;
+    constructor(cfg) {
+        super();
+        this.name = cfg.name;
+        this.embedder = cfg.embedder;
+        this.connection = normalizeConnection(cfg.connection);
+        this.defaultDimension = cfg.defaultDimension ?? 1536;
+        this.autoCreateSchema = cfg.autoCreateSchema ?? true;
+        this.editable = cfg.editable ?? true;
+        this.supportedScopes = cfg.supportedScopes ?? ['session', 'user', 'global'];
+        this.clientFactory = cfg.clientFactory;
+        if (cfg.idStrategyFactory)
+            this.idStrategyFactory = cfg.idStrategyFactory;
+    }
+    async createCollection(name, opts) {
+        const scopeCheck = this.checkScope(opts.scope);
+        if (!scopeCheck.ok)
+            return scopeCheck;
+        try {
+            const rag = new HanaVectorRag({
+                ...this.connection,
+                collectionName: name,
+                dimension: this.connection.dimension ?? this.defaultDimension,
+                autoCreateSchema: this.autoCreateSchema,
+                embedder: this.embedder,
+            }, this.clientFactory?.());
+            if (this.autoCreateSchema)
+                await rag.ensureSchema();
+            const editor = this.buildEditor(rag, this.pickIdStrategy(opts));
+            return { ok: true, value: { rag, editor } };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: new RagError(String(err), 'RAG_CREATE_ERROR'),
+            };
+        }
+    }
+    async deleteCollection(name) {
+        try {
+            const client = this.requireClient();
+            await client.exec(dropTableSql(name));
+            return { ok: true, value: undefined };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: new RagError(String(err), 'RAG_DELETE_ERROR'),
+            };
+        }
+    }
+    async listCollections() {
+        try {
+            const client = this.requireClient();
+            const rows = await client.query(this.connection.schema
+                ? 'SELECT TABLE_NAME FROM SYS.TABLES WHERE SCHEMA_NAME = ?'
+                : 'SELECT TABLE_NAME FROM SYS.TABLES WHERE SCHEMA_NAME = CURRENT_SCHEMA', this.connection.schema ? [this.connection.schema] : []);
+            return { ok: true, value: rows.map((r) => String(r.TABLE_NAME)) };
+        }
+        catch (err) {
+            return { ok: false, error: new RagError(String(err), 'RAG_LIST_ERROR') };
+        }
+    }
+    requireClient() {
+        if (!this.clientFactory) {
+            throw new Error('HanaVectorRagProvider deleteCollection/listCollections require clientFactory; provide one to enable schema-level operations');
+        }
+        return this.clientFactory();
+    }
+}
+//# sourceMappingURL=hana-vector-rag-provider.js.map

package/dist/hana-vector-rag-provider.js.map

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

package/dist/hana-vector-rag.d.ts

@@ -0,0 +1,39 @@
+import type { CallOptions, IEmbedder, IQueryEmbedding, IRag, IRagBackendWriter, RagMetadata, RagResult, Result } from '@mcp-abap-adt/llm-agent';
+import { RagError } from '@mcp-abap-adt/llm-agent';
+import type { HanaVectorRagConfig } from './connection.js';
+export type { HanaVectorRagConfig };
+export interface HanaClient {
+    exec(sql: string, params?: readonly unknown[]): Promise<{
+        rowCount: number;
+    }>;
+    query(sql: string, params?: readonly unknown[]): Promise<Array<Record<string, unknown>>>;
+    close(): Promise<void>;
+}
+export declare class HanaVectorRag implements IRag {
+    private readonly collectionName;
+    private readonly dimension;
+    private readonly embedder;
+    private readonly autoCreateSchema;
+    private readonly clientPromise;
+    private schemaReady;
+    private schemaPromise?;
+    constructor(config: HanaVectorRagConfig & {
+        embedder: IEmbedder;
+    }, injectedClient?: HanaClient);
+    private createDriverClient;
+    /**
+     * Idempotent schema bootstrap. Called by both direct makeRag() consumers
+     * (when autoCreateSchema is true) and HanaVectorRagProvider.createCollection().
+     */
+    ensureSchema(): Promise<void>;
+    private maybeEnsureSchema;
+    private vectorLiteral;
+    query(embedding: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+    getById(id: string, options?: CallOptions): Promise<Result<RagResult | null, RagError>>;
+    healthCheck(): Promise<Result<void, RagError>>;
+    upsert(text: string, metadata: RagMetadata, options?: CallOptions): Promise<Result<void, RagError>>;
+    upsertPrecomputed(text: string, vector: number[], metadata: RagMetadata): Promise<Result<void, RagError>>;
+    private upsertKnown;
+    writer(): IRagBackendWriter;
+}
+//# sourceMappingURL=hana-vector-rag.d.ts.map

package/dist/hana-vector-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hana-vector-rag.d.ts","sourceRoot":"","sources":["../src/hana-vector-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,IAAI,EACJ,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,MAAM,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA0B,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI3D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,KAAK,CACH,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,aAAc,YAAW,IAAI;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAGpC,MAAM,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,EACrD,cAAc,CAAC,EAAE,UAAU;YAgBf,kBAAkB;IAkDhC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAUrB,iBAAiB;IAI/B,OAAO,CAAC,aAAa;IAIf,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IA0BnC,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IAuBxC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAa9C,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAW5B,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAIpB,WAAW;IAmBzB,MAAM,IAAI,iBAAiB;CAsC5B"}

package/dist/hana-vector-rag.js

@@ -0,0 +1,192 @@
+import { FallbackQueryEmbedding, RagError } from '@mcp-abap-adt/llm-agent';
+import { resolveHanaConnectArgs } from './connection.js';
+import { assertCollectionName, createTableSql, quoteIdent } from './schema.js';
+export class HanaVectorRag {
+    collectionName;
+    dimension;
+    embedder;
+    autoCreateSchema;
+    clientPromise;
+    schemaReady = false;
+    schemaPromise;
+    constructor(config, injectedClient) {
+        assertCollectionName(config.collectionName);
+        this.collectionName = config.collectionName;
+        this.dimension = config.dimension ?? 1536;
+        this.embedder = config.embedder;
+        this.autoCreateSchema = config.autoCreateSchema ?? true;
+        // Attach a no-op catch so the eager import never becomes an unhandledRejection.
+        // The rejection is re-thrown when clientPromise is actually awaited.
+        const driverPromise = injectedClient
+            ? Promise.resolve(injectedClient)
+            : this.createDriverClient(config);
+        driverPromise.catch(() => { });
+        this.clientPromise = driverPromise;
+    }
+    async createDriverClient(cfg) {
+        const args = resolveHanaConnectArgs(cfg);
+        const mod = (await import('@sap/hana-client'));
+        const conn = mod.createConnection();
+        await new Promise((resolve, reject) => conn.connect(args, (err) => (err ? reject(err) : resolve())));
+        return {
+            exec: (sql, params = []) => new Promise((resolve, reject) => conn.exec(sql, params, (err, result) => err
+                ? reject(err)
+                : resolve({
+                    rowCount: typeof result === 'number'
+                        ? result
+                        : Array.isArray(result)
+                            ? result.length
+                            : 0,
+                }))),
+            query: (sql, params = []) => new Promise((resolve, reject) => conn.exec(sql, params, (err, rows) => err
+                ? reject(err)
+                : resolve(rows ?? []))),
+            close: () => new Promise((resolve, reject) => conn.disconnect((err) => (err ? reject(err) : resolve()))),
+        };
+    }
+    /**
+     * Idempotent schema bootstrap. Called by both direct makeRag() consumers
+     * (when autoCreateSchema is true) and HanaVectorRagProvider.createCollection().
+     */
+    async ensureSchema() {
+        if (this.schemaReady)
+            return;
+        this.schemaPromise ??= (async () => {
+            const client = await this.clientPromise;
+            await client.exec(createTableSql(this.collectionName, this.dimension));
+            this.schemaReady = true;
+        })();
+        await this.schemaPromise;
+    }
+    async maybeEnsureSchema() {
+        if (this.autoCreateSchema)
+            await this.ensureSchema();
+    }
+    vectorLiteral(vec) {
+        return `TO_REAL_VECTOR('[${vec.join(',')}]')`;
+    }
+    async query(embedding, k, options) {
+        if (options?.signal?.aborted)
+            return { ok: false, error: new RagError('Aborted', 'ABORTED') };
+        try {
+            await this.maybeEnsureSchema();
+            const safe = new FallbackQueryEmbedding(embedding, this.embedder);
+            const vector = await safe.toVector();
+            const client = await this.clientPromise;
+            const table = quoteIdent(this.collectionName);
+            const sql = `SELECT id, text, metadata, COSINE_SIMILARITY(vector, ${this.vectorLiteral(vector)}) AS score FROM ${table} ORDER BY score DESC LIMIT ${Math.max(1, k)}`;
+            const rows = await client.query(sql);
+            const results = rows.map((row) => {
+                const metaRaw = row.metadata;
+                const metadata = metaRaw ? JSON.parse(metaRaw) : {};
+                return {
+                    text: String(row.text ?? ''),
+                    metadata,
+                    score: Number(row.score ?? 0),
+                };
+            });
+            return { ok: true, value: results };
+        }
+        catch (err) {
+            return { ok: false, error: new RagError(String(err), 'QUERY_ERROR') };
+        }
+    }
+    async getById(id, options) {
+        if (options?.signal?.aborted)
+            return { ok: false, error: new RagError('Aborted', 'ABORTED') };
+        try {
+            await this.maybeEnsureSchema();
+            const client = await this.clientPromise;
+            const rows = await client.query(`SELECT id, text, metadata FROM ${quoteIdent(this.collectionName)} WHERE id = ?`, [id]);
+            const row = rows[0];
+            if (!row)
+                return { ok: true, value: null };
+            const metaRaw = row.metadata;
+            const metadata = metaRaw ? JSON.parse(metaRaw) : {};
+            return {
+                ok: true,
+                value: { text: String(row.text ?? ''), metadata, score: 1 },
+            };
+        }
+        catch (err) {
+            return { ok: false, error: new RagError(String(err), 'QUERY_ERROR') };
+        }
+    }
+    async healthCheck() {
+        try {
+            const client = await this.clientPromise;
+            await client.query('SELECT 1 FROM DUMMY');
+            return { ok: true, value: undefined };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: new RagError(String(err), 'HEALTH_CHECK_ERROR'),
+            };
+        }
+    }
+    async upsert(text, metadata, options) {
+        if (options?.signal?.aborted)
+            return { ok: false, error: new RagError('Aborted', 'ABORTED') };
+        try {
+            const { vector } = await this.embedder.embed(text, options);
+            return this.upsertKnown(text, vector, metadata);
+        }
+        catch (err) {
+            return { ok: false, error: new RagError(String(err), 'UPSERT_ERROR') };
+        }
+    }
+    async upsertPrecomputed(text, vector, metadata) {
+        return this.upsertKnown(text, vector, metadata);
+    }
+    async upsertKnown(text, vector, metadata) {
+        try {
+            await this.maybeEnsureSchema();
+            const client = await this.clientPromise;
+            const id = metadata?.id ?? crypto.randomUUID();
+            const { id: _omit, ...rest } = metadata ?? {};
+            const metaJson = JSON.stringify(rest);
+            const sql = `UPSERT ${quoteIdent(this.collectionName)} (id, text, vector, metadata) VALUES (?, ?, ${this.vectorLiteral(vector)}, ?) WITH PRIMARY KEY`;
+            await client.exec(sql, [id, text, metaJson]);
+            return { ok: true, value: undefined };
+        }
+        catch (err) {
+            return { ok: false, error: new RagError(String(err), 'UPSERT_ERROR') };
+        }
+    }
+    writer() {
+        return {
+            upsertRaw: async (id, text, metadata, options) => {
+                const r = await this.upsert(text, { ...metadata, id }, options);
+                return r.ok ? { ok: true, value: undefined } : r;
+            },
+            deleteByIdRaw: async (id) => {
+                try {
+                    await this.maybeEnsureSchema();
+                    const client = await this.clientPromise;
+                    const r = await client.exec(`DELETE FROM ${quoteIdent(this.collectionName)} WHERE id = ?`, [id]);
+                    return { ok: true, value: r.rowCount > 0 };
+                }
+                catch (err) {
+                    return {
+                        ok: false,
+                        error: new RagError(String(err), 'DELETE_ERROR'),
+                    };
+                }
+            },
+            clearAll: async () => {
+                try {
+                    await this.maybeEnsureSchema();
+                    const client = await this.clientPromise;
+                    await client.exec(`TRUNCATE TABLE ${quoteIdent(this.collectionName)}`);
+                    return { ok: true, value: undefined };
+                }
+                catch (err) {
+                    return { ok: false, error: new RagError(String(err), 'CLEAR_ERROR') };
+                }
+            },
+            upsertPrecomputedRaw: async (id, text, vector, metadata) => this.upsertPrecomputed(text, vector, { ...metadata, id }),
+        };
+    }
+}
+//# sourceMappingURL=hana-vector-rag.js.map

package/dist/hana-vector-rag.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { HanaVectorRagConfig } from './hana-vector-rag.js';
+export { HanaVectorRag } from './hana-vector-rag.js';
+export type { HanaVectorRagProviderConfig } from './hana-vector-rag-provider.js';
+export { HanaVectorRagProvider } from './hana-vector-rag-provider.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,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { HanaVectorRag } from './hana-vector-rag.js';
+export { HanaVectorRagProvider } from './hana-vector-rag-provider.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,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,5 @@
+export declare function assertCollectionName(name: string): void;
+export declare function quoteIdent(ident: string): string;
+export declare function createTableSql(collection: string, dimension: number): string;
+export declare function dropTableSql(collection: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAIA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS5E;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/schema.js

@@ -0,0 +1,25 @@
+import { RagError } from '@mcp-abap-adt/llm-agent';
+const COLLECTION_NAME_RE = /^[a-zA-Z_][a-zA-Z0-9_]{0,62}$/;
+export function assertCollectionName(name) {
+    if (!COLLECTION_NAME_RE.test(name)) {
+        throw new RagError(`Invalid collection name: ${name}`, 'INVALID_COLLECTION_NAME');
+    }
+}
+export function quoteIdent(ident) {
+    assertCollectionName(ident);
+    return `"${ident}"`;
+}
+export function createTableSql(collection, dimension) {
+    const table = quoteIdent(collection);
+    return `CREATE TABLE IF NOT EXISTS ${table} (
+    id NVARCHAR(255) PRIMARY KEY,
+    text NCLOB,
+    vector REAL_VECTOR(${dimension}),
+    metadata NCLOB,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+  )`;
+}
+export function dropTableSql(collection) {
+    return `DROP TABLE IF EXISTS ${quoteIdent(collection)}`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,kBAAkB,GAAG,+BAA+B,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAChB,4BAA4B,IAAI,EAAE,EAClC,yBAAyB,CAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,KAAK,GAAG,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,SAAiB;IAClE,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,8BAA8B,KAAK;;;yBAGnB,SAAS;;;IAG9B,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,wBAAwB,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@mcp-abap-adt/hana-vector-rag",
+  "version": "11.0.0",
+  "description": "HanaVectorRag vector store (SAP HANA Cloud Vector Engine) and HanaVectorRagProvider 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/hana-client": "^2.24.26"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/llm-agent.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}