@mcp-abap-adt/llm-agent 8.5.0 → 9.1.0

package/dist/smart-agent/rag/mcp-tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/mcp-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,GAG9B,MAAM,2BAA2B,CAAC"}

package/dist/smart-agent/rag/mcp-tools/rag-collection-tools.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { IRagProviderRegistry, IRagRegistry } from '../../interfaces/rag.js';
+export interface RagToolContext {
+    sessionId?: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+export interface RagToolEntry {
+    toolDefinition: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodRawShape;
+    };
+    handler: (context: RagToolContext, args: Record<string, unknown>) => Promise<unknown>;
+}
+export declare function buildRagCollectionToolEntries(opts: {
+    registry: IRagRegistry;
+    providerRegistry?: IRagProviderRegistry;
+}): RagToolEntry[];
+//# sourceMappingURL=rag-collection-tools.d.ts.map

package/dist/smart-agent/rag/mcp-tools/rag-collection-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-collection-tools.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/mcp-tools/rag-collection-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACb,MAAM,yBAAyB,CAAC;AAMjC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE,CACP,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,YAAY,CAAC;IACvB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC,GAAG,YAAY,EAAE,CA+OjB"}

package/dist/smart-agent/rag/mcp-tools/rag-collection-tools.js

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { buildCorrectionMetadata, deprecateMetadata, } from '../corrections/metadata.js';
+export function buildRagCollectionToolEntries(opts) {
+    const { registry } = opts;
+    const resolveEditor = (name) => {
+        if (typeof name !== 'string') {
+            return { ok: false, error: 'collection is required' };
+        }
+        const editor = registry.getEditor(name);
+        if (!editor) {
+            return {
+                ok: false,
+                error: `Collection '${name}' is read-only or unknown`,
+            };
+        }
+        return { ok: true, editor };
+    };
+    const addTool = {
+        toolDefinition: {
+            name: 'rag_add',
+            description: 'Add a new document to a RAG collection.',
+            inputSchema: {
+                collection: z.string(),
+                text: z.string(),
+                canonicalKey: z.string(),
+                tags: z.array(z.string()).optional(),
+            },
+        },
+        handler: async (_ctx, args) => {
+            const r = resolveEditor(args.collection);
+            if (!r.ok)
+                return r;
+            const res = await r.editor.upsert(String(args.text), {
+                canonicalKey: String(args.canonicalKey),
+                tags: args.tags,
+            });
+            return res.ok
+                ? { ok: true, id: res.value.id }
+                : { ok: false, error: res.error.message };
+        },
+    };
+    const correctTool = {
+        toolDefinition: {
+            name: 'rag_correct',
+            description: 'Supersede a document with a new corrected version. Marks the predecessor as superseded.',
+            inputSchema: {
+                collection: z.string(),
+                predecessorId: z.string(),
+                predecessorCanonicalKey: z.string(),
+                newText: z.string(),
+                reason: z.string(),
+            },
+        },
+        handler: async (_ctx, args) => {
+            const r = resolveEditor(args.collection);
+            if (!r.ok)
+                return r;
+            const predecessorMeta = {
+                canonicalKey: String(args.predecessorCanonicalKey),
+            };
+            const newRes = await r.editor.upsert(String(args.newText), {
+                canonicalKey: predecessorMeta.canonicalKey,
+            });
+            if (!newRes.ok)
+                return { ok: false, error: newRes.error.message };
+            const { predecessor } = buildCorrectionMetadata({
+                predecessor: predecessorMeta,
+                predecessorId: String(args.predecessorId),
+                newEntryId: newRes.value.id,
+                reason: String(args.reason),
+            });
+            const supRes = await r.editor.upsert('', {
+                ...predecessor,
+                id: String(args.predecessorId),
+            });
+            if (!supRes.ok)
+                return { ok: false, error: supRes.error.message };
+            return {
+                ok: true,
+                predecessorId: String(args.predecessorId),
+                newId: newRes.value.id,
+            };
+        },
+    };
+    const deprecateTool = {
+        toolDefinition: {
+            name: 'rag_deprecate',
+            description: 'Mark a document as deprecated (idempotent).',
+            inputSchema: {
+                collection: z.string(),
+                id: z.string(),
+                canonicalKey: z.string(),
+                reason: z.string(),
+            },
+        },
+        handler: async (_ctx, args) => {
+            const r = resolveEditor(args.collection);
+            if (!r.ok)
+                return r;
+            const meta = deprecateMetadata({ canonicalKey: String(args.canonicalKey) }, String(args.reason));
+            const res = await r.editor.upsert('', {
+                ...meta,
+                id: String(args.id),
+            });
+            return res.ok
+                ? { ok: true, id: res.value.id }
+                : { ok: false, error: res.error.message };
+        },
+    };
+    const listTool = {
+        toolDefinition: {
+            name: 'rag_list_collections',
+            description: 'List known RAG collections with optional scope/provider filters.',
+            inputSchema: {
+                scope: z.enum(['session', 'user', 'global']).optional(),
+                provider: z.string().optional(),
+            },
+        },
+        handler: async (_ctx, args) => {
+            const metas = registry.list().filter((m) => {
+                if (args.scope && m.scope !== args.scope)
+                    return false;
+                if (args.provider && m.providerName !== args.provider)
+                    return false;
+                return true;
+            });
+            return { ok: true, collections: metas };
+        },
+    };
+    const describeTool = {
+        toolDefinition: {
+            name: 'rag_describe_collection',
+            description: 'Return the metadata of a RAG collection by name.',
+            inputSchema: { name: z.string() },
+        },
+        handler: async (_ctx, args) => {
+            const name = String(args.name);
+            const meta = registry.list().find((m) => m.name === name);
+            if (!meta) {
+                return { ok: false, error: `Collection '${name}' not found` };
+            }
+            return { ok: true, meta };
+        },
+    };
+    const deleteTool = {
+        toolDefinition: {
+            name: 'rag_delete_collection',
+            description: 'Delete a RAG collection you own (session or user scope).',
+            inputSchema: { name: z.string() },
+        },
+        handler: async (ctx, args) => {
+            const name = String(args.name);
+            const meta = registry.list().find((m) => m.name === name);
+            if (!meta) {
+                return { ok: false, error: `Collection '${name}' not found` };
+            }
+            if (meta.scope === 'global' || !meta.scope) {
+                return {
+                    ok: false,
+                    error: `Global collections cannot be deleted via MCP`,
+                };
+            }
+            if (meta.scope === 'session') {
+                if (!ctx.sessionId || ctx.sessionId !== meta.sessionId) {
+                    return {
+                        ok: false,
+                        error: `sessionId mismatch for collection '${name}'`,
+                    };
+                }
+            }
+            if (meta.scope === 'user') {
+                if (!ctx.userId || ctx.userId !== meta.userId) {
+                    return {
+                        ok: false,
+                        error: `userId mismatch for collection '${name}'`,
+                    };
+                }
+            }
+            const res = await registry.deleteCollection(name);
+            return res.ok ? { ok: true } : { ok: false, error: res.error.message };
+        },
+    };
+    const tools = [
+        addTool,
+        correctTool,
+        deprecateTool,
+        listTool,
+        describeTool,
+        deleteTool,
+    ];
+    if (opts.providerRegistry) {
+        const providerRegistry = opts.providerRegistry;
+        const createTool = {
+            toolDefinition: {
+                name: 'rag_create_collection',
+                description: 'Create a new RAG collection via a provider.',
+                inputSchema: {
+                    provider: z.string(),
+                    name: z.string(),
+                    scope: z.enum(['session', 'user', 'global']),
+                    displayName: z.string().optional(),
+                    description: z.string().optional(),
+                    tags: z.array(z.string()).optional(),
+                },
+            },
+            handler: async (ctx, args) => {
+                const providerName = String(args.provider);
+                const provider = providerRegistry.getProvider(providerName);
+                if (!provider) {
+                    return {
+                        ok: false,
+                        error: `RAG provider '${providerName}' is not registered`,
+                    };
+                }
+                const res = await registry.createCollection({
+                    providerName,
+                    collectionName: String(args.name),
+                    scope: args.scope,
+                    sessionId: ctx.sessionId,
+                    userId: ctx.userId,
+                    displayName: args.displayName,
+                    description: args.description,
+                    tags: args.tags,
+                });
+                return res.ok
+                    ? { ok: true, meta: res.value }
+                    : { ok: false, error: res.error.message };
+            },
+        };
+        tools.push(createTool);
+    }
+    return tools;
+}
+//# sourceMappingURL=rag-collection-tools.js.map

