@farming-labs/docs 0.2.55 → 0.2.56

package/dist/mcp.mjs

@@ -1,6 +1,6 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { Gt as hasStructuredPageAgentContract, Kt as normalizePageAgentFrontmatter, Lt as normalizeDocsRelated, Rt as renderDocsRelatedMarkdownLines, Xt as upsertPageAgentContractMarkdown } from "./agent-DXkXi-pS.mjs";
-import { C as resolvePageSidebarFolderIndexBehavior, E as emitDocsTelemetryAgentSurfaceEvent, O as emitDocsTelemetryMcpToolEvent, k as emitDocsTelemetryProjectEvent, m as parseDocsMarkdownSections, p as findDocsMarkdownSection, u as performDocsSearch, x as stripGeneratedAgentProvenance } from "./search-CEg1omHv.mjs";
+import { Et as resolveDocsAudienceMdxContent, Ht as renderDocsRelatedMarkdownLines, Vt as normalizeDocsRelated, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract, en as upsertPageAgentContractMarkdown } from "./agent-CxDzPqtl.mjs";
+import { C as resolvePageSidebarFolderIndexBehavior, E as emitDocsTelemetryAgentSurfaceEvent, O as emitDocsTelemetryMcpToolEvent, k as emitDocsTelemetryProjectEvent, m as parseDocsMarkdownSections, p as findDocsMarkdownSection, u as performDocsSearch, x as stripGeneratedAgentProvenance } from "./search-OHp36znm.mjs";
 import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-B8lptqCd.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
@@ -2134,6 +2134,7 @@ async function createDocsMcpServer(options) {
 				pages: toSearchSourcePages(dedupePages(await getSourcePages(locale))),
 				query,
 				search: toolSearchConfig ?? true,
+				audience: "agent",
 				locale,
 				siteTitle: options.source.siteTitle,
 				limit: resolvedLimit
@@ -2974,53 +2975,6 @@ 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();
 }
