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

package/dist/__tests__/qdrant-stub.js

@@ -0,0 +1,206 @@
+import http from 'node:http';
+export async function startQdrantStub(catalog = 'rag_collection_catalog') {
+    const collections = new Map();
+    const requests = [];
+    let stub;
+    const route = (r, reply) => {
+        const body = (r.body ?? {});
+        const missing = (name) => reply(404, {
+            status: { error: `Collection \`${name}\` doesn't exist!` },
+        });
+        const coll = r.path.match(/^\/collections\/([^/]+)$/);
+        if (coll) {
+            const name = coll[1];
+            const c = collections.get(name);
+            if (r.method === 'GET') {
+                if (!c) {
+                    missing(name);
+                    return;
+                }
+                reply(200, {
+                    result: {
+                        status: 'green',
+                        config: { params: { vectors: { size: c.size } } },
+                    },
+                });
+                return;
+            }
+            if (r.method === 'PUT') {
+                if (c) {
+                    reply(409, {
+                        status: { error: `Collection \`${name}\` already exists!` },
+                    });
+                    return;
+                }
+                const vectors = body.vectors;
+                collections.set(name, { size: vectors.size, points: new Map() });
+                reply(200, { result: true });
+                return;
+            }
+            if (r.method === 'DELETE') {
+                collections.delete(name);
+                reply(200, { result: true });
+                return;
+            }
+        }
+        if (r.path === '/collections' && r.method === 'GET') {
+            reply(200, {
+                result: {
+                    collections: [...collections.keys()].map((name) => ({ name })),
+                },
+            });
+            return;
+        }
+        const pts = r.path.match(/^\/collections\/([^/]+)\/points(\/scroll|\/delete|\/search)?$/);
+        if (pts) {
+            const name = pts[1];
+            const action = pts[2];
+            const c = collections.get(name);
+            if (!c) {
+                missing(name);
+                return;
+            }
+            if (r.method === 'PUT' && action === undefined) {
+                if (name === catalog)
+                    stub?.beforeCatalogWrite?.();
+                const insertOnly = body.update_mode === 'insert_only';
+                for (const p of body.points) {
+                    if (insertOnly && c.points.has(p.id))
+                        continue;
+                    c.points.set(p.id, p);
+                }
+                reply(200, { result: { status: 'completed' } });
+                return;
+            }
+            if (r.method === 'POST' && action === undefined) {
+                const ids = body.ids;
+                reply(200, {
+                    result: ids.flatMap((id) => {
+                        const p = c.points.get(id);
+                        return p ? [{ id, payload: p.payload }] : [];
+                    }),
+                });
+                return;
+            }
+            if (r.method === 'POST' && action === '/scroll') {
+                const ids = [...c.points.keys()].sort();
+                const start = body.offset === undefined ? 0 : ids.indexOf(String(body.offset));
+                const limit = Number(body.limit ?? 10);
+                reply(200, {
+                    result: {
+                        points: ids
+                            .slice(start, start + limit)
+                            .map((id) => ({ id, payload: c.points.get(id)?.payload })),
+                        next_page_offset: ids[start + limit] ?? null,
+                    },
+                });
+                return;
+            }
+            if (r.method === 'POST' && action === '/delete') {
+                for (const id of body.points ?? [])
+                    c.points.delete(id);
+                if (body.filter !== undefined)
+                    c.points.clear();
+                reply(200, { result: { status: 'completed' } });
+                return;
+            }
+            if (r.method === 'POST' && action === '/search') {
+                // Qdrant's documented search: the filter is applied inside the
+                // search, then points are ordered by cosine similarity and cut at
+                // `limit` — so the conformance cases see what a real server returns.
+                const query = body.vector;
+                const filter = body.filter;
+                const limit = Number(body.limit ?? 10);
+                const hits = [...c.points.values()]
+                    .filter((p) => filter === undefined || matchesFilter(p.payload, filter))
+                    .map((p) => ({
+                    id: p.id,
+                    score: cosine(query, p.vector),
+                    payload: p.payload,
+                }))
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, limit);
+                reply(200, { result: hits });
+                return;
+            }
+        }
+        reply(404, { status: { error: 'not found' } });
+    };
+    const server = http.createServer((req, res) => {
+        let raw = '';
+        req.on('data', (chunk) => {
+            raw += chunk.toString('utf8');
+        });
+        req.on('end', () => {
+            const request = {
+                method: req.method ?? 'GET',
+                path: new URL(req.url ?? '/', 'http://stub').pathname,
+                body: raw ? JSON.parse(raw) : undefined,
+            };
+            requests.push(request);
+            const reply = (status, body) => {
+                res.writeHead(status, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(body));
+            };
+            if (stub?.failOn?.(request)) {
+                reply(500, { status: { error: 'refused by the test' } });
+                return;
+            }
+            route(request, reply);
+        });
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const addr = server.address();
+    if (typeof addr !== 'object' || addr === null)
+        throw new Error('the stub did not bind');
+    stub = {
+        baseUrl: `http://127.0.0.1:${addr.port}`,
+        collections,
+        requests,
+        close: () => new Promise((resolve, reject) => server.close((err) => (err ? reject(err) : resolve()))),
+    };
+    return stub;
+}
+function holds(payload, cond) {
+    if ('is_empty' in cond) {
+        const v = payload[cond.is_empty.key];
+        return (v === undefined || v === null || (Array.isArray(v) && v.length === 0));
+    }
+    if ('match' in cond) {
+        return cond.key in payload && payload[cond.key] === cond.match.value;
+    }
+    if ('range' in cond) {
+        const v = payload[cond.key];
+        if (typeof v !== 'number')
+            return false;
+        const { gt, gte, lt, lte } = cond.range;
+        return ((gt === undefined || v > gt) &&
+            (gte === undefined || v >= gte) &&
+            (lt === undefined || v < lt) &&
+            (lte === undefined || v <= lte));
+    }
+    return matchesFilter(payload, cond);
+}
+export function matchesFilter(payload, filter) {
+    if (filter.must && !filter.must.every((c) => holds(payload, c)))
+        return false;
+    if (filter.should &&
+        filter.should.length > 0 &&
+        !filter.should.some((c) => holds(payload, c)))
+        return false;
+    if (filter.must_not?.some((c) => holds(payload, c)))
+        return false;
+    return true;
+}
+function cosine(a, b) {
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        na += a[i] ** 2;
+        nb += b[i] ** 2;
+    }
+    return dot / (Math.sqrt(na) * Math.sqrt(nb) || 1);
+}
+//# sourceMappingURL=qdrant-stub.js.map

