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

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

@@ -0,0 +1,100 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { CatalogCasError } from '@mcp-abap-adt/llm-agent';
+import { makeInMemoryStoreProvider } from './in-memory-store.js';
+const MANIFEST = {
+    embeddingSpaceId: 'sp',
+    dimension: 3,
+    retrievalSchemaVersion: 1,
+};
+const rec = (id, group, vec) => ({
+    record: {
+        id,
+        sourceId: 's',
+        group,
+        name: id,
+        retrievalText: id,
+        content: `c-${id}`,
+        provenance: id,
+    },
+    vector: vec,
+});
+test('build inactive → publishCatalog activates → query + activeSnapshot from catalog', async () => {
+    const p = makeInMemoryStoreProvider();
+    const store = p.forGroup('g1');
+    const { generation } = await store.beginGeneration();
+    // upsert is embedding-agnostic here: the in-memory store accepts pre-vectorised rows via a test seam
+    await p._seed(generation, [
+        rec('a', 'g1', [1, 0, 0]),
+        rec('b', 'g1', [0, 1, 0]),
+    ]);
+    // nothing serves yet
+    assert.equal(await store.activeSnapshot(), null);
+    const before = await p.readCatalog();
+    await p.publishCatalog(before.catalogRevision, [
+        {
+            collection: { group: 'g1', description: 'd', collection: 'g1' },
+            sources: ['s'],
+            generation,
+            manifest: MANIFEST,
+        },
+    ]);
+    const snap = await store.activeSnapshot();
+    assert.equal(snap?.revision, generation);
+    assert.deepEqual(snap?.manifest, MANIFEST);
+    const hits = await store.queryRevision(generation, [1, 0, 0], 1);
+    assert.equal(hits[0].record.id, 'a');
+});
+test('publishCatalog CAS rejects a stale expectedRevision with CatalogCasError', async () => {
+    const p = makeInMemoryStoreProvider();
+    const r0 = (await p.readCatalog()).catalogRevision;
+    await p.publishCatalog(r0, []); // bumps to r1
+    await assert.rejects(() => p.publishCatalog(r0, []), (e) => e instanceof CatalogCasError);
+});
+test('EXACT retention via lease: a generation pinned by activeSnapshot survives a concurrent reclaim until release', async () => {
+    const p = makeInMemoryStoreProvider();
+    const backend = p.forGroup('g1');
+    const g = await backend.beginGeneration();
+    await p._seed(g.generation, [rec('a', 'g1', [1, 0, 0])]);
+    await p.publishCatalog((await p.readCatalog()).catalogRevision, [
+        {
+            collection: { group: 'g1', description: 'd', collection: 'g1' },
+            sources: ['s'],
+            generation: g.generation,
+            manifest: MANIFEST,
+        },
+    ]);
+    // a reader resolves (PINS) the generation...
+    const snap = await backend.activeSnapshot();
+    // ...then the catalog rotates it out AND a reclaim is attempted (simulating a concurrent load)
+    await p.publishCatalog((await p.readCatalog()).catalogRevision, []); // retire g1
+    await p.forGroup('g1').discardGeneration(snap.revision); // reclaim attempt — DEFERRED (leased)
+    // the in-flight reader's query STILL succeeds (no read-under-delete):
+    assert.equal((await backend.queryRevision(snap.revision, [1, 0, 0], 1)).length, 1);
+    // release the lease → the deferred reclaim now runs
+    backend.release(snap.revision);
+    await assert.rejects(() => backend.queryRevision(snap.revision, [1, 0, 0], 1), /unknown generation/i);
+});
+test('an ACTIVE generation is retained; dropCollection only reclaims a NON-active one', async () => {
+    const p = makeInMemoryStoreProvider();
+    const g = await p.forGroup('g1').beginGeneration();
+    await p._seed(g.generation, [rec('a', 'g1', [1, 0, 0])]);
+    const r0 = (await p.readCatalog()).catalogRevision;
+    await p.publishCatalog(r0, [
+        {
+            collection: { group: 'g1', description: 'd', collection: 'g1' },
+            sources: ['s'],
+            generation: g.generation,
+            manifest: MANIFEST,
+        },
+    ]);
+    // dropCollection on an ACTIVE collection must NOT delete its served generation
+    await p.dropCollection('g1');
+    assert.equal((await p.forGroup('g1').queryRevision(g.generation, [1, 0, 0], 1)).length, 1);
+    // now retire g1 from the catalog (publish WITHOUT it) → the generation becomes non-active
+    const r1 = (await p.readCatalog()).catalogRevision;
+    await p.publishCatalog(r1, []);
+    await p.dropCollection('g1'); // reclaims the now-non-active generation
+    await assert.rejects(() => p.forGroup('g1').queryRevision(g.generation, [1, 0, 0], 1), /unknown generation|not found/i);
+});
+//# sourceMappingURL=in-memory-store.test.js.map

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

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

