@farming-labs/docs 0.2.72 → 0.2.73

package/dist/{mcp-BNK45dzD.mjs → mcp-BLLXvEXB.mjs}

@@ -1,13 +1,14 @@
-import "./agent-pS2nNQS3.mjs";
-import { I as resolveDocsPublishedAgentSkill } from "./standards-discovery-CYfiQE13.mjs";
-import "./search-BbArHODP.mjs";
-import "./sitemap-server-PUoOhplO.mjs";
-import "./agent-evals-CjYzCQMZ.mjs";
+import "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import { L as resolveDocsPublishedAgentSkill } from "./standards-discovery-BwL5ffGx.mjs";
+import "./search-RfPcG1if.mjs";
+import "./sitemap-server-VefDnzEB.mjs";
+import "./agent-evals-BFHGypqh.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-BPVv4gMg.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-z7_R0f86.mjs";
+import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/mcp.d.mts

@@ -1,5 +1,5 @@
-import { Ft as DocsMcpAuthenticate, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Qn as PageAgentFrontmatter, Rt as DocsMcpConfig, cn as DocsSearchConfig, kn as DocsTelemetryFramework, qn as OrderingItem, rt as DocsAnalyticsConfig, wn as DocsTelemetryConfig, yn as DocsSearchSourcePage } from "./types-B9DNNAdT.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-DRJ10g7B.mjs";
+import { Ft as DocsMcpAuthenticate, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Qn as PageAgentFrontmatter, Rt as DocsMcpConfig, cn as DocsSearchConfig, kn as DocsTelemetryFramework, qn as OrderingItem, rt as DocsAnalyticsConfig, wn as DocsTelemetryConfig, yn as DocsSearchSourcePage } from "./types-_HCPD4wc.mjs";
+import { L as DocsPublishedAgentSkill } from "./standards-discovery-83lp1lew.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/mcp.mjs

@@ -1,7 +1,8 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { At as resolveDocsAudienceMdxContent, Gt as findDocsMarkdownSection, Jt as renderDocsRelatedMarkdownLines, Kt as parseDocsMarkdownSections, Sn as resolveDocsMcpResourceLocation, bn as normalizeDocsMcpEndpointPath, gn as isDocsMcpProtectedResourceMetadataPath, hn as isDocsMcpOAuthScopeToken, nn as normalizePageAgentFrontmatter, on as upsertPageAgentContractMarkdown, qt as normalizeDocsRelated, tn as hasStructuredPageAgentContract, vn as isDocsMcpResourcePath, xn as resolveDocsMcpProtectedResourceMetadataLocation, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-pS2nNQS3.mjs";
-import "./standards-discovery-CYfiQE13.mjs";
-import { A as stripGeneratedAgentProvenance, F as emitDocsTelemetryAgentSurfaceEvent, L as emitDocsTelemetryMcpToolEvent, M as resolvePageSidebarFolderIndexBehavior, R as emitDocsTelemetryProjectEvent, S as normalizeAgentScopeValues, b as normalizeAgentFramework, d as performDocsSearch, f as performDocsSearchWithMetadata, u as normalizeDocsSearchFilters, v as agentVersionConstraintMatches, x as normalizeAgentLocale, y as agentVersionConstraintsOverlap } from "./search-BbArHODP.mjs";
+import { Kt as normalizeDocsRelated, an as isDocsMcpResourcePath, cn as resolveDocsMcpProtectedResourceMetadataLocation, jt as resolveDocsAudienceMdxContent, ln as resolveDocsMcpResourceLocation, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, qt as renderDocsRelatedMarkdownLines, rn as isDocsMcpProtectedResourceMetadataPath, sn as normalizeDocsMcpEndpointPath } from "./agent-o9OTadrf.mjs";
+import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import { A as stripGeneratedAgentProvenance, F as emitDocsTelemetryAgentSurfaceEvent, L as emitDocsTelemetryMcpToolEvent, M as resolvePageSidebarFolderIndexBehavior, R as emitDocsTelemetryProjectEvent, S as normalizeAgentScopeValues, b as normalizeAgentFramework, d as performDocsSearch, f as performDocsSearchWithMetadata, u as normalizeDocsSearchFilters, v as agentVersionConstraintMatches, x as normalizeAgentLocale, y as agentVersionConstraintsOverlap } from "./search-RfPcG1if.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -3198,11 +3199,10 @@ async function createDocsMcpServer(options) {
 				};
 			}
 			const fullDocument = renderPageDocument(page);