@@ -3075,8 +3029,8 @@ function scanFilesystemDocsPages(contentDirAbs, entry, rootDir) {
 			const baseName = name.replace(/\.(md|mdx|svx)$/, "");
 			const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
 			if (isIndex && resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden" && hasVisibleDescendantFilesystemDocsPage(dir)) continue;
-			const humanRawContent = resolveAgentMdxContent(content, "human");
-			const pageAgentRawContent = resolveAgentMdxContent(content, "agent");
+			const humanRawContent = resolveDocsAudienceMdxContent(content, "human");
+			const pageAgentRawContent = resolveDocsAudienceMdxContent(content, "agent");
 			const pageAgentContent = pageAgentRawContent !== humanRawContent ? stripMarkdownForMcp(pageAgentRawContent) : void 0;
 			const slug = isIndex ? slugParts.join("/") : [...slugParts, baseName].join("/");
 			const url = slug ? `/${entry}/${slug}` : `/${entry}`;
@@ -3112,9 +3066,10 @@ function readFilesystemAgentDoc(dir) {
 	const agentPath = path.join(dir, "agent.md");
 	if (!fs.existsSync(agentPath)) return void 0;
 	const { content } = matter(stripGeneratedAgentProvenance(fs.readFileSync(agentPath, "utf-8")));
+	const agentContent = resolveDocsAudienceMdxContent(content, "agent");
 	return {
-		agentContent: stripMarkdownForMcp(content),
-		agentRawContent: content
+		agentContent: stripMarkdownForMcp(agentContent),
+		agentRawContent: agentContent
 	};
 }
 function resolveRelatedForMcpPages(pages) {
@@ -3233,8 +3188,8 @@ function toSearchSourcePages(pages) {
 	return pages.map((page) => ({
 		title: page.title,
 		url: page.url,
-		content: page.agentContent ?? page.agentFallbackContent ?? page.content,
-		rawContent: page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent,
+		content: page.content,
+		rawContent: page.rawContent,
 		sourcePath: page.sourcePath,
 		lastModified: page.lastModified,
 		locale: page.locale,
@@ -3573,7 +3528,7 @@ function countDocsSections(sections) {
 	return sections.reduce((total, section) => total + 1 + countDocsSections(section.sections), 0);
 }
 function extractDocsMcpCodeExamples(page) {
-	const source = page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent;
+	const source = page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
 	if (!source) return [];
 	const examples = [];
 	const lines = source.split("\n");
@@ -3796,7 +3751,7 @@ function toStructuredDocsMcpPage(page) {
 	};
 }
 function getDocsMcpSourceMarkdown(page) {
-	return page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.content;
+	return page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
 }
 function resolveDocsMcpScopeField(pageValue, contractValue, filter, overlaps, matchesFilter) {
 	const pageValues = normalizeAgentScopeValues(pageValue);
@@ -3860,6 +3815,7 @@ async function buildDocsMcpContext(options) {
 			maxResults: 50,
 			chunking: { strategy: "section" }
 		},
+		audience: "agent",
 		locale: options.locale,
 		siteTitle: options.siteTitle,
 		limit: 50
@@ -3999,12 +3955,13 @@ function normalizeUrlPath(value) {
 	return normalized.replace(/\/+$/, "");
 }
 function renderPageDocument(page) {
-	if (page.agentRawContent !== void 0) return upsertPageAgentContractMarkdown(page.agentRawContent, page.agent);
+	const explicitAgentContent = page.agentRawContent ?? page.agentContent;
+	if (explicitAgentContent !== void 0) return upsertPageAgentContractMarkdown(explicitAgentContent, page.agent);
 	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (page.description) lines.push(`Description: ${page.description}`);
 	lines.push(...relatedLines);
-	lines.push("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.rawContent ?? page.content, page.agent));
+	lines.push("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content, page.agent));
 	return lines.join("\n");
 }
 function renderNavigationTree(tree) {

package/dist/{reading-time-BrTd3DIh.mjs → reading-time-W_Id2ayC.mjs}

@@ -1,5 +1,5 @@
-import { Dt as DEFAULT_SITEMAP_XML_ROUTE, Gt as hasStructuredPageAgentContract, Kt as normalizePageAgentFrontmatter, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, Tt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-DXkXi-pS.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DAptQnkx.mjs";
+import { S as DEFAULT_MCP_WELL_KNOWN_ROUTE, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DRpoiYAV.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/{review-Dlb8dRRx.mjs → review-x3zV5jZp.mjs}

@@ -1,11 +1,11 @@
-import { Bt as PAGE_AGENT_CONTRACT_FIELDS, Gt as hasStructuredPageAgentContract, Kt as normalizePageAgentFrontmatter, M as buildDocsAgentDiscoverySpec, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, Wt as getPageAgentFrontmatterIssues, f as DEFAULT_DOCS_CONFIG_ROUTE, u as DEFAULT_DOCS_API_ROUTE } from "./agent-DXkXi-pS.mjs";
-import "./search-CEg1omHv.mjs";
+import { Jt as getPageAgentFrontmatterIssues, M as buildDocsAgentDiscoverySpec, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, St as findDocsAudienceMdxIssues, Wt as PAGE_AGENT_CONTRACT_FIELDS, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract, f as DEFAULT_DOCS_CONFIG_ROUTE, u as DEFAULT_DOCS_API_ROUTE } from "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
 import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.mjs";
 import { a as loadDocsConfigModuleResultWithProjectEnv, h as resolveDocsContentDir, m as resolveDocsConfigPath, p as readTopLevelStringProperty } from "./config-CydaZ5PB.mjs";
 import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
-import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-LS8zQgbq.mjs";
+import { i as extractAgentBlocks, n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-rGFS38Ak.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
@@ -415,6 +415,14 @@ function checkCodeFences(findings, review, options) {
 	}
 }
 function checkAgentContext(findings, review, options) {
+	for (const issue of findDocsAudienceMdxIssues(options.source)) pushFinding(findings, review, {
+		rule: "agentContext",
+		code: `audience-${issue.code}`,
+		severity: issue.code === "dynamic-only" ? "error" : "warn",
+		file: options.file,
+		line: lineForIndex(options.source, issue.index),
+		message: issue.message
+	});
 	for (const issue of getPageAgentFrontmatterIssues(options.agent)) pushFinding(findings, review, {
 		rule: "agentContext",
 		severity: "warn",
@@ -448,7 +456,7 @@ function checkAgentContext(findings, review, options) {
 		});
 		if (agent?.task && agent.outcome) return;
 	}
-	if (options.source.includes("<Agent>") || options.source.includes("</Agent>")) return;
+	if (extractAgentBlocks(options.source, { sourcePath: options.file }).length > 0) return;
 	if (existsSync(path.join(path.dirname(path.join(options.rootDir, options.file)), "agent.md"))) return;
 	if (!/\b(install|configure|setup|implement|defineDocs|docs\.config|MCP|agent)\b/i.test(options.source)) return;
 	pushFinding(findings, review, {
@@ -456,7 +464,7 @@ function checkAgentContext(findings, review, options) {
 		severity: "suggestion",
 		file: options.file,
 		line: 1,
-		message: "Implementation-heavy docs page could use an <Agent> block or sibling agent.md."
+		message: "Implementation-heavy docs page could use an <Agent> block, <Audience only=\"agent\"> block, or sibling agent.md."
 	});
 }
 function pushFinding(findings, review, finding) {
@@ -486,7 +494,7 @@ function printReviewReport(report) {
 	console.log(`Changed files: ${report.changedFiles.length}`);
 	console.log(`Reviewed docs files: ${report.reviewedFiles.length}`);
 	console.log(`Findings: ${counts.error} error${counts.error === 1 ? "" : "s"}, ${counts.warn} warning${counts.warn === 1 ? "" : "s"}, ${counts.suggestion} suggestion${counts.suggestion === 1 ? "" : "s"}`);
-	if (report.usefulness) console.log(`Useful Agent blocks: ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total}; task-complete pages: ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages}`);
+	if (report.usefulness) console.log(`Useful agent-only blocks: ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total}; task-complete pages: ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages}`);
 	if (report.evaluations) console.log(`Golden tasks: ${report.evaluations.status === "unmeasured" ? "unmeasured" : `${report.evaluations.passedTaskCount}/${report.evaluations.taskCount} passed (${report.evaluations.score}/100)`}`);
 	if (report.reviewedFiles.length === 0 && report.findings.length === 0) {
 		console.log("");

package/dist/{robots-4BUJxlvV.mjs → robots-BSPfXA3J.mjs}

@@ -1,5 +1,5 @@
-import "./agent-DXkXi-pS.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
+import "./agent-CxDzPqtl.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
 import { d as readStringProperty, i as loadDocsConfigModule, m as resolveDocsConfigPath, p as readTopLevelStringProperty, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-CydaZ5PB.mjs";
 import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{robots-DAptQnkx.mjs → robots-DRpoiYAV.mjs}

@@ -1,4 +1,4 @@
-import { $ as normalizeDocsPathSegment, Nt as resolveDocsSitemapConfig, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DXkXi-pS.mjs";
+import { $ as normalizeDocsPathSegment, Lt as resolveDocsSitemapConfig, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CxDzPqtl.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";

package/dist/{search-BnQKgDbk.d.mts → search-9uEaC23e.d.mts}

@@ -29,6 +29,30 @@ declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig
 declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
 declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
 //#endregion
+//#region src/audience.d.ts
+/** The two content projections emitted by the docs framework. */
+type DocsContentAudience = "human" | "agent";
+/** Resolve whether content with an optional audience restriction is visible. */
+declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
+interface DocsAudienceMdxIssue {
+  code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
+  index: number;
+  message: string;
+}
+/** Find audience declarations that cannot be projected consistently at build time. */
+declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
+/**
+ * Resolve MDX into its human or agent projection.
+ *
+ * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
+ * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
+ * treated as shared content so an authoring typo never silently deletes content.
+ * These primitives shape content for each surface; they are not an access-control boundary.
+ */
+declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
+/** Backwards-compatible name retained for existing integrations. */
+declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
+//#endregion
 //#region src/prompt-utils.d.ts
 type PromptAction = "copy" | "open";
 interface SerializedOpenDocsProvider {
@@ -185,7 +209,7 @@ interface DocsAskAIPackageHints {
 }
 declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
 declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
-declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
+declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
 declare function createSimpleSearchAdapter(): DocsSearchAdapter;
 declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
 declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
@@ -202,7 +226,8 @@ declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): Do
 declare function performDocsSearch(options: {
   pages: DocsSearchSourcePage[];
   query: string;
-  search?: boolean | DocsSearchConfig;
+  search?: boolean | DocsSearchConfig; /** Selects which audience projection is searchable. Public site search defaults to human. */
+  audience?: DocsContentAudience;
   locale?: string;
   pathname?: string;
   siteTitle?: string;
@@ -222,4 +247,4 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { createDocsAgentTraceId as $, resolveDocsSitemapRequest as A, normalizePromptProviderName as B, buildDocsSitemapManifest as C, renderDocsSitemapXml as D, renderDocsSitemapMarkdown as E, DEFAULT_PROMPT_PROVIDER_TEMPLATES as F, serializeDocsIconRegistry as G, resolvePromptProviderChoices as H, PromptAction as I, DOCS_AGENT_TRACE_EVENT_TYPES as J, serializeOpenDocsProvider as K, PromptProviderChoice as L, DEFAULT_OPEN_DOCS_PROMPT as M, DEFAULT_OPEN_DOCS_PROVIDER_IDS as N, resolveDocsSitemapConfig as O, DEFAULT_OPEN_DOCS_TARGET as P, createDocsAgentTraceContext as Q, SerializeOpenDocsProviderOptions as R, DocsSitemapResolvedConfig as S, readDocsSitemapManifestFromContentMap as T, sanitizePromptText as U, parsePromptStringArray as V, serializeDocsIcon as W, ResolvedDocsAnalyticsConfig as X, DocsAgentTraceContext as Y, ResolvedDocsObservabilityConfig as Z, DEFAULT_SITEMAP_XML_ROUTE as _, createMcpSearchAdapter as a, resolveDocsObservabilityConfig as at, DocsSitemapManifestPage as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, emitDocsAgentTraceEvent as et, resolveSearchRequestConfig as f, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as g, DEFAULT_SITEMAP_MD_ROUTE as h, createCustomSearchAdapter as i, resolveDocsAnalyticsConfig as it, toDocsSitemapMarkdownUrl as j, resolveDocsSitemapPageLastmod as k, inferDocsAskAIPackageHints as l, DEFAULT_SITEMAP_MD_DOCS_ROUTE as m, buildDocsSearchDocuments as n, emitDocsObservabilityEvent as nt, createSimpleSearchAdapter as o, DEFAULT_SITEMAP_MANIFEST_PATH as p, serializeOpenDocsProviders as q, createAlgoliaSearchAdapter as r, getDocsRequestAnalyticsProperties as rt, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, emitDocsAnalyticsEvent as tt, performDocsSearch as u, DocsSitemapFormat as v, createDocsSitemapResponse as w, DocsSitemapPageInput as x, DocsSitemapManifest as y, SerializedOpenDocsProvider as z };
+export { resolveDocsAudienceMdxContent as $, resolveDocsSitemapRequest as A, normalizePromptProviderName as B, buildDocsSitemapManifest as C, renderDocsSitemapXml as D, renderDocsSitemapMarkdown as E, DEFAULT_PROMPT_PROVIDER_TEMPLATES as F, serializeDocsIconRegistry as G, resolvePromptProviderChoices as H, PromptAction as I, DocsAudienceMdxIssue as J, serializeOpenDocsProvider as K, PromptProviderChoice as L, DEFAULT_OPEN_DOCS_PROMPT as M, DEFAULT_OPEN_DOCS_PROVIDER_IDS as N, resolveDocsSitemapConfig as O, DEFAULT_OPEN_DOCS_TARGET as P, resolveDocsAudienceExposure as Q, SerializeOpenDocsProviderOptions as R, DocsSitemapResolvedConfig as S, readDocsSitemapManifestFromContentMap as T, sanitizePromptText as U, parsePromptStringArray as V, serializeDocsIcon as W, findDocsAudienceMdxIssues as X, DocsContentAudience as Y, resolveDocsAgentMdxContent as Z, DEFAULT_SITEMAP_XML_ROUTE as _, createMcpSearchAdapter as a, createDocsAgentTraceId as at, DocsSitemapManifestPage as b, formatDocsAskAIPackageHints as c, emitDocsObservabilityEvent as ct, resolveAskAISearchRequestConfig as d, resolveDocsObservabilityConfig as dt, DOCS_AGENT_TRACE_EVENT_TYPES as et, resolveSearchRequestConfig as f, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as g, DEFAULT_SITEMAP_MD_ROUTE as h, createCustomSearchAdapter as i, createDocsAgentTraceContext as it, toDocsSitemapMarkdownUrl as j, resolveDocsSitemapPageLastmod as k, inferDocsAskAIPackageHints as l, getDocsRequestAnalyticsProperties as lt, DEFAULT_SITEMAP_MD_DOCS_ROUTE as m, buildDocsSearchDocuments as n, ResolvedDocsAnalyticsConfig as nt, createSimpleSearchAdapter as o, emitDocsAgentTraceEvent as ot, DEFAULT_SITEMAP_MANIFEST_PATH as p, serializeOpenDocsProviders as q, createAlgoliaSearchAdapter as r, ResolvedDocsObservabilityConfig as rt, createTypesenseSearchAdapter as s, emitDocsAnalyticsEvent as st, buildDocsAskAIContext as t, DocsAgentTraceContext as tt, performDocsSearch as u, resolveDocsAnalyticsConfig as ut, DocsSitemapFormat as v, createDocsSitemapResponse as w, DocsSitemapPageInput as x, DocsSitemapManifest as y, SerializedOpenDocsProvider as z };

package/dist/{search-CEg1omHv.mjs → search-OHp36znm.mjs}

@@ -1,4 +1,4 @@
-import { G as isDocsAgentsRequest, Ht as PAGE_AGENT_CONTRACT_START_MARKER, W as isDocsAgentDiscoveryRequest, Xt as upsertPageAgentContractMarkdown, Z as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, ct as resolveDocsAgentFeedbackConfig, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackRequest, pt as resolveDocsLlmsTxtRequest, qt as renderPageAgentContractMarkdown, yt as resolveDocsSkillFormat, zt as PAGE_AGENT_CONTRACT_END_MARKER } from "./agent-DXkXi-pS.mjs";
+import { G as isDocsAgentsRequest, Kt as PAGE_AGENT_CONTRACT_START_MARKER, Ut as PAGE_AGENT_CONTRACT_END_MARKER, W as isDocsAgentDiscoveryRequest, Z as isDocsSkillRequest, Zt as renderPageAgentContractMarkdown, ct as resolveDocsAgentFeedbackConfig, en as upsertPageAgentContractMarkdown, ft as resolveDocsLlmsTxtRequest, gt as resolveDocsMarkdownRequest, lt as resolveDocsAgentFeedbackRequest, ut as resolveDocsAgentsFormat, vt as resolveDocsSkillFormat } from "./agent-CxDzPqtl.mjs";
 
 //#region src/telemetry.ts
 const DOCS_PACKAGE_NAME = "@farming-labs/docs";
@@ -706,7 +706,7 @@ function resolveAskAIContextUrl(value, baseUrl) {
 	}
 }
 function getAskAIPageContent(page) {
-	return upsertPageAgentContractMarkdown(page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent ?? page.content, page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, "").replace(/^\r?\n+/, "");
+	return upsertPageAgentContractMarkdown(page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content, page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, "").replace(/^\r?\n+/, "");
 }
 function getPageAgentContractSearchText(page) {
 	return stripMarkdownText(renderPageAgentContractMarkdown(page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, ""));
@@ -838,12 +838,37 @@ function mergeSearchResults(...groups) {
 	}
 	return results;
 }
-function pageToSearchDocument(page) {
+function sanitizeExternalAgentSearchResults(results, localAgentResults, preserveUnmatched) {
+	const localByKey = new Map(localAgentResults.map((result) => [getSearchResultKey(result), result]));
+	const localPageResults = /* @__PURE__ */ new Map();
+	for (const result of localAgentResults) {
+		const pageUrl = normalizeUrlPathname(result.url);
+		if (!localPageResults.get(pageUrl) || result.type === "page") localPageResults.set(pageUrl, result);
+	}
+	return results.flatMap((result) => {
+		const local = localByKey.get(getSearchResultKey(result)) ?? localPageResults.get(normalizeUrlPathname(result.url));
+		if (!local) return preserveUnmatched?.(result) ? [result] : [];
+		return [{
+			...local,
+			id: result.id,
+			score: result.score ?? local.score
+		}];
+	});
+}
+function getPageAudienceRawContent(page, audience) {
+	if (audience === "agent") return page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
+	return page.rawContent ?? page.content;
+}
+function getPageAudienceSearchText(page, audience) {
+	if (audience === "agent") return page.agentContent ?? page.agentFallbackContent ?? stripMarkdownText(getPageAudienceRawContent(page, audience));
+	return page.content || stripMarkdownText(getPageAudienceRawContent(page, audience));
+}
+function pageToSearchDocument(page, audience = "human") {
 	return {
 		id: makeDocumentId(page.url, "page"),
 		url: page.url,
 		title: page.title,
-		content: normalizeWhitespace([page.content, getPageAgentContractSearchText(page)].join(" ")),
+		content: normalizeWhitespace([getPageAudienceSearchText(page, audience), getPageAgentContractSearchText(page)].join(" ")),
 		description: page.description,
 		type: "page",
 		locale: page.locale,
@@ -852,12 +877,12 @@ function pageToSearchDocument(page) {
 		tags: page.tags
 	};
 }
-function buildExactPageSearchResults(query, pages) {
+function buildExactPageSearchResults(query, pages, audience = "human") {
 	const normalizedQuery = normalizeSearchPhrase(query);
 	if (!normalizedQuery) return [];
 	const results = [];
 	for (const page of pages) {
-		const document = pageToSearchDocument(page);
+		const document = pageToSearchDocument(page, audience);
 		const title = normalizeSearchPhrase(page.title);
 		const urlSegments = getUrlSearchSegments(page.url);
 		if (!(title === normalizedQuery || urlSegments.includes(normalizedQuery))) continue;
@@ -890,9 +915,6 @@ function prioritizeLiteralInsideResults(query, results) {
 		return 0;
 	});
 }
-function shouldSupplementAskAIWithSimpleSearch(search) {
-	return search.enabled && search.provider !== "simple";
-}
 function rankAskAIContextResult(query, result) {
 	return scoreDocument(query, {
 		id: result.id,
@@ -914,8 +936,8 @@ function buildAskAIContextBlock(result) {
 function makeDocumentId(url, suffix) {
 	return `${url}#${suffix}`;
 }
-function splitPageIntoSections(page) {
-	return parseDocsMarkdownSections(page.rawContent ?? page.content).flatMap((section, index) => {
+function splitPageIntoSections(page, audience = "human") {
+	return parseDocsMarkdownSections(getPageAudienceRawContent(page, audience)).flatMap((section, index) => {
 		const content = normalizeWhitespace(stripMarkdownText(section.content));
 		if (!content) return [];
 		return [{
@@ -933,12 +955,12 @@ function splitPageIntoSections(page) {
 		}];
 	});
 }
-function buildDocsSearchDocuments(pages, chunking = {}) {
+function buildDocsSearchDocuments(pages, chunking = {}, audience = "human") {
 	const strategy = chunking.strategy ?? "section";
 	return pages.flatMap((page) => {
-		const base = pageToSearchDocument(page);
+		const base = pageToSearchDocument(page, audience);
 		if (strategy === "page") return [base];
-		const sections = splitPageIntoSections(page);
+		const sections = splitPageIntoSections(page, audience);
 		if (sections.length === 0) return [base];
 		return [...base.content ? [base] : [], ...sections];
 	});
@@ -1522,7 +1544,8 @@ async function maybeSyncSearchIndex(adapter, search, context) {
 async function performDocsSearch(options) {
 	const search = normalizeDocsSearchConfig(options.search);
 	if (!search.enabled) return [];
-	const documents = buildDocsSearchDocuments(options.pages, search.chunking);
+	const audience = options.audience ?? "human";
+	const documents = buildDocsSearchDocuments(options.pages, search.chunking, audience);
 	const context = {
 		pages: options.pages,
 		documents,
@@ -1538,10 +1561,16 @@ async function performDocsSearch(options) {
 	};
 	try {
 		const adapter = await resolveSearchAdapter(search, context);
-		await maybeSyncSearchIndex(adapter, search, context);
+		await maybeSyncSearchIndex(adapter, search, audience === "agent" ? {
+			...context,
+			documents: buildDocsSearchDocuments(options.pages, search.chunking, "human")
+		} : context);
 		const results = await adapter.search(query, context);
 		if (search.provider === "simple") return results;
-		return prioritizeLiteralInsideResults(options.query, mergeSearchResults(buildExactPageSearchResults(options.query, options.pages), results)).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
+		const localAudienceResults = audience === "agent" ? await createSimpleSearchAdapter().search(query, context) : [];
+		const localPagePaths = new Set(options.pages.map((page) => normalizeUrlPathname(page.url)));
+		const safeAdapterResults = audience !== "agent" ? results : sanitizeExternalAgentSearchResults(results, localAudienceResults, search.provider === "mcp" ? (result) => !localPagePaths.has(normalizeUrlPathname(result.url)) : void 0);
+		return prioritizeLiteralInsideResults(options.query, mergeSearchResults(buildExactPageSearchResults(options.query, options.pages, audience), safeAdapterResults, localAudienceResults)).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
 	} catch {
 		return createSimpleSearchAdapter().search(query, context);
 	}
@@ -1551,29 +1580,16 @@ async function buildDocsAskAIContext(options) {
 	const searchLimit = Math.max(limit * 2, limit);
 	const initialSearch = options.search === false ? true : options.search;
 	const primarySearch = normalizeDocsSearchConfig(initialSearch).enabled ? initialSearch : true;
-	const primarySearchConfig = normalizeDocsSearchConfig(primarySearch);
-	const searchResults = mergeSearchResults(await performDocsSearch({
+	const searchResults = await performDocsSearch({
 		pages: options.pages,
 		query: options.query,
 		search: primarySearch,
+		audience: "agent",
 		locale: options.locale,
 		pathname: options.pathname,
 		siteTitle: options.siteTitle,
 		limit: searchLimit
-	}), shouldSupplementAskAIWithSimpleSearch(primarySearchConfig) ? await performDocsSearch({
-		pages: options.pages,
-		query: options.query,
-		search: {
-			provider: "simple",
-			enabled: true,
-			chunking: primarySearchConfig.chunking,
-			maxResults: searchLimit
-		},
-		locale: options.locale,
-		pathname: options.pathname,
-		siteTitle: options.siteTitle,
-		limit: searchLimit
-	}) : []);
+	});
 	const seen = /* @__PURE__ */ new Set();
 	const maxResultChars = options.maxResultChars ?? DEFAULT_ASK_AI_RESULT_CHARS;
 	const rankedResults = searchResults.map((result, index) => {

package/dist/{search-B8cF77_i.mjs → search-vG59kGqo.mjs}

@@ -1,6 +1,6 @@
-import "./agent-DXkXi-pS.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-CEg1omHv.mjs";
-import "./sitemap-server-wsNLyVkb.mjs";
+import "./agent-CxDzPqtl.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-OHp36znm.mjs";
+import "./sitemap-server-zFYctvCa.mjs";
 import "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.mjs";

package/dist/server.d.mts

@@ -1,7 +1,7 @@
 import { $t as McpDocsSearchConfig, At as DocsSearchDocument, C as DocsAgentTraceEventType, D as DocsAnalyticsEventInput, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, Et as DocsSearchAdapterContext, F as DocsAskAIFeedbackMessage, Ft as DocsSearchSourcePage, I as DocsAskAIFeedbackValue, It as DocsSitemapConfig, L as DocsAskAIMcpConfig, Mt as DocsSearchQuery, N as DocsAskAIFeedbackConfig, Nt as DocsSearchResult, P as DocsAskAIFeedbackData, S as DocsAgentTraceEventInput, T as DocsAnalyticsConfig, Tt as DocsSearchAdapter, Z as DocsConfig, a as ApiReferenceRenderer, b as DocsAgentGoldenTaskExpectation, bt as DocsReviewRulesConfig, ht as DocsObservabilityEventInput, kt as DocsSearchConfig, mt as DocsObservabilityEvent, pt as DocsObservabilityConfig, v as DocsAgentGoldenExpectedExample, vt as DocsReviewCiMode, w as DocsAgentTraceStatus, x as DocsAgentGoldenTaskFilters, y as DocsAgentGoldenTask, yt as DocsReviewConfig } from "./types-R-DN23yw.mjs";
 import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-CvRVnwdK.mjs";
 import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as resolveDocsObservabilityConfig, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsAnalyticsConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as getDocsRequestAnalyticsProperties, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-BnQKgDbk.mjs";
+import { A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceId, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, ct as emitDocsObservabilityEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsObservabilityConfig, et as DOCS_AGENT_TRACE_EVENT_TYPES, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as createDocsAgentTraceContext, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, lt as getDocsRequestAnalyticsProperties, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as ResolvedDocsAnalyticsConfig, o as createSimpleSearchAdapter, ot as emitDocsAgentTraceEvent, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as ResolvedDocsObservabilityConfig, s as createTypesenseSearchAdapter, st as emitDocsAnalyticsEvent, t as buildDocsAskAIContext, tt as DocsAgentTraceContext, u as performDocsSearch, ut as resolveDocsAnalyticsConfig, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-9uEaC23e.mjs";
 import { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/code-group-mdx.d.ts

package/dist/server.mjs

@@ -1,7 +1,7 @@
 import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { At as readDocsSitemapManifestFromContentMap, Ct as DEFAULT_SITEMAP_MANIFEST_PATH, Dt as DEFAULT_SITEMAP_XML_ROUTE, Et as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Ft as resolveDocsSitemapRequest, It as toDocsSitemapMarkdownUrl, Mt as renderDocsSitemapXml, Nt as resolveDocsSitemapConfig, Ot as buildDocsSitemapManifest, Pt as resolveDocsSitemapPageLastmod, Tt as DEFAULT_SITEMAP_MD_ROUTE, jt as renderDocsSitemapMarkdown, kt as createDocsSitemapResponse, wt as DEFAULT_SITEMAP_MD_DOCS_ROUTE } from "./agent-DXkXi-pS.mjs";
-import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-CEg1omHv.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-wsNLyVkb.mjs";
+import { At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Bt as toDocsSitemapMarkdownUrl, Dt as DEFAULT_SITEMAP_MANIFEST_PATH, Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, Mt as buildDocsSitemapManifest, Nt as createDocsSitemapResponse, Ot as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Pt as readDocsSitemapManifestFromContentMap, Rt as resolveDocsSitemapPageLastmod, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, zt as resolveDocsSitemapRequest } from "./agent-CxDzPqtl.mjs";
+import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-OHp36znm.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-zFYctvCa.mjs";
 import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
 import { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-1k0q6OAH.mjs";

package/dist/{sitemap-D9ivTLm8.mjs → sitemap-DqxsKlvI.mjs}

@@ -1,6 +1,6 @@
-import { Mt as renderDocsSitemapXml, Nt as resolveDocsSitemapConfig, Ot as buildDocsSitemapManifest, jt as renderDocsSitemapMarkdown } from "./agent-DXkXi-pS.mjs";
-import "./search-CEg1omHv.mjs";
-import "./sitemap-server-wsNLyVkb.mjs";
+import { Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, Mt as buildDocsSitemapManifest } from "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
+import "./sitemap-server-zFYctvCa.mjs";
 import "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.mjs";

package/dist/{sitemap-server-wsNLyVkb.mjs → sitemap-server-zFYctvCa.mjs}

@@ -1,4 +1,4 @@
-import { Nt as resolveDocsSitemapConfig } from "./agent-DXkXi-pS.mjs";
+import { Lt as resolveDocsSitemapConfig } from "./agent-CxDzPqtl.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path, { basename, join, relative } from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.55",
+  "version": "0.2.56",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -48,6 +48,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
+    "@mdx-js/mdx": "^3.1.1",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@scalar/core": "^0.4.3",
     "@vercel/sandbox": "^2.0.0",