@farming-labs/docs 0.2.57 → 0.2.59

package/dist/{reading-time-W_Id2ayC.mjs → reading-time-BkEft6SD.mjs}

@@ -1,5 +1,5 @@
-import { S as DEFAULT_MCP_WELL_KNOWN_ROUTE, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DRpoiYAV.mjs";
+import { Gt as API_CATALOG_PROFILE_URI, Nt as DEFAULT_SITEMAP_XML_ROUTE, Qt as DEFAULT_API_CATALOG_ROUTE, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, Ut as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, Wt as API_CATALOG_MEDIA_TYPE, Yt as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_MD_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, qt as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-BFqyqEnC.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-ltltiLJF.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts
@@ -159,9 +159,89 @@ function extendTheme(baseTheme, extensions) {
 	return deepMerge(baseTheme, extensions);
 }
 
+//#endregion
+//#region src/http-link.ts
+/** Split an HTTP list without treating delimiters inside quotes or URI references as separators. */
+function splitHttpList(value, delimiter) {
+	const parts = [];
+	let start = 0;
+	let quoted = false;
+	let escaped = false;
+	let angleDepth = 0;
+	for (let index = 0; index < value.length; index += 1) {
+		const character = value[index];
+		if (escaped) {
+			escaped = false;
+			continue;
+		}
+		if (quoted && character === "\\") {
+			escaped = true;
+			continue;
+		}
+		if (character === "\"") {
+			quoted = !quoted;
+			continue;
+		}
+		if (!quoted && character === "<") angleDepth += 1;
+		if (!quoted && character === ">" && angleDepth > 0) angleDepth -= 1;
+		if (!quoted && angleDepth === 0 && character === delimiter) {
+			parts.push(value.slice(start, index).trim());
+			start = index + 1;
+		}
+	}
+	parts.push(value.slice(start).trim());
+	return parts.filter(Boolean);
+}
+function unquoteHttpValue(value) {
+	const trimmed = value.trim();
+	if (!trimmed.startsWith("\"") || !trimmed.endsWith("\"")) return trimmed;
+	return trimmed.slice(1, -1).replace(/\\(.)/g, "$1");
+}
+/** Parse Link header values while preserving the target/relation association. */
+function parseHttpLinkHeader(header) {
+	if (!header) return [];
+	const links = [];
+	for (const value of splitHttpList(header, ",")) {
+		const target = value.match(/^\s*<([^>]*)>/);
+		if (!target) continue;
+		const relations = [];
+		for (const rawParameter of splitHttpList(value.slice(target[0].length), ";")) {
+			const separator = rawParameter.indexOf("=");
+			if (separator < 0 || rawParameter.slice(0, separator).trim().toLowerCase() !== "rel") continue;
+			relations.push(...unquoteHttpValue(rawParameter.slice(separator + 1)).toLowerCase().split(/\s+/));
+		}
+		links.push({
+			href: target[1],
+			relations: relations.filter(Boolean)
+		});
+	}
+	return links;
+}
+function httpLinkMatchesExpectation(links, expectation, responseUrl) {
+	let expectedUrl;
+	try {
+		expectedUrl = new URL(expectation.href, responseUrl).toString();
+	} catch {
+		return false;
+	}
+	return links.some((link) => {
+		try {
+			return new URL(link.href, responseUrl).toString() === expectedUrl && link.relations.includes(expectation.rel.toLowerCase());
+		} catch {
+			return false;
+		}
+	});
+}
+function httpLinkHeaderHasTargetRelation(header, href, rel, responseUrl) {
+	return httpLinkMatchesExpectation(parseHttpLinkHeader(header), {
+		href,
+		rel
+	}, responseUrl);
+}
+
 //#endregion
 //#region src/agent-conformance.ts
-const DOCS_AGENT_CONTRACT_VERSION = "1.0";
+const DOCS_AGENT_CONTRACT_VERSION = "1.1";
 function normalizeOrigin(value) {
 	return value.replace(/\/+$/, "");
 }
@@ -185,7 +265,118 @@ function createDocsAgentContractCases(options = {}) {
 			request: { url: url(DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE) },
 			expect: {
 				statuses: [200],
-				contentTypes: json
+				contentTypes: json,
+				linkRelations: [{
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}, {
+					href: DEFAULT_AGENT_SKILLS_INDEX_ROUTE,
+					rel: "service-meta"
+				}]
+			}
+		},
+		{
+			surface: "api-catalog",
+			request: { url: url(DEFAULT_API_CATALOG_ROUTE) },
+			expect: {
+				statuses: [200],
+				contentTypes: [`${API_CATALOG_MEDIA_TYPE}; profile="${API_CATALOG_PROFILE_URI}"`],
+				bodyIncludes: [
+					"linkset",
+					DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+					DEFAULT_AGENT_SKILLS_INDEX_ROUTE
+				],
+				linkRelations: [{
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
+			}
+		},
+		{
+			surface: "api-catalog-head",
+			request: {
+				url: url(DEFAULT_API_CATALOG_ROUTE),
+				init: { method: "HEAD" }
+			},
+			expect: {
+				statuses: [200],
+				contentTypes: [`${API_CATALOG_MEDIA_TYPE}; profile="${API_CATALOG_PROFILE_URI}"`],
+				bodyEmpty: true,
+				linkRelations: [{
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
+			}
+		},
+		{
+			surface: "agent-skills-index",
+			request: { url: url(DEFAULT_AGENT_SKILLS_INDEX_ROUTE) },
+			expect: {
+				statuses: [200],
+				contentTypes: json,
+				bodyIncludes: [
+					"https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+					`${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/docs/SKILL.md`,
+					"sha256:"
+				],
+				linkRelations: [{
+					href: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/docs/SKILL.md`,
+					rel: "item"
+				}, {
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
+			}
+		},
+		{
+			surface: "agent-skills-index-head",
+			request: {
+				url: url(DEFAULT_AGENT_SKILLS_INDEX_ROUTE),
+				init: { method: "HEAD" }
+			},
+			expect: {
+				statuses: [200],
+				contentTypes: json,
+				bodyEmpty: true,
+				linkRelations: [{
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
+			}
+		},
+		{
+			surface: "agent-skill",
+			request: { url: url(`${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/docs/SKILL.md`) },
+			expect: {
+				statuses: [200],
+				contentTypes: markdown,
+				bodyIncludes: ["name: docs"],
+				linkRelations: [{
+					href: DEFAULT_AGENT_SKILLS_INDEX_ROUTE,
+					rel: "collection"
+				}, {
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
+			}
+		},
+		{
+			surface: "agent-skill-head",
+			request: {
+				url: url(`${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/docs/SKILL.md`),
+				init: { method: "HEAD" }
+			},
+			expect: {
+				statuses: [200],
+				contentTypes: markdown,
+				bodyEmpty: true,
+				linkRelations: [{
+					href: DEFAULT_AGENT_SKILLS_INDEX_ROUTE,
+					rel: "collection"
+				}, {
+					href: DEFAULT_API_CATALOG_ROUTE,
+					rel: "api-catalog"
+				}]
 			}
 		},
 		{
@@ -340,22 +531,112 @@ function createDocsAgentContractCases(options = {}) {
 			}
 		}
 	];
-	if (locale) cases.splice(6, 0, {
-		surface: "markdown-locale",
-		request: { url: url(`/${entry}.md?lang=${encodeURIComponent(locale)}`) },
-		expect: {
-			statuses: [200],
-			contentTypes: markdown,
-			bodyIncludes: ["Bonjour"]
-		}
-	});
+	if (locale) {
+		const markdownMissingIndex = cases.findIndex((contractCase) => contractCase.surface === "markdown-missing");
+		cases.splice(markdownMissingIndex, 0, {
+			surface: "markdown-locale",
+			request: { url: url(`/${entry}.md?lang=${encodeURIComponent(locale)}`) },
+			expect: {
+				statuses: [200],
+				contentTypes: markdown,
+				bodyIncludes: ["Bonjour"]
+			}
+		});
+	}
 	return cases;
 }
+function parseParameterizedValue(value) {
+	const [rawValue, ...rawParameters] = splitHttpList(value, ";");
+	const normalizedValue = rawValue?.trim().toLowerCase();
+	if (!normalizedValue) return null;
+	const parameters = /* @__PURE__ */ new Map();
+	for (const rawParameter of rawParameters) {
+		const separator = rawParameter.indexOf("=");
+		if (separator < 0) continue;
+		const name = rawParameter.slice(0, separator).trim().toLowerCase();
+		if (!name) continue;
+		parameters.set(name, unquoteHttpValue(rawParameter.slice(separator + 1)));
+	}
+	return {
+		value: normalizedValue,
+		parameters
+	};
+}
 function matchesContentType(actual, expected) {
-	const [mediaType] = actual.split(";", 1);
-	const normalized = mediaType?.trim().toLowerCase();
-	if (!normalized) return false;
-	return expected.some((value) => normalized === value.trim().toLowerCase());
+	const parsedActual = parseParameterizedValue(actual);
+	if (!parsedActual) return false;
+	return expected.some((value) => {
+		const parsedExpected = parseParameterizedValue(value);
+		if (!parsedExpected || parsedExpected.value !== parsedActual.value) return false;
+		return [...parsedExpected.parameters].every(([name, expectedValue]) => parsedActual.parameters.get(name) === expectedValue);
+	});
+}
+function asRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function isNonEmptyString(value) {
+	return typeof value === "string" && value.trim().length > 0;
+}
+async function sha256Utf8(content) {
+	const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(content));
+	return [...new Uint8Array(digest)].map((value) => value.toString(16).padStart(2, "0")).join("");
+}
+async function validateAgentSkillsIndex(content, indexUrl, handle) {
+	const issues = [];
+	let parsed;
+	try {
+		parsed = JSON.parse(content);
+	} catch {
+		return ["Agent Skills index did not contain valid JSON"];
+	}
+	const root = asRecord(parsed);
+	if (root?.$schema !== AGENT_SKILLS_DISCOVERY_SCHEMA_URI) issues.push(`Agent Skills index did not declare ${AGENT_SKILLS_DISCOVERY_SCHEMA_URI}`);
+	if (!Array.isArray(root?.skills) || root.skills.length === 0) {
+		issues.push("Agent Skills index did not declare any skills");
+		return issues;
+	}
+	const seenNames = /* @__PURE__ */ new Set();
+	const origin = new URL(indexUrl).origin;
+	for (const rawSkill of root.skills) {
+		const skill = asRecord(rawSkill);
+		const name = skill?.name;
+		const description = skill?.description;
+		const artifactRoute = skill?.url;
+		const digest = skill?.digest;
+		if (!isNonEmptyString(name) || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(name) || name.length > 64 || skill?.type !== "skill-md" || !isNonEmptyString(description) || description.length > 1024 || !isNonEmptyString(artifactRoute) || typeof digest !== "string" || !/^sha256:[0-9a-f]{64}$/u.test(digest)) {
+			issues.push("Agent Skills index contained an invalid skill entry");
+			continue;
+		}
+		if (seenNames.has(name)) {
+			issues.push(`Agent Skills index declared duplicate skill ${JSON.stringify(name)}`);
+			continue;
+		}
+		seenNames.add(name);
+		let artifactUrl;
+		try {
+			artifactUrl = new URL(artifactRoute, indexUrl);
+		} catch {
+			issues.push(`Agent Skills artifact URL for ${JSON.stringify(name)} was invalid`);
+			continue;
+		}
+		const expectedPath = `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${name}/SKILL.md`;
+		if (artifactUrl.origin !== origin || !artifactUrl.pathname.endsWith(expectedPath)) {
+			issues.push(`Agent Skills artifact URL for ${JSON.stringify(name)} did not resolve to same-origin ${expectedPath}`);
+			continue;
+		}
+		try {
+			const response = await handle(new Request(artifactUrl), "agent-skill");
+			const artifact = await response.text();
+			if (response.status !== 200) issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} returned status ${response.status}`);
+			const contentType = response.headers.get("content-type") ?? "";
+			if (!matchesContentType(contentType, ["text/markdown"])) issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} returned content-type ${contentType || "<missing>"}`);
+			const actualDigest = `sha256:${await sha256Utf8(artifact)}`;
+			if (actualDigest !== digest) issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} digest ${actualDigest} did not match ${digest}`);
+		} catch (error) {
+			issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	return issues;
 }
 async function runDocsAgentConformance(options) {
 	const cases = createDocsAgentContractCases(options);
@@ -369,6 +650,14 @@ async function runDocsAgentConformance(options) {
 			if (!contractCase.expect.statuses.includes(response.status)) issues.push(`expected status ${contractCase.expect.statuses.join(" or ")}, received ${response.status}`);
 			if (!matchesContentType(contentType, contractCase.expect.contentTypes)) issues.push(`expected content-type ${contractCase.expect.contentTypes.join(" or ")}, received ${contentType || "<missing>"}`);
 			for (const requiredText of contractCase.expect.bodyIncludes ?? []) if (!body.toLowerCase().includes(requiredText.toLowerCase())) issues.push(`response body did not include ${JSON.stringify(requiredText)}`);
+			if (contractCase.expect.bodyEmpty && body !== "") issues.push(`expected an empty response body, received ${body.length} characters`);
+			if (contractCase.surface === "agent-skills-index") issues.push(...await validateAgentSkillsIndex(body, contractCase.request.url, options.handle));
+			for (const [header, requiredValues] of Object.entries(contractCase.expect.headerIncludes ?? {})) {
+				const actual = response.headers.get(header) ?? "";
+				for (const requiredValue of requiredValues) if (!actual.toLowerCase().includes(requiredValue.toLowerCase())) issues.push(`response header ${JSON.stringify(header)} did not include ${JSON.stringify(requiredValue)}`);
+			}
+			const parsedLinks = parseHttpLinkHeader(response.headers.get("link"));
+			for (const expectation of contractCase.expect.linkRelations ?? []) if (!httpLinkMatchesExpectation(parsedLinks, expectation, contractCase.request.url)) issues.push(`response Link header did not include ${JSON.stringify(expectation.href)} with rel=${JSON.stringify(expectation.rel)} in the same link-value`);
 			results.push({
 				surface: contractCase.surface,
 				passed: issues.length === 0,
@@ -393,238 +682,6 @@ async function runDocsAgentConformance(options) {
 	};
 }
 
-//#endregion
-//#region src/metadata.ts
-/**
-* Resolve page title using metadata titleTemplate.
-* %s is replaced with page title.
-*/
-function resolveTitle(pageTitle, metadata) {
-	return (metadata?.titleTemplate ?? "%s").replace("%s", pageTitle);
-}
-/**
-* Resolve OG image URL for a page.
-* Prefers page.openGraph.images[0], then page.ogImage, then config endpoint/default.
-*/
-function resolveOGImage(page, ogConfig, baseUrl) {
-	if (page.openGraph?.images?.length) return resolveImageUrl(page.openGraph.images[0].url, baseUrl);
-	if (!ogConfig?.enabled) return void 0;
-	if (page.ogImage) return resolveImageUrl(page.ogImage, baseUrl);
-	if (ogConfig.type === "dynamic" && ogConfig.endpoint) return `${baseUrl ?? ""}${ogConfig.endpoint}`;
-	return ogConfig.defaultImage;
-}
-function resolveImageUrl(url, baseUrl) {
-	if (url.startsWith("/") || url.startsWith("http")) return url;
-	const base = baseUrl ?? "";
-	return `${base}${base.length > 0 && !base.endsWith("/") ? "/" : ""}${url}`;
-}
-/**
-* Build the Open Graph metadata object for a page.
-* When the page has openGraph in frontmatter, uses it (with title/description filled from page if omitted).
-* Otherwise uses ogImage or config (dynamic endpoint / defaultImage).
-*/
-function buildPageOpenGraph(page, ogConfig, baseUrl) {
-	if (page.openGraph) {
-		const images = page.openGraph.images?.length ? page.openGraph.images.map((img) => ({
-			url: resolveImageUrl(img.url, baseUrl),
-			width: img.width ?? 1200,
-			height: img.height ?? 630
-		})) : void 0;
-		return {
-			title: page.openGraph.title ?? page.title,
-			description: page.openGraph.description ?? page.description,
-			...images && { images }
-		};
-	}
-	const url = resolveOGImage(page, ogConfig, baseUrl);
-	if (!url) return void 0;
-	return {
-		title: page.title,
-		...page.description && { description: page.description },
-		images: [{
-			url,
-			width: 1200,
-			height: 630
-		}]
-	};
-}
-/**
-* Build the Twitter card metadata object for a page.
-* When the page has twitter in frontmatter, uses it.
-* Otherwise builds from ogImage or config (dynamic endpoint).
-*/
-function buildPageTwitter(page, ogConfig, baseUrl) {
-	if (page.twitter) {
-		const images = page.twitter.images?.length ? page.twitter.images.map((url) => resolveImageUrl(url, baseUrl)) : void 0;
-		return {
-			...page.twitter.card && { card: page.twitter.card },
-			...page.twitter.title !== void 0 && { title: page.twitter.title },
-			...page.twitter.description !== void 0 && { description: page.twitter.description },
-			...images && { images }
-		};
-	}
-	const url = resolveOGImage(page, ogConfig, baseUrl);
-	if (!url) return void 0;
-	return {
-		card: "summary_large_image",
-		title: page.title,
-		...page.description && { description: page.description },
-		images: [url]
-	};
-}
-function normalizeBaseUrl(value) {
-	if (!value) return void 0;
-	try {
-		return new URL(value).toString().replace(/\/+$/, "");
-	} catch {
-		return;
-	}
-}
-function absolutizeUrl(url, baseUrl) {
-	const base = normalizeBaseUrl(baseUrl);
-	if (!base) return url;
-	try {
-		return new URL(url, `${base}/`).toString();
-	} catch {
-		return url;
-	}
-}
-function titleFromSegment(segment) {
-	return segment.replace(/\.[a-z0-9]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
-}
-function normalizeRoutePath(url) {
-	try {
-		return new URL(url, "https://farming-labs.local").pathname.replace(/\/+$/, "") || "/";
-	} catch {
-		return `/${url.replace(/^\/+/, "")}`.replace(/\/+$/, "") || "/";
-	}
-}
-function buildDefaultBreadcrumbs(input) {
-	const routePath = normalizeRoutePath(input.url);
-	const entry = (input.entry ?? "docs").replace(/^\/+|\/+$/g, "") || "docs";
-	const segments = routePath.split("/").filter(Boolean);
-	const entryParts = entry.split("/").filter(Boolean);
-	const contentSegments = segments.slice(0, entryParts.length).join("/") === entryParts.join("/") ? segments.slice(entryParts.length) : segments;
-	const breadcrumbs = [{
-		name: titleFromSegment(entryParts[entryParts.length - 1] ?? "Docs"),
-		url: `/${entry}`
-	}];
-	let current = `/${entry}`;
-	contentSegments.forEach((segment, index) => {
-		current = `${current}/${segment}`.replace(/\/+/g, "/");
-		breadcrumbs.push({
-			name: index === contentSegments.length - 1 ? input.title : titleFromSegment(segment),
-			url: current
-		});
-	});
-	return breadcrumbs;
-}
-function normalizeDateModified(value) {
-	if (!value) return void 0;
-	const date = new Date(value);
-	return Number.isNaN(date.getTime()) ? value : date.toISOString();
-}
-function buildAgentContractHowTo(value, fallback) {
-	const agent = normalizePageAgentFrontmatter(value);
-	if (!agent || !hasStructuredPageAgentContract(agent)) return void 0;
-	const steps = [];
-	for (const command of agent.commands ?? []) {
-		const run = typeof command === "string" ? command : command.run;
-		const description = typeof command === "string" ? void 0 : command.description;
-		const cwd = typeof command === "string" ? void 0 : command.cwd;
-		steps.push({
-			"@type": "HowToStep",
-			position: steps.length + 1,
-			name: description ?? "Run command",
-			text: cwd ? `${run} (from ${cwd})` : run
-		});
-	}
-	for (const verification of agent.verification ?? []) {
-		const description = typeof verification === "string" ? verification : verification.description ?? "Verify the result";
-		const details = typeof verification === "string" ? verification : [verification.run, verification.expect ? `Expected: ${verification.expect}` : void 0].filter(Boolean).join(". ");
-		steps.push({
-			"@type": "HowToStep",
-			position: steps.length + 1,
-			name: description,
-			text: details || description
-		});
-	}
-	const supplies = [...(agent.prerequisites ?? []).map((name) => ({
-		"@type": "HowToSupply",
-		name
-	})), ...(agent.files ?? []).map((name) => ({
-		"@type": "HowToSupply",
-		name
-	}))];
-	const about = Object.entries(agent.appliesTo ?? {}).flatMap(([kind, values]) => (typeof values === "string" ? [values] : values ?? []).map((name) => ({
-		"@type": "Thing",
-		name: `${kind}: ${name}`
-	})));
-	return {
-		"@type": "HowTo",
-		name: agent.task ?? fallback.title,
-		...agent.outcome ?? fallback.description ? { description: agent.outcome ?? fallback.description } : {},
-		...about.length > 0 ? { about } : {},
-		...supplies.length > 0 ? { supply: supplies } : {},
-		...steps.length > 0 ? { step: steps } : {}
-	};
-}
-/**
-* Resolve the public docs site URL from existing agent-facing config.
-*
-* The framework intentionally reuses `sitemap.baseUrl`, `llmsTxt.baseUrl`,
-* `robots.baseUrl`, or `ai.docsUrl` instead of requiring another setting.
-*/
-function resolveDocsMetadataBaseUrl(config) {
-	return [
-		typeof config.sitemap === "object" ? config.sitemap.baseUrl : void 0,
-		typeof config.llmsTxt === "object" ? config.llmsTxt.baseUrl : void 0,
-		typeof config.robots === "object" ? config.robots.baseUrl : void 0,
-		config.ai?.docsUrl
-	].map((value) => normalizeBaseUrl(value)).find((value) => Boolean(value));
-}
-/**
-* Build Schema.org JSON-LD for a docs page.
-*
-* The shape follows Vercel's agent readability guidance: a `TechArticle`
-* with title, description, canonical URL, freshness, and breadcrumbs.
-*/
-function buildDocsPageStructuredData(input) {
-	const breadcrumbs = input.breadcrumbs?.length ? input.breadcrumbs : buildDefaultBreadcrumbs(input);
-	const result = {
-		"@context": "https://schema.org",
-		"@type": "TechArticle",
-		headline: input.title,
-		name: input.title,
-		url: absolutizeUrl(input.url, input.baseUrl),
-		mainEntityOfPage: {
-			"@type": "WebPage",
-			"@id": absolutizeUrl(input.url, input.baseUrl)
-		},
-		breadcrumb: {
-			"@type": "BreadcrumbList",
-			itemListElement: breadcrumbs.map((item, index) => ({
-				"@type": "ListItem",
-				position: index + 1,
-				name: item.name,
-				item: absolutizeUrl(item.url, input.baseUrl)
-			}))
-		}
-	};
-	if (input.description) result.description = input.description;
-	const agentContract = buildAgentContractHowTo(input.agent, input);
-	if (agentContract) result.mainEntity = agentContract;
-	const dateModified = normalizeDateModified(input.dateModified);
-	if (dateModified) result.dateModified = dateModified;
-	return result;
-}
-/**
-* Serialize Schema.org JSON-LD for safe insertion into a `<script>` tag.
-*/
-function renderDocsPageStructuredDataJson(input) {
-	return JSON.stringify(buildDocsPageStructuredData(input)).replace(/</g, "\\u003c");
-}
-
 //#endregion
 //#region src/reading-time.ts
 function hasExplicitReadingTime(frontmatter) {
@@ -681,4 +738,4 @@ function resolveReadingTimeFromSource(source, wordsPerMinute, options) {
 }
 
 //#endregion
-export { extendTheme as _, resolveReadingTimeOptions as a, defineDocs as b, buildPageTwitter as c, resolveOGImage as d, resolveTitle as f, createTheme as g, runDocsAgentConformance as h, resolveReadingTimeFromSource as i, renderDocsPageStructuredDataJson as l, createDocsAgentContractCases as m, resolvePageReadingTime as n, buildDocsPageStructuredData as o, DOCS_AGENT_CONTRACT_VERSION as p, resolveReadingTimeFromContent as r, buildPageOpenGraph as s, estimateReadingTimeMinutes as t, resolveDocsMetadataBaseUrl as u, deepMerge as v, resolveChangelogConfig as y };
+export { resolveReadingTimeOptions as a, runDocsAgentConformance as c, extendTheme as d, deepMerge as f, resolveReadingTimeFromSource as i, httpLinkHeaderHasTargetRelation as l, defineDocs as m, resolvePageReadingTime as n, DOCS_AGENT_CONTRACT_VERSION as o, resolveChangelogConfig as p, resolveReadingTimeFromContent as r, createDocsAgentContractCases as s, estimateReadingTimeMinutes as t, createTheme as u };