@farming-labs/docs 0.2.54 → 0.2.56

package/dist/{mcp-DnxZZWpY.mjs → mcp-BwYAu9DJ.mjs}

@@ -1,6 +1,6 @@
-import "./agent-DXkXi-pS.mjs";
-import "./search-CJIC1Cqo.mjs";
-import "./sitemap-server-wsNLyVkb.mjs";
+import "./agent-CxDzPqtl.mjs";
+import "./search-OHp36znm.mjs";
+import "./sitemap-server-zFYctvCa.mjs";
 import "./agent-evals-BD17jOqL.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./code-blocks-C9awWzEQ.mjs";

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { Ft as DocsSearchSourcePage, Rt as DocsTelemetryConfig, T as DocsAnalyticsConfig, Ut as DocsTelemetryFramework, fn as PageAgentFrontmatter, kt as DocsSearchConfig, nt as DocsMcpAuthPrincipal, ot as DocsMcpConfig, pt as DocsObservabilityConfig, rt as DocsMcpAuthenticate, sn as OrderingItem, tt as DocsMcpAllowedOrigins } from "./types-BVgucdVm.mjs";
+import { Ft as DocsSearchSourcePage, Rt as DocsTelemetryConfig, T as DocsAnalyticsConfig, Ut as DocsTelemetryFramework, fn as PageAgentFrontmatter, kt as DocsSearchConfig, nt as DocsMcpAuthPrincipal, ot as DocsMcpConfig, pt as DocsObservabilityConfig, rt as DocsMcpAuthenticate, sn as OrderingItem, tt as DocsMcpAllowedOrigins } from "./types-R-DN23yw.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

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-CJIC1Cqo.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";
@@ -1522,6 +1522,7 @@ async function createDocsMcpServer(options) {
 	function trackMcpTool(tool, values) {
 		emitDocsTelemetryMcpToolEvent(telemetryConfig, {
 			framework: telemetryFramework,
+			request: options.requestContext?.request,
 			tool,
 			locale: values?.locale,
 			resultCount: values?.resultCount
@@ -2133,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
@@ -2973,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();
 }
@@ -3074,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}`;
@@ -3111,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) {
@@ -3232,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,
@@ -3572,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");
@@ -3795,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);
@@ -3859,6 +3815,7 @@ async function buildDocsMcpContext(options) {
 			maxResults: 50,
 			chunking: { strategy: "section" }
 		},
+		audience: "agent",
 		locale: options.locale,
 		siteTitle: options.siteTitle,
 		limit: 50
@@ -3998,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-B6gyEFkD.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-CJIC1Cqo.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-CfWvmVYA.d.mts → search-9uEaC23e.d.mts}

@@ -1,4 +1,4 @@
-import { $t as McpDocsSearchConfig, An as TypesenseDocsSearchConfig, At as DocsSearchDocument, D as DocsAnalyticsEventInput, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, Ft as DocsSearchSourcePage, It as DocsSitemapConfig, L as DocsAskAIMcpConfig, Nt as DocsSearchResult, Ot as DocsSearchChunkingConfig, S as DocsAgentTraceEventInput, T as DocsAnalyticsConfig, Tt as DocsSearchAdapter, an as OpenDocsTarget, bn as ResolvedDocsRelatedLink, f as CustomDocsSearchConfig, ht as DocsObservabilityEventInput, kt as DocsSearchConfig, mt as DocsObservabilityEvent, nn as OpenDocsProvider, pt as DocsObservabilityConfig, r as AlgoliaDocsSearchConfig } from "./types-BVgucdVm.mjs";
+import { $t as McpDocsSearchConfig, An as TypesenseDocsSearchConfig, At as DocsSearchDocument, D as DocsAnalyticsEventInput, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, Ft as DocsSearchSourcePage, It as DocsSitemapConfig, L as DocsAskAIMcpConfig, Nt as DocsSearchResult, Ot as DocsSearchChunkingConfig, S as DocsAgentTraceEventInput, T as DocsAnalyticsConfig, Tt as DocsSearchAdapter, an as OpenDocsTarget, bn as ResolvedDocsRelatedLink, f as CustomDocsSearchConfig, ht as DocsObservabilityEventInput, kt as DocsSearchConfig, mt as DocsObservabilityEvent, nn as OpenDocsProvider, pt as DocsObservabilityConfig, r as AlgoliaDocsSearchConfig } from "./types-R-DN23yw.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];
@@ -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-CJIC1Cqo.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";
@@ -53,15 +53,42 @@ function readRequestOrigin(request) {
 		return;
 	}
 }
-function normalizeTelemetryOrigin(candidate) {
-	if (!candidate) return void 0;
+/** Normalize an HTTP(S) telemetry site value to its origin. */
+function normalizeDocsTelemetryOrigin(candidate) {
+	if (typeof candidate !== "string") return void 0;
+	const trimmed = candidate.trim();
+	if (!trimmed) return void 0;
 	try {
-		const withProtocol = /^https?:\/\//i.test(candidate) ? candidate : `https://${candidate}`;
-		return new URL(withProtocol).origin;
+		const hasScheme = /^[a-z][a-z\d+.-]*:(?!\d)/i.test(trimmed);
+		const url = new URL(hasScheme ? trimmed : `https://${trimmed}`);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		return url.origin;
 	} catch {
 		return;
 	}
 }
