@convertcom/mcp-server 0.0.1-beta.10

package/build/kb-search.d.ts

@@ -0,0 +1,18 @@
+export interface KbChunk {
+    title: string;
+    url: string;
+    content: string;
+}
+export interface SearchResult {
+    id: string;
+    chunk: KbChunk;
+    score: number;
+    snippet: string;
+}
+export declare class KbSearchService {
+    private readonly index;
+    private readonly chunkMap;
+    constructor(kbPath: string);
+    getById(id: string): KbChunk | null;
+    search(query: string, limit?: number): SearchResult[];
+}

package/build/kb-search.js

@@ -0,0 +1,77 @@
+import { readFileSync } from 'node:fs';
+import MiniSearch from 'minisearch';
+const DEFAULT_SEARCH_OPTIONS = {
+    prefix: true,
+    fuzzy: 0.2,
+    boost: { title: 2, content: 1 }
+};
+export class KbSearchService {
+    index;
+    chunkMap = new Map();
+    constructor(kbPath) {
+        const raw = readFileSync(kbPath, 'utf8');
+        const chunks = JSON.parse(raw);
+        const indexedChunks = chunks.map((chunk, idx) => {
+            const id = String(idx);
+            this.chunkMap.set(id, chunk);
+            return { id, ...chunk };
+        });
+        this.index = new MiniSearch({
+            fields: ['title', 'content'],
+            storeFields: ['title', 'url', 'content'],
+            searchOptions: DEFAULT_SEARCH_OPTIONS
+        });
+        this.index.addAll(indexedChunks);
+        console.error(`[KbSearchService] Indexed ${indexedChunks.length} chunks for MiniSearch-based lookup.`);
+    }
+    getById(id) {
+        return this.chunkMap.get(id) ?? null;
+    }
+    search(query, limit = 5) {
+        if (!query || !query.trim()) {
+            return [];
+        }
+        const cleanedQuery = query.trim();
+        const results = this.index.search(cleanedQuery, DEFAULT_SEARCH_OPTIONS).slice(0, limit);
+        const topScore = results.length > 0 && typeof results[0].score === 'number' ? results[0].score : 0;
+        return results.map((result) => {
+            const chunk = this.chunkMap.get(result.id) ?? {
+                title: result.title,
+                url: result.url,
+                content: result.content
+            };
+            const snippet = buildSnippet(chunk.content, cleanedQuery);
+            const normalizedScore = topScore > 0 && typeof result.score === 'number'
+                ? Number((result.score / topScore).toFixed(4))
+                : 0;
+            return {
+                id: result.id,
+                chunk,
+                score: normalizedScore,
+                snippet
+            };
+        });
+    }
+}
+function buildSnippet(content, query, radius = 180) {
+    if (!content)
+        return '';
+    const lowerContent = content.toLowerCase();
+    const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+    let firstIndex = -1;
+    for (const token of tokens) {
+        const idx = lowerContent.indexOf(token);
+        if (idx !== -1 && (firstIndex === -1 || idx < firstIndex)) {
+            firstIndex = idx;
+        }
+    }
+    if (firstIndex === -1) {
+        return content.length > radius * 2 ? `${content.slice(0, radius * 2)}...` : content;
+    }
+    const start = Math.max(0, firstIndex - radius);
+    const end = Math.min(content.length, firstIndex + tokens[0].length + radius);
+    const prefix = start > 0 ? '...' : '';
+    const suffix = end < content.length ? '...' : '';
+    return `${prefix}${content.slice(start, end)}${suffix}`;
+}
+//# sourceMappingURL=kb-search.js.map

package/build/kb-search.js.map

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

package/build/kb-semantic.d.ts

@@ -0,0 +1,20 @@
+import type { SearchResult } from './kb-search.js';
+export declare class SemanticKbSearchService {
+    private _isReady;
+    private _initPromise;
+    private _collection;
+    private _extractor;
+    private _chunks;
+    private _hasLoadedNativeRuntime;
+    private _runtimeVectorsDir;
+    constructor(kbJsonPath: string, vectorsDir: string);
+    isReady(): boolean;
+    waitReady(): Promise<boolean>;
+    hasNativeRuntimeLoaded(): boolean;
+    search(query: string, limit?: number): Promise<SearchResult[]>;
+    close(): void;
+    private _init;
+    private _openCollectionWithLockFallback;
+}
+export declare function isZvecLockError(error: unknown): boolean;
+export declare function isSemanticKbDisabled(): boolean;

