@farming-labs/docs 0.2.70 → 0.2.72

package/dist/{agent-CXkn2ihX.mjs → agent-pS2nNQS3.mjs}

@@ -736,6 +736,148 @@ function normalizeInlineText(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
 
+//#endregion
+//#region src/markdown-sections.ts
+const HTML_ENTITIES = {
+	amp: "&",
+	apos: "'",
+	gt: ">",
+	lt: "<",
+	nbsp: " ",
+	quot: "\""
+};
+/**
+* Reduce inline Markdown in a heading to the visible label used by search and anchors.
+* This intentionally covers the common inline constructs without adding a Markdown parser
+* dependency to the runtime package.
+*/
+function cleanDocsMarkdownHeadingLabel(value) {
+	return value.replace(/!\[([^\]]*)\]\([^)]*\)/gu, "$1").replace(/\[([^\]]+)\]\([^)]*\)/gu, "$1").replace(/!\[([^\]]*)\]\[[^\]]*\]/gu, "$1").replace(/\[([^\]]+)\]\[[^\]]*\]/gu, "$1").replace(/<((?:https?:\/\/|mailto:)[^>]+)>/giu, "$1").replace(/<[^>]+>/gu, "").replace(/`+([^`]*?)`+/gu, "$1").replace(/\\([!"#$%&'()*+,\-./:;<=>?@[\]^_`{|}~])/gu, "$1").replace(/[*_~]/gu, "").replace(/&(#(?:x[0-9a-f]+|\d+)|[a-z]+);/giu, (_match, entity) => {
+		if (entity.startsWith("#x") || entity.startsWith("#X")) {
+			const codePoint = Number.parseInt(entity.slice(2), 16);
+			return Number.isSafeInteger(codePoint) && codePoint >= 0 && codePoint <= 1114111 ? String.fromCodePoint(codePoint) : _match;
+		}
+		if (entity.startsWith("#")) {
+			const codePoint = Number.parseInt(entity.slice(1), 10);
+			return Number.isSafeInteger(codePoint) && codePoint >= 0 && codePoint <= 1114111 ? String.fromCodePoint(codePoint) : _match;
+		}
+		return HTML_ENTITIES[entity.toLowerCase()] ?? _match;
+	}).replace(/\s+/gu, " ").trim();
+}
+/** Keep anchors aligned with the framework's existing ASCII heading-slug behavior. */
+function slugifyDocsMarkdownHeading(value) {
+	return cleanDocsMarkdownHeadingLabel(value).toLowerCase().replace(/[`'"‘’“”]/gu, "").replace(/&/gu, " and ").replace(/[^a-z0-9\s-]/gu, "").replace(/\s+/gu, "-").replace(/-+/gu, "-").replace(/^-|-$/gu, "");
+}
+function readOpeningFence(line) {
+	const match = line.match(/^ {0,3}(`{3,}|~{3,})/u);
+	if (!match) return void 0;
+	return {
+		marker: match[1][0],
+		length: match[1].length
+	};
+}
+function isClosingFence(line, fence) {
+	const marker = fence.marker === "`" ? "`" : "~";
+	const match = line.match(new RegExp(`^ {0,3}(${marker}{${fence.length},})[\\t ]*$`, "u"));
+	return Boolean(match);
+}
+function readAtxHeading(line) {
+	const match = line.match(/^ {0,3}(#{1,6})(?:[\t ]+|$)(.*)$/u);
+	if (!match) return void 0;
+	return {
+		title: cleanDocsMarkdownHeadingLabel(match[2].replace(/[\t ]+#+[\t ]*$/u, "").trim()),
+		level: match[1].length
+	};
+}
+function readSetextLevel(line) {
+	const match = line.match(/^ {0,3}(=+|-+)[\t ]*$/u);
+	if (!match) return void 0;
+	return match[1][0] === "=" ? 1 : 2;
+}
+function normalizeDocsSectionSelector(value) {
+	let selector = value.trim();
+	const hashIndex = selector.lastIndexOf("#");
+	if (hashIndex >= 0) selector = selector.slice(hashIndex + 1);
+	try {
+		selector = decodeURIComponent(selector);
+	} catch {}
+	return cleanDocsMarkdownHeadingLabel(selector.replace(/^#+/u, "")).toLowerCase();
+}
+/**
+* Parse heading sections once for search, Ask AI hydration, and MCP tools.
+* Supports CommonMark ATX indentation, Setext headings, fenced-code exclusion,
+* visible inline labels, and stable duplicate anchors.
+*/
+function parseDocsMarkdownSections(markdown) {
+	const lines = markdown.split(/\r?\n/u);
+	const headings = [];
+	const headingCounts = /* @__PURE__ */ new Map();
+	let openFence;
+	let setextCandidate;
+	const pushHeading = (title, level, start) => {
+		const baseAnchor = slugifyDocsMarkdownHeading(title) || `section-${headings.length}`;
+		const seen = headingCounts.get(baseAnchor) ?? 0;
+		headingCounts.set(baseAnchor, seen + 1);
+		headings.push({
+			title,
+			anchor: seen === 0 ? baseAnchor : `${baseAnchor}-${seen}`,
+			level,
+			start
+		});
+	};
+	for (let index = 0; index < lines.length; index += 1) {
+		const line = lines[index];
+		if (openFence) {
+			if (isClosingFence(line, openFence)) openFence = void 0;
+			setextCandidate = void 0;
+			continue;
+		}
+		const openingFence = readOpeningFence(line);
+		if (openingFence) {
+			openFence = openingFence;
+			setextCandidate = void 0;
+			continue;
+		}
+		const setextLevel = readSetextLevel(line);
+		if (setextLevel && setextCandidate?.index === index - 1) {
+			const title = cleanDocsMarkdownHeadingLabel(setextCandidate.value.trim());
+			if (title) pushHeading(title, setextLevel, setextCandidate.index);
+			setextCandidate = void 0;
+			continue;
+		}
+		const atxHeading = readAtxHeading(line);
+		if (atxHeading) {
+			pushHeading(atxHeading.title, atxHeading.level, index);
+			setextCandidate = void 0;
+			continue;
+		}
+		if (!line.trim() || /^ {4}|^\t/u.test(line)) {
+			setextCandidate = void 0;
+			continue;
+		}
+		setextCandidate = {
+			index,
+			value: line
+		};
+	}
+	return headings.map((heading, index) => {
+		const end = headings.slice(index + 1).find((candidate) => candidate.level <= heading.level)?.start ?? lines.length;
+		return {
+			title: heading.title,
+			anchor: heading.anchor,
+			level: heading.level,
+			content: lines.slice(heading.start, end).join("\n").trim(),
+			startLine: heading.start + 1,
+			endLine: end
+		};
+	});
+}
+function findDocsMarkdownSection(markdown, requestedSection) {
+	const selector = normalizeDocsSectionSelector(requestedSection);
+	if (!selector) return void 0;
+	return parseDocsMarkdownSections(markdown).find((section) => normalizeDocsSectionSelector(section.title) === selector || section.anchor === selector);
+}
+
 //#endregion
 //#region src/sitemap.ts
 const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
@@ -2178,6 +2320,7 @@ const DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS = {
 	getContext: true
 };
 const DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER = "Signature-Agent";
+const DOCS_MARKDOWN_SECTION_INDEX_FORMAT = "docs-markdown-sections.v1";
 const DOCS_AI_AGENT_USER_AGENT_PATTERNS = [
 	"claudebot",
 	"claude-searchbot",
@@ -2307,6 +2450,7 @@ const DOCS_CONFIG_MAP_TOP_LEVEL_KEYS = [
 	"metadata",
 	"og"
 ];
+const DOCS_MARKDOWN_SECTION_MAX_BUDGET = 1e6;
 function normalizeDocsPathSegment(value) {
 	return value.replace(/^\/+|\/+$/g, "");
 }
@@ -2466,12 +2610,22 @@ function buildDocsDiagnostics(config, options = {}) {
 				route: search.enabled ? apiQueryRoute("query={query}") : null,
 				routes: {
 					human: search.enabled ? apiQueryRoute("query={query}") : null,
-					agent: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null
+					agent: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
+					structuredAgent: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured") : null
 				},
 				agentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
+				structuredAgentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured") : null,
 				audienceParam: "audience",
 				defaultAudience: "human",
 				supportedAudiences: ["human", "agent"],
+				filterParams: {
+					framework: "framework",
+					version: "version",
+					package: "package",
+					tags: "tags"
+				},
+				responseFormat: "docs-search.v1",
+				warningsField: "warnings",
 				provider: search.provider,
 				transport: "GET"
 			},
@@ -3633,6 +3787,269 @@ function prependDocsMarkdownFrontmatter(markdown, metadata) {
 	if (hasDocsMarkdownFrontmatter(markdown)) return markdown;
 	return `${renderDocsMarkdownFrontmatter(metadata)}\n\n${markdown.replace(/^\r?\n+/, "")}`;
 }
+function stripDocsMarkdownFrontmatter(markdown) {
+	const match = markdown.match(/^(---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$))([\s\S]*)$/);
+	if (!match) return {
+		frontmatter: "",
+		body: markdown
+	};
+	return {
+		frontmatter: match[1] ?? "",
+		body: match[2] ?? ""
+	};
+}
+function slugifyPublicDocsMarkdownSectionId(value) {
+	return value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/`([^`]+)`/g, "$1").replace(/<[^>]*>/g, "").replace(/[^\p{L}\p{N}\s-]/gu, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function resolveDocsMarkdownSectionBody(document) {
+	const lines = stripDocsMarkdownFrontmatter(document).body.split(/\r?\n/u);
+	let generatedPreambleStart = 0;
+	while (generatedPreambleStart < lines.length && (lines[generatedPreambleStart] ?? "").trim() === "") generatedPreambleStart += 1;
+	if (/^#(?:\s+|$)/u.test(lines[generatedPreambleStart] ?? "") && /^URL:\s+\S/u.test(lines[generatedPreambleStart + 1] ?? "")) {
+		let metadataEnd = generatedPreambleStart + 2;
+		while (/^(?:LLM index|Description|Related):\s*/u.test(lines[metadataEnd] ?? "")) metadataEnd += 1;
+		for (let index = generatedPreambleStart + 1; index < metadataEnd; index += 1) lines[index] = "";
+	}
+	return {
+		body: lines.join("\n").replace(/\n{2,}## Sitemap\n\n(?:(?:See the (?:full|XML) \[sitemap\]\()|Sitemap discovery is not enabled)[\s\S]*$/u, ""),
+		lineOffset: 0
+	};
+}
+function estimateDocsMarkdownTokens(value) {
+	if (!value) return 0;
+	return Math.max(1, Math.ceil(docsMarkdownUtf8Bytes(value) / 4));
+}
+function docsMarkdownUtf8Bytes(value) {
+	return new TextEncoder().encode(value).byteLength;
+}
+function trimDocsMarkdownToByteBudget(value, byteBudget) {
+	if (docsMarkdownUtf8Bytes(value) <= byteBudget) return value;
+	let output = "";
+	let bytes = 0;
+	const encoder = new TextEncoder();
+	for (const character of value) {
+		const characterBytes = encoder.encode(character).byteLength;
+		if (bytes + characterBytes > byteBudget) break;
+		output += character;
+		bytes += characterBytes;
+	}
+	return output.trimEnd();
+}
+function truncateDocsMarkdownSectionContent(content, request) {
+	const budgets = [typeof request.byteBudget === "number" ? request.byteBudget : void 0, typeof request.tokenBudget === "number" ? request.tokenBudget * 4 : void 0].filter((budget) => budget !== void 0 && Number.isSafeInteger(budget) && budget > 0);
+	const byteBudget = budgets.length > 0 ? Math.min(...budgets) : void 0;
+	if (!byteBudget || docsMarkdownUtf8Bytes(content) <= byteBudget) return {
+		document: content,
+		truncated: false
+	};
+	const fullMarker = "\n\n<!-- section truncated: increase tokenBudget or byteBudget for more. -->";
+	const marker = docsMarkdownUtf8Bytes(fullMarker) <= byteBudget ? fullMarker : "\n\n<!-- section truncated -->";
+	if (docsMarkdownUtf8Bytes(marker) > byteBudget) return {
+		document: trimDocsMarkdownToByteBudget(marker.trimStart(), byteBudget),
+		truncated: true
+	};
+	let truncated = trimDocsMarkdownToByteBudget(content, Math.max(0, byteBudget - docsMarkdownUtf8Bytes(marker)));
+	const paragraphBoundary = truncated.lastIndexOf("\n\n");
+	if (paragraphBoundary > 0 && paragraphBoundary > truncated.length * .45) truncated = truncated.slice(0, paragraphBoundary).trimEnd();
+	return {
+		document: `${truncated}${marker}`,
+		truncated: true
+	};
+}
+function parsePositiveDocsMarkdownBudget(value) {
+	if (!value) return null;
+	const parsed = Number.parseInt(value.replace(/_/g, ""), 10);
+	if (!Number.isSafeInteger(parsed) || parsed <= 0) return null;
+	return Math.min(parsed, DOCS_MARKDOWN_SECTION_MAX_BUDGET);
+}
+function resolveDocsMarkdownSectionRequest(url) {
+	const section = url.searchParams.get("section")?.trim() || null;
+	const tokenBudget = parsePositiveDocsMarkdownBudget(url.searchParams.get("tokenBudget")) ?? parsePositiveDocsMarkdownBudget(url.searchParams.get("tokens"));
+	const byteBudget = parsePositiveDocsMarkdownBudget(url.searchParams.get("byteBudget")) ?? parsePositiveDocsMarkdownBudget(url.searchParams.get("bytes"));
+	if (!section && tokenBudget === null && byteBudget === null) return null;
+	return {
+		section,
+		tokenBudget,
+		byteBudget
+	};
+}
+function isDocsMarkdownSectionIndexRequest(url) {
+	if (!url.searchParams.has("sections")) return false;
+	const value = url.searchParams.get("sections")?.trim().toLowerCase();
+	return value === void 0 || ![
+		"0",
+		"false",
+		"no",
+		"off"
+	].includes(value);
+}
+function collectDocsMarkdownSections(document) {
+	const { body, lineOffset } = resolveDocsMarkdownSectionBody(document);
+	const seen = /* @__PURE__ */ new Map();
+	return parseDocsMarkdownSections(body).flatMap((section) => {
+		const baseId = slugifyPublicDocsMarkdownSectionId(section.title);
+		if (!baseId) return [];
+		const count = seen.get(baseId) ?? 0;
+		seen.set(baseId, count + 1);
+		return [{
+			id: count === 0 ? baseId : `${baseId}-${count + 1}`,
+			heading: section.title,
+			level: section.level,
+			content: section.content,
+			startLine: section.startLine + lineOffset,
+			endLine: section.endLine + lineOffset
+		}];
+	});
+}
+function updateDocsMarkdownUrl(value, update) {
+	const isAbsolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
+	try {
+		const url = new URL(value, "https://docs.invalid");
+		update(url);
+		return (isAbsolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`).replace(/([?&])sections=(?=&|$)/u, "$1sections");
+	} catch {
+		return value;
+	}
+}
+function resolveDocsMarkdownSectionCanonicalUrl(canonicalUrl, sectionId) {
+	return updateDocsMarkdownUrl(canonicalUrl, (url) => {
+		url.hash = sectionId;
+	});
+}
+function resolveDocsMarkdownSectionFetchUrl(markdownUrl, sectionId, request) {
+	return updateDocsMarkdownUrl(markdownUrl, (url) => {
+		url.searchParams.delete("sections");
+		url.searchParams.delete("section");
+		url.searchParams.delete("tokens");
+		url.searchParams.delete("bytes");
+		url.searchParams.delete("tokenBudget");
+		url.searchParams.delete("byteBudget");
+		url.searchParams.set("section", sectionId);
+		if (request.tokenBudget) url.searchParams.set("tokenBudget", String(request.tokenBudget));
+		if (request.byteBudget) url.searchParams.set("byteBudget", String(request.byteBudget));
+	});
+}
+function resolveDocsMarkdownSectionIndexUrl(markdownUrl, request) {
+	return updateDocsMarkdownUrl(markdownUrl, (url) => {
+		url.searchParams.delete("sections");
+		url.searchParams.delete("section");
+		url.searchParams.delete("tokens");
+		url.searchParams.delete("bytes");
+		url.searchParams.delete("tokenBudget");
+		url.searchParams.delete("byteBudget");
+		url.searchParams.set("sections", "");
+		if (request.tokenBudget) url.searchParams.set("tokenBudget", String(request.tokenBudget));
+		if (request.byteBudget) url.searchParams.set("byteBudget", String(request.byteBudget));
+	});
+}
+function buildDocsMarkdownSectionIndex(document, options) {
+	const request = {
+		tokenBudget: options.tokenBudget ?? void 0,
+		byteBudget: options.byteBudget ?? void 0
+	};
+	const sections = collectDocsMarkdownSections(document);
+	const ancestors = [];
+	const metadata = sections.map((section) => {
+		while (ancestors.length > 0 && (ancestors[ancestors.length - 1]?.level ?? Number.NEGATIVE_INFINITY) >= section.level) ancestors.pop();
+		const parentId = ancestors.at(-1)?.id;
+		const item = {
+			id: section.id,
+			heading: section.heading,
+			level: section.level,
+			...parentId ? { parentId } : {},
+			startLine: section.startLine,
+			endLine: section.endLine,
+			estimatedTokens: estimateDocsMarkdownTokens(section.content),
+			utf8Bytes: docsMarkdownUtf8Bytes(section.content),
+			canonicalUrl: resolveDocsMarkdownSectionCanonicalUrl(options.canonicalUrl, section.id),
+			markdownUrl: resolveDocsMarkdownSectionFetchUrl(options.markdownUrl, section.id, request)
+		};
+		ancestors.push(section);
+		return item;
+	});
+	const fetchBudget = request.tokenBudget || request.byteBudget ? {
+		...request.tokenBudget ? { tokenBudget: request.tokenBudget } : {},
+		...request.byteBudget ? { byteBudget: request.byteBudget } : {}
+	} : void 0;
+	return {
+		schemaVersion: 1,
+		format: DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
+		canonicalUrl: options.canonicalUrl,
+		markdownUrl: options.markdownUrl,
+		sectionIndexUrl: options.sectionIndexUrl ?? resolveDocsMarkdownSectionIndexUrl(options.markdownUrl, request),
+		lineNumbering: "body",
+		sectionCount: metadata.length,
+		estimatedTokens: estimateDocsMarkdownTokens(document),
+		utf8Bytes: docsMarkdownUtf8Bytes(document),
+		...fetchBudget ? { fetchBudget } : {},
+		sections: metadata
+	};
+}
+function normalizeRequestedDocsMarkdownSectionId(requestedSection) {
+	let selector = requestedSection.trim();
+	const hashIndex = selector.lastIndexOf("#");
+	if (hashIndex >= 0) selector = selector.slice(hashIndex + 1);
+	try {
+		selector = decodeURIComponent(selector);
+	} catch {}
+	return selector.replace(/^#+/u, "").toLowerCase();
+}
+function selectDocsMarkdownSection(document, request) {
+	const availableSections = collectDocsMarkdownSections(document);
+	const requestedSection = request.section?.trim();
+	if (!requestedSection) {
+		const { document: budgetedDocument, truncated } = truncateDocsMarkdownSectionContent(document, request);
+		return {
+			found: true,
+			document: budgetedDocument,
+			truncated,
+			tokenBudget: request.tokenBudget ?? void 0,
+			byteBudget: request.byteBudget ?? void 0,
+			estimatedTokens: estimateDocsMarkdownTokens(budgetedDocument),
+			utf8Bytes: docsMarkdownUtf8Bytes(budgetedDocument),
+			availableSections
+		};
+	}
+	const requestedId = normalizeRequestedDocsMarkdownSectionId(requestedSection);
+	const directSection = availableSections.find((candidate) => candidate.id === requestedId);
+	const { body, lineOffset } = resolveDocsMarkdownSectionBody(document);
+	const selectedSharedSection = directSection ? void 0 : findDocsMarkdownSection(body, requestedSection);
+	const sharedAliasSection = selectedSharedSection ? availableSections.find((candidate) => candidate.startLine === selectedSharedSection.startLine + lineOffset) : void 0;
+	const section = directSection ?? sharedAliasSection;
+	if (!section) {
+		const lines = [
+			"# Markdown Section Not Found",
+			"",
+			requestedSection ? `Could not find section \`${requestedSection}\`.` : "No Markdown sections were available in this page."
+		];
+		if (availableSections.length > 0) lines.push("", "## Available Sections", "", ...availableSections.map((candidate) => `- ${candidate.heading} (#${candidate.id})`));
+		const notFoundDocument = lines.join("\n");
+		return {
+			found: false,
+			requestedSection,
+			document: notFoundDocument,
+			truncated: false,
+			tokenBudget: request.tokenBudget ?? void 0,
+			byteBudget: request.byteBudget ?? void 0,
+			estimatedTokens: estimateDocsMarkdownTokens(notFoundDocument),
+			utf8Bytes: docsMarkdownUtf8Bytes(notFoundDocument),
+			availableSections
+		};
+	}
+	const { document: selectedDocument, truncated } = truncateDocsMarkdownSectionContent(section.content, request);
+	return {
+		found: true,
+		requestedSection,
+		section,
+		document: selectedDocument,
+		truncated,
+		tokenBudget: request.tokenBudget ?? void 0,
+		byteBudget: request.byteBudget ?? void 0,
+		estimatedTokens: estimateDocsMarkdownTokens(selectedDocument),
+		utf8Bytes: docsMarkdownUtf8Bytes(selectedDocument),
+		availableSections
+	};
+}
 function resolveDocsMarkdownPageMetadata(page, options) {
 	return {
 		title: page.title,
@@ -3671,7 +4088,7 @@ function renderDocsMarkdownNotFound({ entry = "docs", apiRoute, requestedPath, o
 			lines.push(`- [${match.title}](${match.markdownUrl}) (${confidence} confidence)${match.description ? ` - ${match.description}` : ""}`);
 		}
 	}
-	lines.push("", "## Recovery", "", "- If a closest match looks right, fetch that markdown URL directly.", "- If the match is uncertain, search the docs first and then fetch the smallest page that answers the task.", "- Use the sitemap routes below to browse the full docs index before guessing another slug.", "", "## Discovery Routes", "", "Use these discovery routes to find the right page:", "", `- Agent discovery spec: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}\``, `- Agent discovery fallback: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}\``, `- Agent discovery API: \`${agentSpecApiRoute}\``, `- API catalog: \`${DEFAULT_API_CATALOG_ROUTE}\``, `- Agent Skills index: \`${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}\``, `- Agent instructions: \`${DEFAULT_AGENTS_MD_ROUTE}\``, `- Agent search endpoint: \`${resolvedApiRoute}?query={query}&audience=agent\``, `- Docs index markdown: \`/${normalizedEntry}.md\``, `- Requested markdown API route: \`${requestedApiRoute}\``);
+	lines.push("", "## Recovery", "", "- If a closest match looks right, fetch that markdown URL directly.", "- If the match is uncertain, search the docs first and then fetch the smallest page that answers the task.", "- Use the sitemap routes below to browse the full docs index before guessing another slug.", "", "## Discovery Routes", "", "Use these discovery routes to find the right page:", "", `- Agent discovery spec: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}\``, `- Agent discovery fallback: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}\``, `- Agent discovery API: \`${agentSpecApiRoute}\``, `- API catalog: \`${DEFAULT_API_CATALOG_ROUTE}\``, `- Agent Skills index: \`${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}\``, `- Agent instructions: \`${DEFAULT_AGENTS_MD_ROUTE}\``, `- Structured agent search: \`${resolvedApiRoute}?query={query}&audience=agent&response=structured\` (optionally repeat \`framework\`, \`version\`, \`package\`, or \`tags\`).`, `- Docs index markdown: \`/${normalizedEntry}.md\``, `- Requested markdown API route: \`${requestedApiRoute}\``);
 	if (sitemapConfig.enabled) {
 		if (sitemapConfig.markdown.enabled) {
 			lines.push(`- Semantic sitemap: \`${sitemapConfig.markdown.route}\``);
@@ -3737,6 +4154,17 @@ function resolveDocsMarkdownContentLocation(canonicalUrl) {
 	url.pathname = toDocsMarkdownUrl(url.pathname);
 	return url.toString();
 }
+function appendDocsMarkdownSectionQuery(value, sectionRequest) {
+	try {
+		const url = new URL(value);
+		if (sectionRequest.section) url.searchParams.set("section", sectionRequest.section);
+		if (sectionRequest.tokenBudget) url.searchParams.set("tokenBudget", String(sectionRequest.tokenBudget));
+		if (sectionRequest.byteBudget) url.searchParams.set("byteBudget", String(sectionRequest.byteBudget));
+		return url.toString();
+	} catch {
+		return value;
+	}
+}
 /** Build one standards-aware Markdown response for every framework adapter. */
 function createDocsMarkdownResponse(options) {
 	const { request, document, entry = "docs", requestedPath, origin = new URL(request.url).origin, pages, sitemap, locale } = options;
@@ -3748,9 +4176,7 @@ function createDocsMarkdownResponse(options) {
 	});
 	const contentLocation = options.contentLocation ?? resolveDocsMarkdownContentLocation(canonicalUrl);
 	const varyHeader = getDocsMarkdownVaryHeader(request);
-	const sharedHeaders = {
-		"Content-Location": contentLocation,
-		Link: `<${canonicalUrl}>; rel="canonical"`,
+	const baseSharedHeaders = {
 		"X-Robots-Tag": "noindex",
 		...locale ? { "Content-Language": locale } : {},
 		...varyHeader ? { Vary: varyHeader } : {}
@@ -3765,7 +4191,9 @@ function createDocsMarkdownResponse(options) {
 		if (recovery.redirect) return new Response(null, {
 			status: 307,
 			headers: {
-				...sharedHeaders,
+				...baseSharedHeaders,
+				"Content-Location": contentLocation,
+				Link: `<${canonicalUrl}>; rel="canonical"`,
 				"Cache-Control": "no-store",
 				Location: new URL(recovery.redirect.markdownUrl, request.url).toString()
 			}
@@ -3780,19 +4208,81 @@ function createDocsMarkdownResponse(options) {
 		}), {
 			status: 404,
 			headers: {
-				...sharedHeaders,
+				...baseSharedHeaders,
+				"Content-Location": contentLocation,
+				Link: `<${canonicalUrl}>; rel="canonical"`,
 				"Cache-Control": "no-store",
 				"Content-Type": "text/markdown; charset=utf-8"
 			}
 		});
 	}
-	const etag = createDocsMarkdownEtag(document);
+	const requestUrl = new URL(request.url);
+	const sectionRequest = resolveDocsMarkdownSectionRequest(requestUrl);
+	if (isDocsMarkdownSectionIndexRequest(requestUrl)) {
+		const sectionIndexRequest = sectionRequest ?? {};
+		const sectionIndexContentLocation = resolveDocsMarkdownSectionIndexUrl(contentLocation, sectionIndexRequest);
+		const sectionIndex = buildDocsMarkdownSectionIndex(document, {
+			canonicalUrl,
+			markdownUrl: contentLocation,
+			sectionIndexUrl: sectionIndexContentLocation,
+			tokenBudget: sectionIndexRequest.tokenBudget,
+			byteBudget: sectionIndexRequest.byteBudget
+		});
+		const responseDocument = JSON.stringify(sectionIndex);
+		const etag = createDocsMarkdownEtag(responseDocument);
+		const lastModified = resolveDocsMarkdownHttpDate(options.lastModified ?? extractDocsMarkdownLastModified(document));
+		const responseHeaders = {
+			...baseSharedHeaders,
+			"Content-Location": sectionIndexContentLocation,
+			Link: `<${canonicalUrl}>; rel="canonical", <${contentLocation}>; rel="alternate"; type="text/markdown"`,
+			"Cache-Control": options.cacheControl ?? "public, max-age=0, s-maxage=3600",
+			"Content-Type": "application/json; charset=utf-8",
+			ETag: etag,
+			"X-Docs-Markdown-Section-Index": DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
+			"X-Docs-Markdown-Section-Count": String(sectionIndex.sectionCount),
+			"X-Docs-Markdown-Source-Estimated-Tokens": String(sectionIndex.estimatedTokens),
+			"X-Docs-Markdown-Source-Utf8-Bytes": String(sectionIndex.utf8Bytes),
+			"X-Docs-Markdown-Estimated-Tokens": String(estimateDocsMarkdownTokens(responseDocument)),
+			"X-Docs-Markdown-Utf8-Bytes": String(docsMarkdownUtf8Bytes(responseDocument)),
+			...sectionIndexRequest.tokenBudget ? { "X-Docs-Markdown-Token-Budget": String(sectionIndexRequest.tokenBudget) } : {},
+			...sectionIndexRequest.byteBudget ? { "X-Docs-Markdown-Byte-Budget": String(sectionIndexRequest.byteBudget) } : {},
+			...lastModified ? { "Last-Modified": lastModified } : {}
+		};
+		if (requestMatchesDocsMarkdownEtag(request, etag) || requestHasFreshDocsMarkdownDate(request, lastModified)) {
+			const { "Content-Type": _contentType, ...notModifiedHeaders } = responseHeaders;
+			return new Response(null, {
+				status: 304,
+				headers: notModifiedHeaders
+			});
+		}
+		return new Response(request.method.toUpperCase() === "HEAD" ? null : responseDocument, {
+			status: 200,
+			headers: responseHeaders
+		});
+	}
+	const sectionResult = sectionRequest ? selectDocsMarkdownSection(document, sectionRequest) : void 0;
+	const responseDocument = sectionResult?.document ?? document;
+	const sectionCanonicalUrl = sectionResult?.found && sectionResult.section ? `${canonicalUrl}#${sectionResult.section.id}` : canonicalUrl;
+	const sectionContentLocation = sectionRequest ? appendDocsMarkdownSectionQuery(contentLocation, sectionRequest) : contentLocation;
+	const sectionHeaders = sectionResult ? {
+		"X-Docs-Markdown-Section": sectionResult.section?.id ?? "",
+		"X-Docs-Markdown-Section-Found": sectionResult.found ? "true" : "false",
+		"X-Docs-Markdown-Section-Truncated": sectionResult.truncated ? "true" : "false",
+		"X-Docs-Markdown-Estimated-Tokens": String(sectionResult.estimatedTokens),
+		"X-Docs-Markdown-Utf8-Bytes": String(sectionResult.utf8Bytes),
+		...sectionResult.tokenBudget ? { "X-Docs-Markdown-Token-Budget": String(sectionResult.tokenBudget) } : {},
+		...sectionResult.byteBudget ? { "X-Docs-Markdown-Byte-Budget": String(sectionResult.byteBudget) } : {}
+	} : {};
+	const etag = createDocsMarkdownEtag(responseDocument);
 	const lastModified = resolveDocsMarkdownHttpDate(options.lastModified ?? extractDocsMarkdownLastModified(document));
 	const responseHeaders = {
-		...sharedHeaders,
-		"Cache-Control": options.cacheControl ?? "public, max-age=0, s-maxage=3600",
+		...baseSharedHeaders,
+		"Content-Location": sectionContentLocation,
+		Link: `<${sectionCanonicalUrl}>; rel="canonical"`,
+		"Cache-Control": sectionResult?.found === false ? "no-store" : options.cacheControl ?? "public, max-age=0, s-maxage=3600",
 		"Content-Type": "text/markdown; charset=utf-8",
 		ETag: etag,
+		...sectionHeaders,
 		...lastModified ? { "Last-Modified": lastModified } : {}
 	};
 	if (requestMatchesDocsMarkdownEtag(request, etag) || requestHasFreshDocsMarkdownDate(request, lastModified)) {
@@ -3802,7 +4292,10 @@ function createDocsMarkdownResponse(options) {
 			headers: notModifiedHeaders
 		});
 	}
-	return new Response(document, { headers: responseHeaders });
+	return new Response(responseDocument, {
+		status: sectionResult?.found === false ? 404 : 200,
+		headers: responseHeaders
+	});
 }
 function findDocsMarkdownPage(entry, pages, requestedPath) {
 	const normalizedRequest = normalizeRequestedMarkdownPath(entry, requestedPath);
@@ -3840,6 +4333,7 @@ function resolveDocsAgentDocumentContext({ entry = "docs", apiRoute, apiCatalog:
 		llmsSections: resolveDocsLlmsTxtSections(llms),
 		markdownAcceptHeader: markdown?.acceptHeader === false ? null : "text/markdown",
 		markdownSignatureAgentHeader: markdown?.signatureAgentHeader === false ? null : DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER,
+		markdownSectionDiscoveryEnabled: markdown?.sectionDiscovery !== false,
 		apiCatalogEnabled: explicitApiCatalog ?? llms?.apiCatalog ?? true
 	};
 }
@@ -3849,7 +4343,7 @@ function appendDocsMarkdownNegotiationStartLines(lines, context, variant) {
 }
 function appendDocsSearchStartLine(lines, context, variant) {
 	if (!context.searchEnabled) return;
-	lines.push(variant === "skill" ? `- Search with ${context.apiRoute}?query={query}&audience=agent when you do not know the page.` : `- Search with ${context.apiRoute}?query={query}&audience=agent when the route is unknown.`);
+	lines.push(variant === "skill" ? `- Search with ${context.apiRoute}?query={query}&audience=agent&response=structured when you do not know the page; optionally repeat framework, version, package, or tags filters.` : `- Search with ${context.apiRoute}?query={query}&audience=agent&response=structured when the route is unknown; optionally repeat framework, version, package, or tags filters.`);
 }
 function appendDocsOpenApiStartLine(lines, context, variant) {
 	if (!context.openapiConfig.enabled || !context.openapiConfig.url) return;
@@ -3887,6 +4381,7 @@ function appendDocsAgentStartHereLines(lines, context, variant) {
 	lines.push(variant === "skill" ? `- Fetch ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}; fall back to ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE} or ${agentSpecFallback}.` : `- Read ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE} first; fall back to ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE} or ${agentSpecFallback}.`);
 	if (context.apiCatalogEnabled) lines.push(variant === "skill" ? `- Use ${DEFAULT_API_CATALOG_ROUTE} for standards-based API discovery.` : `- Use ${DEFAULT_API_CATALOG_ROUTE} for RFC 9727 API discovery.`);
 	lines.push(variant === "skill" ? `- Use ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE} for hashed skill discovery.` : `- Use ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE} for integrity-checked skills.`, variant === "skill" ? `- Fetch /${context.normalizedEntry}.md for the root docs page.` : `- Read /${context.normalizedEntry}.md for the root docs page.`, variant === "skill" ? `- Fetch /${context.normalizedEntry}/{slug}.md for page-specific context.` : `- Read /${context.normalizedEntry}/{slug}.md for page-specific context.`);
+	if (context.markdownSectionDiscoveryEnabled) lines.push(variant === "skill" ? `- Fetch /${context.normalizedEntry}/{slug}.md?sections to list section IDs and size estimates before requesting ?section={id}.` : `- Read /${context.normalizedEntry}/{slug}.md?sections before fetching ?section={id} when a full page is larger than needed.`);
 	if (variant === "skill") {
 		appendDocsMarkdownNegotiationStartLines(lines, context, variant);
 		appendDocsSearchStartLine(lines, context, variant);
@@ -3934,6 +4429,7 @@ function appendDocsAgentPublicRouteLines(lines, context, variant) {
 		lines.push(`- Agent instructions: ${DEFAULT_AGENTS_MD_ROUTE}`, `- Agent instructions well-known alias: ${DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE}`, `- Agent instructions API format: ${context.apiRoute}?format=agents`, `- Skill document: ${DEFAULT_SKILL_MD_ROUTE}`, `- Skill well-known alias: ${DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE}`, `- Skill API format: ${context.apiRoute}?format=skill`, `- Agent discovery: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}`, `- Agent discovery fallback: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}`);
 		if (context.apiCatalogEnabled) lines.push(`- API catalog (RFC 9727): ${DEFAULT_API_CATALOG_ROUTE}`);
 		lines.push(`- Agent Skills index: ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}`, `- Agent Skills artifacts: ${DEFAULT_AGENT_SKILLS_ROUTE_PATTERN}`, `- Markdown root: /${context.normalizedEntry}.md`, `- Markdown pages: /${context.normalizedEntry}/{slug}.md`);
+		if (context.markdownSectionDiscoveryEnabled) lines.push(`- Markdown section index: /${context.normalizedEntry}/{slug}.md?sections`, `- Markdown section fetch: /${context.normalizedEntry}/{slug}.md?section={id}&tokenBudget={tokens}`);
 		if (context.robotsEnabled) lines.push(`- Robots policy: ${DEFAULT_AGENT_DISCOVERY_ROBOTS_TXT_ROUTE}`);
 		appendDocsLlmsRouteLines(lines, context);
 		appendDocsOpenApiRouteLines(lines, context);
@@ -3942,6 +4438,7 @@ function appendDocsAgentPublicRouteLines(lines, context, variant) {
 		return;
 	}
 	lines.push(`- Agent instructions: ${DEFAULT_AGENTS_MD_ROUTE}`, `- Agent instructions well-known alias: ${DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE}`, `- Agent instructions API format: ${context.apiRoute}?format=agents`, `- Agent instructions aliases: ${DEFAULT_AGENT_MD_ROUTE}, ${DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE}`, `- Site skill: ${DEFAULT_SKILL_MD_ROUTE}`, `- Site skill well-known alias: ${DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE}`, `- Site skill API format: ${context.apiRoute}?format=skill`, `- Markdown root: /${context.normalizedEntry}.md`, `- Markdown pages: /${context.normalizedEntry}/{slug}.md`, `- Agent discovery: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}`, `- Agent discovery fallback: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}`);
+	if (context.markdownSectionDiscoveryEnabled) lines.push(`- Markdown section index: /${context.normalizedEntry}/{slug}.md?sections`, `- Markdown section fetch: /${context.normalizedEntry}/{slug}.md?section={id}&tokenBudget={tokens}`);
 	if (context.apiCatalogEnabled) lines.push(`- API catalog (RFC 9727): ${DEFAULT_API_CATALOG_ROUTE}`);
 	lines.push(`- Agent Skills index: ${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}`, `- Agent Skills artifacts: ${DEFAULT_AGENT_SKILLS_ROUTE_PATTERN}`);
 	appendDocsLlmsRouteLines(lines, context);
@@ -4024,6 +4521,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 	const openapiUrl = resolveDocsOpenApiDiscoveryUrl(openapiConfig, resolvedApiRoute);
 	const agentContractMcpTools = resolveDocsAgentContractMcpTools(mcp);
 	const apiCatalogEnabled = explicitApiCatalog ?? llms?.apiCatalog ?? true;
+	const markdownSectionDiscoveryEnabled = markdown?.sectionDiscovery !== false;
 	const protectedResource = mcp.enabled && mcp.security?.authenticate ? mcp.security.protectedResource : void 0;
 	const protectedResourceMetadataRoutes = protectedResource ? getDocsMcpProtectedResourceMetadataRoutes(mcp.route) : [];
 	return {
@@ -4047,6 +4545,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		},
 		capabilities: {
 			markdownRoutes: true,
+			markdownSectionDiscovery: markdownSectionDiscoveryEnabled,
 			agentMdOverrides: true,
 			agentBlocks: true,
 			structuredAgentContracts: true,
@@ -4103,6 +4602,16 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 			pagePattern: `/${normalizedEntry}/{slug}.md`,
 			rootPage: `/${normalizedEntry}.md`,
 			apiPattern: apiQueryRoute("format=markdown&path={slug}"),
+			sectionDiscovery: {
+				enabled: markdownSectionDiscoveryEnabled,
+				...markdownSectionDiscoveryEnabled ? {
+					format: DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
+					indexParam: "sections",
+					sectionParam: "section",
+					tokenBudgetParam: "tokenBudget",
+					byteBudgetParam: "byteBudget"
+				} : {}
+			},
 			resolutionOrder: [
 				"agent.md",
 				"agent audience projection",
@@ -4190,12 +4699,29 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 			enabled: searchEnabled,
 			endpoint: apiQueryRoute("query={query}"),
 			agentEndpoint: apiQueryRoute("query={query}&audience=agent"),
+			structuredAgentEndpoint: apiQueryRoute("query={query}&audience=agent&response=structured"),
 			method: "GET",
 			queryParam: "query",
 			localeParam: "lang",
 			audienceParam: "audience",
 			defaultAudience: "human",
-			supportedAudiences: ["human", "agent"]
+			supportedAudiences: ["human", "agent"],
+			responseParam: "response",
+			structuredResponseValue: "structured",
+			responseFormat: "docs-search.v1",
+			filterParams: {
+				framework: "framework",
+				version: "version",
+				package: "package",
+				tags: "tags"
+			},
+			repeatedFilterParams: [
+				"framework",
+				"version",
+				"package",
+				"tags"
+			],
+			warningsField: "warnings"
 		},
 		agents: {
 			enabled: true,
@@ -4364,4 +4890,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { renderDocsAgentsDocument as $, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as $t, buildDocsAgentFeedbackSchema as A, buildDocsSitemapManifest as At, getDocsMarkdownVaryHeader as B, renderDocsRelatedMarkdownLines as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, resolveDocsAudienceExposure as Ct, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as D, DEFAULT_SITEMAP_MD_ROUTE as Dt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as E, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Et, createDocsStandardsDiscoveryResponse as F, resolveDocsSitemapConfig as Ft, isDocsDiagnosticsRequest as G, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS as Gt, isDocsAgentDiscoveryRequest as H, PAGE_AGENT_CONTRACT_FIELDS as Ht, detectDocsMarkdownAgentRequest as I, resolveDocsSitemapPageLastmod as It, isDocsSkillRequest as J, normalizePageAgentFrontmatter as Jt, isDocsLlmsTxtPublicRequest as K, getPageAgentFrontmatterIssues as Kt, findDocsMarkdownPage as L, resolveDocsSitemapRequest as Lt, buildDocsDiagnostics as M, readDocsSitemapManifestFromContentMap as Mt, buildDocsMcpEndpointCandidates as N, renderDocsSitemapMarkdown as Nt, acceptsDocsMarkdown as O, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as Ot, createDocsMarkdownResponse as P, renderDocsSitemapXml as Pt, parseDocsAgentFeedbackData as Q, upsertPageAgentContractMarkdown as Qt, getDocsLlmsTxtMaxCharsIssue as R, toDocsSitemapMarkdownUrl as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, resolveDocsAgentMdxContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, DEFAULT_SITEMAP_MANIFEST_PATH as Tt, isDocsAgentsRequest as U, PAGE_AGENT_CONTRACT_FIELD_SCHEMA as Ut, hasDocsMarkdownSignatureAgent as V, PAGE_AGENT_CONTRACT_END_MARKER as Vt, isDocsConfigRequest as W, PAGE_AGENT_CONTRACT_START_MARKER as Wt, normalizeDocsPathSegment as X, renderPageAgentFrontmatterYamlLines as Xt, matchesDocsLlmsTxtSection as Y, renderPageAgentContractMarkdown as Yt, normalizeDocsUrlPath as Z, stripGeneratedPageAgentContractMarkdown as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, selectDocsLlmsTxtContent as _t, DEFAULT_AGENT_MD_ROUTE as a, getDocsMcpResourcePaths as an, resolveDocsAgentFeedbackConfig as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, findDocsAudienceMdxIssues as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, isDocsMcpProtectedResourceMetadataPath as cn, resolveDocsLlmsTxtFormat as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, normalizeDocsMcpAuthorizationServerUrls as dn, resolveDocsMarkdownCanonicalUrl as dt, DEFAULT_MCP_PUBLIC_ROUTE as en, renderDocsLlmsTxt as et, DEFAULT_DOCS_CONFIG_ROUTE as f, normalizeDocsMcpEndpointPath as fn, resolveDocsMarkdownRecovery as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSkillFormat as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsRequestApiRoute as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, getDocsMcpProtectedResourceMetadataRoutes as in, resolveDocsAgentContractMcpTools as it, buildDocsConfigMap as j, createDocsSitemapResponse as jt, buildDocsAgentDiscoverySpec as k, DEFAULT_SITEMAP_XML_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, isDocsMcpRequest as ln, resolveDocsLlmsTxtRequest as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsMcpResourceLocation as mn, resolveDocsOpenApiDiscoveryConfig as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, DEFAULT_MCP_WELL_KNOWN_ROUTE as nn, renderDocsMarkdownNotFound as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, hasDocsMcpProtectedResourceConfig as on, resolveDocsAgentFeedbackRequest as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveDocsMcpProtectedResourceMetadataLocation as pn, resolveDocsMarkdownRequest as pt, isDocsPublicGetRequest as q, hasStructuredPageAgentContract as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, buildDocsMcpProtectedResourceMetadataRoute as rn, renderDocsSkillDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, isDocsMcpOAuthScopeToken as sn, resolveDocsAgentsFormat as st, DEFAULT_AGENTS_MD_ROUTE as t, DEFAULT_MCP_ROUTE as tn, renderDocsMarkdownDocument as tt, DEFAULT_DOCS_API_ROUTE as u, isDocsMcpResourcePath as un, resolveDocsLlmsTxtSections as ut, DEFAULT_LLMS_TXT_ROUTE as v, toDocsMarkdownUrl as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAudienceMdxContent as wt, DEFAULT_SKILL_MD_ROUTE as x, findDocsAudienceMdxTags as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, validateDocsAgentFeedbackPayload as yt, getDocsMarkdownCanonicalLinkHeader as z, normalizeDocsRelated as zt };
+export { matchesDocsLlmsTxtSection as $, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS as $t, buildDocsAgentDiscoverySpec as A, resolveDocsAudienceMdxContent as At, findDocsMarkdownPage as B, renderDocsSitemapXml as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, findDocsAudienceMdxTags as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, findDocsAudienceMdxIssues as Et, buildDocsMcpEndpointCandidates as F, DEFAULT_SITEMAP_XML_ROUTE as Ft, isDocsAgentDiscoveryRequest as G, findDocsMarkdownSection as Gt, getDocsMarkdownCanonicalLinkHeader as H, resolveDocsSitemapPageLastmod as Ht, collectDocsMarkdownSections as I, buildDocsSitemapManifest as It, isDocsDiagnosticsRequest as J, renderDocsRelatedMarkdownLines as Jt, isDocsAgentsRequest as K, parseDocsMarkdownSections as Kt, createDocsMarkdownResponse as L, createDocsSitemapResponse as Lt, buildDocsConfigMap as M, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Mt, buildDocsDiagnostics as N, DEFAULT_SITEMAP_MD_ROUTE as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, resolveDocsAgentMdxContent as Ot, buildDocsMarkdownSectionIndex as P, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as Pt, isDocsSkillRequest as Q, PAGE_AGENT_CONTRACT_START_MARKER as Qt, createDocsStandardsDiscoveryResponse as R, readDocsSitemapManifestFromContentMap as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, resolveDocsMcpResourceLocation as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, resolveDocsSitemapRequest as Ut, getDocsLlmsTxtMaxCharsIssue as V, resolveDocsSitemapConfig as Vt, hasDocsMarkdownSignatureAgent as W, toDocsSitemapMarkdownUrl as Wt, isDocsMarkdownSectionIndexRequest as X, PAGE_AGENT_CONTRACT_FIELDS as Xt, isDocsLlmsTxtPublicRequest as Y, PAGE_AGENT_CONTRACT_END_MARKER as Yt, isDocsPublicGetRequest as Z, PAGE_AGENT_CONTRACT_FIELD_SCHEMA as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, isDocsMcpRequest as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, stripGeneratedPageAgentContractMarkdown as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, normalizeDocsMcpEndpointPath as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, DEFAULT_MCP_PUBLIC_ROUTE as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, buildDocsMcpProtectedResourceMetadataRoute as dn, resolveDocsAgentsFormat as dt, getPageAgentFrontmatterIssues as en, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, getDocsMcpProtectedResourceMetadataRoutes as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, isDocsMcpProtectedResourceMetadataPath as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, isDocsMcpOAuthScopeToken as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, renderPageAgentFrontmatterYamlLines as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, DEFAULT_SITEMAP_MANIFEST_PATH as jt, acceptsDocsMarkdown as k, resolveDocsAudienceExposure as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, DEFAULT_MCP_ROUTE as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, hasDocsMcpProtectedResourceConfig as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, normalizePageAgentFrontmatter as nn, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, upsertPageAgentContractMarkdown as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, getDocsMcpResourcePaths as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, normalizeDocsRelated as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, renderPageAgentContractMarkdown as rn, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, hasStructuredPageAgentContract as tn, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, DEFAULT_MCP_WELL_KNOWN_ROUTE as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, isDocsMcpResourcePath as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, resolveDocsMcpProtectedResourceMetadataLocation as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, normalizeDocsMcpAuthorizationServerUrls as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, renderDocsSitemapMarkdown as zt };