+/** Return whether a telemetry origin points at a local development server. */
+function isLocalDocsTelemetryOrigin(candidate) {
+	const origin = normalizeDocsTelemetryOrigin(candidate);
+	if (!origin) return false;
+	const hostname = new URL(origin).hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.+$/, "");
+	if ([
+		"localhost",
+		"localhost.localdomain",
+		"localhost6",
+		"localhost6.localdomain6",
+		"ip6-localhost",
+		"ip6-loopback"
+	].includes(hostname) || hostname.endsWith(".localhost")) return true;
+	if (hostname === "::" || hostname === "::1") return true;
+	const ipv4 = hostname.split(".").map((part) => Number(part));
+	if (ipv4.length === 4 && ipv4.every((part) => Number.isInteger(part) && part >= 0 && part <= 255)) return ipv4[0] === 127 || ipv4.every((part) => part === 0);
+	return /^::ffff:7f[0-9a-f]{2}:/.test(hostname) || hostname === "::ffff:0:0";
+}
+function isBlockedDocsTelemetryOrigin(candidate) {
+	if (candidate === void 0) return false;
+	return !normalizeDocsTelemetryOrigin(candidate) || isLocalDocsTelemetryOrigin(candidate);
+}
 function readDeploymentOrigin() {
 	const candidates = [
 		readRuntimeEnv("DOCS_SITE_URL"),
@@ -75,7 +102,7 @@ function readDeploymentOrigin() {
 		readRuntimeEnv("DEPLOY_PRIME_URL")
 	];
 	for (const candidate of candidates) {
-		const origin = normalizeTelemetryOrigin(candidate);
+		const origin = normalizeDocsTelemetryOrigin(candidate);
 		if (origin) return origin;
 	}
 }
@@ -158,7 +185,15 @@ function getDocsTelemetryFeatures(config) {
 }
 function createDocsTelemetryEvent(config, input, context = {}) {
 	const telemetryConfig = config.telemetry && typeof config.telemetry === "object" ? config.telemetry : void 0;
-	const siteOrigin = context.siteOrigin ?? input.site?.origin ?? normalizeTelemetryOrigin(telemetryConfig?.siteOrigin) ?? readRequestOrigin(context.request) ?? readDeploymentOrigin();
+	const siteOriginCandidates = [
+		context.siteOrigin,
+		input.site?.origin,
+		telemetryConfig?.siteOrigin,
+		readRequestOrigin(context.request),
+		readDeploymentOrigin()
+	];
+	if (siteOriginCandidates.some(isBlockedDocsTelemetryOrigin)) return void 0;
+	const siteOrigin = siteOriginCandidates.map(normalizeDocsTelemetryOrigin).find((origin) => Boolean(origin));
 	const deployment = input.deployment ?? detectDeployment();
 	const properties = context.properties || input.properties ? {
 		...input.properties,
@@ -206,7 +241,13 @@ function pruneSentProjectKeys(sent, now) {
 }
 async function emitDocsTelemetryEvent(telemetry, event) {
 	const resolved = resolveDocsTelemetryConfig(telemetry);
-	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function") return;
+	const eventSiteOrigin = event.site?.origin;
+	const normalizedSiteOrigin = normalizeDocsTelemetryOrigin(eventSiteOrigin);
+	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function" || eventSiteOrigin !== void 0 && (!normalizedSiteOrigin || isLocalDocsTelemetryOrigin(eventSiteOrigin))) return;
+	const eventToSend = normalizedSiteOrigin ? {
+		...event,
+		site: { origin: normalizedSiteOrigin }
+	} : event;
 	try {
 		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
 		const headers = { "content-type": "application/json" };
@@ -214,13 +255,14 @@ async function emitDocsTelemetryEvent(telemetry, event) {
 		await fetch(resolved.endpoint, {
 			method: "POST",
 			headers,
-			body: JSON.stringify({ event }),
+			body: JSON.stringify({ event: eventToSend }),
 			keepalive: true
 		});
 	} catch {}
 }
 function emitDocsTelemetryProjectEvent(config, context = {}) {
 	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
+	if (!event) return;
 	const key = projectEventKey(event);
 	const sent = getSentProjectKeys();
 	const now = Date.now();
@@ -236,6 +278,7 @@ function emitDocsTelemetryAgentSurfaceEvent(config, context) {
 		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
 		properties: { surface: context.surface }
 	}, context);
+	if (!event) return;
 	emitDocsTelemetryEvent(config.telemetry, event);
 }
 function emitDocsTelemetryMcpToolEvent(config, context) {
@@ -247,6 +290,7 @@ function emitDocsTelemetryMcpToolEvent(config, context) {
 			resultCount: context.resultCount
 		}
 	}, context);
+	if (!event) return;
 	emitDocsTelemetryEvent(config.telemetry, event);
 }
 function inferDocsTelemetryAgentSurface(request, options) {
@@ -662,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, ""));
@@ -794,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,
@@ -808,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;
@@ -846,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,
@@ -870,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 [{
@@ -889,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];
 	});