package/build/kb-semantic.js

@@ -0,0 +1,135 @@
+import { cpSync, existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const MODEL_ID = 'Xenova/all-MiniLM-L6-v2';
+const EMBEDDING_DIM = 384;
+export class SemanticKbSearchService {
+    _isReady = false;
+    _initPromise;
+    _collection = null;
+    _extractor = null;
+    _chunks = [];
+    _hasLoadedNativeRuntime = false;
+    _runtimeVectorsDir = null;
+    constructor(kbJsonPath, vectorsDir) {
+        this._initPromise = this._init(kbJsonPath, vectorsDir);
+    }
+    isReady() {
+        return this._isReady;
+    }
+    waitReady() {
+        return this._initPromise;
+    }
+    hasNativeRuntimeLoaded() {
+        return this._hasLoadedNativeRuntime;
+    }
+    async search(query, limit = 5) {
+        if (!this._isReady || !this._collection || !this._extractor) {
+            return [];
+        }
+        try {
+            const output = await this._extractor(query, { pooling: 'mean', normalize: true });
+            const queryVec = new Float32Array(output.data);
+            if (queryVec.length !== EMBEDDING_DIM) {
+                console.error(`[SemanticKbSearch] Unexpected embedding dimension: ${queryVec.length}, expected ${EMBEDDING_DIM}`);
+                return [];
+            }
+            const docs = this._collection.querySync({
+                fieldName: 'embedding',
+                vector: queryVec,
+                topk: limit,
+                outputFields: ['chunk_id'],
+            });
+            return docs.map((doc) => {
+                const chunkId = Number(doc.fields.chunk_id);
+                const chunk = this._chunks[chunkId];
+                if (!chunk)
+                    return null;
+                const snippet = chunk.content.length > 360
+                    ? chunk.content.slice(0, 360) + '...'
+                    : chunk.content;
+                return {
+                    id: String(chunkId),
+                    chunk,
+                    score: doc.score,
+                    snippet,
+                };
+            }).filter((r) => r !== null);
+        }
+        catch (err) {
+            console.error('[SemanticKbSearch] Query error:', err instanceof Error ? err.message : err);
+            return [];
+        }
+    }
+    close() {
+        this._collection = null;
+        this._extractor = null;
+        this._isReady = false;
+        if (this._runtimeVectorsDir) {
+            rmSync(this._runtimeVectorsDir, { recursive: true, force: true });
+            this._runtimeVectorsDir = null;
+        }
+    }
+    async _init(kbJsonPath, vectorsDir) {
+        try {
+            if (isSemanticKbDisabled()) {
+                console.error('[SemanticKbSearch] Disabled by CONVERT_DISABLE_SEMANTIC_KB; using keyword-only search.');
+                return false;
+            }
+            if (!existsSync(vectorsDir)) {
+                console.error(`[SemanticKbSearch] Vectors directory not found: ${vectorsDir} — falling back to keyword-only search.`);
+                return false;
+            }
+            // Load chunks for content lookup by chunk_id
+            const raw = readFileSync(kbJsonPath, 'utf8');
+            this._chunks = JSON.parse(raw);
+            // Dynamic imports — missing packages throw catchable errors.
+            // Zvec is CJS, so dynamic import yields { default: { ZVecOpen, ... } }.
+            const [hf, zvecMod] = await Promise.all([
+                import('@huggingface/transformers'),
+                import('@zvec/zvec'),
+            ]);
+            this._hasLoadedNativeRuntime = true;
+            const { ZVecOpen } = zvecMod.default ?? zvecMod;
+            this._extractor = await hf.pipeline('feature-extraction', MODEL_ID, {
+                dtype: 'fp32',
+            });
+            this._collection = this._openCollectionWithLockFallback(ZVecOpen, vectorsDir);
+            this._isReady = true;
+            console.error(`[SemanticKbSearch] Ready — ${this._chunks.length} chunks, model: ${MODEL_ID}`);
+            return true;
+        }
+        catch (err) {
+            console.error('[SemanticKbSearch] Init failed (keyword-only fallback):', err instanceof Error ? err.message : err);
+            this._isReady = false;
+            return false;
+        }
+    }
+    _openCollectionWithLockFallback(openCollection, vectorsDir) {
+        const runtimeParent = process.env.CONVERT_KB_VECTOR_TMPDIR || tmpdir();
+        const runtimeDir = mkdtempSync(join(runtimeParent, 'convert-mcp-kb-vectors-'));
+        cpSync(vectorsDir, runtimeDir, { recursive: true });
+        this._runtimeVectorsDir = runtimeDir;
+        try {
+            console.error(`[SemanticKbSearch] Using read-only runtime vector copy: ${runtimeDir}`);
+            return openCollection(runtimeDir, { readOnly: true });
+        }
+        catch (error) {
+            rmSync(runtimeDir, { recursive: true, force: true });
+            this._runtimeVectorsDir = null;
+            if (!isZvecLockError(error))
+                throw error;
+            throw new Error(`Packaged vector store could not be opened from runtime copy: ${error instanceof Error ? error.message : String(error)}`, {
+                cause: error,
+            });
+        }
+    }
+}
+export function isZvecLockError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /\b(lock|locked|locking)\b/i.test(message);
+}
+export function isSemanticKbDisabled() {
+    return /^(1|true|yes)$/i.test(process.env.CONVERT_DISABLE_SEMANTIC_KB || '');
+}
+//# sourceMappingURL=kb-semantic.js.map

