@cyanheads/cyanheads-mcp-server 0.1.1

package/dist/services/catalog/catalog-service.js

@@ -0,0 +1,233 @@
+/**
+ * @fileoverview CatalogService — fleet catalog with semantic search.
+ * Loads fleet.json (v2 with baked embeddings) at startup, packs vectors into a
+ * Float32Array for cache locality, and serves cosine-similarity search by
+ * embedding the query at runtime and dot-producting against the in-memory index.
+ * Polls the remote payload on a configurable interval; atomic swap on change.
+ * @module services/catalog/catalog-service
+ */
+import { JsonRpcErrorCode, McpError, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { logger } from '@cyanheads/mcp-ts-core/utils';
+import { TransformersEmbeddingsRuntime } from './embeddings-runtime.js';
+import { RemoteJsonCatalogProvider } from './remote-catalog-provider.js';
+// ---------------------------------------------------------------------------
+// CatalogService
+// ---------------------------------------------------------------------------
+export class CatalogService {
+    _index = null;
+    _provider;
+    _embeddings;
+    _config;
+    _refreshTimer = null;
+    constructor(config, embeddings) {
+        this._config = config;
+        this._provider = new RemoteJsonCatalogProvider(config);
+        this._embeddings = embeddings ?? new TransformersEmbeddingsRuntime(config.embeddingModelId);
+    }
+    async initialize() {
+        logger.info(`Loading fleet catalog from ${this._config.catalogUrl}`);
+        const payload = await this._provider.load();
+        this._assertModelMatch(payload);
+        this._index = this._buildIndex(payload);
+        await this._embeddings.initialize();
+        logger.info(`Fleet catalog loaded: ${payload.servers.length} servers, ${this._index.toolByName.size} tools ` +
+            `(model=${payload.embeddingModel}, dims=${payload.embeddingDims}, generatedAt=${payload.generatedAt})`);
+        if (this._config.catalogRefreshSeconds > 0) {
+            this._refreshTimer = setInterval(() => {
+                void this._maybeRefresh();
+            }, this._config.catalogRefreshSeconds * 1000);
+        }
+    }
+    async search(params) {
+        const index = this._assertInitialized();
+        const queryVec = await this._embeddings.embedQuery(params.query, index.dims, index.payload.embeddingQueryPrefix);
+        const floor = this._config.similarityFloor;
+        const results = [];
+        if (params.scope === 'servers') {
+            for (const [i, server] of index.payload.servers.entries()) {
+                if (params.category && server.category !== params.category)
+                    continue;
+                const score = dotRow(queryVec, index.serverVectors, i, index.dims);
+                if (score < floor)
+                    continue;
+                results.push({
+                    name: server.name,
+                    server: server.name,
+                    brief: server.description,
+                    category: server.category,
+                    score,
+                });
+            }
+        }
+        else {
+            let toolI = 0;
+            for (const server of index.payload.servers) {
+                for (const tool of server.tools) {
+                    if (params.category && server.category !== params.category) {
+                        toolI++;
+                        continue;
+                    }
+                    const score = dotRow(queryVec, index.toolVectors, toolI, index.dims);
+                    toolI++;
+                    if (score < floor)
+                        continue;
+                    results.push({
+                        name: tool.name,
+                        server: server.name,
+                        brief: tool.description,
+                        category: server.category,
+                        score,
+                    });
+                }
+            }
+        }
+        results.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+        return params.limit != null ? results.slice(0, params.limit) : results;
+    }
+    getTool(name) {
+        const index = this._assertInitialized();
+        return index.toolByName.get(name) ?? null;
+    }
+    getServer(name) {
+        const index = this._assertInitialized();
+        return index.serverByName.get(name) ?? null;
+    }
+    listCategories() {
+        const index = this._assertInitialized();
+        const cats = new Set();
+        for (const server of index.payload.servers)
+            cats.add(server.category);
+        return Array.from(cats).sort();
+    }
+    stats() {
+        const index = this._assertInitialized();
+        return {
+            toolCount: index.toolByName.size,
+            serverCount: index.payload.servers.length,
+            initializedAt: index.initializedAt,
+            embeddingModel: index.payload.embeddingModel,
+        };
+    }
+    /** Stop the background refresh timer (test-only / shutdown). */
+    shutdown() {
+        if (this._refreshTimer) {
+            clearInterval(this._refreshTimer);
+            this._refreshTimer = null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    _assertModelMatch(payload) {
+        if (payload.embeddingModel !== this._config.embeddingModelId) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Catalog embedding model mismatch: payload declares "${payload.embeddingModel}" but server expects "${this._config.embeddingModelId}". ` +
+                'Update EMBEDDING_MODEL_ID or regenerate the catalog with the matching model.', {
+                payloadModel: payload.embeddingModel,
+                expected: this._config.embeddingModelId,
+            });
+        }
+    }
+    _buildIndex(payload) {
+        const dims = payload.embeddingDims;
+        const serverCount = payload.servers.length;
+        let toolCount = 0;
+        for (const s of payload.servers)
+            toolCount += s.tools.length;
+        const serverVectors = new Float32Array(serverCount * dims);
+        const toolVectors = new Float32Array(toolCount * dims);
+        const toolByName = new Map();
+        const serverByName = new Map();
+        const toolNamesInOrder = [];
+        let toolI = 0;
+        for (const [si, server] of payload.servers.entries()) {
+            if (server.name.includes('_')) {
+                throw new McpError(JsonRpcErrorCode.InternalError, `Server name "${server.name}" contains underscores. Fleet naming convention requires hyphenated server names.`);
+            }
+            if (server.embedding.length !== dims) {
+                throw new McpError(JsonRpcErrorCode.InternalError, `Server "${server.name}" embedding has ${server.embedding.length} dims; expected ${dims}.`);
+            }
+            serverVectors.set(server.embedding, si * dims);
+            serverByName.set(server.name, server);
+            for (const tool of server.tools) {
+                if (tool.embedding.length !== dims) {
+                    throw new McpError(JsonRpcErrorCode.InternalError, `Tool "${tool.name}" embedding has ${tool.embedding.length} dims; expected ${dims}.`);
+                }
+                toolVectors.set(tool.embedding, toolI * dims);
+                toolByName.set(tool.name, { ...tool, serverRecord: server });
+                toolNamesInOrder.push(tool.name);
+                toolI++;
+            }
+        }
+        return {
+            payload,
+            serverVectors,
+            toolVectors,
+            toolByName,
+            serverByName,
+            toolNamesInOrder,
+            dims,
+            initializedAt: new Date().toISOString(),
+        };
+    }
+    async _maybeRefresh() {
+        try {
+            const current = this._index;
+            if (!current)
+                return;
+            const payload = await this._provider.load();
+            if (payload.generatedAt === current.payload.generatedAt) {
+                logger.debug(`Catalog refresh: no change (generatedAt=${payload.generatedAt})`);
+                return;
+            }
+            if (payload.embeddingModel !== this._config.embeddingModelId) {
+                logger.warning(`Catalog refresh skipped: payload claims model "${payload.embeddingModel}" but server expects "${this._config.embeddingModelId}". Keeping last-known state.`);
+                return;
+            }
+            const next = this._buildIndex(payload);
+            this._index = next;
+            logger.info(`Catalog refreshed: ${payload.servers.length} servers, ${next.toolByName.size} tools (generatedAt=${payload.generatedAt})`);
+        }
+        catch (err) {
+            logger.warning(`Catalog refresh failed; keeping last-known state. ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    _assertInitialized() {
+        if (!this._index) {
+            throw serviceUnavailable('CatalogService not initialized — call initialize() in setup()', {
+                reason: 'catalog_empty',
+            });
+        }
+        return this._index;
+    }
+}
+// ---------------------------------------------------------------------------
+// Dot product helper
+// ---------------------------------------------------------------------------
+function dotRow(query, store, rowIdx, dims) {
+    const offset = rowIdx * dims;
+    let sum = 0;
+    for (let i = 0; i < dims; i++) {
+        // biome-ignore lint/style/noNonNullAssertion: bounds enforced by loop + Float32Array sizing
+        sum += query[i] * store[offset + i];
+    }
+    return sum;
+}
+// ---------------------------------------------------------------------------
+// Init / accessor
+// ---------------------------------------------------------------------------
+let _service;
+export function initCatalogService(config, embeddings) {
+    _service = new CatalogService(config, embeddings);
+}
+export function getCatalogService() {
+    if (!_service) {
+        throw serviceUnavailable('CatalogService not initialized — call initCatalogService() in setup()', { reason: 'catalog_empty' });
+    }
+    return _service;
+}
+/** Test-only reset. */
+export function resetCatalogServiceForTests() {
+    _service?.shutdown();
+    _service = undefined;
+}
+//# sourceMappingURL=catalog-service.js.map

package/dist/services/catalog/catalog-service.js.map

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

package/dist/services/catalog/embeddings-runtime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Embeddings runtime — wraps @huggingface/transformers's
+ * feature-extraction pipeline to embed query strings at search time.
+ * Loaded once at startup, kept warm for the lifetime of the process.
+ * Applies the asymmetric query prefix declared in the catalog payload and
+ * Matryoshka-truncates + L2-normalizes the output to match document vectors.
+ * @module services/catalog/embeddings-runtime
+ */
+export interface IEmbeddingsRuntime {
+    embedQuery(text: string, dims: number, queryPrefix: string): Promise<Float32Array>;
+    initialize(): Promise<void>;
+    readonly modelId: string;
+}
+export declare class TransformersEmbeddingsRuntime implements IEmbeddingsRuntime {
+    readonly modelId: string;
+    private _extractor;
+    constructor(modelId: string);
+    initialize(): Promise<void>;
+    embedQuery(text: string, dims: number, queryPrefix: string): Promise<Float32Array>;
+}
+//# sourceMappingURL=embeddings-runtime.d.ts.map

package/dist/services/catalog/embeddings-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings-runtime.d.ts","sourceRoot":"","sources":["../../../src/services/catalog/embeddings-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,6BAA8B,YAAW,kBAAkB;aAG1C,OAAO,EAAE,MAAM;IAF3C,OAAO,CAAC,UAAU,CAA0C;gBAEhC,OAAO,EAAE,MAAM;IAErC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAmCzF"}

package/dist/services/catalog/embeddings-runtime.js

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Embeddings runtime — wraps @huggingface/transformers's
+ * feature-extraction pipeline to embed query strings at search time.
+ * Loaded once at startup, kept warm for the lifetime of the process.
+ * Applies the asymmetric query prefix declared in the catalog payload and
+ * Matryoshka-truncates + L2-normalizes the output to match document vectors.
+ * @module services/catalog/embeddings-runtime
+ */
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { logger } from '@cyanheads/mcp-ts-core/utils';
+import { pipeline } from '@huggingface/transformers';
+export class TransformersEmbeddingsRuntime {
+    modelId;
+    _extractor = null;
+    constructor(modelId) {
+        this.modelId = modelId;
+    }
+    async initialize() {
+        if (this._extractor)
+            return;
+        logger.info(`Loading embedding model: ${this.modelId}`);
+        const startMs = Date.now();
+        try {
+            this._extractor = (await pipeline('feature-extraction', this.modelId));
+        }
+        catch (err) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Failed to load embedding model ${this.modelId}: ${err instanceof Error ? err.message : String(err)}`, { modelId: this.modelId }, { cause: err });
+        }
+        logger.info(`Embedding model loaded in ${((Date.now() - startMs) / 1000).toFixed(1)}s`);
+    }
+    async embedQuery(text, dims, queryPrefix) {
+        if (!this._extractor) {
+            throw new McpError(JsonRpcErrorCode.InternalError, 'Embeddings runtime not initialized — call initialize() first.');
+        }
+        const input = `${queryPrefix}${text}`;
+        const tensor = await this._extractor([input], {
+            pooling: 'cls',
+            normalize: false,
+        });
+        const rows = tensor.tolist();
+        const fullVec = rows[0];
+        if (!fullVec || fullVec.length < dims) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Embedding pipeline returned a vector of length ${fullVec?.length ?? 0}; expected at least ${dims}.`);
+        }
+        const out = new Float32Array(dims);
+        let sumSq = 0;
+        for (let i = 0; i < dims; i++) {
+            // biome-ignore lint/style/noNonNullAssertion: length checked above
+            const v = fullVec[i];
+            out[i] = v;
+            sumSq += v * v;
+        }
+        if (sumSq === 0)
+            return out;
+        const norm = Math.sqrt(sumSq);
+        // biome-ignore lint/style/noNonNullAssertion: Float32Array allocated with exact dims
+        for (let i = 0; i < dims; i++)
+            out[i] = out[i] / norm;
+        return out;
+    }
+}
+//# sourceMappingURL=embeddings-runtime.js.map

package/dist/services/catalog/embeddings-runtime.js.map

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

package/dist/services/catalog/remote-catalog-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview RemoteJsonCatalogProvider — fetches and validates the fleet.json
+ * payload (schema v2, with baked embeddings) from a configurable URL. Caches the
+ * validated result in memory after a successful load.
+ * @module services/catalog/remote-catalog-provider
+ */
+import type { ServerConfig } from '../../config/server-config.js';
+import type { FleetPayload } from './types.js';
+export declare class RemoteJsonCatalogProvider {
+    private readonly _url;
+    private readonly _timeoutMs;
+    constructor(config: Pick<ServerConfig, 'catalogUrl' | 'catalogFetchTimeoutMs'>);
+    /**
+     * Fetch and validate the remote fleet.json payload.
+     * Merges the provided signal (if any) with the configured timeout signal.
+     * Throws McpError(InternalError) on any failure.
+     */
+    load(signal?: AbortSignal): Promise<FleetPayload>;
+}
+//# sourceMappingURL=remote-catalog-provider.d.ts.map

package/dist/services/catalog/remote-catalog-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-catalog-provider.d.ts","sourceRoot":"","sources":["../../../src/services/catalog/remote-catalog-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyC/C,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,uBAAuB,CAAC;IAK9E;;;;OAIG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAoDxD"}

package/dist/services/catalog/remote-catalog-provider.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview RemoteJsonCatalogProvider — fetches and validates the fleet.json
+ * payload (schema v2, with baked embeddings) from a configurable URL. Caches the
+ * validated result in memory after a successful load.
+ * @module services/catalog/remote-catalog-provider
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+// ---------------------------------------------------------------------------
+// Validation schema (v2)
+// ---------------------------------------------------------------------------
+const EmbeddingSchema = z.array(z.number());
+const CatalogToolSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    embedding: EmbeddingSchema,
+});
+const CatalogRecordSchema = z.object({
+    name: z.string(),
+    displayName: z.string(),
+    description: z.string(),
+    category: z.enum(['research', 'government', 'public-data', 'utility']),
+    endpoint: z.string(),
+    npm: z.string(),
+    github: z.string(),
+    version: z.string(),
+    auth: z.string(),
+    embedding: EmbeddingSchema,
+    tools: z.array(CatalogToolSchema),
+});
+const FleetPayloadSchema = z.object({
+    version: z.literal('2'),
+    generatedAt: z.string(),
+    embeddingModel: z.string(),
+    embeddingDims: z.number().int().positive(),
+    embeddingQueryPrefix: z.string(),
+    servers: z.array(CatalogRecordSchema),
+});
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+export class RemoteJsonCatalogProvider {
+    _url;
+    _timeoutMs;
+    constructor(config) {
+        this._url = config.catalogUrl;
+        this._timeoutMs = config.catalogFetchTimeoutMs;
+    }
+    /**
+     * Fetch and validate the remote fleet.json payload.
+     * Merges the provided signal (if any) with the configured timeout signal.
+     * Throws McpError(InternalError) on any failure.
+     */
+    async load(signal) {
+        const timeoutSignal = AbortSignal.timeout(this._timeoutMs);
+        const combinedSignal = signal != null ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+        let response;
+        try {
+            response = await fetch(this._url, { signal: combinedSignal });
+        }
+        catch (err) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Catalog fetch failed: ${err instanceof Error ? err.message : String(err)}`, { url: this._url }, { cause: err });
+        }
+        if (!response.ok) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Catalog fetch returned ${response.status} ${response.statusText}`, { url: this._url, status: response.status, statusText: response.statusText });
+        }
+        let raw;
+        try {
+            raw = await response.json();
+        }
+        catch (err) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Catalog response is not valid JSON: ${err instanceof Error ? err.message : String(err)}`, { url: this._url }, { cause: err });
+        }
+        const parsed = FleetPayloadSchema.safeParse(raw);
+        if (!parsed.success) {
+            const first = parsed.error.issues[0];
+            const path = first?.path.join('.') ?? '(unknown)';
+            const msg = first?.message ?? 'validation failed';
+            throw new McpError(JsonRpcErrorCode.InternalError, `Catalog payload failed validation at ${path}: ${msg}`, { url: this._url, issues: parsed.error.issues.slice(0, 5) });
+        }
+        return parsed.data;
+    }
+}
+//# sourceMappingURL=remote-catalog-provider.js.map

package/dist/services/catalog/remote-catalog-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-catalog-provider.js","sourceRoot":"","sources":["../../../src/services/catalog/remote-catalog-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAI3E,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAE5C,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,eAAe;CAC3B,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACtC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,OAAO,yBAAyB;IACnB,IAAI,CAAS;IACb,UAAU,CAAS;IAEpC,YAAY,MAAkE;QAC5E,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3D,MAAM,cAAc,GAClB,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QAE5E,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3E,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAClB,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAClE,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAC7E,CAAC;QACJ,CAAC;QAED,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,uCAAuC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACzF,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAClB,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;YAClD,MAAM,GAAG,GAAG,KAAK,EAAE,OAAO,IAAI,mBAAmB,CAAC;YAClD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,wCAAwC,IAAI,KAAK,GAAG,EAAE,EACtD,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,IAAoB,CAAC;IACrC,CAAC;CACF"}

package/dist/services/catalog/snippets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Per-client install snippet factory registry.
+ * A plain Record mapping ClientId to a factory function that produces an InstallSnippet
+ * from a CatalogRecord. Snippets are derived at request time from the record's
+ * { name, npm, endpoint } fields — no precomputed snippet list lives in the catalog JSON.
+ * @module services/catalog/snippets
+ */
+import type { CatalogRecord, ClientId, InstallSnippet } from './types.js';
+/** Factory signature: given a CatalogRecord, produce one InstallSnippet. */
+type SnippetFactory = (record: CatalogRecord) => InstallSnippet;
+/** Registry of all supported clients. */
+export declare const SNIPPET_REGISTRY: Record<ClientId, SnippetFactory>;
+/** Generate install snippets for all supported clients for a given record. */
+export declare function buildAllSnippets(record: CatalogRecord): InstallSnippet[];
+export {};
+//# sourceMappingURL=snippets.d.ts.map

package/dist/services/catalog/snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.d.ts","sourceRoot":"","sources":["../../../src/services/catalog/snippets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E,4EAA4E;AAC5E,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,cAAc,CAAC;AA8ChE,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAK7D,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,EAAE,CAExE"}

package/dist/services/catalog/snippets.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Per-client install snippet factory registry.
+ * A plain Record mapping ClientId to a factory function that produces an InstallSnippet
+ * from a CatalogRecord. Snippets are derived at request time from the record's
+ * { name, npm, endpoint } fields — no precomputed snippet list lives in the catalog JSON.
+ * @module services/catalog/snippets
+ */
+/** Build the Claude Desktop JSON fragment. All catalog servers have a hosted endpoint. */
+function claudeDesktopSnippet(record) {
+    return {
+        client: 'claude-desktop',
+        label: 'Claude Desktop (JSON config)',
+        payload: JSON.stringify({ [record.name]: { type: 'sse', url: record.endpoint } }, null, 2),
+    };
+}
+/** Build the Claude Code CLI command. */
+function claudeCodeSnippet(record) {
+    return {
+        client: 'claude-code',
+        label: 'Claude Code (CLI)',
+        payload: `claude mcp add --transport sse ${record.name} ${record.endpoint}`,
+    };
+}
+/** Build the Cursor .cursor/mcp.json fragment. */
+function cursorSnippet(record) {
+    return {
+        client: 'cursor',
+        label: 'Cursor (mcp.json)',
+        payload: JSON.stringify({ mcpServers: { [record.name]: { type: 'sse', url: record.endpoint } } }, null, 2),
+    };
+}
+/** Build the Cline VS Code extension MCP settings fragment. */
+function clineSnippet(record) {
+    return {
+        client: 'cline',
+        label: 'Cline (VS Code)',
+        payload: JSON.stringify({ [record.name]: { type: 'sse', url: record.endpoint, disabled: false, autoApprove: [] } }, null, 2),
+    };
+}
+/** Registry of all supported clients. */
+export const SNIPPET_REGISTRY = {
+    'claude-desktop': claudeDesktopSnippet,
+    'claude-code': claudeCodeSnippet,
+    cursor: cursorSnippet,
+    cline: clineSnippet,
+};
+/** Generate install snippets for all supported clients for a given record. */
+export function buildAllSnippets(record) {
+    return Object.values(SNIPPET_REGISTRY).map((factory) => factory(record));
+}
+//# sourceMappingURL=snippets.js.map

package/dist/services/catalog/snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.js","sourceRoot":"","sources":["../../../src/services/catalog/snippets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,0FAA0F;AAC1F,SAAS,oBAAoB,CAAC,MAAqB;IACjD,OAAO;QACL,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,8BAA8B;QACrC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,SAAS,iBAAiB,CAAC,MAAqB;IAC9C,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,kCAAkC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE;KAC5E,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,SAAS,aAAa,CAAC,MAAqB;IAC1C,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,EACxE,IAAI,EACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAS,YAAY,CAAC,MAAqB;IACzC,OAAO;QACL,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,EAC1F,IAAI,EACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,iBAAiB;IAChC,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC"}