@mcp-abap-adt/llm-agent-libs 19.1.2 → 19.2.0

package/dist/skills/plugin-host/compatible-skills-rag.test.js

@@ -0,0 +1,174 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { SkillsIncompatibleError } from '@mcp-abap-adt/llm-agent';
+import { makeCompatibleSkillsRag } from './compatible-skills-rag.js';
+const MANIFEST = {
+    embeddingSpaceId: 'sp',
+    dimension: 3,
+    retrievalSchemaVersion: 1,
+};
+function stubBackend(opts) {
+    let queryCalls = 0;
+    const released = [];
+    return {
+        backend: {
+            activeSnapshot: opts.snapshot,
+            release(rev) {
+                released.push(rev);
+            },
+            async queryRevision() {
+                queryCalls++;
+                return (opts.hits ?? []);
+            },
+        },
+        queryCalls: () => queryCalls,
+        released: () => released,
+    };
+}
+test('lease: release(revision) is called in the finally on every non-null path', async () => {
+    // compatible path
+    const ok = stubBackend({
+        snapshot: async () => ({ revision: 'g0', manifest: MANIFEST }),
+        hits: [],
+    });
+    const ragOk = makeCompatibleSkillsRag({
+        backend: ok.backend,
+        embedder: { embed: async () => ({ vector: [1, 0, 0] }) },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+    });
+    await ragOk.query('q', { k: 1 });
+    assert.deepEqual(ok.released(), ['g0']);
+    // incompatible path (no query, still releases)
+    const bad = stubBackend({
+        snapshot: async () => ({
+            revision: 'g1',
+            manifest: { ...MANIFEST, embeddingSpaceId: 'X' },
+        }),
+    });
+    const ragBad = makeCompatibleSkillsRag({
+        backend: bad.backend,
+        embedder: { embed: async () => ({ vector: [1, 0, 0] }) },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+    });
+    await ragBad.query('q', { k: 1 });
+    assert.deepEqual(bad.released(), ['g1']);
+});
+test('recallTimeoutMs: a query that outlives the deadline aborts → empty (no crash)', async () => {
+    const backend = {
+        activeSnapshot: async () => ({ revision: 'g0', manifest: MANIFEST }),
+        release() { },
+        async queryRevision(_r, _v, _k, options) {
+            // simulate a slow backend that respects the abort signal
+            return await new Promise((resolve, reject) => {
+                const t = setTimeout(() => resolve([]), 1000);
+                options?.signal?.addEventListener('abort', () => {
+                    clearTimeout(t);
+                    reject(Object.assign(new Error('aborted'), { name: 'AbortError' }));
+                });
+            });
+        },
+    };
+    const rag = makeCompatibleSkillsRag({
+        backend: backend,
+        embedder: { embed: async () => ({ vector: [1, 0, 0] }) },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+        recallTimeoutMs: 20,
+    });
+    const hits = await rag.query('q', { k: 1 }); // resolves to [] when the 20ms deadline fires
+    assert.deepEqual(hits, []);
+});
+test('compatible revision: embeds once, calls queryRevision', async () => {
+    let embeds = 0;
+    const sb = stubBackend({
+        snapshot: async () => ({ revision: 'g0', manifest: MANIFEST }),
+        hits: [{ record: { content: 'x' }, score: 0.9 }],
+    });
+    const rag = makeCompatibleSkillsRag({
+        backend: sb.backend,
+        embedder: {
+            embed: async () => {
+                embeds++;
+                return { vector: [1, 0, 0] };
+            },
+        },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+    });
+    const hits = await rag.query('q', { k: 1, threshold: 0 });
+    assert.equal(hits.length, 1);
+    assert.equal(embeds, 1);
+    assert.equal(sb.queryCalls(), 1);
+});
+test('incompatible revision: query() degrades to empty (ZERO embeds), but activeManifest() THROWS', async () => {
+    let embeds = 0;
+    const sb = stubBackend({
+        snapshot: async () => ({
+            revision: 'g0',
+            manifest: { ...MANIFEST, embeddingSpaceId: 'OTHER' },
+        }),
+    });
+    const rag = makeCompatibleSkillsRag({
+        backend: sb.backend,
+        embedder: {
+            embed: async () => {
+                embeds++;
+                return { vector: [1, 0, 0] };
+            },
+        },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+    });
+    // RUNTIME query() degrades to []
+    const hits = await rag.query('q', { k: 1 });
+    assert.equal(hits.length, 0);
+    assert.equal(embeds, 0); // embed skipped on incompatible
+    // EAGER activeManifest() THROWS (so recall-only load()/healthCheck can fail-fast)
+    await assert.rejects(() => rag.activeManifest(), (e) => e instanceof SkillsIncompatibleError);
+});
+test('null snapshot: ZERO embeds, empty', async () => {
+    let embeds = 0;
+    const sb = stubBackend({ snapshot: async () => null });
+    const rag = makeCompatibleSkillsRag({
+        backend: sb.backend,
+        embedder: {
+            embed: async () => {
+                embeds++;
+                return { vector: [1, 0, 0] };
+            },
+        },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1,
+        dimension: 3,
+    });
+    assert.equal((await rag.query('q', { k: 1 })).length, 0);
+    assert.equal(embeds, 0);
+});
+test('lazy dimension probe: no embed at construction; first activeManifest probes once', async () => {
+    let embeds = 0;
+    const sb = stubBackend({
+        snapshot: async () => ({ revision: 'g0', manifest: MANIFEST }),
+    });
+    const rag = makeCompatibleSkillsRag({
+        backend: sb.backend,
+        embedder: {
+            embed: async () => {
+                embeds++;
+                return { vector: [1, 0, 0] };
+            },
+        },
+        embeddingSpaceId: 'sp',
+        retrievalSchemaVersion: 1, // dimension undeclared
+    });
+    assert.equal(embeds, 0); // construction did not embed
+    await rag.activeManifest();
+    assert.equal(embeds, 1); // one probe
+});
+//# sourceMappingURL=compatible-skills-rag.test.js.map