package/dist/skills/plugin-host/index.d.ts

@@ -0,0 +1,10 @@
+export { chunkSkill, type SkillIdentity } from './chunker.js';
+export { type CompatibleSkillsRagDeps, makeCompatibleSkillsRag, } from './compatible-skills-rag.js';
+export { type HttpMarketplaceSourceOptions, type HttpTransportOptions, type IMarketplaceTransport, makeHttpMarketplaceSource, makeHttpTransport, } from './http-marketplace-source.js';
+export { type IInMemoryStoreProvider, makeInMemoryStoreProvider, } from './in-memory-store.js';
+export { buildIngestResult, type MarketplaceInput, } from './marketplace-adapter.js';
+export { type ICatalogReader, type ICatalogStore, type IPgPool, type IQdrantClient, type IQdrantReader, makeInProcessCatalogStore, makePgCatalogReader, makePgCatalogStore, makeQdrantBackendProvider, makeQdrantClient, makeQdrantReader, makeQdrantStoreProvider, pointId, type QdrantPoint, type QdrantStoreProviderDeps, } from './qdrant-store.js';
+export { type IngestHostDeps, makeSkillPluginHost, type RecallHostDeps, type SkillPluginHostDeps, } from './skill-plugin-host.js';
+export { type SkillsRagSourceConfig, skillsRagSource, } from './skills-rag-source.js';
+export { type FetchedSourceConfig, registerSkillSourceStrategy, resolveSkillSourceStrategy, type SkillSourceStrategy, } from './source-strategies.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/plugin-host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,KAAK,uBAAuB,EAC5B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,sBAAsB,EAC3B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,qBAAqB,EAC1B,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,mBAAmB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC"}

package/dist/skills/plugin-host/index.js

@@ -0,0 +1,12 @@
+// Skill plugin-host barrel — chunker, marketplace adapter, store, compat wrapper,
+// host, RAG source, HTTP marketplace source, and the source-strategy registry.
+export { chunkSkill } from './chunker.js';
+export { makeCompatibleSkillsRag, } from './compatible-skills-rag.js';
+export { makeHttpMarketplaceSource, makeHttpTransport, } from './http-marketplace-source.js';
+export { makeInMemoryStoreProvider, } from './in-memory-store.js';
+export { buildIngestResult, } from './marketplace-adapter.js';
+export { makeInProcessCatalogStore, makePgCatalogReader, makePgCatalogStore, makeQdrantBackendProvider, makeQdrantClient, makeQdrantReader, makeQdrantStoreProvider, pointId, } from './qdrant-store.js';
+export { makeSkillPluginHost, } from './skill-plugin-host.js';
+export { skillsRagSource, } from './skills-rag-source.js';
+export { registerSkillSourceStrategy, resolveSkillSourceStrategy, } from './source-strategies.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/plugin-host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAEL,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAIL,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAML,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,OAAO,GAGR,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,2BAA2B,EAC3B,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC"}

package/dist/skills/plugin-host/marketplace-adapter.d.ts

