@mcp-abap-adt/qdrant-rag 26.0.0 → 28.0.0

package/README.md

@@ -7,6 +7,28 @@ QdrantRag vector store and QdrantRagProvider for @mcp-abap-adt/llm-agent.
 
 Provides vector search capabilities using Qdrant as the backend.
 
+Requires Qdrant 1.17 or later: the collection catalog is written with an insert-only operation.
+
+## Catalog, rights, and the Qdrant version
+
+`QdrantRagProvider` keeps one record per collection in a catalog collection of its own
+(`rag_collection_catalog` by default, `catalogCollection` to rename it): one point per collection,
+the record in its payload. `createCollection` embeds one probe string to learn the vector size,
+creates the collection, and then writes its record; `deleteCollection` deletes the record first, then
+the collection; `describeCollections` reads the catalog back.
+
+- **Qdrant 1.17 or later is required** for a catalogued store: the record is written with
+  `update_mode: "insert_only"`, which exists from 1.17.
+- **The key must be able to manage collections**: create collections (the catalog on first use, one
+  per collection), write, read and delete points in the catalog, and delete collections. A
+  `read-only-api-key`, or a JWT restricted to named collections, is not enough.
+- A standalone `QdrantRag` (a store configured directly, not through the provider) keeps creating
+  its collection on the first write (`autoCreateCollection`, default `true`); the provider's handles
+  never create theirs.
+
+A collection created before this release has a collection and no record: take it over once with
+`createCollection(..., { adoptExisting: true })`.
+
 ## 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,241 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { CatalogRecordDeleteError } from '@mcp-abap-adt/llm-agent';
