@mcp-abap-adt/hana-vector-rag 26.0.0 → 28.0.0

package/README.md

@@ -18,16 +18,53 @@ npm install @mcp-abap-adt/hana-vector-rag @sap/hana-client
 ## Minimal config
 
 ```yaml
+# the address only; the login is a credential (required — HANA has no anonymous login)
 rag:
-  type: hana-vector
-  connectionString: hdbsql://user:pass@host:443
-  collectionName: llm_agent_docs
-  dimension: 1536
-  autoCreateSchema: true
+  store:
+    type: hana-vector
+    connectionString: hdbsql://host:443
+    collectionName: llm_agent_docs
+    dimension: 1536
+    autoCreateSchema: true
+    credentialRef: RAG_HANA          # the llm-agent binary reads RAG_HANA_USER and RAG_HANA_PASSWORD
 ```
 
+In code: `new HanaVectorRag({ connectionString: 'hdbsql://host:443', credential: staticLogin(user, password), … })`
+— `credential` is **required**, and a bare-string `connection` is refused at construction.
+
 See the monorepo root README for full configuration surface.
 
+## Catalog and the rights it needs
+
+`HanaVectorRagProvider` keeps one record per collection in a catalog table of its own
+(`rag_collection_catalog` by default, `catalogTable` to rename it), in the configured schema or the
+connection's current one. `createCollection` creates the collection's table and then writes its
+record; `deleteCollection` deletes the record first, then drops the table; `describeCollections`
+reads the catalog back. The database user the connection uses needs:
+
+| with `autoCreateSchema` | rights |
+|---|---|
+| `true` (default) | `CREATE ANY` on the schema (the catalog table on first use, one table per collection); `SELECT`, `INSERT`, `DELETE` on the catalog; `DROP` on the collection tables (it owns those it created); `SELECT` on `SYS.TABLES` (granted to `PUBLIC` by default) |
+| `false` | no creating DDL is issued: the operator creates the catalog with `createCatalogTableSql(table)` (exported) and each collection table. The user needs `SELECT`, `INSERT`, `DELETE` on the catalog, `SELECT`, `INSERT`, `UPDATE`, `DELETE` on the collection tables, and `DROP` on them — the flag governs creation only, and `deleteCollection` still drops the table |
+
+Without those rights `createCollection` fails where it used to succeed. A collection created before
+this release has a table and no record: take it over once with
+`createCollection(..., { adoptExisting: true })`.
+
+## Connections, and `clientFactory` for per-session hydration
+
+`openCollection` builds a collection's handles without a statement and without a connection; a
+handle connects on its first query or write. Without `clientFactory`, each handle then opens a
+connection of its own — one physical connection per collection handle, which nothing closes.
+Per-session hydration opens every one of a caller's catalog records in every session, so a
+deployment that hydrates per session should pass **`clientFactory` returning one shared client**:
+every handle and the provider's own catalog work then run on that client.
+
+```ts
+const shared = await createHanaClient({ host, credential: staticLogin(user, password), collectionName: '_' });
+new HanaVectorRagProvider({ name: 'hana', embedder, connection, clientFactory: () => shared });
+```
+
 ## License
 
 **GNU Lesser General Public License v3.0 only** (`LGPL-3.0-only`) — see

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

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

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

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

package/dist/__tests__/catalog.test.js