package/dist/skills/plugin-host/compatible-skills-rag.test.js.map

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

package/dist/skills/plugin-host/http-marketplace-source.d.ts

@@ -0,0 +1,46 @@
+import type { ISkillSource } from '@mcp-abap-adt/llm-agent';
+/** Mockable transport over the marketplace registry: a manifest listing plus per-skill
+ *  SKILL.md fetch. The unit tests inject a fake; {@link makeHttpTransport} is the live
+ *  global-`fetch` implementation (exercised end-to-end, not in unit tests). */
+export interface IMarketplaceTransport {
+    /** List every plugin the registry offers, with its version and skill names. */
+    listPlugins(): Promise<Array<{
+        plugin: string;
+        version: string;
+        skills: string[];
+    }>>;
+    /** Fetch the raw SKILL.md text for one skill of one plugin. */
+    fetchSkillMd(plugin: string, skill: string): Promise<string>;
+}
+export interface HttpMarketplaceSourceOptions {
+    /** Stable sourceId stamped onto every record/collection. */
+    source: string;
+    /** Plugins to enable; non-empty required. `['*']` = every offered plugin. */
+    enabled: readonly string[];
+    transport: IMarketplaceTransport;
+    chunk: {
+        maxChars: number;
+    };
+    /** plugin → its group + description; default one-group-per-plugin. */
+    placement?: (plugin: string) => {
+        group: string;
+        description: string;
+    };
+}
+/** Build an {@link ISkillSource} backed by a marketplace {@link IMarketplaceTransport}.
+ *  `acquire()` resolves the enabled plugin set against the registry manifest, fetches each
+ *  SKILL.md, and delegates placement/chunking to {@link buildIngestResult}. FS/network-free
+ *  given a mock transport. */
+export declare function makeHttpMarketplaceSource(opts: HttpMarketplaceSourceOptions): ISkillSource;
+export interface HttpTransportOptions {
+    /** Base URL of the marketplace registry (no trailing slash required). */
+    registry: string;
+    /** Optional bearer token sent as `Authorization: Bearer <apiKey>`. */
+    apiKey?: string;
+}
+/** Live {@link IMarketplaceTransport} over global `fetch`. NOT unit-tested (no real network
+ *  in tests); exercised live against a registry. Endpoints:
+ *  `GET {registry}/plugins` → `[{ plugin, version, skills }]`;
+ *  `GET {registry}/plugins/{plugin}/skills/{skill}` → raw SKILL.md text. */
+export declare function makeHttpTransport(opts: HttpTransportOptions): IMarketplaceTransport;
+//# sourceMappingURL=http-marketplace-source.d.ts.map

