@farming-labs/docs 0.2.55 → 0.2.56

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

@@ -1,3 +1,5 @@
+import { createProcessor } from "@mdx-js/mdx";
+
 //#region src/agent-contract.ts
 const PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS = [
 	"task",
@@ -886,6 +888,1117 @@ function createDocsSitemapResponse({ request, sitemap, entry = "docs", siteTitle
 	return new Response(body, { headers });
 }
 
+//#endregion
+//#region src/audience.ts
+/** Resolve whether content with an optional audience restriction is visible. */
+function resolveDocsAudienceExposure(only, audience) {
+	return only !== "human" && only !== "agent" || only === audience;
+}
+const DOCS_AUDIENCE_TAG_NAMES = [
+	"Audience",
+	"Agent",
+	"Human"
+];
+const DOCS_AUDIENCE_TAG_CANDIDATE_PATTERN = /<\/?(?:Audience|Agent|Human)(?=[\s/>])/;
+function parseAudienceOnly(attributes) {
+	if (/\{\s*\.\.\./.test(attributes)) return void 0;
+	const value = attributes.match(/(?:^|\s)only\s*=\s*(?:"(human|agent)"|'(human|agent)'|\{\s*"(human|agent)"\s*\}|\{\s*'(human|agent)'\s*\})/)?.slice(1).find(Boolean);
+	return value === "human" || value === "agent" ? value : void 0;
+}
+function isEscapedAt(content, index) {
+	let backslashes = 0;
+	for (let cursor = index - 1; cursor >= 0 && content[cursor] === "\\"; cursor -= 1) backslashes += 1;
+	return backslashes % 2 === 1;
+}
+const JAVASCRIPT_REGEX_PREFIX_KEYWORDS = new Set([
+	"await",
+	"case",
+	"delete",
+	"do",
+	"else",
+	"each",
+	"if",
+	"in",
+	"instanceof",
+	"key",
+	"new",
+	"of",
+	"return",
+	"throw",
+	"catch",
+	"const",
+	"debug",
+	"html",
+	"render",
+	"snippet",
+	"then",
+	"typeof",
+	"void",
+	"yield"
+]);
+function canStartJavascriptRegex(content, cursor, boundary) {
+	let previous = cursor - 1;
+	while (previous > boundary && /\s/.test(content[previous] ?? "")) previous -= 1;
+	if (previous <= boundary || /[([{=,:;!?&|>]/.test(content[previous] ?? "")) return true;
+	const precedingWord = content.slice(boundary + 1, cursor).match(/([A-Za-z_$][\w$]*)\s*$/)?.[1];
+	return JAVASCRIPT_REGEX_PREFIX_KEYWORDS.has(precedingWord ?? "");
+}
+function readAudienceTagAt(content, index) {
+	let cursor = index + 1;
+	const closing = content[cursor] === "/";
+	if (closing) cursor += 1;
+	const name = DOCS_AUDIENCE_TAG_NAMES.find((candidate) => content.startsWith(candidate, cursor) && /[\s/>]/.test(content[cursor + candidate.length] ?? ""));
+	if (!name) return void 0;
+	cursor += name.length;
+	const attributesStart = cursor;
+	let braceDepth = 0;
+	let quote;
+	let blockComment = false;
+	let lineComment = false;
+	while (cursor < content.length) {
+		const character = content[cursor];
+		const next = content[cursor + 1];
+		if (lineComment) {
+			if (character === "\n") lineComment = false;
+			cursor += 1;
+			continue;
+		}
+		if (blockComment) {
+			if (character === "*" && next === "/") {
+				blockComment = false;
+				cursor += 2;
+			} else cursor += 1;
+			continue;
+		}
+		if (quote) {
+			if (character === "\\") {
+				cursor += 2;
+				continue;
+			}
+			if (character === quote) quote = void 0;
+			cursor += 1;
+			continue;
+		}
+		if (braceDepth > 0 && character === "/" && next === "*") {
+			blockComment = true;
+			cursor += 2;
+			continue;
+		}
+		if (braceDepth > 0 && character === "/" && next === "/") {
+			lineComment = true;
+			cursor += 2;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") quote = character;
+		else if (character === "{") braceDepth += 1;
+		else if (character === "}" && braceDepth > 0) braceDepth -= 1;
+		else if (character === ">" && braceDepth === 0) {
+			let attributesEnd = cursor;
+			let slashIndex = cursor - 1;
+			while (slashIndex >= attributesStart && /\s/.test(content[slashIndex] ?? "")) slashIndex -= 1;
+			const selfClosing = content[slashIndex] === "/";
+			if (selfClosing) attributesEnd = slashIndex;
+			const attributes = content.slice(attributesStart, attributesEnd);
+			return {
+				index,
+				end: cursor + 1,
+				name,
+				closing,
+				selfClosing,
+				attributes,
+				only: name === "Agent" ? "agent" : name === "Human" ? "human" : parseAudienceOnly(attributes)
+			};
+		}
+		cursor += 1;
+	}
+}
+function findAudienceTags(content, protectedRanges) {
+	const tags = [];
+	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 = readAudienceTagAt(content, index);
+		if (tag) {
+			tags.push(tag);
+			cursor = tag.end;
+		} else cursor = index + 1;
+	}
+	return tags;
+}
+const docsAudienceMdxProcessor = createProcessor({ format: "mdx" });
+const docsAudienceMarkdownProcessor = createProcessor({ format: "md" });
+function getOffset(position, edge) {
+	const value = position?.[edge]?.offset;
+	return typeof value === "number" ? value : void 0;
+}
+function maskRangesForMdxParser(content, ranges) {
+	if (ranges.length === 0) return content;
+	const characters = content.split("");
+	for (const range of ranges) for (let index = range.start; index < range.end; index += 1) if (characters[index] !== "\n" && characters[index] !== "\r") characters[index] = " ";
+	return characters.join("");
+}
+function findLeadingFrontmatterRange(content) {
+	const bomLength = content.startsWith("") ? 1 : 0;
+	const opening = content.slice(bomLength).match(/^(---|\+\+\+)[\t ]*(?:\r?\n|$)/);
+	const marker = opening?.[1];
+	if (!opening || !marker) return void 0;
+	let offset = bomLength + opening[0].length;
+	for (const line of content.slice(offset).split(/(?<=\n)/)) {
+		offset += line.length;
+		const value = line.replace(/\r?\n$/, "");
+		if (marker === "---" ? /^(?:---|\.\.\.)[\t ]*$/.test(value) : /^\+\+\+[\t ]*$/.test(value)) return {
+			start: 0,
+			end: offset
+		};
+	}
+}
+function findHtmlLiteralRanges(content, excludedRanges = []) {
+	const ranges = [];
+	const rawPattern = /<(script|style)(?=[\s/>])/g;
+	let cursor = 0;
+	while (cursor < content.length) {
+		rawPattern.lastIndex = cursor;
+		const rawMatch = rawPattern.exec(content);
+		const commentStart = content.indexOf("<!--", cursor);
+		const rawStart = rawMatch?.index ?? -1;
+		const useComment = commentStart !== -1 && (rawStart === -1 || commentStart < rawStart);
+		const start = useComment ? commentStart : rawStart;
+		if (start === -1) break;
+		if (isEscapedAt(content, start) || isInsideRange(start, excludedRanges)) {
+			cursor = start + 1;
+			continue;
+		}
+		if (useComment) {
+			const closing = content.indexOf("-->", start + 4);
+			const end = closing === -1 ? content.length : closing + 3;
+			ranges.push({
+				start,
+				end
+			});
+			cursor = end;
+			continue;
+		}
+		const name = rawMatch?.[1];
+		if (!name) {
+			cursor = start + 1;
+			continue;
+		}
+		const opening = readGenericMdxJsxTag(content, start);
+		if (!opening) {
+			cursor = start + 1;
+			continue;
+		}
+		if (opening.selfClosing) {
+			cursor = opening.end;
+			continue;
+		}
+		const closingPattern = new RegExp(`</${name}\\s*>`, "g");
+		closingPattern.lastIndex = opening.end;
+		if (!closingPattern.exec(content)) {
+			ranges.push({
+				start,
+				end: content.length
+			});
+			break;
+		}
+		ranges.push({
+			start,
+			end: closingPattern.lastIndex
+		});
+		cursor = closingPattern.lastIndex;
+	}
+	return ranges;
+}
+function prepareMdxParserSource(content) {
+	const baseExcludedRanges = findDelimiterExclusionRanges(content);
+	const svelteDirectives = findSvelteDirectiveRanges(content, baseExcludedRanges);
+	const ranges = [...findHtmlLiteralRanges(content, mergeProtectedRanges([...baseExcludedRanges, ...svelteDirectives])), ...svelteDirectives];
+	const frontmatter = findLeadingFrontmatterRange(content);
+	if (frontmatter) ranges.push(frontmatter);
+	return maskRangesForMdxParser(content, mergeProtectedRanges(ranges));
+}
+function getExpressionLiteralString(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const expression = value.data?.estree?.body?.[0]?.expression;
+	return expression?.type === "Literal" && typeof expression.value === "string" ? expression.value : void 0;
+}
+function getMdxAudienceAttributeInfo(attributes) {
+	const hasSpreadAttribute = attributes.some((attribute) => attribute.type === "mdxJsxExpressionAttribute");
+	const onlyAttribute = [...attributes].reverse().find((attribute) => attribute.type === "mdxJsxAttribute" && attribute.name === "only");
+	if (hasSpreadAttribute) return {
+		hasOnlyAttribute: Boolean(onlyAttribute),
+		hasSpreadAttribute,
+		onlyKind: "dynamic"
+	};
+	if (!onlyAttribute) return {
+		hasOnlyAttribute: false,
+		hasSpreadAttribute: false,
+		onlyKind: "missing"
+	};
+	const value = typeof onlyAttribute.value === "string" ? onlyAttribute.value : getExpressionLiteralString(onlyAttribute.value);
+	if (value === "human" || value === "agent") return {
+		only: value,
+		hasOnlyAttribute: true,
+		hasSpreadAttribute: false,
+		onlyKind: "static"
+	};
+	return {
+		hasOnlyAttribute: true,
+		hasSpreadAttribute: false,
+		onlyKind: typeof onlyAttribute.value === "object" ? "dynamic" : "invalid"
+	};
+}
+function getEstreeAudienceAttributeInfo(attributes) {
+	const records = attributes.filter((attribute) => Boolean(attribute && typeof attribute === "object"));
+	const hasSpreadAttribute = records.some((attribute) => attribute.type === "JSXSpreadAttribute");
+	const onlyAttribute = [...records].reverse().find((attribute) => {
+		const name = attribute.name;
+		return attribute.type === "JSXAttribute" && name?.type === "JSXIdentifier" && name.name === "only";
+	});
+	if (hasSpreadAttribute) return {
+		hasOnlyAttribute: Boolean(onlyAttribute),
+		hasSpreadAttribute,
+		onlyKind: "dynamic"
+	};
+	if (!onlyAttribute) return {
+		hasOnlyAttribute: false,
+		hasSpreadAttribute: false,
+		onlyKind: "missing"
+	};
+	const attributeValue = onlyAttribute.value;
+	const value = attributeValue?.type === "Literal" ? attributeValue.value : attributeValue?.type === "JSXExpressionContainer" && attributeValue.expression?.type === "Literal" ? attributeValue.expression.value : void 0;
+	if (value === "human" || value === "agent") return {
+		only: value,
+		hasOnlyAttribute: true,
+		hasSpreadAttribute: false,
+		onlyKind: "static"
+	};
+	return {
+		hasOnlyAttribute: true,
+		hasSpreadAttribute: false,
+		onlyKind: attributeValue?.type === "JSXExpressionContainer" ? "dynamic" : "invalid"
+	};
+}
+function getOpeningTagEnd(content, start, name, attributes) {
+	const searchStart = Math.max(start + name.length + 1, ...attributes.map((attribute) => getOffset(attribute.position, "end") ?? 0));
+	const closingBracket = content.indexOf(">", searchStart);
+	return closingBracket === -1 ? void 0 : closingBracket + 1;
+}
+function addMdxAudienceElementTags(content, node, tags) {
+	const name = node.name;
+	const start = getOffset(node.position, "start");
+	const nodeEnd = getOffset(node.position, "end");
+	if (start === void 0 || nodeEnd === void 0) return;
+	const attributes = node.attributes ?? [];
+	const openingEnd = getOpeningTagEnd(content, start, name, attributes);
+	if (openingEnd === void 0) return;
+	const closingStart = content.lastIndexOf(`</${name}`, nodeEnd);
+	const hasClosingTag = closingStart >= openingEnd;
+	const attributeInfo = getMdxAudienceAttributeInfo(attributes);
+	const rawAttributes = content.slice(start + name.length + 1, openingEnd - 1);
+	tags.push({
+		index: start,
+		end: openingEnd,
+		name,
+		closing: false,
+		selfClosing: !hasClosingTag,
+		attributes: rawAttributes,
+		only: name === "Agent" ? "agent" : name === "Human" ? "human" : attributeInfo.only,
+		hasOnlyAttribute: attributeInfo.hasOnlyAttribute,
+		hasSpreadAttribute: attributeInfo.hasSpreadAttribute,
+		onlyKind: attributeInfo.onlyKind
+	});
+	if (hasClosingTag) tags.push({
+		index: closingStart,
+		end: nodeEnd,
+		name,
+		closing: true,
+		selfClosing: false,
+		attributes: ""
+	});
+}
+function getEstreeJsxIdentifierName(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const name = value;
+	return name.type === "JSXIdentifier" && DOCS_AUDIENCE_TAG_NAMES.some((candidate) => candidate === name.name) ? name.name : void 0;
+}
+function addEstreeAudienceElementTags(content, node, tags, jsxChild) {
+	const opening = node.openingElement;
+	if (!opening) return;
+	const name = getEstreeJsxIdentifierName(opening.name);
+	const start = typeof opening.start === "number" ? opening.start : void 0;
+	const openingEnd = typeof opening.end === "number" ? opening.end : void 0;
+	const nodeEnd = typeof node.end === "number" ? node.end : void 0;
+	if (!name || start === void 0 || openingEnd === void 0 || nodeEnd === void 0) return;
+	const attributeInfo = getEstreeAudienceAttributeInfo(Array.isArray(opening.attributes) ? opening.attributes : []);
+	const closing = node.closingElement;
+	const closingStart = closing && typeof closing.start === "number" ? closing.start : void 0;
+	const closingEnd = closing && typeof closing.end === "number" ? closing.end : void 0;
+	tags.push({
+		index: start,
+		end: openingEnd,
+		name,
+		closing: false,
+		selfClosing: closingStart === void 0,
+		attributes: content.slice(start + name.length + 1, openingEnd - 1),
+		only: name === "Agent" ? "agent" : name === "Human" ? "human" : attributeInfo.only,
+		expression: true,
+		jsxChild,
+		hasOnlyAttribute: attributeInfo.hasOnlyAttribute,
+		hasSpreadAttribute: attributeInfo.hasSpreadAttribute,
+		onlyKind: attributeInfo.onlyKind
+	});
+	if (closingStart !== void 0 && closingEnd !== void 0) tags.push({
+		index: closingStart,
+		end: closingEnd,
+		name,
+		closing: true,
+		selfClosing: false,
+		attributes: "",
+		expression: true,
+		jsxChild
+	});
+}
+function collectEstreeAudienceTags(content, value, tags, seen = /* @__PURE__ */ new WeakSet(), parent, parentKey) {
+	if (!value || typeof value !== "object" || seen.has(value)) return;
+	seen.add(value);
+	const record = value;
+	if (record.type === "JSXElement") {
+		const opening = record.openingElement;
+		if (getEstreeJsxIdentifierName(opening?.name)) {
+			addEstreeAudienceElementTags(content, record, tags, parentKey === "children" && (parent?.type === "JSXElement" || parent?.type === "JSXFragment"));
+			for (const child of Array.isArray(record.children) ? record.children : []) collectEstreeAudienceTags(content, child, tags, seen, record, "children");
+			return;
+		}
+	}
+	for (const [key, child] of Object.entries(record)) {
+		if (key === "loc" || key === "range" || key === "comments") continue;
+		if (Array.isArray(child)) for (const item of child) collectEstreeAudienceTags(content, item, tags, seen, record, key);
+		else collectEstreeAudienceTags(content, child, tags, seen, record, key);
+	}
+}
+function collectMdxAudienceTags(content, node, tags) {
+	const isMdxJsxElement = node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
+	if (isMdxJsxElement && (node.name === "script" || node.name === "style")) return;
+	const isAudienceElement = Boolean(isMdxJsxElement && node.name && DOCS_AUDIENCE_TAG_NAMES.some((candidate) => candidate === node.name));
+	if (isAudienceElement) addMdxAudienceElementTags(content, node, tags);
+	if (node.type !== "mdxjsEsm") {
+		if (node.type === "mdxFlowExpression" || node.type === "mdxTextExpression") collectEstreeAudienceTags(content, node.data?.estree, tags);
+		if (isMdxJsxElement && !isAudienceElement) for (const attribute of node.attributes ?? []) {
+			collectEstreeAudienceTags(content, attribute.data?.estree, tags);
+			if (attribute.value && typeof attribute.value === "object") {
+				const value = attribute.value;
+				collectEstreeAudienceTags(content, value.data?.estree, tags);
+			}
+		}
+	}
+	for (const child of node.children ?? []) collectMdxAudienceTags(content, child, tags);
+}
+function findMdxAstAudienceTags(content) {
+	try {
+		const tree = docsAudienceMdxProcessor.parse(prepareMdxParserSource(content));
+		const tags = [];
+		collectMdxAudienceTags(content, tree, tags);
+		return tags.sort((left, right) => left.index - right.index || left.end - right.end);
+	} catch {
+		return;
+	}
+}
+/** Locate effective audience tags while excluding Markdown/MDX literal contexts. */
+function findDocsAudienceMdxTags(content) {
+	if (!DOCS_AUDIENCE_TAG_CANDIDATE_PATTERN.test(content)) return [];
+	return findMdxAstAudienceTags(content) ?? findAudienceTags(content, findProtectedRanges(content));
+}
+function isAudienceVisible(scopes, audience) {
+	return scopes.every((scope) => resolveDocsAudienceExposure(scope.only, audience));
+}
+function mergeProtectedRanges(ranges) {
+	const sorted = [...ranges].sort((left, right) => left.start - right.start || left.end - right.end);
+	const merged = [];
+	for (const range of sorted) {
+		const previous = merged.at(-1);
+		if (!previous || range.start > previous.end) {
+			merged.push({ ...range });
+			continue;
+		}
+		previous.end = Math.max(previous.end, range.end);
+	}
+	return merged;
+}
+function findMarkdownLiteralRanges(content) {
+	try {
+		const tree = docsAudienceMarkdownProcessor.parse(content);
+		const ranges = [];
+		const visit = (node) => {
+			const start = getOffset(node.position, "start");
+			const end = getOffset(node.position, "end");
+			if (start !== void 0 && end !== void 0) {
+				if (node.type === "code" || node.type === "inlineCode" || node.type === "definition") ranges.push({
+					start,
+					end
+				});
+				else if (node.type === "link" || node.type === "image") {
+					const contentEnd = Math.max(start, ...(node.children ?? []).map((child) => getOffset(child.position, "end") ?? start));
+					ranges.push({
+						start: contentEnd,
+						end
+					});
+				}
+			}
+			for (const child of node.children ?? []) visit(child);
+		};
+		visit(tree);
+		return ranges;
+	} catch {
+		return [];
+	}
+}
+function findMarkdownLinkDestinationRanges(content, protectedRanges) {
+	const ranges = [];
+	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 end = start + 2;
+		let parenthesisDepth = 1;
+		let angleDestination = false;
+		let quote;
+		while (end < content.length && parenthesisDepth > 0) {
+			const character = content[end];
+			if (character === "\\") {
+				end += 2;
+				continue;
+			}
+			if (quote) {
+				if (character === quote) quote = void 0;
+				end += 1;
+				continue;
+			}
+			if (character === "\"" || character === "'") quote = character;
+			else if (character === "<" && parenthesisDepth === 1) {
+				const closingAngle = content.indexOf(">", end + 1);
+				const closingParenthesis = content.indexOf(")", end + 1);
+				angleDestination = closingAngle !== -1 && closingAngle < closingParenthesis;
+			} else if (character === ">" && angleDestination) angleDestination = false;
+			else if (!angleDestination && character === "(") parenthesisDepth += 1;
+			else if (!angleDestination && character === ")") parenthesisDepth -= 1;
+			end += 1;
+		}
+		if (parenthesisDepth === 0) ranges.push({
+			start: start + 1,
+			end
+		});
+		cursor = Math.max(start + 1, end);
+	}
+	return ranges;
+}
+function findFenceRanges(content) {
+	const ranges = [];
+	let fence;
+	let offset = 0;
+	const stripBlockquoteContainers = (line) => {
+		let value = line;
+		while (/^ {0,3}>[\t ]?/.test(value)) value = value.replace(/^ {0,3}>[\t ]?/, "");
+		return value;
+	};
+	const stripOpeningListContainers = (line) => {
+		let value = line;
+		while (/^ {0,3}(?:[-+*]|\d{1,9}[.)])[\t ]+/.test(value)) value = value.replace(/^ {0,3}(?:[-+*]|\d{1,9}[.)])[\t ]+/, "");
+		return value;
+	};
+	for (const line of content.split(/(?<=\n)/)) {
+		const containerRelativeLine = stripBlockquoteContainers(line.replace(/\r?\n$/, ""));
+		const match = (fence ? containerRelativeLine : stripOpeningListContainers(containerRelativeLine)).match(/^[\t ]*(`{3,}|~{3,})(.*)$/);
+		if (!fence && match?.[1]) fence = {
+			marker: match[1][0],
+			length: match[1].length,
+			start: offset
+		};
+		else if (fence && match?.[1]?.[0] === fence.marker && match[1].length >= fence.length && /^[\t ]*$/.test(match[2] ?? "")) {
+			ranges.push({
+				start: fence.start,
+				end: offset + line.length
+			});
+			fence = void 0;
+		}
+		offset += line.length;
+	}
+	if (fence) ranges.push({
+		start: fence.start,
+		end: content.length
+	});
+	return ranges;
+}
+function findSvelteDirectiveRanges(content, excludedRanges) {
+	const ranges = [];
+	let index = 0;
+	while (index < content.length) {
+		const start = content.indexOf("{", index);
+		if (start === -1) break;
+		const sigil = content[start + 1];
+		if (!/[#/:@]/.test(sigil ?? "") || !/[A-Za-z]/.test(content[start + 2] ?? "") || isEscapedAt(content, start) || isInsideRange(start, excludedRanges)) {
+			index = start + 1;
+			continue;
+		}
+		let cursor = start + 2;
+		let braceDepth = 1;
+		let quote;
+		let blockComment = false;
+		let lineComment = false;
+		let regex = false;
+		let regexCharacterClass = false;
+		while (cursor < content.length && braceDepth > 0) {
+			const character = content[cursor];
+			const next = content[cursor + 1];
+			if (lineComment) {
+				if (character === "\n") lineComment = false;
+				cursor += 1;
+				continue;
+			}
+			if (blockComment) {
+				if (character === "*" && next === "/") {
+					blockComment = false;
+					cursor += 2;
+				} else cursor += 1;
+				continue;
+			}
+			if (quote) {
+				if (character === "\\") {
+					cursor += 2;
+					continue;
+				}
+				if (character === quote) quote = void 0;
+				cursor += 1;
+				continue;
+			}
+			if (regex) {
+				if (character === "\\") {
+					cursor += 2;
+					continue;
+				}
+				if (character === "[") regexCharacterClass = true;
+				if (character === "]") regexCharacterClass = false;
+				if (character === "/" && !regexCharacterClass) regex = false;
+				cursor += 1;
+				continue;
+			}
+			if (character === "/" && next === "*") {
+				blockComment = true;
+				cursor += 2;
+				continue;
+			}
+			if (character === "/" && next === "/") {
+				lineComment = true;
+				cursor += 2;
+				continue;
+			}
+			if (character === "\"" || character === "'" || character === "`") {
+				quote = character;
+				cursor += 1;
+				continue;
+			}
+			if (character === "/") {
+				if (canStartJavascriptRegex(content, cursor, start + 1)) {
+					regex = true;
+					cursor += 1;
+					continue;
+				}
+			}
+			if (character === "{") braceDepth += 1;
+			if (character === "}") braceDepth -= 1;
+			cursor += 1;
+		}
+		if (braceDepth === 0) ranges.push({
+			start,
+			end: cursor
+		});
+		index = Math.max(start + 1, cursor);
+	}
+	return ranges;
+}
+function scanMdxModuleLine(line, state) {
+	for (let index = 0; index < line.length; index += 1) {
+		const character = line[index];
+		const next = line[index + 1];
+		if (state.blockComment) {
+			if (character === "*" && next === "/") {
+				state.blockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (state.quote) {
+			if (character === "\\") {
+				index += 1;
+				continue;
+			}
+			if (character === state.quote) state.quote = void 0;
+			continue;
+		}
+		if (character === "/" && next === "/") break;
+		if (character === "/" && next === "*") {
+			state.blockComment = true;
+			index += 1;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") {
+			state.quote = character;
+			continue;
+		}
+		if (state.jsxTag) {
+			if (character === "{") state.braceDepth += 1;
+			else if (character === "}" && state.braceDepth > 0) state.braceDepth -= 1;
+			else if (character === ">" && state.braceDepth === 0) {
+				let previous = index - 1;
+				while (previous >= 0 && /[\t ]/.test(line[previous] ?? "")) previous -= 1;
+				const selfClosing = line[previous] === "/";
+				let following = index + 1;
+				while (following < line.length && /[\t ]/.test(line[following] ?? "")) following += 1;
+				const genericTypeParameters = !state.jsxTag.closing && line[following] === "(";
+				if (state.jsxTag.closing) state.jsxDepth = Math.max(0, state.jsxDepth - 1);
+				else if (!selfClosing && !genericTypeParameters) state.jsxDepth += 1;
+				state.jsxTag = void 0;
+			}
+			continue;
+		}
+		if (character === "<") {
+			let previous = index - 1;
+			while (previous >= 0 && /[\t ]/.test(line[previous] ?? "")) previous -= 1;
+			const previousCharacter = line[previous];
+			const atExpressionStart = previousCharacter === void 0 || /[=([{,:?!;]/.test(previousCharacter);
+			const openingElement = (state.jsxDepth > 0 || atExpressionStart) && /[A-Za-z]/.test(next ?? "");
+			const closingElement = state.jsxDepth > 0 && next === "/" && /[A-Za-z]/.test(line[index + 2] ?? "");
+			const openingFragment = atExpressionStart && next === ">";
+			const closingFragment = state.jsxDepth > 0 && next === "/" && line[index + 2] === ">";
+			if (openingFragment) {
+				state.jsxDepth += 1;
+				index += 1;
+				continue;
+			}
+			if (closingFragment) {
+				state.jsxDepth = Math.max(0, state.jsxDepth - 1);
+				index += 2;
+				continue;
+			}
+			if (openingElement || closingElement) {
+				state.jsxTag = { closing: closingElement };
+				continue;
+			}
+		}
+		if (character === "{") {
+			state.braceDepth += 1;
+			state.sawBlock = true;
+			continue;
+		}
+		if (character === "}") state.braceDepth = Math.max(0, state.braceDepth - 1);
+		else if (character === "[") state.bracketDepth += 1;
+		else if (character === "]") state.bracketDepth = Math.max(0, state.bracketDepth - 1);
+		else if (character === "(") state.parenthesisDepth += 1;
+		else if (character === ")") state.parenthesisDepth = Math.max(0, state.parenthesisDepth - 1);
+	}
+}
+function shouldContinueMdxModule(statement, state, nextSignificantLine) {
+	if (state.quote || state.blockComment || state.braceDepth > 0 || state.bracketDepth > 0 || state.parenthesisDepth > 0 || state.jsxTag || state.jsxDepth > 0) return true;
+	const trimmed = statement.trimEnd();
+	if (/^\s*import\b(?!\s*[.(])/.test(statement)) {
+		if (!(/^\s*import\s*(?:type\s+)?["'`]/.test(statement) || /\bfrom\s*["'`][\s\S]*["'`]\s*;?\s*$/.test(trimmed)) && !/;\s*$/.test(trimmed)) return true;
+	}
+	const isExportList = /^\s*export\s+(?:type\s+)?\{/.test(statement);
+	const isExportAll = /^\s*export\s+\*/.test(statement);
+	if ((isExportList || isExportAll) && !/\bfrom\s*["'`][\s\S]*["'`]\s*;?\s*$/.test(trimmed) && (isExportAll || /^\s*from\b/.test(nextSignificantLine ?? ""))) return true;
+	if (/=>\s*$/.test(trimmed) || /[=([{,:.?+\-*/%&|^!]$/.test(trimmed)) return true;
+	if (/\b(?:as|default|extends|from|implements|satisfies)$/.test(trimmed)) return true;
+	return /^\s*export\s+(?:default\s+)?(?:(?:async\s+)?function|class|enum|interface|module|namespace)\b/.test(statement) && !state.sawBlock;
+}
+function isInsideRange(index, ranges) {
+	return ranges.some((range) => index >= range.start && index < range.end);
+}
+function findMdxModuleRanges(content, protectedRanges) {
+	const ranges = [];
+	const lines = content.split(/(?<=\n)/);
+	let offset = 0;
+	for (let lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
+		const line = lines[lineIndex] ?? "";
+		const firstNonWhitespace = line.search(/\S/);
+		if (/^\s*(?:import|export)\b/.test(line) && !isInsideRange(offset + Math.max(0, firstNonWhitespace), protectedRanges)) {
+			const start = offset;
+			const state = {
+				braceDepth: 0,
+				bracketDepth: 0,
+				parenthesisDepth: 0,
+				blockComment: false,
+				sawBlock: false,
+				jsxDepth: 0
+			};
+			let statement = "";
+			while (lineIndex < lines.length) {
+				const moduleLine = lines[lineIndex] ?? "";
+				statement += moduleLine;
+				scanMdxModuleLine(moduleLine, state);
+				offset += moduleLine.length;
+				const nextSignificantLine = lines.slice(lineIndex + 1).find((candidate) => candidate.trim().length > 0);
+				if (!shouldContinueMdxModule(statement, state, nextSignificantLine)) break;
+				lineIndex += 1;
+			}
+			ranges.push({
+				start,
+				end: offset
+			});
+			continue;
+		}
+		offset += line.length;
+	}
+	return ranges;
+}
+function findInlineCodeRanges(content, protectedRanges) {
+	const ranges = [];
+	let index = 0;
+	while (index < content.length) {
+		if (content[index] !== "`" || isEscapedAt(content, index) || isInsideRange(index, protectedRanges)) {
+			index += 1;
+			continue;
+		}
+		let markerLength = 1;
+		while (content[index + markerLength] === "`") markerLength += 1;
+		let closingIndex = index + markerLength;
+		while (closingIndex < content.length) {
+			closingIndex = content.indexOf("`", closingIndex);
+			if (closingIndex === -1) break;
+			if (isInsideRange(closingIndex, protectedRanges)) {
+				closingIndex += 1;
+				continue;
+			}
+			let closingLength = 1;
+			while (content[closingIndex + closingLength] === "`") closingLength += 1;
+			if (closingLength === markerLength) break;
+			closingIndex += closingLength;
+		}
+		if (closingIndex === -1) {
+			index += markerLength;
+			continue;
+		}
+		ranges.push({
+			start: index,
+			end: closingIndex + markerLength
+		});
+		index = closingIndex + markerLength;
+	}
+	return ranges;
+}
+function findMdxExpressionLiteralRanges(content, protectedRanges) {
+	const ranges = [];
+	let index = 0;
+	while (index < content.length) {
+		if (content[index] !== "{" || isEscapedAt(content, index) || isInsideRange(index, protectedRanges)) {
+			index += 1;
+			continue;
+		}
+		let cursor = index + 1;
+		let depth = 1;
+		while (cursor < content.length && depth > 0) {
+			if (isInsideRange(cursor, protectedRanges)) {
+				cursor += 1;
+				continue;
+			}
+			const character = content[cursor];
+			const next = content[cursor + 1];
+			if (character === "\"" || character === "'" || character === "`") {
+				const quote = character;
+				const start = cursor;
+				cursor += 1;
+				while (cursor < content.length) {
+					if (content[cursor] === "\\") {
+						cursor += 2;
+						continue;
+					}
+					if (content[cursor] === quote) {
+						cursor += 1;
+						break;
+					}
+					cursor += 1;
+				}
+				ranges.push({
+					start,
+					end: cursor
+				});
+				continue;
+			}
+			if (character === "/" && next === "*") {
+				const start = cursor;
+				const end = content.indexOf("*/", cursor + 2);
+				cursor = end === -1 ? content.length : end + 2;
+				ranges.push({
+					start,
+					end: cursor
+				});
+				continue;
+			}
+			if (character === "/" && next === "/") {
+				const start = cursor;
+				const newline = content.indexOf("\n", cursor + 2);
+				cursor = newline === -1 ? content.length : newline;
+				ranges.push({
+					start,
+					end: cursor
+				});
+				continue;
+			}
+			if (character === "/") {
+				if (canStartJavascriptRegex(content, cursor, index)) {
+					const start = cursor;
+					let inCharacterClass = false;
+					cursor += 1;
+					while (cursor < content.length) {
+						if (content[cursor] === "\\") {
+							cursor += 2;
+							continue;
+						}
+						if (content[cursor] === "[") inCharacterClass = true;
+						if (content[cursor] === "]") inCharacterClass = false;
+						if (content[cursor] === "/" && !inCharacterClass) {
+							cursor += 1;
+							while (/[A-Za-z]/.test(content[cursor] ?? "")) cursor += 1;
+							break;
+						}
+						if (content[cursor] === "\n") break;
+						cursor += 1;
+					}
+					ranges.push({
+						start,
+						end: cursor
+					});
+					continue;
+				}
+			}
+			if (character === "{") depth += 1;
+			if (character === "}") depth -= 1;
+			cursor += 1;
+		}
+		index = Math.max(index + 1, cursor);
+	}
+	return ranges;
+}
+function readGenericMdxJsxTag(content, index) {
+	let cursor = index + 1;
+	if (content[cursor] === "/") cursor += 1;
+	if (!/[A-Za-z]/.test(content[cursor] ?? "")) return void 0;
+	const nameStart = cursor;
+	while (/[\w:.-]/.test(content[cursor] ?? "")) cursor += 1;
+	const name = content.slice(nameStart, cursor);
+	if (DOCS_AUDIENCE_TAG_NAMES.some((candidate) => candidate === name)) return void 0;
+	if (!/[\s/>]/.test(content[cursor] ?? "")) return void 0;
+	const literals = [];
+	let braceDepth = 0;
+	while (cursor < content.length) {
+		const character = content[cursor];
+		const next = content[cursor + 1];
+		if (character === "\"" || character === "'" || character === "`") {
+			const quote = character;
+			const start = cursor;
+			cursor += 1;
+			while (cursor < content.length) {
+				if (content[cursor] === "\\") {
+					cursor += 2;
+					continue;
+				}
+				if (content[cursor] === quote) {
+					cursor += 1;
+					break;
+				}
+				cursor += 1;
+			}
+			literals.push({
+				start,
+				end: cursor
+			});
+			continue;
+		}
+		if (braceDepth > 0 && character === "/" && next === "*") {
+			const start = cursor;
+			const end = content.indexOf("*/", cursor + 2);
+			cursor = end === -1 ? content.length : end + 2;
+			literals.push({
+				start,
+				end: cursor
+			});
+			continue;
+		}
+		if (braceDepth > 0 && character === "/" && next === "/") {
+			const start = cursor;
+			const newline = content.indexOf("\n", cursor + 2);
+			cursor = newline === -1 ? content.length : newline;
+			literals.push({
+				start,
+				end: cursor
+			});
+			continue;
+		}
+		if (character === "{") braceDepth += 1;
+		else if (character === "}" && braceDepth > 0) braceDepth -= 1;
+		else if (character === ">" && braceDepth === 0) {
+			let previous = cursor - 1;
+			while (previous >= index && /\s/.test(content[previous] ?? "")) previous -= 1;
+			return {
+				end: cursor + 1,
+				literals,
+				selfClosing: content[previous] === "/"
+			};
+		}
+		cursor += 1;
+	}
+}
+function findGenericMdxJsxLiteralRanges(content, protectedRanges) {
+	const ranges = [];
+	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 = readGenericMdxJsxTag(content, index);
+		if (!tag) {
+			cursor = index + 1;
+			continue;
+		}
+		ranges.push(...tag.literals);
+		cursor = tag.end;
+	}
+	return ranges;
+}
+function findDelimiterExclusionRanges(content) {
+	const markdownLiterals = findMarkdownLiteralRanges(content);
+	const fences = findFenceRanges(content);
+	const frontmatter = findLeadingFrontmatterRange(content);
+	const literalBlocks = mergeProtectedRanges([
+		...markdownLiterals,
+		...fences,
+		...frontmatter ? [frontmatter] : []
+	]);
+	const inlineCode = findInlineCodeRanges(content, literalBlocks);
+	const markdownLinks = findMarkdownLinkDestinationRanges(content, literalBlocks);
+	const nonModuleRanges = mergeProtectedRanges([
+		...literalBlocks,
+		...inlineCode,
+		...markdownLinks
+	]);
+	const moduleRanges = findMdxModuleRanges(content, nonModuleRanges);
+	const nonExpressionRanges = mergeProtectedRanges([...nonModuleRanges, ...moduleRanges]);
+	const expressionLiterals = findMdxExpressionLiteralRanges(content, nonExpressionRanges);
+	const nonJsxRanges = mergeProtectedRanges([...nonExpressionRanges, ...expressionLiterals]);
+	return mergeProtectedRanges([...nonJsxRanges, ...findGenericMdxJsxLiteralRanges(content, nonJsxRanges)]);
+}
+function findProtectedRanges(content) {
+	const baseExcludedRanges = findDelimiterExclusionRanges(content);
+	const svelteDirectives = findSvelteDirectiveRanges(content, baseExcludedRanges);
+	const excludedRanges = mergeProtectedRanges([...baseExcludedRanges, ...svelteDirectives]);
+	const htmlLiterals = findHtmlLiteralRanges(content, excludedRanges);
+	return mergeProtectedRanges([...excludedRanges, ...htmlLiterals]);
+}
+function normalizeProjectedWhitespace(content) {
+	const protectedRanges = findProtectedRanges(content);
+	return content.replace(/\n{3,}/g, (newlines, offset) => {
+		const end = offset + newlines.length;
+		return protectedRanges.some((range) => range.start < end && range.end > offset) ? newlines : "\n\n";
+	}).trim();
+}
+/** Find audience declarations that cannot be projected consistently at build time. */
+function findDocsAudienceMdxIssues(content) {
+	const issues = [];
+	for (const tag of findDocsAudienceMdxTags(content)) {
+		if (tag.closing) continue;
+		const { attributes } = tag;
+		const hasOnlyAttribute = tag.hasOnlyAttribute ?? /(?:^|\s)only\s*=/.test(attributes);
+		const hasSpreadAttribute = tag.hasSpreadAttribute ?? /\{\s*\.\.\./.test(attributes);
+		if ((tag.name === "Agent" || tag.name === "Human") && hasOnlyAttribute) {
+			const shorthandAudience = tag.name === "Agent" ? "agent" : "human";
+			issues.push({
+				code: tag.name === "Agent" ? "ignored-agent-only" : "ignored-human-only",
+				index: tag.index,
+				message: `<${tag.name}> is always ${shorthandAudience}-only, so its \`only\` prop is ignored. Use <Audience only="${shorthandAudience}"> when you need the explicit form.`
+			});
+			continue;
+		}
+		if (tag.name !== "Audience") continue;
+		if (hasSpreadAttribute) {
+			issues.push({
+				code: "dynamic-only",
+				index: tag.index,
+				message: "Audience spread props cannot be projected consistently. Remove the spread and use the static literal `only=\"human\"` or `only=\"agent\"`."
+			});
+			continue;
+		}
+		if (tag.only) continue;
+		if (!hasOnlyAttribute) {
+			issues.push({
+				code: "missing-only",
+				index: tag.index,
+				message: "<Audience> requires the static literal `only=\"human\"` or `only=\"agent\"`."
+			});
+			continue;
+		}
+		const dynamicOnly = tag.onlyKind === "dynamic" || /(?:^|\s)only\s*=\s*\{/.test(attributes);
+		issues.push({
+			code: dynamicOnly ? "dynamic-only" : "invalid-only",
+			index: tag.index,
+			message: dynamicOnly ? "Dynamic Audience.only expressions cannot be projected consistently. Use the static literal `only=\"human\"` or `only=\"agent\"`." : "Audience.only must be the static literal `\"human\"` or `\"agent\"`."
+		});
+	}
+	return issues;
+}
+/**
+* Resolve MDX into its human or agent projection.
+*
+* `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
+* shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
+* treated as shared content so an authoring typo never silently deletes content.
+* These primitives shape content for each surface; they are not an access-control boundary.
+*/
+function resolveDocsAudienceMdxContent(content, audience) {
+	const scopes = [];
+	let output = "";
+	let cursor = 0;
+	let resolvedTag = false;
+	for (const tag of findDocsAudienceMdxTags(content)) {
+		const activeScope = scopes.at(-1);
+		if (tag.closing && activeScope?.name !== tag.name) continue;
+		resolvedTag = true;
+		const visibleBeforeTag = isAudienceVisible(scopes, audience);
+		if (visibleBeforeTag) output += content.slice(cursor, tag.index);
+		cursor = tag.end;
+		if (tag.closing) {
+			if (tag.expression && visibleBeforeTag) output += "</>";
+			scopes.pop();
+			continue;
+		}
+		if (tag.selfClosing) {
+			if (tag.expression && visibleBeforeTag) output += tag.jsxChild ? "{null}" : "null";
+			continue;
+		}
+		scopes.push({
+			name: tag.name,
+			only: tag.only
+		});
+		if (tag.expression && visibleBeforeTag) output += isAudienceVisible(scopes, audience) ? "<>" : tag.jsxChild ? "{null}" : "null";
+	}
+	if (isAudienceVisible(scopes, audience)) output += content.slice(cursor);
+	return resolvedTag ? normalizeProjectedWhitespace(output) : content;
+}
+/** Backwards-compatible name retained for existing integrations. */
+function resolveDocsAgentMdxContent(content, audience) {
+	return resolveDocsAudienceMdxContent(content, audience);
+}
+
 //#endregion
 //#region src/agent.ts
 const DEFAULT_DOCS_API_ROUTE = "/api/docs";
@@ -1873,7 +2986,8 @@ function renderLlmsFullTxtPages(pages, baseUrl) {
 		content += `## ${page.title}\n\n`;
 		content += `URL: ${baseUrl}${page.url}\n\n`;
 		if (page.description) content += `${page.description}\n\n`;
-		content += `${page.content}\n\n---\n\n`;
+		const agentContent = page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
+		content += `${agentContent}\n\n---\n\n`;
 	}
 	return content;
 }
@@ -2595,13 +3709,14 @@ function appendDocsAgentPublicRouteLines(lines, context, variant) {
 	appendDocsMcpRouteLines(lines, context);
 }
 function renderDocsMarkdownDocument(page, options) {
-	if (page.agentRawContent !== void 0) return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(upsertPageAgentContractMarkdown(page.agentRawContent, page.agent), resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
+	const explicitAgentContent = page.agentRawContent ?? page.agentContent;
+	if (explicitAgentContent !== void 0) return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(upsertPageAgentContractMarkdown(explicitAgentContent, 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("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.rawContent ?? page.content, page.agent));
+	lines.push("", upsertPageAgentContractMarkdown(page.agentFallbackRawContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content, page.agent));
 	return appendDocsMarkdownSitemapFooter(prependDocsMarkdownFrontmatter(lines.join("\n"), resolveDocsMarkdownPageMetadata(page, options)), options?.sitemap);
 }
 function renderDocsSkillDocument(options) {
@@ -2642,53 +3757,6 @@ function renderDocsAgentsDocument(options) {
 	lines.push("", "## Framework Maintenance", "- For @farming-labs/docs projects, keep the framework package current before debugging missing agent surfaces.", "", "```sh", "npx @farming-labs/docs@latest upgrade --latest", "```", "", "- For framework setup, configuration, CLI, Ask AI, page actions, or theme work, install the reusable Skills pack:", "", "```sh", "npx skills add farming-labs/docs", "```");
 	return lines.join("\n");
 }
-function resolveDocsAgentMdxContent(content, audience) {
-	const lines = content.split("\n");
-	const output = [];
-	let fenceMarker = null;
-	let agentDepth = 0;
-	for (const line of lines) {
-		const trimmed = line.trim();
-		const fenceMatch = trimmed.match(/^(`{3,}|~{3,})/);
-		if (fenceMatch) {
-			if (!fenceMarker) fenceMarker = fenceMatch[1];
-			else if (trimmed.startsWith(fenceMarker)) fenceMarker = null;
-			if (audience === "agent" || agentDepth === 0) output.push(line);
-			continue;
-		}
-		if (!fenceMarker) {
-			if (/^<Agent(?:\s[^>]*)?\/>$/.test(trimmed)) continue;
-			const singleLineMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>([\s\S]*?)<\/Agent>\s*$/);
-			if (singleLineMatch) {
-				if (audience === "agent" && singleLineMatch[2]) output.push(`${singleLineMatch[1]}${singleLineMatch[2]}`);
-				continue;
-			}
-			if (line.match(/^(\s*)<Agent(?:\s[^>]*)?>\s*$/)) {
-				agentDepth += 1;
-				continue;
-			}
-			const openWithContentMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>(.*)$/);
-			if (openWithContentMatch) {
-				agentDepth += 1;
-				if (audience === "agent" && openWithContentMatch[2]) output.push(`${openWithContentMatch[1]}${openWithContentMatch[2]}`);
-				continue;
-			}
-			const closeWithContentMatch = line.match(/^(.*)<\/Agent>\s*$/);
-			if (closeWithContentMatch && agentDepth > 0) {
-				if (audience === "agent" && closeWithContentMatch[1].trim()) output.push(closeWithContentMatch[1]);
-				agentDepth = Math.max(0, agentDepth - 1);
-				continue;
-			}
-			if (/^<\/Agent>\s*$/.test(trimmed) && agentDepth > 0) {
-				agentDepth = Math.max(0, agentDepth - 1);
-				continue;
-			}
-		}
-		if (agentDepth > 0 && audience === "human") continue;
-		output.push(line);
-	}
-	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;
@@ -2770,8 +3838,8 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, sear
 			apiPattern: `${DEFAULT_DOCS_API_ROUTE}?format=markdown&path={slug}`,
 			resolutionOrder: [
 				"agent.md",
-				"Agent blocks",
-				"page markdown"
+				"agent audience projection",
+				"shared page markdown"
 			]
 		},
 		agentContract: {
@@ -2990,4 +4058,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-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 };
+export { normalizeDocsPathSegment as $, stripGeneratedPageAgentContractMarkdown as $t, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as A, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as At, getDocsLlmsTxtMaxCharsIssue as B, toDocsSitemapMarkdownUrl as Bt, DEFAULT_OPENAPI_SCHEMA_ROUTE as C, findDocsAudienceMdxTags as Ct, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as D, DEFAULT_SITEMAP_MANIFEST_PATH as Dt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as E, resolveDocsAudienceMdxContent as Et, buildDocsDiagnostics as F, renderDocsSitemapMarkdown as Ft, isDocsAgentsRequest as G, PAGE_AGENT_CONTRACT_FIELD_SCHEMA as Gt, getDocsMarkdownVaryHeader as H, renderDocsRelatedMarkdownLines as Ht, buildDocsMcpEndpointCandidates as I, renderDocsSitemapXml as It, isDocsLlmsTxtPublicRequest as J, getPageAgentFrontmatterIssues as Jt, isDocsConfigRequest as K, PAGE_AGENT_CONTRACT_START_MARKER as Kt, createDocsMarkdownResponse as L, resolveDocsSitemapConfig as Lt, buildDocsAgentDiscoverySpec as M, buildDocsSitemapManifest as Mt, buildDocsAgentFeedbackSchema as N, createDocsSitemapResponse as Nt, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as O, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Ot, buildDocsConfigMap as P, readDocsSitemapManifestFromContentMap as Pt, matchesDocsLlmsTxtSection as Q, renderPageAgentFrontmatterYamlLines as Qt, detectDocsMarkdownAgentRequest as R, resolveDocsSitemapPageLastmod as Rt, DEFAULT_MCP_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as St, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as T, resolveDocsAudienceExposure as Tt, hasDocsMarkdownSignatureAgent as U, PAGE_AGENT_CONTRACT_END_MARKER as Ut, getDocsMarkdownCanonicalLinkHeader as V, normalizeDocsRelated as Vt, isDocsAgentDiscoveryRequest as W, PAGE_AGENT_CONTRACT_FIELDS as Wt, isDocsPublicGetRequest as X, normalizePageAgentFrontmatter as Xt, isDocsMcpRequest as Y, hasStructuredPageAgentContract as Yt, isDocsSkillRequest as Z, renderPageAgentContractMarkdown as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsOpenApiDiscoveryConfig as _t, DEFAULT_AGENT_MD_ROUTE as a, renderDocsMarkdownNotFound as at, DEFAULT_MCP_PUBLIC_ROUTE as b, toDocsMarkdownUrl as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, resolveDocsAgentFeedbackConfig as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, resolveDocsLlmsTxtFormat as dt, upsertPageAgentContractMarkdown as en, normalizeDocsUrlPath as et, DEFAULT_DOCS_CONFIG_ROUTE as f, resolveDocsLlmsTxtRequest as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsMarkdownRequest as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsMarkdownRecovery as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, renderDocsMarkdownDocument as it, acceptsDocsMarkdown as j, DEFAULT_SITEMAP_XML_ROUTE as jt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as k, DEFAULT_SITEMAP_MD_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, resolveDocsAgentFeedbackRequest as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsMarkdownCanonicalUrl 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, resolveDocsLlmsTxtSections as pt, isDocsDiagnosticsRequest as q, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS 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, resolveDocsAgentsFormat as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSkillFormat as vt, DEFAULT_SKILL_MD_ROUTE as w, resolveDocsAgentMdxContent as wt, DEFAULT_MCP_ROUTE as x, validateDocsAgentFeedbackPayload as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, selectDocsLlmsTxtContent as yt, findDocsMarkdownPage as z, resolveDocsSitemapRequest as zt };