@@ -0,0 +1,23 @@
+import type { SkillIngestResult } from '@mcp-abap-adt/llm-agent';
+export interface MarketplaceInput {
+    source: string;
+    plugins: ReadonlyArray<{
+        plugin: string;
+        version: string;
+        skills: ReadonlyArray<{
+            skill: string;
+            skillMd: string;
+        }>;
+    }>;
+    chunk: {
+        maxChars: number;
+    };
+    /** Strategy placement: plugin → its group + description. */
+    placement: (plugin: string) => {
+        group: string;
+        description: string;
+    };
+}
+/** Pure, FS-free: parse SKILL.md strings, chunk, and place records into collections. */
+export declare function buildIngestResult(input: MarketplaceInput): SkillIngestResult;
+//# sourceMappingURL=marketplace-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-adapter.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/marketplace-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,4DAA4D;IAC5D,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAkC5E"}

package/dist/skills/plugin-host/marketplace-adapter.js

@@ -0,0 +1,32 @@
+import { parseFrontmatter } from '../../utils/parse-frontmatter.js';
+import { chunkSkill } from './chunker.js';
+/** Pure, FS-free: parse SKILL.md strings, chunk, and place records into collections. */
+export function buildIngestResult(input) {
+    const records = [];
+    const collections = new Map();
+    for (const p of input.plugins) {
+        const place = input.placement(p.plugin);
+        if (!collections.has(place.group)) {
+            collections.set(place.group, {
+                group: place.group,
+                description: place.description,
+                collection: place.group,
+            });
+        }
+        for (const s of p.skills) {
+            const { meta, body } = parseFrontmatter(s.skillMd);
+            const description = String(meta.description ?? '');
+            records.push(...chunkSkill({
+                source: input.source,
+                plugin: p.plugin,
+                version: p.version,
+                skill: s.skill,
+                group: place.group,
+                description,
+                body,
+            }, input.chunk));
+        }
+    }
+    return { collections: [...collections.values()], records };
+}
+//# sourceMappingURL=marketplace-adapter.js.map

package/dist/skills/plugin-host/marketplace-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-adapter.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/marketplace-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;gBAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU,EAAE,KAAK,CAAC,KAAK;aACxB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CACrC,CAAC,CAAC,OAAO,CACV,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CACV,GAAG,UAAU,CACX;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW;gBACX,IAAI;aACL,EACD,KAAK,CAAC,KAAK,CACZ,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC"}

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

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

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

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

package/dist/skills/plugin-host/marketplace-adapter.test.js

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { buildIngestResult } from './marketplace-adapter.js';
+const SKILL_MD = `---\nname: do-thing\ndescription: How to do the thing\n---\n# Do Thing\n## Step\nrun it`;
+test('manifest + SKILL.md → records placed one-group-per-plugin + catalog', () => {
+    const res = buildIngestResult({
+        source: 'vendor',
+        plugins: [
+            {
+                plugin: 'p1',
+                version: '1',
+                skills: [{ skill: 'do-thing', skillMd: SKILL_MD }],
+            },
+        ],
+        chunk: { maxChars: 1000 },
+        placement: (plugin) => ({ group: plugin, description: `plugin ${plugin}` }),
+    });
+    assert.deepEqual(res.collections.map((c) => c.group), ['p1']);
+    assert.equal(res.collections[0].description, 'plugin p1');
+    assert.ok(res.records.length >= 1);
+    assert.ok(res.records.every((r) => r.group === 'p1'));
+    const groups = new Set(res.collections.map((c) => c.group));
+    assert.ok(res.records.every((r) => groups.has(r.group)));
+});
+test('a strategy may bundle plugins into one group', () => {
+    const res = buildIngestResult({
+        source: 'vendor',
+        plugins: [
+            {
+                plugin: 'a',
+                version: '1',
+                skills: [{ skill: 's', skillMd: SKILL_MD }],
+            },
+            {
+                plugin: 'b',
+                version: '1',
+                skills: [{ skill: 's', skillMd: SKILL_MD }],
+            },
+        ],
+        chunk: { maxChars: 1000 },
+        placement: () => ({ group: 'bundle', description: 'bundle' }),
+    });
+    assert.deepEqual(res.collections.map((c) => c.group), ['bundle']);
+    assert.ok(res.records.every((r) => r.group === 'bundle'));
+});
+//# sourceMappingURL=marketplace-adapter.test.js.map

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

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