package/dist/skills/plugin-host/http-marketplace-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-marketplace-source.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/http-marketplace-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,yBAAyB,CAAC;AAGjC;;+EAE+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CACpB,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAC7D,CAAC;IACF,+DAA+D;IAC/D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,4BAA4B;IAC3C,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAOD;;;8BAG8B;AAC9B,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,4BAA4B,GACjC,YAAY,CAoCd;AAED,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;4EAG4E;AAC5E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,GACzB,qBAAqB,CA6BvB"}

package/dist/skills/plugin-host/http-marketplace-source.js

@@ -0,0 +1,67 @@
+import { buildIngestResult } from './marketplace-adapter.js';
+const defaultPlacement = (plugin) => ({
+    group: plugin,
+    description: plugin,
+});
+/** Build an {@link ISkillSource} backed by a marketplace {@link IMarketplaceTransport}.
+ *  `acquire()` resolves the enabled plugin set against the registry manifest, fetches each
+ *  SKILL.md, and delegates placement/chunking to {@link buildIngestResult}. FS/network-free
+ *  given a mock transport. */
+export function makeHttpMarketplaceSource(opts) {
+    if (opts.enabled.length === 0) {
+        throw new Error('makeHttpMarketplaceSource: `enabled` must be non-empty');
+    }
+    const placement = opts.placement ?? defaultPlacement;
+    const wantAll = opts.enabled.includes('*');
+    const enabledSet = new Set(opts.enabled);
+    return {
+        async acquire(_options) {
+            const offered = await opts.transport.listPlugins();
+            const selected = wantAll
+                ? offered
+                : offered.filter((p) => enabledSet.has(p.plugin));
+            const plugins = await Promise.all(selected.map(async (p) => ({
+                plugin: p.plugin,
+                version: p.version,
+                skills: await Promise.all(p.skills.map(async (skill) => ({
+                    skill,
+                    skillMd: await opts.transport.fetchSkillMd(p.plugin, skill),
+                }))),
+            })));
+            return buildIngestResult({
+                source: opts.source,
+                plugins,
+                chunk: opts.chunk,
+                placement,
+            });
+        },
+    };
+}
+/** Live {@link IMarketplaceTransport} over global `fetch`. NOT unit-tested (no real network
+ *  in tests); exercised live against a registry. Endpoints:
+ *  `GET {registry}/plugins` → `[{ plugin, version, skills }]`;
+ *  `GET {registry}/plugins/{plugin}/skills/{skill}` → raw SKILL.md text. */
+export function makeHttpTransport(opts) {
+    const base = opts.registry.replace(/\/+$/, '');
+    const headers = opts.apiKey
+        ? { authorization: `Bearer ${opts.apiKey}` }
+        : {};
+    return {
+        async listPlugins() {
+            const res = await fetch(`${base}/plugins`, { headers });
+            if (!res.ok) {
+                throw new Error(`listPlugins ${res.status} ${res.statusText}`);
+            }
+            return (await res.json());
+        },
+        async fetchSkillMd(plugin, skill) {
+            const url = `${base}/plugins/${encodeURIComponent(plugin)}/skills/${encodeURIComponent(skill)}`;
+            const res = await fetch(url, { headers });
+            if (!res.ok) {
+                throw new Error(`fetchSkillMd(${plugin}/${skill}) ${res.status} ${res.statusText}`);
+            }
+            return await res.text();
+        },
+    };
+}
+//# sourceMappingURL=http-marketplace-source.js.map

