@mcp-abap-adt/llm-agent 25.0.0 → 27.0.1

package/dist/rag/registry/simple-rag-registry.js

@@ -1,8 +1,57 @@
+import { createHash } from 'node:crypto';
 import { RagError } from '../../interfaces/types.js';
-import { CollectionNotFoundError, ProviderNotFoundError, } from '../corrections/errors.js';
+import { ragOwnerKeys, validateRagAttributes, validateRagOwner, } from '../catalog/validation.js';
+import { AmbiguousCollectionError, CatalogRecordDeleteError, CollectionNotFoundError, DeleteUnsupportedError, DuplicateCollectionError, ProviderNotFoundError, SessionCloseIncompleteError, } from '../corrections/errors.js';
 import { ImmutableEditStrategy } from '../strategies/edit/immutable.js';
+import { reservedGlobalNameError } from './store-key.js';
+/**
+ * The name a provider keeps a collection's data under.
+ *
+ * The collection name and a digest of its scope, its owner (the session for a
+ * session collection, the user for a user one) and the name. The same
+ * collection of the same owner always names the same store; another session or
+ * user names another one, so none opens a store someone else left. Because the
+ * name is deterministic, a second creation of a collection that exists is
+ * refused by the provider (RAG_DUPLICATE_COLLECTION when it has a record,
+ * RAG_ORPHAN_STORE when only its store is there) — a restart reattaches a
+ * collection by hydration (describeCollections, openCollection, adopt), never
+ * by creating it again (§6.3). It fits the strictest provider rules: letters,
+ * digits and underscores, not starting with a digit, at most 63 characters
+ * (PostgreSQL, HANA).
+ */
+function storeNameFor(params) {
+    const owner = params.scope === 'session'
+        ? params.sessionId
+        : params.scope === 'user'
+            ? params.userId
+            : '';
+    const digest = createHash('sha256')
+        .update(JSON.stringify([params.scope, owner, params.collectionName]))
+        .digest('hex')
+        .slice(0, 12);
+    let base = params.collectionName.replace(/[^a-zA-Z0-9_]/g, '_');
+    if (!/^[a-zA-Z_]/.test(base))
+        base = `_${base}`;
+    return `${base.slice(0, 63 - digest.length - 1)}_${digest}`;
+}
+/** A collection is its scope and its name (§6.4); the owner is the registry's own. */
+function keyOf(scope, name) {
+    return JSON.stringify([scope, name]);
+}
+const SCOPES = ['global', 'user', 'session'];
 export class SimpleRagRegistry {
+    /** Keyed by keyOf(scope, name). */
     entries = new Map();
+    /**
+     * Keys (scope, name) whose deletion is running. Absent to get, getEditor and
+     * list, so nothing reaches the collection; taken for createCollection,
+     * register and adopt, which refuse it — a taken name is refused, not queued
+     * (§6.3). The reservation is what lets a failed record deletion restore the
+     * entry: without it a creation could take the key in between.
+     */
+    deleting = new Set();
+    /** Keys (scope, name) being created, held until inserted or refused. */
+    creating = new Set();
     providerRegistry;
     mutationListener;
     setProviderRegistry(providerRegistry) {
@@ -14,44 +63,151 @@ export class SimpleRagRegistry {
     fireMutation() {
         this.mutationListener?.();
     }
+    /**
+     * The entry `name` addresses: with a scope, that scope's; without one, the
+     * entry of the one scope holding it — or AmbiguousCollectionError naming
+     * every scope that does. Never a silent precedence between scopes.
+     */
+    find(name, scope) {
+        if (scope) {
+            const key = keyOf(scope, name);
+            const entry = this.entries.get(key);
+            return { ok: true, found: entry ? { key, entry } : undefined };
+        }
+        const held = SCOPES.filter((s) => this.entries.has(keyOf(s, name)));
+        if (held.length > 1) {
+            return { ok: false, error: new AmbiguousCollectionError(name, held) };
+        }
+        if (held.length === 0)
+            return { ok: true };
+        const key = keyOf(held[0], name);
+        const entry = this.entries.get(key);
+        return { ok: true, found: { key, entry } };
+    }
+    findOrThrow(name, scope) {
+        const f = this.find(name, scope);
+        if (!f.ok)
+            throw f.error;
+        return f.found;
+    }
+    /** A key is taken while an entry holds it, or a creation or deletion runs. */
+    isTaken(key) {
+        return (this.entries.has(key) || this.creating.has(key) || this.deleting.has(key));
+    }
+    insert(key, entry) {
+        this.entries.set(key, entry);
+        this.fireMutation();
+    }
     register(name, rag, editor, meta) {
-        if (this.entries.has(name)) {
-            throw new Error(`Collection '${name}' is already registered`);
+        const scope = meta?.scope ?? 'global';
+        const reserved = reservedGlobalNameError(scope, name);
+        if (reserved)
+            throw reserved;
+        const key = keyOf(scope, name);
+        if (this.isTaken(key)) {
+            throw new DuplicateCollectionError(name, `already registered in scope '${scope}'`);
         }
         const editable = Boolean(editor) && !(editor instanceof ImmutableEditStrategy);
-        this.entries.set(name, {
+        this.insert(key, {
             rag,
             editor,
+            storeName: name,
             meta: {
                 name,
                 displayName: meta?.displayName ?? name,
                 description: meta?.description,
                 editable,
-                scope: meta?.scope ?? 'global',
+                scope,
                 sessionId: meta?.sessionId,
                 userId: meta?.userId,
                 providerName: meta?.providerName,
                 tags: meta?.tags,
             },
         });
+    }
+    /**
+     * Register a collection whose store EXISTS, from its catalog record (§6.3):
+     * under its logical name, with the store name the record gives. Creates
+     * nothing and asks no provider for anything. See IRagRegistry.adopt.
+     */
+    adopt(record, rag, editor, providerName) {
+        // A record may come from a caller no compiler saw: the one owner rule,
+        // and the owner it returns, with only the key its scope selects.
+        const owner = validateRagOwner(record);
+        if (!owner.ok)
+            throw owner.error;
+        const reserved = reservedGlobalNameError(owner.value.scope, record.name);
+        if (reserved)
+            throw reserved;
+        const key = keyOf(owner.value.scope, record.name);
+        if (this.isTaken(key)) {
+            throw new DuplicateCollectionError(record.name, `already registered in scope '${owner.value.scope}'`);
+        }
+        this.insert(key, {
+            rag,
+            editor,
+            // NOT record.name: the provider knows the store by its own name, and a
+            // deletion addressed to the logical name would miss it.
+            storeName: record.storeName,
+            meta: {
+                name: record.name,
+                displayName: record.name,
+                editable: Boolean(editor) && !(editor instanceof ImmutableEditStrategy),
+                scope: owner.value.scope,
+                ...ragOwnerKeys(owner.value),
+                providerName,
+            },
+        });
+    }
+    unregister(name, scope) {
+        const found = this.findOrThrow(name, scope);
+        if (!found)
+            return false;
+        this.entries.delete(found.key);
         this.fireMutation();
+        return true;
     }
-    unregister(name) {
-        const existed = this.entries.delete(name);
-        if (existed)
-            this.fireMutation();
-        return existed;
+    get(name, scope) {
+        return this.findOrThrow(name, scope)?.entry.rag;
     }
-    get(name) {
-        return this.entries.get(name)?.rag;
+    getEditor(name, scope) {
+        return this.findOrThrow(name, scope)?.entry.editor;
     }
-    getEditor(name) {
-        return this.entries.get(name)?.editor;
+    /**
+     * Swap the store handle of an existing entry, keeping everything else — its
+     * editor, its provider, its store name and its meta — and tell the mutation
+     * listener. For a decorator such as the builder's circuit-breaker
+     * FallbackRag: re-registering would set the store name to the logical name
+     * and drop the provider, so a hydrated collection's delete would miss its
+     * store and its catalog record would come back (§6.3). The scope is
+     * required, so the lookup is never ambiguous. False when the entry is
+     * absent — including one currently reserved by an in-flight deletion (it is
+     * gone from `entries` already); never re-inserts.
+     */
+    replaceRag(name, scope, rag) {
+        const found = this.findOrThrow(name, scope);
+        if (!found)
+            return false;
+        found.entry.rag = rag;
+        this.fireMutation();
+        return true;
     }
     list() {
         return Array.from(this.entries.values()).map((e) => e.meta);
     }
     async createCollection(params) {
+        // Checked before anything else: an untyped caller's owner without its key
+        // would digest to a store every such caller shares (storeNameFor), and
+        // attributes JSON would change could not come back as given (§6.3).
+        const owner = validateRagOwner(params);
+        if (!owner.ok)
+            return owner;
+        const attributes = validateRagAttributes(params.attributes);
+        if (!attributes.ok)
+            return attributes;
+        const reserved = reservedGlobalNameError(owner.value.scope, params.collectionName);
+        if (reserved)
+            return { ok: false, error: reserved };
         if (!this.providerRegistry) {
             return {
                 ok: false,
@@ -65,77 +221,195 @@ export class SimpleRagRegistry {
                 error: new ProviderNotFoundError(params.providerName),
             };
         }
-        // Preflight duplicate-name check.
-        if (this.entries.has(params.collectionName)) {
+        // Preflight duplicate check, counting creations still running: two at
+        // once would share one store.
+        const key = keyOf(owner.value.scope, params.collectionName);
+        if (this.isTaken(key)) {
             return {
                 ok: false,
-                error: new RagError(`Collection '${params.collectionName}' already exists`, 'RAG_DUPLICATE_COLLECTION'),
+                error: new DuplicateCollectionError(params.collectionName, `the name is taken in scope '${owner.value.scope}'`),
             };
         }
-        const created = await provider.createCollection(params.collectionName, {
-            scope: params.scope,
-            sessionId: params.sessionId,
-            userId: params.userId,
+        this.creating.add(key);
+        try {
+            return await this.createUnder(provider, key, params, owner.value);
+        }
+        finally {
+            this.creating.delete(key);
+        }
+    }
+    async createUnder(provider, key, params, owner) {
+        // A provider that keeps stores by name gets one per owner; see storeNameFor.
+        const storeName = storeNameFor({
+            collectionName: params.collectionName,
+            ...owner,
+        });
+        // The logical name and the attributes go to the provider, because its
+        // catalog cannot return what it was never given (§6.3). Passed unread, and
+        // only when given, so `'attributes' in opts` reads the caller's intent.
+        const created = await provider.createCollection(storeName, {
+            ...owner,
+            collectionName: params.collectionName,
+            ...(params.attributes !== undefined
+                ? { attributes: params.attributes }
+                : {}),
+            ...(params.adoptExisting ? { adoptExisting: true } : {}),
         });
         if (!created.ok)
             return created;
-        try {
-            this.register(params.collectionName, created.value.rag, created.value.editor, {
+        // Inserted directly: the key has been held in `creating` since the
+        // preflight, so nothing can have taken it, and there is nothing to roll
+        // back — a rollback would delete a store whose catalog record the provider
+        // has just committed (§6.3).
+        const editor = created.value.editor;
+        const entry = {
+            rag: created.value.rag,
+            editor,
+            storeName,
+            meta: {
+                name: params.collectionName,
                 displayName: params.displayName ?? params.collectionName,
                 description: params.description,
-                scope: params.scope,
-                sessionId: params.sessionId,
-                userId: params.userId,
+                editable: Boolean(editor) && !(editor instanceof ImmutableEditStrategy),
+                scope: owner.scope,
+                ...ragOwnerKeys(owner),
                 providerName: params.providerName,
                 tags: params.tags,
-            });
+            },
+        };
+        this.insert(key, entry);
+        return { ok: true, value: entry.meta };
+    }
+    /**
+     * Delete a collection.
+     *
+     * It is unregistered first and its key reserved, so nothing reaches it and
+     * nothing takes its name while it is being deleted. Then its data goes: a
+     * collection a provider created is deleted by that provider's
+     * `deleteCollection` (which cannot throw — see deleteData) — which removes
+     * its catalog record before its data — or, where the provider has none,
+     * emptied through its store's `writer().clearAll()`. A collection
+     * registered without a provider is only unregistered. Nothing is retried.
+     *
+     * On CatalogRecordDeleteError nothing was deleted: record and data are both
+     * intact, so the same entry is registered again before the reservation ends,
+     * and the same call can be retried in place. Any other failure comes back as
+     * the error with the collection unregistered; its data may remain under a
+     * store name no other session or user is given (see storeNameFor).
+     *
+     * The reservation is released — and the entry restored first, if this was a
+     * CatalogRecordDeleteError — on every path, including a throwing
+     * `mutationListener`: that listener is consumer-injected and its own
+     * exception must never pin the key in `deleting` forever, nor skip the
+     * restore. Once state is settled, a listener exception is rethrown (so the
+     * caller sees it — never silently dropped); the delete's own Result is
+     * returned only when notifying succeeded.
+     */
+    async deleteCollection(name, scope) {
+        const f = this.find(name, scope);
+        if (!f.ok)
+            return { ok: false, error: f.error };
+        if (!f.found) {
+            return { ok: false, error: new CollectionNotFoundError(name) };
+        }
+        const { key, entry } = f.found;
+        this.entries.delete(key);
+        this.deleting.add(key);
+        let notifyFailed = false;
+        let notifyError;
+        try {
+            this.fireMutation();
         }
         catch (err) {
-            // Defense-in-depth rollback: the preflight check should prevent this,
-            // but if register throws anyway (subclass or race), roll the backend back.
+            notifyFailed = true;
+            notifyError = err;
+        }
+        // deleteData never throws (its own try/catch turns everything, including
+        // an injected provider registry throwing, into a Result), so this await
+        // cannot reject.
+        const result = await this.deleteData(name, entry);
+        const restoring = !result.ok && result.error instanceof CatalogRecordDeleteError;
+        try {
+            if (restoring) {
+                // Restored while the key is still reserved, so nothing slips in
+                // between.
+                this.entries.set(key, entry);
+            }
+        }
+        finally {
+            // Released on every path — success, any other failure, or a restore —
+            // whatever the mutation listener above did.
+            this.deleting.delete(key);
+        }
+        if (restoring) {
+            try {
+                this.fireMutation();
+            }
+            catch (err) {
+                if (!notifyFailed) {
+                    notifyFailed = true;
+                    notifyError = err;
+                }
+            }
+        }
+        if (notifyFailed)
+            throw notifyError;
+        return result;
+    }
+    async deleteData(name, entry) {
+        const providerName = entry.meta.providerName;
+        if (!providerName)
+            return { ok: true, value: undefined };
+        try {
+            // getProvider is an injected registry's call, not ours — it belongs
+            // inside this try along with everything else that can throw.
+            const provider = this.providerRegistry?.getProvider(providerName);
+            if (!provider) {
+                return {
+                    ok: false,
+                    error: new DeleteUnsupportedError(name, `provider '${providerName}' is not registered`),
+                };
+            }
             if (provider.deleteCollection) {
-                await provider.deleteCollection(params.collectionName).catch(() => { });
+                return await provider.deleteCollection(entry.storeName);
             }
+            const writer = entry.rag.writer?.();
+            if (writer?.clearAll)
+                return await writer.clearAll();
+        }
+        catch (err) {
             return {
                 ok: false,
                 error: err instanceof RagError
                     ? err
-                    : new RagError(String(err), 'RAG_REGISTER_FAILED'),
-            };
-        }
-        const registered = this.entries.get(params.collectionName);
-        if (!registered) {
-            return {
-                ok: false,
-                error: new RagError(`Collection '${params.collectionName}' vanished after registration`, 'RAG_REGISTER_FAILED'),
+                    : new RagError(`Deleting the data of collection '${name}' failed: ${err instanceof Error ? err.message : String(err)}`, 'RAG_DELETE_ERROR'),
             };
         }
-        return { ok: true, value: registered.meta };
-    }
-    async deleteCollection(name) {
-        const entry = this.entries.get(name);
-        if (!entry) {
-            return { ok: false, error: new CollectionNotFoundError(name) };
-        }
-        if (entry.meta.providerName && this.providerRegistry) {
-            const provider = this.providerRegistry.getProvider(entry.meta.providerName);
-            if (provider?.deleteCollection) {
-                const res = await provider.deleteCollection(name);
-                if (!res.ok)
-                    return res;
-            }
-        }
-        this.unregister(name);
-        return { ok: true, value: undefined };
+        return {
+            ok: false,
+            error: new DeleteUnsupportedError(name, `provider '${providerName}' has no deleteCollection, and its store no writer().clearAll()`),
+        };
     }
+    /**
+     * Delete every session-scoped collection of this session. Goes through all of
+     * them even when one fails — each is unregistered regardless (see
+     * deleteCollection) — and returns the failures together.
+     */
     async closeSession(sessionId) {
         const victims = Array.from(this.entries.values())
             .filter((e) => e.meta.scope === 'session' && e.meta.sessionId === sessionId)
             .map((e) => e.meta.name);
+        const failures = [];
         for (const name of victims) {
-            const res = await this.deleteCollection(name);
+            const res = await this.deleteCollection(name, 'session');
             if (!res.ok)
-                return res;
+                failures.push({ name, error: res.error });
+        }
+        if (failures.length > 0) {
+            return {
+                ok: false,
+                error: new SessionCloseIncompleteError(sessionId, failures),
+            };
         }
         return { ok: true, value: undefined };
     }

package/dist/rag/registry/simple-rag-registry.js.map

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

package/dist/rag/registry/store-key.d.ts

@@ -0,0 +1,15 @@
+import type { RagCollectionScope } from '../../interfaces/rag.js';
+import { ReservedCollectionNameError } from '../corrections/errors.js';
+/** The refusal for a global named into a reserved prefix, or undefined. */
+export declare function reservedGlobalNameError(scope: RagCollectionScope, name: string): ReservedCollectionNameError | undefined;
+/**
+ * The key a collection has in the `ragStores` projection: a global keeps its
+ * bare name, so every stage configuration naming one keeps working; a user or
+ * session collection is `user/<name>` or `session/<name>`. An absent scope is
+ * global, as `register` defaults it.
+ */
+export declare function ragStoreKey(meta: {
+    readonly name: string;
+    readonly scope?: RagCollectionScope;
+}): string;
+//# sourceMappingURL=store-key.d.ts.map

package/dist/rag/registry/store-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-key.d.ts","sourceRoot":"","sources":["../../../src/rag/registry/store-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AASvE,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,MAAM,GACX,2BAA2B,GAAG,SAAS,CAIzC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC,GAAG,MAAM,CAGT"}

package/dist/rag/registry/store-key.js

@@ -0,0 +1,25 @@
+import { ReservedCollectionNameError } from '../corrections/errors.js';
+/**
+ * The prefixes the `ragStores` projection gives the two owned scopes (§6.4). A
+ * global may not begin with one: it would take a key the projection gives
+ * another scope, and one entry would silently overwrite the other.
+ */
+const RESERVED_GLOBAL_PREFIXES = ['user/', 'session/'];
+/** The refusal for a global named into a reserved prefix, or undefined. */
+export function reservedGlobalNameError(scope, name) {
+    if (scope !== 'global')
+        return undefined;
+    const prefix = RESERVED_GLOBAL_PREFIXES.find((p) => name.startsWith(p));
+    return prefix ? new ReservedCollectionNameError(name, prefix) : undefined;
+}
+/**
+ * The key a collection has in the `ragStores` projection: a global keeps its
+ * bare name, so every stage configuration naming one keeps working; a user or
+ * session collection is `user/<name>` or `session/<name>`. An absent scope is
+ * global, as `register` defaults it.
+ */
+export function ragStoreKey(meta) {
+    const scope = meta.scope ?? 'global';
+    return scope === 'global' ? meta.name : `${scope}/${meta.name}`;
+}
+//# sourceMappingURL=store-key.js.map

package/dist/rag/registry/store-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-key.js","sourceRoot":"","sources":["../../../src/rag/registry/store-key.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,UAAU,CAAU,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CACrC,KAAyB,EACzB,IAAY;IAEZ,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAG3B;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACrC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/rag/search-strategy.d.ts

@@ -15,6 +15,15 @@ export interface IScoredResult {
     score: number;
 }
 export interface ISearchContext {
+    /**
+     * Term statistics over THIS query's candidates only — the records that
+     * passed the store's namespace / TTL / session / user filters — never over
+     * the whole store: store-wide statistics make one session's ranking depend
+     * on (and leak a signal about) another session's records. The built-in
+     * strategies do not read it; they compute the same statistics from the
+     * `candidates` they are given, so they are scoped whatever a caller passes.
+     * Kept for custom strategies.
+     */
     index: InvertedIndex;
     tokenize: (s: string) => string[];
 }

package/dist/rag/search-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-strategy.d.ts","sourceRoot":"","sources":["../../src/rag/search-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE,CAAC;CACpB;AA8CD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,QAAQ,CAAC,IAAI,qBAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAKtE,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE;CAYnB;AAMD;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAInC,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE;CAoCnB;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,QAAQ,EAAE,cAAc,GACvB,aAAa,EAAE;CASnB;AAMD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,eAAe;IAE5B,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE;CAUnB;AAMD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,OAAO,EAAE,sBAAsB,EAAE,EAAE,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAMtE,KAAK,CACH,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE;CA0CnB"}
+{"version":3,"file":"search-strategy.d.ts","sourceRoot":"","sources":["../../src/rag/search-strategy.ts"],"names":[],"mappings":"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"}