@farming-labs/docs 0.2.128 → 0.2.130

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

@@ -15,5 +15,11 @@ declare const bundledAgentSkills: readonly DocsPublishedAgentSkill[] | undefined
  * `bundledAgentSkills`; consumers fall back to the filesystem when undefined.
  */
 declare const bundledRootDocuments: Readonly<Record<string, string>> | undefined;
+/**
+ * Build-time snapshot of the app's `package.json` version, reported as the MCP
+ * server version when `mcp.version` is not set. A deployed function usually has
+ * no `package.json` beside it; consumers read the file when this is undefined.
+ */
+declare const bundledAppVersion: string | undefined;
 //#endregion
-export { bundledAgentSkills, bundledRootDocuments };
+export { bundledAgentSkills, bundledAppVersion, bundledRootDocuments };

package/dist/agent-skills-bundle.mjs

@@ -13,6 +13,12 @@ const bundledAgentSkills = void 0;
 * `bundledAgentSkills`; consumers fall back to the filesystem when undefined.
 */
 const bundledRootDocuments = void 0;
+/**
+* Build-time snapshot of the app's `package.json` version, reported as the MCP
+* server version when `mcp.version` is not set. A deployed function usually has
+* no `package.json` beside it; consumers read the file when this is undefined.
+*/
+const bundledAppVersion = void 0;
 
 //#endregion
-export { bundledAgentSkills, bundledRootDocuments };
+export { bundledAgentSkills, bundledAppVersion, bundledRootDocuments };

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

@@ -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[], rootDocuments?: Readonly<Record<string, string>>): string;
+declare function renderDocsAgentSkillsBundle(skills: readonly DocsPublishedAgentSkill[], rootDocuments?: Readonly<Record<string, string>>, appVersion?: string): string;
 /**
  * Snapshot configured Agent Skills into the server bundle.
  *

package/dist/agent-skills-vite.mjs

@@ -25,7 +25,7 @@ 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, rootDocuments) {
+function renderDocsAgentSkillsBundle(skills, rootDocuments, appVersion) {
 	return `const snapshot = ${serializeSnapshotLiteral(skills.map(serializeSkill))};
 function decodeBase64(value) {
   const binary = globalThis.atob(value);
@@ -42,6 +42,7 @@ export const bundledAgentSkills = snapshot.map((skill) => ({
   files: skill.files.map((file) => ({ ...file, content: hydrateContent(file.content) })),
 }));
 export const bundledRootDocuments = ${rootDocuments ? serializeSnapshotLiteral(rootDocuments) : "undefined"};
+export const bundledAppVersion = ${appVersion ? serializeSnapshotLiteral(appVersion) : "undefined"};
 `;
 }
 /**

package/dist/app-version.d.mts

@@ -0,0 +1,10 @@
+//#region src/app-version.d.ts
+/**
+ * The `version` field of the app's `package.json`, which adapters report as the
+ * MCP server version when `mcp.version` is not set. Returns `undefined` when the
+ * file is missing (a deployed function often ships without it), unreadable, or
+ * has no usable version, so callers fall back instead of failing to start.
+ */
+declare function readDocsAppVersion(rootDir: string): string | undefined;
+//#endregion
+export { readDocsAppVersion };

package/dist/app-version.mjs