package/dist/skills/plugin-host/http-marketplace-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-marketplace-source.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/http-marketplace-source.ts"],"names":[],"mappings":"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"}

package/dist/skills/plugin-host/http-marketplace-source.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-marketplace-source.test.d.ts.map

package/dist/skills/plugin-host/http-marketplace-source.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-marketplace-source.test.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/http-marketplace-source.test.ts"],"names":[],"mappings":""}

package/dist/skills/plugin-host/http-marketplace-source.test.js

@@ -0,0 +1,71 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { makeHttpMarketplaceSource } from './http-marketplace-source.js';
+const SKILL_MD = `---\nname: s\ndescription: d\n---\n## H\nbody`;
+test('fetches manifest + SKILL.md via injected transport, builds ingest result, zero FS', async () => {
+    const src = makeHttpMarketplaceSource({
+        source: 'vendor',
+        enabled: ['p1'],
+        transport: {
+            async listPlugins() {
+                return [{ plugin: 'p1', version: '1', skills: ['s'] }];
+            },
+            async fetchSkillMd(plugin, skill) {
+                assert.equal(plugin, 'p1');
+                assert.equal(skill, 's');
+                return SKILL_MD;
+            },
+        },
+        chunk: { maxChars: 1000 },
+    });
+    const res = await src.acquire();
+    assert.deepEqual(res.collections.map((c) => c.group), ['p1']);
+    assert.ok(res.records.length >= 1);
+});
+test('enabled "*" loads every offered plugin; empty enabled is a caller error', async () => {
+    const transport = {
+        async listPlugins() {
+            return [
+                { plugin: 'a', version: '1', skills: ['s'] },
+                { plugin: 'b', version: '1', skills: ['s'] },
+            ];
+        },
+        async fetchSkillMd() {
+            return SKILL_MD;
+        },
+    };
+    const all = makeHttpMarketplaceSource({
+        source: 'v',
+        enabled: ['*'],
+        transport,
+        chunk: { maxChars: 1000 },
+    });
+    assert.equal((await all.acquire()).collections.length, 2);
+    assert.throws(() => makeHttpMarketplaceSource({
+        source: 'v',
+        enabled: [],
+        transport,
+        chunk: { maxChars: 1000 },
+    }), /enabled/);
+});
+test('only the enabled subset of offered plugins is acquired', async () => {
+    const src = makeHttpMarketplaceSource({
+        source: 'v',
+        enabled: ['b'],
+        transport: {
+            async listPlugins() {
+                return [
+                    { plugin: 'a', version: '1', skills: ['s'] },
+                    { plugin: 'b', version: '1', skills: ['s'] },
+                ];
+            },
+            async fetchSkillMd() {
+                return SKILL_MD;
+            },
+        },
+        chunk: { maxChars: 1000 },
+    });
+    const res = await src.acquire();
+    assert.deepEqual(res.collections.map((c) => c.group), ['b']);
+});
+//# sourceMappingURL=http-marketplace-source.test.js.map