-			const sectionDocument = getDocsMcpSourceMarkdown(page);
-			const selectedSection = section ? findDocsMarkdownSection(sectionDocument, section) ?? (sectionDocument !== fullDocument ? findDocsMarkdownSection(fullDocument, section) : void 0) : void 0;
+			const sectionDocument = upsertPageAgentContractMarkdown(getDocsMcpSourceMarkdown(page), page.agent);
+			const selectedSection = section ? findDocsMarkdownSection(sectionDocument, section) : void 0;
 			if (section && !selectedSection) {
-				const sourceSections = parseDocsMarkdownSections(sectionDocument);
-				const availableSections = (sourceSections.length > 0 ? sourceSections : parseDocsMarkdownSections(fullDocument)).map((item) => ({
+				const availableSections = parseDocsMarkdownSections(sectionDocument).map((item) => ({
 					title: item.title,
 					anchor: item.anchor
 				}));
@@ -4613,7 +4613,8 @@ function getDocsMcpResultPageUrl(value) {
 	return value.split("#", 1)[0] ?? value;
 }
 function getDocsMcpResultAnchor(value) {
-	const anchor = value.split("#", 2)[1];
+	const hashIndex = value.indexOf("#");
+	const anchor = hashIndex >= 0 ? value.slice(hashIndex + 1) : "";
 	if (!anchor) return void 0;
 	try {
 		return decodeURIComponent(anchor);
@@ -4695,7 +4696,7 @@ async function buildDocsMcpContext(options) {
 	let usedUtf8Bytes = 0;
 	for (const { result, page, scope, selectedSection, rawContent } of resolvedCandidates) {
 		const anchor = selectedSection?.anchor;
-		const sourceUrl = anchor ? `${page.url}#${anchor}` : page.url;
+		const sourceUrl = anchor ? `${page.url.split("#", 1)[0]}#${encodeURIComponent(anchor)}` : page.url;
 		const headerLines = [`## ${page.title}`, `Source: ${sourceUrl}`];
 		if (selectedSection?.title) headerLines.push(`Section: ${selectedSection.title}`);
 		if (scope.framework) headerLines.push(`Framework: ${scope.framework}`);

package/dist/{metadata-D6qlWDu-.mjs → metadata-N252j5_a.mjs}

@@ -1,4 +1,4 @@
-import { nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-pS2nNQS3.mjs";
+import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 
 //#region src/metadata.ts
 /**

package/dist/{package-version-BXHcIm1T.mjs → package-version-n5AFur8a.mjs}

@@ -1,4 +1,4 @@
-import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-C4RC8Zq_.mjs";
+import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-DpiIioYb.mjs";
 import pc from "picocolors";
 import * as p from "@clack/prompts";
 

package/dist/{reading-time-DvTuW2Iy.mjs → prompt-references-Cz35rlOa.mjs}

@@ -1,7 +1,7 @@
-import { Ft as DEFAULT_SITEMAP_XML_ROUTE, Nt 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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-pS2nNQS3.mjs";
+import { It as DEFAULT_SITEMAP_XML_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_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, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-o9OTadrf.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-CYfiQE13.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-C2SindI5.mjs";
+import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-BwL5ffGx.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BcuxnZqZ.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts
@@ -683,6 +683,7 @@ function validateAgentManifest(content) {
 	const issues = [];
 	if (root?.$schema !== DOCS_AGENT_MANIFEST_SCHEMA_URI) issues.push(`Agent manifest did not declare top-level $schema ${DOCS_AGENT_MANIFEST_SCHEMA_URI}`);
 	if (root?.format !== DOCS_AGENT_MANIFEST_FORMAT) issues.push(`Agent manifest did not declare top-level format ${DOCS_AGENT_MANIFEST_FORMAT}`);
+	if (root?.version !== DOCS_AGENT_MANIFEST_VERSION) issues.push(`Agent manifest did not declare top-level version ${DOCS_AGENT_MANIFEST_VERSION}`);
 	return issues;
 }
 function httpLinkMatchesContractExpectation(header, expectation, responseUrl) {
@@ -909,4 +910,157 @@ function resolveReadingTimeFromSource(source, wordsPerMinute, options) {
 }
 
 //#endregion
-export { resolveReadingTimeOptions as a, runDocsAgentConformance as c, readAgentSkillDocumentFromTar as d, createTheme as f, defineDocs as g, resolveChangelogConfig as h, resolveReadingTimeFromSource as i, httpLinkHeaderHasTargetRelation as l, deepMerge as m, resolvePageReadingTime as n, DOCS_AGENT_CONTRACT_VERSION as o, extendTheme as p, resolveReadingTimeFromContent as r, createDocsAgentContractCases as s, estimateReadingTimeMinutes as t, AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES as u };
+//#region src/heading-toc.ts
+/**
+* Encode heading fragments emitted by a renderer's nested table of contents.
+*
+* Fumadocs stores fragment URLs as raw DOM ids. Encoding the fragment after its
+* heading visitor runs keeps links valid without changing path prefixes.
+*/
+function encodeDocsHeadingTocUrls(value) {
+	if (Array.isArray(value)) {
+		for (const item of value) encodeDocsHeadingTocUrls(item);
+		return;
+	}
+	if (!value || typeof value !== "object") return;
+	const item = value;
+	if (typeof item.url === "string") {
+		const hashIndex = item.url.indexOf("#");
+		if (hashIndex >= 0) item.url = `${item.url.slice(0, hashIndex)}#${encodeURIComponent(item.url.slice(hashIndex + 1))}`;
+	}
+	encodeDocsHeadingTocUrls(item.children);
+}
+
+//#endregion
+//#region src/prompt-references.ts
+function isDocsMarkdownPromptNode(node) {
+	return (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.name === "Prompt";
+}
+function normalizeDocsMarkdownReferenceIdentifier(value) {
+	return typeof value === "string" ? value.trim().replace(/\s+/gu, " ").toLowerCase() : "";
+}
+function readDocsMarkdownPromptReferenceSource(value) {
+	const source = typeof value === "string" ? value : value instanceof Uint8Array ? new TextDecoder().decode(value) : void 0;
+	if (source === void 0) return void 0;
+	return source.startsWith("") ? source.slice(1) : source;
+}
+function sliceDocsMarkdownPromptReferenceSource(node, source) {
+	if (source === void 0) return void 0;
+	const start = node.position?.start?.offset;
+	const end = node.position?.end?.offset;
+	if (typeof start !== "number" || typeof end !== "number" || !Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end < start || end > source.length) return;
+	return source.slice(start, end);
+}
+function sliceDocsMarkdownPromptChildrenSource(node, source) {
+	const nodeSource = sliceDocsMarkdownPromptReferenceSource(node, source);
+	if (nodeSource === void 0) return void 0;
+	const closingStart = nodeSource.lastIndexOf("</Prompt");
+	if (closingStart < 0) return void 0;
+	const children = node.children ?? [];
+	const isolatedChild = children.length === 1 ? children[0] : void 0;
+	if (isolatedChild?.type === "text" && typeof isolatedChild.value === "string" && isolatedChild.position === void 0) return isolatedChild.value;
+	const nodeStart = node.position?.start?.offset;
+	if (typeof nodeStart !== "number") return void 0;
+	let firstChildStart;
+	for (const child of children) {
+		const childStart = child.position?.start?.offset;
+		if (typeof childStart === "number" && Number.isInteger(childStart) && childStart >= nodeStart && (firstChildStart === void 0 || childStart - nodeStart < firstChildStart)) firstChildStart = childStart - nodeStart;
+	}
+	if (children.length > 0 && firstChildStart === void 0) return void 0;
+	const openingEnd = nodeSource.lastIndexOf(">", (firstChildStart ?? closingStart) - 1);
+	if (openingEnd < 0 || openingEnd >= closingStart) return void 0;
+	return nodeSource.slice(openingEnd + 1, closingStart);
+}
+function flattenDocsMarkdownPromptReferenceNode(node) {
+	if (typeof node.value === "string") return node.value;
+	return (node.children ?? []).map((child) => flattenDocsMarkdownPromptReferenceNode(child)).join("");
+}
+function formatDocsMarkdownPromptReference(node) {
+	const image = node.type === "imageReference";
+	const visibleLabel = image ? typeof node.alt === "string" ? node.alt : "" : flattenDocsMarkdownPromptReferenceNode(node);
+	const referenceLabel = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : visibleLabel;
+	const prefix = image ? "!" : "";
+	if (node.referenceType === "collapsed") return `${prefix}[${visibleLabel}][]`;
+	if (node.referenceType === "shortcut") return `${prefix}[${visibleLabel}]`;
+	return `${prefix}[${visibleLabel}][${referenceLabel}]`;
+}
+function formatDocsMarkdownPromptDefinition(node) {
+	const label = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : "";
+	const rawUrl = typeof node.url === "string" ? node.url : "";
+	return `[${label}]: ${/[<>\s]/u.test(rawUrl) ? `<${rawUrl.replace(/>/gu, "\\>")}>` : rawUrl}${typeof node.title === "string" ? ` "${node.title.replace(/"/gu, "\\\"")}"` : ""}`;
+}
+function createDocsMarkdownPromptReferenceText(node, source) {
+	return {
+		type: "text",
+		value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptReference(node),
+		position: node.position
+	};
+}
+function createDocsMarkdownPromptDefinitionParagraph(node, source) {
+	return {
+		type: "paragraph",
+		children: [{
+			type: "text",
+			value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptDefinition(node),
+			position: node.position
+		}],
+		position: node.position
+	};
+}
+/**
+* Keep `<Prompt>` children literal before Markdown reference definitions are
+* resolved by the MDX compiler.
+*
+* Definitions inside Prompt are copyable source, not page-level definitions.
+* References inside Prompt always remain source text, while references outside
+* Prompt only remain live when they have a definition outside Prompt.
+*/
+function isolateDocsMarkdownPromptReferences(root, value) {
+	if (!root || typeof root !== "object") return;
+	const source = readDocsMarkdownPromptReferenceSource(value);
+	const promptDefinitions = /* @__PURE__ */ new Set();
+	const pageDefinitions = /* @__PURE__ */ new Set();
+	let hasPrompt = false;
+	const collectDefinitions = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		const literal = insidePrompt || prompt;
+		if (prompt) hasPrompt = true;
+		if (node.type === "definition") {
+			const identifier = normalizeDocsMarkdownReferenceIdentifier(node.identifier);
+			if (identifier) (literal ? promptDefinitions : pageDefinitions).add(identifier);
+		}
+		for (const child of node.children ?? []) collectDefinitions(child, literal);
+	};
+	collectDefinitions(root, false);
+	if (!hasPrompt) return;
+	const isolateReferences = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		if (prompt) {
+			const promptSource = sliceDocsMarkdownPromptChildrenSource(node, source);
+			if (promptSource !== void 0) {
+				node.children = [{
+					type: "text",
+					value: promptSource
+				}];
+				return;
+			}
+		}
+		const literal = insidePrompt || prompt;
+		const children = node.children;
+		if (!children) return;
+		node.children = children.map((child) => {
+			const childInsidePrompt = literal || isDocsMarkdownPromptNode(child);
+			if (childInsidePrompt && child.type === "definition") return createDocsMarkdownPromptDefinitionParagraph(child, source);
+			if (child.type === "linkReference" || child.type === "imageReference") {
+				const identifier = normalizeDocsMarkdownReferenceIdentifier(child.identifier);
+				if (childInsidePrompt || promptDefinitions.has(identifier) && !pageDefinitions.has(identifier)) return createDocsMarkdownPromptReferenceText(child, source);
+			}
+			isolateReferences(child, childInsidePrompt);
+			return child;
+		});
+	};
+	isolateReferences(root, false);
+}
+
+//#endregion
+export { resolveChangelogConfig as _, resolveReadingTimeFromContent as a, DOCS_AGENT_CONTRACT_VERSION as c, httpLinkHeaderHasTargetRelation as d, AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES as f, deepMerge as g, extendTheme as h, resolvePageReadingTime as i, createDocsAgentContractCases as l, createTheme as m, encodeDocsHeadingTocUrls as n, resolveReadingTimeFromSource as o, readAgentSkillDocumentFromTar as p, estimateReadingTimeMinutes as r, resolveReadingTimeOptions as s, isolateDocsMarkdownPromptReferences as t, runDocsAgentConformance as u, defineDocs as v };

package/dist/{review-Cace7A2c.mjs → review-DaJLdPLh.mjs}

@@ -1,13 +1,14 @@
-import { A as buildDocsAgentDiscoverySpec, Et as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Xt as PAGE_AGENT_CONTRACT_FIELDS, en as getPageAgentFrontmatterIssues, fn as getDocsMcpProtectedResourceMetadataRoutes, nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-pS2nNQS3.mjs";
-import { F as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-CYfiQE13.mjs";
-import { p as resolveAskAISearchRequestConfig } from "./search-BbArHODP.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-D6qlWDu-.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-CjYzCQMZ.mjs";
+import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-o9OTadrf.mjs";
+import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
+import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-BwL5ffGx.mjs";
+import { p as resolveAskAISearchRequestConfig } from "./search-RfPcG1if.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BFHGypqh.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-z7_R0f86.mjs";
-import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DGg_eHIY.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CloP0pAe.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-C2SindI5.mjs → robots-BcuxnZqZ.mjs}

@@ -1,5 +1,5 @@
-import { S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as resolveDocsSitemapConfig, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_ROUTE, et as normalizeDocsPathSegment, 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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-pS2nNQS3.mjs";
-import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
+import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, 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, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-o9OTadrf.mjs";
+import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";

package/dist/{robots-DmE_wXvG.mjs → robots-DI-9MZz1.mjs}

@@ -1,8 +1,9 @@
-import "./agent-pS2nNQS3.mjs";
-import "./standards-discovery-CYfiQE13.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-C2SindI5.mjs";
-import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-z7_R0f86.mjs";
-import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
+import "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.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-BcuxnZqZ.mjs";
+import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{search-1aftosa5.d.mts → search-D1n8Sf25.d.mts}

@@ -1,5 +1,5 @@
-import { Gn as OpenDocsTarget, Hn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Sn as DocsSitemapConfig, _n as DocsSearchResult, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchFilterInput, gn as DocsSearchResponse, gr as TypesenseDocsSearchConfig, hn as DocsSearchRequest, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, on as DocsSearchAdapterFactory, or as ResolvedDocsRelatedLink, pn as DocsSearchFilters, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig, yn as DocsSearchSourcePage, zn as McpDocsSearchConfig } from "./types-B9DNNAdT.mjs";
-import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-DRJ10g7B.mjs";
+import { Gn as OpenDocsTarget, Hn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Sn as DocsSitemapConfig, _n as DocsSearchResult, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchFilterInput, gn as DocsSearchResponse, gr as TypesenseDocsSearchConfig, hn as DocsSearchRequest, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, on as DocsSearchAdapterFactory, or as ResolvedDocsRelatedLink, pn as DocsSearchFilters, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig, yn as DocsSearchSourcePage, zn as McpDocsSearchConfig } from "./types-_HCPD4wc.mjs";
+import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-83lp1lew.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"];
@@ -35,11 +35,32 @@ declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabil
 type DocsContentAudience = "human" | "agent";
 /** Resolve whether content with an optional audience restriction is visible. */
 declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
+interface DocsMarkdownPromptBlock {
+  /** Raw JSX attributes between the Prompt name and opening bracket. */
+  attributes: string;
+  /** Literal source between the Prompt tags, with enclosing Markdown container prefixes removed. */
+  children: string;
+  /** Collision-safe placeholder carried through document-level rendering. */
+  token: string;
+}
+interface ExtractedDocsMarkdownPromptBlocks {
+  blocks: DocsMarkdownPromptBlock[];
+  markdown: string;
+}
 interface DocsAudienceMdxIssue {
   code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
   index: number;
   message: string;
 }
+/**
+ * Extract live MDX Prompt blocks while leaving Markdown literals untouched.
+ *
+ * Prompt bodies are copyable source, so callers can safely run audience,
+ * reference-definition, and heading passes over `markdown`, then restore each
+ * block from its token. Fences (including container fences), inline code, links,
+ * comments, raw elements, and other literal contexts are never extracted.
+ */
+declare function extractDocsMarkdownPromptBlocks(content: string): ExtractedDocsMarkdownPromptBlocks;
 /** Find audience declarations that cannot be projected consistently at build time. */
 declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
 /**
@@ -291,4 +312,4 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { serializeOpenDocsProviders as $, createDocsSitemapResponse as A, DEFAULT_OPEN_DOCS_TARGET as B, DEFAULT_SITEMAP_XML_ROUTE as C, DocsSitemapPageInput as D, DocsSitemapManifestPage as E, resolveDocsSitemapPageLastmod as F, SerializedOpenDocsProvider as G, PromptAction as H, resolveDocsSitemapRequest as I, resolvePromptProviderChoices as J, normalizePromptProviderName as K, toDocsSitemapMarkdownUrl as L, renderDocsSitemapMarkdown as M, renderDocsSitemapXml as N, DocsSitemapResolvedConfig as O, resolveDocsSitemapConfig as P, serializeOpenDocsProvider as Q, DEFAULT_OPEN_DOCS_PROMPT as R, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as S, DocsSitemapManifest as T, PromptProviderChoice as U, DEFAULT_PROMPT_PROVIDER_TEMPLATES as V, SerializeOpenDocsProviderOptions as W, serializeDocsIcon as X, sanitizePromptText as Y, serializeDocsIconRegistry as Z, resolveDocsSearchRequest as _, resolveDocsObservabilityConfig as _t, createCustomSearchAdapter as a, resolveDocsAudienceMdxContent as at, DEFAULT_SITEMAP_MD_DOCS_ROUTE as b, createTypesenseSearchAdapter as c, ResolvedDocsAnalyticsConfig as ct, normalizeDocsSearchFilters as d, createDocsAgentTraceId as dt, DocsAudienceMdxIssue as et, performDocsSearch as f, emitDocsAgentTraceEvent as ft, resolveDocsSearchFilters as g, resolveDocsAnalyticsConfig as gt, resolveDocsSearchAudience as h, getDocsRequestAnalyticsProperties as ht, createAlgoliaSearchAdapter as i, resolveDocsAudienceExposure as it, readDocsSitemapManifestFromContentMap as j, buildDocsSitemapManifest as k, formatDocsAskAIPackageHints as l, ResolvedDocsObservabilityConfig as lt, resolveAskAISearchRequestConfig as m, emitDocsObservabilityEvent as mt, buildDocsAskAIContext as n, findDocsAudienceMdxIssues as nt, createMcpSearchAdapter as o, DOCS_AGENT_TRACE_EVENT_TYPES as ot, performDocsSearchWithMetadata as p, emitDocsAnalyticsEvent as pt, parsePromptStringArray as q, buildDocsSearchDocuments as r, resolveDocsAgentMdxContent as rt, createSimpleSearchAdapter as s, DocsAgentTraceContext as st, PerformDocsSearchOptions as t, DocsContentAudience as tt, inferDocsAskAIPackageHints as u, createDocsAgentTraceContext as ut, resolveSearchRequestConfig as v, DocsSitemapFormat as w, DEFAULT_SITEMAP_MD_ROUTE as x, DEFAULT_SITEMAP_MANIFEST_PATH as y, DEFAULT_OPEN_DOCS_PROVIDER_IDS as z };
+export { serializeOpenDocsProviders as $, createDocsSitemapResponse as A, DEFAULT_OPEN_DOCS_TARGET as B, DEFAULT_SITEMAP_XML_ROUTE as C, DocsSitemapPageInput as D, DocsSitemapManifestPage as E, resolveDocsSitemapPageLastmod as F, SerializedOpenDocsProvider as G, PromptAction as H, resolveDocsSitemapRequest as I, resolvePromptProviderChoices as J, normalizePromptProviderName as K, toDocsSitemapMarkdownUrl as L, renderDocsSitemapMarkdown as M, renderDocsSitemapXml as N, DocsSitemapResolvedConfig as O, resolveDocsSitemapConfig as P, serializeOpenDocsProvider as Q, DEFAULT_OPEN_DOCS_PROMPT as R, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as S, DocsSitemapManifest as T, PromptProviderChoice as U, DEFAULT_PROMPT_PROVIDER_TEMPLATES as V, SerializeOpenDocsProviderOptions as W, serializeDocsIcon as X, sanitizePromptText as Y, serializeDocsIconRegistry as Z, resolveDocsSearchRequest as _, emitDocsObservabilityEvent as _t, createCustomSearchAdapter as a, findDocsAudienceMdxIssues as at, DEFAULT_SITEMAP_MD_DOCS_ROUTE as b, resolveDocsObservabilityConfig as bt, createTypesenseSearchAdapter as c, resolveDocsAudienceMdxContent as ct, normalizeDocsSearchFilters as d, ResolvedDocsAnalyticsConfig as dt, DocsAudienceMdxIssue as et, performDocsSearch as f, ResolvedDocsObservabilityConfig as ft, resolveDocsSearchFilters as g, emitDocsAnalyticsEvent as gt, resolveDocsSearchAudience as h, emitDocsAgentTraceEvent as ht, createAlgoliaSearchAdapter as i, extractDocsMarkdownPromptBlocks as it, readDocsSitemapManifestFromContentMap as j, buildDocsSitemapManifest as k, formatDocsAskAIPackageHints as l, DOCS_AGENT_TRACE_EVENT_TYPES as lt, resolveAskAISearchRequestConfig as m, createDocsAgentTraceId as mt, buildDocsAskAIContext as n, DocsMarkdownPromptBlock as nt, createMcpSearchAdapter as o, resolveDocsAgentMdxContent as ot, performDocsSearchWithMetadata as p, createDocsAgentTraceContext as pt, parsePromptStringArray as q, buildDocsSearchDocuments as r, ExtractedDocsMarkdownPromptBlocks as rt, createSimpleSearchAdapter as s, resolveDocsAudienceExposure as st, PerformDocsSearchOptions as t, DocsContentAudience as tt, inferDocsAskAIPackageHints as u, DocsAgentTraceContext as ut, resolveSearchRequestConfig as v, getDocsRequestAnalyticsProperties as vt, DocsSitemapFormat as w, DEFAULT_SITEMAP_MD_ROUTE as x, DEFAULT_SITEMAP_MANIFEST_PATH as y, resolveDocsAnalyticsConfig as yt, DEFAULT_OPEN_DOCS_PROVIDER_IDS as z };

package/dist/{search-DB3svkNQ.mjs → search-DeOJiMAy.mjs}

@@ -1,13 +1,14 @@
-import "./agent-pS2nNQS3.mjs";
-import "./standards-discovery-CYfiQE13.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-BbArHODP.mjs";
-import "./sitemap-server-PUoOhplO.mjs";
-import "./agent-evals-CjYzCQMZ.mjs";
+import "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-RfPcG1if.mjs";
+import "./sitemap-server-VefDnzEB.mjs";
+import "./agent-evals-BFHGypqh.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import "./agent-skills-server-BPVv4gMg.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-z7_R0f86.mjs";
+import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-Wcdj-D0a.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/{search-BbArHODP.mjs → search-RfPcG1if.mjs}

@@ -1,4 +1,5 @@
-import { At as resolveDocsAudienceMdxContent, G as isDocsAgentDiscoveryRequest, Gt as findDocsMarkdownSection, K as isDocsAgentsRequest, Kt as parseDocsMarkdownSections, Q as isDocsSkillRequest, Qt as PAGE_AGENT_CONTRACT_START_MARKER, Yt as PAGE_AGENT_CONTRACT_END_MARKER, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, on as upsertPageAgentContractMarkdown, pt as resolveDocsLlmsTxtRequest, rn as renderPageAgentContractMarkdown, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-pS2nNQS3.mjs";
+import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, jt as resolveDocsAudienceMdxContent, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-o9OTadrf.mjs";
+import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
 
 //#region src/telemetry.ts
 const DOCS_PACKAGE_NAME = "@farming-labs/docs";
@@ -1044,8 +1045,14 @@ function resolveAskAIContextUrl(value, baseUrl) {
 		return value;
 	}
 }
+function cleanGeneratedAgentContractMarkers(content) {
+	return stripDocsGeneratedAgentContractMarkers(content);
+}
+function getAskAIPageSectionContent(page) {
+	return getPageAudienceSectionContent(page, "agent");
+}
 function getAskAIPageContent(page) {
-	return upsertPageAgentContractMarkdown(getPageAudienceRawContent(page, "agent"), page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, "").replace(/^\r?\n+/, "");
+	return cleanGeneratedAgentContractMarkers(getAskAIPageSectionContent(page));
 }
 function getPageAgentContractSearchText(page) {
 	return stripMarkdownText(renderPageAgentContractMarkdown(page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, ""));
@@ -1145,7 +1152,7 @@ function formatAskAIContextResult(options) {
 	const title = inferResultTitle(result, page);
 	const section = result.section;
 	const sectionSelector = getSearchResultAnchor(result.url) ?? section;
-	const contextContent = clampText(cleanAskAIContextMarkdown(page ? sectionSelector ? findDocsMarkdownSection(getAskAIPageContent(page), sectionSelector)?.content ?? "" : getAskAIPageContent(page) : [result.content, result.description].filter(Boolean).join("\n\n")), maxChars);
+	const contextContent = clampText(cleanAskAIContextMarkdown(page ? sectionSelector ? cleanGeneratedAgentContractMarkers(findDocsMarkdownSection(getAskAIPageSectionContent(page), sectionSelector)?.content ?? "") : getAskAIPageContent(page) : [result.content, result.description].filter(Boolean).join("\n\n")), maxChars);
 	return {
 		...result,
 		url: resolveAskAIContextUrl(result.url, baseUrl),
@@ -1154,20 +1161,17 @@ function formatAskAIContextResult(options) {
 	};
 }
 function getSearchResultKey(result) {
-	let hash = "";
-	try {
-		hash = new URL(result.url, "https://docs.local").hash.replace(/^#/, "");
-	} catch {
-		hash = result.url.split("#")[1]?.split(/[?&]/)[0] ?? "";
-	}
-	return `${normalizeUrlPathname(result.url)}#${normalizeWhitespace(hash || result.section || "").toLowerCase()}`;
+	const anchor = getSearchResultAnchor(result.url);
+	const sectionFallback = normalizeWhitespace(result.section ?? "").toLowerCase();
+	return `${normalizeUrlPathname(result.url)}#${anchor ?? sectionFallback}`;
 }
 function getSearchResultAnchor(value) {
 	let hash = "";
 	try {
 		hash = new URL(value, "https://docs.local").hash.replace(/^#/, "");
 	} catch {
-		hash = value.split("#")[1]?.split(/[?&]/)[0] ?? "";
+		const hashIndex = value.indexOf("#");
+		hash = hashIndex >= 0 ? value.slice(hashIndex + 1) : "";
 	}
 	if (!hash) return void 0;
 	try {
@@ -1191,7 +1195,9 @@ function getAskAIResultPageKey(value, baseUrl, strictExternalOrigins = false) {
 	}
 }
 function getAskAIResultKey(result, baseUrl, strictExternalOrigins = false) {
-	return `${getAskAIResultPageKey(result.url, baseUrl, strictExternalOrigins)}#${normalizeWhitespace(getSearchResultAnchor(result.url) || result.section || "").toLowerCase()}`;
+	const anchor = getSearchResultAnchor(result.url);
+	const sectionFallback = normalizeWhitespace(result.section ?? "").toLowerCase();
+	return `${getAskAIResultPageKey(result.url, baseUrl, strictExternalOrigins)}#${anchor ?? sectionFallback}`;
 }
 function mergeSearchResults(groups, getResultKey = getSearchResultKey) {
 	const seen = /* @__PURE__ */ new Set();
@@ -1267,6 +1273,10 @@ function shouldPreserveUnmatchedExternalResult(options) {
 function getPageAudienceRawContent(page, audience) {
 	return resolveDocsAudienceMdxContent(audience === "agent" ? page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content : page.rawContent ?? page.content, audience);
 }
+function getPageAudienceSectionContent(page, audience) {
+	const content = getPageAudienceRawContent(page, audience);
+	return audience === "agent" ? upsertPageAgentContractMarkdown(content, page.agent) : content;
+}
 function getPageAudienceSearchText(page, audience) {
 	return stripMarkdownText(getPageAudienceRawContent(page, audience));
 }
@@ -1382,14 +1392,19 @@ function makeDocumentId(url, suffix) {
 	return `${url}#${suffix}`;
 }
 function splitPageIntoSections(page, audience = "human") {
-	const raw = getPageAudienceRawContent(page, audience);
+	const raw = getPageAudienceSectionContent(page, audience);
+	const generatedContract = audience === "agent" ? findDocsGeneratedAgentContractRanges(raw)[0] : void 0;
 	const scope = resolveDocsSearchPageScope(page);
-	return parseDocsMarkdownSections(raw).flatMap((section, index) => {
+	let documentIndex = 0;
+	return parseDocsMarkdownSections(raw).flatMap((section) => {
+		if (generatedContract && section.startLine > generatedContract.startLine && section.startLine < generatedContract.endLine) return [];
 		const content = normalizeWhitespace(stripMarkdownText(section.content));
 		if (!content) return [];
+		const index = documentIndex;
+		documentIndex += 1;
 		return [{
 			id: makeDocumentId(page.url, `section-${index}`),
-			url: `${page.url}#${section.anchor}`,
+			url: `${page.url.split("#", 1)[0]}#${encodeURIComponent(section.anchor)}`,
 			title: page.title,
 			section: section.title,
 			content,
@@ -2092,10 +2107,19 @@ async function performDocsSearch(options) {
 	const filters = normalizeDocsSearchFilters(options.filters);
 	const hasFilters = hasDocsSearchFilters(filters);
 	const scopedPages = hasFilters ? options.pages.filter((page) => docsSearchPageMatchesFilters(resolveDocsSearchPageScope(page), filters)) : options.pages;
-	const documents = buildDocsSearchDocuments(scopedPages, search.chunking, audience);
+	let resolvedDocuments;
+	const getDocuments = () => {
+		if (!resolvedDocuments) resolvedDocuments = buildDocsSearchDocuments(scopedPages, search.chunking, audience);
+		return resolvedDocuments;
+	};
 	const context = {
 		pages: scopedPages,
-		documents,
+		get documents() {
+			return getDocuments();
+		},
+		set documents(documents) {
+			resolvedDocuments = documents;
+		},
 		audience,
 		locale: options.locale,
 		pathname: options.pathname,
@@ -2112,13 +2136,24 @@ async function performDocsSearch(options) {
 	};
 	try {
 		const adapter = await resolveSearchAdapter(search, context);
-		await maybeSyncSearchIndex(adapter, search, audience === "agent" || hasFilters ? {
-			...context,
+		if (shouldSyncOnSearch(search) && typeof adapter.index === "function") await maybeSyncSearchIndex(adapter, search, audience === "agent" || hasFilters ? {
 			pages: options.pages,
 			documents: buildDocsSearchDocuments(options.pages, search.chunking, "human"),
-			audience: "human"
+			audience: "human",
+			locale: options.locale,
+			pathname: options.pathname,
+			siteTitle: options.siteTitle,
+			signal: options.signal
 		} : context);
-		const results = await adapter.search(query, context);
+		const adapterSearch = adapter.search(query, context);
+		let documents;
+		try {
+			documents = getDocuments();
+		} catch (error) {
+			adapterSearch.catch(() => void 0);
+			throw error;
+		}
+		const results = await adapterSearch;
 		if (search.provider === "simple") return results;
 		const localAudienceProjectionResults = buildAudienceProjectionSearchResults(documents, options.query);
 		const localPagePaths = new Set(scopedPages.map((page) => normalizeUrlPathname(page.url)));