package/build/kb-semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-semantic.js","sourceRoot":"","sources":["../src/kb-semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAYjC,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAC3C,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,OAAO,uBAAuB;IAC1B,QAAQ,GAAG,KAAK,CAAC;IACjB,YAAY,CAAmB;IAC/B,WAAW,GAA0B,IAAI,CAAC;IAC1C,UAAU,GAAqB,IAAI,CAAC;IACpC,OAAO,GAAc,EAAE,CAAC;IACxB,uBAAuB,GAAG,KAAK,CAAC;IAChC,kBAAkB,GAAkB,IAAI,CAAC;IAEjD,YAAY,UAAkB,EAAE,UAAkB;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClF,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,IAAyB,CAAC,CAAC;YAEpE,IAAI,QAAQ,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CAAC,sDAAsD,QAAQ,CAAC,MAAM,cAAc,aAAa,EAAE,CAAC,CAAC;gBAClH,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBACtC,SAAS,EAAE,WAAW;gBACtB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,KAAK;gBACX,YAAY,EAAE,CAAC,UAAU,CAAC;aAC3B,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpC,IAAI,CAAC,KAAK;oBAAE,OAAO,IAAI,CAAC;gBAExB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;oBACxC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;oBACrC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;gBAElB,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;oBACnB,KAAK;oBACL,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,OAAO;iBACR,CAAC;YACJ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC3F,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,UAAkB,EAAE,UAAkB;QACxD,IAAI,CAAC;YACH,IAAI,oBAAoB,EAAE,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;gBACxG,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,mDAAmD,UAAU,yCAAyC,CAAC,CAAC;gBACtH,OAAO,KAAK,CAAC;YACf,CAAC;YAED,6CAA6C;YAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;YAE5C,6DAA6D;YAC7D,wEAAwE;YACxE,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACtC,MAAM,CAAC,2BAA2B,CAAC;gBACnC,MAAM,CAAC,YAAY,CAAC;aACrB,CAAC,CAAC;YACH,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;YACpC,MAAM,EAAE,QAAQ,EAAE,GAAI,OAAe,CAAC,OAAO,IAAI,OAAO,CAAC;YAEzD,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,EAAE;gBAClE,KAAK,EAAE,MAAM;aACd,CAAyB,CAAC;YAE3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,+BAA+B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAE9E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,CAAC,OAAO,CAAC,MAAM,mBAAmB,QAAQ,EAAE,CAAC,CAAC;YAC9F,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yDAAyD,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACnH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,+BAA+B,CACrC,cAA4F,EAC5F,UAAkB;QAElB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,MAAM,EAAE,CAAC;QACvE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC;QAErC,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,2DAA2D,UAAU,EAAE,CAAC,CAAC;YACvF,OAAO,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,gEAAgE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBACxI,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/build/namespaced.d.ts

@@ -0,0 +1,10 @@
+import { Tool, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Per-action agent guidance. Appended to generated descriptions as "Agent Notes:".
+ * Keys are "namespace.action" strings matching REGISTRY entries.
+ * This map survives `yarn generate` — it's hand-curated like REGISTRY.
+ */
+export declare const ACTION_NOTES: Record<string, string>;
+export declare function getNamespacedTools(toolSet: string): Tool[];
+export declare function executeNamespacedTool(namespace: string, args: any): Promise<CallToolResult>;
+export declare function isNamespace(name: string): boolean;