@farming-labs/docs 0.2.83 → 0.2.85

package/dist/{agent-Dze2Cy5B.mjs → agent-CTOUI2BK.mjs}

@@ -1,5 +1,5 @@
 import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, b as renderPageAgentFrontmatterYamlLines, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, 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-BKlEnK_H.mjs";
+import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, K as digestDocsRetrievalContent, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, W as resolveDocsHttpDate, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, q as isDocsRetrievalCanonicalUrl, 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-Ckx0tN7B.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/mcp-auth.ts
@@ -148,172 +148,6 @@ function normalizeInlineText(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
 
-//#endregion
-//#region src/retrieval-digest.ts
-const SHA256_INITIAL_STATE = [
-	1779033703,
-	3144134277,
-	1013904242,
-	2773480762,
-	1359893119,
-	2600822924,
-	528734635,
-	1541459225
-];
-const SHA256_ROUND_CONSTANTS = [
-	1116352408,
-	1899447441,
-	3049323471,
-	3921009573,
-	961987163,
-	1508970993,
-	2453635748,
-	2870763221,
-	3624381080,
-	310598401,
-	607225278,
-	1426881987,
-	1925078388,
-	2162078206,
-	2614888103,
-	3248222580,
-	3835390401,
-	4022224774,
-	264347078,
-	604807628,
-	770255983,
-	1249150122,
-	1555081692,
-	1996064986,
-	2554220882,
-	2821834349,
-	2952996808,
-	3210313671,
-	3336571891,
-	3584528711,
-	113926993,
-	338241895,
-	666307205,
-	773529912,
-	1294757372,
-	1396182291,
-	1695183700,
-	1986661051,
-	2177026350,
-	2456956037,
-	2730485921,
-	2820302411,
-	3259730800,
-	3345764771,
-	3516065817,
-	3600352804,
-	4094571909,
-	275423344,
-	430227734,
-	506948616,
-	659060556,
-	883997877,
-	958139571,
-	1322822218,
-	1537002063,
-	1747873779,
-	1955562222,
-	2024104815,
-	2227730452,
-	2361852424,
-	2428436474,
-	2756734187,
-	3204031479,
-	3329325298
-];
-function rotateRight(value, bits) {
-	return value >>> bits | value << 32 - bits;
-}
-function normalizeDigestContent(value) {
-	return value.replace(/\r\n?/gu, "\n").replace(/^\uFEFF/u, "").trimEnd();
-}
-/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
-function isDocsRetrievalCanonicalUrl(value) {
-	const hasUnsafeCharacter = value.includes("\\") || Array.from(value).some((character) => {
-		const codePoint = character.codePointAt(0) ?? 0;
-		return codePoint <= 31 || codePoint === 127;
-	});
-	if (!value || value !== value.trim() || value.length > 4096 || hasUnsafeCharacter) return false;
-	if (/^\/(?!\/)/u.test(value)) try {
-		new URL(value, "https://docs.local");
-		return true;
-	} catch {
-		return false;
-	}
-	try {
-		const url = new URL(value);
-		return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
-	} catch {
-		return false;
-	}
-}
-/**
-* Hash a retrieval source projection with portable SHA-256.
-*
-* The projection is normalized by removing one leading BOM, converting CRLF/CR
-* line endings to LF, and trimming trailing whitespace. The helper is exported so
-* agents can independently verify provenance in Node, edge, and browser runtimes.
-*/
-function digestDocsRetrievalContent(value) {
-	const input = new TextEncoder().encode(normalizeDigestContent(value));
-	const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
-	const padded = new Uint8Array(paddedLength);
-	padded.set(input);
-	padded[input.length] = 128;
-	const bitLength = input.length * 8;
-	const dataView = new DataView(padded.buffer);
-	dataView.setUint32(paddedLength - 8, Math.floor(bitLength / 4294967296), false);
-	dataView.setUint32(paddedLength - 4, bitLength >>> 0, false);
-	const state = Uint32Array.from(SHA256_INITIAL_STATE);
-	const words = new Uint32Array(64);
-	for (let offset = 0; offset < padded.length; offset += 64) {
-		for (let index = 0; index < 16; index += 1) words[index] = dataView.getUint32(offset + index * 4, false);
-		for (let index = 16; index < 64; index += 1) {
-			const previous15 = words[index - 15];
-			const previous2 = words[index - 2];
-			const sigma0 = rotateRight(previous15, 7) ^ rotateRight(previous15, 18) ^ previous15 >>> 3;
-			const sigma1 = rotateRight(previous2, 17) ^ rotateRight(previous2, 19) ^ previous2 >>> 10;
-			words[index] = words[index - 16] + sigma0 + words[index - 7] + sigma1 >>> 0;
-		}
-		let a = state[0];
-		let b = state[1];
-		let c = state[2];
-		let d = state[3];
-		let e = state[4];
-		let f = state[5];
-		let g = state[6];
-		let h = state[7];
-		for (let index = 0; index < 64; index += 1) {
-			const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
-			const choice = e & f ^ ~e & g;
-			const temporary1 = h + sum1 + choice + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
-			const temporary2 = (rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
-			h = g;
-			g = f;
-			f = e;
-			e = d + temporary1 >>> 0;
-			d = c;
-			c = b;
-			b = a;
-			a = temporary1 + temporary2 >>> 0;
-		}
-		state[0] = state[0] + a >>> 0;
-		state[1] = state[1] + b >>> 0;
-		state[2] = state[2] + c >>> 0;
-		state[3] = state[3] + d >>> 0;
-		state[4] = state[4] + e >>> 0;
-		state[5] = state[5] + f >>> 0;
-		state[6] = state[6] + g >>> 0;
-		state[7] = state[7] + h >>> 0;
-	}
-	return `sha256:${Array.from(state, (word) => word.toString(16).padStart(8, "0")).join("")}`;
-}
-
 //#endregion
 //#region src/pagination.ts
 const DOCS_PAGINATION_CURSOR_VERSION = 1;
@@ -2408,6 +2242,8 @@ const MAX_SEARCH_WARNINGS = 16;
 const MAX_SEARCH_WARNING_VALUES = 16;
 const MAX_SEARCH_WARNING_PAGE_URLS = 8;
 const MAX_SEARCH_FACET_VALUES = 100;
+const MAX_SEARCH_EXPLANATION_TERMS = 32;
+const MAX_SEARCH_EXPLANATION_TERM_CHARS = 128;
 const RETRIEVAL_INDEX_FORMAT = "docs-retrieval-index.v1";
 const MAX_RETRIEVAL_SOURCE_URL_CHARS = 4096;
 const MAX_RETRIEVAL_SOURCE_VALUE_CHARS = 256;
@@ -2522,6 +2358,9 @@ function resolveDocsSearchRequest(searchParams) {
 	const response = searchParams.get("response");
 	const structured = response === "structured";
 	const facets = response === "facets";
+	const rawExplain = searchParams.get("explain");
+	if (rawExplain !== null && rawExplain !== "true" && rawExplain !== "false") throw new DocsSearchRequestError("Search explain must be `true` or `false`.");
+	const explain = rawExplain === "true";
 	const rawFacet = searchParams.get("facet");
 	let facet;
 	if (rawFacet !== null) {
@@ -2543,6 +2382,7 @@ function resolveDocsSearchRequest(searchParams) {
 	return {
 		filters: resolveDocsSearchFilters(searchParams),
 		structured,
+		...explain ? { explain: true } : {},
 		...facets ? { facets: true } : {},
 		...facet !== void 0 ? { facet } : {},
 		...cursor !== void 0 ? { cursor } : {},
@@ -3703,9 +3543,14 @@ function buildDocsSearchDocuments(pages, chunking = {}, audience = "human") {
 		return [...base.content ? [base] : [], ...sections];
 	});
 }
-function scoreDocument(query, document) {
+function analyzeDocsSearchDocument(query, document, explain = false) {
 	const q = normalizeSearchPhrase(query);
-	if (!q) return 0;
+	if (!q) return {
+		score: 0,
+		matchedTerms: [],
+		matchedTermsTruncated: false,
+		rankingReasons: []
+	};
 	const words = tokenizeSearchQuery(q);
 	const title = normalizeSearchPhrase(document.title);
 	const section = document.section ? normalizeSearchPhrase(document.section) : "";
@@ -3718,65 +3563,248 @@ function scoreDocument(query, document) {
 	const titleTokens = tokenizeSearchQuery(title);
 	const sectionTokens = tokenizeSearchQuery(section);
 	let score = 0;
+	const reasonContributions = explain ? /* @__PURE__ */ new Map() : void 0;
+	const addScore = (contribution, code, description) => {
+		score += contribution;
+		if (!reasonContributions) return;
+		const current = reasonContributions.get(code);
+		reasonContributions.set(code, {
+			contribution: (current?.contribution ?? 0) + contribution,
+			description: current?.description ?? description
+		});
+	};
 	const insideLiteralPriority = document.type !== "page" && hasDistinctSection && isLiteralLookupQuery(q) ? Math.max(literalMatchPriority(q, section), literalMatchPriority(q, description), literalMatchPriority(q, content)) : 0;
-	if (insideLiteralPriority > 0) score += insideLiteralPriority * 2250;
-	if (title === q) score += 1120;
-	else if (title.startsWith(q)) score += 70;
-	else if (title.includes(q)) score += 45;
+	if (insideLiteralPriority > 0) addScore(insideLiteralPriority * 2250, "literal_match", "A short literal lookup matched this section or its searchable text.");
+	if (title === q) addScore(1120, "title_phrase", "The normalized query exactly matches the page title.");
+	else if (title.startsWith(q)) addScore(70, "title_phrase", "The page title starts with the normalized query.");
+	else if (title.includes(q)) addScore(45, "title_phrase", "The page title contains the normalized query.");
 	if (hasDistinctSection) {
-		if (section === q) score += 1080;
-		else if (section.startsWith(q)) score += 55;
-		else if (section.includes(q)) score += 30;
-		if (titleSection === q) score += 1e3;
-		else if (titleSection.startsWith(q)) score += 50;
-		else if (titleSection.includes(q)) score += 28;
-	}
-	if (urlSegments.includes(q)) score += 950;
-	if (url.includes(q)) score += 12;
-	if (description.includes(q)) score += 18;
-	if (content.includes(q)) score += 12;
+		if (section === q) addScore(1080, "section_phrase", "The normalized query exactly matches the section title.");
+		else if (section.startsWith(q)) addScore(55, "section_phrase", "The section title starts with the normalized query.");
+		else if (section.includes(q)) addScore(30, "section_phrase", "The section title contains the normalized query.");
+		if (titleSection === q) addScore(1e3, "title_section_phrase", "The normalized query exactly matches the combined page and section title.");
+		else if (titleSection.startsWith(q)) addScore(50, "title_section_phrase", "The combined page and section title starts with the normalized query.");
+		else if (titleSection.includes(q)) addScore(28, "title_section_phrase", "The combined page and section title contains the normalized query.");
+	}
+	if (urlSegments.includes(q)) addScore(950, "url_phrase", "The normalized query exactly matches a URL segment.");
+	if (url.includes(q)) addScore(12, "url_phrase", "The result URL contains the normalized query.");
+	if (description.includes(q)) addScore(18, "description_phrase", "The page description contains the normalized query.");
+	if (content.includes(q)) addScore(12, "content_phrase", "The searchable content contains the normalized query.");
 	let matchedWords = 0;
 	for (const word of words) {
 		let matched = false;
 		if (title === word) {
-			score += 28;
+			addScore(28, "title_terms", "Normalized query terms match the page title.");
 			matched = true;
 		} else if (title.startsWith(word)) {
-			score += 20;
+			addScore(20, "title_terms", "Normalized query terms match the page title.");
 			matched = true;
 		} else if (title.includes(word)) {
-			score += 12;
+			addScore(12, "title_terms", "Normalized query terms match the page title.");
 			matched = true;
 		}
 		if (hasDistinctSection) {
 			if (section === word) {
-				score += 22;
+				addScore(22, "section_terms", "Normalized query terms match the section title.");
 				matched = true;
 			} else if (section.startsWith(word)) {
-				score += 16;
+				addScore(16, "section_terms", "Normalized query terms match the section title.");
 				matched = true;
 			} else if (section.includes(word)) {
-				score += 10;
+				addScore(10, "section_terms", "Normalized query terms match the section title.");
 				matched = true;
 			}
 		}
 		if (description.includes(word)) {
-			score += 6;
+			addScore(6, "description_terms", "Normalized query terms match the page description.");
 			matched = true;
 		}
 		if (content.includes(word)) {
-			score += 4;
+			addScore(4, "content_terms", "Normalized query terms match the searchable content.");
 			matched = true;
 		}
 		if (matched) matchedWords += 1;
 	}
 	if (words.length > 1) {
-		if (hasDistinctSection && sectionTokens.length > 0 && words.every((word) => sectionTokens.includes(word))) score += 30;
-		if (document.type === "page" && titleTokens.length > 0 && words.every((word) => titleTokens.includes(word))) score += 24;
+		if (hasDistinctSection && sectionTokens.length > 0 && words.every((word) => sectionTokens.includes(word))) addScore(30, "all_terms_in_section", "Every normalized query term occurs in the section title.");
+		if (document.type === "page" && titleTokens.length > 0 && words.every((word) => titleTokens.includes(word))) addScore(24, "all_terms_in_title", "Every normalized query term occurs in the page title.");
+	}
+	if (matchedWords === words.length && words.length > 1) addScore(20, "all_query_terms", "Every normalized query term matched a searchable field.");
+	if (score > 0 && document.type === "heading" && hasDistinctSection) addScore(6, "heading_boost", "A distinct matching section is preferred over a page-only hit.");
+	const matchedTerms = [];
+	let matchedTermCount = 0;
+	let matchedTermCharactersTruncated = false;
+	if (explain) {
+		const candidateTerms = words.length > 0 ? words : [q];
+		const fields = [
+			["title", title],
+			["section", section],
+			["description", description],
+			["content", content],
+			["url", url]
+		];
+		for (const term of candidateTerms) {
+			const matchingFields = fields.flatMap(([field, value]) => value.includes(term) ? [field] : []);
+			if (matchingFields.length === 0) continue;
+			matchedTermCount += 1;
+			if (matchedTerms.length < MAX_SEARCH_EXPLANATION_TERMS) {
+				matchedTermCharactersTruncated ||= term.length > MAX_SEARCH_EXPLANATION_TERM_CHARS;
+				matchedTerms.push({
+					term: term.slice(0, MAX_SEARCH_EXPLANATION_TERM_CHARS),
+					fields: matchingFields
+				});
+			}
+		}
 	}
-	if (matchedWords === words.length && words.length > 1) score += 20;
-	if (score > 0 && document.type === "heading" && hasDistinctSection) score += 6;
-	return score;
+	return {
+		score,
+		matchedTerms,
+		matchedTermsTruncated: matchedTermCount > matchedTerms.length || matchedTermCharactersTruncated,
+		rankingReasons: reasonContributions ? [...reasonContributions.entries()].map(([code, value]) => ({
+			code,
+			...value
+		})).sort((left, right) => right.contribution - left.contribution || left.code.localeCompare(right.code)) : []
+	};
+}
+function scoreDocument(query, document) {
+	return analyzeDocsSearchDocument(query, document).score;
+}
+function getDocsSearchExplanationResultIdentity(result) {
+	return JSON.stringify([
+		result.id,
+		result.url,
+		result.section ?? null
+	]);
+}
+function getDocsSearchExplanationDocumentIdentity(document) {
+	return getSearchResultKey({
+		id: document.id,
+		url: document.url,
+		content: document.title,
+		type: document.type,
+		section: document.section
+	});
+}
+function resolveDocsSearchExplanationDocument(result, documentsById, documentsByResultKey) {
+	const local = documentsById.get(result.id) ?? documentsByResultKey.get(getSearchResultKey(result));
+	if (local) return local;
+	return {
+		id: result.id,
+		url: result.url,
+		title: inferResultTitle(result),
+		content: result.content,
+		description: result.description,
+		section: result.section,
+		type: result.type
+	};
+}
+function buildDocsSearchFilterDecisions(filters, scope) {
+	return SEARCH_FILTER_FIELDS.map((field) => {
+		const requestedValues = filters[field] ?? [];
+		const selectedValues = scope?.[field] ?? [];
+		if (requestedValues.length === 0) return {
+			field,
+			requestedValues: [],
+			selectedValues: [...selectedValues],
+			matchedValues: [],
+			outcome: "not_requested"
+		};
+		const matchedValues = requestedValues.filter((requested) => selectedValues.some((selected) => docsSearchScopeValueMatches(field, requested, selected)));
+		const versionGroupsMatch = field !== "version" || !scope?.versionGroups?.length || agentVersionConstraintGroupsOverlap([requestedValues, ...scope.versionGroups]);
+		const verifiable = Boolean(scope) && !scope?.conflicts?.includes(field) && !scope?.truncated?.includes(field) && selectedValues.length > 0;
+		return {
+			field,
+			requestedValues: [...requestedValues],
+			selectedValues: [...selectedValues],
+			matchedValues,
+			outcome: verifiable && matchedValues.length > 0 && versionGroupsMatch ? "matched" : "not_verifiable"
+		};
+	});
+}
+function buildDocsSearchAmbiguityResolution(filters, scope, warnings, unverifiableFields) {
+	const decisions = SEARCH_AMBIGUITY_FIELDS.map((field) => {
+		const selectedValues = [...scope?.[field] ?? []];
+		const requestedValues = filters[field];
+		if (requestedValues?.length) return {
+			field,
+			status: "resolved_by_filter",
+			selectedValues,
+			candidateValues: [...requestedValues],
+			reason: `The explicit ${field} filter constrained the result set.`
+		};
+		const warning = warnings.find((candidate) => candidate.code === "ambiguous_scope" && candidate.field === field);
+		if (warning) return {
+			field,
+			status: "requires_filter",
+			selectedValues,
+			...warning.values ? { candidateValues: [...warning.values] } : {},
+			reason: `Results span multiple ${field} scopes; select a ${field} filter before acting on scope-specific guidance.`
+		};
+		const hasConflictingMetadata = warnings.some((candidate) => candidate.code === "conflicting_scope_metadata" && candidate.field === field);
+		if (selectedValues.length === 0 || unverifiableFields.has(field) || hasConflictingMetadata) return {
+			field,
+			status: "not_verifiable",
+			selectedValues,
+			reason: `No trusted ${field} scope is available for this result.`
+		};
+		return {
+			field,
+			status: "unambiguous",
+			selectedValues,
+			reason: `The matching result set does not contain conflicting ${field} choices.`
+		};
+	});
+	const hasUnresolved = decisions.some((decision) => decision.status === "requires_filter");
+	const isNotVerifiable = decisions.some((decision) => decision.status === "not_verifiable");
+	const hasResolved = decisions.some((decision) => decision.status === "resolved_by_filter");
+	return {
+		status: hasUnresolved ? "unresolved" : isNotVerifiable ? "not_verifiable" : hasResolved ? "resolved" : "unambiguous",
+		decisions
+	};
+}
+function explainDocsSearchResults(options) {
+	const documentsById = new Map(options.documents.map((document) => [document.id, document]));
+	const documentsByResultKey = new Map(options.documents.map((document) => [getDocsSearchExplanationDocumentIdentity(document), document]));
+	return options.results.map((result, index, results) => {
+		const document = resolveDocsSearchExplanationDocument(result, documentsById, documentsByResultKey);
+		const analysis = analyzeDocsSearchDocument(options.query, document, true);
+		const rankingStrategy = options.resolveRankingStrategy(result);
+		const rankingReasons = rankingStrategy === "provider" ? [{
+			code: "provider_order",
+			description: `The ${options.provider} search adapter supplied this result order; provider-internal ranking details are not available to the shared pipeline.`
+		}] : [...analysis.rankingReasons];
+		if (rankingStrategy === "exact") rankingReasons.unshift({
+			code: "exact_page_boost",
+			contribution: 2e3,
+			description: "An exact normalized page-title or URL-segment match was promoted."
+		});
+		if (rankingStrategy === "provider" && insideLiteralResultPriority(options.query, result) > 0) rankingReasons.push({
+			code: "literal_result_priority",
+			description: "The shared pipeline promoted this distinct section because it matched a short literal lookup."
+		});
+		const resultScore = result.score;
+		const previousScore = index > 0 ? results[index - 1]?.score : void 0;
+		const nextScore = index + 1 < results.length ? results[index + 1]?.score : void 0;
+		if (rankingStrategy !== "provider" && resultScore !== void 0 && (resultScore === previousScore || resultScore === nextScore)) rankingReasons.push({
+			code: "stable_url_tiebreak",
+			description: "A stable URL comparison resolved an equal lexical score."
+		});
+		const selectedScope = result.source?.scope;
+		return {
+			...result,
+			explanation: {
+				format: "docs-search-explanation.v1",
+				rank: options.rankOffset + index + 1,
+				rankingStrategy,
+				matchedTerms: analysis.matchedTerms,
+				matchedTermsTruncated: analysis.matchedTermsTruncated,
+				selectedScope: selectedScope ? { ...selectedScope } : null,
+				filterDecisions: buildDocsSearchFilterDecisions(options.filters, selectedScope),
+				ambiguityResolution: buildDocsSearchAmbiguityResolution(options.filters, selectedScope, options.warnings, options.unverifiableAmbiguityFields),
+				rankingReasons
+			}
+		};
+	});
 }
 function buildSnippet(document, query) {
 	const q = query.trim().toLowerCase();
@@ -4568,6 +4596,7 @@ function createMcpSearchAdapter(config) {
 								query: query.query,
 								limit: pageSize,
 								locale: query.locale,
+								...query.explain ? { explain: true } : {},
 								...providerCursor !== void 0 ? { cursor: providerCursor } : {},
 								...forwardAudience ? { audience } : {},
 								...query.filters?.framework ? { framework: query.filters.framework } : {},
@@ -4994,7 +5023,8 @@ async function performDocsSearchInternal(options) {
 		locale: options.locale,
 		pathname: options.pathname,
 		audience,
-		...hasFilters ? { filters } : {}
+		...hasFilters ? { filters } : {},
+		...options.explain ? { explain: true } : {}
 	};
 	let currentIndexGeneration;
 	const getCurrentIndexGeneration = () => {
@@ -5017,24 +5047,64 @@ async function performDocsSearchInternal(options) {
 		});
 		return hostedIndexGeneration;
 	};
-	const finalizeResults = async (results) => enrichDocsSearchResultsWithSources({
-		results,
-		pages: scopedPages,
-		generationPages: options.generationPages ?? options.pages,
-		audience,
-		chunking: search.chunking,
-		locale: options.locale,
-		baseUrl: options.baseUrl,
-		indexGeneration: options.indexGeneration,
-		strictExternalOrigins: options.strictExternalOrigins,
-		filters,
-		requireCurrentIndexGeneration
-	});
+	let explanationWarnings;
+	const getExplanationWarnings = () => {
+		explanationWarnings ??= buildDocsSearchWarnings({
+			pages: corpusPages,
+			results: [],
+			filters,
+			query: options.query,
+			audience,
+			baseUrl: options.baseUrl,
+			completeResultSet: true
+		});
+		return explanationWarnings;
+	};
+	let explanationUnverifiableAmbiguityFields;
+	const getExplanationUnverifiableAmbiguityFields = () => {
+		explanationUnverifiableAmbiguityFields ??= new Set(SEARCH_AMBIGUITY_FIELDS.filter((field) => corpusPages.some((page) => {
+			if (scoreDocument(options.query, pageToSearchDocument(page, audience)) <= 0) return false;
+			const scope = resolveDocsSearchPageScope(page);
+			if (hasFilters && !docsSearchPageMatchesFilters(scope, filters)) return false;
+			return scope.conflicts.includes(field) || scope.declarations[field].length === 0;
+		})));
+		return explanationUnverifiableAmbiguityFields;
+	};
+	const finalizeResults = async (results, ranking = "lexical") => {
+		const enriched = await enrichDocsSearchResultsWithSources({
+			results,
+			pages: scopedPages,
+			generationPages: options.generationPages ?? options.pages,
+			audience,
+			chunking: search.chunking,
+			locale: options.locale,
+			baseUrl: options.baseUrl,
+			indexGeneration: options.indexGeneration,
+			strictExternalOrigins: options.strictExternalOrigins,
+			filters,
+			requireCurrentIndexGeneration
+		});
+		if (!options.explain) return enriched.map((result) => {
+			const { explanation: _explanation, ...resultWithoutExplanation } = result;
+			return resultWithoutExplanation;
+		});
+		return explainDocsSearchResults({
+			results: enriched,
+			documents: getDocuments(),
+			query: options.query,
+			filters,
+			warnings: getExplanationWarnings(),
+			unverifiableAmbiguityFields: getExplanationUnverifiableAmbiguityFields(),
+			provider: search.provider,
+			rankOffset: options.offset ?? 0,
+			resolveRankingStrategy: typeof ranking === "function" ? ranking : () => ranking
+		});
+	};
 	const createLocalPage = async () => {
 		const fallback = options.paginated ? await createSimpleSearchAdapter().searchPage(query, context) : normalizeDocsSearchAdapterPage(await createSimpleSearchAdapter().search(query, context));
 		if (options.expectedTotal !== void 0 && fallback.total !== options.expectedTotal) throw new DocsPaginationCursorError();
 		return {
-			results: await finalizeResults(fallback.results),
+			results: await finalizeResults(fallback.results, "lexical"),
 			total: options.paginated ? fallback.total : fallback.results.length,
 			paginationMode: "local"
 		};
@@ -5084,7 +5154,7 @@ async function performDocsSearchInternal(options) {
 		if (search.provider === "simple") {
 			if (options.expectedTotal !== void 0 && adapterPage.total !== options.expectedTotal) throw new DocsPaginationCursorError();
 			return {
-				results: await finalizeResults(results),
+				results: await finalizeResults(results, "lexical"),
 				total: options.paginated ? adapterPage.total : results.length,
 				paginationMode: "local"
 			};
@@ -5116,7 +5186,7 @@ async function performDocsSearchInternal(options) {
 			const endOffset = (query.offset ?? 0) + safeAdapterResults.length;
 			if (safeAdapterResults.length !== results.length || safeAdapterResults.length > (query.limit ?? search.maxResults) || endOffset > adapterPage.total || requireCurrentIndexGeneration && adapterPage.total === 0 && localAudienceProjectionResults.length > 0 || endOffset < adapterPage.total && safeAdapterResults.length === 0 || adapterPage.nextCursor !== void 0 && options.providerCursor !== void 0 && adapterPage.nextCursor === options.providerCursor || adapterPage.nextCursor !== void 0 && endOffset >= adapterPage.total || options.expectedTotal !== void 0 && adapterPage.total !== options.expectedTotal) return fallBackFromProvider();
 			return {
-				results: await finalizeResults(safeAdapterResults),
+				results: await finalizeResults(safeAdapterResults, "provider"),
 				total: adapterPage.total,
 				...adapterPage.nextCursor !== void 0 ? { nextCursor: adapterPage.nextCursor } : {},
 				paginationMode: "provider"
@@ -5125,20 +5195,30 @@ async function performDocsSearchInternal(options) {
 		if (options.supplementExternalResults === false) {
 			const bounded = safeAdapterResults.slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
 			return {
-				results: await finalizeResults(bounded),
+				results: await finalizeResults(bounded, "provider"),
 				total: bounded.length,
 				paginationMode: "provider"
 			};
 		}
 		const simpleAudienceResults = audience === "agent" || results.length === 0 || safeAdapterResults.length < results.length ? await createSimpleSearchAdapter().search(query, context) : [];
+		const exactPageResults = buildExactPageSearchResults(options.query, scopedPages, audience);
+		const rankingStrategyByResult = /* @__PURE__ */ new Map();
+		for (const [group, strategy] of [
+			[exactPageResults, "exact"],
+			[safeAdapterResults, "provider"],
+			[simpleAudienceResults, "lexical"]
+		]) for (const result of group) {
+			const identity = getDocsSearchExplanationResultIdentity(result);
+			if (!rankingStrategyByResult.has(identity)) rankingStrategyByResult.set(identity, strategy);
+		}
 		const combinedResults = mergeSearchResults([
-			buildExactPageSearchResults(options.query, scopedPages, audience),
+			exactPageResults,
 			safeAdapterResults,
 			simpleAudienceResults
 		], audience === "agent" ? (result) => getAskAIResultKey(result, options.baseUrl, options.strictExternalOrigins) : void 0);
 		const bounded = prioritizeLiteralInsideResults(options.query, combinedResults).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
 		return {
-			results: await finalizeResults(bounded),
+			results: await finalizeResults(bounded, (result) => rankingStrategyByResult.get(getDocsSearchExplanationResultIdentity(result)) ?? "provider"),
 			total: bounded.length,
 			paginationMode: "provider"
 		};
@@ -6350,10 +6430,12 @@ function buildDocsDiagnostics(config, options = {}) {
 					human: search.enabled ? apiQueryRoute("query={query}") : null,
 					agent: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
 					structuredAgent: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured") : null,
+					explainedAgent: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured&explain=true") : null,
 					facets: search.enabled ? apiQueryRoute("audience=agent&response=facets") : null
 				},
 				agentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
 				structuredAgentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured") : null,
+				explainedAgentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent&response=structured&explain=true") : null,
 				facetsEndpoint: search.enabled ? apiQueryRoute("audience=agent&response=facets") : null,
 				audienceParam: "audience",
 				defaultAudience: "human",
@@ -6365,6 +6447,10 @@ function buildDocsDiagnostics(config, options = {}) {
 					tags: "tags"
 				},
 				responseFormat: "docs-search.v1",
+				explainParam: "explain",
+				explainValue: "true",
+				explanationField: "explanation",
+				explanationFormat: "docs-search-explanation.v1",
 				facetsResponseFormat: "docs-search-facets.v1",
 				warningsField: "warnings",
 				facetParam: "facet",
@@ -7170,7 +7256,7 @@ function resolveDocsStandardsOrigin(preferred, fallback) {
 	return new URL(fallback).origin;
 }
 /** Build and serve standards-based discovery without replacing the custom agent manifest. */
-async function createDocsStandardsDiscoveryResponse({ request, preferredSkillDocument, fallbackSkillDocument, origin, entry = "docs", docsPath, apiCatalog: explicitApiCatalog, apiRoute, i18n: _i18n, search: _search, mcp, feedback, llms, sitemap, robots, openapi, markdown: _markdown, publishedSkills, agentCard }) {
+async function createDocsStandardsDiscoveryResponse({ request, preferredSkillDocument, fallbackSkillDocument, origin, entry = "docs", docsPath, apiCatalog: explicitApiCatalog, apiRoute, i18n: _i18n, search: _search, mcp, feedback, llms, sitemap, robots, openapi, markdown: _markdown, publishedSkills, agentCard, lastModified }) {
 	const url = new URL(request.url);
 	const resolvedApiRoute = resolveDocsDiscoveryApiRoute(apiRoute);
 	if (!isDocsStandardsDiscoveryRequest(url, { apiRoute: resolvedApiRoute })) return null;
@@ -7207,6 +7293,7 @@ async function createDocsStandardsDiscoveryResponse({ request, preferredSkillDoc
 		fallbackSkillDocument,
 		publishedSkills,
 		agentCard,
+		lastModified,
 		apiCatalog: apiCatalogEnabled ? buildDocsApiCatalog({
 			origin: catalogOrigin,
 			docsRoute: normalizedDocsPath ? `/${normalizedDocsPath}` : "/",
@@ -7879,34 +7966,6 @@ function renderDocsMarkdownNotFound({ entry = "docs", apiRoute, requestedPath, o
 		markdownUrl: resolveDocsMarkdownMetadataUrl(requestedMarkdownRoute, origin)
 	}), sitemap);
 }
-function hashDocsMarkdownRepresentation(value) {
-	let hash = 2166136261;
-	for (let index = 0; index < value.length; index += 1) {
-		hash ^= value.charCodeAt(index);
-		hash = Math.imul(hash, 16777619);
-	}
-	return (hash >>> 0).toString(16).padStart(8, "0");
-}
-function createDocsMarkdownEtag(document) {
-	return `W/"${document.length.toString(16)}-${hashDocsMarkdownRepresentation(document)}"`;
-}
-function normalizeDocsMarkdownEtag(value) {
-	return value.trim().replace(/^W\//i, "");
-}
-function requestMatchesDocsMarkdownEtag(request, etag) {
-	const header = request.headers.get("if-none-match");
-	if (!header) return false;
-	if (header.trim() === "*") return true;
-	const expected = normalizeDocsMarkdownEtag(etag);
-	return header.split(",").some((candidate) => normalizeDocsMarkdownEtag(candidate) === expected);
-}
-function resolveDocsMarkdownHttpDate(value) {
-	if (!value) return void 0;
-	if (typeof value === "string" && !/(?:T|\s)\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?/.test(value.trim())) return;
-	const date = value instanceof Date ? value : new Date(value);
-	if (Number.isNaN(date.getTime())) return void 0;
-	return date.toUTCString();
-}
 function extractDocsMarkdownLastModified(document) {
 	const frontmatter = document.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1];
 	if (!frontmatter) return void 0;
@@ -7915,14 +7974,6 @@ function extractDocsMarkdownLastModified(document) {
 	if (raw.startsWith("\"") && raw.endsWith("\"") || raw.startsWith("'") && raw.endsWith("'")) return raw.slice(1, -1);
 	return raw;
 }
-function requestHasFreshDocsMarkdownDate(request, lastModified) {
-	if (!lastModified || request.headers.has("if-none-match")) return false;
-	const ifModifiedSince = request.headers.get("if-modified-since");
-	if (!ifModifiedSince) return false;
-	const resourceTime = Date.parse(lastModified);
-	const requestTime = Date.parse(ifModifiedSince);
-	return Number.isFinite(resourceTime) && Number.isFinite(requestTime) && Math.floor(resourceTime / 1e3) <= Math.floor(requestTime / 1e3);
-}
 function resolveDocsMarkdownContentLocation(canonicalUrl) {
 	const url = new URL(canonicalUrl);
 	url.pathname = toDocsMarkdownUrl(url.pathname);
@@ -8003,35 +8054,27 @@ function createDocsMarkdownResponse(options) {
 			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 lastModified = resolveDocsHttpDate(options.lastModified ?? extractDocsMarkdownLastModified(document));
+		return createDocsCacheableResponse({
+			request,
+			content: responseDocument,
+			lastModified,
+			headers: {
+				...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",
+				"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 } : {}
+			}
 		});
 	}
 	const sectionResult = sectionRequest ? selectDocsMarkdownSection(document, sectionRequest) : void 0;
@@ -8047,27 +8090,21 @@ function createDocsMarkdownResponse(options) {
 		...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 lastModified = resolveDocsHttpDate(options.lastModified ?? extractDocsMarkdownLastModified(document));
 	const responseHeaders = {
 		...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)) {
-		const { "Content-Type": _contentType, ...notModifiedHeaders } = responseHeaders;
-		return new Response(null, {
-			status: 304,
-			headers: notModifiedHeaders
-		});
-	}
-	return new Response(responseDocument, {
+	return createDocsCacheableResponse({
+		request,
+		content: responseDocument,
 		status: sectionResult?.found === false ? 404 : 200,
+		lastModified,
 		headers: responseHeaders
 	});
 }
@@ -8118,7 +8155,7 @@ function appendDocsMarkdownNegotiationStartLines(lines, context, variant) {
 }
 function appendDocsSearchStartLine(lines, context, variant) {
 	if (!context.searchEnabled) return;
-	lines.push(`- Discover valid search filters with ${context.apiRoute}?audience=agent&response=facets before choosing framework, version, package, or tags values; continue a large field with facet={field}, limit={limit}, and its nextCursor.`, 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.`);
+	lines.push(`- Discover valid search filters with ${context.apiRoute}?audience=agent&response=facets before choosing framework, version, package, or tags values; continue a large field with facet={field}, limit={limit}, and its nextCursor.`, 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 and add explain=true for retrieval evidence.` : `- Search with ${context.apiRoute}?query={query}&audience=agent&response=structured when the route is unknown; optionally repeat framework, version, package, or tags filters and add explain=true for retrieval evidence.`);
 }
 function appendDocsContentChangesStartLine(lines, context) {
 	if (!context.contentChangesEnabled) return;
@@ -8489,6 +8526,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 			endpoint: apiQueryRoute("query={query}"),
 			agentEndpoint: apiQueryRoute("query={query}&audience=agent"),
 			structuredAgentEndpoint: apiQueryRoute("query={query}&audience=agent&response=structured"),
+			explainedAgentEndpoint: apiQueryRoute("query={query}&audience=agent&response=structured&explain=true"),
 			facetsEndpoint: apiQueryRoute("audience=agent&response=facets"),
 			method: "GET",
 			queryParam: "query",
@@ -8500,6 +8538,10 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 			structuredResponseValue: "structured",
 			facetsResponseValue: "facets",
 			responseFormat: "docs-search.v1",
+			explainParam: "explain",
+			explainValue: "true",
+			explanationField: "explanation",
+			explanationFormat: "docs-search-explanation.v1",
 			facetsResponseFormat: "docs-search-facets.v1",
 			filterParams: {
 				framework: "framework",
@@ -8715,4 +8757,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { matchesDocsLlmsTxtSection as $, isDocsMcpResourcePath as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, normalizeDocsRelated as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, DEFAULT_MCP_WELL_KNOWN_ROUTE as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, getDocsMcpResourcePaths as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, buildDocsMcpProtectedResourceMetadataRoute as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, isDocsMcpRequest as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, digestDocsRetrievalContent as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceExposure as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, DEFAULT_MCP_PUBLIC_ROUTE as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, renderDocsRelatedMarkdownLines as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, DEFAULT_MCP_ROUTE as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpOAuthScopeToken as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, hasDocsMcpProtectedResourceConfig as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, isDocsMcpProtectedResourceMetadataPath as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, normalizeDocsMcpAuthorizationServerUrls as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentLocale as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, resolveDocsMcpProtectedResourceMetadataLocation as nr, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, getDocsMcpProtectedResourceMetadataRoutes as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, resolveDocsMcpResourceLocation as rr, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, normalizeDocsMcpEndpointPath as tr, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, isDocsRetrievalCanonicalUrl as zn, toDocsSitemapMarkdownUrl as zt };
+export { matchesDocsLlmsTxtSection as $, normalizeDocsMcpEndpointPath as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpProtectedResourceMetadataRoutes as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpOAuthScopeToken as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, getDocsMcpResourcePaths as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpAuthorizationServerUrls as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, normalizeDocsRelated as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceExposure as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, DEFAULT_MCP_WELL_KNOWN_ROUTE as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_PUBLIC_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, buildDocsMcpProtectedResourceMetadataRoute as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpRequest as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpProtectedResourceMetadataPath as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, isDocsMcpResourcePath as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, resolveDocsMcpProtectedResourceMetadataLocation as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentLocale as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, hasDocsMcpProtectedResourceConfig as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, resolveDocsMcpResourceLocation as tr, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, renderDocsRelatedMarkdownLines as zn, toDocsSitemapMarkdownUrl as zt };