@@ -0,0 +1,266 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { CatalogRecordDeleteError, staticLogin } from '@mcp-abap-adt/llm-agent';
+import { HanaVectorRag } from '../hana-vector-rag.js';
+import { HanaVectorRagProvider } from '../hana-vector-rag-provider.js';
+import { fakeHana } from './fake-hana.js';
+const CATALOG = 'rag_collection_catalog';
+const STORE = 'my_notes_a1b2c3d4e5f6';
+const embedder = { embed: async () => ({ vector: [0, 0, 0] }) };
+const createOpts = {
+    scope: 'session',
+    sessionId: 's-1',
+    collectionName: 'my notes',
+    attributes: { role: 'analyst' },
+};
+const row = (over = {}) => ({
+    storeName: STORE,
+    name: 'my notes',
+    scope: 'global',
+    userId: null,
+    sessionId: null,
+    attributesJson: null,
+    ...over,
+});
+function providerOn(fake, autoCreateSchema = true) {
+    return new HanaVectorRagProvider({
+        name: 'hana',
+        embedder,
+        connection: {
+            host: 'h',
+            collectionName: '__unused',
+            credential: staticLogin('u', 'p'),
+        },
+        defaultDimension: 3,
+        autoCreateSchema,
+        clientFactory: () => fake.client,
+    });
+}
+const at = (fake, re) => fake.statements.findIndex((s) => re.test(s));
+const storeCreate = new RegExp(`^CREATE TABLE "${STORE}"`);
+const recordInsert = new RegExp(`^INSERT INTO "${CATALOG}"`);
+describe('hana catalog: createCollection', () => {
+    it('creates the store with a statement that fails if it exists, and records it last', async () => {
+        const fake = fakeHana();
+        const res = await providerOn(fake).createCollection(STORE, createOpts);
+        assert.equal(res.ok, true);
+        const createdAt = at(fake, storeCreate);
+        assert.ok(createdAt >= 0 && at(fake, recordInsert) > createdAt);
+        assert.equal(at(fake, new RegExp(`CREATE TABLE IF NOT EXISTS "${STORE}"`)), -1);
+        const described = await providerOn(fake).describeCollections();
+        assert.ok(described.ok);
+        assert.deepEqual(described.value.records, [
+            {
+                scope: 'session',
+                sessionId: 's-1',
+                storeName: STORE,
+                name: 'my notes',
+                attributes: { role: 'analyst' },
+            },
+        ]);
+    });
+    it('refuses a collection whose record exists', async () => {
+        const fake = fakeHana();
+        fake.tables.add(CATALOG);
+        fake.tables.add(STORE);
+        fake.records.set(STORE, row());
+        const res = await providerOn(fake).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_DUPLICATE_COLLECTION');
+        assert.equal(at(fake, storeCreate), -1);
+    });
+    it('refuses a store that exists without a record, naming it, and adopts it on request', async () => {
+        const fake = fakeHana();
+        fake.tables.add(STORE);
+        const refused = await providerOn(fake).createCollection(STORE, createOpts);
+        assert.equal(!refused.ok && refused.error.code, 'RAG_ORPHAN_STORE');
+        assert.match(!refused.ok ? refused.error.message : '', new RegExp(STORE));
+        const adopted = await providerOn(fake).createCollection(STORE, {
+            ...createOpts,
+            adoptExisting: true,
+        });
+        assert.equal(adopted.ok, true);
+        assert.ok(fake.records.has(STORE));
+    });
+    it('refuses adoptExisting for a store that is not there, and creates nothing', async () => {
+        const fake = fakeHana();
+        const res = await providerOn(fake).createCollection(STORE, {
+            ...createOpts,
+            adoptExisting: true,
+        });
+        assert.equal(!res.ok && res.error.code, 'RAG_CREATE_ERROR');
+        assert.ok(!fake.tables.has(STORE) && !fake.records.has(STORE));
+    });
+    it('leaves the store in place when the record cannot be written', async () => {
+        const fake = fakeHana();
+        fake.failOn = recordInsert;
+        const res = await providerOn(fake).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_ORPHAN_STORE');
+        assert.ok(fake.tables.has(STORE));
+        assert.equal(at(fake, /^DROP TABLE/), -1);
+    });
+    it('loses cleanly to a registry that recorded the same store first', async () => {
+        const fake = fakeHana();
+        fake.beforeInsertRecord = () => {
+            fake.records.set(STORE, row());
+        };
+        const res = await providerOn(fake).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_DUPLICATE_COLLECTION');
+        assert.ok(fake.tables.has(STORE));
+    });
+    it('refuses an owner without its key before any statement', async () => {
+        const fake = fakeHana();
+        const res = await providerOn(fake).createCollection(STORE, {
+            scope: 'session',
+        });
+        assert.equal(!res.ok && res.error.code, 'RAG_INVALID_OWNER');
+        assert.deepEqual(fake.statements, []);
+    });
+    it('with autoCreateSchema false issues no DDL, requires the store, and records it', async () => {
+        const fake = fakeHana();
+        fake.tables.add(CATALOG);
+        const missing = await providerOn(fake, false).createCollection(STORE, createOpts);
+        assert.equal(missing.ok, false);
+        fake.tables.add(STORE);
+        assert.equal((await providerOn(fake, false).createCollection(STORE, createOpts)).ok, true);
+        assert.equal(at(fake, /^CREATE /), -1);
+    });
+});
+describe('hana catalog: describeCollections', () => {
+    it('returns nothing, and creates nothing, when no catalog exists yet', async () => {
+        const fake = fakeHana();
+        assert.deepEqual(await providerOn(fake).describeCollections(), {
+            ok: true,
+            value: { records: [], rejected: [] },
+        });
+        assert.equal(at(fake, /^CREATE /), -1);
+    });
+    it('decodes an NCLOB handed back as a Buffer, and rejects malformed rows', async () => {
+        const fake = fakeHana();
+        fake.tables.add(CATALOG);
+        fake.records.set('a_1', row({
+            storeName: 'a_1',
+            attributesJson: Buffer.from('{"k":[1]}', 'utf8'),
+        }));
+        fake.records.set('b_1', row({ storeName: 'b_1', scope: 'session' }));
+        const res = await providerOn(fake).describeCollections();
+        assert.ok(res.ok);
+        assert.deepEqual(res.value.records, [
+            {
+                scope: 'global',
+                storeName: 'a_1',
+                name: 'my notes',
+                attributes: { k: [1] },
+            },
+        ]);
+        assert.deepEqual(res.value.rejected.map((r) => r.storeName), ['b_1']);
+    });
+});
+describe('hana catalog: openCollection', () => {
+    it('builds handles without a statement, and a write to a missing store fails instead of creating it', async () => {
+        const fake = fakeHana();
+        const record = {
+            storeName: STORE,
+            name: 'n',
+            scope: 'global',
+        };
+        const opened = await providerOn(fake).openCollection(record);
+        assert.ok(opened.ok);
+        assert.deepEqual(fake.statements, []);
+        assert.equal((await opened.value.editor.upsert('hello', { id: 'r1' })).ok, false);
+        assert.ok(!fake.tables.has(STORE));
+        assert.equal(at(fake, /^CREATE /), -1);
+    });
+});
+describe('hana: a handle connects on first use, never at openCollection', () => {
+    // Without clientFactory each handle opens its own connection. Per-session
+    // hydration opens one handle per record per session, so a handle that
+    // connected in its constructor opened a connection nobody used or closed.
+    // Resolving the credential is the first step of a connect, so counting its
+    // reads counts connection attempts without a driver.
+    it('openCollection reads no credential; the first use does', async () => {
+        let reads = 0;
+        const credential = {
+            ...staticLogin('u', 'pw'),
+            secret: async () => {
+                reads++;
+                throw new Error('no HANA here');
+            },
+        };
+        const provider = new HanaVectorRagProvider({
+            name: 'hana',
+            embedder,
+            connection: { host: 'h', collectionName: '__unused', credential },
+        });
+        const opened = await provider.openCollection({
+            storeName: STORE,
+            name: 'n',
+            scope: 'global',
+        });
+        assert.ok(opened.ok);
+        await new Promise((r) => setImmediate(r));
+        assert.equal(reads, 0, 'openCollection must open no connection');
+        const first = await opened.value.rag.healthCheck();
+        assert.equal(first.ok, false);
+        assert.equal(reads, 1);
+        // A failed connect is not memoized: the next use tries again.
+        await opened.value.rag.healthCheck();
+        assert.equal(reads, 2);
+    });
+});
+describe('hana: a failed first connect is retried on the schema path too', () => {
+    // A directly configured store (autoCreateSchema defaults to true) reaches the
+    // connection through ensureSchema; a failed bootstrap must not be kept either.
+    it('getById after a failed connect tries to connect again', async () => {
+        let reads = 0;
+        const credential = {
+            ...staticLogin('u', 'pw'),
+            secret: async () => {
+                reads++;
+                throw new Error('no HANA here');
+            },
+        };
+        const rag = new HanaVectorRag({
+            host: 'h',
+            collectionName: 'docs',
+            dimension: 3,
+            embedder,
+            credential,
+        });
+        assert.equal((await rag.getById('x')).ok, false);
+        assert.equal(reads, 1);
+        assert.equal((await rag.getById('x')).ok, false);
+        assert.equal(reads, 2);
+    });
+});
+describe('hana catalog: deleteCollection', () => {
+    const seeded = () => {
+        const fake = fakeHana();
+        fake.tables.add(CATALOG);
+        fake.tables.add(STORE);
+        fake.records.set(STORE, row());
+        return fake;
+    };
+    it('deletes the record before the data', async () => {
+        const fake = seeded();
+        assert.equal((await providerOn(fake).deleteCollection(STORE)).ok, true);
+        const recordAt = at(fake, new RegExp(`^DELETE FROM "${CATALOG}"`));
+        assert.ok(recordAt >= 0 &&
+            at(fake, new RegExp(`^DROP TABLE IF EXISTS "${STORE}"`)) > recordAt);
+    });
+    it('leaves record and data alone when the record cannot be deleted', async () => {
+        const fake = seeded();
+        fake.failOn = new RegExp(`^DELETE FROM "${CATALOG}"`);
+        const res = await providerOn(fake).deleteCollection(STORE);
+        assert.ok(!res.ok && res.error instanceof CatalogRecordDeleteError);
+        assert.equal(at(fake, /^DROP TABLE/), -1);
+        assert.ok(fake.records.has(STORE) && fake.tables.has(STORE));
+    });
+    it('reports a data failure after the record is gone as a plain delete error', async () => {
+        const fake = seeded();
+        fake.failOn = /^DROP TABLE/;
+        const res = await providerOn(fake).deleteCollection(STORE);
+        assert.equal(!res.ok && res.error.code, 'RAG_DELETE_ERROR');
+        assert.ok(!fake.records.has(STORE));
+    });
+});
+//# sourceMappingURL=catalog.test.js.map

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

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