package/dist/skills/plugin-host/http-marketplace-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-marketplace-source.test.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/http-marketplace-source.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,QAAQ,GAAG,+CAA+C,CAAC;AAEjE,IAAI,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;IACnG,MAAM,GAAG,GAAG,yBAAyB,CAAC;QACpC,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,SAAS,EAAE;YACT,KAAK,CAAC,WAAW;gBACf,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK;gBAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACzB,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF;QACD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,MAAM,CAAC,SAAS,CACd,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EACnC,CAAC,IAAI,CAAC,CACP,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;IACzF,MAAM,SAAS,GAAG;QAChB,KAAK,CAAC,WAAW;YACf,OAAO;gBACL,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;gBAC5C,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;aAC7C,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,YAAY;YAChB,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;IACF,MAAM,GAAG,GAAG,yBAAyB,CAAC;QACpC,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,SAAS;QACT,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,yBAAyB,CAAC;QACxB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE;QACX,SAAS;QACT,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1B,CAAC,EACJ,SAAS,CACV,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;IACxE,MAAM,GAAG,GAAG,yBAAyB,CAAC;QACpC,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,SAAS,EAAE;YACT,KAAK,CAAC,WAAW;gBACf,OAAO;oBACL,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;oBAC5C,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;iBAC7C,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,YAAY;gBAChB,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF;QACD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,MAAM,CAAC,SAAS,CACd,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EACnC,CAAC,GAAG,CAAC,CACN,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/skills/plugin-host/in-memory-store.d.ts

@@ -0,0 +1,15 @@
+import type { CallOptions, ISkillsStoreProvider, SkillRecord } from '@mcp-abap-adt/llm-agent';
+interface Row {
+    record: SkillRecord;
+    vector: number[];
+}
+type Embed = (text: string, options?: CallOptions) => Promise<number[]>;
+export interface IInMemoryStoreProvider extends ISkillsStoreProvider {
+    /** TEST SEAM: write pre-vectorised rows into a generation without an embedder. */
+    _seed(generation: string, rows: Row[]): Promise<void>;
+}
+export declare function makeInMemoryStoreProvider(opts?: {
+    embed?: Embed;
+}): IInMemoryStoreProvider;
+export {};
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/skills/plugin-host/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAKX,oBAAoB,EAEpB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAGjC,UAAU,GAAG;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,KAAK,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAExE,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,kFAAkF;IAClF,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAcD,wBAAgB,yBAAyB,CACvC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAO,GAC3B,sBAAsB,CAsJxB"}

package/dist/skills/plugin-host/in-memory-store.js

