@farming-labs/docs 0.2.116 → 0.2.118

package/dist/server.mjs

@@ -1,20 +1,22 @@
-import "./markdown-sections-BKy4labo.mjs";
-import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-CqfcIBdg.mjs";
-import { $t as buildDocsAskAIContext, At as DEFAULT_SITEMAP_MD_ROUTE, Bt as resolveDocsSitemapRequest, Cn as extractDocsMarkdownPromptBlocks, Fn as DocsPaginationCursorError, Ft as readDocsSitemapManifestFromContentMap, Gt as DocsContentChangesRequestError, Ht as DOCS_CONTENT_CHANGES_FORMAT, It as renderDocsSitemapMarkdown, Jt as isDocsContentChangeGeneration, Kt as createDocsContentChangeFeed, Lt as renderDocsSitemapXml, Mt as DEFAULT_SITEMAP_XML_ROUTE, Nt as buildDocsSitemapManifest, Ot as DEFAULT_SITEMAP_MANIFEST_PATH, Pt as createDocsSitemapResponse, Qt as DocsSearchRequestError, Rt as resolveDocsSitemapConfig, Sn as resolveSearchRequestConfig, Ut as DOCS_CONTENT_CHANGES_RESPONSE_VALUE, Vt as toDocsSitemapMarkdownUrl, Wt as DOCS_CONTENT_SNAPSHOT_FORMAT, Xt as resolveDocsContentChangesConfig, Yt as isDocsContentChangesRequest, Zt as resolveDocsContentChangesRequest, _n as resolveDocsSearchAudience, an as createCustomSearchAdapter, bn as resolveDocsSearchRequest, cn as createTypesenseSearchAdapter, dn as inferDocsAskAIPackageHints, en as buildDocsContentSnapshot, fn as normalizeDocsSearchFilters, gn as resolveDocsRetrievalLastModified, hn as resolveAskAISearchRequestConfig, in as createAlgoliaSearchAdapter, jt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, kt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, ln as enrichDocsSearchDocumentsWithProvenance, mn as performDocsSearchWithMetadata, nn as buildDocsSearchDocuments, on as createMcpSearchAdapter, pn as performDocsSearch, qt as createDocsContentChangesHttpResponse, sn as createSimpleSearchAdapter, tn as buildDocsRetrievalDigestProjection, un as formatDocsAskAIPackageHints, vn as resolveDocsSearchError, xn as resolveLocalDocsMcpSearchConfig, yn as resolveDocsSearchFilters, zt as resolveDocsSitemapPageLastmod } from "./agent-CEZCaYto.mjs";
-import { n as digestDocsRetrievalContent, r as isDocsRetrievalCanonicalUrl } from "./retrieval-digest-B-SgtXKK.mjs";
-import "./standards-discovery-Bpz90VYq.mjs";
-import { a as DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, c as MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, l as hydrateDocsContentChanges, o as DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, s as MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET } from "./openapi-mcp-UF4Cx885.mjs";
-import { n as buildNormalizedOpenApiModel, t as OPENAPI_OPERATION_METHODS } from "./openapi-operations-DFpaqOqA.mjs";
-import { a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as remarkCodeGroup, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon } from "./sitemap-server-C4bpuoLi.mjs";
-import { a as buildApiReferenceOpenApiDocumentAsync, c as buildApiReferenceScalarCss, f as resolveApiReferenceConfig, g as resolveApiReferenceVersionFromPathname, h as resolveApiReferenceVersion, i as buildApiReferenceOpenApiDocument, l as createApiReferenceOperationMarkdownResponse, m as resolveApiReferenceRenderer, n as buildApiReferenceHtmlDocument, o as buildApiReferenceOperationPagesAsync, p as resolveApiReferenceOpenApiDiscovery, r as buildApiReferenceHtmlDocumentAsync, s as buildApiReferencePageTitle, t as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, u as isApiReferenceOpenApiRequest } from "./api-reference-0XdEWya8.mjs";
-import { i as resolveConfiguredAgentSkillsSync, r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddm90WL6.mjs";
-import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-CmeTjDMC.mjs";
+import "./http-body-DkAPk6D5.mjs";
+import "./markdown-sections-9Oxr33b-.mjs";
+import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-p8Vhhu2P.mjs";
+import { $t as buildDocsAskAIContext, At as DEFAULT_SITEMAP_MD_ROUTE, Bt as resolveDocsSitemapRequest, Cn as extractDocsMarkdownPromptBlocks, Fn as DocsPaginationCursorError, Ft as readDocsSitemapManifestFromContentMap, Gt as DocsContentChangesRequestError, Ht as DOCS_CONTENT_CHANGES_FORMAT, It as renderDocsSitemapMarkdown, Jt as isDocsContentChangeGeneration, Kt as createDocsContentChangeFeed, Lt as renderDocsSitemapXml, Mt as DEFAULT_SITEMAP_XML_ROUTE, Nt as buildDocsSitemapManifest, Ot as DEFAULT_SITEMAP_MANIFEST_PATH, Pt as createDocsSitemapResponse, Qt as DocsSearchRequestError, Rt as resolveDocsSitemapConfig, Sn as resolveSearchRequestConfig, Ut as DOCS_CONTENT_CHANGES_RESPONSE_VALUE, Vt as toDocsSitemapMarkdownUrl, Wt as DOCS_CONTENT_SNAPSHOT_FORMAT, Xt as resolveDocsContentChangesConfig, Yt as isDocsContentChangesRequest, Zt as resolveDocsContentChangesRequest, _n as resolveDocsSearchAudience, an as createCustomSearchAdapter, bn as resolveDocsSearchRequest, cn as createTypesenseSearchAdapter, dn as inferDocsAskAIPackageHints, en as buildDocsContentSnapshot, fn as normalizeDocsSearchFilters, gn as resolveDocsRetrievalLastModified, hn as resolveAskAISearchRequestConfig, in as createAlgoliaSearchAdapter, jt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, kt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, ln as enrichDocsSearchDocumentsWithProvenance, mn as performDocsSearchWithMetadata, nn as buildDocsSearchDocuments, on as createMcpSearchAdapter, pn as performDocsSearch, qt as createDocsContentChangesHttpResponse, sn as createSimpleSearchAdapter, tn as buildDocsRetrievalDigestProjection, un as formatDocsAskAIPackageHints, vn as resolveDocsSearchError, xn as resolveLocalDocsMcpSearchConfig, yn as resolveDocsSearchFilters, zt as resolveDocsSitemapPageLastmod } from "./agent-BErhm-eR.mjs";
+import { n as digestDocsRetrievalContent, r as isDocsRetrievalCanonicalUrl } from "./retrieval-digest-CT-eIEcp.mjs";
+import "./standards-discovery-BQQ3CAzz.mjs";
+import { a as DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, c as MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, l as hydrateDocsContentChanges, o as DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, s as MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET } from "./openapi-mcp-gbEUXMkc.mjs";
+import { n as buildNormalizedOpenApiModel, t as OPENAPI_OPERATION_METHODS } from "./openapi-operations-CsXLUD3Z.mjs";
+import { a as normalizePromptProviderName, c as sanitizePromptText, d as serializeOpenDocsProvider, f as serializeOpenDocsProviders, i as DEFAULT_PROMPT_PROVIDER_TEMPLATES, l as serializeDocsIcon, n as DEFAULT_OPEN_DOCS_PROVIDER_IDS, o as parsePromptStringArray, p as remarkCodeGroup, r as DEFAULT_OPEN_DOCS_TARGET, s as resolvePromptProviderChoices, t as DEFAULT_OPEN_DOCS_PROMPT, u as serializeDocsIconRegistry } from "./prompt-utils-Dj8-I3Jw.mjs";
+import { a as buildApiReferenceOpenApiDocumentAsync, c as buildApiReferenceScalarCss, f as resolveApiReferenceConfig, g as resolveApiReferenceVersionFromPathname, h as resolveApiReferenceVersion, i as buildApiReferenceOpenApiDocument, l as createApiReferenceOperationMarkdownResponse, m as resolveApiReferenceRenderer, n as buildApiReferenceHtmlDocument, o as buildApiReferenceOperationPagesAsync, p as resolveApiReferenceOpenApiDiscovery, r as buildApiReferenceHtmlDocumentAsync, s as buildApiReferencePageTitle, t as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, u as isApiReferenceOpenApiRequest } from "./api-reference-DafuHRtc.mjs";
+import { i as resolveConfiguredAgentSkillsSync, r as resolveConfiguredAgentSkills } from "./agent-skills-server-CJh3EGWC.mjs";
+import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BHXe_A2m.mjs";
 import { DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, resolveDocsMcpPromptsConfig, runDocsMcpStdio } from "./mcp.mjs";
-import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile, t as DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT } from "./agent-feedback-loop-CcZL_sb1.mjs";
-import { i as writeDocsAuthoringFile, n as readDocsAuthoringFile, r as runDocsAuthoringMcpStdio, t as createDocsAuthoringMcpServer } from "./authoring-mcp-C35lj3cI.mjs";
-import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-BDtBbbZZ.mjs";
+import { n as analyzeDocsAgentFeedback, r as readDocsAgentFeedbackFile, t as DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT } from "./agent-feedback-loop-DpZ9ZdFB.mjs";
+import { i as writeDocsAuthoringFile, n as readDocsAuthoringFile, r as runDocsAuthoringMcpStdio, t as createDocsAuthoringMcpServer } from "./authoring-mcp-BmohXL7E.mjs";
+import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-Bq_njfjh.mjs";
 import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import "./code-blocks-GYdvS3BH.mjs";