+import { deterministicUUID, QdrantRag } from '../qdrant-rag.js';
+import { QdrantRagProvider } from '../qdrant-rag-provider.js';
+import { startQdrantStub, } from './qdrant-stub.js';
+const CATALOG = 'rag_collection_catalog';
+const STORE = 'my_notes_a1b2c3d4e5f6';
+const createOpts = {
+    scope: 'user',
+    userId: 'u-1',
+    collectionName: 'my notes',
+    attributes: { role: 'analyst' },
+};
+class CountingEmbedder {
+    dim;
+    calls = 0;
+    constructor(dim = 3) {
+        this.dim = dim;
+    }
+    async embed() {
+        this.calls++;
+        return { vector: Array.from({ length: this.dim }, () => 0.5) };
+    }
+}
+function providerOn(stub, embedder = new CountingEmbedder()) {
+    return new QdrantRagProvider({ name: 'q', url: stub.baseUrl, embedder });
+}
+async function withStub(run) {
+    const stub = await startQdrantStub();
+    try {
+        await run(stub);
+    }
+    finally {
+        await stub.close();
+    }
+}
+const is = (method, path) => (r) => r.method === method && r.path === path;
+const indexOf = (stub, method, path) => stub.requests.findIndex(is(method, path));
+async function seedRecord(stub, storeName, payload) {
+    if (!stub.collections.has(CATALOG))
+        stub.collections.set(CATALOG, { size: 1, points: new Map() });
+    const id = await deterministicUUID(storeName);
+    stub.collections.get(CATALOG)?.points.set(id, { id, vector: [1], payload });
+}
+describe('qdrant catalog: createCollection', () => {
+    it('creates the collection with the probe size, then records it last, spending one embedding', () => withStub(async (stub) => {
+        const embedder = new CountingEmbedder(3);
+        const res = await providerOn(stub, embedder).createCollection(STORE, createOpts);
+        assert.ok(res.ok);
+        assert.ok(res.value.rag instanceof QdrantRag);
+        assert.equal(embedder.calls, 1, 'one probe embedding per collection created');
+        assert.equal(stub.collections.get(STORE)?.size, 3);
+        const createdAt = indexOf(stub, 'PUT', `/collections/${STORE}`);
+        const recordAt = indexOf(stub, 'PUT', `/collections/${CATALOG}/points`);
+        assert.ok(createdAt >= 0 && recordAt > createdAt, 'store first, record last');
+        const described = await providerOn(stub).describeCollections();
+        assert.ok(described.ok);
+        assert.deepEqual(described.value, {
+            records: [
+                {
+                    scope: 'user',
+                    userId: 'u-1',
+                    storeName: STORE,
+                    name: 'my notes',
+                    attributes: { role: 'analyst' },
+                },
+            ],
+            rejected: [],
+        });
+    }));
+    it('refuses a collection whose record exists, and creates nothing', () => withStub(async (stub) => {
+        await seedRecord(stub, STORE, {
+            store_name: STORE,
+            collection_name: 'x',
+            scope: 'global',
+            attributes_json: null,
+            write_id: 'w',
+        });
+        const res = await providerOn(stub).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_DUPLICATE_COLLECTION');
+        assert.equal(indexOf(stub, 'PUT', `/collections/${STORE}`), -1);
+    }));
+    it('refuses a collection that exists without a record, naming it, and adopts it on request', () => withStub(async (stub) => {
+        stub.collections.set(STORE, { size: 3, points: new Map() });
+        const refused = await providerOn(stub).createCollection(STORE, createOpts);
+        assert.equal(!refused.ok && refused.error.code, 'RAG_ORPHAN_STORE');
+        assert.match(!refused.ok ? refused.error.message : '', new RegExp(STORE));
+        const embedder = new CountingEmbedder();
+        const adopted = await providerOn(stub, embedder).createCollection(STORE, {
+            ...createOpts,
+            adoptExisting: true,
+        });
+        assert.equal(adopted.ok, true);
+        assert.equal(embedder.calls, 0, 'adoption creates nothing, so it embeds nothing');
+        const records = await providerOn(stub).describeCollections();
+        assert.ok(records.ok && records.value.records.length === 1);
+    }));
+    it('refuses adoptExisting for a collection that is not there, and creates nothing', () => withStub(async (stub) => {
+        const res = await providerOn(stub).createCollection(STORE, {
+            ...createOpts,
+            adoptExisting: true,
+        });
+        assert.equal(!res.ok && res.error.code, 'RAG_CREATE_ERROR');
+        assert.ok(!stub.collections.has(STORE));
+    }));
+    it('leaves the collection in place, named, when the record cannot be written', () => withStub(async (stub) => {
+        stub.failOn = is('PUT', `/collections/${CATALOG}/points`);
+        const res = await providerOn(stub).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_ORPHAN_STORE');
+        assert.ok(stub.collections.has(STORE));
+        assert.equal(indexOf(stub, 'DELETE', `/collections/${STORE}`), -1);
+    }));
+    it('loses cleanly when another registry recorded the same collection first', () => withStub(async (stub) => {
+        // computed before the race: the hook is synchronous and must land the
+        // winner's point before the stub applies this call's insert_only write
+        const winnerId = await deterministicUUID(STORE);
+        stub.beforeCatalogWrite = () => {
+            stub.beforeCatalogWrite = undefined;
+            stub.collections.get(CATALOG)?.points.set(winnerId, {
+                id: winnerId,
+                vector: [1],
+                payload: {
+                    store_name: STORE,
+                    collection_name: 'my notes',
+                    scope: 'user',
+                    user_id: 'u-1',
+                    attributes_json: null,
+                    write_id: 'the-winner',
+                },
+            });
+        };
+        const res = await providerOn(stub).createCollection(STORE, createOpts);
+        assert.equal(!res.ok && res.error.code, 'RAG_DUPLICATE_COLLECTION');
+        assert.ok(stub.collections.has(STORE), "the winner's record points at it");
+    }));
+    it('refuses an owner without its key before any request', () => withStub(async (stub) => {
+        const res = await providerOn(stub).createCollection(STORE, {
+            scope: 'user',
+        });
+        assert.equal(!res.ok && res.error.code, 'RAG_INVALID_OWNER');
+        assert.deepEqual(stub.requests, []);
+    }));
+});
+describe('qdrant catalog: no handle creates its collection', () => {
+    it('openCollection issues no request, and a write to a missing collection fails instead of creating it', () => withStub(async (stub) => {
+        const record = {
+            storeName: STORE,
+            name: 'n',
+            scope: 'global',
+        };
+        const opened = await providerOn(stub).openCollection(record);
+        assert.ok(opened.ok);
+        assert.deepEqual(stub.requests, []);
+        assert.equal((await opened.value.editor.upsert('hello', { id: 'r1' })).ok, false);
+        assert.ok(!stub.collections.has(STORE));
+        assert.equal(indexOf(stub, 'PUT', `/collections/${STORE}`), -1);
+    }));
+    it('openCollection answers a failed Result, never a rejection, when building a handle throws', async () => {
+        const provider = new QdrantRagProvider({
+            name: 'q',
+            url: 'http://127.0.0.1:9', // never contacted: no request is made
+            embedder: new CountingEmbedder(),
+            idStrategyFactory: () => {
+                throw new Error('id strategy refused');
+            },
+        });
+        const opened = await provider.openCollection({
+            storeName: STORE,
+            name: 'n',
+            scope: 'global',
+        });
+        assert.equal(opened.ok, false);
+        assert.ok(!opened.ok && opened.error.code === 'RAG_OPEN_ERROR');
+        assert.match(!opened.ok ? opened.error.message : '', /id strategy refused/);
+    });
+    it('a handle whose collection was deleted elsewhere fails rather than recreating it', () => withStub(async (stub) => {
+        const created = await providerOn(stub).createCollection(STORE, createOpts);
+        assert.ok(created.ok);
+        stub.collections.delete(STORE);
+        assert.equal((await created.value.editor.upsert('hello', { id: 'r1' })).ok, false);
+        assert.ok(!stub.collections.has(STORE));
+    }));
+});
+describe('qdrant catalog: describeCollections', () => {
+    it('returns nothing, and creates nothing, when no catalog exists yet', () => withStub(async (stub) => {
+        assert.deepEqual(await providerOn(stub).describeCollections(), {
+            ok: true,
+            value: { records: [], rejected: [] },
+        });
+        assert.equal(indexOf(stub, 'PUT', `/collections/${CATALOG}`), -1);
+    }));
+    it('pages through the catalog and rejects malformed points', () => withStub(async (stub) => {
+        for (let i = 0; i < 257; i++) {
+            await seedRecord(stub, `s_${i}`, {
+                store_name: `s_${i}`,
+                collection_name: `c${i}`,
+                scope: 'global',
+                attributes_json: null,
+                write_id: 'w',
+            });
+        }
+        await seedRecord(stub, 'bad_1', {
+            store_name: 'bad_1',
+            collection_name: 'c',
+            scope: 'session',
+            attributes_json: null,
+            write_id: 'w',
+        });
+        const res = await providerOn(stub).describeCollections();
+        assert.ok(res.ok);
+        assert.equal(res.value.records.length, 257);
+        assert.deepEqual(res.value.rejected.map((r) => r.storeName), ['bad_1']);
+    }));
+});
+describe('qdrant catalog: deleteCollection', () => {
+    it('deletes the record before the collection', () => withStub(async (stub) => {
+        assert.ok((await providerOn(stub).createCollection(STORE, createOpts)).ok);
+        assert.equal((await providerOn(stub).deleteCollection(STORE)).ok, true);
+        const recordAt = indexOf(stub, 'POST', `/collections/${CATALOG}/points/delete`);
+        const dataAt = indexOf(stub, 'DELETE', `/collections/${STORE}`);
+        assert.ok(recordAt >= 0 && dataAt > recordAt);
+        const records = await providerOn(stub).describeCollections();
+        assert.ok(records.ok && records.value.records.length === 0);
+    }));
+    it('stops with CatalogRecordDeleteError, touching nothing, when the record cannot be deleted', () => withStub(async (stub) => {
+        assert.ok((await providerOn(stub).createCollection(STORE, createOpts)).ok);
+        stub.failOn = is('POST', `/collections/${CATALOG}/points/delete`);
+        const res = await providerOn(stub).deleteCollection(STORE);
+        assert.ok(!res.ok && res.error instanceof CatalogRecordDeleteError);
+        assert.equal(indexOf(stub, 'DELETE', `/collections/${STORE}`), -1);
+        assert.ok(stub.collections.has(STORE));
+    }));
+    it('reports a collection failure after the record is gone as a plain delete error', () => withStub(async (stub) => {
+        assert.ok((await providerOn(stub).createCollection(STORE, createOpts)).ok);
+        stub.failOn = is('DELETE', `/collections/${STORE}`);
+        const res = await providerOn(stub).deleteCollection(STORE);
+        assert.equal(!res.ok && res.error.code, 'RAG_DELETE_ERROR');
+    }));
+});
+//# 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__/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,93 @@
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import { after, before, describe, it } from 'node:test';
+import { staticApiKey } from '@mcp-abap-adt/llm-agent';
+import { QdrantRag } from '../qdrant-rag.js';
+function makeEmbedder(dim = 3) {
+    return {
+        async embed(text) {
+            let hash = 0;
+            for (const ch of text)
+                hash = (hash * 31 + ch.charCodeAt(0)) | 0;
+            return {
+                vector: Array.from({ length: dim }, (_, i) => ((hash >> i) & 0xff) / 255),
+            };
+        },
+    };
+}
+describe('QdrantRag credential', () => {
+    let server;
+    let baseUrl;
+    const receivedApiKeyHeaders = [];
+    before(async () => {
+        server = http.createServer((req, res) => {
+            receivedApiKeyHeaders.push(req.headers['api-key']);
+            if (req.url?.match(/^\/collections\/[^/]+$/) && req.method === 'GET') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ result: { status: 'green' } }));
+                return;
+            }
+            res.writeHead(404);
+            res.end();
+        });
+        await new Promise((resolve) => {
+            server.listen(0, '127.0.0.1', resolve);
+        });
+        const addr = server.address();
+        if (typeof addr === 'object' && addr) {
+            baseUrl = `http://127.0.0.1:${addr.port}`;
+        }
+    });
+    after(async () => {
+        await new Promise((resolve, reject) => {
+            server.close((err) => (err ? reject(err) : resolve()));
+        });
+    });
+    it('asks the credential for the secret on every request, not once at construction', async () => {
+        let calls = 0;
+        const credential = {
+            kind: 'api-key',
+            secret: async () => {
+                calls++;
+                return `key-${calls}`;
+            },
+        };
+        const rag = new QdrantRag({
+            url: baseUrl,
+            collectionName: 'test-cred',
+            embedder: makeEmbedder(),
+            credential,
+        });
+        assert.equal(calls, 0, 'constructing the store must not resolve the secret');
+        const first = await rag.healthCheck();
+        const second = await rag.healthCheck();
+        assert.ok(first.ok);
+        assert.ok(second.ok);
+        assert.equal(calls, 2, 'the secret is asked once per request, not cached');
+        assert.deepEqual(receivedApiKeyHeaders, ['key-1', 'key-2']);
+    });
+    it('sends the api-key header built from staticApiKey', async () => {
+        receivedApiKeyHeaders.length = 0;
+        const rag = new QdrantRag({
+            url: baseUrl,
+            collectionName: 'test-cred-static',
+            embedder: makeEmbedder(),
+            credential: staticApiKey('static-secret'),
+        });
+        const result = await rag.healthCheck();
+        assert.ok(result.ok);
+        assert.deepEqual(receivedApiKeyHeaders, ['static-secret']);
+    });
+    it('omits the api-key header when no credential is configured', async () => {
+        receivedApiKeyHeaders.length = 0;
+        const rag = new QdrantRag({
+            url: baseUrl,
+            collectionName: 'test-cred-none',
+            embedder: makeEmbedder(),
+        });
+        const result = await rag.healthCheck();
+        assert.ok(result.ok);
+        assert.deepEqual(receivedApiKeyHeaders, [undefined]);
+    });
+});
+//# 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":"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"}

