@farming-labs/next 0.1.30 → 0.1.33

package/dist/config.mjs

@@ -147,7 +147,15 @@ const FILE_EXTS = [
 const INTERNAL_DOCS_CONFIG_ALIAS = "@farming-labs/next-internal-docs-config";
 const NEXT_PACKAGE_ROOT = fileURLToPath(new URL("..", import.meta.url));
 const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
 const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
+const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
+const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
+const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
+const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
 const MARKDOWN_ACCEPT_HEADER_VALUE = [
 	"(?:^|.*,\\s*)",
 	"text/markdown",
@@ -630,11 +638,11 @@ function readMcpConfig(root) {
 			const content = readFileSync(configPath, "utf-8");
 			if (content.match(/mcp\s*:\s*false/)) return {
 				enabled: false,
-				route: "/api/docs/mcp"
+				route: DEFAULT_MCP_ROUTE
 			};
 			if (content.match(/mcp\s*:\s*true/)) return {
 				enabled: true,
-				route: "/api/docs/mcp"
+				route: DEFAULT_MCP_ROUTE
 			};
 			const block = extractObjectLiteral(content, "mcp");
 			if (!block) continue;
@@ -642,23 +650,23 @@ function readMcpConfig(root) {
 			const routeMatch = block.match(/route\s*:\s*["']([^"']+)["']/);
 			return {
 				enabled: enabledMatch ? enabledMatch[1] !== "false" : true,
-				route: normalizeRoutePath(routeMatch?.[1] ?? "/api/docs/mcp")
+				route: normalizeRoutePath(routeMatch?.[1] ?? DEFAULT_MCP_ROUTE)
 			};
 		} catch {
 			return {
 				enabled: true,
-				route: "/api/docs/mcp"
+				route: DEFAULT_MCP_ROUTE
 			};
 		}
 	}
 	return {
 		enabled: true,
-		route: "/api/docs/mcp"
+		route: DEFAULT_MCP_ROUTE
 	};
 }
 function normalizeRoutePath(route) {
 	const normalized = `/${route}`.replace(/\/+/g, "/");
-	return normalized !== "/" ? normalized.replace(/\/+$/, "") : "/api/docs/mcp";
+	return normalized !== "/" ? normalized.replace(/\/+$/, "") : DEFAULT_MCP_ROUTE;
 }
 function normalizeAgentFeedbackRoute(route, fallback = DEFAULT_AGENT_FEEDBACK_ROUTE) {
 	if (!route || route.trim().length === 0) return fallback;
@@ -730,9 +738,46 @@ function buildDocsMarkdownRewrites(entry) {
 	];
 }
 function buildAgentSpecRewrites() {
+	return [
+		{
+			source: DEFAULT_AGENT_SPEC_ROUTE,
+			destination: "/api/docs?agent=spec"
+		},
+		{
+			source: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
+			destination: "/api/docs?agent=spec"
+		},
+		{
+			source: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			destination: "/api/docs?agent=spec"
+		}
+	];
+}
+function buildLlmsTxtRewrites() {
+	return [
+		{
+			source: DEFAULT_LLMS_TXT_ROUTE,
+			destination: "/api/docs?format=llms"
+		},
+		{
+			source: DEFAULT_LLMS_FULL_TXT_ROUTE,
+			destination: "/api/docs?format=llms-full"
+		},
+		{
+			source: DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE,
+			destination: "/api/docs?format=llms"
+		},
+		{
+			source: DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE,
+			destination: "/api/docs?format=llms-full"
+		}
+	];
+}
+function buildMcpRewrites(config) {
+	if (!config.enabled || config.route === DEFAULT_MCP_PUBLIC_ROUTE) return [];
 	return [{
-		source: DEFAULT_AGENT_SPEC_ROUTE,
-		destination: "/api/docs?agent=spec"
+		source: DEFAULT_MCP_PUBLIC_ROUTE,
+		destination: config.route
 	}];
 }
 function buildAgentFeedbackRewrites(config) {
@@ -756,9 +801,11 @@ function dedupeRewrites(rewrites) {
 	}
 	return result;
 }
-function mergeDocsMarkdownRewrites(entry, agentFeedback, result) {
+function mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, result) {
 	const autoRewrites = [
 		...buildAgentSpecRewrites(),
+		...buildMcpRewrites(mcp),
+		...buildLlmsTxtRewrites(),
 		...buildDocsMarkdownRewrites(entry),
 		...buildAgentFeedbackRewrites(agentFeedback)
 	];
@@ -797,7 +844,7 @@ function withDocs(nextConfig = {}) {
 	}
 	const mcp = readMcpConfig(root);
 	const docsMcpRouteDir = join(root, appDir, "api", "docs", "mcp");
-	if (mcp.enabled && mcp.route === "/api/docs/mcp" && !isStaticExport && !hasFile(docsMcpRouteDir, "route")) {
+	if (mcp.enabled && mcp.route === DEFAULT_MCP_ROUTE && !isStaticExport && !hasFile(docsMcpRouteDir, "route")) {
 		mkdirSync(docsMcpRouteDir, { recursive: true });
 		writeFileSync(join(docsMcpRouteDir, "route.ts"), DOCS_MCP_ROUTE_TEMPLATE);
 	}
@@ -948,13 +995,13 @@ function withDocs(nextConfig = {}) {
 	if (!isStaticExport) {
 		const existingRewrites = nextConfig.rewrites;
 		nextConfig.rewrites = async () => {
-			return mergeDocsMarkdownRewrites(entry, agentFeedback, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
+			return mergeDocsMarkdownRewrites(entry, mcp, agentFeedback, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
 		};
 	}
 	nextConfig.outputFileTracingIncludes = {
 		...existingTracingIncludes,
 		"/api/docs": [...new Set([...existingTracingIncludes["/api/docs"] ?? [], docsTraceGlob])],
-		"/api/docs/mcp": [...new Set([...existingTracingIncludes["/api/docs/mcp"] ?? [], docsTraceGlob])]
+		[DEFAULT_MCP_ROUTE]: [...new Set([...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [], docsTraceGlob])]
 	};
 	return withMDX(nextConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.1.30",
+  "version": "0.1.33",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -95,8 +95,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.30",
-    "@farming-labs/theme": "0.1.30"
+    "@farming-labs/docs": "0.1.33",
+    "@farming-labs/theme": "0.1.33"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",