package/dist/smart-agent/rag/mcp-tools/rag-collection-tools.js.map

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

package/dist/smart-agent/rag/overlays/index.d.ts

@@ -0,0 +1,3 @@
+export { OverlayRag } from './overlay-rag.js';
+export { SessionScopedRag } from './session-scoped-rag.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/smart-agent/rag/overlays/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/smart-agent/rag/overlays/index.js

@@ -0,0 +1,3 @@
+export { OverlayRag } from './overlay-rag.js';
+export { SessionScopedRag } from './session-scoped-rag.js';
+//# sourceMappingURL=index.js.map

package/dist/smart-agent/rag/overlays/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/smart-agent/rag/overlays/overlay-rag.d.ts

@@ -0,0 +1,15 @@
+import type { IQueryEmbedding } from '../../interfaces/query-embedding.js';
+import type { IRag } from '../../interfaces/rag.js';
+import type { CallOptions, RagError, RagResult, Result } from '../../interfaces/types.js';
+export declare class OverlayRag implements IRag {
+    protected readonly base: IRag;
+    protected readonly overlay: IRag;
+    constructor(base: IRag, overlay: IRag);
+    query(embedding: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+    getById(id: string, options?: CallOptions): Promise<Result<RagResult | null, RagError>>;
+    healthCheck(options?: CallOptions): Promise<Result<void, RagError>>;
+    /** Hook for subclasses to drop overlay rows (e.g. by sessionId). */
+    protected filterOverlay(results: RagResult[]): RagResult[];
+    protected overlayAllows(_result: RagResult): boolean;
+}
+//# sourceMappingURL=overlay-rag.d.ts.map

package/dist/smart-agent/rag/overlays/overlay-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-rag.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/overlay-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,MAAM,EACP,MAAM,2BAA2B,CAAC;AAEnC,qBAAa,UAAW,YAAW,IAAI;IAEnC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;IAC7B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI;gBADb,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI;IAG5B,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;IAwBnC,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IAOxC,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IASzE,oEAAoE;IACpE,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;IAI1D,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO;CAGrD"}

package/dist/smart-agent/rag/overlays/overlay-rag.js

@@ -0,0 +1,55 @@
+export class OverlayRag {
+    base;
+    overlay;
+    constructor(base, overlay) {
+        this.base = base;
+        this.overlay = overlay;
+    }
+    async query(embedding, k, options) {
+        const [baseRes, overlayRes] = await Promise.all([
+            this.base.query(embedding, k, options),
+            this.overlay.query(embedding, k, options),
+        ]);
+        if (!baseRes.ok)
+            return baseRes;
+        if (!overlayRes.ok)
+            return overlayRes;
+        const overlayList = this.filterOverlay(overlayRes.value);
+        const overlayKeys = new Set(overlayList
+            .map((r) => r.metadata.canonicalKey)
+            .filter((key) => typeof key === 'string'));
+        const baseKept = baseRes.value.filter((r) => {
+            const key = r.metadata.canonicalKey;
+            return typeof key !== 'string' || !overlayKeys.has(key);
+        });
+        const merged = [...overlayList, ...baseKept]
+            .sort((a, b) => b.score - a.score)
+            .slice(0, k);
+        return { ok: true, value: merged };
+    }
+    async getById(id, options) {
+        const o = await this.overlay.getById(id, options);
+        if (!o.ok)
+            return o;
+        if (o.value !== null && this.overlayAllows(o.value))
+            return o;
+        return this.base.getById(id, options);
+    }
+    async healthCheck(options) {
+        const [a, b] = await Promise.all([
+            this.base.healthCheck(options),
+            this.overlay.healthCheck(options),
+        ]);
+        if (!a.ok)
+            return a;
+        return b;
+    }
+    /** Hook for subclasses to drop overlay rows (e.g. by sessionId). */
+    filterOverlay(results) {
+        return results;
+    }
+    overlayAllows(_result) {
+        return true;
+    }
+}
+//# sourceMappingURL=overlay-rag.js.map

package/dist/smart-agent/rag/overlays/overlay-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-rag.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/overlay-rag.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,UAAU;IAEA;IACA;IAFrB,YACqB,IAAU,EACV,OAAa;QADb,SAAI,GAAJ,IAAI,CAAM;QACV,YAAO,GAAP,OAAO,CAAM;IAC/B,CAAC;IAEJ,KAAK,CAAC,KAAK,CACT,SAA0B,EAC1B,CAAS,EACT,OAAqB;QAErB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC;QAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,WAAW;aACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;aACnC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAC3D,CAAC;QACF,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;YACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC;aACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,EAAU,EACV,OAAqB;QAErB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAqB;QACrC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,oEAAoE;IAC1D,aAAa,CAAC,OAAoB;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAES,aAAa,CAAC,OAAkB;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/smart-agent/rag/overlays/session-scoped-rag.d.ts

@@ -0,0 +1,12 @@
+import type { IRag } from '../../interfaces/rag.js';
+import type { RagResult } from '../../interfaces/types.js';
+import { OverlayRag } from './overlay-rag.js';
+export declare class SessionScopedRag extends OverlayRag {
+    private readonly sessionId;
+    private readonly ttlMs?;
+    constructor(base: IRag, overlay: IRag, sessionId: string, ttlMs?: number | undefined);
+    protected filterOverlay(results: RagResult[]): RagResult[];
+    protected overlayAllows(result: RagResult): boolean;
+    private matches;
+}
+//# sourceMappingURL=session-scoped-rag.d.ts.map

package/dist/smart-agent/rag/overlays/session-scoped-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-scoped-rag.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/session-scoped-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,qBAAa,gBAAiB,SAAQ,UAAU;IAI5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAHvB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,EACI,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,YAAA;cAKd,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;cAMhD,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAM5D,OAAO,CAAC,OAAO;CAWhB"}

package/dist/smart-agent/rag/overlays/session-scoped-rag.js

@@ -0,0 +1,31 @@
+import { OverlayRag } from './overlay-rag.js';
+export class SessionScopedRag extends OverlayRag {
+    sessionId;
+    ttlMs;
+    constructor(base, overlay, sessionId, ttlMs) {
+        super(base, overlay);
+        this.sessionId = sessionId;
+        this.ttlMs = ttlMs;
+    }
+    filterOverlay(results) {
+        const cutoff = this.ttlMs !== undefined ? Date.now() - this.ttlMs : undefined;
+        return results.filter((r) => this.matches(r, cutoff));
+    }
+    overlayAllows(result) {
+        const cutoff = this.ttlMs !== undefined ? Date.now() - this.ttlMs : undefined;
+        return this.matches(result, cutoff);
+    }
+    matches(result, cutoffMs) {
+        if (result.metadata.sessionId !== this.sessionId)
+            return false;
+        if (cutoffMs !== undefined) {
+            const createdMs = typeof result.metadata.createdAt === 'number'
+                ? result.metadata.createdAt
+                : undefined;
+            if (createdMs !== undefined && createdMs < cutoffMs)
+                return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=session-scoped-rag.js.map

package/dist/smart-agent/rag/overlays/session-scoped-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-scoped-rag.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/overlays/session-scoped-rag.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAI3B;IACA;IAJnB,YACE,IAAU,EACV,OAAa,EACI,SAAiB,EACjB,KAAc;QAE/B,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAHJ,cAAS,GAAT,SAAS,CAAQ;QACjB,UAAK,GAAL,KAAK,CAAS;IAGjC,CAAC;IAEkB,aAAa,CAAC,OAAoB;QACnD,MAAM,MAAM,GACV,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAEkB,aAAa,CAAC,MAAiB;QAChD,MAAM,MAAM,GACV,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAEO,OAAO,CAAC,MAAiB,EAAE,QAA4B;QAC7D,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,SAAS,GACb,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS;gBAC3B,CAAC,CAAC,SAAS,CAAC;YAChB,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,QAAQ;gBAAE,OAAO,KAAK,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/smart-agent/rag/providers/base-provider.d.ts

@@ -0,0 +1,29 @@
+import type { IIdStrategy, IRag, IRagEditor, IRagProvider, RagCollectionScope } from '../../interfaces/rag.js';
+import type { RagError, Result } from '../../interfaces/types.js';
+export declare abstract class AbstractRagProvider implements IRagProvider {
+    abstract readonly name: string;
+    abstract readonly kind: string;
+    abstract readonly editable: boolean;
+    abstract readonly supportedScopes: readonly RagCollectionScope[];
+    protected idStrategyFactory?: (opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }) => IIdStrategy;
+    abstract createCollection(name: string, opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }): Promise<Result<{
+        rag: IRag;
+        editor: IRagEditor;
+    }, RagError>>;
+    protected checkScope(scope: RagCollectionScope): Result<void, RagError>;
+    protected pickIdStrategy(opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }): IIdStrategy;
+    protected buildEditor(rag: IRag, idStrategy: IIdStrategy): IRagEditor;
+}
+//# sourceMappingURL=base-provider.d.ts.map

package/dist/smart-agent/rag/providers/base-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/base-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAWlE,8BAAsB,mBAAoB,YAAW,YAAY;IAC/D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAEjE,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QACnC,KAAK,EAAE,kBAAkB,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,WAAW,CAAC;IAElB,QAAQ,CAAC,gBAAgB,CACvB,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;IAE/D,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;IAOvE,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE;QAC7B,KAAK,EAAE,kBAAkB,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,WAAW;IAQf,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,GAAG,UAAU;CAUtE"}

package/dist/smart-agent/rag/providers/base-provider.js

@@ -0,0 +1,30 @@
+import { UnsupportedScopeError } from '../corrections/errors.js';
+import { DirectEditStrategy, ImmutableEditStrategy, } from '../strategies/edit/index.js';
+import { GlobalUniqueIdStrategy, SessionScopedIdStrategy, } from '../strategies/id/index.js';
+export class AbstractRagProvider {
+    idStrategyFactory;
+    checkScope(scope) {
+        if (!this.supportedScopes.includes(scope)) {
+            return { ok: false, error: new UnsupportedScopeError(this.name, scope) };
+        }
+        return { ok: true, value: undefined };
+    }
+    pickIdStrategy(opts) {
+        if (this.idStrategyFactory)
+            return this.idStrategyFactory(opts);
+        if (opts.scope === 'session' && opts.sessionId) {
+            return new SessionScopedIdStrategy(opts.sessionId);
+        }
+        return new GlobalUniqueIdStrategy();
+    }
+    buildEditor(rag, idStrategy) {
+        if (!this.editable)
+            return new ImmutableEditStrategy(this.name);
+        const writer = rag.writer?.();
+        if (!writer) {
+            throw new Error(`Provider '${this.name}' requires an IRag with writer() support for editable mode`);
+        }
+        return new DirectEditStrategy(writer, idStrategy);
+    }
+}
+//# sourceMappingURL=base-provider.js.map

package/dist/smart-agent/rag/providers/base-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/base-provider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,OAAgB,mBAAmB;IAM7B,iBAAiB,CAIT;IAWR,UAAU,CAAC,KAAyB;QAC5C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACxC,CAAC;IAES,cAAc,CAAC,IAIxB;QACC,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/C,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACtC,CAAC;IAES,WAAW,CAAC,GAAS,EAAE,UAAuB;QACtD,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,IAAI,4DAA4D,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/smart-agent/rag/providers/in-memory-rag-provider.d.ts

@@ -0,0 +1,31 @@
+import type { IIdStrategy, IRag, IRagEditor, RagCollectionScope } from '../../interfaces/rag.js';
+import type { RagError, Result } from '../../interfaces/types.js';
+import { type InMemoryRagConfig } from '../in-memory-rag.js';
+import { AbstractRagProvider } from './base-provider.js';
+export interface InMemoryRagProviderConfig {
+    name: string;
+    editable?: boolean;
+    inMemoryRagConfig?: InMemoryRagConfig;
+    idStrategyFactory?: (opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }) => IIdStrategy;
+}
+export declare class InMemoryRagProvider extends AbstractRagProvider {
+    readonly name: string;
+    readonly kind = "vector";
+    readonly editable: boolean;
+    readonly supportedScopes: readonly ["session"];
+    private readonly inMemoryCfg?;
+    constructor(cfg: InMemoryRagProviderConfig);
+    createCollection(_name: string, opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }): Promise<Result<{
+        rag: IRag;
+        editor: IRagEditor;
+    }, RagError>>;
+}
+//# sourceMappingURL=in-memory-rag-provider.d.ts.map