package/dist/__tests__/qdrant-stub.d.ts

@@ -0,0 +1,52 @@
+export type StubPoint = {
+    id: string;
+    vector: number[];
+    payload: Record<string, unknown>;
+};
+export type StubRequest = {
+    method: string;
+    path: string;
+    body: unknown;
+};
+export type StubCollection = {
+    size: number;
+    points: Map<string, StubPoint>;
+};
+/** The Qdrant REST surface the provider uses, with the documented semantics:
+ *  a repeated collection PUT is 409, and insert_only skips an existing id. */
+export type QdrantStub = {
+    readonly baseUrl: string;
+    readonly collections: Map<string, StubCollection>;
+    readonly requests: StubRequest[];
+    failOn?: (r: StubRequest) => boolean;
+    /** Runs inside a points PUT to the catalog, before it is applied — a racing writer. */
+    beforeCatalogWrite?: () => void;
+    close(): Promise<void>;
+};
+export declare function startQdrantStub(catalog?: string): Promise<QdrantStub>;
+type QdrantCondition = {
+    key: string;
+    match: {
+        value: unknown;
+    };
+} | {
+    is_empty: {
+        key: string;
+    };
+} | {
+    key: string;
+    range: {
+        gt?: number;
+        gte?: number;
+        lt?: number;
+        lte?: number;
+    };
+} | QdrantFilter;
+export type QdrantFilter = {
+    must?: QdrantCondition[];
+    should?: QdrantCondition[];
+    must_not?: QdrantCondition[];
+};
+export declare function matchesFilter(payload: Record<string, unknown>, filter: QdrantFilter): boolean;
+export {};
+//# sourceMappingURL=qdrant-stub.d.ts.map

package/dist/__tests__/qdrant-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-stub.d.ts","sourceRoot":"","sources":["../../src/__tests__/qdrant-stub.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AACF,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,CAAC;AAE9E;8EAC8E;AAC9E,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;IACrC,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAsB,eAAe,CACnC,OAAO,SAA2B,GACjC,OAAO,CAAC,UAAU,CAAC,CA4KrB;AAUD,KAAK,eAAe,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC1C;IAAE,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7B;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,GACD,YAAY,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AA6BF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,YAAY,GACnB,OAAO,CAUT"}