@cloudcart/dev-mcp 0.1.5 → 0.2.0

package/dist/tools/semantic-search.js

@@ -0,0 +1,312 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { pipeline } from "@huggingface/transformers";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const MODEL_ID = "Xenova/multilingual-e5-large";
+const EMBED_DIM = 1024;
+const QUERY_PREFIX = "query: ";
+// Lazy singletons — model load is heavy, reuse across calls.
+let extractor = null;
+let vectors = null;
+let metadata = [];
+let chunkCount = 0;
+function dataPath(name) {
+    const candidates = [
+        join(__dirname, "../../data", name),
+        join(__dirname, "../../../data", name),
+        join(process.cwd(), "data", name),
+    ];
+    for (const p of candidates)
+        if (existsSync(p))
+            return p;
+    throw new Error(`Cannot locate data/${name} — run 'npm run build-embeddings' first`);
+}
+function loadCorpus() {
+    if (vectors)
+        return;
+    const buf = readFileSync(dataPath("embeddings.bin"));
+    const n = buf.readUInt32LE(0);
+    const dim = buf.readUInt32LE(4);
+    if (dim !== EMBED_DIM) {
+        throw new Error(`embeddings.bin dimension ${dim} does not match model ${EMBED_DIM}`);
+    }
+    chunkCount = n;
+    const payload = buf.subarray(8);
+    vectors = new Float32Array(payload.buffer, payload.byteOffset, payload.byteLength / 4);
+    metadata = JSON.parse(readFileSync(dataPath("embeddings.json"), "utf8"));
+    if (metadata.length !== n) {
+        throw new Error(`metadata length ${metadata.length} != vector count ${n}`);
+    }
+}
+async function ensureModel() {
+    if (extractor)
+        return extractor;
+    extractor = await pipeline("feature-extraction", MODEL_ID, { dtype: "q8" });
+    return extractor;
+}
+/**
+ * Fire-and-forget prewarm. Kicks off corpus load + model download/load so the
+ * first real semantic_search call doesn't eat a 30+ second cold start.
+ * Swallows errors — prewarm is best-effort and must never break the caller.
+ */
+let prewarmStarted = false;
+export function prewarm() {
+    if (prewarmStarted)
+        return;
+    prewarmStarted = true;
+    void (async () => {
+        try {
+            loadCorpus();
+        }
+        catch { /* index not built yet — ignore */ }
+        try {
+            await ensureModel();
+        }
+        catch { /* offline / no cache yet — ignore */ }
+    })();
+}
+function dot(a, aOff, b, bOff, len) {
+    let s = 0;
+    for (let i = 0; i < len; i++)
+        s += a[aOff + i] * b[bOff + i];
+    return s;
+}
+const OP_ARG_PREVIEW = 8;
+/**
+ * Shrink a fat operation signature like
+ *   `customers(query: String, firstName: String, ..., total_spent: NumericFilter, first: Int! = 25, after: String): CustomerConnection!`
+ * into
+ *   `customers(query, firstName, …, total_spent [+14 more]): CustomerConnection!`
+ *
+ * Keeps the agent aware of what args exist without bleeding 300 tokens of
+ * type annotations into every semantic result.
+ */
+function compactSignature(sig) {
+    if (!sig)
+        return sig;
+    const m = sig.match(/^([^(]+)\(([\s\S]*)\)\s*:\s*(.+)$/);
+    if (!m)
+        return sig;
+    const [, name, argsRaw, ret] = m;
+    const argChunks = splitTopLevelCommas(argsRaw);
+    if (argChunks.length <= OP_ARG_PREVIEW)
+        return sig;
+    const preview = argChunks
+        .slice(0, OP_ARG_PREVIEW)
+        .map((a) => a.trim().split(":")[0]?.trim())
+        .filter(Boolean);
+    const more = argChunks.length - OP_ARG_PREVIEW;
+    return `${name.trim()}(${preview.join(", ")} [+${more} more]): ${ret.trim()}`;
+}
+/** Split a comma-separated arg list, respecting nested parens/brackets. */
+function splitTopLevelCommas(s) {
+    const out = [];
+    let depth = 0;
+    let buf = "";
+    for (const ch of s) {
+        if (ch === "(" || ch === "[" || ch === "{")
+            depth++;
+        else if (ch === ")" || ch === "]" || ch === "}")
+            depth--;
+        if (ch === "," && depth === 0) {
+            out.push(buf);
+            buf = "";
+            continue;
+        }
+        buf += ch;
+    }
+    if (buf.trim())
+        out.push(buf);
+    return out;
+}
+/**
+ * Trim the `Arguments:` block inside an operation chunk to the first
+ * OP_ARG_PREVIEW entries, replacing the tail with a count marker.
+ * Leaves everything outside the block (description, Intent: line) intact.
+ */
+function compactOperationBody(body) {
+    // Strip the redundant "Signature: …" line — the compact signature is
+    // already rendered in the backtick line above this body.
+    const lines = body.split("\n").filter((l) => !l.trimStart().startsWith("Signature:"));
+    const argHeaderIdx = lines.findIndex((l) => l.trimStart().startsWith("Arguments:"));
+    if (argHeaderIdx < 0)
+        return lines.join("\n");
+    const before = lines.slice(0, argHeaderIdx + 1);
+    // Arg lines start with two-space indent + "- ".
+    const afterHeader = lines.slice(argHeaderIdx + 1);
+    const argLines = [];
+    let nonArgTail = [];
+    let inArgs = true;
+    for (const l of afterHeader) {
+        if (inArgs && /^\s+- /.test(l))
+            argLines.push(l);
+        else {
+            inArgs = false;
+            nonArgTail.push(l);
+        }
+    }
+    if (argLines.length <= OP_ARG_PREVIEW)
+        return body;
+    const kept = argLines.slice(0, OP_ARG_PREVIEW);
+    const rest = argLines.length - OP_ARG_PREVIEW;
+    return [
+        ...before,
+        ...kept,
+        `  (+${rest} more args — introspect the operation by exact name for full list)`,
+        ...nonArgTail,
+    ].join("\n");
+}
+/**
+ * Extract lexical tokens from the user query for substring matching.
+ * Splits on whitespace and snake/camel boundaries, drops stop-ish short words,
+ * lowercases for case-insensitive match.
+ */
+function lexicalTokens(query) {
+    const raw = query
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/[_.,;:!?()[\]{}'"`/\\-]+/g, " ")
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean);
+    // Drop 1-char noise; keep 2+ char tokens. Avoid generic stop words.
+    const STOP = new Set(["the", "a", "an", "of", "on", "in", "to", "by", "for", "and", "or", "is", "are"]);
+    return raw.filter((t) => t.length >= 2 && !STOP.has(t));
+}
+/**
+ * True when the query looks like a schema identifier (single token, no spaces,
+ * probably CamelCase or snake_case). For these queries we treat matches
+ * against the full query string as high-signal.
+ */
+function looksLikeSchemaName(query) {
+    return /^[A-Za-z][A-Za-z0-9_]*$/.test(query.trim());
+}
+/**
+ * Tiny lexical tie-breaker. Semantic cosine drives ranking; this only nudges
+ * exact-name hits when the query IS a name (e.g. "Product", "createSegment")
+ * or the user's intent clearly references a specific type.
+ *
+ * Magnitudes are deliberately small (≤ 0.25 and only for exact name match on
+ * a schema-identifier-shaped query) so intent queries like "refund an order"
+ * stay semantic-ranked and don't collapse to every chunk whose name happens
+ * to contain "order".
+ */
+function lexicalScore(chunk, query, tokens) {
+    const name = chunk.name.toLowerCase();
+    const parent = (chunk.parent || "").toLowerCase();
+    const schemaish = looksLikeSchemaName(query);
+    const qLow = query.trim().toLowerCase();
+    // Whole-query exact match against name/parent — strongest signal. Only
+    // applied when the query looks like a schema identifier; for natural
+    // language queries this branch never fires.
+    if (schemaish) {
+        if (name === qLow)
+            return 0.25;
+        if (parent === qLow)
+            return 0.15;
+        // Substring on the full query (handles "createSegment" matching a chunk
+        // literally named "createSegment" even if we also have `createdAt` around).
+        if (name.includes(qLow))
+            return 0.10;
+        if (parent.includes(qLow))
+            return 0.05;
+    }
+    if (tokens.length === 0)
+        return 0;
+    const singleToken = tokens.length === 1;
+    let best = 0;
+    for (const t of tokens) {
+        if (name === t) {
+            best = Math.max(best, singleToken ? 0.15 : 0.04);
+            continue;
+        }
+        if (parent === t) {
+            best = Math.max(best, singleToken ? 0.08 : 0.02);
+            continue;
+        }
+        if (singleToken) {
+            if (name.includes(t)) {
+                best = Math.max(best, 0.05);
+                continue;
+            }
+            if (parent.includes(t)) {
+                best = Math.max(best, 0.02);
+                continue;
+            }
+        }
+    }
+    return best;
+}
+export async function semanticSearch(input) {
+    const query = (input.query ?? "").trim();
+    if (query === "") {
+        return {
+            content: [{
+                    type: "text",
+                    text: "Provide a search query describing what you want to find (e.g. \"customers who spent more than 100\", \"out of stock products\", \"create a segment for returning buyers\").",
+                }],
+        };
+    }
+    loadCorpus();
+    const model = await ensureModel();
+    const out = await model([QUERY_PREFIX + query], { pooling: "mean", normalize: true });
+    const qvec = out.data;
+    const limit = Math.min(Math.max(input.limit ?? 8, 1), 20);
+    const allowKinds = input.kinds && input.kinds.length ? new Set(input.kinds) : null;
+    const tokens = lexicalTokens(query);
+    // Hybrid scoring: semantic cosine + lexical name/parent-match boost.
+    // Widen the top-N during collection so a late lexical boost can still
+    // surface a result the pure-semantic heap would have discarded.
+    const pool = Math.max(limit * 4, 32);
+    const top = [];
+    for (let i = 0; i < chunkCount; i++) {
+        if (allowKinds && !allowKinds.has(metadata[i].kind))
+            continue;
+        const sem = dot(qvec, 0, vectors, i * EMBED_DIM, EMBED_DIM);
+        const lex = lexicalScore(metadata[i], query, tokens);
+        const score = sem + lex;
+        if (top.length < pool) {
+            top.push({ idx: i, sem, lex, score });
+            if (top.length === pool)
+                top.sort((a, b) => a.score - b.score);
+        }
+        else if (score > top[0].score) {
+            top[0] = { idx: i, sem, lex, score };
+            top.sort((a, b) => a.score - b.score);
+        }
+    }
+    top.sort((a, b) => b.score - a.score);
+    top.length = Math.min(top.length, limit);
+    if (top.length === 0) {
+        return {
+            content: [{ type: "text", text: `No matches for "${query}".` }],
+        };
+    }
+    const lines = [
+        `## Top ${top.length} semantic matches for "${query}"`,
+        "",
+    ];
+    for (const { idx, sem, lex, score } of top) {
+        const m = metadata[idx];
+        const lexNote = lex > 0 ? ` (sem ${sem.toFixed(3)} + lex ${lex.toFixed(2)})` : "";
+        lines.push(`### [${m.kind}] ${m.name}${m.parent ? ` (on ${m.parent})` : ""}  — score ${score.toFixed(3)}${lexNote}`);
+        // Operation chunks carry the full list-query signature with all 20+ args
+        // inline — that's ~400 tokens of noise when only the first few matter.
+        // Truncate both the signature and the Arguments block to the 8 most
+        // relevant args; the agent can introspect the operation by exact name
+        // if they need the full list.
+        const sig = m.kind === "operation" ? compactSignature(m.signature) : m.signature;
+        if (sig)
+            lines.push(`\`${sig}\``);
+        const body = m.text.split("\n").slice(1).join("\n").trim();
+        const renderedBody = m.kind === "operation" ? compactOperationBody(body) : body;
+        if (renderedBody)
+            lines.push(renderedBody);
+        lines.push("");
+    }
+    lines.push("> NEXT: use introspect_graphql_schema with the exact type/field name for full details, then validate_graphql_codeblocks before executing.");
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+}
+//# sourceMappingURL=semantic-search.js.map

package/dist/tools/semantic-search.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloudcart/dev-mcp",
-  "version": "0.1.5",
-  "description": "MCP server for CloudCart GraphQL APIs \u2014 helps AI assistants write correct queries and mutations",
+  "version": "0.2.0",
+  "description": "MCP server for CloudCart GraphQL APIs — helps AI assistants write correct queries and mutations",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -11,13 +11,15 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "generate-schema": "tsx scripts/generate-schema.ts",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "build-embeddings": "tsx scripts/build-embeddings.ts"
   },
   "files": [
     "dist",
     "data"
   ],
   "dependencies": {
+    "@huggingface/transformers": "^4.1.0",
     "@modelcontextprotocol/sdk": "^1.27.0",
     "graphql": "^16.13.0",
     "zod": "^3.24.0"