package/dist/skills/plugin-host/qdrant-store.d.ts

@@ -0,0 +1,85 @@
+import type { CallOptions, CatalogEntry, CatalogSnapshot, ISkillsRagBackendProvider, ISkillsStoreProvider } from '@mcp-abap-adt/llm-agent';
+export interface QdrantPoint {
+    id: string;
+    vector: number[];
+    payload: Record<string, unknown>;
+}
+export interface IQdrantReader {
+    search(filter: object, vector: number[], k: number, options?: {
+        signal?: AbortSignal;
+    }): Promise<Array<{
+        payload: Record<string, unknown>;
+        score: number;
+    }>>;
+    scroll(filter: object, cursor?: string): Promise<{
+        points: QdrantPoint[];
+        next?: string;
+    }>;
+}
+export interface IQdrantClient extends IQdrantReader {
+    /**
+     * Upsert points. `opts.wait` (default false) maps to Qdrant `?wait=true`:
+     * the request returns only after the operation is APPLIED and the points are
+     * searchable. The general default omits it (throughput); the catalog-activation
+     * ingest path passes `wait: true` so a generation is never published active
+     * before its points are visible to recall (read-after-write at the activation
+     * boundary).
+     */
+    upsertPoints(points: QdrantPoint[], opts?: {
+        wait?: boolean;
+    }): Promise<void>;
+    deleteByFilter(filter: object): Promise<void>;
+}
+export interface ICatalogReader {
+    read(): Promise<CatalogSnapshot>;
+}
+export interface ICatalogStore extends ICatalogReader {
+    casPublish(expectedCatalogRevision: string, entries: readonly CatalogEntry[], now: number): Promise<CatalogSnapshot>;
+    pruneRetired(expectedCatalogRevision: string, generations: readonly string[]): Promise<CatalogSnapshot>;
+}
+type Embed = (text: string, options?: CallOptions) => Promise<number[]>;
+type PointId = (generation: string, recordId: string) => string;
+export declare const pointId: PointId;
+export declare function makeInProcessCatalogStore(): ICatalogStore;
+export interface IPgPool {
+    query(sql: string, params?: unknown[]): Promise<{
+        rows: unknown[];
+        rowCount: number;
+    }>;
+}
+export declare function makePgCatalogStore(deps: {
+    pool: IPgPool;
+    table?: string;
+}): ICatalogStore;
+export declare function makePgCatalogReader(deps: {
+    pool: IPgPool;
+    table?: string;
+}): ICatalogReader;
+interface QdrantRestOptions {
+    url: string;
+    apiKey?: string;
+    collection: string;
+}
+/** Read-only Qdrant reader (search + scroll). Used by recall-only with a read key. */
+export declare function makeQdrantReader(opts: QdrantRestOptions): IQdrantReader;
+/** Read/write Qdrant client (reader + upsert + delete). Used by the ingest path. */
+export declare function makeQdrantClient(opts: QdrantRestOptions): IQdrantClient;
+/** Read-only backend provider over reader interfaces (no write/reconcile API). */
+export declare function makeQdrantBackendProvider(deps: {
+    reader: IQdrantReader;
+    catalogReader: ICatalogReader;
+    collection: string;
+}): ISkillsRagBackendProvider;
+export interface QdrantStoreProviderDeps {
+    client: IQdrantClient;
+    collection: string;
+    catalogStore: ICatalogStore;
+    embed: Embed;
+    pointId?: PointId;
+    now?: () => number;
+    retiredGraceMs: number;
+    orphanGraceMs: number;
+}
+export declare function makeQdrantStoreProvider(deps: QdrantStoreProviderDeps): ISkillsStoreProvider;
+export {};
+//# sourceMappingURL=qdrant-store.d.ts.map

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

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