@farming-labs/theme 0.1.17 → 0.1.18

package/dist/docs-api.mjs

@@ -274,8 +274,54 @@ function stripCommentsAndStrings(content) {
 	}
 	return result;
 }
-function stripMdx(raw) {
-	const { content } = matter(raw);
+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 stripMdx(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();
 }
 function scanDocsDir(docsDir, entry, locale, excludedDirs = []) {
@@ -296,14 +342,17 @@ function scanDocsDir(docsDir, entry, locale, excludedDirs = []) {
 			const { data } = matter(raw);
 			const title = data.title || slugParts[slugParts.length - 1]?.replace(/-/g, " ") || "Documentation";
 			const description = data.description;
-			const { content: rawContent } = matter(raw);
-			const content = stripMdx(raw);
+			const { content: fileContent } = matter(raw);
+			const rawContent = resolveAgentMdxContent(fileContent, "human");
+			const agentRawContent = resolveAgentMdxContent(fileContent, "agent");
+			const content = stripMdx(rawContent);
 			const url = withLangInUrl(slugParts.length === 0 ? `/${entry}` : `/${entry}/${slugParts.join("/")}`, locale);
 			indexes.push({
 				title,
 				description,
 				content,
 				rawContent,
+				agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
 				url,
 				locale
 			});
@@ -346,12 +395,13 @@ function scanChangelogDir(changelogDir, entryPath, changelogPath, locale) {
 		const pagePath = path.join(entryDir, "page.mdx");
 		if (!fs.existsSync(pagePath)) continue;
 		try {
-			const raw = fs.readFileSync(pagePath, "utf-8");
-			const { data, content: rawContent } = matter(raw);
+			const { data, content: fileContent } = matter(fs.readFileSync(pagePath, "utf-8"));
 			if (data.draft === true) continue;
 			const title = data.title || name.replace(/-/g, " ");
 			const description = data.description;
-			const content = stripMdx(raw);
+			const rawContent = resolveAgentMdxContent(fileContent, "human");
+			const agentRawContent = resolveAgentMdxContent(fileContent, "agent");
+			const content = stripMdx(rawContent);
 			const url = withLangInUrl(`/${entryPath}/${changelogPath}/${name}`, locale);
 			const tags = Array.isArray(data.tags) ? data.tags.filter((value) => typeof value === "string") : void 0;
 			indexes.push({
@@ -359,6 +409,7 @@ function scanChangelogDir(changelogDir, entryPath, changelogPath, locale) {
 				description,
 				content,
 				rawContent,
+				agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
 				url,
 				locale,
 				type: "changelog",
@@ -397,7 +448,7 @@ function renderMarkdownDocument(page) {
 	if ("agentRawContent" in page && 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");
 }
 const DEFAULT_SYSTEM_PROMPT = `You are a helpful documentation assistant. Answer questions based on the provided documentation context. Be concise and accurate. If the answer is not in the context, say so honestly. Use markdown formatting for code examples and links.`;

package/dist/mdx.d.mts

@@ -13,9 +13,13 @@ import * as fumadocs_ui_components_callout0 from "fumadocs-ui/components/callout
 declare function Table(props: React.ComponentPropsWithoutRef<"table">): React.DetailedReactHTMLElement<{
   className: string;
 }, HTMLElement>;
+declare function Agent(_props: {
+  children?: React.ReactNode;
+}): null;
 declare const extendedMdxComponents: {
   img: typeof MDXImg;
   table: typeof Table;
+  Agent: typeof Agent;
   HoverLink: typeof HoverLink;
   Tab: typeof Tab;
   Tabs: typeof Tabs;
@@ -46,4 +50,4 @@ interface GetMDXComponentsOptions {
 }
 declare function getMDXComponents<T extends Record<string, unknown> = Record<string, unknown>>(overrides?: T, options?: GetMDXComponentsOptions): typeof extendedMdxComponents & T;
 //#endregion
-export { GetMDXComponentsOptions, HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };
+export { Agent, GetMDXComponentsOptions, HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/dist/mdx.mjs

@@ -27,10 +27,14 @@ import defaultMdxComponents from "fumadocs-ui/mdx";
 function Table(props) {
 	return React.createElement("div", { className: "fd-table-wrapper relative overflow-auto prose-no-margin my-6" }, React.createElement("table", props));
 }
+function Agent(_props) {
+	return null;
+}
 const extendedMdxComponents = {
 	...defaultMdxComponents,
 	img: MDXImg,
 	table: Table,
+	Agent,
 	HoverLink,
 	Tab,
 	Tabs
@@ -80,4 +84,4 @@ function getMDXComponents(overrides, options) {
 }
 
 //#endregion
-export { HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };
+export { Agent, HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -133,7 +133,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.17"
+    "@farming-labs/docs": "0.1.18"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",