@farming-labs/next 0.2.62 → 0.2.63

package/dist/api.mjs

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { createDocsAPI as createDocsAPI$1, createDocsMCPAPI as createDocsMCPAPI$1 } from "@farming-labs/theme/api";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import { createDocsCloudRouteHandler } from "@farming-labs/docs/cloud/server";
 
 //#region src/api.ts
@@ -113,10 +114,11 @@ async function isDocsCloudPostRequest(request) {
 }
 function createDocsAPI(options = {}, cloudIntegration) {
 	const rootDir = options.rootDir ?? inferNextProjectRootFromCaller();
-	const handlers = createDocsAPI$1(rootDir ? {
+	const handlers = createDocsAPI$1({
 		...options,
-		rootDir
-	} : options);
+		...rootDir ? { rootDir } : {},
+		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills
+	});
 	const integration = resolveDocsCloudIntegration(cloudIntegration);
 	if (!integration) return handlers;
 	return {
@@ -141,10 +143,11 @@ function createDocsAPI(options = {}, cloudIntegration) {
 }
 function createDocsMCPAPI(options = {}) {
 	const rootDir = options.rootDir ?? inferNextProjectRootFromCaller();
-	return createDocsMCPAPI$1(rootDir ? {
+	return createDocsMCPAPI$1({
 		...options,
-		rootDir
-	} : options);
+		...rootDir ? { rootDir } : {},
+		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills
+	});
 }
 
 //#endregion

package/dist/config.d.mts

@@ -2,6 +2,6 @@ import { DocsConfig } from "@farming-labs/docs";
 import { NextConfig } from "next";
 
 //#region src/config.d.ts
-declare function withDocs(nextConfig?: NextConfig, docsConfig?: Pick<DocsConfig, "mcp">): NextConfig;
+declare function withDocs(nextConfig?: NextConfig, docsConfig?: Pick<DocsConfig, "agent" | "mcp">): NextConfig;
 //#endregion
 export { withDocs };

package/dist/config.mjs

@@ -1,9 +1,10 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { dirname, extname, isAbsolute, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN } from "@farming-labs/docs";
-import { ensureDocsReviewWorkflow } from "@farming-labs/docs/server";
+import { ensureDocsReviewWorkflow, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync } from "@farming-labs/docs/server";
 import matter from "gray-matter";
+import { parse } from "@babel/parser";
 import createMDX from "@next/mdx";
 
 //#region src/config.ts
@@ -144,6 +145,8 @@ const FILE_EXTS = [
 	"js"
 ];
 const INTERNAL_DOCS_CONFIG_ALIAS = "@farming-labs/next-internal-docs-config";
+const AGENT_SKILLS_BUNDLE_ALIAS = "@farming-labs/docs/agent-skills-bundle";
+const AGENT_SKILLS_BUNDLE_PATH = ".docs/agent-skills-bundle.mjs";
 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";
@@ -188,8 +191,8 @@ function resolvePackageSubpath(packageDir, relativePath) {
 }
 function toTurbopackAliasPath(root, value) {
 	if (!isAbsolute(value)) return value;
-	const relativePath = relative(root, value);
-	return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+	const relativePath = relative(root, value).replaceAll("\\", "/");
+	return relativePath === ".." || relativePath.startsWith("../") ? relativePath : relativePath.startsWith("./") ? relativePath : `./${relativePath}`;
 }
 const FUMADOCS_OPENAPI_PACKAGE_ALIAS = resolvePackageAlias("fumadocs-openapi") ?? "fumadocs-openapi";
 const FUMADOCS_CORE_PACKAGE_ALIAS = resolvePackageAlias("fumadocs-core") ?? "fumadocs-core";
@@ -545,43 +548,119 @@ function readDocsConfigPath(root) {
 	}
 	return "docs.config.ts";
 }
-function readLiteralStringList(block, key) {
-	const cursor = findTopLevelPropertyValueIndex(block, key);
-	if (cursor === void 0) return null;
-	const value = block.slice(cursor);
-	const quoted = value.match(/^(["'])(.*?)\1/s);
-	if (quoted) return [quoted[2]];
-	if (!value.startsWith("[")) return null;
-	const end = value.indexOf("]");
-	if (end === -1) return null;
-	return [...value.slice(1, end).matchAll(/(["'])(.*?)\1/g)].map((match) => match[2]);
-}
-function readAgentSkillTraceGlobs(root, configPath) {
-	const absoluteConfigPath = join(root, configPath);
-	if (!existsSync(absoluteConfigPath)) return [];
-	const agent = extractTopLevelObjectLiteral(readFileSync(absoluteConfigPath, "utf8"), "agent");
-	if (!agent) return [];
-	const skillsCursor = findTopLevelPropertyValueIndex(agent, "skills");
-	if (skillsCursor === void 0) return [];
-	const skillsObject = agent[skillsCursor] === "{" ? extractObjectLiteral(agent, "skills") : void 0;
-	const configured = skillsObject ? readLiteralStringList(skillsObject, "paths") : readLiteralStringList(agent, "skills");
-	if (!configured) throw new Error("withDocs could not statically trace agent.skills. Use a literal path, a literal path array, or { paths: [...] } so configured skills are included in production.");
-	return configured.map((configuredPath) => {
-		const normalized = configuredPath.replace(/\\/g, "/").replace(/\/$/, "");
-		return normalized.endsWith("/SKILL.md") || normalized === "SKILL.md" ? normalized : `${normalized}/**/*`;
-	});
-}
-function commonTracingRoot(root, globs) {
-	let common = resolve(root);
-	for (const glob of globs) {
-		const candidate = resolve(root, glob.replace(/\/\*\*\/\*$/, ""));
-		while (relative(common, candidate) === ".." || relative(common, candidate).startsWith(`..${sep}`)) {
-			const parent = dirname(common);
-			if (parent === common) break;
-			common = parent;
+function unwrapStaticExpression(expression) {
+	let current = expression;
+	while (current.type === "ParenthesizedExpression" || current.type === "TSAsExpression" || current.type === "TSSatisfiesExpression" || current.type === "TSTypeAssertion" || current.type === "TSNonNullExpression" || current.type === "TSInstantiationExpression") current = current.expression;
+	return current;
+}
+function readStaticPropertyName(property) {
+	const key = unwrapStaticExpression(property.key);
+	if (property.computed) return void 0;
+	if (key.type === "Identifier") return key.name;
+	if (key.type === "StringLiteral") return key.value;
+	if (key.type === "NumericLiteral") return String(key.value);
+	if (key.type === "BigIntLiteral") return key.value;
+	if (key.type === "TemplateLiteral" && key.expressions.length === 0) return key.quasis[0]?.value.cooked ?? void 0;
+}
+function resolveStaticObjectProperty(object, key) {
+	let resolution = { status: "absent" };
+	for (const entry of object.properties) {
+		if (entry.type === "SpreadElement") {
+			resolution = { status: "unknown" };
+			continue;
+		}
+		const name = readStaticPropertyName(entry);
+		if (name === void 0) {
+			if (entry.computed) resolution = { status: "unknown" };
+			continue;
+		}
+		if (name === "__proto__" && !entry.computed && entry.type === "ObjectProperty" && !entry.shorthand) {
+			if (resolution.status !== "value") resolution = { status: "unknown" };
+			continue;
+		}
+		if (name !== key) continue;
+		if (entry.type !== "ObjectProperty" || entry.shorthand) {
+			resolution = { status: "unknown" };
+			continue;
 		}
+		resolution = {
+			status: "value",
+			value: entry.value
+		};
+	}
+	return resolution;
+}
+function hasDefineDocsImport(program, localName) {
+	return program.body.some((statement) => statement.type === "ImportDeclaration" && statement.importKind !== "type" && statement.source.value === "@farming-labs/docs" && statement.specifiers.some((specifier) => specifier.type === "ImportSpecifier" && specifier.importKind !== "type" && specifier.local.name === localName && specifier.imported.type === "Identifier" && specifier.imported.name === "defineDocs"));
+}
+function readDocsConfigRootObject(configPath, content) {
+	let program;
+	try {
+		const extension = extname(configPath).toLowerCase();
+		program = parse(content, {
+			sourceType: "module",
+			sourceFilename: configPath,
+			plugins: extension === ".tsx" ? [
+				"typescript",
+				"jsx",
+				"decorators-legacy"
+			] : extension === ".ts" ? ["typescript", "decorators-legacy"] : extension === ".jsx" ? ["jsx", "decorators-legacy"] : ["decorators-legacy"],
+			createParenthesizedExpressions: true
+		}).program;
+	} catch (error) {
+		throw new Error(`withDocs could not parse ${configPath} while bundling Agent Skills: ${error instanceof Error ? error.message : String(error)}`);
 	}
-	return common;
+	const defaults = program.body.filter((statement) => statement.type === "ExportDefaultDeclaration");
+	if (defaults.length !== 1) throw new Error("withDocs could not statically determine agent.skills. Pass the live docs config as the second withDocs argument or use a literal agent object.");
+	let expression = unwrapStaticExpression(defaults[0].declaration);
+	if (expression.type === "CallExpression") {
+		const callee = expression.callee.type === "V8IntrinsicIdentifier" ? void 0 : unwrapStaticExpression(expression.callee);
+		const argument = expression.arguments[0];
+		if (!callee || callee.type !== "Identifier" || !hasDefineDocsImport(program, callee.name) || !argument || argument.type === "SpreadElement" || argument.type === "ArgumentPlaceholder") throw new Error("withDocs could not statically determine agent.skills. Pass the live docs config as the second withDocs argument or use a literal agent object.");
+		expression = unwrapStaticExpression(argument);
+	}
+	if (expression.type !== "ObjectExpression") throw new Error("withDocs could not statically determine agent.skills. Pass the live docs config as the second withDocs argument or use a literal agent object.");
+	return expression;
+}
+function readStaticStringPaths(expression) {
+	const value = unwrapStaticExpression(expression);
+	if (value.type === "StringLiteral") return [value.value];
+	if (value.type !== "ArrayExpression") return null;
+	const paths = [];
+	for (const entry of value.elements) {
+		if (!entry || entry.type === "SpreadElement") return null;
+		const item = unwrapStaticExpression(entry);
+		if (item.type !== "StringLiteral") return null;
+		paths.push(item.value);
+	}
+	return paths;
+}
+function readAgentSkillPaths(root, configPath) {
+	const absoluteConfigPath = join(root, configPath);
+	if (!existsSync(absoluteConfigPath)) return [];
+	const agent = resolveStaticObjectProperty(readDocsConfigRootObject(absoluteConfigPath, readFileSync(absoluteConfigPath, "utf8")), "agent");
+	if (agent.status === "absent") return [];
+	if (agent.status === "unknown") throw new Error("withDocs could not statically determine agent.skills from a composed agent config. Pass the live docs config as the second withDocs argument.");
+	const agentValue = unwrapStaticExpression(agent.value);
+	if (agentValue.type !== "ObjectExpression") throw new Error("withDocs could not statically determine agent.skills from a composed agent config. Pass the live docs config as the second withDocs argument.");
+	const skills = resolveStaticObjectProperty(agentValue, "skills");
+	if (skills.status === "absent") return [];
+	if (skills.status === "unknown") throw new Error("withDocs could not statically determine agent.skills from a composed agent config. Pass the live docs config as the second withDocs argument.");
+	const skillsValue = unwrapStaticExpression(skills.value);
+	let configured;
+	if (skillsValue.type === "ObjectExpression") {
+		const paths = resolveStaticObjectProperty(skillsValue, "paths");
+		configured = paths.status === "value" ? readStaticStringPaths(paths.value) : null;
+	} else configured = readStaticStringPaths(skillsValue);
+	if (!configured) throw new Error("withDocs could not statically bundle agent.skills. Use a literal path, a literal path array, or { paths: [...] } so configured skills are included in production.");
+	return configured;
+}
+function writeAgentSkillsBundle(root, configuredSkills) {
+	const bundlePath = join(root, AGENT_SKILLS_BUNDLE_PATH);
+	const source = `${GENERATED_BANNER}${renderDocsAgentSkillsBundle(resolveConfiguredAgentSkillsSync(configuredSkills, { rootDir: root }))}`;
+	mkdirSync(dirname(bundlePath), { recursive: true });
+	if (!existsSync(bundlePath) || readFileSync(bundlePath, "utf8") !== source) writeFileSync(bundlePath, source, "utf8");
+	return bundlePath;
 }
 /** Read the OG endpoint from docs.config.ts[x] (returns undefined if not set). */
 function readOgEndpoint(root) {
@@ -1809,8 +1888,7 @@ function withDocs(nextConfig = {}, docsConfig) {
 	const mcp = docsConfig ? resolveMcpConfig(docsConfig.mcp) : readMcpConfig(root);
 	const nextBasePath = normalizeRoutePrefix(nextConfig.basePath);
 	if (mcp.enabled && mcp.protectedResource && nextBasePath) throw new Error(`@farming-labs/next: mcp.security.protectedResource cannot be combined with Next.js basePath ${JSON.stringify(nextBasePath)} because RFC 9728 metadata must be hosted at origin-root well-known URLs. Host the protected docs app at the origin root or publish the metadata and MCP proxy at the edge.`);
-	const agentSkillTraceGlobs = readAgentSkillTraceGlobs(root, docsConfigPath);
-	if (agentSkillTraceGlobs.some((glob) => glob.startsWith("../"))) nextConfig.outputFileTracingRoot ??= workspaceRoot ?? commonTracingRoot(root, agentSkillTraceGlobs);
+	const agentSkillsBundlePath = writeAgentSkillsBundle(root, docsConfig === void 0 || !Object.hasOwn(docsConfig, "agent") ? readAgentSkillPaths(root, docsConfigPath) : docsConfig.agent?.skills);
 	const agentFeedback = readAgentFeedbackConfig(root);
 	const docsConfigRelativeAlias = docsConfigPath.startsWith("./") || docsConfigPath.startsWith("../") ? docsConfigPath : `./${docsConfigPath}`;
 	ensureDocsReviewWorkflow({
@@ -1957,6 +2035,7 @@ function withDocs(nextConfig = {}, docsConfig) {
 			...workspaceRoot ? createDocsWorkspaceAliases(root, workspaceRoot) : {},
 			...existingResolveAlias,
 			[INTERNAL_DOCS_CONFIG_ALIAS]: docsConfigRelativeAlias,
+			[AGENT_SKILLS_BUNDLE_ALIAS]: toTurbopackAliasPath(root, agentSkillsBundlePath),
 			"fumadocs-openapi": toTurbopackAliasPath(root, FUMADOCS_OPENAPI_PACKAGE_ALIAS),
 			"fumadocs-openapi/ui": toTurbopackAliasPath(root, FUMADOCS_OPENAPI_UI_ALIAS),
 			"fumadocs-openapi/server": toTurbopackAliasPath(root, FUMADOCS_OPENAPI_SERVER_ALIAS),
@@ -1988,6 +2067,7 @@ function withDocs(nextConfig = {}, docsConfig) {
 			"@farming-labs/theme/api": join(workspaceRoot, "packages", "fumadocs", "dist", "docs-api.mjs")
 		});
 		resolvedConfig.resolve.alias[INTERNAL_DOCS_CONFIG_ALIAS] = docsConfigAbsolutePath;
+		resolvedConfig.resolve.alias[AGENT_SKILLS_BUNDLE_ALIAS] = agentSkillsBundlePath;
 		resolvedConfig.resolve.alias["fumadocs-openapi"] = FUMADOCS_OPENAPI_PACKAGE_ALIAS;
 		resolvedConfig.resolve.alias["fumadocs-openapi/ui"] = FUMADOCS_OPENAPI_UI_ALIAS;
 		resolvedConfig.resolve.alias["fumadocs-openapi/server"] = FUMADOCS_OPENAPI_SERVER_ALIAS;
@@ -2028,14 +2108,12 @@ function withDocs(nextConfig = {}, docsConfig) {
 			skillTraceFile,
 			agentsTraceFile,
 			agentTraceFile,
-			sitemapManifestTraceFile,
-			...agentSkillTraceGlobs
+			sitemapManifestTraceFile
 		])],
 		[DEFAULT_MCP_ROUTE]: [...new Set([
 			...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [],
 			docsTraceGlob,
-			skillTraceFile,
-			...agentSkillTraceGlobs
+			skillTraceFile
 		])]
 	};
 	return withMDX(nextConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.2.62",
+  "version": "0.2.63",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -86,6 +86,7 @@
     }
   },
   "dependencies": {
+    "@babel/parser": "7.29.7",
     "@mdx-js/loader": "^3.1.0",
     "@mdx-js/react": "^3.1.0",
     "@next/mdx": "^16.1.6",
@@ -100,17 +101,18 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@babel/types": "7.29.7",
     "@types/node": "^22.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.62",
-    "@farming-labs/theme": "0.2.62"
+    "@farming-labs/theme": "0.2.63",
+    "@farming-labs/docs": "0.2.63"
   },
   "peerDependencies": {
-    "@farming-labs/docs": ">=0.0.1",
+    "@farming-labs/docs": ">=0.2.61",
     "@farming-labs/theme": ">=0.0.1",
     "next": ">=16.0.0",
     "react": ">=19.2.0",