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

package/dist/skills/plugin-host/skill-plugin-host.recall-and-reload.test.js

@@ -0,0 +1,328 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { SkillsIncompatibleError } from '@mcp-abap-adt/llm-agent';
+import { makeInMemoryStoreProvider } from './in-memory-store.js';
+import { makeSkillPluginHost } from './skill-plugin-host.js';
+// Deterministic 3-dim vector from text — lets the in-memory store embed with no real embedder.
+function hash3(text) {
+    const v = [0, 0, 0];
+    for (let i = 0; i < text.length; i++) {
+        v[i % 3] += text.charCodeAt(i);
+    }
+    return v;
+}
+// In-memory store provider embed: text → vector (number[]).
+const embed = async (text) => hash3(text);
+// Host serving embedder: text → IEmbedResult.
+const embedder = {
+    async embed(text) {
+        return { vector: hash3(text) };
+    },
+};
+function rec(id, sourceId, group, content) {
+    return {
+        id,
+        sourceId,
+        group,
+        name: id,
+        retrievalText: content,
+        content,
+        provenance: id,
+    };
+}
+function info(group, description = `desc-${group}`) {
+    return { group, description, collection: group };
+}
+function makeStubSource(result) {
+    return {
+        async acquire(_options) {
+            if (typeof result === 'function')
+                return result();
+            return result;
+        },
+    };
+}
+const SERVE_BASE = {
+    embedder: embedder,
+    embeddingSpaceId: 'sp',
+    retrievalSchemaVersion: 1,
+    dimension: 3,
+};
+/** Seed an in-memory provider with one committed generation for `group`. */
+async function seedProvider(group, records, manifest = {
+    embeddingSpaceId: 'sp',
+    dimension: 3,
+    retrievalSchemaVersion: 1,
+}) {
+    const provider = makeInMemoryStoreProvider({ embed });
+    const generation = `${group}#g0`;
+    await provider._seed(generation, records.map((r) => ({ record: r, vector: hash3(r.retrievalText) })));
+    await provider.publishCatalog('c0', [
+        {
+            collection: info(group),
+            sources: ['seed'],
+            generation,
+            manifest,
+        },
+    ]);
+    return provider;
+}
+// 1 -------------------------------------------------------------------------
+test('recall-only: load() validates serveCollections + eager compat; groups()/rag() from catalog', async () => {
+    const provider = await seedProvider('g1', [
+        rec('g1:a', 'seed', 'g1', 'alpha record'),
+    ]);
+    const host = makeSkillPluginHost({
+        ...SERVE_BASE,
+        backendProvider: provider.asBackendProvider(),
+        serveCollections: ['g1'],
+    });
+    const res = await host.load();
+    assert.equal(res.ok, true);
+    assert.deepEqual(res.committed, ['g1']);
+    assert.deepEqual(res.omitted, []);
+    assert.deepEqual(res.tombstoned, []);
+    assert.deepEqual(host.groups().map((g) => g.group), ['g1']);
+    const hits = await host
+        .rag('g1')
+        .query('alpha record', { k: 5, threshold: 0 });
+    assert.ok(hits.some((h) => h.record.id === 'g1:a'));
+});
+// 2 -------------------------------------------------------------------------
+test('recall-only: serveCollections naming an absent collection → load() throws (config error)', async () => {
+    const provider = await seedProvider('g1', [
+        rec('g1:a', 'seed', 'g1', 'alpha'),
+    ]);
+    const host = makeSkillPluginHost({
+        ...SERVE_BASE,
+        backendProvider: provider.asBackendProvider(),
+        serveCollections: ['missing'],
+    });
+    await assert.rejects(() => host.load(), /serveCollections/);
+});
+// 3 -------------------------------------------------------------------------
+test('recall-only: incompatible serving embeddingSpaceId → load() throws (eager)', async () => {
+    // Seed manifest with embeddingSpaceId 'sp'; serve with a different one → incompatible.
+    const provider = await seedProvider('g1', [
+        rec('g1:a', 'seed', 'g1', 'alpha'),
+    ]);
+    const host = makeSkillPluginHost({
+        ...SERVE_BASE,
+        embeddingSpaceId: 'OTHER-SPACE',
+        backendProvider: provider.asBackendProvider(),
+        serveCollections: ['g1'],
+    });
+    await assert.rejects(() => host.load(), (e) => e instanceof SkillsIncompatibleError);
+});
+// 4 -------------------------------------------------------------------------
+test('serving reload SAME set, new generations → succeeds and rotates', async () => {
+    const provider = makeInMemoryStoreProvider({ embed });
+    const mkHost = (body) => makeSkillPluginHost({
+        ...SERVE_BASE,
+        storeProvider: provider,
+        sources: [
+            {
+                id: 's1',
+                source: makeStubSource({
+                    collections: [info('c1')],
+                    records: [rec('c1:a', 's1', 'c1', body)],
+                }),
+            },
+        ],
+    });
+    // First load registers the served set {c1}.
+    const host = mkHost('v1 body');
+    await host.load();
+    const gen1 = (await provider.readCatalog()).entries.find((e) => e.collection.group === 'c1')?.generation;
+    // Reload on the SAME host, SAME set → new generation, no throw.
+    const res = await host.load();
+    assert.equal(res.ok, true);
+    assert.deepEqual(res.committed, ['c1']);
+    const gen2 = (await provider.readCatalog()).entries.find((e) => e.collection.group === 'c1')?.generation;
+    assert.notEqual(gen1, gen2); // rotated
+});
+// 5 -------------------------------------------------------------------------
+test('serving reload LOCAL change (sources resolve a new collection) → throws, no build/publish', async () => {
+    // A host whose source set changes between loads via a toggling stub: first load resolves
+    // {c1} (registers the served set), the second resolves {c1,c2} (a LOCAL change).
+    let loadNo = 0;
+    const togglingSource = {
+        async acquire() {
+            loadNo++;
+            if (loadNo === 1) {
+                return {
+                    collections: [info('c1')],
+                    records: [rec('c1:a', 'sX', 'c1', 'alpha')],
+                };
+            }
+            return {
+                collections: [info('c1'), info('c2')],
+                records: [
+                    rec('c1:a', 'sX', 'c1', 'alpha'),
+                    rec('c2:a', 'sX', 'c2', 'beta'),
+                ],
+            };
+        },
+    };
+    const provider2 = makeInMemoryStoreProvider({ embed });
+    let begin2 = 0;
+    let publish2 = 0;
+    const fg2 = provider2.forGroup.bind(provider2);
+    provider2.forGroup = (group) => {
+        const store = fg2(group);
+        return {
+            ...store,
+            async beginGeneration() {
+                begin2++;
+                return store.beginGeneration();
+            },
+        };
+    };
+    const pub2 = provider2.publishCatalog.bind(provider2);
+    provider2.publishCatalog = async (rev, entries, options) => {
+        publish2++;
+        return pub2(rev, entries, options);
+    };
+    const reloadHost = makeSkillPluginHost({
+        ...SERVE_BASE,
+        storeProvider: provider2,
+        sources: [{ id: 'sX', source: togglingSource }],
+    });
+    await reloadHost.load(); // registers {c1}
+    const beginAfterFirst = begin2;
+    const publishAfterFirst = publish2;
+    const catBeforeReload = await provider2.readCatalog();
+    // Second load resolves {c1,c2} → LOCAL change → guard throws BEFORE any build/publish.
+    await assert.rejects(() => reloadHost.load(), /served collection set changed/i);
+    assert.equal(begin2, beginAfterFirst); // NO new generation built
+    assert.equal(publish2, publishAfterFirst); // NO publish
+    // Catalog unchanged.
+    assert.deepEqual((await provider2.readCatalog()).catalogRevision, catBeforeReload.catalogRevision);
+});
+// 6 -------------------------------------------------------------------------
+test('serving reload OUT-OF-BAND change (active catalog grew) → throws; external collection NOT tombstoned', async () => {
+    const provider = makeInMemoryStoreProvider({ embed });
+    let publishCalls = 0;
+    const origPublish = provider.publishCatalog.bind(provider);
+    provider.publishCatalog = async (rev, entries, options) => {
+        publishCalls++;
+        return origPublish(rev, entries, options);
+    };
+    // Serving host registers {c1}.
+    const host = makeSkillPluginHost({
+        ...SERVE_BASE,
+        storeProvider: provider,
+        sources: [
+            {
+                id: 's1',
+                source: makeStubSource({
+                    collections: [info('c1')],
+                    records: [rec('c1:a', 's1', 'c1', 'alpha')],
+                }),
+            },
+        ],
+    });
+    await host.load(); // registers {c1}
+    const publishAfterFirst = publishCalls;
+    // OUT-OF-BAND: a separate ingest adds c2 to the active catalog.
+    const ingest = makeSkillPluginHost({
+        ...SERVE_BASE,
+        storeProvider: provider,
+        servingMode: false,
+        sources: [
+            {
+                id: 's1',
+                source: makeStubSource({
+                    collections: [info('c1')],
+                    records: [rec('c1:a', 's1', 'c1', 'alpha')],
+                }),
+            },
+            {
+                id: 's2',
+                source: makeStubSource({
+                    collections: [info('c2')],
+                    records: [rec('c2:a', 's2', 'c2', 'beta')],
+                }),
+            },
+        ],
+    });
+    await ingest.load();
+    const catWithBoth = await provider.readCatalog();
+    assert.deepEqual(catWithBoth.entries.map((e) => e.collection.group).sort(), [
+        'c1',
+        'c2',
+    ]);
+    const publishAfterIngest = publishCalls;
+    // Serving host reloads: its desired stays {c1} but active catalog is now {c1,c2} →
+    // OUT-OF-BAND mismatch → guard throws BEFORE any publish.
+    await assert.rejects(() => host.load(), /served collection set changed/i);
+    assert.equal(publishCalls, publishAfterIngest); // serving host published NOTHING
+    assert.ok(publishAfterFirst <= publishAfterIngest); // sanity
+    // c2 is NOT tombstoned — it still serves (the externally-added collection survives).
+    const cat = await provider.readCatalog();
+    const c2 = cat.entries.find((e) => e.collection.group === 'c2');
+    assert.ok(c2 && !c2.tombstone);
+    const c2hits = await ingest.rag('c2').query('beta', { k: 5, threshold: 0 });
+    assert.ok(c2hits.some((h) => h.record.id === 'c2:a'));
+});
+// 7 -------------------------------------------------------------------------
+test('groups()/rag(): one group → rag() defaults; several → rag() throws; inactive group serves []', async () => {
+    // One group: rag() with no arg resolves it.
+    {
+        const provider = await seedProvider('g1', [
+            rec('g1:a', 'seed', 'g1', 'alpha'),
+        ]);
+        const host = makeSkillPluginHost({
+            ...SERVE_BASE,
+            backendProvider: provider.asBackendProvider(),
+            serveCollections: ['g1'],
+        });
+        await host.load();
+        const hits = await host.rag().query('alpha', { k: 5, threshold: 0 });
+        assert.ok(hits.some((h) => h.record.id === 'g1:a'));
+        // An inactive/unknown group serves [] (does NOT throw).
+        const none = await host.rag('nonexistent').query('alpha', {
+            k: 5,
+            threshold: 0,
+        });
+        assert.equal(none.length, 0);
+    }
+    // Several groups: rag() with no arg throws.
+    {
+        const provider = makeInMemoryStoreProvider({ embed });
+        // seed two collections.
+        await provider._seed('g1#g0', [
+            { record: rec('g1:a', 'seed', 'g1', 'alpha'), vector: hash3('alpha') },
+        ]);
+        await provider._seed('g2#g0', [
+            { record: rec('g2:a', 'seed', 'g2', 'beta'), vector: hash3('beta') },
+        ]);
+        const manifest = {
+            embeddingSpaceId: 'sp',
+            dimension: 3,
+            retrievalSchemaVersion: 1,
+        };
+        await provider.publishCatalog('c0', [
+            {
+                collection: info('g1'),
+                sources: ['seed'],
+                generation: 'g1#g0',
+                manifest,
+            },
+            {
+                collection: info('g2'),
+                sources: ['seed'],
+                generation: 'g2#g0',
+                manifest,
+            },
+        ]);
+        const host = makeSkillPluginHost({
+            ...SERVE_BASE,
+            backendProvider: provider.asBackendProvider(),
+            serveCollections: ['g1', 'g2'],
+        });
+        await host.load();
+        assert.throws(() => host.rag(), /name the group/);
+    }
+});
+//# sourceMappingURL=skill-plugin-host.recall-and-reload.test.js.map