+import "./code-blocks-BE3sEayp.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
+import { t as readDocsSitemapManifest } from "./sitemap-server-CClBRp7_.mjs";
 
 export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_FEEDBACK_IMPROVEMENT_FORMAT, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_CONTENT_CHANGES_FORMAT, DOCS_CONTENT_CHANGES_RESPONSE_VALUE, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, DOCS_CONTENT_SNAPSHOT_FORMAT, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, DocsContentChangesRequestError, DocsPaginationCursorError, DocsSearchRequestError, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, OPENAPI_OPERATION_METHODS, analyzeDocsAgentFeedback, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsContentSnapshot, buildDocsRetrievalDigestProjection, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, buildNormalizedOpenApiModel, createAlgoliaSearchAdapter, createApiReferenceOperationMarkdownResponse, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsAuthoringMcpServer, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, hydrateDocsContentChanges, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsContentChangeGeneration, isDocsContentChangesRequest, isDocsRetrievalCanonicalUrl, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsAgentFeedbackFile, readDocsAuthoringFile, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsContentChangesConfig, resolveDocsContentChangesRequest, resolveDocsMcpConfig, resolveDocsMcpPromptsConfig, resolveDocsObservabilityConfig, resolveDocsRetrievalLastModified, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveLocalDocsMcpSearchConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsAuthoringMcpStdio, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl, writeDocsAuthoringFile };