package/dist/__tests__/qdrant-stub.js.map

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

package/dist/__tests__/rag-filter-conformance.test.d.ts

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

package/dist/__tests__/rag-filter-conformance.test.d.ts.map

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

package/dist/__tests__/rag-filter-conformance.test.js

@@ -0,0 +1,25 @@
+import { after, before, describe, it } from 'node:test';
+import { conformanceEmbedder, ragFilterConformanceCases, } from '@mcp-abap-adt/llm-agent/testing/rag-filter-conformance';
+import { QdrantRag } from '../qdrant-rag.js';
+import { startQdrantStub } from './qdrant-stub.js';
+// The shared conformance kit over QdrantRag, against a stub that evaluates the
+// search filter with Qdrant's documented semantics. The same cases run live
+// against a real Qdrant in the release check.
+describe('QdrantRag — filter conformance (stub)', () => {
+    let stub;
+    let n = 0;
+    before(async () => {
+        stub = await startQdrantStub();
+    });
+    after(async () => {
+        await stub.close();
+    });
+    for (const c of ragFilterConformanceCases) {
+        it(c.name, () => c.run(async () => new QdrantRag({
+            url: stub.baseUrl,
+            collectionName: `conf_${n++}`,
+            embedder: conformanceEmbedder(),
+        })));
+    }
+});
+//# sourceMappingURL=rag-filter-conformance.test.js.map

package/dist/__tests__/rag-filter-conformance.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-filter-conformance.test.js","sourceRoot":"","sources":["../../src/__tests__/rag-filter-conformance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAmB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEpE,+EAA+E;AAC/E,4EAA4E;AAC5E,8CAA8C;AAC9C,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,IAAI,IAAgB,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,CAAC,KAAK,IAAI,EAAE;QAChB,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC1C,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CACd,CAAC,CAAC,GAAG,CACH,KAAK,IAAI,EAAE,CACT,IAAI,SAAS,CAAC;YACZ,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,cAAc,EAAE,QAAQ,CAAC,EAAE,EAAE;YAC7B,QAAQ,EAAE,mBAAmB,EAAE;SAChC,CAAC,CACL,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { QdrantRagConfig } from './qdrant-rag.js';
 export { QdrantRag } from './qdrant-rag.js';
 export type { QdrantRagProviderConfig } from './qdrant-rag-provider.js';
-export { QdrantRagProvider } from './qdrant-rag-provider.js';
+export { DEFAULT_CATALOG_COLLECTION, QdrantRagProvider, } from './qdrant-rag-provider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
 export { QdrantRag } from './qdrant-rag.js';
-export { QdrantRagProvider } from './qdrant-rag-provider.js';
+export { DEFAULT_CATALOG_COLLECTION, QdrantRagProvider, } from './qdrant-rag-provider.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/qdrant-rag-provider.d.ts

@@ -1,9 +1,21 @@
-import type { IEmbedder, IIdStrategy, IRag, IRagEditor, RagCollectionScope } from '@mcp-abap-adt/llm-agent';
+import type { IApiKeyCredential } from '@mcp-abap-adt/interfaces-auth';
+import type { IEmbedder, IIdStrategy, IRag, IRagEditor, RagCatalogDescription, RagCollectionRecord, RagCollectionScope, RagProviderCreateCollectionOptions } from '@mcp-abap-adt/llm-agent';
 import { AbstractRagProvider as BaseRagProvider, RagError, type Result } from '@mcp-abap-adt/llm-agent';