package/dist/smart-agent/rag/providers/in-memory-rag-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-rag-provider.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/in-memory-rag-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EACJ,UAAU,EACV,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,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,mBAAoB,SAAQ,mBAAmB;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,uBAAwB;IAEhD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAoB;gBAErC,GAAG,EAAE,yBAAyB;IAQpC,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,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;CAOhE"}

package/dist/smart-agent/rag/providers/in-memory-rag-provider.js

@@ -0,0 +1,26 @@
+import { InMemoryRag } from '../in-memory-rag.js';
+import { AbstractRagProvider } from './base-provider.js';
+export class InMemoryRagProvider extends AbstractRagProvider {
+    name;
+    kind = 'vector';
+    editable;
+    supportedScopes = ['session'];
+    inMemoryCfg;
+    constructor(cfg) {
+        super();
+        this.name = cfg.name;
+        this.editable = cfg.editable ?? true;
+        this.inMemoryCfg = cfg.inMemoryRagConfig;
+        if (cfg.idStrategyFactory)
+            this.idStrategyFactory = cfg.idStrategyFactory;
+    }
+    async createCollection(_name, opts) {
+        const scopeCheck = this.checkScope(opts.scope);
+        if (!scopeCheck.ok)
+            return scopeCheck;
+        const rag = new InMemoryRag(this.inMemoryCfg);
+        const editor = this.buildEditor(rag, this.pickIdStrategy(opts));
+        return { ok: true, value: { rag, editor } };
+    }
+}
+//# sourceMappingURL=in-memory-rag-provider.js.map