@@ -0,0 +1,30 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+//#region src/app-version.ts
+/**
+* The `version` field of the app's `package.json`, which adapters report as the
+* MCP server version when `mcp.version` is not set. Returns `undefined` when the
+* file is missing (a deployed function often ships without it), unreadable, or
+* has no usable version, so callers fall back instead of failing to start.
+*/
+function readDocsAppVersion(rootDir) {
+	try {
+		const manifestPath = path.join(
+			/* turbopackIgnore: true */
+			rootDir,
+			"package.json"
+		);
+		const version = JSON.parse(readFileSync(
+			/* turbopackIgnore: true */
+			manifestPath,
+			"utf8"
+		))?.version;
+		return typeof version === "string" && version.trim() ? version.trim() : void 0;
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+export { readDocsAppVersion };

package/dist/audience.mjs

@@ -1,4 +1,5 @@
 import { createDocsMarkdownParser } from "./markdown-parser.mjs";
+import { createDocsTextTransformCache } from "./text-transform-cache.mjs";
 import { resolveDocsAudienceExposure } from "./audience-exposure.mjs";
 
 //#region src/audience.ts
@@ -8,6 +9,10 @@ const DOCS_AUDIENCE_TAG_NAMES = [
 	"Human"
 ];
 const DOCS_AUDIENCE_TAG_CANDIDATE_PATTERN = /<\/?(?:Audience|Agent|Human)(?=[\s/>])/;
+const audienceContentCaches = {
+	human: createDocsTextTransformCache(),
+	agent: createDocsTextTransformCache()
+};
 function parseAudienceOnly(attributes) {
 	if (/\{\s*\.\.\./.test(attributes)) return void 0;
 	const value = attributes.match(/(?:^|\s)only\s*=\s*(?:"(human|agent)"|'(human|agent)'|\{\s*"(human|agent)"\s*\}|\{\s*'(human|agent)'\s*\})/)?.slice(1).find(Boolean);
@@ -1616,6 +1621,10 @@ function findDocsAudienceMdxIssues(content) {
 * These primitives shape content for each surface; they are not an access-control boundary.
 */
 function resolveDocsAudienceMdxContent(content, audience) {
+	if (!DOCS_AUDIENCE_TAG_CANDIDATE_PATTERN.test(content)) return content;
+	const cache = audienceContentCaches[audience];
+	const cached = cache.get(content);
+	if (cached !== void 0) return cached;
 	const scopes = [];
 	let output = "";
 	let cursor = 0;
@@ -1643,7 +1652,9 @@ function resolveDocsAudienceMdxContent(content, audience) {
 		if (tag.expression && visibleBeforeTag) output += isAudienceVisible(scopes, audience) ? "<>" : tag.jsxChild ? "{null}" : "null";
 	}
 	if (isAudienceVisible(scopes, audience)) output += content.slice(cursor);
-	return resolvedTag ? normalizeProjectedWhitespace(output) : content;
+	const result = resolvedTag ? normalizeProjectedWhitespace(output) : content;
+	cache.set(content, result);
+	return result;
 }
 /** Backwards-compatible name retained for existing integrations. */
 function resolveDocsAgentMdxContent(content, audience) {

package/dist/build.d.mts

@@ -4,5 +4,6 @@ import { resolveConfiguredAgentSkillsSync } from "./agent-skills-server.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
 import { DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN } from "./agent-detection.mjs";
 import { ensureDocsReviewWorkflow } from "./review.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { loadDocsConfigModule } from "./cli/config.mjs";
-export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsConfig, ensureDocsReviewWorkflow, loadDocsConfigModule, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };
+export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsConfig, ensureDocsReviewWorkflow, loadDocsConfigModule, readDocsAppVersion, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };

package/dist/build.mjs

@@ -3,6 +3,7 @@ import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT
 import { resolveConfiguredAgentSkillsSync } from "./agent-skills-server.mjs";
 import { ensureDocsReviewWorkflow } from "./review.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { loadDocsConfigModule } from "./cli/config.mjs";
 
-export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, ensureDocsReviewWorkflow, loadDocsConfigModule, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };
+export { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, ensureDocsReviewWorkflow, loadDocsConfigModule, readDocsAppVersion, renderDocsAgentSkillsBundle, resolveConfiguredAgentSkillsSync };

package/dist/cli/mcp.mjs

@@ -3,6 +3,7 @@ import { resolveDocsMetadataBaseUrl } from "../metadata.mjs";
 import { buildApiReferenceOperationPagesAsync } from "../api-reference.mjs";
 import { resolveConfiguredAgentSkills } from "../agent-skills-server.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "../mcp.mjs";
+import { readDocsAppVersion } from "../app-version.mjs";
 import { extractNestedObjectLiteral, extractObjectLiteral, hasTopLevelProperty, loadDocsConfigModuleResult, readBooleanProperty, readNavTitle, readStringProperty, resolveDocsConfigPath, resolveDocsContentDir } from "./config.mjs";
 import { detectFramework } from "./utils.mjs";
 import { existsSync, readFileSync } from "node:fs";
@@ -46,7 +47,11 @@ async function runMcp(options = {}) {
 		siteTitle: navTitle ?? "Documentation",
 		baseUrl: loadedConfig ? resolveDocsMetadataBaseUrl(loadedConfig) : void 0
 	});
-	const resolvedMcp = resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" });
+	const appVersion = readDocsAppVersion(rootDir);
+	const resolvedMcp = resolveDocsMcpConfig(mcp ?? true, {
+		defaultName: navTitle ?? "@farming-labs/docs",
+		defaultVersion: appVersion
+	});
 	const source = {
 		...filesystemSource,
 		async getSkills() {
@@ -70,7 +75,8 @@ async function runMcp(options = {}) {
 		mcp: resolvedMcp,
 		contentChanges: loadedConfig?.agent?.contentChanges,
 		evaluations: loadedConfig?.agent?.evaluations,
-		defaultName: navTitle ?? "@farming-labs/docs"
+		defaultName: navTitle ?? "@farming-labs/docs",
+		defaultVersion: appVersion
 	});
 }
 function normalizeApiBaseUrl(value) {

package/dist/mcp-server-card.d.mts

@@ -0,0 +1,47 @@
+//#region src/mcp-server-card.d.ts
+/**
+ * MCP server cards (SEP-2127): a small JSON document served at
+ * `<streamable-http-url>/server-card` that names the server and its endpoint, so a
+ * client can discover it from the URL alone. The card carries identity only, never
+ * tools or resources, so it reveals nothing the endpoint does not already answer.
+ */
+declare const DOCS_MCP_SERVER_CARD_SUFFIX = "/server-card";
+interface DocsMcpServerCard {
+  $schema: string;
+  name: string;
+  version: string;
+  description: string;
+  title?: string;
+  websiteUrl?: string;
+  remotes: Array<{
+    type: "streamable-http";
+    url: string;
+    supportedProtocolVersions: string[];
+  }>;
+}
+interface CreateDocsMcpServerCardOptions {
+  /** Absolute URL of the Streamable HTTP endpoint the card describes. */
+  endpointUrl: string;
+  /** The MCP server name reported in `serverInfo`. */
+  name: string;
+  /** The MCP server version reported in `serverInfo`. */
+  version: string;
+  /** What the server offers; the card keeps the first 100 characters. */
+  description?: string;
+  /** Documentation site the server reads from. */
+  websiteUrl?: string;
+}
+/**
+ * Build the server card for a docs MCP endpoint. The card's `name` must be
+ * reverse-DNS, so a plain server name such as a site title becomes the
+ * card's `title` and the name is namespaced by the endpoint's host.
+ */
+declare function createDocsMcpServerCard(options: CreateDocsMcpServerCardOptions): DocsMcpServerCard;
+/**
+ * Answer a request for a server card: public, read-only metadata with CORS for
+ * any origin and an ETag. The body names the request's origin, so caches
+ * revalidate instead of reusing it.
+ */
+declare function createDocsMcpServerCardResponse(request: Request, card: DocsMcpServerCard): Response;
+//#endregion
+export { CreateDocsMcpServerCardOptions, DOCS_MCP_SERVER_CARD_SUFFIX, DocsMcpServerCard, createDocsMcpServerCard, createDocsMcpServerCardResponse };

package/dist/mcp-server-card.mjs

@@ -0,0 +1,83 @@
+import { createDocsCacheableResponse } from "./http-cache.mjs";
+import { SUPPORTED_PROTOCOL_VERSIONS } from "@modelcontextprotocol/server";
+
+//#region src/mcp-server-card.ts
+/**
+* MCP server cards (SEP-2127): a small JSON document served at
+* `<streamable-http-url>/server-card` that names the server and its endpoint, so a
+* client can discover it from the URL alone. The card carries identity only, never
+* tools or resources, so it reveals nothing the endpoint does not already answer.
+*/
+const DOCS_MCP_SERVER_CARD_SUFFIX = "/server-card";
+const SERVER_CARD_SCHEMA = "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json";
+const SERVER_CARD_CONTENT_TYPE = "application/mcp-server-card+json; charset=utf-8";
+const CARD_DESCRIPTION_MAX = 100;
+const REVERSE_DNS_NAME = /^[a-zA-Z0-9.-]+\/[a-zA-Z0-9._-]+$/;
+function cardNamespace(host) {
+	if (host.includes(":") || /^\d+(?:\.\d+){3}$/.test(host)) return "local";
+	return host.split(".").reverse().join(".");
+}
+function truncateDescription(text) {
+	return text.length <= CARD_DESCRIPTION_MAX ? text : `${text.slice(0, CARD_DESCRIPTION_MAX - 1).trimEnd()}…`;
+}
+/**
+* Build the server card for a docs MCP endpoint. The card's `name` must be
+* reverse-DNS, so a plain server name such as a site title becomes the
+* card's `title` and the name is namespaced by the endpoint's host.
+*/
+function createDocsMcpServerCard(options) {
+	const endpoint = new URL(options.endpointUrl);
+	const reverseDns = REVERSE_DNS_NAME.test(options.name);
+	const description = truncateDescription(options.description?.trim() || `Search and read the ${options.name} documentation.`);
+	return {
+		$schema: SERVER_CARD_SCHEMA,
+		name: reverseDns ? options.name : `${cardNamespace(endpoint.hostname)}/docs`,
+		version: options.version,
+		description,
+		...reverseDns ? {} : { title: options.name },
+		...options.websiteUrl ? { websiteUrl: options.websiteUrl } : {},
+		remotes: [{
+			type: "streamable-http",
+			url: endpoint.href,
+			supportedProtocolVersions: [...SUPPORTED_PROTOCOL_VERSIONS]
+		}]
+	};
+}
+const SERVER_CARD_CORS_HEADERS = Object.freeze({
+	"Access-Control-Allow-Origin": "*",
+	"Access-Control-Allow-Methods": "GET, HEAD, OPTIONS",
+	"Access-Control-Allow-Headers": "Content-Type, If-None-Match"
+});
+/**
+* Answer a request for a server card: public, read-only metadata with CORS for
+* any origin and an ETag. The body names the request's origin, so caches
+* revalidate instead of reusing it.
+*/
+function createDocsMcpServerCardResponse(request, card) {
+	const method = request.method.toUpperCase();
+	if (method === "OPTIONS") return new Response(null, {
+		status: 204,
+		headers: SERVER_CARD_CORS_HEADERS
+	});
+	if (method !== "GET" && method !== "HEAD") return new Response("Method Not Allowed", {
+		status: 405,
+		headers: {
+			...SERVER_CARD_CORS_HEADERS,
+			Allow: "GET, HEAD, OPTIONS",
+			"Content-Type": "text/plain; charset=utf-8"
+		}
+	});
+	return createDocsCacheableResponse({
+		request,
+		content: JSON.stringify(card),
+		headers: {
+			...SERVER_CARD_CORS_HEADERS,
+			"Content-Type": SERVER_CARD_CONTENT_TYPE,
+			"Cache-Control": "public, max-age=0, must-revalidate",
+			"X-Content-Type-Options": "nosniff"
+		}
+	});
+}
+
+//#endregion
+export { DOCS_MCP_SERVER_CARD_SUFFIX, createDocsMcpServerCard, createDocsMcpServerCardResponse };

package/dist/mcp.mjs

@@ -1679,7 +1679,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 				path: "mcp.version",
 				name: "version",
 				type: "string",
-				default: "0.0.0",
+				default: "package.json version or 0.0.0",
 				description: "Version string reported to MCP clients."
 			},
 			{

package/dist/native-api-reference.mjs

@@ -142,9 +142,9 @@ function renderOperation(operation, options) {
       </div>
       <aside class="fl-api-code-panel" aria-label="Request example and interactive console" data-console-root>
         <div class="fl-api-code-header">
-          <div class="fl-api-code-tabs" role="tablist" aria-label="Request tools">
-            <button id="example-tab-${escapeAttribute(operation.slug)}" type="button" role="tab" aria-selected="true" aria-controls="example-panel-${escapeAttribute(operation.slug)}" tabindex="0" data-console-tab="example">cURL</button>
-            <button id="console-tab-${escapeAttribute(operation.slug)}" type="button" role="tab" aria-selected="false" aria-controls="console-panel-${escapeAttribute(operation.slug)}" tabindex="-1" data-console-tab="console">Try it</button>
+          <div class="fl-api-code-tabs fd-tabs-list" role="tablist" aria-label="Request tools">
+            <button id="example-tab-${escapeAttribute(operation.slug)}" type="button" role="tab" class="fd-tabs-trigger" aria-selected="true" aria-controls="example-panel-${escapeAttribute(operation.slug)}" tabindex="0" data-console-tab="example">cURL</button>
+            <button id="console-tab-${escapeAttribute(operation.slug)}" type="button" role="tab" class="fd-tabs-trigger" aria-selected="false" aria-controls="console-panel-${escapeAttribute(operation.slug)}" tabindex="-1" data-console-tab="console">Try it</button>
           </div>
           <button type="button" class="fl-api-copy" data-copy="${escapeAttribute(curl)}" data-example-copy aria-label="Copy cURL request">Copy</button>
         </div>

package/dist/runtime.d.mts

@@ -1,5 +1,6 @@
 import { resolveConfiguredAgentSkills } from "./agent-skills-server.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { DocsMcpPage, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "./api-reference.mjs";
 import { readDocsSitemapManifest } from "./sitemap-server.mjs";
-export { type DocsMcpPage, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };
+export { type DocsMcpPage, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsAppVersion, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };

package/dist/runtime.mjs

@@ -1,6 +1,7 @@
 import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "./api-reference.mjs";
 import { resolveConfiguredAgentSkills } from "./agent-skills-server.mjs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { readDocsSitemapManifest } from "./sitemap-server.mjs";
 
-export { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };
+export { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsAppVersion, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname, resolveConfiguredAgentSkills, resolveDocsMcpConfig };

package/dist/server.d.mts

@@ -3,6 +3,7 @@ import { ResolveConfiguredAgentSkillsOptions, resolveConfiguredAgentSkills, reso
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
 import { DOCS_AGENT_TRACE_EVENT_TYPES, DocsAgentTraceContext, ResolvedDocsAnalyticsConfig, ResolvedDocsObservabilityConfig, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, getDocsRequestAnalyticsProperties, resolveDocsAnalyticsConfig, resolveDocsObservabilityConfig } from "./analytics.mjs";
 import { DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, ResolvedDocsReviewConfig, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, ensureDocsReviewWorkflow, readDocsReviewConfigFromSource, resolveDocsReviewConfig } from "./review.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { loadDocsConfigModule } from "./cli/config.mjs";
 import { DocsCloudAskAIConfig, DocsCloudAskAIResponseOptions, createDocsCloudAskAIResponse, isDocsCloudAskAIProvider } from "./cloud-ask-ai.mjs";
 import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
@@ -22,4 +23,5 @@ import { ApiReferenceFramework, ApiReferenceOpenApiDiscovery, ApiReferenceOpenAp
 import { readDocsSitemapManifest } from "./sitemap-server.mjs";
 import { NormalizedOpenApiExample, NormalizedOpenApiMediaType, NormalizedOpenApiModel, NormalizedOpenApiOperation, NormalizedOpenApiParameter, NormalizedOpenApiRequestBody, NormalizedOpenApiResponse, OPENAPI_OPERATION_METHODS, OpenApiOperationMethod, buildNormalizedOpenApiModel } from "./openapi-operations.mjs";
 import { DocsAuthoringFileState, DocsAuthoringMcpOptions, createDocsAuthoringMcpServer, readDocsAuthoringFile, runDocsAuthoringMcpStdio, writeDocsAuthoringFile } from "./authoring-mcp.mjs";
-export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceOpenApiVersionDiscovery, type ApiReferenceRenderer, type ApiReferenceRendererConfig, type ApiReferenceRendererInput, type ApiReferenceRoute, type BuildApiReferenceOperationPagesOptions, type BuildApiReferenceOptions, type BuildDocsContentSnapshotOptions, type CreateApiReferenceOperationMarkdownResponseOptions, type CreateDocsMcpServerOptions, 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, type DocsAgentContentChangesConfig, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentFeedbackCluster, type DocsAgentFeedbackImprovementOptions, type DocsAgentFeedbackImprovementReport, type DocsAgentFeedbackIssueDraft, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenAuthenticatedContentExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentGoldenFreshnessExpectation, type DocsAgentGoldenPromptInjectionExpectation, type DocsAgentGoldenQueryVariant, type DocsAgentGoldenQueryVariantKind, type DocsAgentGoldenSafetyExpectation, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAuthoringFileState, type DocsAuthoringMcpOptions, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsContentChangeDocument, type DocsContentChangeFeed, type DocsContentChangeHydrationBudget, type DocsContentChangeHydrationContent, type DocsContentChangeHydrationResponse, type DocsContentChangeHydrationSection, type DocsContentChangeHydrationTombstone, type DocsContentChangeSnapshotContext, type DocsContentChangeSnapshotLoader, type DocsContentChangeSnapshotSaver, type DocsContentChangedDocument, type DocsContentChangesRequest, DocsContentChangesRequestError, type DocsContentChangesResponse, type DocsContentSnapshot, type DocsContentSnapshotDocument, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationCoverage, type DocsGoldenEvaluationCoverageStatus, type DocsGoldenEvaluationDimensionCoverage, type DocsGoldenEvaluationQuality, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenQueryVariantResult, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSafetyCaseKind, type DocsGoldenSafetyCaseResult, type DocsGoldenSafetyMetrics, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsLocalMcpSearchRuntimeConfig, type DocsLocalMcpSearchRuntimeInput, type DocsMarkdownPromptBlock, type DocsMcpAgentContractSummary, type DocsMcpApiReferenceSource, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpPageSectionIndex, type DocsMcpPageSectionList, type DocsMcpPaginatedDocsList, type DocsMcpPagination, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedPromptsConfig, type DocsMcpResolvedProtectedResourceConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsPaginatedSearchResponse, DocsPaginationCursorError, type DocsResolvedContentChangesConfig, type DocsRetrievalSourceProvenance, type DocsRetrievalSourceScope, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchAdapterPage, type DocsSearchAmbiguityDecision, type DocsSearchAmbiguityDecisionStatus, type DocsSearchAmbiguityResolution, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchExplanation, type DocsSearchFilterDecision, type DocsSearchFilterDecisionOutcome, type DocsSearchFilterField, type DocsSearchFilterInput, type DocsSearchFilters, type DocsSearchMatchField, type DocsSearchMatchedTerm, type DocsSearchQuery, type DocsSearchRankingReason, type DocsSearchRankingReasonCode, type DocsSearchRankingStrategy, type DocsSearchRequest, DocsSearchRequestError, type DocsSearchRequestResolutionOptions, type DocsSearchResponse, type DocsSearchResult, type DocsSearchSourcePage, type DocsSearchWarning, type DocsSearchWarningCode, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type EnrichDocsSearchDocumentsWithProvenanceOptions, type ExtractedDocsMarkdownPromptBlocks, type HydrateDocsContentChangesOptions, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, type McpDocsSearchConfig, type NormalizedOpenApiExample, type NormalizedOpenApiMediaType, type NormalizedOpenApiModel, type NormalizedOpenApiOperation, type NormalizedOpenApiParameter, type NormalizedOpenApiRequestBody, type NormalizedOpenApiResponse, OPENAPI_OPERATION_METHODS, type OpenApiOperationMethod, type PerformDocsSearchOptions, type PromptAction, type PromptProviderChoice, type ResolveConfiguredAgentSkillsOptions, type ResolveDocsContentChangesOptions, type ResolvedApiReferenceConfig, type ResolvedApiReferenceVersion, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, 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, loadDocsConfigModule, 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 };
+import { CreateDocsMcpServerCardOptions, DOCS_MCP_SERVER_CARD_SUFFIX, DocsMcpServerCard, createDocsMcpServerCard, createDocsMcpServerCardResponse } from "./mcp-server-card.mjs";
+export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceOpenApiVersionDiscovery, type ApiReferenceRenderer, type ApiReferenceRendererConfig, type ApiReferenceRendererInput, type ApiReferenceRoute, type BuildApiReferenceOperationPagesOptions, type BuildApiReferenceOptions, type BuildDocsContentSnapshotOptions, type CreateApiReferenceOperationMarkdownResponseOptions, type CreateDocsMcpServerCardOptions, type CreateDocsMcpServerOptions, 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, DOCS_MCP_SERVER_CARD_SUFFIX, type DocsAgentContentChangesConfig, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentFeedbackCluster, type DocsAgentFeedbackImprovementOptions, type DocsAgentFeedbackImprovementReport, type DocsAgentFeedbackIssueDraft, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenAuthenticatedContentExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentGoldenFreshnessExpectation, type DocsAgentGoldenPromptInjectionExpectation, type DocsAgentGoldenQueryVariant, type DocsAgentGoldenQueryVariantKind, type DocsAgentGoldenSafetyExpectation, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAuthoringFileState, type DocsAuthoringMcpOptions, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsContentChangeDocument, type DocsContentChangeFeed, type DocsContentChangeHydrationBudget, type DocsContentChangeHydrationContent, type DocsContentChangeHydrationResponse, type DocsContentChangeHydrationSection, type DocsContentChangeHydrationTombstone, type DocsContentChangeSnapshotContext, type DocsContentChangeSnapshotLoader, type DocsContentChangeSnapshotSaver, type DocsContentChangedDocument, type DocsContentChangesRequest, DocsContentChangesRequestError, type DocsContentChangesResponse, type DocsContentSnapshot, type DocsContentSnapshotDocument, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationCoverage, type DocsGoldenEvaluationCoverageStatus, type DocsGoldenEvaluationDimensionCoverage, type DocsGoldenEvaluationQuality, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenQueryVariantResult, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSafetyCaseKind, type DocsGoldenSafetyCaseResult, type DocsGoldenSafetyMetrics, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsLocalMcpSearchRuntimeConfig, type DocsLocalMcpSearchRuntimeInput, type DocsMarkdownPromptBlock, type DocsMcpAgentContractSummary, type DocsMcpApiReferenceSource, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpPageSectionIndex, type DocsMcpPageSectionList, type DocsMcpPaginatedDocsList, type DocsMcpPagination, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedPromptsConfig, type DocsMcpResolvedProtectedResourceConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpServerCard, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsPaginatedSearchResponse, DocsPaginationCursorError, type DocsResolvedContentChangesConfig, type DocsRetrievalSourceProvenance, type DocsRetrievalSourceScope, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchAdapterPage, type DocsSearchAmbiguityDecision, type DocsSearchAmbiguityDecisionStatus, type DocsSearchAmbiguityResolution, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchExplanation, type DocsSearchFilterDecision, type DocsSearchFilterDecisionOutcome, type DocsSearchFilterField, type DocsSearchFilterInput, type DocsSearchFilters, type DocsSearchMatchField, type DocsSearchMatchedTerm, type DocsSearchQuery, type DocsSearchRankingReason, type DocsSearchRankingReasonCode, type DocsSearchRankingStrategy, type DocsSearchRequest, DocsSearchRequestError, type DocsSearchRequestResolutionOptions, type DocsSearchResponse, type DocsSearchResult, type DocsSearchSourcePage, type DocsSearchWarning, type DocsSearchWarningCode, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type EnrichDocsSearchDocumentsWithProvenanceOptions, type ExtractedDocsMarkdownPromptBlocks, type HydrateDocsContentChangesOptions, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, type McpDocsSearchConfig, type NormalizedOpenApiExample, type NormalizedOpenApiMediaType, type NormalizedOpenApiModel, type NormalizedOpenApiOperation, type NormalizedOpenApiParameter, type NormalizedOpenApiRequestBody, type NormalizedOpenApiResponse, OPENAPI_OPERATION_METHODS, type OpenApiOperationMethod, type PerformDocsSearchOptions, type PromptAction, type PromptProviderChoice, type ResolveConfiguredAgentSkillsOptions, type ResolveDocsContentChangesOptions, type ResolvedApiReferenceConfig, type ResolvedApiReferenceVersion, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, 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, createDocsMcpServerCard, createDocsMcpServerCardResponse, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, hydrateDocsContentChanges, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsContentChangeGeneration, isDocsContentChangesRequest, isDocsRetrievalCanonicalUrl, loadDocsConfigModule, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsAgentFeedbackFile, readDocsAppVersion, 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/server.mjs

@@ -18,8 +18,10 @@ import { createDocsCloudAskAIResponse, isDocsCloudAskAIProvider } from "./cloud-
 import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
 import { runDocsGoldenTasks } from "./agent-evals.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
+import { readDocsAppVersion } from "./app-version.mjs";
 import { loadDocsConfigModule } from "./cli/config.mjs";
 import { DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, normalizePromptProviderName, parsePromptStringArray, resolvePromptProviderChoices, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders } from "./prompt-utils.mjs";
 import { readDocsSitemapManifest } from "./sitemap-server.mjs";
+import { DOCS_MCP_SERVER_CARD_SUFFIX, createDocsMcpServerCard, createDocsMcpServerCardResponse } from "./mcp-server-card.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, loadDocsConfigModule, 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 };
+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, DOCS_MCP_SERVER_CARD_SUFFIX, 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, createDocsMcpServerCard, createDocsMcpServerCardResponse, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, hydrateDocsContentChanges, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsContentChangeGeneration, isDocsContentChangesRequest, isDocsRetrievalCanonicalUrl, loadDocsConfigModule, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsAgentFeedbackFile, readDocsAppVersion, 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/text-transform-cache.mjs

@@ -0,0 +1,38 @@
+//#region src/text-transform-cache.ts
+/** Bounded LRU cache for pure text transforms. Values are immutable strings. */
+function createDocsTextTransformCache({ maxEntries = 512, maxCharacters = 4e6 } = {}) {
+	const entries = /* @__PURE__ */ new Map();
+	let characters = 0;
+	return {
+		get(source) {
+			const entry = entries.get(source);
+			if (!entry) return void 0;
+			entries.delete(source);
+			entries.set(source, entry);
+			return entry.value;
+		},
+		set(source, value) {
+			const previous = entries.get(source);
+			if (previous) {
+				entries.delete(source);
+				characters -= previous.characters;
+			}
+			const size = source.length + (source === value ? 0 : value.length);
+			if (maxEntries < 1 || size > maxCharacters) return;
+			entries.set(source, {
+				value,
+				characters: size
+			});
+			characters += size;
+			while (entries.size > maxEntries || characters > maxCharacters) {
+				const oldest = entries.entries().next().value;
+				if (!oldest) break;
+				entries.delete(oldest[0]);
+				characters -= oldest[1].characters;
+			}
+		}
+	};
+}
+
+//#endregion
+export { createDocsTextTransformCache };

package/dist/types.d.mts

@@ -1080,14 +1080,6 @@ interface LlmsTxtConfig {
    * @default true
    */
   apiCatalog?: boolean;
-  /**
-   * Render the `llms.txt` link as a visible header link instead of a visually hidden agent
-   * directive. The link gets `data-visible-in-header="true"`; style and place it in your site's
-   * CSS (`.fd-agent-llms-directive[data-visible-in-header="true"]`), and keep it clear of the
-   * search and menu buttons on narrow screens. The link stays in the page for agents either way.
-   * @default false
-   */
-  showInHeader?: boolean;
   /**
    * Base URL for your docs site (used to build absolute links in llms.txt).
    * @example "https://docs.example.com"
@@ -1441,7 +1433,7 @@ interface DocsMcpConfig {
   name?: string;
   /**
    * Version string reported by the MCP server.
-   * Defaults to `"0.0.0"` when not set.
+   * Defaults to the app's `package.json` version, or `"0.0.0"` when it cannot be read.
    */
   version?: string;
   /** Fine-grained tool toggles. Omitted tools stay enabled. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.128",
+  "version": "0.2.130",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",

package/styles/themes/shadcn.css

@@ -949,7 +949,7 @@ aside#nd-sidebar button.text-fd-muted-foreground,
 }
 
 .fd-tabs-list,
-[role="tablist"] {
+.fd-tabs > [role="tablist"] {
   border: 0 !important;
   border-bottom: 1px solid var(--color-fd-border) !important;
   border-radius: 0 !important;
@@ -960,7 +960,7 @@ aside#nd-sidebar button.text-fd-muted-foreground,
 
 .fd-tabs-trigger,
 .fd-tab-trigger,
-[role="tab"] {
+.fd-tabs > [role="tablist"] > [role="tab"] {
   border: 0 !important;
   border-bottom: 2px solid transparent !important;
   border-radius: 0 !important;
@@ -974,17 +974,18 @@ aside#nd-sidebar button.text-fd-muted-foreground,
 }
 
 .fd-tabs-trigger[data-state="active"],
+.fd-tabs-trigger[aria-selected="true"],
 .fd-tab-trigger[data-state="active"],
 .fd-tab-trigger.fd-tab-active,
-[role="tab"][aria-selected="true"],
-[role="tab"][data-active="true"] {
+.fd-tabs > [role="tablist"] > [role="tab"][aria-selected="true"],
+.fd-tabs > [role="tablist"] > [role="tab"][data-active="true"] {
   border-bottom-color: var(--color-fd-foreground) !important;
   color: var(--color-fd-foreground) !important;
 }
 
 .fd-tabs-trigger:focus-visible,
 .fd-tab-trigger:focus-visible,
-[role="tab"]:focus-visible {
+.fd-tabs > [role="tablist"] > [role="tab"]:focus-visible {
   outline: 2px solid var(--color-fd-ring) !important;
   outline-offset: -2px !important;
 }