+/** The collection a QdrantRagProvider keeps one point per collection in, by default. */
+export declare const DEFAULT_CATALOG_COLLECTION = "rag_collection_catalog";
+type Handles = {
+    rag: IRag;
+    editor: IRagEditor;
+};
 export interface QdrantRagProviderConfig {
     name: string;
     url: string;
-    apiKey?: string;
+    /**
+     * Asked for fresh on every request — never cached — so a rotating key
+     * rotates. Optional: an unauthenticated Qdrant deployment works today
+     * without one.
+     */
+    credential?: IApiKeyCredential;
     embedder: IEmbedder;
     editable?: boolean;
     timeoutMs?: number;
@@ -13,6 +25,8 @@ export interface QdrantRagProviderConfig {
         sessionId?: string;
         userId?: string;
     }) => IIdStrategy;
+    /** The collection holding one record point per collection. Default `rag_collection_catalog`. */
+    catalogCollection?: string;
 }
 export declare class QdrantRagProvider extends BaseRagProvider {
     readonly name: string;
@@ -20,19 +34,35 @@ export declare class QdrantRagProvider extends BaseRagProvider {
     readonly editable: boolean;
     readonly supportedScopes: readonly RagCollectionScope[];
     private readonly url;
-    private readonly apiKey?;
+    private readonly credential?;
     private readonly embedder;
     private readonly timeoutMs?;
+    private readonly catalog;
+    private catalogReady?;
     constructor(cfg: QdrantRagProviderConfig);
-    createCollection(name: string, opts: {
-        scope: RagCollectionScope;
-        sessionId?: string;
-        userId?: string;
-    }): Promise<Result<{
-        rag: IRag;
-        editor: IRagEditor;
-    }, RagError>>;
+    /**
+     * Creates the collection — sized by one probe embedding — with a request that
+     * fails if it exists, then commits the creation by writing the record last,
+     * create-if-absent (§6.3).
+     */
+    createCollection(name: string, opts: RagProviderCreateCollectionOptions): Promise<Result<Handles, RagError>>;
+    /** The catalog, paged and read back through the shared row check. Creates nothing. */
+    describeCollections(): Promise<Result<RagCatalogDescription, RagError>>;
+    /** Handles for a collection that exists. Issues no request, and the handles never create. */
+    openCollection(record: RagCollectionRecord): Promise<Result<Handles, RagError>>;
+    /** The record first, then the collection (§6.3). */
     deleteCollection(name: string): Promise<Result<void, RagError>>;
     listCollections(): Promise<Result<string[], RagError>>;
+    private createStore;
+    private writeRecord;
+    private handles;
+    private duplicate;
+    private refuseCatalogName;
+    private ensureCatalog;
+    private collectionExists;
+    /** The catalog point's payload, or undefined when there is none (or no catalog yet). */
+    private readRecord;
+    private request;
 }
+export {};
 //# sourceMappingURL=qdrant-rag-provider.d.ts.map

package/dist/qdrant-rag-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qdrant-rag-provider.d.ts","sourceRoot":"","sources":["../src/qdrant-rag-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,UAAU,EACV,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,IAAI,eAAe,EACtC,QAAQ,EACR,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,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;CACnB;AAED,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,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,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,GAAG,EAAE,uBAAuB;IAYlC,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QACJ,KAAK,EAAE,kBAAkB,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAczD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IA6B/D,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;CA6B7D"}
+{"version":3,"file":"qdrant-rag-provider.d.ts","sourceRoot":"","sources":["../src/qdrant-rag-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,UAAU,EACV,qBAAqB,EAGrB,mBAAmB,EACnB,kBAAkB,EAClB,kCAAkC,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,IAAI,eAAe,EAMtC,QAAQ,EACR,KAAK,MAAM,EAGZ,MAAM,yBAAyB,CAAC;AAGjC,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAKnE,KAAK,OAAO,GAAG;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAGjD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,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,gGAAgG;IAChG,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,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,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,YAAY,CAAC,CAAgB;gBAEzB,GAAG,EAAE,uBAAuB;IAaxC;;;;OAIG;IACG,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kCAAkC,GACvC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IA4CrC,sFAAsF;IAChF,mBAAmB,IAAI,OAAO,CAClC,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CACxC;IAyDD,6FAA6F;IACvF,cAAc,CAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAUrC,oDAAoD;IAC9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAmD/D,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;YA0B9C,WAAW;YAmCX,WAAW;IAwDzB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;YAuBP,gBAAgB;IAU9B,wFAAwF;YAC1E,UAAU;YAuBV,OAAO;CAUtB"}