@terreno/mcp 0.21.0

package/dist/search/docIndex.js

@@ -0,0 +1,254 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { extname, join, relative } from "node:path";
+import MiniSearch from "minisearch";
+import { getDocsRoot } from "../docsRoot.js";
+import { formatComponentMarkdown, loadTypeDocJson, parseComponentsFromTypeDoc, } from "../resources.js";
+import { chunkMarkdown } from "./chunker.js";
+import { inferPackageTags, normalizePackageFilter } from "./inferPackages.js";
+let cachedIndex = null;
+let cachedChunks = null;
+/**
+ * Collects `.md` paths under `dir` without following symbolic links (avoids
+ * indexing targets outside the docs tree via symlinked paths).
+ */
+const walkMarkdownFiles = (dir, acc = []) => {
+    if (!existsSync(dir)) {
+        return acc;
+    }
+    for (const ent of readdirSync(dir, { withFileTypes: true })) {
+        if (ent.isSymbolicLink()) {
+            continue;
+        }
+        const full = join(dir, ent.name);
+        if (ent.isDirectory()) {
+            walkMarkdownFiles(full, acc);
+        }
+        else if (ent.isFile() && extname(ent.name).toLowerCase() === ".md") {
+            acc.push(full);
+        }
+    }
+    return acc;
+};
+const loadAllChunks = () => {
+    const root = getDocsRoot();
+    const chunks = [];
+    const resourcesDir = join(root, "resources");
+    if (existsSync(resourcesDir)) {
+        for (const file of readdirSync(resourcesDir)) {
+            if (!file.endsWith(".md")) {
+                continue;
+            }
+            const abs = join(resourcesDir, file);
+            const rel = relative(root, abs).replace(/\\/g, "/");
+            const tags = inferPackageTags(rel);
+            const raw = readFileSync(abs, "utf-8");
+            for (const c of chunkMarkdown(rel, raw, tags)) {
+                chunks.push({ ...c, combined: `${c.breadcrumb} ${c.title} ${c.text}` });
+            }
+        }
+    }
+    const versionedDir = join(root, "versioned");
+    if (existsSync(versionedDir)) {
+        for (const abs of walkMarkdownFiles(versionedDir)) {
+            const rel = relative(root, abs).replace(/\\/g, "/");
+            const tags = inferPackageTags(rel);
+            const raw = readFileSync(abs, "utf-8");
+            for (const c of chunkMarkdown(rel, raw, tags)) {
+                chunks.push({ ...c, combined: `${c.breadcrumb} ${c.title} ${c.text}` });
+            }
+        }
+    }
+    const typeDoc = loadTypeDocJson();
+    if (typeDoc) {
+        const components = parseComponentsFromTypeDoc(typeDoc);
+        for (const comp of components) {
+            const md = formatComponentMarkdown(comp);
+            const rel = `resources/ui-types-component/${comp.name}.md`;
+            const tags = ["ui"];
+            for (const c of chunkMarkdown(rel, md, tags)) {
+                chunks.push({ ...c, combined: `${c.breadcrumb} ${c.title} ${c.text}` });
+            }
+        }
+    }
+    const seenIds = new Set();
+    const deduped = [];
+    for (const c of chunks) {
+        if (seenIds.has(c.id)) {
+            continue;
+        }
+        seenIds.add(c.id);
+        deduped.push(c);
+    }
+    return deduped;
+};
+const buildMiniSearch = (chunks) => {
+    const docs = chunks.map((c) => ({
+        breadcrumb: c.breadcrumb,
+        combined: c.combined,
+        id: c.id,
+        packageTags: c.packageTags,
+        packageTagsJoined: c.packageTags.join(" "),
+        sourcePath: c.sourcePath,
+        text: c.text,
+        title: c.title,
+    }));
+    const search = new MiniSearch({
+        fields: ["title", "breadcrumb", "text", "combined", "sourcePath", "packageTagsJoined"],
+        idField: "id",
+        searchOptions: {
+            boost: { breadcrumb: 1.8, combined: 1.2, title: 2.5 },
+            fuzzy: 0.18,
+            prefix: true,
+        },
+        storeFields: ["title", "breadcrumb", "text", "sourcePath", "packageTags", "id"],
+    });
+    search.addAll(docs);
+    return search;
+};
+export const resetDocSearchIndexForTests = () => {
+    cachedIndex = null;
+    cachedChunks = null;
+};
+const ensureIndex = () => {
+    if (cachedIndex && cachedChunks) {
+        return { chunks: cachedChunks, index: cachedIndex };
+    }
+    const chunks = loadAllChunks();
+    cachedChunks = chunks;
+    cachedIndex = buildMiniSearch(chunks);
+    return { chunks: cachedChunks, index: cachedIndex };
+};
+const approxCharsForTokens = (tokens) => {
+    const safe = Math.max(0, Math.min(Math.floor(tokens), 8000));
+    return Math.floor(safe * 3.5);
+};
+/** Clamps tool `tokenLimit` so invalid or hostile values cannot widen the response budget. */
+const normalizeTokenLimit = (raw) => {
+    if (raw === undefined) {
+        return 3000;
+    }
+    if (!Number.isFinite(raw) || raw <= 0) {
+        return 3000;
+    }
+    return Math.min(8000, Math.floor(raw));
+};
+const chunkMatchesPackages = (chunk, normalizedFilters) => {
+    if (normalizedFilters.length === 0) {
+        return true;
+    }
+    return chunk.packageTags.some((t) => normalizedFilters.includes(t));
+};
+export const searchDocs = (params) => {
+    const queries = params.queries.map((q) => q.trim()).filter(Boolean);
+    if (queries.length === 0) {
+        return 'No search queries provided. Pass one or more strings in `queries` (e.g. ["modelRouter", "Button props"]).';
+    }
+    const packageFilters = (params.packages ?? []).map(normalizePackageFilter).filter(Boolean);
+    const tokenLimit = normalizeTokenLimit(params.tokenLimit);
+    const charBudget = approxCharsForTokens(tokenLimit);
+    const { chunks, index } = ensureIndex();
+    const scoreById = new Map();
+    for (const q of queries) {
+        const hits = index.search(q, { combineWith: "OR" });
+        for (const hit of hits) {
+            const prev = scoreById.get(hit.id) ?? 0;
+            scoreById.set(hit.id, prev + hit.score);
+        }
+    }
+    const rankedIds = [...scoreById.entries()].sort((a, b) => b[1] - a[1]).map(([id]) => id);
+    const chunkById = new Map();
+    for (const c of chunks) {
+        chunkById.set(c.id, c);
+    }
+    const lines = [
+        "# Terreno documentation search results",
+        "",
+        `Queries: ${queries.map((q) => JSON.stringify(q)).join(", ")}`,
+        packageFilters.length
+            ? `Package filter: ${packageFilters.join(", ")}`
+            : "Package filter: (none — all packages)",
+        "",
+    ];
+    let used = 0;
+    let included = 0;
+    for (const id of rankedIds) {
+        const chunk = chunkById.get(id);
+        if (!chunk) {
+            continue;
+        }
+        if (!chunkMatchesPackages(chunk, packageFilters)) {
+            continue;
+        }
+        const rawBlock = [
+            `## ${chunk.title}`,
+            `_Source: \`${chunk.sourcePath}\` · Packages: ${chunk.packageTags.join(", ")}_`,
+            "",
+            chunk.text,
+            "",
+        ].join("\n");
+        let block = rawBlock;
+        if (block.length > charBudget && included === 0) {
+            block = `${rawBlock.slice(0, charBudget)}\n\n_…Truncated to approximate token budget (~${tokenLimit} tokens)._`;
+        }
+        else if (used + block.length > charBudget && included > 0) {
+            lines.push(`_Additional matches omitted to stay within token budget (~${tokenLimit} tokens)._`);
+            break;
+        }
+        lines.push(block);
+        used += block.length;
+        included += 1;
+        if (used >= charBudget) {
+            break;
+        }
+    }
+    if (included === 0) {
+        lines.push("No matching chunks found. Try different keywords, remove the package filter, or use passive MCP resources for full bundled guides.");
+    }
+    lines.push("");
+    lines.push("Prefer calling `terreno_search_docs` before guessing Terreno APIs. For a single @terreno/ui component props table, use `terreno_get_component_docs`.");
+    return lines.join("\n");
+};
+export const getComponentDocsMarkdown = (componentName) => {
+    const trimmed = componentName.trim();
+    if (!trimmed) {
+        return 'Pass `component` (e.g. "Button").';
+    }
+    const typeDoc = loadTypeDocJson();
+    if (!typeDoc) {
+        return "Component documentation is unavailable (ui-types-documentation.json not found). Run `bun run sync-ui-docs` in mcp-server before build.";
+    }
+    const components = parseComponentsFromTypeDoc(typeDoc);
+    const exact = components.find((c) => c.name === trimmed);
+    const ci = components.find((c) => c.name.toLowerCase() === trimmed.toLowerCase());
+    const chosen = exact ?? ci;
+    if (!chosen) {
+        const names = components.map((c) => c.name).sort();
+        const preview = names.slice(0, 40).join(", ");
+        const more = names.length > 40 ? `, … (+${names.length - 40} more)` : "";
+        return `No component named "${trimmed}". Examples: ${preview}${more}`;
+    }
+    let md = formatComponentMarkdown(chosen);
+    const { chunks, index } = ensureIndex();
+    const extra = index.search(`${chosen.name} props`, { combineWith: "OR", fuzzy: 0.2 }).slice(0, 3);
+    const chunkById = new Map();
+    for (const c of chunks) {
+        chunkById.set(c.id, c);
+    }
+    const extras = [];
+    for (const hit of extra) {
+        const ch = chunkById.get(hit.id);
+        if (!ch) {
+            continue;
+        }
+        if (!ch.text.includes(chosen.name)) {
+            continue;
+        }
+        extras.push(`### Related: ${ch.title}\n_Source: \`${ch.sourcePath}\`_\n\n${ch.text.slice(0, 1500)}`);
+    }
+    if (extras.length) {
+        md += "\n\n## Related markdown excerpts\n\n";
+        md += extras.join("\n\n---\n\n");
+    }
+    return md;
+};
+//# sourceMappingURL=docIndex.js.map

