@farming-labs/docs 0.2.103 → 0.2.105

package/dist/{agent-BLHMoVId.mjs → agent-CaCWThBY.mjs}

@@ -1,8 +1,8 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-CFqECAG0.mjs";
-import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { c as hashGeneratedAgentContent, d as serializeGeneratedAgentDocument, s as GENERATED_AGENT_PROVENANCE_VERSION, u as parseGeneratedAgentDocument } from "./content-change-hydration-BsbBXAUi.mjs";
+import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-BKy4labo.mjs";
+import { V as findDocsMarkdownPage, ot as renderDocsMarkdownDocument } from "./agent-DCTGj6J7.mjs";
+import { d as GENERATED_AGENT_PROVENANCE_VERSION, f as hashGeneratedAgentContent, h as serializeGeneratedAgentDocument, m as parseGeneratedAgentDocument } from "./openapi-mcp-DQ3xptKo.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-BaTmjDqD.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-DrZ3fXgf.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";

package/dist/{agent-CFqECAG0.mjs → agent-DCTGj6J7.mjs}

@@ -1,8 +1,153 @@
-import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, b as renderPageAgentFrontmatterYamlLines, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, K as digestDocsRetrievalContent, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, W as resolveDocsHttpDate, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, q as isDocsRetrievalCanonicalUrl, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Ckx0tN7B.mjs";
+import { C as filterDocsPagesByAccess, S as upsertPageAgentContractMarkdown, T as isDocsPageAccessAllowed, a as findDocsGeneratedAgentContractRanges, b as renderPageAgentFrontmatterYamlLines, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-BKy4labo.mjs";
+import { n as digestDocsRetrievalContent, r as isDocsRetrievalCanonicalUrl } from "./retrieval-digest-B-SgtXKK.mjs";
 import { t as resolveDocsAudienceExposure } from "./audience-exposure-DVsfT9Sx.mjs";
+import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, W as resolveDocsHttpDate, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Bpz90VYq.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
+//#region src/okf.ts
+const DOCS_OKF_VERSION = "0.2";
+const DOCS_OKF_BUNDLE_FORMAT = "open-knowledge-format.v0.2";
+const DEFAULT_DOCS_OKF_ROUTE = "/.well-known/okf.json";
+function cleanString$1(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim() || void 0;
+}
+function normalizeDate(value) {
+	if (value instanceof Date && Number.isFinite(value.getTime())) return value.toISOString();
+	const stringValue = cleanString$1(value);
+	if (!stringValue) return void 0;
+	const parsed = new Date(stringValue);
+	return Number.isFinite(parsed.getTime()) ? parsed.toISOString() : void 0;
+}
+function normalizeDateOnly$1(value) {
+	return normalizeDate(value)?.slice(0, 10);
+}
+function normalizeStatus(value) {
+	return value === "draft" || value === "stable" || value === "deprecated" ? value : void 0;
+}
+function normalizeActorTimestamp(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const by = cleanString$1(record.by);
+	const at = normalizeDate(record.at);
+	return by && at ? {
+		by,
+		at
+	} : void 0;
+}
+function normalizeSource(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const resource = cleanString$1(record.resource);
+	if (!resource) return void 0;
+	const usageCount = typeof record.usage_count === "number" && Number.isInteger(record.usage_count) ? Math.max(0, record.usage_count) : void 0;
+	const usageWindowRecord = record.usage_window && typeof record.usage_window === "object" && !Array.isArray(record.usage_window) ? record.usage_window : void 0;
+	const usageWindow = usageWindowRecord ? {
+		...normalizeDate(usageWindowRecord.start) ? { start: normalizeDate(usageWindowRecord.start) } : {},
+		...normalizeDate(usageWindowRecord.end) ? { end: normalizeDate(usageWindowRecord.end) } : {}
+	} : void 0;
+	return {
+		resource,
+		...cleanString$1(record.id) ? { id: cleanString$1(record.id) } : {},
+		...cleanString$1(record.title) ? { title: cleanString$1(record.title) } : {},
+		...cleanString$1(record.author) ? { author: cleanString$1(record.author) } : {},
+		...usageCount !== void 0 ? { usage_count: usageCount } : {},
+		...normalizeDate(record.last_modified) ? { last_modified: normalizeDate(record.last_modified) } : {},
+		...usageWindow && Object.keys(usageWindow).length > 0 ? { usage_window: usageWindow } : {}
+	};
+}
+function normalizeDocsOkfTrustMetadataInput(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const record = value;
+	const sources = Array.isArray(record.sources) ? record.sources.flatMap((source) => {
+		const normalized = normalizeSource(source);
+		return normalized ? [normalized] : [];
+	}) : void 0;
+	const verified = Array.isArray(record.verified) ? record.verified.flatMap((entry) => {
+		const normalized = normalizeActorTimestamp(entry);
+		return normalized ? [normalized] : [];
+	}) : void 0;
+	const generated = normalizeActorTimestamp(record.generated);
+	const status = normalizeStatus(record.status);
+	const staleAfter = normalizeDateOnly$1(record.stale_after);
+	const result = {
+		...sources && sources.length > 0 ? { sources } : {},
+		...generated ? { generated } : {},
+		...verified && verified.length > 0 ? { verified } : {},
+		...status ? { status } : {},
+		...staleAfter ? { stale_after: staleAfter } : {}
+	};
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function resolveDocsOkfConfig(value) {
+	const config = value && typeof value === "object" ? value : {};
+	return {
+		enabled: value === true || typeof value === "object" && value !== null && value.enabled !== false,
+		route: cleanString$1(config.route) ?? DEFAULT_DOCS_OKF_ROUTE,
+		generatedBy: cleanString$1(config.generatedBy) ?? "software:@farming-labs/docs",
+		...Number.isInteger(config.staleAfterDays) && (config.staleAfterDays ?? 0) > 0 ? { staleAfterDays: config.staleAfterDays } : {},
+		...normalizeDocsOkfTrustMetadataInput(config)
+	};
+}
+function addDays(value, days) {
+	const parsed = new Date(value);
+	if (!Number.isFinite(parsed.getTime())) return void 0;
+	parsed.setUTCDate(parsed.getUTCDate() + days);
+	return parsed.toISOString().slice(0, 10);
+}
+function trustTier(verified) {
+	if (verified.some((entry) => entry.by.toLowerCase().startsWith("human:"))) return "human-reviewed";
+	return verified.length > 0 ? "machine-confirmed" : "unverified";
+}
+function resolveDocsOkfTrustMetadata(page, value, now = /* @__PURE__ */ new Date()) {
+	const config = resolveDocsOkfConfig(value);
+	const authored = normalizeDocsOkfTrustMetadataInput(page.okf) ?? {};
+	const bestTimestamp = normalizeDate(page.lastmod) ?? normalizeDate(page.lastModified);
+	const generated = authored.generated ?? config.generated ?? {
+		by: config.generatedBy,
+		at: bestTimestamp ?? "1970-01-01T00:00:00.000Z"
+	};
+	const sources = [...authored.sources ?? config.sources ?? []];
+	if (sources.length === 0) sources.push({
+		resource: page.canonicalUrl ?? page.url,
+		...page.sourcePath ? { id: page.sourcePath } : {},
+		title: page.title,
+		...bestTimestamp ? { last_modified: bestTimestamp } : {}
+	});
+	const verified = [...authored.verified ?? config.verified ?? []];
+	const staleAfter = authored.stale_after ?? config.stale_after ?? (config.staleAfterDays && bestTimestamp ? addDays(bestTimestamp, config.staleAfterDays) : void 0);
+	return {
+		sources,
+		generated,
+		verified,
+		status: authored.status ?? config.status ?? "stable",
+		...staleAfter ? { stale_after: staleAfter } : {},
+		trust_tier: trustTier(verified),
+		stale: staleAfter ? now.getTime() > (/* @__PURE__ */ new Date(`${staleAfter}T23:59:59.999Z`)).getTime() : false
+	};
+}
+function buildDocsOkfBundle(pages, value) {
+	const config = resolveDocsOkfConfig(value);
+	const documents = pages.map((page) => ({
+		id: page.sourcePath ?? page.url,
+		url: page.canonicalUrl ?? page.url,
+		title: page.title,
+		...page.content ? { content: page.content } : {},
+		trust: resolveDocsOkfTrustMetadata(page, config)
+	})).sort((left, right) => left.url.localeCompare(right.url));
+	const generatedAt = documents.reduce((latest, document) => document.trust.generated.at > latest ? document.trust.generated.at : latest, "1970-01-01T00:00:00.000Z");
+	return {
+		format: DOCS_OKF_BUNDLE_FORMAT,
+		spec_version: DOCS_OKF_VERSION,
+		generated: {
+			by: config.generatedBy,
+			at: generatedAt
+		},
+		documents
+	};
+}
+
+//#endregion
 //#region src/mcp-auth.ts
 const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
 const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
@@ -2990,17 +3135,18 @@ async function buildDocsSearchIndexGeneration(pages, options) {
 * locale, base URL, and chunking policy.
 */
 async function buildDocsContentSnapshot(options) {
+	const pages = filterDocsPagesByAccess(options.pages, options.principal);
 	const audience = resolveDocsSearchAudience(options.audience);
 	const search = normalizeDocsSearchConfig(options.search);
 	const digestCache = /* @__PURE__ */ new Map();
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.pages, {
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(pages, {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
 		baseUrl: options.baseUrl,
 		digestCache
 	});
-	const documents = await Promise.all(options.pages.map(async (page) => {
+	const documents = await Promise.all(pages.map(async (page) => {
 		const localizedPage = localizeDocsSearchPage(page, options.locale);
 		const source = await buildDocsRetrievalSource(page, localizedPage.url, {
 			audience,
@@ -3315,6 +3461,7 @@ async function enrichDocsSearchResultsWithSources(options) {
 		const page = findPageForSearchResult(localizedPages, result, options.baseUrl, pagesByRoute);
 		if (page) return {
 			...resultWithoutSource,
+			trust: resolveDocsOkfTrustMetadata(page),
 			source: await buildDocsRetrievalSource(page, result.url, {
 				audience: options.audience,
 				chunking: options.chunking,
@@ -4986,7 +5133,9 @@ async function performDocsSearchInternal(options) {
 	const audience = resolveDocsSearchAudience(options.audience);
 	const filters = normalizeDocsSearchFilters(options.filters);
 	const hasFilters = hasDocsSearchFilters(filters);
-	const corpusPages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale));
+	const accessiblePages = filterDocsPagesByAccess(options.pages, options.principal);
+	const accessibleGenerationPages = filterDocsPagesByAccess(options.generationPages ?? options.pages, options.principal);
+	const corpusPages = accessiblePages.map((page) => localizeDocsSearchPage(page, options.locale));
 	const indexBaseUrl = options.syncBaseUrl === null ? void 0 : options.syncBaseUrl ?? options.baseUrl;
 	const scopedPages = hasFilters ? corpusPages.filter((page) => docsSearchPageMatchesFilters(resolveDocsSearchPageScope(page), filters)) : corpusPages;
 	let resolvedDocuments;
@@ -5025,7 +5174,7 @@ async function performDocsSearchInternal(options) {
 	};
 	let currentIndexGeneration;
 	const getCurrentIndexGeneration = () => {
-		currentIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+		currentIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(accessibleGenerationPages, {
 			audience,
 			chunking: search.chunking,
 			locale: options.locale,
@@ -5036,7 +5185,7 @@ async function performDocsSearchInternal(options) {
 	const requireCurrentIndexGeneration = search.provider === "algolia" || search.provider === "typesense";
 	let hostedIndexGeneration;
 	const getHostedIndexGeneration = () => {
-		hostedIndexGeneration ??= audience === "human" ? getCurrentIndexGeneration() : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+		hostedIndexGeneration ??= audience === "human" ? getCurrentIndexGeneration() : buildDocsSearchIndexGeneration(accessibleGenerationPages, {
 			audience: "human",
 			chunking: search.chunking,
 			locale: options.locale,
@@ -5290,8 +5439,9 @@ async function buildDocsSearchFacets(options) {
 	const requestedLimit = options.limit ?? MAX_SEARCH_FACET_VALUES;
 	if (!Number.isSafeInteger(requestedLimit) || requestedLimit < 1 || requestedLimit > MAX_SEARCH_FACET_VALUES) throw new DocsSearchRequestError("Search limit must be an integer between 1 and 100.");
 	if (options.cursor !== void 0 && options.facet === void 0) throw new DocsSearchRequestError("Facet continuation cursors require a `facet` field.");
-	const pages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale)).map((page) => ({ scope: resolveDocsSearchPageScope(page) }));
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.pages, {
+	const accessiblePages = filterDocsPagesByAccess(options.pages, options.principal);
+	const pages = accessiblePages.map((page) => localizeDocsSearchPage(page, options.locale)).map((page) => ({ scope: resolveDocsSearchPageScope(page) }));
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(accessiblePages, {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
@@ -5436,7 +5586,7 @@ async function performDocsSearchWithMetadata(options) {
 	const search = normalizeDocsSearchConfig(options.search);
 	const requestedLimit = options.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT;
 	const limit = Number.isFinite(requestedLimit) && requestedLimit > 0 ? Math.max(1, Math.floor(requestedLimit)) : DEFAULT_SEARCH_LIMIT;
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(filterDocsPagesByAccess(options.generationPages ?? options.pages, options.principal), {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
@@ -6123,6 +6273,8 @@ const DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS = {
 	listPages: true,
 	listPageSections: true,
 	readPage: true,
+	readPages: true,
+	submitFeedback: true,
 	listTasks: true,
 	readTask: true,
 	searchDocs: true,
@@ -7152,6 +7304,7 @@ function renderLlmsFullTxtPages(pages, baseUrl) {
 	return content;
 }
 function renderDocsLlmsTxt(pages, options = {}) {
+	pages = filterDocsPagesByAccess(pages);
 	const siteTitle = options.siteTitle ?? "Documentation";
 	const siteDescription = options.siteDescription;
 	const baseUrl = options.baseUrl ?? "";
@@ -7633,7 +7786,7 @@ function resolveDocsMarkdownMetadataUrl(value, origin) {
 		return value;
 	}
 }
-function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, agent, generatedPreamble }) {
+function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markdownUrl, lastUpdated, trust, agent, generatedPreamble }) {
 	return [
 		"---",
 		`title: ${toYamlString(title)}`,
@@ -7641,6 +7794,7 @@ function renderDocsMarkdownFrontmatter({ title, description, canonicalUrl, markd
 		`canonical_url: ${toYamlString(canonicalUrl)}`,
 		`markdown_url: ${toYamlString(markdownUrl)}`,
 		...lastUpdated ? [`last_updated: ${toYamlString(lastUpdated)}`] : [],
+		...trust ? [`okf: ${JSON.stringify(trust)}`] : [],
 		...generatedPreamble ? [`${DOCS_MARKDOWN_GENERATED_PREAMBLE_FIELD}: true`] : [],
 		...renderPageAgentFrontmatterYamlLines(agent),
 		"---"
@@ -7914,13 +8068,19 @@ function selectDocsMarkdownSection(document, request) {
 	};
 }
 function resolveDocsMarkdownPageMetadata(page, options) {
+	const canonicalUrl = resolveDocsMarkdownMetadataUrl(page.url, options?.origin);
+	const okfEnabled = resolveDocsOkfConfig(options?.okf).enabled || page.okf !== void 0;
 	return {
 		title: page.title,
 		description: page.description,
-		canonicalUrl: resolveDocsMarkdownMetadataUrl(page.url, options?.origin),
+		canonicalUrl,
 		markdownUrl: resolveDocsMarkdownMetadataUrl(page.markdownUrl ?? toDocsMarkdownUrl(page.url), options?.origin),
 		lastUpdated: normalizeDocsMarkdownLastUpdated(page.lastmod ?? page.lastModified),
-		agent: page.agent
+		agent: page.agent,
+		...okfEnabled ? { trust: resolveDocsOkfTrustMetadata({
+			...page,
+			canonicalUrl
+		}, options?.okf) } : {}
 	};
 }
 function renderDocsMarkdownNotFound({ entry = "docs", apiRoute, requestedPath, origin, pages, sitemap }) {
@@ -7994,7 +8154,7 @@ function appendDocsMarkdownSectionQuery(value, sectionRequest) {
 }
 /** 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 { request, document, entry = "docs", requestedPath, origin = new URL(request.url).origin, pages: rawPages, sitemap, locale } = options;
 	const canonicalUrl = options.canonicalUrl ?? resolveDocsMarkdownCanonicalUrl({
 		origin,
 		entry,
@@ -8003,11 +8163,23 @@ function createDocsMarkdownResponse(options) {
 	});
 	const contentLocation = options.contentLocation ?? resolveDocsMarkdownContentLocation(canonicalUrl);
 	const varyHeader = getDocsMarkdownVaryHeader(request);
+	const llmsTxtUrl = new URL(DEFAULT_LLMS_TXT_ROUTE, origin).toString();
+	const discoveryLink = `<${llmsTxtUrl}>; rel="describedby"; type="text/plain"`;
 	const baseSharedHeaders = {
 		"X-Robots-Tag": "noindex",
+		"X-Llms-Txt": llmsTxtUrl,
 		...locale ? { "Content-Language": locale } : {},
 		...varyHeader ? { Vary: varyHeader } : {}
 	};
+	const pages = rawPages ? filterDocsPagesByAccess(rawPages, options.principal) : void 0;
+	if (!isDocsPageAccessAllowed(options.access, options.principal)) return new Response("Not Found", {
+		status: 404,
+		headers: {
+			...baseSharedHeaders,
+			"Cache-Control": "private, no-store",
+			"Content-Type": "text/plain; charset=utf-8"
+		}
+	});
 	if (!document) {
 		const recovery = resolveDocsMarkdownRecovery({
 			entry,
@@ -8020,7 +8192,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": contentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical"`,
+				Link: `<${canonicalUrl}>; rel="canonical", ${discoveryLink}`,
 				"Cache-Control": "no-store",
 				Location: new URL(recovery.redirect.markdownUrl, request.url).toString()
 			}
@@ -8037,7 +8209,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": contentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical"`,
+				Link: `<${canonicalUrl}>; rel="canonical", ${discoveryLink}`,
 				"Cache-Control": "no-store",
 				"Content-Type": "text/markdown; charset=utf-8"
 			}
@@ -8064,7 +8236,7 @@ function createDocsMarkdownResponse(options) {
 			headers: {
 				...baseSharedHeaders,
 				"Content-Location": sectionIndexContentLocation,
-				Link: `<${canonicalUrl}>; rel="canonical", <${contentLocation}>; rel="alternate"; type="text/markdown"`,
+				Link: `<${canonicalUrl}>; rel="canonical", <${contentLocation}>; rel="alternate"; type="text/markdown", ${discoveryLink}`,
 				"Cache-Control": options.cacheControl ?? "public, max-age=0, s-maxage=3600",
 				"Content-Type": "application/json; charset=utf-8",
 				"X-Docs-Markdown-Section-Index": DOCS_MARKDOWN_SECTION_INDEX_FORMAT,
@@ -8096,7 +8268,7 @@ function createDocsMarkdownResponse(options) {
 	const responseHeaders = {
 		...baseSharedHeaders,
 		"Content-Location": sectionContentLocation,
-		Link: `<${sectionCanonicalUrl}>; rel="canonical"`,
+		Link: `<${sectionCanonicalUrl}>; rel="canonical", ${discoveryLink}`,
 		"Cache-Control": sectionResult?.found === false ? "no-store" : options.cacheControl ?? "public, max-age=0, s-maxage=3600",
 		"Content-Type": "text/markdown; charset=utf-8",
 		...sectionHeaders,
@@ -8355,6 +8527,12 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		format: DOCS_AGENT_MANIFEST_FORMAT,
 		version: DOCS_AGENT_MANIFEST_VERSION,
 		name: "@farming-labs/docs",
+		profile: "full",
+		profiles: {
+			default: "full",
+			full: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			compact: `${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}?profile=compact`
+		},
 		baseUrl: origin,
 		site: {
 			title: llms?.siteTitle ?? "Documentation",
@@ -8672,6 +8850,21 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		}
 	};
 }
+/** Remove first-hop file inventories while retaining every discovery route and capability. */
+function compactDocsAgentDiscoverySpec(spec) {
+	return {
+		...spec,
+		profile: "compact",
+		skills: {
+			...spec.skills,
+			published: spec.skills.published.map((skill) => ({
+				...skill,
+				fileCount: skill.files.length,
+				files: []
+			}))
+		}
+	};
+}
 function acceptsDocsMarkdown(request) {
 	const accept = request.headers.get("accept");
 	if (!accept) return false;
@@ -8764,4 +8957,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { matchesDocsLlmsTxtSection as $, resolveDocsMcpProtectedResourceMetadataLocation as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentLocale as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PUBLIC_ROUTE as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintMatches as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, agentVersionConstraintGroupsOverlap as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, paginateDocsItems as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpResourcePaths as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_WELL_KNOWN_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, resolveDocsPaginationOffset as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpProtectedResourceMetadataPath as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, hasDocsMcpProtectedResourceConfig as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, normalizeDocsRelated as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentVersion as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, DocsPaginationCursorError as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintsOverlap as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, createDocsPaginationCursor as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpEndpointPath as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, renderDocsRelatedMarkdownLines as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceMdxContent as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, buildDocsMcpProtectedResourceMetadataRoute as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, getDocsMcpProtectedResourceMetadataRoutes as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpResourcePath as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpRequest as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, normalizeDocsMcpAuthorizationServerUrls as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, resolveDocsMcpResourceLocation as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentScopeValues as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, normalizeAgentFramework as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, isDocsMcpOAuthScopeToken as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as zn, toDocsSitemapMarkdownUrl as zt };
+export { isDocsSkillRequest as $, normalizeDocsMcpEndpointPath as $n, buildDocsContentSnapshot as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as At, detectDocsMarkdownAgentRequest as B, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Bn, toDocsSitemapMarkdownUrl as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxIssues as Cn, selectDocsLlmsTxtContent as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MANIFEST_PATH as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, validateDocsAgentFeedbackPayload as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapMarkdown as Ft, hasDocsMarkdownSignatureAgent as G, getDocsMcpProtectedResourceMetadataRoutes as Gn, createDocsContentChangeFeed as Gt, getDocsLlmsTxtMaxCharsIssue as H, DEFAULT_MCP_ROUTE as Hn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, renderDocsSitemapXml as It, isDocsConfigRequest as J, isDocsMcpOAuthScopeToken as Jn, isDocsContentChangesRequest as Jt, isDocsAgentDiscoveryRequest as K, getDocsMcpResourcePaths as Kn, createDocsContentChangesHttpResponse as Kt, compactDocsAgentDiscoverySpec as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapConfig as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, buildDocsSitemapManifest as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, createDocsSitemapResponse as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, readDocsSitemapManifestFromContentMap as Pt, isDocsPublicGetRequest as Q, normalizeDocsMcpAuthorizationServerUrls as Qn, buildDocsAskAIContext as Qt, createDocsMarkdownResponse as R, normalizeDocsRelated as Rn, resolveDocsSitemapPageLastmod as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, extractDocsMarkdownPromptBlocks as Sn, resolveDocsSkillFormat as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAgentMdxContent as Tn, toDocsMarkdownUrl as Tt, getDocsMarkdownCanonicalLinkHeader as U, DEFAULT_MCP_WELL_KNOWN_ROUTE as Un, DOCS_CONTENT_SNAPSHOT_FORMAT as Ut, findDocsMarkdownPage as V, DEFAULT_MCP_PUBLIC_ROUTE as Vn, DOCS_CONTENT_CHANGES_FORMAT as Vt, getDocsMarkdownVaryHeader as W, buildDocsMcpProtectedResourceMetadataRoute as Wn, DocsContentChangesRequestError as Wt, isDocsLlmsTxtPublicRequest as X, isDocsMcpRequest as Xn, resolveDocsContentChangesRequest as Xt, isDocsDiagnosticsRequest as Y, isDocsMcpProtectedResourceMetadataPath as Yn, resolveDocsContentChangesConfig as Yt, isDocsMarkdownSectionIndexRequest as Z, isDocsMcpResourcePath as Zn, DocsSearchRequestError as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchError as _n, resolveDocsMarkdownRecovery as _t, DEFAULT_AGENT_MD_ROUTE as a, createMcpSearchAdapter as an, buildDocsOkfBundle as ar, renderDocsLlmsTxt as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveLocalDocsMcpSearchConfig as bn, resolveDocsOpenApiDiscoveryConfig as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, enrichDocsSearchDocumentsWithProvenance as cn, resolveDocsOkfTrustMetadata as cr, renderDocsSkillDocument as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, normalizeDocsSearchFilters as dn, resolveDocsAgentFeedbackRequest as dt, buildDocsRetrievalDigestProjection as en, resolveDocsMcpProtectedResourceMetadataLocation as er, matchesDocsLlmsTxtSection as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearch as fn, resolveDocsAgentsFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchAudience as gn, resolveDocsMarkdownCanonicalUrl as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsRetrievalLastModified as hn, resolveDocsLlmsTxtSections as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createCustomSearchAdapter as in, DOCS_OKF_VERSION as ir, renderDocsAgentsDocument as it, buildDocsAgentFeedbackSchema as j, normalizeAgentLocale as jn, DEFAULT_SITEMAP_XML_ROUTE as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap as kn, DEFAULT_SITEMAP_MD_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, formatDocsAskAIPackageHints as ln, resolveDocsAgentContractMcpTools as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveAskAISearchRequestConfig as mn, resolveDocsLlmsTxtRequest as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, buildDocsSearchFacets as nn, DEFAULT_DOCS_OKF_ROUTE as nr, normalizeDocsUrlPath as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createSimpleSearchAdapter as on, normalizeDocsOkfTrustMetadataInput as or, renderDocsMarkdownDocument as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, performDocsSearchWithMetadata as pn, resolveDocsLlmsTxtFormat as pt, isDocsAgentsRequest as q, hasDocsMcpProtectedResourceConfig as qn, isDocsContentChangeGeneration as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createAlgoliaSearchAdapter as rn, DOCS_OKF_BUNDLE_FORMAT as rr, parseDocsAgentFeedbackData as rt, DEFAULT_AGENT_SPEC_ROUTE as s, createTypesenseSearchAdapter as sn, resolveDocsOkfConfig as sr, renderDocsMarkdownNotFound as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchDocuments as tn, resolveDocsMcpResourceLocation as tr, normalizeDocsPathSegment as tt, DEFAULT_DOCS_API_ROUTE as u, inferDocsAskAIPackageHints as un, resolveDocsAgentFeedbackConfig as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchFilters as vn, resolveDocsMarkdownRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, findDocsAudienceMdxTags as wn, selectDocsMarkdownSection as wt, DEFAULT_SKILL_MD_ROUTE as x, resolveSearchRequestConfig as xn, resolveDocsRequestApiRoute as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveDocsSearchRequest as yn, resolveDocsMarkdownSectionRequest as yt, createDocsStandardsDiscoveryResponse as z, renderDocsRelatedMarkdownLines as zn, resolveDocsSitemapRequest as zt };

package/dist/{agent-evals-GpcaCbRb.mjs → agent-evals-D-sPJfXz.mjs}

@@ -1,9 +1,9 @@
-import { $t as buildDocsRetrievalDigestProjection, An as normalizeAgentLocale, Dn as agentVersionConstraintMatches, En as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentScopeValues, kn as normalizeAgentFramework, un as normalizeDocsSearchFilters } from "./agent-CFqECAG0.mjs";
-import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
-import { K as digestDocsRetrievalContent } from "./standards-discovery-Ckx0tN7B.mjs";
-import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-DFqQyO_V.mjs";
+import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-BKy4labo.mjs";
+import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Qt as buildDocsAskAIContext, dn as normalizeDocsSearchFilters, en as buildDocsRetrievalDigestProjection, fn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, xn as resolveSearchRequestConfig } from "./agent-DCTGj6J7.mjs";
+import { n as digestDocsRetrievalContent } from "./retrieval-digest-B-SgtXKK.mjs";
+import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-Ddbf15pY.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-Bel6vDqI.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-D90CCJFs.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";

package/dist/{agent-export-oiWxB5aX.mjs → agent-export-GcTZPLfB.mjs}

@@ -1,17 +1,18 @@
-import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CFqECAG0.mjs";
-import "./markdown-sections-7OoA7ylx.mjs";
-import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-Ckx0tN7B.mjs";
-import "./content-change-hydration-BsbBXAUi.mjs";
-import { t as resolveDocsI18n } from "./i18n-B3BIxShC.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-NQesPX5L.mjs";
-import "./sitemap-server-B0SiREN0.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-DFqQyO_V.mjs";
-import "./agent-evals-GpcaCbRb.mjs";
+import { w as isDocsAgentPageAccessible } from "./markdown-sections-BKy4labo.mjs";
+import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, Mt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as toDocsMarkdownUrl, a as DEFAULT_AGENT_MD_ROUTE, ar as buildDocsOkfBundle, at as renderDocsLlmsTxt, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as renderDocsSkillDocument, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsAgentsDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsMarkdownDocument, sr as resolveDocsOkfConfig, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DCTGj6J7.mjs";
+import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-Bpz90VYq.mjs";
+import "./openapi-mcp-DQ3xptKo.mjs";
+import { t as resolveDocsI18n } from "./i18n-B1gJ9EW0.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-BOjWB1ky.mjs";
+import "./sitemap-server-NeVu8W38.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
+import "./agent-evals-D-sPJfXz.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-Bel6vDqI.mjs";
+import "./authoring-mcp-Be7quE5R.mjs";
+import "./code-blocks-D90CCJFs.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-BaTmjDqD.mjs";
-import { t as detectFramework } from "./utils-DOMeZW9V.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-DrZ3fXgf.mjs";
+import { t as detectFramework } from "./utils-Cc1SrVza.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -443,7 +444,8 @@ function resolveUserOwnedOverrides(outputs, previous) {
 		"page",
 		"llms",
 		"discovery",
-		"skill"
+		"skill",
+		"okf"
 	]);
 	const previousByPath = new Map(previous?.files.map((file) => [file.path, file]) ?? []);
 	return outputs.map((output) => {
@@ -683,7 +685,9 @@ async function exportAgentBundle(options = {}) {
 		};
 	});
 	if (localizedPages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
-	const pages = localizedPages.map(({ page }) => page);
+	const publishablePages = localizedPages.filter(({ page }) => isDocsAgentPageAccessible(page));
+	const pages = publishablePages.map(({ page }) => page);
+	const okfConfig = resolveDocsOkfConfig(config?.agent?.okf);
 	const sitemap = resolveDocsSitemapConfig(sitemapInput, { baseUrl });
 	const robots = resolveDocsRobotsConfig(robotsInput, { baseUrl: typeof robotsInput === "object" ? robotsInput.baseUrl ?? sitemap.baseUrl : sitemap.baseUrl });
 	const mcp = resolveDocsMcpConfig(false, { defaultName: resolvedSiteTitle });
@@ -725,17 +729,25 @@ async function exportAgentBundle(options = {}) {
 	const configuredAgentSkills = await resolveConfiguredAgentSkills(config?.agent?.skills, { rootDir });
 	let outputs = [];
 	const internalOutputs = [];
-	for (const { page } of localizedPages) {
+	for (const { page } of publishablePages) {
 		const output = addOutput(outputs, publicDir, staticMarkdownRoute(page, sourceEntry, routeEntry), "page", "text/markdown", renderDocsMarkdownDocument({
 			...page,
 			markdownUrl: staticMarkdownRoute(page, sourceEntry, routeEntry)
 		}, {
 			llms,
+			okf: config?.agent?.okf,
 			origin: baseUrl,
 			sitemap: sitemapInput
 		}));
 		output.lastModified = resolveDocsHttpDate(page.lastModified);
 	}
+	if (okfConfig.enabled) {
+		const okfBundle = buildDocsOkfBundle(pages.map((page) => ({
+			...page,
+			canonicalUrl: baseUrl ? new URL(page.url, baseUrl).toString() : page.url
+		})), okfConfig);
+		addOutput(outputs, publicDir, okfConfig.route, "okf", "application/json", JSON.stringify(okfBundle, null, 2));
+	}
 	if (llmsEnabled) {
 		const llmsContent = renderDocsLlmsTxt(pages.map((page) => ({
 			url: page.url,
@@ -747,7 +759,8 @@ async function exportAgentBundle(options = {}) {
 			agentContent: page.agentContent,
 			agentRawContent: page.agentRawContent,
 			agentFallbackContent: page.agentFallbackContent,
-			agentFallbackRawContent: page.agentFallbackRawContent
+			agentFallbackRawContent: page.agentFallbackRawContent,
+			agent: page.agent
 		})), llms);
 		for (const route of [DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsTxt);
 		for (const route of [DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsFullTxt);
@@ -877,7 +890,7 @@ async function exportAgentBundle(options = {}) {
 		internalOutputs,
 		orphanedFiles,
 		orphanedInternalFiles,
-		pages: localizedPages
+		pages: publishablePages
 	});
 	const manifestJson = `${JSON.stringify(manifest, null, 2)}\n`;
 	const changed = changedOutputs(outputs);