package/dist/smart-agent/rag/providers/in-memory-rag-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-rag-provider.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/in-memory-rag-provider.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAA0B,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAazD,MAAM,OAAO,mBAAoB,SAAQ,mBAAmB;IACjD,IAAI,CAAS;IACb,IAAI,GAAG,QAAQ,CAAC;IAChB,QAAQ,CAAU;IAClB,eAAe,GAAG,CAAC,SAAS,CAAU,CAAC;IAE/B,WAAW,CAAqB;IAEjD,YAAY,GAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,iBAAiB,CAAC;QACzC,IAAI,GAAG,CAAC,iBAAiB;YAAE,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,KAAa,EACb,IAIC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/smart-agent/rag/providers/index.d.ts

@@ -0,0 +1,6 @@
+export { AbstractRagProvider } from './base-provider.js';
+export { InMemoryRagProvider, type InMemoryRagProviderConfig, } from './in-memory-rag-provider.js';
+export { QdrantRagProvider, type QdrantRagProviderConfig, } from './qdrant-rag-provider.js';
+export { SimpleRagProviderRegistry } from './simple-provider-registry.js';
+export { VectorRagProvider, type VectorRagProviderConfig, } from './vector-rag-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/smart-agent/rag/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC"}

package/dist/smart-agent/rag/providers/index.js

