@farming-labs/docs 0.2.114 → 0.2.116

package/dist/{agent-5jyEosML.mjs → agent-CEZCaYto.mjs}

@@ -7299,6 +7299,10 @@ function resolveDocsResourceUrl(baseUrl, url) {
 	if (/^[a-z][a-z0-9+.-]*:/i.test(url)) return url;
 	return `${baseUrl}${url.startsWith("/") ? url : `/${url}`}`;
 }
+function formatOpenApiOperationCount(count) {
+	if (count === void 0) return void 0;
+	return `${count.toLocaleString("en-US")} ${count === 1 ? "operation" : "operations"}`;
+}
 function renderLlmsFullTxtPages(pages, baseUrl) {
 	let content = "";
 	for (const page of pages) {
@@ -7319,7 +7323,8 @@ function renderDocsLlmsTxt(pages, options = {}) {
 	const apiCatalogEnabled = options.apiCatalog ?? true;
 	const sections = resolveDocsLlmsTxtSections(options);
 	const openapi = resolveDocsOpenApiDiscoveryConfig(options.openapi);
-	const openapiUrl = resolveDocsOpenApiDiscoveryUrl(openapi, resolveDocsDiscoveryApiRoute(options.apiRoute));
+	const resolvedApiRoute = resolveDocsDiscoveryApiRoute(options.apiRoute);
+	const openapiUrl = resolveDocsOpenApiDiscoveryUrl(openapi, resolvedApiRoute);
 	const matchedPageUrls = /* @__PURE__ */ new Set();
 	const generatedSections = sections.map((section) => {
 		const sectionPages = pages.filter((page) => matchesDocsLlmsTxtSection(page.url, section));
@@ -7358,8 +7363,15 @@ function renderDocsLlmsTxt(pages, options = {}) {
 	if (openapi.enabled && openapiUrl) {
 		llmsTxt += "## API Schemas\n\n";
 		llmsTxt += `- [OpenAPI schema](${resolveDocsResourceUrl(baseUrl, openapiUrl)}): Machine-readable API schema for tool use and API clients`;
+		const operationCount = formatOpenApiOperationCount(openapi.operationCount);
+		if (operationCount) llmsTxt += `; ${operationCount}`;
 		if (openapi.apiReferencePath) llmsTxt += `; rendered API reference at ${resolveDocsResourceUrl(baseUrl, openapi.apiReferencePath)}`;
-		llmsTxt += "\n\n";
+		llmsTxt += "\n";
+		for (const version of openapi.versions ?? []) {
+			const versionOperationCount = formatOpenApiOperationCount(version.operationCount);
+			llmsTxt += `- [OpenAPI schema – ${version.label}](${resolveDocsResourceUrl(baseUrl, resolveDocsOpenApiVersionUrl(openapi, version, resolvedApiRoute))}): Version \`${version.id}\`${version.default ? " (default)" : ""}${versionOperationCount ? `; ${versionOperationCount}` : ""}; rendered API reference at ${resolveDocsResourceUrl(baseUrl, version.apiReferencePath)}\n`;
+		}
+		llmsTxt += "\n";
 	}
 	if (rootPages.length > 0 || generatedSections.length === 0) {
 		llmsTxt += "## Pages\n\n";
@@ -7475,13 +7487,21 @@ async function createDocsStandardsDiscoveryResponse({ request, preferredSkillDoc
 			mcpRoute: mcp.enabled ? mcp.route : null,
 			protectedResourceMetadataRoutes,
 			feedbackRoutes: feedback?.enabled ? [feedbackRoute, feedbackSchemaRoute] : [],
-			openapiDefinitions: openapiConfig.enabled && openapiConfig.catalogTargets?.length ? [{
-				route: openapiUrl ?? `${resolvedApiRoute}?format=openapi`,
+			openapiDefinitions: openapiConfig.enabled && openapiConfig.catalogTargets?.length ? (openapiConfig.versions?.length ? openapiConfig.versions : [{
+				id: "default",
+				label: "Product API",
+				default: true,
+				url: openapiUrl ?? `${resolvedApiRoute}?format=openapi`,
+				apiReferencePath: openapiConfig.apiReferencePath ?? "/api-reference",
+				operationCount: openapiConfig.operationCount
+			}]).map((version) => ({
+				route: resolveDocsOpenApiVersionUrl(openapiConfig, version, resolvedApiRoute),
+				title: `${openapiConfig.versions?.length ? `OpenAPI schema – ${version.label}` : "OpenAPI schema"}${formatOpenApiOperationCount(version.operationCount) ? ` — ${formatOpenApiOperationCount(version.operationCount)}` : ""}`,
 				targets: openapiConfig.catalogTargets.map((route) => ({
 					route,
 					title: "Product API"
 				}))
-			}] : [],
+			})) : [],
 			apiReferenceRoute: openapiConfig.enabled && openapiConfig.apiReferencePath ? openapiConfig.apiReferencePath : null
 		}) : void 0
 	});
@@ -8413,6 +8433,7 @@ function appendDocsOpenApiRouteLines(lines, context) {
 	if (!context.openapiConfig.enabled || !context.openapiConfig.url) return;
 	lines.push(`- OpenAPI schema: ${context.openapiConfig.url}`);
 	if (context.openapiConfig.apiReferencePath) lines.push(`- API reference: ${context.openapiConfig.apiReferencePath}`);
+	for (const version of context.openapiConfig.versions ?? []) lines.push(`- OpenAPI ${version.label}${version.default ? " (default)" : ""}: ${version.url}`, `- API reference ${version.label}: ${version.apiReferencePath}`);
 }
 function appendDocsSitemapRouteLines(lines, context) {
 	if (!context.sitemapConfig.enabled) return;
@@ -8706,6 +8727,11 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 			source: openapiConfig.source ?? null,
 			specUrl: openapiConfig.specUrl ?? null,
 			apiReferencePath: openapiConfig.apiReferencePath ?? null,
+			...openapiConfig.operationCount !== void 0 ? { operationCount: openapiConfig.operationCount } : {},
+			versions: openapiConfig.versions?.map((version) => ({
+				...version,
+				url: resolveDocsOpenApiVersionUrl(openapiConfig, version, resolvedApiRoute)
+			})) ?? [],
 			format: "OpenAPI 3.1"
 		},
 		search: {
@@ -8945,12 +8971,31 @@ function resolveDocsOpenApiDiscoveryConfig(openapi) {
 		source,
 		specUrl: openapi.specUrl,
 		apiReferencePath: openapi.apiReferencePath,
-		catalogTargets
+		catalogTargets,
+		operationCount: openapi.operationCount,
+		versions: openapi.versions?.map((version) => ({ ...version }))
+	};
+}
+/** Attach operation totals from the same normalized pages used by search and Markdown. */
+function withDocsOpenApiOperationCounts(openapi, operationPages) {
+	const resolved = resolveDocsOpenApiDiscoveryConfig(openapi);
+	if (!resolved.enabled) return resolved;
+	return {
+		...resolved,
+		operationCount: operationPages.length,
+		versions: resolved.versions?.map((version) => ({
+			...version,
+			operationCount: operationPages.filter((page) => page.version === version.id).length
+		}))
 	};
 }
 function resolveDocsOpenApiDiscoveryUrl(openapi, apiRoute) {
 	return openapi.urlSource === "default" && openapi.url === DEFAULT_OPENAPI_SCHEMA_ROUTE ? `${apiRoute}?format=openapi` : openapi.url;
 }
+function resolveDocsOpenApiVersionUrl(openapi, version, apiRoute) {
+	if (openapi.urlSource === "default" && openapi.url === DEFAULT_OPENAPI_SCHEMA_ROUTE && version.url.startsWith(`${DEFAULT_OPENAPI_SCHEMA_ROUTE}&`)) return `${apiRoute}?format=openapi&${version.url.slice(DEFAULT_OPENAPI_SCHEMA_ROUTE.length + 1)}`;
+	return version.url;
+}
 function compactSkillText(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
@@ -8964,4 +9009,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-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 };
+export { isDocsSkillRequest as $, normalizeDocsMcpAuthorizationServerUrls as $n, buildDocsAskAIContext as $t, buildDocsAgentDiscoverySpec as A, agentVersionConstraintsOverlap as An, DEFAULT_SITEMAP_MD_ROUTE as At, detectDocsMarkdownAgentRequest as B, renderDocsRelatedMarkdownLines as Bn, resolveDocsSitemapRequest as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, extractDocsMarkdownPromptBlocks as Cn, selectDocsLlmsTxtContent as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, resolveDocsAudienceMdxContent as Dn, withDocsOpenApiOperationCounts as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAgentMdxContent as En, validateDocsAgentFeedbackPayload as Et, buildDocsMcpEndpointCandidates as F, DocsPaginationCursorError as Fn, readDocsSitemapManifestFromContentMap as Ft, hasDocsMarkdownSignatureAgent as G, buildDocsMcpProtectedResourceMetadataRoute as Gn, DocsContentChangesRequestError as Gt, getDocsLlmsTxtMaxCharsIssue as H, DEFAULT_MCP_PUBLIC_ROUTE as Hn, DOCS_CONTENT_CHANGES_FORMAT as Ht, collectDocsMarkdownSections as I, createDocsPaginationCursor as In, renderDocsSitemapMarkdown as It, isDocsConfigRequest as J, hasDocsMcpProtectedResourceConfig as Jn, isDocsContentChangeGeneration as Jt, isDocsAgentDiscoveryRequest as K, getDocsMcpProtectedResourceMetadataRoutes as Kn, createDocsContentChangeFeed as Kt, compactDocsAgentDiscoverySpec as L, paginateDocsItems as Ln, renderDocsSitemapXml as Lt, buildDocsConfigMap as M, normalizeAgentLocale as Mn, DEFAULT_SITEMAP_XML_ROUTE as Mt, buildDocsDiagnostics as N, normalizeAgentScopeValues as Nn, buildDocsSitemapManifest as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintGroupsOverlap as On, DEFAULT_SITEMAP_MANIFEST_PATH as Ot, buildDocsMarkdownSectionIndex as P, normalizeAgentVersion as Pn, createDocsSitemapResponse as Pt, isDocsPublicGetRequest as Q, isDocsMcpResourcePath as Qn, DocsSearchRequestError as Qt, createDocsMarkdownResponse as R, resolveDocsPaginationOffset as Rn, resolveDocsSitemapConfig as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, resolveSearchRequestConfig as Sn, resolveDocsSkillFormat as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, findDocsAudienceMdxTags as Tn, toDocsMarkdownUrl as Tt, getDocsMarkdownCanonicalLinkHeader as U, DEFAULT_MCP_ROUTE as Un, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Ut, findDocsMarkdownPage as V, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Vn, toDocsSitemapMarkdownUrl as Vt, getDocsMarkdownVaryHeader as W, DEFAULT_MCP_WELL_KNOWN_ROUTE as Wn, DOCS_CONTENT_SNAPSHOT_FORMAT as Wt, isDocsLlmsTxtPublicRequest as X, isDocsMcpProtectedResourceMetadataPath as Xn, resolveDocsContentChangesConfig as Xt, isDocsDiagnosticsRequest as Y, isDocsMcpOAuthScopeToken as Yn, isDocsContentChangesRequest as Yt, isDocsMarkdownSectionIndexRequest as Z, isDocsMcpRequest as Zn, resolveDocsContentChangesRequest as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchAudience as _n, resolveDocsMarkdownRecovery as _t, DEFAULT_AGENT_MD_ROUTE as a, createCustomSearchAdapter as an, DOCS_OKF_VERSION as ar, renderDocsLlmsTxt as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveDocsSearchRequest as bn, resolveDocsOpenApiDiscoveryConfig as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, createTypesenseSearchAdapter as cn, resolveDocsOkfConfig as cr, renderDocsSkillDocument as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, inferDocsAskAIPackageHints as dn, resolveDocsAgentFeedbackRequest as dt, buildDocsContentSnapshot as en, normalizeDocsMcpEndpointPath as er, matchesDocsLlmsTxtSection as et, DEFAULT_DOCS_CONFIG_ROUTE as f, normalizeDocsSearchFilters as fn, resolveDocsAgentsFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsRetrievalLastModified as gn, resolveDocsMarkdownCanonicalUrl as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveAskAISearchRequestConfig as hn, resolveDocsLlmsTxtSections as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createAlgoliaSearchAdapter as in, DOCS_OKF_BUNDLE_FORMAT as ir, renderDocsAgentsDocument as it, buildDocsAgentFeedbackSchema as j, normalizeAgentFramework as jn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as jt, acceptsDocsMarkdown as k, agentVersionConstraintMatches as kn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, enrichDocsSearchDocumentsWithProvenance as ln, resolveDocsOkfTrustMetadata as lr, resolveDocsAgentContractMcpTools as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, performDocsSearchWithMetadata as mn, resolveDocsLlmsTxtRequest as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, buildDocsSearchDocuments as nn, resolveDocsMcpResourceLocation as nr, normalizeDocsUrlPath as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createMcpSearchAdapter as on, buildDocsOkfBundle as or, renderDocsMarkdownDocument as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, performDocsSearch as pn, resolveDocsLlmsTxtFormat as pt, isDocsAgentsRequest as q, getDocsMcpResourcePaths as qn, createDocsContentChangesHttpResponse as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, buildDocsSearchFacets as rn, DEFAULT_DOCS_OKF_ROUTE as rr, parseDocsAgentFeedbackData as rt, DEFAULT_AGENT_SPEC_ROUTE as s, createSimpleSearchAdapter as sn, normalizeDocsOkfTrustMetadataInput as sr, renderDocsMarkdownNotFound as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsRetrievalDigestProjection as tn, resolveDocsMcpProtectedResourceMetadataLocation as tr, normalizeDocsPathSegment as tt, DEFAULT_DOCS_API_ROUTE as u, formatDocsAskAIPackageHints as un, resolveDocsAgentFeedbackConfig as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchError as vn, resolveDocsMarkdownRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, findDocsAudienceMdxIssues as wn, selectDocsMarkdownSection as wt, DEFAULT_SKILL_MD_ROUTE as x, resolveLocalDocsMcpSearchConfig as xn, resolveDocsRequestApiRoute as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveDocsSearchFilters as yn, resolveDocsMarkdownSectionRequest as yt, createDocsStandardsDiscoveryResponse as z, normalizeDocsRelated as zn, resolveDocsSitemapPageLastmod as zt };

package/dist/{agent-Dlswu0Mm.mjs → agent-DGNTD-N6.mjs}

@@ -1,8 +1,8 @@
 import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-BKy4labo.mjs";
-import { V as findDocsMarkdownPage, ot as renderDocsMarkdownDocument } from "./agent-5jyEosML.mjs";
-import { d as GENERATED_AGENT_PROVENANCE_VERSION, f as hashGeneratedAgentContent, h as serializeGeneratedAgentDocument, m as parseGeneratedAgentDocument } from "./openapi-mcp-D8NVpTW1.mjs";
+import { V as findDocsMarkdownPage, ot as renderDocsMarkdownDocument } from "./agent-CEZCaYto.mjs";
+import { d as GENERATED_AGENT_PROVENANCE_VERSION, f as hashGeneratedAgentContent, h as serializeGeneratedAgentDocument, m as parseGeneratedAgentDocument } from "./openapi-mcp-UF4Cx885.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-DrZ3fXgf.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-BnUOoj07.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";

package/dist/{agent-evals-CnQC3W2a.mjs → agent-evals-CmeTjDMC.mjs}

@@ -1,9 +1,9 @@
 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-5jyEosML.mjs";
+import { $t as buildDocsAskAIContext, An as agentVersionConstraintsOverlap, Mn as normalizeAgentLocale, Nn as normalizeAgentScopeValues, On as agentVersionConstraintGroupsOverlap, Pn as normalizeAgentVersion, Sn as resolveSearchRequestConfig, fn as normalizeDocsSearchFilters, jn as normalizeAgentFramework, kn as agentVersionConstraintMatches, pn as performDocsSearch, tn as buildDocsRetrievalDigestProjection } from "./agent-CEZCaYto.mjs";
 import { n as digestDocsRetrievalContent } from "./retrieval-digest-B-SgtXKK.mjs";
-import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-Ddbf15pY.mjs";
+import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-Ddm90WL6.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-D90CCJFs.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-GYdvS3BH.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-yilcRMg6.mjs → agent-export-DIKwVWYN.mjs}

@@ -1,18 +1,19 @@
 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-5jyEosML.mjs";
+import { A as buildDocsAgentDiscoverySpec, It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as toDocsMarkdownUrl, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsLlmsTxt, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cr as resolveDocsOkfConfig, 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, or as buildDocsOkfBundle, ot as renderDocsMarkdownDocument, 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-CEZCaYto.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-D8NVpTW1.mjs";
+import "./openapi-mcp-UF4Cx885.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-Bne9ODlC.mjs";
-import "./sitemap-server-D3mFJkjE.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
-import "./agent-evals-CnQC3W2a.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-BPYWIGqD.mjs";
+import "./sitemap-server-C4bpuoLi.mjs";
+import "./api-reference-0XdEWya8.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddm90WL6.mjs";
+import "./agent-evals-CmeTjDMC.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./authoring-mcp-BpwboE3k.mjs";
-import "./code-blocks-D90CCJFs.mjs";
+import "./authoring-mcp-C35lj3cI.mjs";
+import "./code-blocks-GYdvS3BH.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-DrZ3fXgf.mjs";
-import { t as detectFramework } from "./utils-Cc1SrVza.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-BnUOoj07.mjs";
+import { t as detectFramework } from "./utils-c9arebCi.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";

package/dist/agent-skills-bundle.d.mts

@@ -1,4 +1,4 @@
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-CjyUCxdy.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-C1RLKwV9.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**
@@ -9,5 +9,11 @@ import { z as DocsPublishedAgentSkill } from "./standards-discovery-CjyUCxdy.mjs
  * resolver when the build plugin is not installed.
  */
 declare const bundledAgentSkills: readonly DocsPublishedAgentSkill[] | undefined;
+/**
+ * Build-time snapshot of the project-root agent documents (`skill.md`,
+ * `AGENTS.md`, `AGENT.md`), keyed by filename. Replaced together with
+ * `bundledAgentSkills`; consumers fall back to the filesystem when undefined.
+ */
+declare const bundledRootDocuments: Readonly<Record<string, string>> | undefined;
 //#endregion
-export { bundledAgentSkills };
+export { bundledAgentSkills, bundledRootDocuments };

package/dist/agent-skills-bundle.mjs

@@ -7,6 +7,12 @@
 * resolver when the build plugin is not installed.
 */
 const bundledAgentSkills = void 0;
+/**
+* Build-time snapshot of the project-root agent documents (`skill.md`,
+* `AGENTS.md`, `AGENT.md`), keyed by filename. Replaced together with
+* `bundledAgentSkills`; consumers fall back to the filesystem when undefined.
+*/
+const bundledRootDocuments = void 0;
 
 //#endregion
-export { bundledAgentSkills };
+export { bundledAgentSkills, bundledRootDocuments };

package/dist/{agent-skills-progressive-disclosure-DL-q4JZo.mjs → agent-skills-progressive-disclosure-BDSjGGFd.mjs}

@@ -1,5 +1,5 @@
 import { validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import { n as resolveConfiguredAgentSkillPathsSync } from "./agent-skills-server-Ddbf15pY.mjs";
+import { n as resolveConfiguredAgentSkillPathsSync } from "./agent-skills-server-Ddm90WL6.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 

package/dist/{agent-skills-server-CF6iVTBR.d.mts → agent-skills-server-BWRJjIQG.d.mts}

@@ -1,5 +1,5 @@
-import { ut as DocsAgentSkillsInput } from "./types-BkAk6B2d.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-CjyUCxdy.mjs";
+import { dt as DocsAgentSkillsInput } from "./types-Dkl2DUfp.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-C1RLKwV9.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

package/dist/{agent-skills-server-Ddbf15pY.mjs → agent-skills-server-Ddm90WL6.mjs}

@@ -1,8 +1,8 @@
 import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, j as buildDocsPublishedAgentSkill } from "./standards-discovery-Bpz90VYq.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { access, lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { access, lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
 import { gzip, gzipSync } from "node:zlib";
 
 //#region src/agent-skills-server.ts

package/dist/agent-skills-vite.d.mts

@@ -1,6 +1,6 @@
-import { ut as DocsAgentSkillsInput } from "./types-BkAk6B2d.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-CjyUCxdy.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CF6iVTBR.mjs";
+import { dt as DocsAgentSkillsInput } from "./types-Dkl2DUfp.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-C1RLKwV9.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-BWRJjIQG.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";
@@ -19,7 +19,7 @@ interface DocsAgentSkillsBuildPlugin {
   load(id: string): Promise<string | undefined>;
 }
 /** Render a self-contained virtual module without relying on Node at runtime. */
-declare function renderDocsAgentSkillsBundle(skills: readonly DocsPublishedAgentSkill[]): string;
+declare function renderDocsAgentSkillsBundle(skills: readonly DocsPublishedAgentSkill[], rootDocuments?: Readonly<Record<string, string>>): string;
 /**
  * Snapshot configured Agent Skills into the server bundle.
  *

package/dist/agent-skills-vite.mjs

@@ -1,5 +1,5 @@
 import "./standards-discovery-Bpz90VYq.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddm90WL6.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";
@@ -22,9 +22,12 @@ function serializeSkill(skill) {
 		}))
 	};
 }
+function serializeSnapshotLiteral(value) {
+	return JSON.stringify(value).replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
+}
 /** Render a self-contained virtual module without relying on Node at runtime. */
-function renderDocsAgentSkillsBundle(skills) {
-	return `const snapshot = ${JSON.stringify(skills.map(serializeSkill)).replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029")};
+function renderDocsAgentSkillsBundle(skills, rootDocuments) {
+	return `const snapshot = ${serializeSnapshotLiteral(skills.map(serializeSkill))};
 function decodeBase64(value) {
   const binary = globalThis.atob(value);
   const bytes = new Uint8Array(binary.length);
@@ -39,6 +42,7 @@ export const bundledAgentSkills = snapshot.map((skill) => ({
   content: hydrateContent(skill.content),
   files: skill.files.map((file) => ({ ...file, content: hydrateContent(file.content) })),
 }));
+export const bundledRootDocuments = ${rootDocuments ? serializeSnapshotLiteral(rootDocuments) : "undefined"};
 `;
 }
 /**

package/dist/{agents-D5waM-jZ.mjs → agents-l8RtkFim.mjs}

@@ -1,16 +1,17 @@
 import "./markdown-sections-BKy4labo.mjs";
-import { a as DEFAULT_AGENT_MD_ROUTE, it as renderDocsAgentsDocument, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig } from "./agent-5jyEosML.mjs";
+import { a as DEFAULT_AGENT_MD_ROUTE, it as renderDocsAgentsDocument, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig } from "./agent-CEZCaYto.mjs";
 import "./standards-discovery-Bpz90VYq.mjs";
-import "./openapi-mcp-D8NVpTW1.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-D3mFJkjE.mjs";
-import "./agent-skills-server-Ddbf15pY.mjs";
-import "./agent-evals-CnQC3W2a.mjs";
+import "./openapi-mcp-UF4Cx885.mjs";
+import "./sitemap-server-C4bpuoLi.mjs";
+import { p as resolveApiReferenceOpenApiDiscovery } from "./api-reference-0XdEWya8.mjs";
+import "./agent-skills-server-Ddm90WL6.mjs";
+import "./agent-evals-CmeTjDMC.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
-import "./authoring-mcp-BpwboE3k.mjs";
-import "./code-blocks-D90CCJFs.mjs";
+import "./authoring-mcp-C35lj3cI.mjs";
+import "./code-blocks-GYdvS3BH.mjs";
 import "./server.mjs";
-import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-DrZ3fXgf.mjs";
-import { t as detectFramework } from "./utils-Cc1SrVza.mjs";
+import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BnUOoj07.mjs";
+import { t as detectFramework } from "./utils-c9arebCi.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{analytics-CwXxM9oL.d.mts → analytics-R9c-Md4b.d.mts}

@@ -1,4 +1,4 @@
-import { _t as DocsAnalyticsEventInput, ft as DocsAgentTraceEventInput, gt as DocsAnalyticsEvent, hn as DocsObservabilityEventInput, ht as DocsAnalyticsConfig, mn as DocsObservabilityEvent, pn as DocsObservabilityConfig } from "./types-BkAk6B2d.mjs";
+import { _t as DocsAnalyticsEvent, gn as DocsObservabilityEventInput, gt as DocsAnalyticsConfig, hn as DocsObservabilityEvent, mn as DocsObservabilityConfig, pt as DocsAgentTraceEventInput, vt as DocsAnalyticsEventInput } from "./types-Dkl2DUfp.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];