package/dist/__tests__/connection.test.js

@@ -1,13 +1,13 @@
 import assert from 'node:assert/strict';
 import { describe, it } from 'node:test';
+import { staticLogin } from '@mcp-abap-adt/llm-agent';
 import { resolveHanaConnectArgs } from '../connection.js';
 describe('resolveHanaConnectArgs', () => {
-    it('accepts explicit fields', () => {
-        const args = resolveHanaConnectArgs({
+    it('accepts explicit fields', async () => {
+        const args = await resolveHanaConnectArgs({
             host: 'h.example.com',
             port: 443,
-            user: 'U1',
-            password: 'pw',
+            credential: staticLogin('U1', 'pw'),
             collectionName: 't',
         });
         assert.equal(args.serverNode, 'h.example.com:443');
@@ -15,19 +15,19 @@ describe('resolveHanaConnectArgs', () => {
         assert.equal(args.pwd, 'pw');
         assert.equal(args.encrypt, 'true');
     });
-    it('parses hdbsql URL', () => {
-        const args = resolveHanaConnectArgs({
-            connectionString: 'hdbsql://u:p@host.example:443',
+    it('parses hdbsql URL carrying the address only', async () => {
+        const args = await resolveHanaConnectArgs({
+            connectionString: 'hdbsql://host.example:443',
+            credential: staticLogin('u', 'p'),
             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',
+    it('rejects missing host', async () => {
+        await assert.rejects(() => resolveHanaConnectArgs({
+            credential: staticLogin('u', 'p'),
             collectionName: 't',
         }), /host/i);
     });

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

@@ -1 +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"}
+{"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,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,GAAG;YACT,UAAU,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;YACnC,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,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,gBAAgB,EAAE,2BAA2B;YAC7C,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,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,KAAK,IAAI,EAAE;QACpC,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,sBAAsB,CAAC;YACrB,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,cAAc,EAAE,GAAG;SACpB,CAAC,EACJ,OAAO,CACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/credential.test.js

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { staticLogin } from '@mcp-abap-adt/llm-agent';
+import { resolveHanaConnectArgs } from '../connection.js';
+describe('resolveHanaConnectArgs', () => {
+    it('takes the identity and the secret from the credential', async () => {
+        const args = await resolveHanaConnectArgs({
+            host: 'h',
+            collectionName: 't',
+            credential: staticLogin('cred_user', 'cred_pw'),
+        });
+        assert.equal(args.uid, 'cred_user');
+        assert.equal(args.pwd, 'cred_pw');
+    });
+    it('accepts a connection string that carries the ADDRESS only', async () => {
+        const args = await resolveHanaConnectArgs({
+            connectionString: 'hdbsql://h:443',
+            collectionName: 't',
+            credential: staticLogin('cred_user', 'cred_pw'),
+        });
+        assert.equal(args.uid, 'cred_user');
+        assert.equal(args.pwd, 'cred_pw');
+    });
+    it('REFUSES a connection string carrying credentials, naming the fix', async () => {
+        await assert.rejects(() => resolveHanaConnectArgs({
+            connectionString: 'hdbsql://u:pw@h:443',
+            collectionName: 't',
+            credential: staticLogin('cred_user', 'cred_pw'),
+        }), /staticLogin/, 'silently ignoring the embedded password is the failure this replaces');
+    });
+});
+//# sourceMappingURL=credential.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credential.test.js","sourceRoot":"","sources":["../../src/__tests__/credential.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,IAAI,EAAE,GAAG;YACT,cAAc,EAAE,GAAG;YACnB,UAAU,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC;SAChD,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,gBAAgB,EAAE,gBAAgB;YAClC,cAAc,EAAE,GAAG;YACnB,UAAU,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC;SAChD,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,sBAAsB,CAAC;YACrB,gBAAgB,EAAE,qBAAqB;YACvC,cAAc,EAAE,GAAG;YACnB,UAAU,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC;SAChD,CAAC,EACJ,aAAa,EACb,sEAAsE,CACvE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/fake-hana.d.ts

@@ -0,0 +1,19 @@
+import type { HanaClient } from '../hana-vector-rag.js';
+export type FakeCatalogRow = {
+    storeName: string;
+    name: unknown;
+    scope: unknown;
+    userId: unknown;
+    sessionId: unknown;
+    attributesJson: unknown;
+};
+export type FakeHana = {
+    readonly client: HanaClient;
+    readonly tables: Set<string>;
+    readonly records: Map<string, FakeCatalogRow>;
+    readonly statements: string[];
+    failOn?: RegExp;
+    beforeInsertRecord?: () => void;
+};
+export declare function fakeHana(catalog?: string): FakeHana;
+//# sourceMappingURL=fake-hana.d.ts.map

package/dist/__tests__/fake-hana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-hana.d.ts","sourceRoot":"","sources":["../../src/__tests__/fake-hana.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAIF,wBAAgB,QAAQ,CAAC,OAAO,SAA2B,GAAG,QAAQ,CAcrE"}

package/dist/__tests__/fake-hana.js

@@ -0,0 +1,87 @@
+export function fakeHana(catalog = 'rag_collection_catalog') {
+    const fake = {
+        tables: new Set(),
+        records: new Map(),
+        statements: [],
+        client: {
+            exec: async (sql, params = []) => ({
+                rowCount: answer(fake, catalog, sql, params).length,
+            }),
+            query: async (sql, params = []) => answer(fake, catalog, sql, params),
+            close: async () => { },
+        },
+    };
+    return fake;
+}
+function requireTable(fake, table) {
+    if (!fake.tables.has(table))
+        throw new Error(`invalid table name: ${table}`);
+}
+function answer(fake, catalog, sql, params) {
+    fake.statements.push(sql);
+    if (fake.failOn?.test(sql))
+        throw new Error(`refused by the test: ${sql.slice(0, 60)}`);
+    const q = `"${catalog}"`;
+    if (sql.startsWith('SELECT COUNT(*) AS "n" FROM SYS.TABLES')) {
+        return [{ n: fake.tables.has(String(params[params.length - 1])) ? 1 : 0 }];
+    }
+    const create = sql.match(/^CREATE TABLE (IF NOT EXISTS )?"([^"]+)"/);
+    if (create) {
+        const [, ifNotExists, table] = create;
+        if (fake.tables.has(table)) {
+            if (ifNotExists)
+                return [];
+            throw new Error(`cannot use duplicate table name: ${table}`);
+        }
+        fake.tables.add(table);
+        return [];
+    }
+    const probe = sql.match(/^SELECT COUNT\(\*\) AS "n" FROM "([^"]+)" WHERE 1 = 0$/);
+    if (probe) {
+        requireTable(fake, probe[1]);
+        return [{ n: 0 }];
+    }
+    if (sql.startsWith(`SELECT 1 AS "present" FROM ${q}`)) {
+        requireTable(fake, catalog);
+        return fake.records.has(String(params[0])) ? [{ present: 1 }] : [];
+    }
+    if (sql.startsWith(`INSERT INTO ${q}`)) {
+        requireTable(fake, catalog);
+        fake.beforeInsertRecord?.();
+        const storeName = String(params[0]);
+        if (fake.records.has(storeName))
+            throw new Error('unique constraint violated');
+        fake.records.set(storeName, {
+            storeName,
+            name: params[1],
+            scope: params[2],
+            userId: params[3],
+            sessionId: params[4],
+            attributesJson: params[5],
+        });
+        return [{}];
+    }
+    if (sql.startsWith('SELECT store_name AS "storeName"')) {
+        requireTable(fake, catalog);
+        return [...fake.records.values()];
+    }
+    if (sql.startsWith(`DELETE FROM ${q}`)) {
+        requireTable(fake, catalog);
+        return fake.records.delete(String(params[0])) ? [{}] : [];
+    }
+    const drop = sql.match(/^DROP TABLE IF EXISTS "([^"]+)"$/);
+    if (drop) {
+        fake.tables.delete(drop[1]);
+        return [];
+    }
+    const write = sql.match(/^UPSERT "([^"]+)" \(id, text, vector, metadata\)/);
+    if (write) {
+        requireTable(fake, write[1]);
+        return [{}];
+    }
+    if (sql.startsWith('SELECT TABLE_NAME FROM SYS.TABLES')) {
+        return [...fake.tables].map((t) => ({ TABLE_NAME: t }));
+    }
+    throw new Error(`fake hana: unhandled statement: ${sql}`);
+}
+//# sourceMappingURL=fake-hana.js.map

package/dist/__tests__/fake-hana.js.map

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

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

@@ -1,5 +1,6 @@
 import assert from 'node:assert/strict';
 import { describe, it } from 'node:test';
+import { staticLogin } from '@mcp-abap-adt/llm-agent';
 import { HanaVectorRagProvider } from '../hana-vector-rag-provider.js';
 function makeEmbedder() {
     return {
@@ -32,8 +33,7 @@ describe('HanaVectorRagProvider', () => {
             connection: {
                 collectionName: '__ignored',
                 host: 'h',
-                user: 'u',
-                password: 'p',
+                credential: staticLogin('u', 'p'),
             },
             defaultDimension: 3,
             autoCreateSchema: true,
@@ -56,8 +56,7 @@ describe('HanaVectorRagProvider', () => {
             connection: {
                 collectionName: '__ignored',
                 host: 'h',
-                user: 'u',
-                password: 'p',
+                credential: staticLogin('u', 'p'),
             },
             defaultDimension: 3,
             autoCreateSchema: false,
@@ -75,8 +74,7 @@ describe('HanaVectorRagProvider', () => {
             connection: {
                 collectionName: '__ignored',
                 host: 'h',
-                user: 'u',
-                password: 'p',
+                credential: staticLogin('u', 'p'),
             },
             clientFactory: () => client,
         });
@@ -95,8 +93,7 @@ describe('HanaVectorRagProvider', () => {
             connection: {
                 collectionName: '__ignored',
                 host: 'h',
-                user: 'u',
-                password: 'p',
+                credential: staticLogin('u', 'p'),
             },
             clientFactory: () => client,
         });
@@ -114,13 +111,15 @@ describe('HanaVectorRagProvider', () => {
             connection: {
                 collectionName: '__ignored',
                 host: 'h',
-                user: 'u',
-                password: 'p',
+                credential: staticLogin('u', 'p'),
             },
             clientFactory: () => client,
             supportedScopes: ['global'],
         });
-        const r = await provider.createCollection('docs', { scope: 'session' });
+        const r = await provider.createCollection('docs', {
+            scope: 'session',
+            sessionId: 's1',
+        });
         assert.equal(r.ok, false);
     });
 });