package/dist/{sidebar-CGbvEPTX.d.mts → sidebar-CAncgoWu.d.mts}

@@ -1,4 +1,4 @@
-import { ci as SidebarConfig, li as SidebarFolderIndexBehavior } from "./types-Dkl2DUfp.mjs";
+import { ci as SidebarConfig, li as SidebarFolderIndexBehavior } from "./types-Ba9Dd_fe.mjs";
 
 //#region src/sidebar.d.ts
 interface SidebarFolderIndexBehaviorOptions {

package/dist/sitemap-BEUEeKbt.d.mts

@@ -0,0 +1,110 @@
+import { oi as ResolvedDocsRelatedLink, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
+import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C3AB6qNv.mjs";
+
+//#region src/sitemap.d.ts
+declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+declare const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+declare const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
+declare const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
+declare const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
+type DocsSitemapFormat = "xml" | "markdown";
+interface DocsSitemapPageInput {
+  slug?: string;
+  url: string;
+  /** Override the public Markdown representation URL when it differs from `${url}.md`. */
+  markdownUrl?: string;
+  title: string;
+  description?: string;
+  related?: ResolvedDocsRelatedLink[];
+  sourcePath?: string;
+  lastmod?: string;
+  lastModified?: string;
+}
+interface DocsSitemapManifestPage {
+  url: string;
+  absoluteUrl?: string;
+  markdownUrl: string;
+  title: string;
+  description?: string;
+  sourcePath?: string;
+  lastmod?: string;
+  lastmodSource?: "git" | "filesystem" | "frontmatter" | "manifest" | "unknown";
+  related?: string[];
+}
+interface DocsSitemapManifest {
+  version: 1;
+  generatedAt: string;
+  baseUrl?: string;
+  entry: string;
+  siteTitle?: string;
+  pages: DocsSitemapManifestPage[];
+}
+interface DocsSitemapResolvedConfig {
+  enabled: boolean;
+  routePrefix: string;
+  baseUrl?: string;
+  manifestPath: string;
+  xml: {
+    enabled: boolean;
+    includeLastmod: boolean;
+    route: string;
+  };
+  markdown: {
+    enabled: boolean;
+    includeDescriptions: boolean;
+    includeLastmod: boolean;
+    linkTarget: "html" | "markdown" | "both";
+    route: string;
+    docsRoute?: string;
+    wellKnownRoute: string;
+  };
+}
+interface CreateDocsSitemapResponseOptions extends DocsDiscoveryApiRouteOptions {
+  request: Request;
+  sitemap?: boolean | DocsSitemapConfig;
+  entry?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  pages: DocsSitemapPageInput[];
+  manifest?: DocsSitemapManifest | null;
+}
+declare function resolveDocsSitemapConfig(sitemap?: boolean | DocsSitemapConfig, defaults?: {
+  baseUrl?: string;
+}): DocsSitemapResolvedConfig;
+declare function resolveDocsSitemapRequest(url: URL, sitemap?: boolean | DocsSitemapConfig, options?: DocsDiscoveryApiRouteOptions): DocsSitemapFormat | null;
+declare function toDocsSitemapMarkdownUrl(url: string): string;
+declare function buildDocsSitemapManifest(options: {
+  pages: DocsSitemapPageInput[];
+  entry?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  generatedAt?: string;
+  resolveLastmod?: (page: DocsSitemapPageInput) => {
+    lastmod?: string;
+    lastmodSource?: DocsSitemapManifestPage["lastmodSource"];
+  } | undefined;
+}): DocsSitemapManifest;
+declare function renderDocsSitemapXml(manifest: DocsSitemapManifest, options?: {
+  baseUrl?: string;
+  includeLastmod?: boolean;
+}): string;
+declare function renderDocsSitemapMarkdown(manifest: DocsSitemapManifest, options?: {
+  baseUrl?: string;
+  includeDescriptions?: boolean;
+  includeLastmod?: boolean;
+  linkTarget?: "html" | "markdown" | "both";
+}): string;
+declare function readDocsSitemapManifestFromContentMap(contentMap?: Record<string, string> | null): DocsSitemapManifest | null;
+declare function resolveDocsSitemapPageLastmod(manifest: DocsSitemapManifest | null | undefined, url: string): string | undefined;
+declare function createDocsSitemapResponse({
+  request,
+  apiRoute,
+  sitemap,
+  entry,
+  siteTitle,
+  baseUrl,
+  pages,
+  manifest
+}: CreateDocsSitemapResponseOptions): Response | null;
+//#endregion
+export { resolveDocsSitemapPageLastmod as _, DEFAULT_SITEMAP_XML_ROUTE as a, DocsSitemapManifestPage as c, buildDocsSitemapManifest as d, createDocsSitemapResponse as f, resolveDocsSitemapConfig as g, renderDocsSitemapXml as h, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as i, DocsSitemapPageInput as l, renderDocsSitemapMarkdown as m, DEFAULT_SITEMAP_MD_DOCS_ROUTE as n, DocsSitemapFormat as o, readDocsSitemapManifestFromContentMap as p, DEFAULT_SITEMAP_MD_ROUTE as r, DocsSitemapManifest as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, DocsSitemapResolvedConfig as u, resolveDocsSitemapRequest as v, toDocsSitemapMarkdownUrl as y };

package/dist/{sitemap-Bc4LkIcm.mjs → sitemap-Du2wWBmo.mjs}

@@ -1,17 +1,20 @@
-import "./markdown-sections-BKy4labo.mjs";
-import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-CEZCaYto.mjs";
-import "./standards-discovery-Bpz90VYq.mjs";
-import "./openapi-mcp-UF4Cx885.mjs";
-import "./sitemap-server-C4bpuoLi.mjs";
-import "./api-reference-0XdEWya8.mjs";
-import "./agent-skills-server-Ddm90WL6.mjs";
-import "./agent-evals-CmeTjDMC.mjs";
+import "./http-body-DkAPk6D5.mjs";
+import "./markdown-sections-9Oxr33b-.mjs";
+import { It as renderDocsSitemapMarkdown, Lt as renderDocsSitemapXml, Nt as buildDocsSitemapManifest, Rt as resolveDocsSitemapConfig } from "./agent-BErhm-eR.mjs";
+import "./standards-discovery-BQQ3CAzz.mjs";
+import "./openapi-mcp-gbEUXMkc.mjs";
+import "./prompt-utils-Dj8-I3Jw.mjs";
+import "./api-reference-DafuHRtc.mjs";
+import "./agent-skills-server-CJh3EGWC.mjs";
+import "./agent-evals-BHXe_A2m.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-C35lj3cI.mjs";
-import "./code-blocks-GYdvS3BH.mjs";
+import "./authoring-mcp-BmohXL7E.mjs";
+import "./cloud-ask-ai-Bq_njfjh.mjs";
+import "./code-blocks-BE3sEayp.mjs";
+import "./sitemap-server-CClBRp7_.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, 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 { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-DDuQ4Qma.mjs";
+import { t as detectFramework } from "./utils-8H7dkC8w.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/sitemap-server-CClBRp7_.mjs

@@ -0,0 +1,18 @@
+import { Rt as resolveDocsSitemapConfig } from "./agent-BErhm-eR.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+
+//#region src/sitemap-server.ts
+function readDocsSitemapManifest(rootDir, sitemap) {
+	const resolved = resolveDocsSitemapConfig(sitemap);
+	const manifestPath = path.resolve(rootDir, resolved.manifestPath);
+	if (!existsSync(manifestPath)) return null;
+	try {
+		return JSON.parse(readFileSync(manifestPath, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { readDocsSitemapManifest as t };

package/dist/sitemap-server-DNsVKCnP.d.mts

@@ -0,0 +1,114 @@
+import { Ht as DocsConfig, a as ApiReferenceRenderer, gr as DocsSearchSourcePage, vn as DocsOkfConfig, wn as DocsOpenApiMcpConfig, yr as DocsSitemapConfig } from "./types-Ba9Dd_fe.mjs";
+import { s as DocsSitemapManifest } from "./sitemap-BEUEeKbt.mjs";
+
+//#region src/api-reference.d.ts
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+type ApiReferenceFramework = "next" | "tanstack-start" | "farmjs" | "sveltekit" | "astro" | "nuxt";
+interface ApiReferenceRoute {
+  title: string;
+  summary: string;
+  description?: string;
+  routePath: string;
+  sourceFile: string;
+  methods: HttpMethod[];
+  tag: string;
+  parameters: Array<Record<string, unknown>>;
+}
+interface ResolvedApiReferenceConfig {
+  enabled: boolean;
+  path: string;
+  specUrl?: string;
+  overlays: string[];
+  versions: ResolvedApiReferenceVersion[];
+  defaultVersion?: string;
+  catalogTargets?: string[];
+  renderer?: ApiReferenceRenderer;
+  mcp?: DocsOpenApiMcpConfig;
+  routeRoot: string;
+  exclude: string[];
+}
+interface ResolvedApiReferenceVersion {
+  id: string;
+  label: string;
+  specUrl: string;
+  overlays: string[];
+  default: boolean;
+}
+interface ApiReferenceOpenApiVersionDiscovery {
+  id: string;
+  label: string;
+  default: boolean;
+  url: string;
+  apiReferencePath: string;
+  specUrl?: string;
+  operationCount?: number;
+}
+interface ApiReferenceOpenApiDiscovery {
+  enabled: boolean;
+  url?: string;
+  urlSource?: "default" | "configured";
+  source?: "generated" | "configured";
+  specUrl?: string;
+  apiReferencePath?: string;
+  catalogTargets?: string[];
+  operationCount?: number;
+  versions?: ApiReferenceOpenApiVersionDiscovery[];
+}
+interface BuildApiReferenceOptions {
+  framework: ApiReferenceFramework;
+  rootDir?: string;
+  baseUrl?: string;
+  version?: string;
+}
+interface BuildApiReferenceOperationPagesOptions extends Omit<BuildApiReferenceOptions, "version"> {
+  /** Locale attached to generated search records in localized documentation sites. */
+  locale?: string;
+}
+interface CreateApiReferenceOperationMarkdownResponseOptions extends BuildApiReferenceOperationPagesOptions {
+  request: Request;
+  /** Shared Docs API pathname used by query-form Markdown requests. @default "/api/docs" */
+  apiRoute?: string;
+  /** Public metadata origin. Defaults to `baseUrl`, then the request origin. */
+  origin?: string;
+  /** Authored pages included in Markdown recovery suggestions. */
+  pages?: DocsSearchSourcePage[];
+  /** Reuse a cached operation projection when the adapter already maintains one. */
+  operationPages?: DocsSearchSourcePage[] | (() => DocsSearchSourcePage[] | Promise<DocsSearchSourcePage[]>);
+  sitemap?: boolean | DocsSitemapConfig;
+  okf?: boolean | DocsOkfConfig;
+}
+interface BuildApiReferenceHtmlOptions extends BuildApiReferenceOptions {
+  title?: string;
+}
+declare const DEFAULT_API_REFERENCE_OPENAPI_ROUTE = "/api/docs?format=openapi";
+declare function resolveApiReferenceConfig(value: DocsConfig["apiReference"]): ResolvedApiReferenceConfig;
+declare function resolveApiReferenceRenderer(value: DocsConfig["apiReference"], _framework: ApiReferenceFramework): ApiReferenceRenderer;
+declare function resolveApiReferenceOpenApiDiscovery(value: DocsConfig["apiReference"], options?: {
+  route?: string;
+}): ApiReferenceOpenApiDiscovery;
+declare function resolveApiReferenceVersion(config: ResolvedApiReferenceConfig, requestedVersion?: string): ResolvedApiReferenceVersion | undefined;
+declare function resolveApiReferenceVersionFromPathname(value: DocsConfig["apiReference"], pathname: string): ResolvedApiReferenceVersion | undefined;
+declare function isApiReferenceOpenApiRequest(url: URL): boolean;
+declare function buildApiReferencePageTitle(config: DocsConfig, title?: string): string;
+declare function buildApiReferenceScalarCss(config: DocsConfig): string;
+declare function buildApiReferenceOpenApiDocument(config: DocsConfig, options: BuildApiReferenceOptions): Record<string, unknown>;
+declare function buildApiReferenceOpenApiDocumentAsync(config: DocsConfig, options: BuildApiReferenceOptions): Promise<Record<string, unknown>>;
+/**
+ * Build deterministic, operation-level source pages from every configured OpenAPI version.
+ *
+ * These pages are framework-neutral projections used by documentation search and other
+ * read-only knowledge surfaces. They never inherit MCP execution headers or credentials.
+ */
+declare function buildApiReferenceOperationPagesAsync(config: DocsConfig, options: BuildApiReferenceOperationPagesOptions): Promise<DocsSearchSourcePage[]>;
+/**
+ * Resolve a public per-operation Markdown request using the same generated projection as search,
+ * Ask AI, and MCP. Returns `null` when the request is not an API operation Markdown route.
+ */
+declare function createApiReferenceOperationMarkdownResponse(config: DocsConfig, options: CreateApiReferenceOperationMarkdownResponseOptions): Promise<Response | null>;
+declare function buildApiReferenceHtmlDocument(config: DocsConfig, options: BuildApiReferenceHtmlOptions): string;
+declare function buildApiReferenceHtmlDocumentAsync(config: DocsConfig, options: BuildApiReferenceHtmlOptions): Promise<string>;
+//#endregion
+//#region src/sitemap-server.d.ts
+declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
+//#endregion
+export { resolveApiReferenceRenderer as C, resolveApiReferenceOpenApiDiscovery as S, resolveApiReferenceVersionFromPathname as T, buildApiReferencePageTitle as _, ApiReferenceRoute as a, isApiReferenceOpenApiRequest as b, CreateApiReferenceOperationMarkdownResponseOptions as c, ResolvedApiReferenceVersion as d, buildApiReferenceHtmlDocument as f, buildApiReferenceOperationPagesAsync as g, buildApiReferenceOpenApiDocumentAsync as h, ApiReferenceOpenApiVersionDiscovery as i, DEFAULT_API_REFERENCE_OPENAPI_ROUTE as l, buildApiReferenceOpenApiDocument as m, ApiReferenceFramework as n, BuildApiReferenceOperationPagesOptions as o, buildApiReferenceHtmlDocumentAsync as p, ApiReferenceOpenApiDiscovery as r, BuildApiReferenceOptions as s, readDocsSitemapManifest as t, ResolvedApiReferenceConfig as u, buildApiReferenceScalarCss as v, resolveApiReferenceVersion as w, resolveApiReferenceConfig as x, createApiReferenceOperationMarkdownResponse as y };

package/dist/{skills-B6wl1bUL.mjs → skills-BC0GTdUM.mjs}

@@ -1,18 +1,21 @@
-import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-BKy4labo.mjs";
-import "./agent-CEZCaYto.mjs";
-import "./standards-discovery-Bpz90VYq.mjs";
+import "./http-body-DkAPk6D5.mjs";
+import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-9Oxr33b-.mjs";
+import "./agent-BErhm-eR.mjs";
+import "./standards-discovery-BQQ3CAzz.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import "./openapi-mcp-UF4Cx885.mjs";
-import "./sitemap-server-C4bpuoLi.mjs";
-import "./api-reference-0XdEWya8.mjs";
-import "./agent-skills-server-Ddm90WL6.mjs";
-import "./agent-evals-CmeTjDMC.mjs";
+import "./openapi-mcp-gbEUXMkc.mjs";
+import "./prompt-utils-Dj8-I3Jw.mjs";
+import "./api-reference-DafuHRtc.mjs";
+import "./agent-skills-server-CJh3EGWC.mjs";
+import "./agent-evals-BHXe_A2m.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./authoring-mcp-C35lj3cI.mjs";
-import "./code-blocks-GYdvS3BH.mjs";
+import "./authoring-mcp-BmohXL7E.mjs";
+import "./cloud-ask-ai-Bq_njfjh.mjs";
+import "./code-blocks-BE3sEayp.mjs";
+import "./sitemap-server-CClBRp7_.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-BnUOoj07.mjs";
-import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-BDSjGGFd.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-DDuQ4Qma.mjs";
+import { n as estimateAgentSkillInstructionTokens, r as resolveDocsAgentSkillsProgressiveDisclosureConfig } from "./agent-skills-progressive-disclosure-1XPV0wCN.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";

package/dist/{standards-discovery-Bpz90VYq.mjs → standards-discovery-BQQ3CAzz.mjs}

@@ -1,4 +1,4 @@
-import { i as sha256DocsContent } from "./retrieval-digest-B-SgtXKK.mjs";
+import { i as sha256DocsContent } from "./retrieval-digest-CT-eIEcp.mjs";
 import { parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 
 //#region src/http-cache.ts

package/dist/{standards-discovery-C1RLKwV9.d.mts → standards-discovery-C3AB6qNv.d.mts}

@@ -1,4 +1,4 @@
-import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-Dkl2DUfp.mjs";
+import { F as DocsAgentA2ASkill, M as DocsAgentA2ASecurityRequirement, N as DocsAgentA2ASecurityScheme, _ as DocsAgentA2ACapabilities, j as DocsAgentA2AProtocolBinding, v as DocsAgentA2AConfig } from "./types-Ba9Dd_fe.mjs";
 
 //#region src/standards-discovery.d.ts
 declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";

package/dist/{upgrade-8zStRidw.mjs → upgrade-CXIQlLWx.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-c9arebCi.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-CTkii52k.mjs";
+import { c as fileExists, o as exec } from "./utils-8H7dkC8w.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-CiVXOONu.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.116",
+  "version": "0.2.118",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -34,6 +34,11 @@
       "import": "./dist/server.mjs",
       "default": "./dist/server.mjs"
     },
+    "./runtime": {
+      "types": "./dist/runtime.d.mts",
+      "import": "./dist/runtime.mjs",
+      "default": "./dist/runtime.mjs"
+    },
     "./markdown-rendering": {
       "types": "./dist/markdown-rendering.d.mts",
       "import": "./dist/markdown-rendering.mjs",
@@ -89,7 +94,7 @@
     "parse-entities": "^4.0.2",
     "picocolors": "^1.1.1",
     "remark-gfm": "^4.0.1",
-    "yaml": "^2.8.2",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   },
   "peerDependencies": {