package/dist/search/docIndex.js.map

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

package/dist/search/inferPackages.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Map a docs-relative path to Terreno package tags used by `terreno_search_docs` filters.
+ * Tags are lowercase short names: api, ui, rtk, admin-backend, admin-frontend, mcp-server, docs.
+ */
+export declare const inferPackageTags: (relativePath: string) => string[];
+export declare const normalizePackageFilter: (pkg: string) => string;
+//# sourceMappingURL=inferPackages.d.ts.map

package/dist/search/inferPackages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferPackages.d.ts","sourceRoot":"","sources":["../../src/search/inferPackages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,cAAc,MAAM,KAAG,MAAM,EAoD7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAKpD,CAAC"}

package/dist/search/inferPackages.js

@@ -0,0 +1,56 @@
+/**
+ * Map a docs-relative path to Terreno package tags used by `terreno_search_docs` filters.
+ * Tags are lowercase short names: api, ui, rtk, admin-backend, admin-frontend, mcp-server, docs.
+ */
+export const inferPackageTags = (relativePath) => {
+    const norm = relativePath.replace(/\\/g, "/").toLowerCase();
+    const tags = new Set();
+    const base = norm.split("/").pop() ?? norm;
+    if (base === "api.md" || norm.includes("/resources/api.md")) {
+        tags.add("api");
+    }
+    if (base === "ui.md" || norm.includes("/resources/ui.md")) {
+        tags.add("ui");
+    }
+    if (base === "rtk.md" || norm.includes("/resources/rtk.md")) {
+        tags.add("rtk");
+    }
+    if (norm.includes("admin-backend")) {
+        tags.add("admin-backend");
+    }
+    if (norm.includes("admin-frontend")) {
+        tags.add("admin-frontend");
+    }
+    if (norm.includes("mcp-server")) {
+        tags.add("mcp-server");
+    }
+    if (norm.includes("/reference/generated/api/")) {
+        tags.add("api");
+    }
+    if (norm.includes("/reference/components/") || norm.includes("/components/")) {
+        tags.add("ui");
+    }
+    if (norm.includes("/api/") && !norm.includes("admin-backend")) {
+        tags.add("api");
+    }
+    if (norm.includes("/ui/") && !norm.includes("admin-frontend")) {
+        tags.add("ui");
+    }
+    if (norm.includes("/rtk/")) {
+        tags.add("rtk");
+    }
+    if (norm.includes("ui-types") || norm.includes("component")) {
+        tags.add("ui");
+    }
+    if (tags.size === 0) {
+        tags.add("docs");
+    }
+    return [...tags];
+};
+export const normalizePackageFilter = (pkg) => {
+    return pkg
+        .trim()
+        .replace(/^@terreno\//i, "")
+        .toLowerCase();
+};
+//# sourceMappingURL=inferPackages.js.map

package/dist/search/inferPackages.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export declare const handleToolCall: (name: string, args: Record<string, unknown>) => {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,oCAAoC,CAAC;AAqE7D,eAAO,MAAM,KAAK,EAAE,IAAI,EAgOvB,CAAC;AAsxBF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAoG/C,CAAC"}