@farming-labs/docs 0.2.71 → 0.2.73

package/dist/{agent-FIyl4-Oa.mjs → agent-o9OTadrf.mjs}

@@ -1,4 +1,5 @@
-import { F as resolveDocsDiscoveryApiRoute, O as buildDocsApiCatalog, P as isDocsStandardsDiscoveryRequest, S as DOCS_AGENT_MANIFEST_FORMAT, _ 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, j as createDocsStandardsResponse, 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-CYfiQE13.mjs";
+import { S as upsertPageAgentContractMarkdown, b as renderPageAgentFrontmatterYamlLines, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections } 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-BwL5ffGx.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/mcp-auth.ts
@@ -98,595 +99,6 @@ function isAbsoluteHttpUrl(value) {
 	}
 }
 
-//#endregion
-//#region src/agent-contract.ts
-const PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS = [
-	"task",
-	"outcome",
-	"appliesTo",
-	"prerequisites",
-	"files",
-	"commands",
-	"sideEffects",
-	"verification",
-	"rollback",
-	"failureModes"
-];
-const PAGE_AGENT_CONTRACT_FIELDS = ["tokenBudget", ...PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS];
-const PAGE_AGENT_CONTRACT_FIELD_SCHEMA = {
-	tokenBudget: "number",
-	task: "string",
-	outcome: "string",
-	appliesTo: {
-		framework: "string|string[]",
-		version: "string|string[]",
-		package: "string|string[]"
-	},
-	prerequisites: "string[]",
-	files: "string[]",
-	commands: "Array<string|{run,cwd?,description?}>",
-	sideEffects: "string[]",
-	verification: "Array<string|{description?,run?,expect?}>",
-	rollback: "string[]",
-	failureModes: "Array<string|{symptom,resolution?}>"
-};
-const APPLIES_TO_FIELDS = [
-	"framework",
-	"version",
-	"package"
-];
-const COMMAND_FIELDS = [
-	"run",
-	"cwd",
-	"description"
-];
-const VERIFICATION_FIELDS = [
-	"description",
-	"run",
-	"expect"
-];
-const FAILURE_MODE_FIELDS = ["symptom", "resolution"];
-const PAGE_AGENT_CONTRACT_START_MARKER = "<!-- farming-labs:agent-contract:start -->";
-const PAGE_AGENT_CONTRACT_END_MARKER = "<!-- farming-labs:agent-contract:end -->";
-function isRecord(value) {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function normalizeString(value) {
-	if (typeof value !== "string") return void 0;
-	return value.trim() || void 0;
-}
-function normalizeStringList(value) {
-	if (!Array.isArray(value)) return void 0;
-	const seen = /* @__PURE__ */ new Set();
-	const normalized = [];
-	for (const item of value) {
-		const text = normalizeString(item);
-		if (!text || seen.has(text)) continue;
-		seen.add(text);
-		normalized.push(text);
-	}
-	return normalized.length > 0 ? normalized : void 0;
-}
-function normalizeStringOrList(value) {
-	const single = normalizeString(value);
-	if (single) return [single];
-	return normalizeStringList(value);
-}
-function normalizeAppliesTo(value) {
-	if (!isRecord(value)) return void 0;
-	const framework = normalizeStringOrList(value.framework);
-	const version = normalizeStringOrList(value.version);
-	const packageNames = normalizeStringOrList(value.package);
-	if (!framework && !version && !packageNames) return void 0;
-	return {
-		...framework ? { framework } : {},
-		...version ? { version } : {},
-		...packageNames ? { package: packageNames } : {}
-	};
-}
-function normalizeCommands(value) {
-	if (!Array.isArray(value)) return void 0;
-	const commands = [];
-	for (const item of value) {
-		const shorthand = normalizeString(item);
-		if (shorthand) {
-			commands.push(shorthand);
-			continue;
-		}
-		if (!isRecord(item)) continue;
-		const run = normalizeString(item.run);
-		if (!run) continue;
-		const cwd = normalizeString(item.cwd);
-		const description = normalizeString(item.description);
-		commands.push({
-			run,
-			...cwd ? { cwd } : {},
-			...description ? { description } : {}
-		});
-	}
-	return commands.length > 0 ? commands : void 0;
-}
-function normalizeVerification(value) {
-	if (!Array.isArray(value)) return void 0;
-	const verification = [];
-	for (const item of value) {
-		const shorthand = normalizeString(item);
-		if (shorthand) {
-			verification.push(shorthand);
-			continue;
-		}
-		if (!isRecord(item)) continue;
-		const description = normalizeString(item.description);
-		const run = normalizeString(item.run);
-		const expect = normalizeString(item.expect);
-		if (!description && !run && !expect) continue;
-		verification.push({
-			...description ? { description } : {},
-			...run ? { run } : {},
-			...expect ? { expect } : {}
-		});
-	}
-	return verification.length > 0 ? verification : void 0;
-}
-function normalizeFailureModes(value) {
-	if (!Array.isArray(value)) return void 0;
-	const failureModes = [];
-	for (const item of value) {
-		const shorthand = normalizeString(item);
-		if (shorthand) {
-			failureModes.push(shorthand);
-			continue;
-		}
-		if (!isRecord(item)) continue;
-		const symptom = normalizeString(item.symptom);
-		if (!symptom) continue;
-		const resolution = normalizeString(item.resolution);
-		failureModes.push({
-			symptom,
-			...resolution ? { resolution } : {}
-		});
-	}
-	return failureModes.length > 0 ? failureModes : void 0;
-}
-function normalizeTokenBudget(value) {
-	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return void 0;
-	return Math.ceil(value);
-}
-/**
-* Normalize untrusted page frontmatter into the stable agent contract shape.
-* Invalid fields are omitted so malformed author input cannot break page delivery.
-*/
-function normalizePageAgentFrontmatter(value) {
-	if (!isRecord(value)) return void 0;
-	const tokenBudget = normalizeTokenBudget(value.tokenBudget);
-	const task = normalizeString(value.task);
-	const outcome = normalizeString(value.outcome);
-	const appliesTo = normalizeAppliesTo(value.appliesTo);
-	const prerequisites = normalizeStringList(value.prerequisites);
-	const files = normalizeStringList(value.files);
-	const commands = normalizeCommands(value.commands);
-	const sideEffects = normalizeStringList(value.sideEffects);
-	const verification = normalizeVerification(value.verification);
-	const rollback = normalizeStringList(value.rollback);
-	const failureModes = normalizeFailureModes(value.failureModes);
-	const normalized = {
-		...tokenBudget !== void 0 ? { tokenBudget } : {},
-		...task ? { task } : {},
-		...outcome ? { outcome } : {},
-		...appliesTo ? { appliesTo } : {},
-		...prerequisites ? { prerequisites } : {},
-		...files ? { files } : {},
-		...commands ? { commands } : {},
-		...sideEffects ? { sideEffects } : {},
-		...verification ? { verification } : {},
-		...rollback ? { rollback } : {},
-		...failureModes ? { failureModes } : {}
-	};
-	return Object.keys(normalized).length > 0 ? normalized : void 0;
-}
-function hasStructuredPageAgentContract(value) {
-	const normalized = normalizePageAgentFrontmatter(value);
-	if (!normalized) return false;
-	return PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS.some((field) => normalized[field] !== void 0);
-}
-function addStringIssue(issues, object, field) {
-	if (!(field in object)) return;
-	if (!normalizeString(object[field])) issues.push({
-		path: `agent.${field}`,
-		message: "must be a non-empty string"
-	});
-}
-function addStringListIssues(issues, object, field) {
-	if (!(field in object)) return;
-	const value = object[field];
-	if (!Array.isArray(value) || value.length === 0) {
-		issues.push({
-			path: `agent.${field}`,
-			message: "must be a non-empty string array"
-		});
-		return;
-	}
-	value.forEach((item, index) => {
-		if (!normalizeString(item)) issues.push({
-			path: `agent.${field}[${index}]`,
-			message: "must be a non-empty string"
-		});
-	});
-}
-function editDistance(left, right) {
-	const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
-	for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
-		const current = [leftIndex];
-		for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (previous[rightIndex] ?? 0) + 1, (previous[rightIndex - 1] ?? 0) + (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1));
-		previous.splice(0, previous.length, ...current);
-	}
-	return previous[right.length] ?? 0;
-}
-function closestKnownField(field, allowed) {
-	const closest = allowed.map((candidate) => ({
-		candidate,
-		distance: editDistance(field, candidate)
-	})).sort((left, right) => left.distance - right.distance || left.candidate.localeCompare(right.candidate))[0];
-	if (!closest) return void 0;
-	const threshold = Math.max(1, Math.min(3, Math.floor(closest.candidate.length / 3)));
-	return closest.distance <= threshold ? closest.candidate : void 0;
-}
-function addUnknownKeyIssues(issues, object, allowed, path) {
-	for (const field of Object.keys(object)) {
-		if (allowed.includes(field)) continue;
-		const suggestion = closestKnownField(field, allowed);
-		issues.push({
-			path: `${path}.${field}`,
-			message: suggestion ? `is not recognized; did you mean "${path}.${suggestion}"?` : "is not recognized"
-		});
-	}
-}
-/** Return author-facing validation issues without throwing. */
-function getPageAgentFrontmatterIssues(value) {
-	if (value === void 0) return [];
-	if (!isRecord(value)) return [{
-		path: "agent",
-		message: "must be an object"
-	}];
-	const issues = [];
-	addUnknownKeyIssues(issues, value, PAGE_AGENT_CONTRACT_FIELDS, "agent");
-	if ("tokenBudget" in value && (typeof value.tokenBudget !== "number" || !Number.isFinite(value.tokenBudget) || value.tokenBudget <= 0)) issues.push({
-		path: "agent.tokenBudget",
-		message: "must be a positive finite number"
-	});
-	addStringIssue(issues, value, "task");
-	addStringIssue(issues, value, "outcome");
-	if ("appliesTo" in value) if (!isRecord(value.appliesTo)) issues.push({
-		path: "agent.appliesTo",
-		message: "must be an object"
-	});
-	else {
-		addUnknownKeyIssues(issues, value.appliesTo, APPLIES_TO_FIELDS, "agent.appliesTo");
-		for (const field of [
-			"framework",
-			"version",
-			"package"
-		]) {
-			if (!(field in value.appliesTo)) continue;
-			const fieldValue = value.appliesTo[field];
-			if (!normalizeStringOrList(fieldValue)) {
-				issues.push({
-					path: `agent.appliesTo.${field}`,
-					message: "must be a non-empty string or string array"
-				});
-				continue;
-			}
-			if (Array.isArray(fieldValue)) fieldValue.forEach((item, index) => {
-				if (!normalizeString(item)) issues.push({
-					path: `agent.appliesTo.${field}[${index}]`,
-					message: "must be a non-empty string"
-				});
-			});
-		}
-		if (!normalizeAppliesTo(value.appliesTo)) issues.push({
-			path: "agent.appliesTo",
-			message: "must include framework, version, or package"
-		});
-	}
-	for (const field of [
-		"prerequisites",
-		"files",
-		"sideEffects",
-		"rollback"
-	]) addStringListIssues(issues, value, field);
-	if ("commands" in value) if (!Array.isArray(value.commands) || value.commands.length === 0) issues.push({
-		path: "agent.commands",
-		message: "must be a non-empty array"
-	});
-	else value.commands.forEach((command, index) => {
-		if (normalizeString(command)) return;
-		if (!isRecord(command)) {
-			issues.push({
-				path: `agent.commands[${index}]`,
-				message: "must be a command string or an object with a non-empty run field"
-			});
-			return;
-		}
-		addUnknownKeyIssues(issues, command, COMMAND_FIELDS, `agent.commands[${index}]`);
-		if (!normalizeString(command.run)) {
-			issues.push({
-				path: `agent.commands[${index}]`,
-				message: "must be a command string or an object with a non-empty run field"
-			});
-			return;
-		}
-		for (const field of ["cwd", "description"]) if (field in command && !normalizeString(command[field])) issues.push({
-			path: `agent.commands[${index}].${field}`,
-			message: "must be a non-empty string"
-		});
-	});
-	if ("verification" in value) if (!Array.isArray(value.verification) || value.verification.length === 0) issues.push({
-		path: "agent.verification",
-		message: "must be a non-empty array"
-	});
-	else value.verification.forEach((step, index) => {
-		if (normalizeString(step)) return;
-		if (!isRecord(step)) {
-			issues.push({
-				path: `agent.verification[${index}]`,
-				message: "must be a string or an object with description, run, or expect"
-			});
-			return;
-		}
-		addUnknownKeyIssues(issues, step, VERIFICATION_FIELDS, `agent.verification[${index}]`);
-		if (!normalizeVerification([step])) {
-			issues.push({
-				path: `agent.verification[${index}]`,
-				message: "must be a string or an object with description, run, or expect"
-			});
-			return;
-		}
-		for (const field of [
-			"description",
-			"run",
-			"expect"
-		]) if (field in step && !normalizeString(step[field])) issues.push({
-			path: `agent.verification[${index}].${field}`,
-			message: "must be a non-empty string"
-		});
-	});
-	if ("failureModes" in value) if (!Array.isArray(value.failureModes) || value.failureModes.length === 0) issues.push({
-		path: "agent.failureModes",
-		message: "must be a non-empty array"
-	});
-	else value.failureModes.forEach((mode, index) => {
-		if (normalizeString(mode)) return;
-		if (!isRecord(mode)) {
-			issues.push({
-				path: `agent.failureModes[${index}]`,
-				message: "must be a string or an object with a non-empty symptom field"
-			});
-			return;
-		}
-		addUnknownKeyIssues(issues, mode, FAILURE_MODE_FIELDS, `agent.failureModes[${index}]`);
-		if (!normalizeString(mode.symptom)) {
-			issues.push({
-				path: `agent.failureModes[${index}]`,
-				message: "must be a string or an object with a non-empty symptom field"
-			});
-			return;
-		}
-		if ("resolution" in mode && !normalizeString(mode.resolution)) issues.push({
-			path: `agent.failureModes[${index}].resolution`,
-			message: "must be a non-empty string"
-		});
-	});
-	return issues;
-}
-function yamlString(value) {
-	return JSON.stringify(value);
-}
-function renderYamlStringList(lines, indent, key, values) {
-	lines.push(`${indent}${key}:`);
-	for (const value of values) lines.push(`${indent}  - ${yamlString(value)}`);
-}
-function renderYamlObjectList(lines, indent, key, values, fields) {
-	lines.push(`${indent}${key}:`);
-	for (const value of values) {
-		if (typeof value === "string") {
-			lines.push(`${indent}  - ${yamlString(value)}`);
-			continue;
-		}
-		const record = value;
-		const firstField = fields.find((field) => normalizeString(record[field]));
-		if (!firstField) continue;
-		lines.push(`${indent}  - ${firstField}: ${yamlString(normalizeString(record[firstField]))}`);
-		for (const field of fields) {
-			const fieldValue = normalizeString(record[field]);
-			if (field === firstField || !fieldValue) continue;
-			lines.push(`${indent}    ${field}: ${yamlString(fieldValue)}`);
-		}
-	}
-}
-/** Render normalized `agent` YAML in a stable field order. */
-function renderPageAgentFrontmatterYamlLines(value, indentation = 0) {
-	const agent = normalizePageAgentFrontmatter(value);
-	if (!agent) return [];
-	const indent = " ".repeat(Math.max(0, indentation));
-	const child = `${indent}  `;
-	const lines = [`${indent}agent:`];
-	if (agent.tokenBudget !== void 0) lines.push(`${child}tokenBudget: ${agent.tokenBudget}`);
-	if (agent.task) lines.push(`${child}task: ${yamlString(agent.task)}`);
-	if (agent.outcome) lines.push(`${child}outcome: ${yamlString(agent.outcome)}`);
-	if (agent.appliesTo) {
-		lines.push(`${child}appliesTo:`);
-		const appliesIndent = `${child}  `;
-		for (const field of [
-			"framework",
-			"version",
-			"package"
-		]) {
-			const values = normalizeStringOrList(agent.appliesTo[field]);
-			if (values) renderYamlStringList(lines, appliesIndent, field, values);
-		}
-	}
-	if (agent.prerequisites) renderYamlStringList(lines, child, "prerequisites", agent.prerequisites);
-	if (agent.files) renderYamlStringList(lines, child, "files", agent.files);
-	if (agent.commands) renderYamlObjectList(lines, child, "commands", agent.commands, [
-		"run",
-		"cwd",
-		"description"
-	]);
-	if (agent.sideEffects) renderYamlStringList(lines, child, "sideEffects", agent.sideEffects);
-	if (agent.verification) renderYamlObjectList(lines, child, "verification", agent.verification, [
-		"description",
-		"run",
-		"expect"
-	]);
-	if (agent.rollback) renderYamlStringList(lines, child, "rollback", agent.rollback);
-	if (agent.failureModes) renderYamlObjectList(lines, child, "failureModes", agent.failureModes, ["symptom", "resolution"]);
-	return lines;
-}
-function inlineCode(value) {
-	const longestRun = Math.max(0, ...[...value.matchAll(/`+/g)].map((match) => match[0].length));
-	const fence = "`".repeat(longestRun + 1);
-	const padding = value.startsWith("`") || value.endsWith("`") ? " " : "";
-	return `${fence}${padding}${value}${padding}${fence}`;
-}
-function renderTextList(lines, title, values, code = false) {
-	lines.push("", `### ${title}`, "");
-	for (const value of values) lines.push(`- ${code ? inlineCode(value) : value}`);
-}
-/** Render the structured contract as deterministic, compact machine-readable Markdown. */
-function renderPageAgentContractMarkdown(value) {
-	const agent = normalizePageAgentFrontmatter(value);
-	if (!agent || !hasStructuredPageAgentContract(agent)) return "";
-	const lines = [PAGE_AGENT_CONTRACT_START_MARKER, "## Agent Contract"];
-	if (agent.task) lines.push("", `Task: ${agent.task}`);
-	if (agent.outcome) lines.push(`Outcome: ${agent.outcome}`);
-	if (agent.appliesTo) {
-		lines.push("", "### Applies To", "");
-		for (const [label, field] of [
-			["Framework", "framework"],
-			["Version", "version"],
-			["Package", "package"]
-		]) {
-			const values = normalizeStringOrList(agent.appliesTo[field]);
-			if (values) lines.push(`- ${label}: ${values.map(inlineCode).join(", ")}`);
-		}
-	}
-	if (agent.prerequisites) renderTextList(lines, "Prerequisites", agent.prerequisites);
-	if (agent.files) renderTextList(lines, "Files", agent.files, true);
-	if (agent.commands) {
-		lines.push("", "### Commands", "");
-		for (const command of agent.commands) {
-			if (typeof command === "string") {
-				lines.push(`- ${inlineCode(command)}`);
-				continue;
-			}
-			const details = [command.cwd ? `cwd ${inlineCode(command.cwd)}` : void 0, command.description].filter(Boolean);
-			lines.push(`- ${inlineCode(command.run)}${details.length ? ` — ${details.join("; ")}` : ""}`);
-		}
-	}
-	if (agent.sideEffects) renderTextList(lines, "Side Effects", agent.sideEffects);
-	if (agent.verification) {
-		lines.push("", "### Verification", "");
-		for (const step of agent.verification) {
-			if (typeof step === "string") {
-				lines.push(`- ${step}`);
-				continue;
-			}
-			const summary = step.description ?? (step.run ? `Run ${inlineCode(step.run)}` : step.expect ?? "Verification step");
-			lines.push(`- ${summary}`);
-			if (step.run && step.description) lines.push(`  - Run: ${inlineCode(step.run)}`);
-			if (step.expect && step.expect !== summary) lines.push(`  - Expected: ${step.expect}`);
-		}
-	}
-	if (agent.rollback) renderTextList(lines, "Rollback", agent.rollback);
-	if (agent.failureModes) {
-		lines.push("", "### Failure Modes", "");
-		for (const mode of agent.failureModes) {
-			if (typeof mode === "string") {
-				lines.push(`- ${mode}`);
-				continue;
-			}
-			lines.push(`- ${mode.symptom}${mode.resolution ? ` — Recovery: ${mode.resolution}` : ""}`);
-		}
-	}
-	lines.push(PAGE_AGENT_CONTRACT_END_MARKER);
-	return lines.join("\n");
-}
-/** Remove generated contract blocks while preserving handwritten guidance. */
-function stripGeneratedPageAgentContractMarkdown(markdown) {
-	const newline = markdown.includes("\r\n") ? "\r\n" : "\n";
-	const output = [];
-	let fence;
-	let pendingBlock;
-	let skipEmptySeparator = false;
-	for (const line of markdown.split(/\r?\n/)) {
-		if (pendingBlock) {
-			pendingBlock.push(line);
-			if (isGeneratedAgentContractMarker(line, PAGE_AGENT_CONTRACT_END_MARKER)) {
-				pendingBlock = void 0;
-				skipEmptySeparator = true;
-			}
-			continue;
-		}
-		if (!fence && isGeneratedAgentContractMarker(line, PAGE_AGENT_CONTRACT_START_MARKER)) {
-			pendingBlock = [line];
-			continue;
-		}
-		if (skipEmptySeparator && line.length === 0) continue;
-		skipEmptySeparator = false;
-		output.push(line);
-		fence = advanceMarkdownFence(line, fence);
-	}
-	if (pendingBlock) output.push(...pendingBlock);
-	while (output[0] === "") output.shift();
-	return output.join(newline);
-}
-function isGeneratedAgentContractMarker(line, marker) {
-	if (line.trim() !== marker) return false;
-	const markerIndex = line.indexOf(marker);
-	return markerIndex <= 3 && /^ *$/.test(line.slice(0, markerIndex));
-}
-function advanceMarkdownFence(line, fence) {
-	if (fence) {
-		const closing = /^ {0,3}(`+|~+)[\t ]*$/.exec(line)?.[1];
-		if (closing?.[0] === fence.character && closing.length >= fence.length) return;
-		return fence;
-	}
-	const opening = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
-	if (!opening?.[1]) return void 0;
-	if (opening[1][0] === "`" && opening[2]?.includes("`")) return void 0;
-	return {
-		character: opening[1][0],
-		length: opening[1].length
-	};
-}
-function isAgentContractHeadingText(value) {
-	return value.trim().toLowerCase() === "agent contract";
-}
-function hasPageAgentContractHeading(markdown) {
-	let fence;
-	let previousLine;
-	for (const line of markdown.split(/\r?\n/)) {
-		const nextFence = advanceMarkdownFence(line, fence);
-		if (fence || nextFence) {
-			fence = nextFence;
-			previousLine = void 0;
-			continue;
-		}
-		const atxText = /^ {0,3}#{1,6}(?:[\t ]+|$)(.*)$/.exec(line)?.[1]?.replace(/[\t ]+#+[\t ]*$/, "").trim();
-		if (atxText && isAgentContractHeadingText(atxText)) return true;
-		if (previousLine && /^ {0,3}(?:=+|-+)[\t ]*$/.test(line) && isAgentContractHeadingText(previousLine)) return true;
-		previousLine = line.trim().length > 0 && !/^ {4}/.test(line) && !/^ {0,3}\t/.test(line) ? line : void 0;
-	}
-	return false;
-}
-/** Insert one generated contract unless the document already has handwritten contract guidance. */
-function upsertPageAgentContractMarkdown(markdown, value) {
-	const cleaned = stripGeneratedPageAgentContractMarkdown(markdown);
-	const contract = renderPageAgentContractMarkdown(value);
-	if (!contract || hasPageAgentContractHeading(cleaned)) return cleaned;
-	return cleaned ? `${contract}\n\n${cleaned.replace(/^\r?\n+/, "")}` : contract;
-}
-
 //#endregion
 //#region src/related.ts
 function normalizeDocsRelated(value) {
@@ -736,148 +148,6 @@ 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";
@@ -2146,6 +1416,543 @@ function findProtectedRanges(content) {
 	const htmlLiterals = findHtmlLiteralRanges(content, excludedRanges);
 	return mergeProtectedRanges([...excludedRanges, ...htmlLiterals]);
 }
+function findMarkdownLinkLiteralRanges(content) {
+	try {
+		const offsetAdjustment = content.startsWith("") ? 1 : 0;
+		const tree = docsAudienceMarkdownProcessor.parse(offsetAdjustment > 0 ? content.slice(offsetAdjustment) : content);
+		const ranges = [];
+		const visit = (node) => {
+			const rawStart = getOffset(node.position, "start");
+			const rawEnd = getOffset(node.position, "end");
+			const start = rawStart === void 0 ? void 0 : rawStart + offsetAdjustment;
+			const end = rawEnd === void 0 ? void 0 : rawEnd + offsetAdjustment;
+			if (start !== void 0 && end !== void 0 && (node.type === "link" || node.type === "image" || node.type === "linkReference" || node.type === "imageReference")) {
+				ranges.push({
+					start,
+					end
+				});
+				return;
+			}
+			for (const child of node.children ?? []) visit(child);
+		};
+		visit(tree);
+		return ranges;
+	} catch {
+		return [];
+	}
+}
+function findDocsMarkdownPromptBracketLiteralRanges(content, protectedRanges) {
+	const ranges = [];
+	let cursor = 0;
+	while (cursor < content.length) {
+		const index = content.indexOf("[", cursor);
+		if (index === -1 || isEscapedAt(content, index) || isInsideRange(index, protectedRanges)) {
+			if (index === -1) break;
+			cursor = index + 1;
+			continue;
+		}
+		let depth = 1;
+		let end = index + 1;
+		while (end < content.length && depth > 0) {
+			if (content[end] === "\\") {
+				end += 2;
+				continue;
+			}
+			if (content[end] === "[") depth += 1;
+			if (content[end] === "]") depth -= 1;
+			end += 1;
+		}
+		if (depth !== 0) {
+			cursor = index + 1;
+			continue;
+		}
+		const label = content.slice(index + 1, end - 1);
+		if (/<Prompt(?=[\s/>])/.test(label) && /<\/Prompt\s*>/.test(label)) {
+			let rangeEnd = end;
+			if (content[rangeEnd] === "[") {
+				let referenceEnd = rangeEnd + 1;
+				while (referenceEnd < content.length) {
+					if (content[referenceEnd] === "\\") {
+						referenceEnd += 2;
+						continue;
+					}
+					if (content[referenceEnd] === "]") {
+						referenceEnd += 1;
+						break;
+					}
+					referenceEnd += 1;
+				}
+				if (content[referenceEnd - 1] === "]") rangeEnd = referenceEnd;
+			}
+			ranges.push({
+				start: content[index - 1] === "!" ? index - 1 : index,
+				end: rangeEnd
+			});
+		}
+		cursor = end;
+	}
+	return ranges;
+}
+const DOCS_MARKDOWN_INTRINSIC_CONTAINER_NAMES = new Set([
+	"a",
+	"abbr",
+	"address",
+	"article",
+	"aside",
+	"audio",
+	"b",
+	"bdi",
+	"bdo",
+	"blockquote",
+	"body",
+	"button",
+	"canvas",
+	"caption",
+	"cite",
+	"code",
+	"colgroup",
+	"data",
+	"datalist",
+	"dd",
+	"del",
+	"details",
+	"dfn",
+	"dialog",
+	"div",
+	"dl",
+	"dt",
+	"em",
+	"fieldset",
+	"figcaption",
+	"figure",
+	"footer",
+	"form",
+	"h1",
+	"h2",
+	"h3",
+	"h4",
+	"h5",
+	"h6",
+	"head",
+	"header",
+	"hgroup",
+	"html",
+	"i",
+	"iframe",
+	"ins",
+	"kbd",
+	"label",
+	"legend",
+	"li",
+	"main",
+	"map",
+	"mark",
+	"math",
+	"menu",
+	"meter",
+	"nav",
+	"noembed",
+	"noframes",
+	"noscript",
+	"object",
+	"ol",
+	"optgroup",
+	"option",
+	"output",
+	"p",
+	"picture",
+	"pre",
+	"progress",
+	"q",
+	"rp",
+	"rt",
+	"ruby",
+	"s",
+	"samp",
+	"script",
+	"search",
+	"section",
+	"select",
+	"slot",
+	"small",
+	"span",
+	"strong",
+	"style",
+	"sub",
+	"summary",
+	"sup",
+	"svg",
+	"table",
+	"tbody",
+	"td",
+	"template",
+	"textarea",
+	"tfoot",
+	"th",
+	"thead",
+	"time",
+	"title",
+	"tr",
+	"u",
+	"ul",
+	"var",
+	"video",
+	"xmp"
+]);
+function normalizeDocsMarkdownIntrinsicContainerName(name) {
+	const normalized = name.toLowerCase();
+	if (!DOCS_MARKDOWN_INTRINSIC_CONTAINER_NAMES.has(normalized)) return void 0;
+	const isLowercase = name === normalized;
+	const isUppercase = name === name.toUpperCase() && /[A-Z]/.test(name);
+	return isLowercase || isUppercase ? normalized : void 0;
+}
+function readDocsMarkdownPromptTagAt(content, index) {
+	const closing = content[index + 1] === "/";
+	const nameStart = index + (closing ? 2 : 1);
+	if (!content.startsWith("Prompt", nameStart) || !/[\s/>]/.test(content[nameStart + 6] ?? "")) return;
+	const tag = readGenericMdxJsxTag(content, index);
+	if (!tag) return void 0;
+	const attributesStart = nameStart + 6;
+	let attributesEnd = tag.end - 1;
+	while (attributesEnd > attributesStart && /\s/.test(content[attributesEnd - 1] ?? "")) attributesEnd -= 1;
+	if (content[attributesEnd - 1] === "/") attributesEnd -= 1;
+	return {
+		attributes: closing ? "" : content.slice(attributesStart, attributesEnd),
+		closing,
+		end: tag.end,
+		index,
+		selfClosing: tag.selfClosing
+	};
+}
+function findDocsMarkdownHtmlContainerLiteralRanges(content, protectedRanges) {
+	const ranges = [];
+	const openings = [];
+	let cursor = 0;
+	while (cursor < content.length) {
+		const index = content.indexOf("<", cursor);
+		if (index === -1) break;
+		if (isEscapedAt(content, index) || isInsideRange(index, protectedRanges)) {
+			cursor = index + 1;
+			continue;
+		}
+		const closing = content[index + 1] === "/";
+		const nameStart = index + (closing ? 2 : 1);
+		let nameEnd = nameStart;
+		while (/[\w:.-]/.test(content[nameEnd] ?? "")) nameEnd += 1;
+		const name = normalizeDocsMarkdownIntrinsicContainerName(content.slice(nameStart, nameEnd));
+		if (!name) {
+			cursor = index + 1;
+			continue;
+		}
+		const tag = readGenericMdxJsxTag(content, index);
+		if (!tag) {
+			cursor = index + 1;
+			continue;
+		}
+		cursor = tag.end;
+		if (!closing) {
+			if (!tag.selfClosing) openings.push({
+				name,
+				start: index
+			});
+			continue;
+		}
+		let openingIndex = openings.length - 1;
+		while (openingIndex >= 0 && openings[openingIndex].name !== name) openingIndex -= 1;
+		if (openingIndex < 0) continue;
+		const [opening] = openings.splice(openingIndex);
+		ranges.push({
+			start: opening.start,
+			end: tag.end
+		});
+	}
+	return ranges;
+}
+function isStandaloneDocsMarkdownPromptHtmlRange(content, start, end) {
+	while (start < end && /\s/.test(content[start] ?? "")) start += 1;
+	while (end > start && /\s/.test(content[end - 1] ?? "")) end -= 1;
+	return readDocsMarkdownPromptTagAt(content, start) !== void 0;
+}
+function findDocsMarkdownRawHtmlLiteralRanges(content) {
+	try {
+		const offsetAdjustment = content.startsWith("") ? 1 : 0;
+		const tree = docsAudienceMarkdownProcessor.parse(offsetAdjustment > 0 ? content.slice(offsetAdjustment) : content);
+		const ranges = [];
+		const visit = (node) => {
+			const rawStart = getOffset(node.position, "start");
+			const rawEnd = getOffset(node.position, "end");
+			const start = rawStart === void 0 ? void 0 : rawStart + offsetAdjustment;
+			const end = rawEnd === void 0 ? void 0 : rawEnd + offsetAdjustment;
+			if (node.type === "html" && start !== void 0 && end !== void 0) {
+				if (isStandaloneDocsMarkdownPromptHtmlRange(content, start, end)) return;
+				const elementName = content.slice(start, end).trimStart().match(/^<\/?([A-Za-z][\w:.-]*)(?=[\s/>])/)?.[1];
+				if (elementName && !normalizeDocsMarkdownIntrinsicContainerName(elementName)) return;
+				let cursor = start;
+				let promptDepth = 0;
+				let trailingClosingPrompt;
+				while (cursor < end) {
+					const index = content.indexOf("<", cursor);
+					if (index === -1 || index >= end) break;
+					const tag = readDocsMarkdownPromptTagAt(content, index);
+					if (!tag || tag.end > end) {
+						cursor = index + 1;
+						continue;
+					}
+					if (!tag.closing && !tag.selfClosing) promptDepth += 1;
+					else if (tag.closing && promptDepth > 0) promptDepth -= 1;
+					else if (tag.closing && content.slice(tag.end, end).trim().length === 0) trailingClosingPrompt = tag.index;
+					cursor = tag.end;
+				}
+				const literalEnd = trailingClosingPrompt ?? end;
+				if (literalEnd > start) ranges.push({
+					start,
+					end: literalEnd
+				});
+				return;
+			}
+			for (const child of node.children ?? []) visit(child);
+		};
+		visit(tree);
+		return ranges;
+	} catch {
+		return [];
+	}
+}
+function findDocsMarkdownPromptAstInfo(content) {
+	try {
+		const prepared = prepareMdxParserSource(content);
+		const offsetAdjustment = prepared.startsWith("") ? 1 : 0;
+		const tree = docsAudienceMdxProcessor.parse(offsetAdjustment > 0 ? prepared.slice(offsetAdjustment) : prepared);
+		const flowStarts = /* @__PURE__ */ new Set();
+		const starts = /* @__PURE__ */ new Set();
+		const visit = (node) => {
+			if (node.name === "Prompt" && (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && getOffset(node.position, "start") !== void 0) {
+				const start = getOffset(node.position, "start") + offsetAdjustment;
+				starts.add(start);
+				if (node.type === "mdxJsxFlowElement") flowStarts.add(start);
+			}
+			for (const child of node.children ?? []) visit(child);
+		};
+		visit(tree);
+		return {
+			flowStarts,
+			starts
+		};
+	} catch {
+		return;
+	}
+}
+function findDocsMarkdownPromptExpressionRanges(content, protectedRanges) {
+	const ranges = [];
+	let protectedIndex = 0;
+	let cursor = 0;
+	while (cursor < content.length) {
+		const start = content.indexOf("{", cursor);
+		if (start === -1) break;
+		if (isEscapedAt(content, start) || isInsideRange(start, protectedRanges)) {
+			cursor = start + 1;
+			continue;
+		}
+		let depth = 1;
+		let end = start + 1;
+		while (end < content.length && depth > 0) {
+			while (protectedIndex < protectedRanges.length && protectedRanges[protectedIndex].end <= end) protectedIndex += 1;
+			const candidate = protectedRanges[protectedIndex];
+			const protectedRange = candidate && end >= candidate.start && end < candidate.end ? candidate : void 0;
+			if (protectedRange) {
+				end = protectedRange.end;
+				continue;
+			}
+			if (content[end] === "{") depth += 1;
+			if (content[end] === "}") depth -= 1;
+			end += 1;
+		}
+		ranges.push({
+			start,
+			end: depth === 0 ? end : content.length
+		});
+		if (depth !== 0) break;
+		cursor = end;
+	}
+	return ranges;
+}
+function createDocsMarkdownPromptToken(content, used, startAt) {
+	let index = startAt;
+	let token = "";
+	do {
+		token = `%%PROMPT_${index}%%`;
+		index += 1;
+	} while (content.includes(token) || used.has(token));
+	return token;
+}
+function isFallbackDocsMarkdownPromptFlow(content, opening, closing) {
+	const lineStart = Math.max(0, content.lastIndexOf("\n", opening.index - 1) + 1);
+	const prefix = content.slice(lineStart, opening.index);
+	if (!/^[\t ]{0,3}$/.test(prefix)) return false;
+	const lineEnd = content.indexOf("\n", closing.end);
+	const suffix = content.slice(closing.end, lineEnd === -1 ? content.length : lineEnd);
+	return content.slice(opening.end, closing.index).includes("\n") || /^[\t\r ]*$/.test(suffix);
+}
+function resolveDocsMarkdownPromptContainer(content, opening) {
+	const lineStart = Math.max(0, content.lastIndexOf("\n", opening.index - 1) + 1);
+	let prefix = content.slice(lineStart, opening.index);
+	let blockquoteDepth = 0;
+	let listIndent = 0;
+	while (true) {
+		const blockquote = /^ {0,3}>[\t ]?/.exec(prefix);
+		if (!blockquote) break;
+		blockquoteDepth += 1;
+		prefix = prefix.slice(blockquote[0].length);
+	}
+	while (true) {
+		const list = /^ {0,3}(?:[-+*]|\d{1,9}[.)])[\t ]+/.exec(prefix);
+		if (!list) break;
+		listIndent += list[0].length;
+		prefix = prefix.slice(list[0].length);
+	}
+	if (listIndent === 0 && /^[\t ]+$/.test(prefix)) {
+		let previousLineEnd = Math.max(0, lineStart - 1);
+		while (previousLineEnd > 0) {
+			const previousLineStart = Math.max(0, content.lastIndexOf("\n", previousLineEnd - 1) + 1);
+			let previousLine = content.slice(previousLineStart, previousLineEnd).replace(/\r$/, "");
+			for (let depth = 0; depth < blockquoteDepth; depth += 1) {
+				const blockquote = /^ {0,3}>[\t ]?/.exec(previousLine);
+				if (!blockquote) {
+					previousLine = "";
+					break;
+				}
+				previousLine = previousLine.slice(blockquote[0].length);
+			}
+			const list = /^ {0,3}(?:[-+*]|\d{1,9}[.)])[\t ]+/.exec(previousLine);
+			if (list && prefix.length >= list[0].length) {
+				listIndent = list[0].length;
+				break;
+			}
+			if (previousLine.trim().length === 0) break;
+			previousLineEnd = Math.max(0, previousLineStart - 1);
+		}
+	}
+	if (blockquoteDepth === 0 && listIndent === 0 || !/^[\t ]*$/.test(prefix)) return;
+	return {
+		blockquoteDepth,
+		listIndent
+	};
+}
+function stripDocsMarkdownPromptContainer(children, container) {
+	if (!container) return children;
+	return children.split(/(\r?\n)/).map((segment, index) => {
+		if (index % 2 === 1) return segment;
+		let line = segment;
+		for (let depth = 0; depth < container.blockquoteDepth; depth += 1) {
+			const blockquote = /^ {0,3}>[\t ]?/.exec(line);
+			if (!blockquote) break;
+			line = line.slice(blockquote[0].length);
+		}
+		let remainingIndent = container.listIndent;
+		while (remainingIndent > 0 && /^[\t ]/.test(line)) {
+			line = line.slice(1);
+			remainingIndent -= 1;
+		}
+		return line;
+	}).join("");
+}
+function createDocsMarkdownPromptReplacement(content, start, end, token, flow, container, adjacentFlowBefore = false, adjacentFlowAfter = false) {
+	if (!flow || container) return token;
+	const newline = content.includes("\r\n") ? "\r\n" : "\n";
+	const before = content.slice(0, start);
+	const after = content.slice(end);
+	const leading = adjacentFlowBefore || before.length === 0 || /(?:\r?\n){2}$/.test(before) ? "" : /\r?\n$/.test(before) ? newline : newline + newline;
+	const trailing = adjacentFlowAfter || after.length === 0 || /^(?:\r?\n){2}/.test(after) ? "" : /^\r?\n/.test(after) ? newline : newline + newline;
+	return leading + token + trailing;
+}
+/**
+* Extract live MDX Prompt blocks while leaving Markdown literals untouched.
+*
+* Prompt bodies are copyable source, so callers can safely run audience,
+* reference-definition, and heading passes over `markdown`, then restore each
+* block from its token. Fences (including container fences), inline code, links,
+* comments, raw elements, and other literal contexts are never extracted.
+*/
+function extractDocsMarkdownPromptBlocks(content) {
+	if (!/<Prompt(?=[\s/>])/.test(content)) return {
+		blocks: [],
+		markdown: content
+	};
+	const syntaxProtectedRanges = mergeProtectedRanges([...findProtectedRanges(content), ...findMarkdownLinkLiteralRanges(content)]);
+	const expressionRanges = findDocsMarkdownPromptExpressionRanges(content, syntaxProtectedRanges);
+	const baseProtectedRanges = mergeProtectedRanges([
+		...syntaxProtectedRanges,
+		...expressionRanges,
+		...findDocsMarkdownRawHtmlLiteralRanges(content),
+		...findDocsMarkdownHtmlContainerLiteralRanges(content, syntaxProtectedRanges)
+	]);
+	const protectedRanges = mergeProtectedRanges([...baseProtectedRanges, ...findDocsMarkdownPromptBracketLiteralRanges(content, baseProtectedRanges)]);
+	const promptAst = findDocsMarkdownPromptAstInfo(content);
+	const pairs = [];
+	const openings = [];
+	let cursor = 0;
+	while (cursor < content.length) {
+		const index = content.indexOf("<", cursor);
+		if (index === -1) break;
+		if (isEscapedAt(content, index) || isInsideRange(index, protectedRanges)) {
+			cursor = index + 1;
+			continue;
+		}
+		const tag = readDocsMarkdownPromptTagAt(content, index);
+		if (!tag) {
+			cursor = index + 1;
+			continue;
+		}
+		cursor = tag.end;
+		if (!tag.closing) {
+			if (promptAst && !promptAst.starts.has(tag.index)) continue;
+			if (!tag.selfClosing) openings.push({
+				completedChildren: [],
+				tag
+			});
+			continue;
+		}
+		const frame = openings.pop();
+		if (!frame) continue;
+		const container = resolveDocsMarkdownPromptContainer(content, frame.tag);
+		const pair = {
+			attributes: frame.tag.attributes,
+			children: stripDocsMarkdownPromptContainer(content.slice(frame.tag.end, tag.index), container),
+			container,
+			end: tag.end,
+			flow: promptAst?.flowStarts.has(frame.tag.index) === true || isFallbackDocsMarkdownPromptFlow(content, frame.tag, tag),
+			start: frame.tag.index
+		};
+		const parent = openings.at(-1);
+		if (parent) parent.completedChildren.push(pair);
+		else pairs.push(pair);
+	}
+	for (const frame of openings) pairs.push(...frame.completedChildren);
+	pairs.sort((left, right) => left.start - right.start);
+	if (pairs.length === 0) return {
+		blocks: [],
+		markdown: content
+	};
+	const usedTokens = /* @__PURE__ */ new Set();
+	const blocks = pairs.map((pair, index) => {
+		const token = createDocsMarkdownPromptToken(content, usedTokens, index);
+		usedTokens.add(token);
+		return {
+			attributes: pair.attributes,
+			children: pair.children,
+			token
+		};
+	});
+	let markdown = content;
+	for (let index = pairs.length - 1; index >= 0; index -= 1) {
+		const replacement = createDocsMarkdownPromptReplacement(content, pairs[index].start, pairs[index].end, blocks[index].token, pairs[index].flow, pairs[index].container, index > 0 && pairs[index - 1].flow && /^[\t \r\n]*$/.test(content.slice(pairs[index - 1].end, pairs[index].start)), index + 1 < pairs.length && pairs[index + 1].flow && /^[\t \r\n]*$/.test(content.slice(pairs[index].end, pairs[index + 1].start)));
+		markdown = markdown.slice(0, pairs[index].start) + replacement + markdown.slice(pairs[index].end);
+	}
+	return {
+		blocks,
+		markdown
+	};
+}
 function normalizeProjectedWhitespace(content) {
 	const protectedRanges = findProtectedRanges(content);
 	return content.replace(/\n{3,}/g, (newlines, offset) => {
@@ -2320,7 +2127,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_MARKDOWN_SECTION_INDEX_FORMAT = "docs-markdown-sections.v2";
 const DOCS_AI_AGENT_USER_AGENT_PATTERNS = [
 	"claudebot",
 	"claude-searchbot",
@@ -2389,6 +2196,7 @@ const DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN = buildDocsUserAgentHeaderPattern(
 const DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN = buildDocsUserAgentHeaderPattern(DOCS_TRADITIONAL_BOT_USER_AGENT_PATTERNS);
 const DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN = buildDocsUserAgentHeaderPattern(DOCS_BOT_LIKE_USER_AGENT_TERMS);
 const DOCS_LLMS_TXT_DIRECTIVE_LINE = "LLM index: /llms.txt";
+const DOCS_MARKDOWN_GENERATED_PREAMBLE_FIELD = "x_farming_labs_generated_preamble";
 const DOCS_MCP_SERVICE_SUBDOMAIN_LABELS = new Set([
 	"api",
 	"developer",
@@ -2610,12 +2418,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"
 			},
@@ -3127,7 +2945,9 @@ function validateDocsAgentFeedbackPayload(value, schema, valuePath = "payload")
 	}
 }
 function toDocsMarkdownUrl(url, options = {}) {
-	const [withoutHash, hash = ""] = url.split("#", 2);
+	const hashIndex = url.indexOf("#");
+	const withoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
+	const hash = hashIndex >= 0 ? url.slice(hashIndex + 1) : "";
 	const [pathname, query = ""] = withoutHash.split("?", 2);
 	const normalizedPath = normalizeDocsUrlPath(pathname || "/");
 	const markdownPath = normalizedPath.endsWith(".md") ? normalizedPath : `${normalizedPath}.md`;
@@ -3758,7 +3578,7 @@ function resolveDocsMarkdownMetadataUrl(value, origin) {
 		return value;
 	}
 }
-function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, agent }) {
+function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, agent, generatedPreamble }) {
 	return [
 		"---",
 		`title: ${toYamlString(title)}`,
@@ -3766,6 +3586,7 @@ function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markd
 		`canonical_url: ${toYamlString(canonicalUrl)}`,
 		`markdown_url: ${toYamlString(markdownUrl)}`,
 		...lastUpdated ? [`last_updated: ${toYamlString(lastUpdated)}`] : [],
+		...generatedPreamble ? [`${DOCS_MARKDOWN_GENERATED_PREAMBLE_FIELD}: true`] : [],
 		...renderPageAgentFrontmatterYamlLines(agent),
 		"---"
 	].join("\n");
@@ -3788,14 +3609,14 @@ function stripDocsMarkdownFrontmatter(markdown) {
 		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);
+	const stripped = stripDocsMarkdownFrontmatter(document);
+	const hasGeneratedPreamble = stripped.frontmatter.split(/\r?\n/u).some((line) => line.trim() === `${DOCS_MARKDOWN_GENERATED_PREAMBLE_FIELD}: true`);
+	const lines = stripped.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] ?? "")) {
+	if (hasGeneratedPreamble && /^#(?:\s+|$)/u.test(lines[generatedPreambleStart] ?? "") && /^URL:\s+\S/u.test(lines[generatedPreambleStart + 1] ?? "")) {
+		lines[generatedPreambleStart] = "";
 		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] = "";
@@ -3875,21 +3696,14 @@ function isDocsMarkdownSectionIndexRequest(url) {
 }
 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
-		}];
-	});
+	return parseDocsMarkdownSections(body).map((section) => ({
+		id: section.anchor,
+		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);
@@ -3903,7 +3717,7 @@ function updateDocsMarkdownUrl(value, update) {
 }
 function resolveDocsMarkdownSectionCanonicalUrl(canonicalUrl, sectionId) {
 	return updateDocsMarkdownUrl(canonicalUrl, (url) => {
-		url.hash = sectionId;
+		url.hash = encodeURIComponent(sectionId);
 	});
 }
 function resolveDocsMarkdownSectionFetchUrl(markdownUrl, sectionId, request) {
@@ -3962,7 +3776,7 @@ function buildDocsMarkdownSectionIndex(document, options) {
 		...request.byteBudget ? { byteBudget: request.byteBudget } : {}
 	} : void 0;
 	return {
-		schemaVersion: 1,
+		schemaVersion: 2,
 		format: DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
 		canonicalUrl: options.canonicalUrl,
 		markdownUrl: options.markdownUrl,
@@ -3977,12 +3791,12 @@ function buildDocsMarkdownSectionIndex(document, options) {
 }
 function normalizeRequestedDocsMarkdownSectionId(requestedSection) {
 	let selector = requestedSection.trim();
-	const hashIndex = selector.lastIndexOf("#");
+	const hashIndex = selector.indexOf("#");
 	if (hashIndex >= 0) selector = selector.slice(hashIndex + 1);
 	try {
 		selector = decodeURIComponent(selector);
 	} catch {}
-	return selector.replace(/^#+/u, "").toLowerCase();
+	return selector;
 }
 function selectDocsMarkdownSection(document, request) {
 	const availableSections = collectDocsMarkdownSections(document);
@@ -4000,8 +3814,12 @@ function selectDocsMarkdownSection(document, request) {
 			availableSections
 		};
 	}
+	const rawRequestedId = requestedSection.trim();
+	const rawExactSection = availableSections.find((candidate) => candidate.id === rawRequestedId);
 	const requestedId = normalizeRequestedDocsMarkdownSectionId(requestedSection);
-	const directSection = availableSections.find((candidate) => candidate.id === requestedId);
+	const exactSection = rawExactSection ?? availableSections.find((candidate) => candidate.id === requestedId);
+	const caseInsensitiveSections = exactSection ? [] : availableSections.filter((candidate) => candidate.id.toLowerCase() === requestedId.toLowerCase());
+	const directSection = exactSection ?? (caseInsensitiveSections.length === 1 ? caseInsensitiveSections[0] : void 0);
 	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;
@@ -4078,7 +3896,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}\``);
@@ -4252,10 +4070,10 @@ function createDocsMarkdownResponse(options) {
 	}
 	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 sectionCanonicalUrl = sectionResult?.found && sectionResult.section ? resolveDocsMarkdownSectionCanonicalUrl(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": sectionResult.section ? encodeURIComponent(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),
@@ -4333,7 +4151,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;
@@ -4446,7 +4264,10 @@ function renderDocsMarkdownDocument(page, options) {
 	if (page.description) lines.push(`Description: ${page.description}`);
 	lines.push(...relatedLines);
 	lines.push("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content, page.agent));
-	return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(lines.join("\n"), resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
+	return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(lines.join("\n"), {
+		...resolveDocsMarkdownPageMetadata(page, options),
+		generatedPreamble: true
+	}), options?.sitemap);
 }
 function renderDocsSkillDocument(options) {
 	const { origin } = options;
@@ -4517,7 +4338,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 	return {
 		$schema: DOCS_AGENT_MANIFEST_SCHEMA_URI,
 		format: DOCS_AGENT_MANIFEST_FORMAT,
-		version: "1",
+		version: DOCS_AGENT_MANIFEST_VERSION,
 		name: "@farming-labs/docs",
 		baseUrl: origin,
 		site: {
@@ -4689,12 +4510,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,
@@ -4863,4 +4701,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-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 };
+export { matchesDocsLlmsTxtSection as $, getDocsMcpProtectedResourceMetadataRoutes as $t, buildDocsAgentDiscoverySpec as A, resolveDocsAudienceExposure as At, findDocsMarkdownPage as B, renderDocsSitemapMarkdown as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, findDocsAudienceMdxIssues as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, extractDocsMarkdownPromptBlocks as Et, buildDocsMcpEndpointCandidates as F, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as Ft, isDocsAgentDiscoveryRequest as G, toDocsSitemapMarkdownUrl as Gt, getDocsMarkdownCanonicalLinkHeader as H, resolveDocsSitemapConfig as Ht, collectDocsMarkdownSections as I, DEFAULT_SITEMAP_XML_ROUTE as It, isDocsDiagnosticsRequest as J, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Jt, isDocsAgentsRequest as K, normalizeDocsRelated as Kt, createDocsMarkdownResponse as L, buildDocsSitemapManifest as Lt, buildDocsConfigMap as M, DEFAULT_SITEMAP_MANIFEST_PATH as Mt, buildDocsDiagnostics as N, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, findDocsAudienceMdxTags as Ot, buildDocsMarkdownSectionIndex as P, DEFAULT_SITEMAP_MD_ROUTE as Pt, isDocsSkillRequest as Q, buildDocsMcpProtectedResourceMetadataRoute as Qt, createDocsStandardsDiscoveryResponse as R, createDocsSitemapResponse as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, resolveDocsSitemapPageLastmod as Ut, getDocsLlmsTxtMaxCharsIssue as V, renderDocsSitemapXml as Vt, hasDocsMarkdownSignatureAgent as W, resolveDocsSitemapRequest as Wt, isDocsMarkdownSectionIndexRequest as X, DEFAULT_MCP_ROUTE as Xt, isDocsLlmsTxtPublicRequest as Y, DEFAULT_MCP_PUBLIC_ROUTE as Yt, isDocsPublicGetRequest as Z, DEFAULT_MCP_WELL_KNOWN_ROUTE as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, isDocsMcpResourcePath as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, resolveDocsMcpProtectedResourceMetadataLocation as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, resolveDocsAgentsFormat as dt, getDocsMcpResourcePaths as en, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, isDocsMcpRequest as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, resolveDocsAudienceMdxContent as jt, acceptsDocsMarkdown as k, resolveDocsAgentMdxContent as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, resolveDocsMcpResourceLocation as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, isDocsMcpOAuthScopeToken as nn, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, normalizeDocsMcpAuthorizationServerUrls as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, renderDocsRelatedMarkdownLines as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, isDocsMcpProtectedResourceMetadataPath as rn, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, normalizeDocsMcpEndpointPath as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, hasDocsMcpProtectedResourceConfig as tn, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, readDocsSitemapManifestFromContentMap as zt };