@@ -1478,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,
@@ -1494,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);
 	}
@@ -1507,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) => {
@@ -1584,4 +1644,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { getDocsTelemetryFeatures as A, resolvePageSidebarFolderIndexBehavior as C, emitDocsTelemetryEvent as D, emitDocsTelemetryAgentSurfaceEvent as E, resolveDocsTelemetryConfig as M, emitDocsTelemetryMcpToolEvent as O, applySidebarFolderIndexBehavior as S, resolveSidebarFolderIndexBehaviorForPath as T, hashGeneratedAgentContent as _, createMcpSearchAdapter as a, serializeGeneratedAgentDocument as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, GENERATED_AGENT_PROVENANCE_VERSION as g, GENERATED_AGENT_PROVENANCE_MARKER as h, createCustomSearchAdapter as i, inferDocsTelemetryAgentSurface as j, emitDocsTelemetryProjectEvent as k, inferDocsAskAIPackageHints as l, parseDocsMarkdownSections as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, findDocsMarkdownSection as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, normalizeGeneratedAgentContent as v, resolveSidebarFolderIndexBehavior as w, stripGeneratedAgentProvenance as x, parseGeneratedAgentDocument as y };
+export { getDocsTelemetryFeatures as A, resolvePageSidebarFolderIndexBehavior as C, emitDocsTelemetryEvent as D, emitDocsTelemetryAgentSurfaceEvent as E, isLocalDocsTelemetryOrigin as M, normalizeDocsTelemetryOrigin as N, emitDocsTelemetryMcpToolEvent as O, resolveDocsTelemetryConfig as P, applySidebarFolderIndexBehavior as S, resolveSidebarFolderIndexBehaviorForPath as T, hashGeneratedAgentContent as _, createMcpSearchAdapter as a, serializeGeneratedAgentDocument as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, GENERATED_AGENT_PROVENANCE_VERSION as g, GENERATED_AGENT_PROVENANCE_MARKER as h, createCustomSearchAdapter as i, inferDocsTelemetryAgentSurface as j, emitDocsTelemetryProjectEvent as k, inferDocsAskAIPackageHints as l, parseDocsMarkdownSections as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, findDocsMarkdownSection as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, normalizeGeneratedAgentContent as v, resolveSidebarFolderIndexBehavior as w, stripGeneratedAgentProvenance as x, parseGeneratedAgentDocument as y };

package/dist/{search-CbPm2x5g.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-CJIC1Cqo.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";