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

package/dist/policy/fallback-llm-call-strategy.js

@@ -1,3 +1,4 @@
+import { normaliseLogger } from '../logger/normalise-logger.js';
 import { NonStreamingLlmCallStrategy } from './non-streaming-llm-call-strategy.js';
 import { StreamingLlmCallStrategy } from './streaming-llm-call-strategy.js';
 /**
@@ -5,12 +6,12 @@ import { StreamingLlmCallStrategy } from './streaming-llm-call-strategy.js';
  * via non-streaming. All subsequent calls use non-streaming for this instance.
  */
 export class FallbackLlmCallStrategy {
-    logger;
     streamingDisabled = false;
     streaming = new StreamingLlmCallStrategy();
     nonStreaming = new NonStreamingLlmCallStrategy();
+    logger;
     constructor(logger) {
-        this.logger = logger;
+        this.logger = logger ? normaliseLogger(logger) : undefined;
     }
     async *call(llm, messages, tools, options) {
         if (this.streamingDisabled) {

package/dist/policy/fallback-llm-call-strategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"fallback-llm-call-strategy.js","sourceRoot":"","sources":["../../src/policy/fallback-llm-call-strategy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fallback-llm-call-strategy.js","sourceRoot":"","sources":["../../src/policy/fallback-llm-call-strategy.ts"],"names":[],"mappings":"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"}

package/dist/rag/catalog/index.d.ts

@@ -0,0 +1,2 @@
+export { describeRagCatalogRows, encodeRagAttributes, parseRagCollectionRecord, type RagCatalogRow, type RagCatalogRowParse, ragOwnerKeys, validateRagAttributes, validateRagOwner, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rag/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rag/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/rag/catalog/index.js

@@ -0,0 +1,2 @@
+export { describeRagCatalogRows, encodeRagAttributes, parseRagCollectionRecord, ragOwnerKeys, validateRagAttributes, validateRagOwner, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/rag/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rag/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EAGxB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/rag/catalog/validation.d.ts

@@ -0,0 +1,56 @@
+import type { RagCatalogDescription, RagCollectionOwner, RagCollectionRecord, RagJsonValue } from '../../interfaces/rag.js';
+import type { Result } from '../../interfaces/types.js';
+import { InvalidAttributesError, InvalidOwnerError } from '../corrections/errors.js';
+/**
+ * Attributes as a catalog can return them: JSON with finite numbers, no cycle,
+ * plain objects and arrays only. Called by both createCollection contracts
+ * BEFORE anything is created, and on every catalog row read back.
+ */
+export declare function validateRagAttributes(value: unknown): Result<RagJsonValue | undefined, InvalidAttributesError>;
+/**
+ * The owner as the union demands it, for input no compiler checked: the scope,
+ * and only the key that scope selects, non-empty. Called by both
+ * createCollection contracts before any backend access, and on every catalog
+ * row read back.
+ */
+export declare function validateRagOwner(input: unknown): Result<RagCollectionOwner, InvalidOwnerError>;
+/** The owner's key in the flat shape RagCollectionMeta carries. */
+export declare function ragOwnerKeys(owner: RagCollectionOwner): {
+    sessionId?: string;
+    userId?: string;
+};
+/**
+ * The stored form of attributes: JSON text, or null for none. Text rather than a
+ * backend's JSON type, so `null` and absent stay apart and nothing is normalized.
+ */
+export declare function encodeRagAttributes(value: RagJsonValue | undefined): string | null;
+/** One catalog row as a provider read it, before anything is trusted. */
+export type RagCatalogRow = {
+    readonly storeName?: unknown;
+    readonly name?: unknown;
+    readonly scope?: unknown;
+    readonly userId?: unknown;
+    readonly sessionId?: unknown;
+    /** What encodeRagAttributes produced; null or absent → no attributes. */
+    readonly attributesJson?: unknown;
+};
+export type RagCatalogRowParse = {
+    readonly ok: true;
+    readonly record: RagCollectionRecord;
+} | {
+    readonly ok: false;
+    readonly rejected: {
+        readonly storeName?: string;
+        readonly reason: string;
+    };
+};
+/**
+ * A catalog row is storage outside any compiler, so it is checked at this
+ * boundary: no store name, no logical name, no or an unknown scope, a missing
+ * owner key, or attributes that are not JSON text make it a rejection, never a
+ * record (§6.3).
+ */
+export declare function parseRagCollectionRecord(row: RagCatalogRow): RagCatalogRowParse;
+/** Sorts rows into records and rejections; one bad row fails nothing. */
+export declare function describeRagCatalogRows(rows: readonly RagCatalogRow[]): RagCatalogDescription;
+//# sourceMappingURL=validation.d.ts.map

package/dist/rag/catalog/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/rag/catalog/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,YAAY,GAAG,SAAS,EAAE,sBAAsB,CAAC,CAM1D;AAiDD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAmC/C;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAIA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,GAAG,SAAS,GAC9B,MAAM,GAAG,IAAI,CAEf;AAED,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC3D;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,aAAa,GACjB,kBAAkB,CAmCpB;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,qBAAqB,CASvB"}

package/dist/rag/catalog/validation.js

@@ -0,0 +1,168 @@
+import { InvalidAttributesError, InvalidOwnerError, } from '../corrections/errors.js';
+/**
+ * Attributes as a catalog can return them: JSON with finite numbers, no cycle,
+ * plain objects and arrays only. Called by both createCollection contracts
+ * BEFORE anything is created, and on every catalog row read back.
+ */
+export function validateRagAttributes(value) {
+    if (value === undefined)
+        return { ok: true, value: undefined };
+    const problem = findNonJson(value, '$', new Set());
+    return problem === undefined
+        ? { ok: true, value: value }
+        : { ok: false, error: new InvalidAttributesError(problem) };
+}
+function findNonJson(value, path, ancestors) {
+    if (value === null)
+        return undefined;
+    switch (typeof value) {
+        case 'string':
+        case 'boolean':
+            return undefined;
+        case 'number':
+            return Number.isFinite(value)
+                ? undefined
+                : `${path} is ${String(value)}, which JSON turns into null`;
+        case 'undefined':
+            return `${path} is undefined, which JSON drops`;
+        case 'object':
+            break;
+        default:
+            return `${path} is a ${typeof value}, which has no JSON form`;
+    }
+    const obj = value;
+    if (ancestors.has(obj))
+        return `${path} is a cycle`;
+    ancestors.add(obj);
+    try {
+        if (Array.isArray(obj)) {
+            for (let i = 0; i < obj.length; i++) {
+                const found = findNonJson(obj[i], `${path}[${i}]`, ancestors);
+                if (found !== undefined)
+                    return found;
+            }
+            return undefined;
+        }
+        const proto = Object.getPrototypeOf(obj);
+        if (proto !== Object.prototype && proto !== null) {
+            const ctor = proto.constructor;
+            return `${path} is a ${ctor?.name ?? 'class'} instance, which JSON would not return as it is`;
+        }
+        for (const [key, child] of Object.entries(obj)) {
+            const found = findNonJson(child, `${path}.${key}`, ancestors);
+            if (found !== undefined)
+                return found;
+        }
+        return undefined;
+    }
+    finally {
+        ancestors.delete(obj);
+    }
+}
+/**
+ * The owner as the union demands it, for input no compiler checked: the scope,
+ * and only the key that scope selects, non-empty. Called by both
+ * createCollection contracts before any backend access, and on every catalog
+ * row read back.
+ */
+export function validateRagOwner(input) {
+    const o = (typeof input === 'object' && input !== null ? input : {});
+    switch (o.scope) {
+        case 'global':
+            return { ok: true, value: { scope: 'global' } };
+        case 'user':
+            return typeof o.userId === 'string' && o.userId !== ''
+                ? { ok: true, value: { scope: 'user', userId: o.userId } }
+                : {
+                    ok: false,
+                    error: new InvalidOwnerError('a user collection needs a non-empty userId'),
+                };
+        case 'session':
+            return typeof o.sessionId === 'string' && o.sessionId !== ''
+                ? { ok: true, value: { scope: 'session', sessionId: o.sessionId } }
+                : {
+                    ok: false,
+                    error: new InvalidOwnerError('a session collection needs a non-empty sessionId'),
+                };
+        case undefined:
+            return { ok: false, error: new InvalidOwnerError('no scope') };
+        default:
+            return {
+                ok: false,
+                error: new InvalidOwnerError(`unknown scope '${String(o.scope)}'`),
+            };
+    }
+}
+/** The owner's key in the flat shape RagCollectionMeta carries. */
+export function ragOwnerKeys(owner) {
+    if (owner.scope === 'session')
+        return { sessionId: owner.sessionId };
+    if (owner.scope === 'user')
+        return { userId: owner.userId };
+    return {};
+}
+/**
+ * The stored form of attributes: JSON text, or null for none. Text rather than a
+ * backend's JSON type, so `null` and absent stay apart and nothing is normalized.
+ */
+export function encodeRagAttributes(value) {
+    return value === undefined ? null : JSON.stringify(value);
+}
+/**
+ * A catalog row is storage outside any compiler, so it is checked at this
+ * boundary: no store name, no logical name, no or an unknown scope, a missing
+ * owner key, or attributes that are not JSON text make it a rejection, never a
+ * record (§6.3).
+ */
+export function parseRagCollectionRecord(row) {
+    const storeName = typeof row.storeName === 'string' && row.storeName !== ''
+        ? row.storeName
+        : undefined;
+    const reject = (reason) => ({
+        ok: false,
+        rejected: storeName === undefined ? { reason } : { storeName, reason },
+    });
+    if (storeName === undefined)
+        return reject('no store name');
+    const name = row.name;
+    if (typeof name !== 'string' || name === '')
+        return reject('no logical name');
+    const owner = validateRagOwner(row);
+    if (!owner.ok)
+        return reject(owner.error.reason);
+    const json = row.attributesJson;
+    if (json === null || json === undefined) {
+        return { ok: true, record: { ...owner.value, storeName, name } };
+    }
+    if (typeof json !== 'string') {
+        return reject(`attributes are stored as ${typeof json}, not as JSON text`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        return reject(`attributes are not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const attributes = validateRagAttributes(parsed);
+    if (!attributes.ok)
+        return reject(attributes.error.reason);
+    return {
+        ok: true,
+        record: { ...owner.value, storeName, name, attributes: attributes.value },
+    };
+}
+/** Sorts rows into records and rejections; one bad row fails nothing. */
+export function describeRagCatalogRows(rows) {
+    const records = [];
+    const rejected = [];
+    for (const row of rows) {
+        const parsed = parseRagCollectionRecord(row);
+        if (parsed.ok)
+            records.push(parsed.record);
+        else
+            rejected.push(parsed.rejected);
+    }
+    return { records, rejected };
+}
+//# sourceMappingURL=validation.js.map

package/dist/rag/catalog/validation.js.map

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

package/dist/rag/corrections/errors.d.ts

@@ -1,3 +1,4 @@
+import type { RagCollectionScope } from '../../interfaces/rag.js';
 import { RagError } from '../../interfaces/types.js';
 export declare class ReadOnlyError extends RagError {
     constructor(collectionName: string);
@@ -17,7 +18,75 @@ export declare class ProviderNotFoundError extends RagError {
 export declare class CollectionNotFoundError extends RagError {
     constructor(collectionName: string);
 }
+/**
+ * A collection was unregistered, but nothing could delete its data: its
+ * provider is gone, or it has no `deleteCollection` and its store no
+ * `writer().clearAll()`.
+ */
+export declare class DeleteUnsupportedError extends RagError {
+    constructor(collectionName: string, reason: string);
+}
+/**
+ * A session was closed — every one of its collections unregistered — but the
+ * data of some could not be deleted. `failures` names each, with its error.
+ */
+export declare class SessionCloseIncompleteError extends RagError {
+    readonly failures: ReadonlyArray<{
+        name: string;
+        error: RagError;
+    }>;
+    constructor(sessionId: string, failures: ReadonlyArray<{
+        name: string;
+        error: RagError;
+    }>);
+}
 export declare class ScopeViolationError extends RagError {
     constructor(collectionName: string, reason: string);
 }
+/** Attributes JSON would not return unchanged: NaN, ±Infinity, a cycle, or no JSON form. */
+export declare class InvalidAttributesError extends RagError {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** A scope without the owner key it selects, or no known scope at all. */
+export declare class InvalidOwnerError extends RagError {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** The collection is taken: its catalog record (or a registry entry) exists. */
+export declare class DuplicateCollectionError extends RagError {
+    constructor(collectionName: string, detail?: string);
+}
+/**
+ * A store exists without a catalog record — at this moment: another session may
+ * be creating or deleting it, so a retry later may find a finished collection or
+ * a free name. Adopt it with `adoptExisting`, or remove it.
+ */
+export declare class OrphanStoreError extends RagError {
+    readonly storeName: string;
+    constructor(storeName: string, reason: string);
+}
+/** A name held in several scopes of one registry, addressed without a scope. */
+export declare class AmbiguousCollectionError extends RagError {
+    readonly scopes: readonly RagCollectionScope[];
+    constructor(collectionName: string, scopes: readonly RagCollectionScope[]);
+}
+/**
+ * The first step of a catalogued deletion failed: the record could not be
+ * removed, so the data was not touched and nothing was deleted — retry it.
+ */
+export declare class CatalogRecordDeleteError extends RagError {
+    readonly storeName: string;
+    constructor(storeName: string, reason: string);
+}
+/**
+ * A global named into a prefix the `ragStores` projection gives another scope
+ * (§6.4): it would take that scope's key, and one entry would silently
+ * overwrite the other. Thrown by `register` and `adopt`, returned by
+ * `createCollection` (Tasks B23, B24).
+ */
+export declare class ReservedCollectionNameError extends RagError {
+    readonly prefix: string;
+    constructor(collectionName: string, prefix: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/rag/corrections/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/rag/corrections/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,cAAc,EAAE,MAAM;CAInC;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,YAAY,EAAE,MAAM;CAIjC;AAED,qBAAa,0BAA2B,SAAQ,QAAQ;gBAC1C,GAAG,EAAE,MAAM;CAOxB;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAOhD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,YAAY,EAAE,MAAM;CAOjC;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,cAAc,EAAE,MAAM;CAOnC;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/rag/corrections/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,cAAc,EAAE,MAAM;CAInC;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,YAAY,EAAE,MAAM;CAIjC;AAED,qBAAa,0BAA2B,SAAQ,QAAQ;gBAC1C,GAAG,EAAE,MAAM;CAOxB;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAOhD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,YAAY,EAAE,MAAM;CAOjC;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,cAAc,EAAE,MAAM;CAOnC;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOnD;AAED;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,QAAQ;IAGrD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;gBADnE,SAAS,EAAE,MAAM,EACR,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;CAUtE;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOnD;AAED,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,QAAQ;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAOpC;AAED,0EAA0E;AAC1E,qBAAa,iBAAkB,SAAQ,QAAQ;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAIpC;AAED,gFAAgF;AAChF,qBAAa,wBAAyB,SAAQ,QAAQ;gBACxC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOpD;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAE1C,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM;CAQjB;AAED,gFAAgF;AAChF,qBAAa,wBAAyB,SAAQ,QAAQ;IAGlD,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE;gBAD9C,cAAc,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,kBAAkB,EAAE;CAQjD;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ;IAElD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM;CAQjB;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,QAAQ;IAGrD,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,cAAc,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;CAQ1B"}

package/dist/rag/corrections/errors.js

@@ -35,10 +35,108 @@ export class CollectionNotFoundError extends RagError {
         this.name = 'CollectionNotFoundError';
     }
 }
+/**
+ * A collection was unregistered, but nothing could delete its data: its
+ * provider is gone, or it has no `deleteCollection` and its store no
+ * `writer().clearAll()`.
+ */
+export class DeleteUnsupportedError extends RagError {
+    constructor(collectionName, reason) {
+        super(`Collection '${collectionName}' was unregistered, but its data was not deleted: ${reason}`, 'RAG_DELETE_UNSUPPORTED');
+        this.name = 'DeleteUnsupportedError';
+    }
+}
+/**
+ * A session was closed — every one of its collections unregistered — but the
+ * data of some could not be deleted. `failures` names each, with its error.
+ */
+export class SessionCloseIncompleteError extends RagError {
+    failures;
+    constructor(sessionId, failures) {
+        super(`Session '${sessionId}' closed, but the data of ${failures.length} collection(s) could not be deleted: ${failures
+            .map((f) => `${f.name}: ${f.error.message}`)
+            .join('; ')}`, 'RAG_SESSION_CLOSE_INCOMPLETE');
+        this.failures = failures;
+        this.name = 'SessionCloseIncompleteError';
+    }
+}
 export class ScopeViolationError extends RagError {
     constructor(collectionName, reason) {
         super(`Scope violation on '${collectionName}': ${reason}`, 'RAG_SCOPE_VIOLATION');
         this.name = 'ScopeViolationError';
     }
 }
+/** Attributes JSON would not return unchanged: NaN, ±Infinity, a cycle, or no JSON form. */
+export class InvalidAttributesError extends RagError {
+    reason;
+    constructor(reason) {
+        super(`Collection attributes cannot be stored as JSON unchanged: ${reason}`, 'RAG_INVALID_ATTRIBUTES');
+        this.reason = reason;
+        this.name = 'InvalidAttributesError';
+    }
+}
+/** A scope without the owner key it selects, or no known scope at all. */
+export class InvalidOwnerError extends RagError {
+    reason;
+    constructor(reason) {
+        super(`Collection owner is invalid: ${reason}`, 'RAG_INVALID_OWNER');
+        this.reason = reason;
+        this.name = 'InvalidOwnerError';
+    }
+}
+/** The collection is taken: its catalog record (or a registry entry) exists. */
+export class DuplicateCollectionError extends RagError {
+    constructor(collectionName, detail) {
+        super(`Collection '${collectionName}' already exists${detail ? `: ${detail}` : ''}`, 'RAG_DUPLICATE_COLLECTION');
+        this.name = 'DuplicateCollectionError';
+    }
+}
+/**
+ * A store exists without a catalog record — at this moment: another session may
+ * be creating or deleting it, so a retry later may find a finished collection or
+ * a free name. Adopt it with `adoptExisting`, or remove it.
+ */
+export class OrphanStoreError extends RagError {
+    storeName;
+    constructor(storeName, reason) {
+        super(`Store '${storeName}' has no catalog record: ${reason}`, 'RAG_ORPHAN_STORE');
+        this.storeName = storeName;
+        this.name = 'OrphanStoreError';
+    }
+}
+/** A name held in several scopes of one registry, addressed without a scope. */
+export class AmbiguousCollectionError extends RagError {
+    scopes;
+    constructor(collectionName, scopes) {
+        super(`Collection '${collectionName}' exists in several scopes (${scopes.join(', ')}); name the scope`, 'RAG_AMBIGUOUS_COLLECTION');
+        this.scopes = scopes;
+        this.name = 'AmbiguousCollectionError';
+    }
+}
+/**
+ * The first step of a catalogued deletion failed: the record could not be
+ * removed, so the data was not touched and nothing was deleted — retry it.
+ */
+export class CatalogRecordDeleteError extends RagError {
+    storeName;
+    constructor(storeName, reason) {
+        super(`The catalog record of store '${storeName}' could not be deleted, so nothing was deleted: ${reason}`, 'RAG_CATALOG_RECORD_DELETE');
+        this.storeName = storeName;
+        this.name = 'CatalogRecordDeleteError';
+    }
+}
+/**
+ * A global named into a prefix the `ragStores` projection gives another scope
+ * (§6.4): it would take that scope's key, and one entry would silently
+ * overwrite the other. Thrown by `register` and `adopt`, returned by
+ * `createCollection` (Tasks B23, B24).
+ */
+export class ReservedCollectionNameError extends RagError {
+    prefix;
+    constructor(collectionName, prefix) {
+        super(`A global collection may not be named '${collectionName}': the prefix '${prefix}' is reserved for the ${prefix.slice(0, -1)} scope`, 'RAG_RESERVED_COLLECTION_NAME');
+        this.prefix = prefix;
+        this.name = 'ReservedCollectionNameError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/rag/corrections/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/rag/corrections/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,cAAsB;QAChC,KAAK,CAAC,eAAe,cAAc,gBAAgB,EAAE,eAAe,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,YAAoB;QAC9B,KAAK,CAAC,GAAG,YAAY,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,QAAQ;IACtD,YAAY,GAAW;QACrB,KAAK,CACH,iBAAiB,GAAG,uEAAuE,EAC3F,6BAA6B,CAC9B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,YAAoB,EAAE,KAAa;QAC7C,KAAK,CACH,aAAa,YAAY,6BAA6B,KAAK,GAAG,EAC9D,uBAAuB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,YAAoB;QAC9B,KAAK,CACH,iBAAiB,YAAY,qBAAqB,EAClD,wBAAwB,CACzB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,cAAsB;QAChC,KAAK,CACH,eAAe,cAAc,qBAAqB,EAClD,0BAA0B,CAC3B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,cAAsB,EAAE,MAAc;QAChD,KAAK,CACH,uBAAuB,cAAc,MAAM,MAAM,EAAE,EACnD,qBAAqB,CACtB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/rag/corrections/errors.ts"],"names":[],"mappings":"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"}

package/dist/rag/identity-filter.d.ts

@@ -0,0 +1,19 @@
+import type { CallOptions, RagMetadata } from '../interfaces/types.js';
+/** The identity part of `CallOptions.ragFilter` every `IRag` store honours. */
+export interface RagIdentityFilter {
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * The `sessionId` / `userId` a query is scoped to, or `undefined` when it is
+ * scoped to neither. Only string values count, so an absent key and an
+ * explicit `undefined` both mean "not filtered".
+ */
+export declare function ragIdentityFilter(options?: CallOptions): RagIdentityFilter | undefined;
+/**
+ * Whether a record belongs to the scope of `filter`. A record without the
+ * filtered key does not match — an unowned record is never shown to a scoped
+ * query. Stores apply this BEFORE top-k.
+ */
+export declare function matchesRagIdentity(metadata: RagMetadata, filter: RagIdentityFilter | undefined): boolean;
+//# sourceMappingURL=identity-filter.d.ts.map

package/dist/rag/identity-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-filter.d.ts","sourceRoot":"","sources":["../../src/rag/identity-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,WAAW,GACpB,iBAAiB,GAAG,SAAS,CAS/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,iBAAiB,GAAG,SAAS,GACpC,OAAO,CAOT"}

package/dist/rag/identity-filter.js

@@ -0,0 +1,31 @@
+/**
+ * The `sessionId` / `userId` a query is scoped to, or `undefined` when it is
+ * scoped to neither. Only string values count, so an absent key and an
+ * explicit `undefined` both mean "not filtered".
+ */
+export function ragIdentityFilter(options) {
+    const f = options?.ragFilter;
+    const sessionId = typeof f?.sessionId === 'string' ? f.sessionId : undefined;
+    const userId = typeof f?.userId === 'string' ? f.userId : undefined;
+    if (sessionId === undefined && userId === undefined)
+        return undefined;
+    return {
+        ...(sessionId !== undefined ? { sessionId } : {}),
+        ...(userId !== undefined ? { userId } : {}),
+    };
+}
+/**
+ * Whether a record belongs to the scope of `filter`. A record without the
+ * filtered key does not match — an unowned record is never shown to a scoped
+ * query. Stores apply this BEFORE top-k.
+ */
+export function matchesRagIdentity(metadata, filter) {
+    if (!filter)
+        return true;
+    if (filter.sessionId !== undefined && metadata.sessionId !== filter.sessionId)
+        return false;
+    if (filter.userId !== undefined && metadata.userId !== filter.userId)
+        return false;
+    return true;
+}
+//# sourceMappingURL=identity-filter.js.map

package/dist/rag/identity-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-filter.js","sourceRoot":"","sources":["../../src/rag/identity-filter.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAqB;IAErB,MAAM,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAqB,EACrB,MAAqC;IAErC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAC3E,OAAO,KAAK,CAAC;IACf,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAClE,OAAO,KAAK,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/rag/in-memory-rag.d.ts

@@ -4,7 +4,9 @@ import type { CallOptions, RagMetadata, RagResult, Result } from '../interfaces/
 import { RagError } from '../interfaces/types.js';
 import type { IDocumentEnricher, IQueryPreprocessor } from './preprocessor.js';
 export interface InMemoryRagConfig {
-    /** Cosine similarity above which upsert updates existing record. Default: 0.92 */
+    /** Cosine similarity above which an upsert without an id updates an existing
+     *  record without an id (a record with an id is replaced only by the same id).
+     *  Default: 0.92 */
     dedupThreshold?: number;
     /** Namespace for this store. Records with different namespace are invisible to query. */
     namespace?: string;

package/dist/rag/in-memory-rag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-rag.d.ts","sourceRoot":"","sources":["../../src/rag/in-memory-rag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,MAAM,EACP,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAwC/E,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAiBD,qBAAa,WAAY,YAAW,IAAI;IACtC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;gBAE5C,MAAM,CAAC,EAAE,iBAAiB;IAOhC,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAiE5B,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IA8CnC,OAAO,CACX,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IASxC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAIpD,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,iBAAiB;CAkB5B"}
+{"version":3,"file":"in-memory-rag.d.ts","sourceRoot":"","sources":["../../src/rag/in-memory-rag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,MAAM,EACP,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAqC/E,MAAM,WAAW,iBAAiB;IAChC;;wBAEoB;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAiBD,qBAAa,WAAY,YAAW,IAAI;IACtC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;gBAE5C,MAAM,CAAC,EAAE,iBAAiB;IAOhC,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAwE5B,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IAgDnC,OAAO,CACX,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IASxC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAIpD,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,iBAAiB;CAkB5B"}