@@ -0,0 +1,6 @@
+export { AbstractRagProvider } from './base-provider.js';
+export { InMemoryRagProvider, } from './in-memory-rag-provider.js';
+export { QdrantRagProvider, } from './qdrant-rag-provider.js';
+export { SimpleRagProviderRegistry } from './simple-provider-registry.js';
+export { VectorRagProvider, } from './vector-rag-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/smart-agent/rag/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/smart-agent/rag/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,mBAAmB,GAEpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAC"}

package/dist/smart-agent/rag/providers/qdrant-rag-provider.d.ts

@@ -0,0 +1,39 @@
+import type { IEmbedder, IIdStrategy, IRag, IRagEditor, RagCollectionScope } from '../../interfaces/rag.js';
+import { RagError, type Result } from '../../interfaces/types.js';
+import { AbstractRagProvider } from './base-provider.js';
+export interface QdrantRagProviderConfig {
+    name: string;
+    url: string;
+    apiKey?: string;
+    embedder: IEmbedder;
+    editable?: boolean;
+    timeoutMs?: number;
+    supportedScopes?: readonly RagCollectionScope[];
+    idStrategyFactory?: (opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }) => IIdStrategy;
+}
+export declare class QdrantRagProvider extends AbstractRagProvider {
+    readonly name: string;
+    readonly kind = "vector";
+    readonly editable: boolean;
+    readonly supportedScopes: readonly RagCollectionScope[];
+    private readonly url;
+    private readonly apiKey?;
+    private readonly embedder;
+    private readonly timeoutMs?;
+    constructor(cfg: QdrantRagProviderConfig);
+    createCollection(name: string, opts: {
+        scope: RagCollectionScope;
+        sessionId?: string;
+        userId?: string;
+    }): Promise<Result<{
+        rag: IRag;
+        editor: IRagEditor;
+    }, RagError>>;
+    deleteCollection(name: string): Promise<Result<void, RagError>>;
+    listCollections(): Promise<Result<string[], RagError>>;
+}
+//# sourceMappingURL=qdrant-rag-provider.d.ts.map