@farming-labs/docs 0.1.2 → 0.1.3

package/dist/cli/index.mjs

@@ -4,6 +4,7 @@ import pc from "picocolors";
 //#region src/cli/index.ts
 const args = process.argv.slice(2);
 const command = args[0];
+const subcommand = args[1];
 const UPGRADE_TAGS = ["latest", "beta"];
 /** Normalize command aliases like `upgrade@beta` into the base command + dist-tag. */
 function parseCommandAlias(rawCommand) {
@@ -18,7 +19,11 @@ function parseCommandAlias(rawCommand) {
 /** Parse flags like --template next, --name my-docs, --theme concrete, --entry docs, --framework astro (exported for tests). */
 function parseFlags(argv) {
 	const flags = {};
-	const booleanFlags = new Set(["api-reference"]);
+	const booleanFlags = new Set([
+		"api-reference",
+		"typesense",
+		"algolia"
+	]);
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
 		if (arg.startsWith("--") && arg.includes("=")) {
@@ -47,14 +52,38 @@ async function main() {
 		apiRouteRoot: typeof flags["api-route-root"] === "string" ? flags["api-route-root"] : void 0
 	};
 	const mcpOptions = { configPath: typeof flags.config === "string" ? flags.config : void 0 };
+	const searchSyncOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		provider: typeof flags.provider === "string" ? flags.provider : void 0,
+		typesense: typeof flags.typesense === "boolean" ? flags.typesense : void 0,
+		algolia: typeof flags.algolia === "boolean" ? flags.algolia : void 0,
+		baseUrl: typeof flags["base-url"] === "string" ? flags["base-url"] : void 0,
+		collection: typeof flags.collection === "string" ? flags.collection : void 0,
+		apiKey: typeof flags["api-key"] === "string" ? flags["api-key"] : void 0,
+		adminApiKey: typeof flags["admin-api-key"] === "string" ? flags["admin-api-key"] : void 0,
+		mode: typeof flags.mode === "string" ? flags.mode : void 0,
+		ollamaModel: typeof flags["ollama-model"] === "string" ? flags["ollama-model"] : void 0,
+		ollamaBaseUrl: typeof flags["ollama-base-url"] === "string" ? flags["ollama-base-url"] : void 0,
+		appId: typeof flags["app-id"] === "string" ? flags["app-id"] : void 0,
+		indexName: typeof flags["index-name"] === "string" ? flags["index-name"] : void 0,
+		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
+	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-N0bZQFRd.mjs");
+		const { init } = await import("../init-C7kgy5hD.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-8rCBy2-U.mjs");
+		const { runMcp } = await import("../mcp-aXyV1jPp.mjs");
 		await runMcp(mcpOptions);
+	} else if (parsedCommand.command === "search" && subcommand === "sync") {
+		const { syncSearch } = await import("../search-ChhShKMO.mjs");
+		await syncSearch(searchSyncOptions);
+	} else if (parsedCommand.command === "search") {
+		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		printHelp();
+		process.exit(1);
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-BbEyR_JB.mjs");
+		const { upgrade } = await import("../upgrade-J_kkv-ti.mjs");
 		await upgrade({
 			framework: (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0),
 			tag: args.includes("--beta") ? "beta" : args.includes("--latest") ? "latest" : parsedCommand.tag ?? "latest"
@@ -78,6 +107,7 @@ ${pc.dim("Usage:")}
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
   ${pc.cyan("mcp")}      Run the built-in docs MCP server over stdio
+  ${pc.cyan("search")}   Search utilities (${pc.dim("sync")} for external indexes)
   ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages to latest (auto-detect or use --framework)
 
 ${pc.dim("Supported frameworks:")}
@@ -95,6 +125,24 @@ ${pc.dim("Options for init:")}
 ${pc.dim("Options for mcp:")}
   ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
 
+${pc.dim("Options for search sync:")}
+  ${pc.cyan("search sync --typesense")}             Sync docs content to Typesense using env/flags
+  ${pc.cyan("search sync --algolia")}              Sync docs content to Algolia using env/flags
+  ${pc.cyan("--config <path>")}                    Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("--provider <name>")}                  Explicit provider (${pc.dim("typesense")}, ${pc.dim("algolia")})
+  ${pc.cyan("--typesense")}                        Shortcut for ${pc.cyan("--provider typesense")}
+  ${pc.cyan("--algolia")}                          Shortcut for ${pc.cyan("--provider algolia")}
+  ${pc.cyan("--base-url <url>")}                   Typesense base URL (or use ${pc.dim("TYPESENSE_URL")})
+  ${pc.cyan("--collection <name>")}                Typesense collection name (default ${pc.dim("docs")})
+  ${pc.cyan("--api-key <key>")}                    Typesense search/api key (or use ${pc.dim("TYPESENSE_API_KEY")})
+  ${pc.cyan("--admin-api-key <key>")}              Admin-capable sync key for Typesense/Algolia
+  ${pc.cyan("--mode <keyword|hybrid>")}            Typesense mode (default ${pc.dim("keyword")})
+  ${pc.cyan("--ollama-model <name>")}              Embeddings model for Typesense hybrid sync
+  ${pc.cyan("--ollama-base-url <url>")}            Ollama base URL for hybrid embeddings
+  ${pc.cyan("--app-id <id>")}                      Algolia app id (or use ${pc.dim("ALGOLIA_APP_ID")})
+  ${pc.cyan("--index-name <name>")}                Algolia index name (default ${pc.dim("docs")})
+  ${pc.cyan("--search-api-key <key>")}             Algolia search key (or use ${pc.dim("ALGOLIA_SEARCH_API_KEY")})
+
 ${pc.dim("Options for upgrade:")}
   ${pc.cyan("--framework <name>")}  Explicit framework (${pc.dim("next")}, ${pc.dim("tanstack-start")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); omit to auto-detect
   ${pc.cyan("--latest")}            Install latest stable (default)

package/dist/config-CSywk3ou.mjs

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+//#region src/cli/config.ts
+const FILE_EXTS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function createPropertyPattern(key, valuePattern) {
+	return new RegExp(`\\b${escapeRegExp(key)}\\b\\s*:\\s*${valuePattern}`);
+}
+function resolveDocsConfigPath(rootDir, explicitPath) {
+	if (explicitPath) {
+		const resolvedPath = resolve(rootDir, explicitPath);
+		if (!existsSync(resolvedPath)) throw new Error(`Could not find docs config at ${explicitPath}.`);
+		return resolvedPath;
+	}
+	for (const ext of FILE_EXTS) {
+		const configPath = join(rootDir, `docs.config.${ext}`);
+		if (existsSync(configPath)) return configPath;
+	}
+	throw new Error("Could not find docs.config.ts or docs.config.tsx in the current project. Use --config to point at a custom path.");
+}
+function readStringProperty(content, key) {
+	return content.match(createPropertyPattern(key, `["']([^"']+)["']`))?.[1];
+}
+function readBooleanProperty(content, key) {
+	const match = content.match(createPropertyPattern(key, "(true|false)"));
+	return match ? match[1] === "true" : void 0;
+}
+function extractObjectLiteral(content, key) {
+	const keyIndex = content.search(new RegExp(`${key}\\s*:\\s*\\{`));
+	if (keyIndex === -1) return void 0;
+	const braceStart = content.indexOf("{", keyIndex);
+	if (braceStart === -1) return void 0;
+	let depth = 0;
+	for (let index = braceStart; index < content.length; index += 1) {
+		const char = content[index];
+		if (char === "{") {
+			depth += 1;
+			continue;
+		}
+		if (char !== "}") continue;
+		depth -= 1;
+		if (depth === 0) return content.slice(braceStart + 1, index);
+	}
+}
+function readNavTitle(content) {
+	const block = extractObjectLiteral(content, "nav");
+	if (!block) return void 0;
+	return readStringProperty(block, "title");
+}
+function resolveDocsContentDir(rootDir, content, entry) {
+	const configuredContentDir = readStringProperty(content, "contentDir");
+	if (configuredContentDir) return configuredContentDir;
+	const candidates = [
+		entry,
+		join("app", entry),
+		join("src", "app", entry)
+	];
+	for (const candidate of candidates) if (existsSync(join(rootDir, candidate))) return candidate;
+	return entry;
+}
+function parseEnvValue(rawValue) {
+	const value = rawValue.trim();
+	if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1);
+	return value;
+}
+function loadProjectEnv(rootDir) {
+	const env = {};
+	for (const filename of [".env", ".env.local"]) {
+		const fullPath = join(rootDir, filename);
+		if (!existsSync(fullPath)) continue;
+		const lines = readFileSync(fullPath, "utf-8").split(/\r?\n/);
+		for (const line of lines) {
+			const trimmed = line.trim();
+			if (!trimmed || trimmed.startsWith("#")) continue;
+			const equalsIndex = trimmed.indexOf("=");
+			if (equalsIndex === -1) continue;
+			const key = trimmed.slice(0, equalsIndex).trim();
+			const rawValue = trimmed.slice(equalsIndex + 1);
+			if (!key) continue;
+			env[key] = parseEnvValue(rawValue);
+		}
+	}
+	return env;
+}
+
+//#endregion
+export { readStringProperty as a, readNavTitle as i, loadProjectEnv as n, resolveDocsConfigPath as o, readBooleanProperty as r, resolveDocsContentDir as s, extractObjectLiteral as t };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { A as SidebarConfig, C as OpenGraphImage, D as PageOpenGraph, E as PageFrontmatter, F as ThemeToggleConfig, I as TypographyConfig, L as UIConfig, M as SidebarNode, N as SidebarPageNode, O as PageTwitter, P as SidebarTree, S as OpenDocsProvider, T as PageActionsConfig, _ as GithubConfig, a as CopyMarkdownConfig, b as OGConfig, c as DocsFeedbackValue, d as DocsMcpToolsConfig, f as DocsMetadata, g as FontStyle, h as FeedbackConfig, i as CodeBlockCopyData, j as SidebarFolderNode, k as SidebarComponentProps, l as DocsI18nConfig, m as DocsTheme, n as ApiReferenceConfig, o as DocsConfig, p as DocsNav, r as BreadcrumbConfig, s as DocsFeedbackData, t as AIConfig, u as DocsMcpConfig, v as LastUpdatedConfig, w as OrderingItem, x as OpenDocsConfig, y as LlmsTxtConfig } from "./types-dqnMXLdw.mjs";
+import { $ as UIConfig, A as GithubConfig, B as PageFrontmatter, C as DocsSearchQuery, D as DocsTheme, E as DocsSearchSourcePage, F as OpenDocsConfig, G as SidebarFolderNode, H as PageTwitter, I as OpenDocsProvider, J as SidebarTree, K as SidebarNode, L as OpenGraphImage, M as LlmsTxtConfig, N as McpDocsSearchConfig, O as FeedbackConfig, P as OGConfig, Q as TypographyConfig, R as OrderingItem, S as DocsSearchEmbeddingsConfig, T as DocsSearchResultType, U as SidebarComponentProps, V as PageOpenGraph, W as SidebarConfig, X as ThemeToggleConfig, Y as SimpleDocsSearchConfig, Z as TypesenseDocsSearchConfig, _ as DocsSearchAdapterContext, a as CodeBlockCopyData, b as DocsSearchConfig, c as DocsConfig, d as DocsI18nConfig, f as DocsMcpConfig, g as DocsSearchAdapter, h as DocsNav, i as BreadcrumbConfig, j as LastUpdatedConfig, k as FontStyle, l as DocsFeedbackData, m as DocsMetadata, n as AlgoliaDocsSearchConfig, o as CopyMarkdownConfig, p as DocsMcpToolsConfig, q as SidebarPageNode, r as ApiReferenceConfig, s as CustomDocsSearchConfig, t as AIConfig, u as DocsFeedbackValue, v as DocsSearchAdapterFactory, w as DocsSearchResult, x as DocsSearchDocument, y as DocsSearchChunkingConfig, z as PageActionsConfig } from "./types-BAulrjlV.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-KzREATdM.mjs";
 
 //#region src/define-docs.d.ts
 /**
@@ -97,4 +98,4 @@ declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "descr
  */
 declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
 //#endregion
-export { type AIConfig, type ApiReferenceConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type ThemeToggleConfig, type TypographyConfig, type UIConfig, buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveTitle };
+export { type AIConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type BreadcrumbConfig, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };

package/dist/index.mjs

@@ -1,3 +1,5 @@
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
+
 //#region src/define-docs.ts
 /**
 * Define docs configuration. Validates and returns the config.
@@ -16,6 +18,7 @@ function defineDocs(config) {
 		components: config.components,
 		onCopyClick: config.onCopyClick,
 		feedback: config.feedback,
+		search: config.search,
 		mcp: config.mcp,
 		icons: config.icons,
 		pageActions: config.pageActions,
@@ -224,4 +227,4 @@ function buildPageTwitter(page, ogConfig, baseUrl) {
 }
 
 //#endregion
-export { buildPageOpenGraph, buildPageTwitter, createTheme, deepMerge, defineDocs, extendTheme, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveTitle };
+export { buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };

package/dist/{init-N0bZQFRd.mjs → init-C7kgy5hD.mjs}

@@ -1,4 +1,4 @@
-import { a as devInstallCommand, c as installCommand, d as writeFileSafe, i as detectPackageManagerFromLockfile, l as readFileSafe, n as detectGlobalCssFiles, o as exec, r as detectNextAppDir, s as fileExists, t as detectFramework, u as spawnAndWaitFor } from "./utils-D5Wn7Q5E.mjs";
+import { a as devInstallCommand, c as installCommand, d as writeFileSafe, i as detectPackageManagerFromLockfile, l as readFileSafe, n as detectGlobalCssFiles, o as exec, r as detectNextAppDir, s as fileExists, t as detectFramework, u as spawnAndWaitFor } from "./utils-CRhME2g-.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/mcp-aXyV1jPp.mjs

@@ -0,0 +1,46 @@
+import "./api-reference-DlfH-Y9c.mjs";
+import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
+import "./server.mjs";
+import { a as readStringProperty, i as readNavTitle, o as resolveDocsConfigPath, r as readBooleanProperty, s as resolveDocsContentDir, t as extractObjectLiteral } from "./config-CSywk3ou.mjs";
+import { readFileSync } from "node:fs";
+
+//#region src/cli/mcp.ts
+async function runMcp(options = {}) {
+	const rootDir = process.cwd();
+	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
+	const entry = readStringProperty(content, "entry") ?? "docs";
+	const contentDir = resolveDocsContentDir(rootDir, content, entry);
+	const navTitle = readNavTitle(content);
+	const mcp = readMcpConfig(content);
+	await runDocsMcpStdio({
+		source: createFilesystemDocsMcpSource({
+			rootDir,
+			entry,
+			contentDir,
+			siteTitle: navTitle ?? "Documentation"
+		}),
+		mcp: resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" }),
+		defaultName: navTitle ?? "@farming-labs/docs"
+	});
+}
+function readMcpConfig(content) {
+	if (content.match(/mcp\s*:\s*false/)) return false;
+	if (content.match(/mcp\s*:\s*true/)) return true;
+	const block = extractObjectLiteral(content, "mcp");
+	if (!block) return void 0;
+	return {
+		enabled: readBooleanProperty(block, "enabled"),
+		route: readStringProperty(block, "route"),
+		name: readStringProperty(block, "name"),
+		version: readStringProperty(block, "version"),
+		tools: {
+			listPages: readBooleanProperty(block, "listPages"),
+			readPage: readBooleanProperty(block, "readPage"),
+			searchDocs: readBooleanProperty(block, "searchDocs"),
+			getNavigation: readBooleanProperty(block, "getNavigation")
+		}
+	};
+}
+
+//#endregion
+export { runMcp };

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { u as DocsMcpConfig, w as OrderingItem } from "./types-dqnMXLdw.mjs";
+import { R as OrderingItem, b as DocsSearchConfig, f as DocsMcpConfig } from "./types-BAulrjlV.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -62,6 +62,7 @@ interface DocsMcpHttpHandlers {
 interface CreateDocsMcpServerOptions {
   source: DocsMcpSource;
   mcp?: boolean | DocsMcpConfig;
+  search?: boolean | DocsSearchConfig;
   defaultName?: string;
   defaultVersion?: string;
 }

package/dist/mcp.mjs

@@ -1,3 +1,4 @@
+import { s as performDocsSearch } from "./search-BS6C5N1i.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
@@ -88,6 +89,7 @@ async function createDocsMcpServer(options) {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
 		defaultVersion: options.defaultVersion
 	});
+	const toolSearchConfig = resolveMcpToolSearchConfig(options.search, resolved.route);
 	const server = new McpServer({
 		name: resolved.name,
 		version: resolved.version
@@ -144,7 +146,14 @@ async function createDocsMcpServer(options) {
 		inputSchema: searchDocsInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ query, limit, locale }) => {
-		const results = searchDocsPages(dedupePages(await options.source.getPages(locale)), query, limit ?? 10);
+		const results = await performDocsSearch({
+			pages: toSearchSourcePages(dedupePages(await options.source.getPages(locale))),
+			query,
+			search: toolSearchConfig ?? true,
+			locale,
+			siteTitle: options.source.siteTitle,
+			limit: limit ?? 10
+		});
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({ results }, null, 2)
@@ -382,6 +391,31 @@ function dedupePages(pages) {
 	for (const page of pages) seen.set(page.url, page);
 	return [...seen.values()];
 }
+function toSearchSourcePages(pages) {
+	return pages.map((page) => ({
+		title: page.title,
+		url: page.url,
+		content: page.content,
+		rawContent: page.rawContent,
+		description: page.description
+	}));
+}
+function isSelfMcpSearchEndpoint(search, route) {
+	if (!search || search === true || typeof search !== "object" || search.provider !== "mcp") return false;
+	const endpoint = search.endpoint.trim();
+	if (!endpoint.startsWith("/")) return false;
+	return normalizeDocsMcpRoute(endpoint) === normalizeDocsMcpRoute(route);
+}
+function resolveMcpToolSearchConfig(search, route) {
+	if (!isSelfMcpSearchEndpoint(search, route)) return search;
+	const config = search;
+	return {
+		provider: "simple",
+		enabled: config.enabled,
+		maxResults: config.maxResults,
+		chunking: config.chunking
+	};
+}
 function toPageSummaries(pages) {
 	return pages.map((page) => ({
 		slug: page.slug,
@@ -418,38 +452,6 @@ function normalizeUrlPath(value) {
 	if (normalized === "/") return normalized;
 	return normalized.replace(/\/+$/, "");
 }
-function searchDocsPages(pages, query, limit) {
-	const normalizedQuery = query.toLowerCase().trim();
-	if (!normalizedQuery) return [];
-	const words = normalizedQuery.split(/\s+/).filter(Boolean);
-	return pages.map((page) => {
-		const titleScore = page.title.toLowerCase().includes(normalizedQuery) ? 10 : 0;
-		const descriptionScore = page.description?.toLowerCase().includes(normalizedQuery) ? 4 : 0;
-		const contentScore = words.reduce((score, word) => {
-			return score + (page.content.toLowerCase().includes(word) ? 1 : 0);
-		}, 0);
-		return {
-			slug: page.slug,
-			url: page.url,
-			title: page.title,
-			description: page.description,
-			icon: page.icon,
-			excerpt: buildExcerpt(page, words),
-			score: titleScore + descriptionScore + contentScore
-		};
-	}).filter((page) => page.score > 0).sort((left, right) => right.score - left.score).slice(0, limit).map(({ score: _score, ...page }) => page);
-}
-function buildExcerpt(page, words) {
-	const haystack = page.rawContent ?? page.content;
-	const lower = haystack.toLowerCase();
-	const firstHit = words.find((word) => lower.includes(word.toLowerCase()));
-	if (!firstHit) return page.description;
-	const index = lower.indexOf(firstHit.toLowerCase());
-	const start = Math.max(0, index - 80);
-	const end = Math.min(haystack.length, index + 140);
-	const excerpt = haystack.slice(start, end).replace(/\s+/g, " ").trim();
-	return excerpt.length > 0 ? excerpt : page.description;
-}
 function renderPageDocument(page) {
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (page.description) lines.push(`Description: ${page.description}`);