@@ -0,0 +1,151 @@
+import { CatalogCasError } from '@mcp-abap-adt/llm-agent'; // value (class), not a type
+function cosine(a, b) {
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    return na && nb ? dot / (Math.sqrt(na) * Math.sqrt(nb)) : 0;
+}
+export function makeInMemoryStoreProvider(opts = {}) {
+    // generations: generationId -> rows
+    const gens = new Map();
+    // EXACT retention (P1.1): a refcount lease per generation + deferred physical delete.
+    const leases = new Map(); // generation -> active reader count
+    const pendingDelete = new Set(); // generations asked to delete while leased
+    // catalog
+    let catalogRevision = 'c0';
+    let entries = [];
+    let genSeq = 0;
+    const embed = opts.embed ??
+        (async () => {
+            throw new Error('no embedder configured');
+        });
+    const liveGenerationOf = (group) => entries.find((e) => e.collection.group === group && !e.tombstone)
+        ?.generation;
+    const isActive = (gen) => entries.some((e) => e.generation === gen && !e.tombstone);
+    // delete now IF safe (not active, not leased); else mark pending.
+    function reclaim(gen) {
+        if (isActive(gen))
+            return; // never delete a served generation
+        if ((leases.get(gen) ?? 0) > 0) {
+            pendingDelete.add(gen);
+            return;
+        } // a reader holds it
+        gens.delete(gen);
+        pendingDelete.delete(gen);
+    }
+    function backendFor(group) {
+        return {
+            async activeSnapshot() {
+                const e = entries.find((x) => x.collection.group === group && !x.tombstone);
+                if (!e)
+                    return null;
+                leases.set(e.generation, (leases.get(e.generation) ?? 0) + 1); // PIN (lease)
+                return { revision: e.generation, manifest: e.manifest };
+            },
+            release(revision) {
+                const n = (leases.get(revision) ?? 0) - 1;
+                if (n <= 0) {
+                    leases.delete(revision);
+                    if (pendingDelete.has(revision))
+                        reclaim(revision); // delete now that no reader holds it
+                }
+                else {
+                    leases.set(revision, n);
+                }
+            },
+            async queryRevision(revision, vector, k) {
+                const rows = gens.get(revision); // captured synchronously; lease guaranteed it survives
+                if (!rows)
+                    throw new Error(`unknown generation: ${revision}`);
+                return rows
+                    .map((r) => ({ record: r.record, score: cosine(vector, r.vector) }))
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, k);
+            },
+        };
+    }
+    function storeFor(group) {
+        const backend = backendFor(group);
+        return {
+            ...backend,
+            async beginGeneration() {
+                const generation = `${group}#g${genSeq++}`;
+                gens.set(generation, []);
+                return { generation };
+            },
+            async upsert(generation, records, options) {
+                const rows = gens.get(generation) ?? [];
+                for (const record of records) {
+                    rows.push({
+                        record,
+                        vector: await embed(record.retrievalText, options),
+                    });
+                }
+                gens.set(generation, rows);
+            },
+            async carryForward(generation, sourceIds) {
+                const live = liveGenerationOf(group);
+                if (!live)
+                    return;
+                const src = new Set(sourceIds);
+                const carried = (gens.get(live) ?? []).filter((r) => src.has(r.record.sourceId));
+                gens.set(generation, [...(gens.get(generation) ?? []), ...carried]);
+            },
+            async discardGeneration(generation) {
+                reclaim(generation); // no-op if active; deferred if leased
+            },
+        };
+    }
+    return {
+        forGroup: storeFor,
+        async _seed(generation, rows) {
+            gens.set(generation, [...(gens.get(generation) ?? []), ...rows]);
+        },
+        async readCatalog() {
+            return { catalogRevision, entries: entries.filter((e) => !e.tombstone) };
+        },
+        async publishCatalog(expectedCatalogRevision, next) {
+            if (expectedCatalogRevision !== catalogRevision) {
+                throw new CatalogCasError(`stale catalog revision: expected ${expectedCatalogRevision}, active ${catalogRevision}`);
+            }
+            const nextGens = new Set(next.filter((e) => !e.tombstone).map((e) => e.generation));
+            const retired = entries
+                .filter((e) => !nextGens.has(e.generation))
+                .map((e) => ({
+                generation: e.generation,
+                group: e.collection.group,
+                retiredAt: 0,
+            })); // in-memory: lease, retiredAt unused
+            entries = [...next];
+            catalogRevision = `c${Number(catalogRevision.slice(1)) + 1}`; // STORE generates revision
+            return {
+                catalogRevision,
+                entries: entries.filter((e) => !e.tombstone),
+                retired,
+            };
+        },
+        async dropCollection(group) {
+            // reclaim generations not named by an ACTIVE entry of this group (lease-respecting)
+            const activeGen = liveGenerationOf(group);
+            for (const gen of [...gens.keys()]) {
+                if (gen.startsWith(`${group}#`) && gen !== activeGen)
+                    reclaim(gen);
+            }
+            // remove tombstoned entries of this group from the catalog records
+            entries = entries.filter((e) => !(e.collection.group === group && e.tombstone));
+        },
+        asBackendProvider() {
+            // read-only view: only readCatalog + forGroup→backend (no write/reconcile API)
+            return {
+                readCatalog: this.readCatalog,
+                forGroup: (g) => backendFor(g),
+            };
+        },
+    };
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/skills/plugin-host/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/in-memory-store.ts"],"names":[],"mappings":"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"}

package/dist/skills/plugin-host/in-memory-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=in-memory-store.test.d.ts.map

package/dist/skills/plugin-host/in-memory-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.test.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/in-memory-store.test.ts"],"names":[],"mappings":""}