package/dist/skills/plugin-host/skill-plugin-host.recall-and-reload.test.js.map

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

package/dist/skills/plugin-host/skills-rag-source.d.ts

@@ -0,0 +1,17 @@
+import type { IRag, ISkillsRagHandle } from '@mcp-abap-adt/llm-agent';
+export interface SkillsRagSourceConfig {
+    group: string;
+    k: number;
+    threshold?: number;
+}
+/**
+ * Read-only {@link IRag} adapter over an {@link ISkillsRagHandle}, letting the
+ * SmartAgent context-assembler consume the skills handle as just another RAG
+ * source.
+ *
+ * Skills live in their own embedding space, so this adapter RE-EMBEDS the
+ * query via the handle (`IQueryEmbedding.text`) and never reuses the
+ * assembler's vector (`IQueryEmbedding.toVector()`).
+ */
+export declare function skillsRagSource(handle: ISkillsRagHandle, cfg: SkillsRagSourceConfig): IRag;
+//# sourceMappingURL=skills-rag-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-rag-source.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/skills-rag-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,IAAI,EACJ,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,qBAAqB,GACzB,IAAI,CAiDN"}

package/dist/skills/plugin-host/skills-rag-source.js

@@ -0,0 +1,52 @@
+import { RagError } from '@mcp-abap-adt/llm-agent'; // value (class)
+/**
+ * Read-only {@link IRag} adapter over an {@link ISkillsRagHandle}, letting the
+ * SmartAgent context-assembler consume the skills handle as just another RAG
+ * source.
+ *
+ * Skills live in their own embedding space, so this adapter RE-EMBEDS the
+ * query via the handle (`IQueryEmbedding.text`) and never reuses the
+ * assembler's vector (`IQueryEmbedding.toVector()`).
+ */
+export function skillsRagSource(handle, cfg) {
+    return {
+        async query(embedding, k, options) {
+            try {
+                const hits = await handle.query(embedding.text, { k: k ?? cfg.k, threshold: cfg.threshold }, options);
+                const value = hits.map((h) => ({
+                    text: h.record.content,
+                    score: h.score,
+                    metadata: {
+                        id: h.record.id,
+                        group: cfg.group,
+                        name: h.record.name,
+                        provenance: h.record.provenance,
+                    },
+                }));
+                return { ok: true, value };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    error: new RagError(`skills source error: ${String(e)}`),
+                };
+            }
+        },
+        async healthCheck(options) {
+            try {
+                await handle.activeManifest(options);
+                return { ok: true, value: undefined };
+            }
+            catch (e) {
+                return { ok: false, error: new RagError(String(e)) };
+            }
+        },
+        async getById() {
+            return { ok: true, value: null };
+        },
+        writer() {
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=skills-rag-source.js.map

package/dist/skills/plugin-host/skills-rag-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-rag-source.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/skills-rag-source.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC,CAAC,gBAAgB;AAQpE;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAwB,EACxB,GAA0B;IAE1B,OAAO;QACL,KAAK,CAAC,KAAK,CACT,SAA0B,EAC1B,CAAS,EACT,OAAqB;YAErB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAC7B,SAAS,CAAC,IAAI,EACd,EAAE,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAC3C,OAAO,CACR,CAAC;gBACF,MAAM,KAAK,GAAgB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;oBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE;wBACR,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;wBACf,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;wBACnB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU;qBAChC;iBACF,CAAC,CAAC,CAAC;gBACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,wBAAwB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAqB;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;gBACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACxC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO;YACX,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;QAED,MAAM;YACJ,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,69 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { skillsRagSource } from './skills-rag-source.js';
+test('query uses IQueryEmbedding.text (NOT toVector) and maps SkillHit→RagResult', async () => {
+    let usedToVector = false;
+    const handle = {
+        async query(text) {
+            assert.equal(text, 'goal-text');
+            return [
+                {
+                    record: {
+                        id: 'i',
+                        name: 'n',
+                        content: 'BODY',
+                        provenance: 'pv',
+                        group: 'g',
+                    },
+                    score: 0.91,
+                },
+            ];
+        },
+        async activeManifest() {
+            return {
+                revision: 'g0',
+                manifest: {
+                    embeddingSpaceId: 'sp',
+                    dimension: 3,
+                    retrievalSchemaVersion: 1,
+                },
+            };
+        },
+    };
+    const src = skillsRagSource(handle, {
+        group: 'g',
+        k: 4,
+        threshold: 0.3,
+    });
+    const embedding = {
+        text: 'goal-text',
+        async toVector() {
+            usedToVector = true;
+            return [0, 0, 0];
+        },
+    };
+    const res = await src.query(embedding, 4);
+    assert.equal(res.ok, true);
+    const value = res.value;
+    assert.equal(value[0].text, 'BODY');
+    assert.equal(value[0].score, 0.91);
+    assert.equal(value[0].metadata.id, 'i');
+    assert.equal(usedToVector, false); // re-embeds via the skills handle, not the assembler vector
+});
+test('healthCheck ok when activeManifest resolves; writer undefined; getById ok(null)', async () => {
+    const handle = {
+        async query() {
+            return [];
+        },
+        async activeManifest() {
+            return { revision: 'g', manifest: {} };
+        },
+    };
+    const src = skillsRagSource(handle, { group: 'g', k: 4 });
+    assert.equal((await src.healthCheck()).ok, true);
+    assert.equal(src.writer?.(), undefined);
+    const byId = await src.getById('x');
+    assert.equal(byId.ok, true);
+    assert.equal(byId.value, null);
+});
+//# sourceMappingURL=skills-rag-source.test.js.map

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

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

package/dist/skills/plugin-host/source-strategies.d.ts

@@ -0,0 +1,20 @@
+import type { ISkillSource } from '@mcp-abap-adt/llm-agent';
+import { type IMarketplaceTransport } from './http-marketplace-source.js';
+/** A fetched source's config, resolved from YAML/CLI. A {@link SkillSourceStrategy}
+ *  turns it into a concrete {@link ISkillSource} with strategy-specific placement. */
+export type FetchedSourceConfig = {
+    source: string;
+    enabled: readonly string[];
+    transport: IMarketplaceTransport;
+    chunk: {
+        maxChars: number;
+    };
+    strategyConfig?: Record<string, unknown>;
+};
+/** Maps a {@link FetchedSourceConfig} to an {@link ISkillSource} (placement decided here). */
+export type SkillSourceStrategy = (cfg: FetchedSourceConfig) => ISkillSource;
+/** Register (or override) a named source strategy. */
+export declare function registerSkillSourceStrategy(name: string, f: SkillSourceStrategy): void;
+/** Resolve a registered strategy by name; throws (listing registered names) if unknown. */
+export declare function resolveSkillSourceStrategy(name: string): SkillSourceStrategy;
+//# sourceMappingURL=source-strategies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-strategies.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/source-strategies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,8BAA8B,CAAC;AAEtC;sFACsF;AACtF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C,CAAC;AAEF,8FAA8F;AAC9F,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,YAAY,CAAC;AAI7E,sDAAsD;AACtD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,mBAAmB,GACrB,IAAI,CAEN;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAS5E"}

package/dist/skills/plugin-host/source-strategies.js

@@ -0,0 +1,37 @@
+import { makeHttpMarketplaceSource, } from './http-marketplace-source.js';
+const registry = new Map();
+/** Register (or override) a named source strategy. */
+export function registerSkillSourceStrategy(name, f) {
+    registry.set(name, f);
+}
+/** Resolve a registered strategy by name; throws (listing registered names) if unknown. */
+export function resolveSkillSourceStrategy(name) {
+    const f = registry.get(name);
+    if (!f) {
+        const known = [...registry.keys()].sort().join(', ');
+        throw new Error(`unknown skill source strategy '${name}'; registered: ${known}`);
+    }
+    return f;
+}
+// --- Built-in strategies (registered at module load) -----------------------
+/** Default: one collection per plugin, named/described by the plugin id. */
+registerSkillSourceStrategy('one-group-per-plugin', (cfg) => makeHttpMarketplaceSource({
+    source: cfg.source,
+    enabled: cfg.enabled,
+    transport: cfg.transport,
+    chunk: cfg.chunk,
+    placement: (plugin) => ({ group: plugin, description: plugin }),
+}));
+/** Bundle every enabled plugin into ONE collection named by
+ *  `strategyConfig.collection` (default `'skills'`). */
+registerSkillSourceStrategy('single-collection', (cfg) => {
+    const collection = String(cfg.strategyConfig?.collection ?? 'skills');
+    return makeHttpMarketplaceSource({
+        source: cfg.source,
+        enabled: cfg.enabled,
+        transport: cfg.transport,
+        chunk: cfg.chunk,
+        placement: () => ({ group: collection, description: collection }),
+    });
+});
+//# sourceMappingURL=source-strategies.js.map

package/dist/skills/plugin-host/source-strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-strategies.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/source-strategies.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAetC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExD,sDAAsD;AACtD,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,CAAsB;IAEtB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,kBAAkB,KAAK,EAAE,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAE9E,4EAA4E;AAC5E,2BAA2B,CAAC,sBAAsB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC1D,yBAAyB,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM;IAClB,OAAO,EAAE,GAAG,CAAC,OAAO;IACpB,SAAS,EAAE,GAAG,CAAC,SAAS;IACxB,KAAK,EAAE,GAAG,CAAC,KAAK;IAChB,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;CAChE,CAAC,CACH,CAAC;AAEF;wDACwD;AACxD,2BAA2B,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,UAAU,IAAI,QAAQ,CAAC,CAAC;IACtE,OAAO,yBAAyB,CAAC;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/skills/plugin-host/source-strategies.test.js

@@ -0,0 +1,52 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { resolveSkillSourceStrategy, } from './source-strategies.js';
+const SKILL_MD = `---\nname: s\ndescription: d\n---\n## H\nbody`;
+const transport = {
+    async listPlugins() {
+        return [
+            { plugin: 'a', version: '1', skills: ['s'] },
+            { plugin: 'b', version: '1', skills: ['s'] },
+        ];
+    },
+    async fetchSkillMd() {
+        return SKILL_MD;
+    },
+};
+const cfg = {
+    source: 'v',
+    enabled: ['*'],
+    transport,
+    chunk: { maxChars: 1000 },
+};
+test('one-group-per-plugin groups per plugin (≥2 plugins → ≥2 collections)', async () => {
+    const src = resolveSkillSourceStrategy('one-group-per-plugin')(cfg);
+    const res = await src.acquire();
+    assert.ok(res.collections.length >= 2);
+    assert.deepEqual(res.collections.map((c) => c.group).sort(), ['a', 'b']);
+});
+test('single-collection bundles all plugins into one named collection', async () => {
+    const src = resolveSkillSourceStrategy('single-collection')({
+        ...cfg,
+        strategyConfig: { collection: 'bundle' },
+    });
+    const res = await src.acquire();
+    assert.equal(res.collections.length, 1);
+    assert.equal(res.collections[0].group, 'bundle');
+});
+test('single-collection defaults to "skills" when unconfigured', async () => {
+    const src = resolveSkillSourceStrategy('single-collection')(cfg);
+    const res = await src.acquire();
+    assert.equal(res.collections.length, 1);
+    assert.equal(res.collections[0].group, 'skills');
+});
+test('resolveSkillSourceStrategy throws on unknown, listing registered names', () => {
+    assert.throws(() => resolveSkillSourceStrategy('nope'), (e) => {
+        const msg = String(e);
+        assert.match(msg, /nope/);
+        assert.match(msg, /one-group-per-plugin/);
+        assert.match(msg, /single-collection/);
+        return true;
+    });
+});
+//# sourceMappingURL=source-strategies.test.js.map

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

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