@farming-labs/docs 0.2.52 → 0.2.54

package/dist/{agent-CaOBIVFy.mjs → agent-DXkXi-pS.mjs}

@@ -1,3 +1,592 @@
+//#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) {
 	if (!Array.isArray(value)) return [];
@@ -181,7 +770,7 @@ function buildDocsSitemapManifest(options) {
 		pages.push({
 			url,
 			absoluteUrl: absolutizeUrl(baseUrl, url),
-			markdownUrl: toDocsSitemapMarkdownUrl(url),
+			markdownUrl: page.markdownUrl ?? toDocsSitemapMarkdownUrl(url),
 			title: page.title,
 			description: page.description,
 			sourcePath: page.sourcePath,
@@ -371,10 +960,13 @@ const DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS = {
 	listDocs: true,
 	listPages: true,
 	readPage: true,
+	listTasks: true,
+	readTask: true,
 	searchDocs: true,
 	getNavigation: true,
 	getCodeExamples: true,
-	getConfigSchema: true
+	getConfigSchema: true,
+	getContext: true
 };
 const DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER = "Signature-Agent";
 const DOCS_AI_AGENT_USER_AGENT_PATTERNS = [
@@ -927,10 +1519,13 @@ function resolveDocsDiagnosticsMcp(mcp) {
 			listDocs: tools.listDocs !== false,
 			listPages: tools.listPages !== false,
 			readPage: tools.readPage !== false,
+			listTasks: tools.listTasks !== false,
+			readTask: tools.readTask !== false,
 			searchDocs: tools.searchDocs !== false,
 			getNavigation: tools.getNavigation !== false,
 			getCodeExamples: tools.getCodeExamples !== false,
-			getConfigSchema: tools.getConfigSchema !== false
+			getConfigSchema: tools.getConfigSchema !== false,
+			getContext: tools.getContext !== false
 		}
 	};
 }
@@ -1262,7 +1857,7 @@ function resolveDocsLlmsTxtRequest(url, llms, basePath) {
 function renderLlmsTxtPageList(pages, baseUrl) {
 	let content = "";
 	for (const page of pages) {
-		content += `- [${page.title}](${baseUrl}${toDocsMarkdownUrl(page.url)})`;
+		content += `- [${page.title}](${baseUrl}${page.markdownUrl ?? toDocsMarkdownUrl(page.url)})`;
 		if (page.description) content += `: ${page.description}`;
 		content += "\n";
 	}
@@ -1498,7 +2093,7 @@ function resolveDocsMarkdownRequest(entry, url, request) {
 	if (pathname === `${normalizedEntry}.md`) return { requestedPath: "" };
 	const slugPrefix = `${normalizedEntry}/`;
 	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return { requestedPath: pathname.slice(slugPrefix.length, -3) };
-	if (acceptsMarkdown(request) || hasDocsMarkdownSignatureAgent(request) || detectDocsMarkdownAgentRequest(request).detected) {
+	if (acceptsDocsMarkdown(request) || hasDocsMarkdownSignatureAgent(request) || detectDocsMarkdownAgentRequest(request).detected) {
 		if (pathname === normalizedEntry) return { requestedPath: "" };
 		if (pathname.startsWith(slugPrefix)) return { requestedPath: pathname.slice(slugPrefix.length) };
 	}
@@ -1534,7 +2129,7 @@ function detectDocsMarkdownAgentRequest(request) {
 }
 function getDocsMarkdownVaryHeader(request) {
 	const values = /* @__PURE__ */ new Set();
-	if (acceptsMarkdown(request)) values.add("Accept");
+	if (acceptsDocsMarkdown(request)) values.add("Accept");
 	if (hasDocsMarkdownSignatureAgent(request)) {
 		values.add("Accept");
 		values.add(DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER);
@@ -1680,7 +2275,7 @@ function resolveDocsMarkdownMetadataUrl(value, origin) {
 		return value;
 	}
 }
-function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated }) {
+function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, agent }) {
 	return [
 		"---",
 		`title: ${toYamlString(title)}`,
@@ -1688,6 +2283,7 @@ function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markd
 		`canonical_url: ${toYamlString(canonicalUrl)}`,
 		`markdown_url: ${toYamlString(markdownUrl)}`,
 		...lastUpdated ? [`last_updated: ${toYamlString(lastUpdated)}`] : [],
+		...renderPageAgentFrontmatterYamlLines(agent),
 		"---"
 	].join("\n");
 }
@@ -1703,8 +2299,9 @@ function resolveDocsMarkdownPageMetadata(page, options) {
 		title: page.title,
 		description: page.description,
 		canonicalUrl: resolveDocsMarkdownMetadataUrl(page.url, options?.origin),
-		markdownUrl: resolveDocsMarkdownMetadataUrl(toDocsMarkdownUrl(page.url), options?.origin),
-		lastUpdated: normalizeDocsMarkdownLastUpdated(page.lastmod ?? page.lastModified)
+		markdownUrl: resolveDocsMarkdownMetadataUrl(page.markdownUrl ?? toDocsMarkdownUrl(page.url), options?.origin),
+		lastUpdated: normalizeDocsMarkdownLastUpdated(page.lastmod ?? page.lastModified),
+		agent: page.agent
 	};
 }
 function renderDocsMarkdownNotFound({ entry = "docs", requestedPath, origin, pages, sitemap }) {
@@ -1750,6 +2347,121 @@ function renderDocsMarkdownNotFound({ entry = "docs", requestedPath, origin, pag
 		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;
+	const raw = frontmatter.match(/^last_updated:\s*(.+?)\s*$/m)?.[1]?.trim();
+	if (!raw) return void 0;
+	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);
+	return url.toString();
+}
+/** Build one standards-aware Markdown response for every framework adapter. */
+function createDocsMarkdownResponse(options) {
+	const { request, document, entry = "docs", requestedPath, origin = new URL(request.url).origin, pages, sitemap, locale } = options;
+	const canonicalUrl = options.canonicalUrl ?? resolveDocsMarkdownCanonicalUrl({
+		origin,
+		entry,
+		requestedPath,
+		locale
+	});
+	const contentLocation = options.contentLocation ?? resolveDocsMarkdownContentLocation(canonicalUrl);
+	const varyHeader = getDocsMarkdownVaryHeader(request);
+	const sharedHeaders = {
+		"Content-Location": contentLocation,
+		Link: `<${canonicalUrl}>; rel="canonical"`,
+		"X-Robots-Tag": "noindex",
+		...locale ? { "Content-Language": locale } : {},
+		...varyHeader ? { Vary: varyHeader } : {}
+	};
+	if (!document) {
+		const recovery = resolveDocsMarkdownRecovery({
+			entry,
+			requestedPath,
+			pages,
+			sitemap
+		});
+		if (recovery.redirect) return new Response(null, {
+			status: 307,
+			headers: {
+				...sharedHeaders,
+				"Cache-Control": "no-store",
+				Location: new URL(recovery.redirect.markdownUrl, request.url).toString()
+			}
+		});
+		return new Response(renderDocsMarkdownNotFound({
+			entry,
+			requestedPath,
+			origin,
+			pages,
+			sitemap
+		}), {
+			status: 404,
+			headers: {
+				...sharedHeaders,
+				"Cache-Control": "no-store",
+				"Content-Type": "text/markdown; charset=utf-8"
+			}
+		});
+	}
+	const etag = createDocsMarkdownEtag(document);
+	const lastModified = resolveDocsMarkdownHttpDate(options.lastModified ?? extractDocsMarkdownLastModified(document));
+	const responseHeaders = {
+		...sharedHeaders,
+		"Cache-Control": options.cacheControl ?? "public, max-age=0, s-maxage=3600",
+		"Content-Type": "text/markdown; charset=utf-8",
+		ETag: etag,
+		...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(document, { headers: responseHeaders });
+}
 function findDocsMarkdownPage(entry, pages, requestedPath) {
 	const normalizedRequest = normalizeRequestedMarkdownPath(entry, requestedPath);
 	for (const page of pages) if (normalizeDocsUrlPath(page.url) === normalizedRequest) return page;
@@ -1883,13 +2595,13 @@ function appendDocsAgentPublicRouteLines(lines, context, variant) {
 	appendDocsMcpRouteLines(lines, context);
 }
 function renderDocsMarkdownDocument(page, options) {
-	if (page.agentRawContent !== void 0) return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(page.agentRawContent, resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
+	if (page.agentRawContent !== void 0) return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(upsertPageAgentContractMarkdown(page.agentRawContent, page.agent), resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
 	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (shouldRenderLlmsDirective(options)) lines.push(DOCS_LLMS_TXT_DIRECTIVE_LINE);
 	if (page.description) lines.push(`Description: ${page.description}`);
 	lines.push(...relatedLines);
-	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
+	lines.push("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.rawContent ?? page.content, page.agent));
 	return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(lines.join("\n"), resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
 }
 function renderDocsSkillDocument(options) {
@@ -1977,6 +2689,14 @@ function resolveDocsAgentMdxContent(content, audience) {
 	}
 	return output.join("\n").replace(/\n{3,}/g, "\n\n").trim();
 }
+/** Resolve only the task tools that the advertised MCP endpoint actually exposes. */
+function resolveDocsAgentContractMcpTools(mcp) {
+	if (!mcp.enabled) return void 0;
+	const tools = {};
+	if (mcp.tools.listTasks !== false) tools.list = "list_tasks";
+	if (mcp.tools.readTask !== false) tools.read = "read_task";
+	return tools.list || tools.read ? tools : void 0;
+}
 function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, search, mcp, feedback, llms, sitemap, robots, openapi, markdown }) {
 	const normalizedEntry = normalizeDocsPathSegment(entry) || "docs";
 	const localesEnabled = i18n !== null;
@@ -1988,6 +2708,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 	const sitemapConfig = resolveDocsSitemapConfig(sitemap, { baseUrl: llms?.baseUrl });
 	const robotsEnabled = isRobotsDiscoveryEnabled(robots);
 	const openapiConfig = resolveDocsOpenApiDiscoveryConfig(openapi);
+	const agentContractMcpTools = resolveDocsAgentContractMcpTools(mcp);
 	return {
 		version: "1",
 		name: "@farming-labs/docs",
@@ -2009,6 +2730,7 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 			markdownRoutes: true,
 			agentMdOverrides: true,
 			agentBlocks: true,
+			structuredAgentContracts: true,
 			agents: true,
 			llms: llmsEnabled,
 			skills: true,
@@ -2052,6 +2774,17 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 				"page markdown"
 			]
 		},
+		agentContract: {
+			enabled: true,
+			schemaVersion: "page-agent-contract.v1",
+			source: "page-frontmatter",
+			frontmatterPath: "agent",
+			markdownSection: "Agent Contract",
+			mcpField: "agent",
+			...agentContractMcpTools ? { mcpTools: agentContractMcpTools } : {},
+			usefulContractFields: ["task", "outcome"],
+			fields: PAGE_AGENT_CONTRACT_FIELD_SCHEMA
+		},
 		llms: {
 			enabled: llmsEnabled,
 			defaultTxt: DEFAULT_LLMS_TXT_ROUTE,
@@ -2103,10 +2836,12 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 				"description",
 				"url",
 				"dateModified",
-				"breadcrumb"
+				"breadcrumb",
+				"mainEntity"
 			],
 			canonicalUrlField: "url",
-			breadcrumbType: "BreadcrumbList"
+			breadcrumbType: "BreadcrumbList",
+			agentContractType: "HowTo"
 		},
 		openapi: {
 			enabled: openapiConfig.enabled,
@@ -2174,18 +2909,26 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 		}
 	};
 }
-function acceptsMarkdown(request) {
+function acceptsDocsMarkdown(request) {
 	const accept = request.headers.get("accept");
 	if (!accept) return false;
-	return accept.split(",").map((value) => value.trim()).some((value) => {
-		const [mediaType, ...params] = value.split(";").map((part) => part.trim().toLowerCase());
-		if (mediaType !== "text/markdown") return false;
+	const ranges = accept.split(",").map((value) => {
+		const [rawMediaType = "", ...params] = value.split(";").map((part) => part.trim().toLowerCase());
 		const qualityParam = params.find((param) => param.split("=", 1)[0]?.trim() === "q");
-		if (!qualityParam) return true;
-		const qualityValue = qualityParam.slice(qualityParam.indexOf("=") + 1).trim();
-		const quality = Number.parseFloat(qualityValue);
-		return Number.isFinite(quality) ? quality > 0 : true;
+		const parsedQuality = qualityParam ? Number.parseFloat(qualityParam.slice(qualityParam.indexOf("=") + 1).trim()) : 1;
+		return {
+			mediaType: rawMediaType,
+			quality: Number.isFinite(parsedQuality) ? Math.min(1, Math.max(0, parsedQuality)) : 0
+		};
 	});
+	const qualityFor = (mediaType) => {
+		const matches = ranges.filter((range) => range.mediaType === mediaType);
+		return matches.length > 0 ? Math.max(...matches.map((range) => range.quality)) : void 0;
+	};
+	const markdownQuality = qualityFor("text/markdown");
+	if (!markdownQuality || markdownQuality <= 0) return false;
+	const htmlQuality = qualityFor("text/html") ?? qualityFor("text/*") ?? qualityFor("*/*");
+	return htmlQuality === void 0 || htmlQuality <= markdownQuality;
 }
 function buildDocsUserAgentHeaderPattern(patterns) {
 	return `.*(?:${patterns.map(toCaseInsensitiveHeaderPattern).join("|")}).*`;
@@ -2247,4 +2990,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { renderDocsAgentsDocument as $, buildDocsAgentDiscoverySpec as A, resolveDocsSitemapPageLastmod as At, hasDocsMarkdownSignatureAgent as B, DEFAULT_OPENAPI_SCHEMA_ROUTE as C, DEFAULT_SITEMAP_XML_ROUTE as Ct, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as D, renderDocsSitemapMarkdown as Dt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as E, readDocsSitemapManifestFromContentMap as Et, detectDocsMarkdownAgentRequest as F, isDocsLlmsTxtPublicRequest as G, isDocsAgentsRequest as H, findDocsMarkdownPage as I, isDocsSkillRequest as J, isDocsMcpRequest as K, getDocsLlmsTxtMaxCharsIssue as L, buildDocsConfigMap as M, toDocsSitemapMarkdownUrl as Mt, buildDocsDiagnostics as N, normalizeDocsRelated as Nt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as O, renderDocsSitemapXml as Ot, buildDocsMcpEndpointCandidates as P, renderDocsRelatedMarkdownLines as Pt, parseDocsAgentFeedbackData as Q, getDocsMarkdownCanonicalLinkHeader as R, DEFAULT_MCP_WELL_KNOWN_ROUTE as S, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as St, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as T, createDocsSitemapResponse as Tt, isDocsConfigRequest as U, isDocsAgentDiscoveryRequest as V, isDocsDiagnosticsRequest as W, normalizeDocsPathSegment as X, matchesDocsLlmsTxtSection as Y, normalizeDocsUrlPath as Z, DEFAULT_LLMS_TXT_MAX_CHARS as _, toDocsMarkdownUrl as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsAgentFeedbackRequest as at, DEFAULT_MCP_PUBLIC_ROUTE as b, DEFAULT_SITEMAP_MD_DOCS_ROUTE as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, resolveDocsLlmsTxtFormat as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, resolveDocsMarkdownCanonicalUrl as dt, renderDocsLlmsTxt as et, DEFAULT_DOCS_CONFIG_ROUTE as f, resolveDocsMarkdownRecovery as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, selectDocsLlmsTxtContent as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSkillFormat as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsAgentFeedbackConfig as it, buildDocsAgentFeedbackSchema as j, resolveDocsSitemapRequest as jt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as k, resolveDocsSitemapConfig as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, resolveDocsLlmsTxtRequest as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsOpenApiDiscoveryConfig as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, renderDocsMarkdownNotFound as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsAgentMdxContent as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveDocsMarkdownRequest as pt, isDocsPublicGetRequest as q, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, renderDocsSkillDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsAgentsFormat as st, DEFAULT_AGENTS_MD_ROUTE as t, renderDocsMarkdownDocument as tt, DEFAULT_DOCS_API_ROUTE as u, resolveDocsLlmsTxtSections as ut, DEFAULT_LLMS_TXT_ROUTE as v, validateDocsAgentFeedbackPayload as vt, DEFAULT_SKILL_MD_ROUTE as w, buildDocsSitemapManifest as wt, DEFAULT_MCP_ROUTE as x, DEFAULT_SITEMAP_MD_ROUTE as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, DEFAULT_SITEMAP_MANIFEST_PATH as yt, getDocsMarkdownVaryHeader as z };
+export { normalizeDocsPathSegment as $, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as A, readDocsSitemapManifestFromContentMap as At, getDocsLlmsTxtMaxCharsIssue as B, PAGE_AGENT_CONTRACT_FIELDS as Bt, DEFAULT_OPENAPI_SCHEMA_ROUTE as C, DEFAULT_SITEMAP_MANIFEST_PATH as Ct, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as D, DEFAULT_SITEMAP_XML_ROUTE as Dt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as E, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as Et, buildDocsDiagnostics as F, resolveDocsSitemapRequest as Ft, isDocsAgentsRequest as G, hasStructuredPageAgentContract as Gt, getDocsMarkdownVaryHeader as H, PAGE_AGENT_CONTRACT_START_MARKER as Ht, buildDocsMcpEndpointCandidates as I, toDocsSitemapMarkdownUrl as It, isDocsLlmsTxtPublicRequest as J, renderPageAgentFrontmatterYamlLines as Jt, isDocsConfigRequest as K, normalizePageAgentFrontmatter as Kt, createDocsMarkdownResponse as L, normalizeDocsRelated as Lt, buildDocsAgentDiscoverySpec as M, renderDocsSitemapXml as Mt, buildDocsAgentFeedbackSchema as N, resolveDocsSitemapConfig as Nt, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as O, buildDocsSitemapManifest as Ot, buildDocsConfigMap as P, resolveDocsSitemapPageLastmod as Pt, matchesDocsLlmsTxtSection as Q, detectDocsMarkdownAgentRequest as R, renderDocsRelatedMarkdownLines as Rt, DEFAULT_MCP_WELL_KNOWN_ROUTE as S, validateDocsAgentFeedbackPayload as St, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as T, DEFAULT_SITEMAP_MD_ROUTE as Tt, hasDocsMarkdownSignatureAgent as U, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS as Ut, getDocsMarkdownCanonicalLinkHeader as V, PAGE_AGENT_CONTRACT_FIELD_SCHEMA as Vt, isDocsAgentDiscoveryRequest as W, getPageAgentFrontmatterIssues as Wt, isDocsPublicGetRequest as X, upsertPageAgentContractMarkdown as Xt, isDocsMcpRequest as Y, stripGeneratedPageAgentContractMarkdown as Yt, isDocsSkillRequest as Z, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, renderDocsMarkdownNotFound as at, DEFAULT_MCP_PUBLIC_ROUTE as b, selectDocsLlmsTxtContent as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, resolveDocsAgentFeedbackConfig as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, resolveDocsAgentsFormat as dt, normalizeDocsUrlPath 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, renderDocsMarkdownDocument as it, acceptsDocsMarkdown as j, renderDocsSitemapMarkdown as jt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as k, createDocsSitemapResponse as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, resolveDocsAgentFeedbackRequest as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, renderDocsAgentsDocument as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, renderDocsSkillDocument as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveDocsLlmsTxtRequest as pt, isDocsDiagnosticsRequest as q, renderPageAgentContractMarkdown as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, renderDocsLlmsTxt as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsAgentContractMcpTools as st, DEFAULT_AGENTS_MD_ROUTE as t, parseDocsAgentFeedbackData as tt, DEFAULT_DOCS_API_ROUTE as u, resolveDocsAgentMdxContent as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsOpenApiDiscoveryConfig as vt, DEFAULT_SKILL_MD_ROUTE as w, DEFAULT_SITEMAP_MD_DOCS_ROUTE as wt, DEFAULT_MCP_ROUTE as x, toDocsMarkdownUrl as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveDocsSkillFormat as yt, findDocsMarkdownPage as z, PAGE_AGENT_CONTRACT_END_MARKER as zt };