@farming-labs/docs 0.1.16 → 0.1.18

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as ThemeToggleConfig, A as DocsTheme, B as OpenGraphImage, C as DocsSearchConfig, D as DocsSearchResult, E as DocsSearchQuery, F as LlmsTxtConfig, G as PageTwitter, H as PageActionsConfig, I as McpDocsSearchConfig, J as SidebarFolderNode, K as SidebarComponentProps, L as OGConfig, M as FontStyle, N as GithubConfig, O as DocsSearchResultType, P as LastUpdatedConfig, Q as SimpleDocsSearchConfig, R as OpenDocsConfig, S as DocsSearchChunkingConfig, T as DocsSearchEmbeddingsConfig, U as PageFrontmatter, V as OrderingItem, W as PageOpenGraph, X as SidebarPageNode, Y as SidebarNode, Z as SidebarTree, _ as DocsMetadata, a as BreadcrumbConfig, b as DocsSearchAdapterContext, c as CodeBlockCopyData, d as DocsConfig, et as TypesenseDocsSearchConfig, f as DocsFeedbackData, g as DocsMcpToolsConfig, h as DocsMcpConfig, i as ApiReferenceRenderer, j as FeedbackConfig, k as DocsSearchSourcePage, l as CopyMarkdownConfig, m as DocsI18nConfig, n as AlgoliaDocsSearchConfig, nt as UIConfig, o as ChangelogConfig, p as DocsFeedbackValue, q as SidebarConfig, r as ApiReferenceConfig, s as ChangelogFrontmatter, t as AIConfig, tt as TypographyConfig, u as CustomDocsSearchConfig, v as DocsNav, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter, z as OpenDocsProvider } from "./types-BqtMAFE0.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-OC9fiolM.mjs";
+import { $ as ThemeToggleConfig, A as DocsTheme, B as OpenGraphImage, C as DocsSearchConfig, D as DocsSearchResult, E as DocsSearchQuery, F as LlmsTxtConfig, G as PageTwitter, H as PageActionsConfig, I as McpDocsSearchConfig, J as SidebarFolderNode, K as SidebarComponentProps, L as OGConfig, M as FontStyle, N as GithubConfig, O as DocsSearchResultType, P as LastUpdatedConfig, Q as SimpleDocsSearchConfig, R as OpenDocsConfig, S as DocsSearchChunkingConfig, T as DocsSearchEmbeddingsConfig, U as PageFrontmatter, V as OrderingItem, W as PageOpenGraph, X as SidebarPageNode, Y as SidebarNode, Z as SidebarTree, _ as DocsMetadata, a as BreadcrumbConfig, b as DocsSearchAdapterContext, c as CodeBlockCopyData, d as DocsConfig, et as TypesenseDocsSearchConfig, f as DocsFeedbackData, g as DocsMcpToolsConfig, h as DocsMcpConfig, i as ApiReferenceRenderer, j as FeedbackConfig, k as DocsSearchSourcePage, l as CopyMarkdownConfig, m as DocsI18nConfig, n as AlgoliaDocsSearchConfig, nt as UIConfig, o as ChangelogConfig, p as DocsFeedbackValue, q as SidebarConfig, r as ApiReferenceConfig, s as ChangelogFrontmatter, t as AIConfig, tt as TypographyConfig, u as CustomDocsSearchConfig, v as DocsNav, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter, z as OpenDocsProvider } from "./types-Du01bck0.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-CzTO1EMx.mjs";
 
 //#region src/define-docs.d.ts
 /**

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { C as DocsSearchConfig, V as OrderingItem, h as DocsMcpConfig } from "./types-BqtMAFE0.mjs";
+import { C as DocsSearchConfig, V as OrderingItem, h as DocsMcpConfig } from "./types-Du01bck0.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -12,6 +12,8 @@ interface DocsMcpPage {
   rawContent?: string;
   agentContent?: string;
   agentRawContent?: string;
+  agentFallbackContent?: string;
+  agentFallbackRawContent?: string;
 }
 interface DocsMcpPageNode {
   type: "page";

package/dist/mcp.mjs

@@ -30,7 +30,7 @@ function normalizeDocsMcpRoute(route) {
 	return normalized !== "/" ? normalized.replace(/\/+$/, "") : DEFAULT_MCP_ROUTE;
 }
 function resolveDocsMcpConfig(mcp, defaults = {}) {
-	if (!mcp) return {
+	if (mcp === false) return {
 		enabled: false,
 		route: normalizeDocsMcpRoute(defaults.defaultRoute),
 		name: defaults.defaultName ?? DEFAULT_MCP_NAME,
@@ -42,7 +42,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			getNavigation: true
 		}
 	};
-	const config = typeof mcp === "object" ? mcp : {};
+	const config = mcp && typeof mcp === "object" ? mcp : {};
 	return {
 		enabled: typeof mcp === "boolean" ? mcp : config.enabled ?? true,
 		route: normalizeDocsMcpRoute(config.route ?? defaults.defaultRoute),
@@ -185,9 +185,9 @@ function createDocsMcpHttpHandler(options) {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
 		defaultVersion: options.defaultVersion
 	}).enabled) return {
-		GET: async () => createJsonErrorResponse(404, "MCP is not enabled. Set `mcp: { enabled: true }` in docs.config to enable it."),
-		POST: async () => createJsonErrorResponse(404, "MCP is not enabled. Set `mcp: { enabled: true }` in docs.config to enable it."),
-		DELETE: async () => createJsonErrorResponse(404, "MCP is not enabled. Set `mcp: { enabled: true }` in docs.config to enable it.")
+		GET: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again."),
+		POST: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again."),
+		DELETE: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again.")
 	};
 	const sessions = /* @__PURE__ */ new Map();
 	async function createSession() {
@@ -252,6 +252,53 @@ function normalizePathSegment(value) {
 function titleize(value) {
 	return value.replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
 }
+function resolveAgentMdxContent(content, audience) {
+	const lines = content.split("\n");
+	const output = [];
+	let fenceMarker = null;
+	let agentDepth = 0;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		const fenceMatch = trimmed.match(/^(`{3,}|~{3,})/);
+		if (fenceMatch) {
+			if (!fenceMarker) fenceMarker = fenceMatch[1];
+			else if (trimmed.startsWith(fenceMarker)) fenceMarker = null;
+			if (audience === "agent" || agentDepth === 0) output.push(line);
+			continue;
+		}
+		if (!fenceMarker) {
+			if (/^<Agent(?:\s[^>]*)?\/>$/.test(trimmed)) continue;
+			const singleLineMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>([\s\S]*?)<\/Agent>\s*$/);
+			if (singleLineMatch) {
+				if (audience === "agent" && singleLineMatch[2]) output.push(`${singleLineMatch[1]}${singleLineMatch[2]}`);
+				continue;
+			}
+			if (line.match(/^(\s*)<Agent(?:\s[^>]*)?>\s*$/)) {
+				agentDepth += 1;
+				continue;
+			}
+			const openWithContentMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>(.*)$/);
+			if (openWithContentMatch) {
+				agentDepth += 1;
+				if (audience === "agent" && openWithContentMatch[2]) output.push(`${openWithContentMatch[1]}${openWithContentMatch[2]}`);
+				continue;
+			}
+			const closeWithContentMatch = line.match(/^(.*)<\/Agent>\s*$/);
+			if (closeWithContentMatch && agentDepth > 0) {
+				if (audience === "agent" && closeWithContentMatch[1]) output.push(closeWithContentMatch[1]);
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+			if (/^<\/Agent>\s*$/.test(trimmed) && agentDepth > 0) {
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+		}
+		if (agentDepth > 0 && audience === "human") continue;
+		output.push(line);
+	}
+	return output.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
 function stripMarkdownForMcp(content) {
 	return content.replace(/^(import|export)\s.*$/gm, "").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
 }
@@ -269,6 +316,9 @@ function scanFilesystemDocsPages(contentDirAbs, entry) {
 			if (name === "agent.md") continue;
 			if (!name.endsWith(".md") && !name.endsWith(".mdx") && !name.endsWith(".svx")) continue;
 			const { data, content } = matter(fs.readFileSync(full, "utf-8"));
+			const humanRawContent = resolveAgentMdxContent(content, "human");
+			const pageAgentRawContent = resolveAgentMdxContent(content, "agent");
+			const pageAgentContent = pageAgentRawContent !== humanRawContent ? stripMarkdownForMcp(pageAgentRawContent) : void 0;
 			const baseName = name.replace(/\.(md|mdx|svx)$/, "");
 			const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
 			const slug = isIndex ? slugParts.join("/") : [...slugParts, baseName].join("/");
@@ -281,10 +331,12 @@ function scanFilesystemDocsPages(contentDirAbs, entry) {
 				title,
 				description: data.description,
 				icon: data.icon,
-				content: stripMarkdownForMcp(content),
-				rawContent: content,
-				...agentDoc,
-				order: typeof data.order === "number" ? data.order : Number.POSITIVE_INFINITY
+				content: stripMarkdownForMcp(humanRawContent),
+				rawContent: humanRawContent,
+				agentFallbackContent: pageAgentContent,
+				agentFallbackRawContent: pageAgentRawContent !== humanRawContent ? pageAgentRawContent : void 0,
+				order: typeof data.order === "number" ? data.order : Number.POSITIVE_INFINITY,
+				...agentDoc
 			});
 		}
 	}
@@ -407,8 +459,12 @@ function toSearchSourcePages(pages) {
 	return pages.map((page) => ({
 		title: page.title,
 		url: page.url,
-		content: page.content,
-		rawContent: page.rawContent,
+		content: page.agentContent ?? page.agentFallbackContent ?? page.content,
+		rawContent: page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent,
+		agentContent: page.agentContent,
+		agentRawContent: page.agentRawContent,
+		agentFallbackContent: page.agentFallbackContent,
+		agentFallbackRawContent: page.agentFallbackRawContent,
 		description: page.description
 	}));
 }
@@ -468,7 +524,7 @@ function renderPageDocument(page) {
 	if (page.agentRawContent !== void 0) return page.agentRawContent;
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (page.description) lines.push(`Description: ${page.description}`);
-	lines.push("", page.rawContent ?? page.content);
+	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
 	return lines.join("\n");
 }
 function renderNavigationTree(tree) {

package/dist/{search-OC9fiolM.d.mts → search-CzTO1EMx.d.mts}

@@ -1,4 +1,4 @@
-import { C as DocsSearchConfig, D as DocsSearchResult, I as McpDocsSearchConfig, S as DocsSearchChunkingConfig, et as TypesenseDocsSearchConfig, k as DocsSearchSourcePage, n as AlgoliaDocsSearchConfig, u as CustomDocsSearchConfig, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter } from "./types-BqtMAFE0.mjs";
+import { C as DocsSearchConfig, D as DocsSearchResult, I as McpDocsSearchConfig, S as DocsSearchChunkingConfig, et as TypesenseDocsSearchConfig, k as DocsSearchSourcePage, n as AlgoliaDocsSearchConfig, u as CustomDocsSearchConfig, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter } from "./types-Du01bck0.mjs";
 
 //#region src/search.d.ts
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { C as DocsSearchConfig, D as DocsSearchResult, E as DocsSearchQuery, I as McpDocsSearchConfig, b as DocsSearchAdapterContext, d as DocsConfig, i as ApiReferenceRenderer, k as DocsSearchSourcePage, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter } from "./types-BqtMAFE0.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-OC9fiolM.mjs";
+import { C as DocsSearchConfig, D as DocsSearchResult, E as DocsSearchQuery, I as McpDocsSearchConfig, b as DocsSearchAdapterContext, d as DocsConfig, i as ApiReferenceRenderer, k as DocsSearchSourcePage, w as DocsSearchDocument, x as DocsSearchAdapterFactory, y as DocsSearchAdapter } from "./types-Du01bck0.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-CzTO1EMx.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts

package/dist/{types-BqtMAFE0.d.mts → types-Du01bck0.d.mts}

@@ -621,6 +621,10 @@ interface DocsSearchSourcePage {
   content: string;
   description?: string;
   rawContent?: string;
+  agentContent?: string;
+  agentRawContent?: string;
+  agentFallbackContent?: string;
+  agentFallbackRawContent?: string;
   type?: "page" | "api" | "code" | "changelog";
   locale?: string;
   framework?: string;
@@ -1517,9 +1521,10 @@ interface DocsConfig {
   /**
    * Built-in MCP server for agent/assistant access to your docs content.
    *
+   * - omitted → enable the default MCP surface at `/api/docs/mcp`
    * - `true` → enable the default MCP surface at `/api/docs/mcp`
    * - `{ route: "/api/docs/mcp" }` → enable with explicit route/config
-   * - `false` or omitted → MCP stays disabled
+   * - `false` or `{ enabled: false }` → disable MCP explicitly
    */
   mcp?: boolean | DocsMcpConfig;
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",