@farming-labs/theme 0.2.103 → 0.2.105

package/dist/docs-api.d.mts

@@ -99,6 +99,8 @@ interface DocsMCPAPIOptions {
   telemetry?: boolean | DocsTelemetryConfig;
   observability?: boolean | DocsObservabilityConfig;
   agent?: DocsConfig["agent"];
+  apiReference?: DocsConfig["apiReference"];
+  feedback?: DocsConfig["feedback"];
   /** @internal Build-time Agent Skills snapshot supplied by framework adapters. */
   _preloadedAgentSkills?: readonly DocsPublishedAgentSkill[];
 }

package/dist/docs-api.mjs

@@ -4,8 +4,8 @@ import { BoundedRouteCache } from "./bounded-route-cache.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DOCS_CONTENT_CHANGES_FORMAT, DOCS_CONTENT_CHANGES_RESPONSE_VALUE, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsSearchFacets, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCacheableResponse, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsContentChangesRequest, isDocsDiagnosticsRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, resolveDocsContentChangesConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMetadataBaseUrl, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsStandardsDiscoveryRequest, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent, stripGeneratedAgentProvenance } from "@farming-labs/docs";
-import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceOpenApiDiscovery, resolveConfiguredAgentSkills, resolveDocsMcpConfig } from "@farming-labs/docs/server";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DOCS_CONTENT_CHANGES_FORMAT, DOCS_CONTENT_CHANGES_RESPONSE_VALUE, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsSearchFacets, compactDocsAgentDiscoverySpec, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCacheableResponse, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsContentChangesRequest, isDocsDiagnosticsRequest, normalizeDocsOkfTrustMetadataInput, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, resolveDocsContentChangesConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMetadataBaseUrl, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsStandardsDiscoveryRequest, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent, stripGeneratedAgentProvenance } from "@farming-labs/docs";
+import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveConfiguredAgentSkills, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
 /**
@@ -214,6 +214,12 @@ function buildAgentSpec({ origin, entry, apiRoute, apiCatalog, i18n, search, con
 		format: DOCS_AGENT_MANIFEST_FORMAT,
 		version: DOCS_AGENT_MANIFEST_VERSION,
 		name: "@farming-labs/docs",
+		profile: "full",
+		profiles: {
+			default: "full",
+			full: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			compact: `${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}?profile=compact`
+		},
 		baseUrl: origin,
 		site: {
 			title: llms.siteTitle ?? "Documentation",
@@ -1037,6 +1043,7 @@ function scanDocsDir(docsDir, entry, locale, excludedDirs = [], publicPath = `/$
 					description,
 					relatedInput: data.related,
 					agent: normalizePageAgentFrontmatter(data.agent),
+					okf: normalizeDocsOkfTrustMetadataInput(data.okf),
 					content,
 					rawContent,
 					agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
@@ -1105,6 +1112,7 @@ function scanChangelogDir(changelogDir, entryPath, changelogPath, locale, public
 				description,
 				relatedInput: data.related,
 				agent: normalizePageAgentFrontmatter(data.agent),
+				okf: normalizeDocsOkfTrustMetadataInput(data.okf),
 				content,
 				rawContent,
 				agentFallbackRawContent: agentRawContent !== rawContent ? agentRawContent : void 0,
@@ -1321,7 +1329,8 @@ function renderMarkdownDocument(page, options = {}) {
 	return renderDocsMarkdownDocument(page, {
 		llms: options.llmsEnabled !== false,
 		origin: options.origin,
-		sitemap: options.sitemap
+		sitemap: options.sitemap,
+		okf: options.okf
 	});
 }
 function renderSkillDocument({ origin, entry, apiRoute, apiCatalog, search, contentChanges, mcp, feedback, llms, sitemap, robots, openapi }) {
@@ -2771,9 +2780,11 @@ function createDocsAPI(options) {
 				document: renderMarkdownDocument(withPublicDocsUrl(page, ctx), {
 					llmsEnabled: llmsConfig.enabled,
 					origin,
-					sitemap: sitemapConfig
+					sitemap: sitemapConfig,
+					okf: options?.agent?.okf
 				}),
-				lastModified: resolveDocsRetrievalLastModified(page, "agent")
+				lastModified: resolveDocsRetrievalLastModified(page, "agent"),
+				access: page.agent?.access
 			};
 		}
 		const fallbackPage = getIndexes(ctx).find((page) => {
@@ -2784,18 +2795,22 @@ function createDocsAPI(options) {
 			document: renderMarkdownDocument(withPublicDocsUrl(fallbackPage, ctx), {
 				llmsEnabled: llmsConfig.enabled,
 				origin,
-				sitemap: sitemapConfig
+				sitemap: sitemapConfig,
+				okf: options?.agent?.okf
 			}),
-			lastModified: resolveDocsRetrievalLastModified(fallbackPage, "agent")
+			lastModified: resolveDocsRetrievalLastModified(fallbackPage, "agent"),
+			access: fallbackPage.agent?.access
 		};
 		const requestedSlug = normalizePublicDocsSlug(ctx, normalizedPublicRequest);
 		for (const page of getIndexes(ctx)) if (normalizePublicDocsSlug(ctx, page.url) === requestedSlug) return {
 			document: renderMarkdownDocument(withPublicDocsUrl(page, ctx), {
 				llmsEnabled: llmsConfig.enabled,
 				origin,
-				sitemap: sitemapConfig
+				sitemap: sitemapConfig,
+				okf: options?.agent?.okf
 			}),
-			lastModified: resolveDocsRetrievalLastModified(page, "agent")
+			lastModified: resolveDocsRetrievalLastModified(page, "agent"),
+			access: page.agent?.access
 		};
 		return null;
 	}
@@ -2931,31 +2946,34 @@ function createDocsAPI(options) {
 						method: requestMethod
 					}
 				});
+				const fullSpec = buildAgentSpec({
+					origin: url.origin,
+					entry,
+					apiRoute: requestApiRoute,
+					apiCatalog: apiCatalogEnabled,
+					i18n,
+					search: searchConfig,
+					contentChanges: contentChangesConfig.enabled,
+					mcp: mcpConfig,
+					feedback: agentFeedbackConfig,
+					llms: llmsConfig,
+					sitemap: sitemapConfig,
+					robots: robotsConfig,
+					openapi: openapiDiscovery,
+					publishedSkills: [await resolveDocsPublishedAgentSkill({
+						preferredDocument: readRootSkillDocument(),
+						fallbackDocument: getGeneratedSkillDocument(url.origin, requestApiRoute)
+					}), ...await getPublishedAgentSkills()],
+					agentCard: options?.agent?.a2a
+				});
+				const compact = url.searchParams.get("profile") === "compact";
+				const spec = compact ? compactDocsAgentDiscoverySpec(fullSpec) : fullSpec;
 				return createDocsCacheableResponse({
 					request,
-					content: `${JSON.stringify(buildAgentSpec({
-						origin: url.origin,
-						entry,
-						apiRoute: requestApiRoute,
-						apiCatalog: apiCatalogEnabled,
-						i18n,
-						search: searchConfig,
-						contentChanges: contentChangesConfig.enabled,
-						mcp: mcpConfig,
-						feedback: agentFeedbackConfig,
-						llms: llmsConfig,
-						sitemap: sitemapConfig,
-						robots: robotsConfig,
-						openapi: openapiDiscovery,
-						publishedSkills: [await resolveDocsPublishedAgentSkill({
-							preferredDocument: readRootSkillDocument(),
-							fallbackDocument: getGeneratedSkillDocument(url.origin, requestApiRoute)
-						}), ...await getPublishedAgentSkills()],
-						agentCard: options?.agent?.a2a
-					}), null, 2)}\n`,
+					content: `${JSON.stringify(spec, null, compact ? void 0 : 2)}\n`,
 					headers: {
 						"Content-Type": "application/json; charset=utf-8",
-						"Cache-Control": "public, max-age=0, s-maxage=3600",
+						"Cache-Control": "public, max-age=0, s-maxage=3600, stale-while-revalidate=86400",
 						Link: agentManifestLinkHeader,
 						"X-Robots-Tag": "noindex"
 					}
@@ -3181,6 +3199,7 @@ function createDocsAPI(options) {
 					canonicalUrl,
 					locale: ctx.locale,
 					lastModified: representation?.lastModified,
+					access: representation?.access,
 					sitemap: sitemapConfig
 				});
 			}
@@ -3429,27 +3448,39 @@ function createDocsMCPAPI(options = {}) {
 		if (!configuredAgentSkills) configuredAgentSkills = Array.isArray(options._preloadedAgentSkills) ? Promise.resolve([...options._preloadedAgentSkills]) : resolveConfiguredAgentSkills(options.agent?.skills, { rootDir });
 		return configuredAgentSkills;
 	}
+	const source = {
+		...createFilesystemDocsMcpSource({
+			rootDir,
+			entry,
+			contentDir,
+			siteTitle: navTitle,
+			baseUrl: options.baseUrl?.trim() || resolveDocsMetadataBaseUrl(options) || void 0,
+			ordering: options.ordering
+		}),
+		async getSkills() {
+			const configured = await getConfiguredAgentSkills();
+			return [await resolveDocsPublishedAgentSkill({
+				preferredDocument: readRootSkillDocument(),
+				fallbackDocument: `---\nname: docs\ndescription: Use the project documentation through MCP resources and tools.\n---\n\n# Documentation\n`
+			}), ...configured];
+		}
+	};
+	const mcpApiReference = resolveApiReferenceConfig(options.apiReference).mcp;
 	const handlers = createDocsMcpHttpHandler({
-		source: {
-			...createFilesystemDocsMcpSource({
-				rootDir,
-				entry,
-				contentDir,
-				siteTitle: navTitle,
-				baseUrl: options.baseUrl?.trim() || resolveDocsMetadataBaseUrl(options) || void 0,
-				ordering: options.ordering
-			}),
-			async getSkills() {
-				const configured = await getConfiguredAgentSkills();
-				return [await resolveDocsPublishedAgentSkill({
-					preferredDocument: readRootSkillDocument(),
-					fallbackDocument: `---\nname: docs\ndescription: Use the project documentation through MCP resources and tools.\n---\n\n# Documentation\n`
-				}), ...configured];
-			}
-		},
+		source,
 		mcp: mcpConfig,
+		okf: options.agent?.okf,
+		openapi: mcpApiReference ? {
+			config: mcpApiReference,
+			document: () => buildApiReferenceOpenApiDocumentAsync(options, {
+				framework: "next",
+				rootDir,
+				baseUrl: options.baseUrl?.trim() || resolveDocsMetadataBaseUrl(options) || void 0
+			})
+		} : void 0,
 		contentChanges: options.agent?.contentChanges,
 		evaluations: options.agent?.evaluations,
+		feedback: options.feedback,
 		contentChangeFeed,
 		search: options.search,
 		analytics: options.analytics,

package/dist/docs-layout.mjs

@@ -708,6 +708,8 @@ function createDocsLayout(config, options) {
 	const copyMarkdownEnabled = resolveBool(pageActions?.copyMarkdown);
 	const copyMarkdownConfig = pageActions?.copyMarkdown && typeof pageActions.copyMarkdown === "object" ? pageActions.copyMarkdown : void 0;
 	const openDocsEnabled = resolveBool(pageActions?.openDocs);
+	const connectMcp = resolveBool(pageActions?.connectMcp) ? pageActions?.connectMcp && typeof pageActions.connectMcp === "object" ? pageActions.connectMcp : {} : void 0;
+	const installSkills = resolveBool(pageActions?.installSkills) ? pageActions?.installSkills && typeof pageActions.installSkills === "object" ? pageActions.installSkills : {} : void 0;
 	const pageActionsPosition = pageActions?.position ?? "below-title";
 	const pageActionsAlignment = pageActions?.alignment ?? "left";
 	const lastUpdatedRaw = config.lastUpdated;
@@ -857,6 +859,8 @@ function createDocsLayout(config, options) {
 						openDocsProviders,
 						openDocsTarget: openDocsConfig?.target,
 						openDocsPrompt: openDocsConfig?.prompt,
+						connectMcp,
+						installSkills,
 						pageActionsPosition,
 						pageActionsAlignment,
 						githubUrl,

package/dist/docs-page-client.d.mts

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import { CopyMarkdownFormat, DocsFeedbackData, ReadingTimeFormat } from "@farming-labs/docs";
+import { CopyMarkdownFormat, DocsFeedbackData, PageActionConnectMcpConfig, PageActionInstallSkillsConfig, ReadingTimeFormat } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/docs-page-client.d.ts
@@ -37,6 +37,8 @@ interface DocsPageClientProps {
   openDocsProviders?: SerializedProvider[];
   openDocsTarget?: "markdown" | "page" | "source" | "github";
   openDocsPrompt?: string;
+  connectMcp?: PageActionConnectMcpConfig;
+  installSkills?: PageActionInstallSkillsConfig;
   /** Where to render page actions relative to the title */
   pageActionsPosition?: "above-title" | "below-title" | "toc";
   /** Horizontal alignment of page action buttons */
@@ -120,6 +122,8 @@ declare function DocsPageClient({
   openDocsProviders,
   openDocsTarget,
   openDocsPrompt,
+  connectMcp,
+  installSkills,
   pageActionsPosition,
   pageActionsAlignment,
   githubUrl,

package/dist/docs-page-client.mjs

@@ -255,7 +255,7 @@ function findThreadlineTocActionsContainer() {
 	}
 	return toc.parentElement ?? toc;
 }
-function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownFormat, copyMarkdownIncludeTitle, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, descriptionInBody = false, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownFormat, copyMarkdownIncludeTitle, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, connectMcp, installSkills, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, descriptionInBody = false, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
@@ -487,6 +487,8 @@ function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "defa
 					providers: openDocsProviders,
 					openDocsTarget,
 					openDocsPrompt,
+					connectMcp,
+					installSkills,
 					alignment: pageActionsAlignment,
 					variant: "default",
 					githubFileUrl,
@@ -571,6 +573,8 @@ function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "defa
 			providers: openDocsProviders,
 			openDocsTarget,
 			openDocsPrompt,
+			connectMcp,
+			installSkills,
 			alignment: "left",
 			variant: "rail",
 			githubFileUrl,
@@ -628,6 +632,8 @@ function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "defa
 							providers: openDocsProviders,
 							openDocsTarget,
 							openDocsPrompt,
+							connectMcp,
+							installSkills,
 							alignment: pageActionsAlignment,
 							variant: "default",
 							githubFileUrl,

package/dist/page-actions.d.mts

@@ -1,4 +1,4 @@
-import { CopyMarkdownFormat } from "@farming-labs/docs";
+import { CopyMarkdownFormat, PageActionMcpProvider } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/page-actions.d.ts
@@ -25,7 +25,18 @@ interface PageActionsProps {
   /** GitHub file URL (edit view) for the current page. Used when urlTemplate contains {githubUrl}. */
   githubFileUrl?: string | null;
   analytics?: boolean;
+  connectMcp?: {
+    endpoint?: string;
+    providers?: readonly PageActionMcpProvider[];
+    label?: string;
+  };
+  installSkills?: {
+    index?: string;
+    command?: string;
+    label?: string;
+  };
 }
+declare function buildMcpSetupInstruction(provider: PageActionMcpProvider, endpoint: string): string;
 declare function formatCopyMarkdownContent(params: {
   content: string;
   format: CopyMarkdownFormat;
@@ -45,7 +56,9 @@ declare function PageActions({
   alignment,
   variant,
   githubFileUrl,
-  analytics
+  analytics,
+  connectMcp,
+  installSkills
 }: PageActionsProps): react_jsx_runtime0.JSX.Element | null;
 //#endregion
-export { PageActions, formatCopyMarkdownContent };
+export { PageActions, buildMcpSetupInstruction, formatCopyMarkdownContent };

package/dist/page-actions.mjs

@@ -8,6 +8,30 @@ import { usePathname } from "fumadocs-core/framework";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/page-actions.tsx
+const DEFAULT_MCP_PROVIDERS = [
+	"copy",
+	"claude-code",
+	"cursor",
+	"vscode",
+	"codex"
+];
+const MCP_PROVIDER_LABELS = {
+	copy: "Copy endpoint",
+	"claude-code": "Claude Code",
+	cursor: "Cursor",
+	vscode: "VS Code",
+	codex: "Codex"
+};
+function buildMcpSetupInstruction(provider, endpoint) {
+	if (provider === "copy") return endpoint;
+	if (provider === "claude-code") return `claude mcp add --transport http docs ${endpoint}`;
+	if (provider === "codex") return `codex mcp add docs --url ${endpoint}`;
+	if (provider === "vscode") return JSON.stringify({ servers: { docs: {
+		type: "http",
+		url: endpoint
+	} } }, null, 2);
+	return JSON.stringify({ mcpServers: { docs: { url: endpoint } } }, null, 2);
+}
 const CopyIcon = () => /* @__PURE__ */ jsxs("svg", {
 	width: "14",
 	height: "14",
@@ -146,14 +170,46 @@ function currentPageTitle() {
 	const title = document.querySelector("#nd-page h1") ?? document.querySelector("article h1") ?? document.querySelector("h1");
 	return title?.innerText?.trim() || title?.textContent?.trim() || "";
 }
-function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdownIncludeTitle = false, copyMarkdownLabel = "Copy page", copyMarkdownCopiedLabel = "Copied!", openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", variant = "default", githubFileUrl, analytics = false }) {
+function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdownIncludeTitle = false, copyMarkdownLabel = "Copy page", copyMarkdownCopiedLabel = "Copied!", openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", variant = "default", githubFileUrl, analytics = false, connectMcp, installSkills }) {
 	const [copied, setCopied] = useState(false);
 	const [dropdownOpen, setDropdownOpen] = useState(false);
+	const [mcpOpen, setMcpOpen] = useState(false);
+	const [skillsOpen, setSkillsOpen] = useState(false);
+	const [copiedSetup, setCopiedSetup] = useState();
+	const [publishedSkills, setPublishedSkills] = useState([]);
 	const dropdownRef = useRef(null);
 	const pathname = usePathname();
 	const resolvedProviders = providers ?? DEFAULT_PROVIDERS;
 	const cleanedPathname = pathname.replace(/\/+$/, "") || "/";
 	const markdownHref = cleanedPathname === "/" ? "/index.md" : `${cleanedPathname.replace(/\.md$/, "")}.md`;
+	const resolveAbsoluteUrl = useCallback((value) => {
+		try {
+			return new URL(value, window.location.origin).toString();
+		} catch {
+			return value;
+		}
+	}, []);
+	const copySetup = useCallback(async (key, value) => {
+		await navigator.clipboard.writeText(value);
+		setCopiedSetup(key);
+		setTimeout(() => setCopiedSetup(void 0), 2e3);
+	}, []);
+	const openSkills = useCallback(async () => {
+		setSkillsOpen(true);
+		if (publishedSkills.length > 0) return;
+		try {
+			const response = await fetch(resolveAbsoluteUrl(installSkills?.index ?? "/.well-known/agent-skills/index.json"), { headers: { Accept: "application/json" } });
+			if (!response.ok) return;
+			setPublishedSkills(((await response.json()).skills ?? []).flatMap((skill) => typeof skill.name === "string" ? [{
+				name: skill.name,
+				...typeof skill.description === "string" ? { description: skill.description } : {}
+			}] : []));
+		} catch {}
+	}, [
+		installSkills?.index,
+		publishedSkills.length,
+		resolveAbsoluteUrl
+	]);
 	const handleCopyMarkdown = useCallback(async () => {
 		try {
 			let content = "";
@@ -249,9 +305,11 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 	}, [dropdownOpen]);
 	useEffect(() => {
 		setDropdownOpen(false);
+		setMcpOpen(false);
+		setSkillsOpen(false);
 		setCopied(false);
 	}, [pathname]);
-	if (variant !== "rail" && !copyMarkdown && !openDocs) return null;
+	if (variant !== "rail" && !copyMarkdown && !openDocs && !connectMcp && !installSkills) return null;
 	if (variant === "rail") return /* @__PURE__ */ jsxs("div", {
 		className: "fd-page-actions fd-page-actions-rail",
 		"data-page-actions": true,
@@ -285,6 +343,18 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 				onClick: handleAskAI,
 				className: "fd-page-action-btn",
 				children: [/* @__PURE__ */ jsx(SparklesIcon, {}), /* @__PURE__ */ jsx("span", { children: "Ask AI" })]
+			}),
+			connectMcp && /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => copySetup("mcp:rail", resolveAbsoluteUrl(connectMcp.endpoint ?? "/mcp")),
+				className: "fd-page-action-btn",
+				children: /* @__PURE__ */ jsx("span", { children: copiedSetup === "mcp:rail" ? "Copied endpoint" : connectMcp.label ?? "Connect MCP" })
+			}),
+			installSkills && /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => copySetup("skills:rail", installSkills.command ?? `npx skills add ${window.location.origin}`),
+				className: "fd-page-action-btn",
+				children: /* @__PURE__ */ jsx("span", { children: copiedSetup === "skills:rail" ? "Copied command" : installSkills.label ?? "Install skills" })
 			})
 		]
 	});
@@ -292,60 +362,124 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 		className: "fd-page-actions",
 		"data-page-actions": true,
 		"data-actions-alignment": alignment,
-		children: [copyMarkdown && /* @__PURE__ */ jsxs("button", {
-			type: "button",
-			onClick: handleCopyMarkdown,
-			className: "fd-page-action-btn",
-			"data-copied": copied,
-			"data-copy-markdown-format": copyMarkdownFormat,
-			"data-copy-markdown-include-title": copyMarkdownIncludeTitle || void 0,
-			children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? copyMarkdownCopiedLabel : copyMarkdownLabel })]
-		}), openDocs && resolvedProviders.length > 0 && /* @__PURE__ */ jsxs("div", {
-			ref: dropdownRef,
-			className: "fd-page-action-dropdown",
-			children: [/* @__PURE__ */ jsxs("button", {
+		children: [
+			copyMarkdown && /* @__PURE__ */ jsxs("button", {
 				type: "button",
-				onClick: () => {
-					const next = !dropdownOpen;
-					setDropdownOpen(next);
-					if (analytics && next) emitClientAnalyticsEvent({
-						type: "page_action_open_docs_menu",
-						properties: {
-							providerCount: resolvedProviders.length,
-							pathname
-						}
-					});
-				},
+				onClick: handleCopyMarkdown,
 				className: "fd-page-action-btn",
-				"aria-expanded": dropdownOpen,
-				children: [/* @__PURE__ */ jsx("span", { children: "Open in" }), /* @__PURE__ */ jsx(ChevronDownIcon, {})]
-			}), dropdownOpen && /* @__PURE__ */ jsx("div", {
-				className: "fd-page-action-menu",
-				role: "menu",
-				children: resolvedProviders.map((provider) => {
-					const iconHtml = sanitizeIconHtml(provider.iconHtml ?? resolveOpenDocsProviderIcon(provider.name));
-					return /* @__PURE__ */ jsxs("button", {
+				"data-copied": copied,
+				"data-copy-markdown-format": copyMarkdownFormat,
+				"data-copy-markdown-include-title": copyMarkdownIncludeTitle || void 0,
+				children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? copyMarkdownCopiedLabel : copyMarkdownLabel })]
+			}),
+			openDocs && resolvedProviders.length > 0 && /* @__PURE__ */ jsxs("div", {
+				ref: dropdownRef,
+				className: "fd-page-action-dropdown",
+				children: [/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: () => {
+						const next = !dropdownOpen;
+						setDropdownOpen(next);
+						if (analytics && next) emitClientAnalyticsEvent({
+							type: "page_action_open_docs_menu",
+							properties: {
+								providerCount: resolvedProviders.length,
+								pathname
+							}
+						});
+					},
+					className: "fd-page-action-btn",
+					"aria-expanded": dropdownOpen,
+					children: [/* @__PURE__ */ jsx("span", { children: "Open in" }), /* @__PURE__ */ jsx(ChevronDownIcon, {})]
+				}), dropdownOpen && /* @__PURE__ */ jsx("div", {
+					className: "fd-page-action-menu",
+					role: "menu",
+					children: resolvedProviders.map((provider) => {
+						const iconHtml = sanitizeIconHtml(provider.iconHtml ?? resolveOpenDocsProviderIcon(provider.name));
+						return /* @__PURE__ */ jsxs("button", {
+							type: "button",
+							role: "menuitem",
+							className: "fd-page-action-menu-item",
+							onClick: () => handleOpen(provider),
+							children: [
+								iconHtml && /* @__PURE__ */ jsx("span", {
+									className: "fd-page-action-menu-icon",
+									dangerouslySetInnerHTML: { __html: iconHtml }
+								}),
+								/* @__PURE__ */ jsxs("span", {
+									className: "fd-page-action-menu-label",
+									children: ["Open in ", provider.name]
+								}),
+								/* @__PURE__ */ jsx(ExternalLinkIcon, {})
+							]
+						}, provider.name);
+					})
+				})]
+			}),
+			connectMcp && /* @__PURE__ */ jsxs("div", {
+				className: "fd-page-action-dropdown",
+				children: [/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					className: "fd-page-action-btn",
+					"aria-expanded": mcpOpen,
+					onClick: () => setMcpOpen((open) => !open),
+					children: [/* @__PURE__ */ jsx("span", { children: connectMcp.label ?? "Connect MCP" }), /* @__PURE__ */ jsx(ChevronDownIcon, {})]
+				}), mcpOpen && /* @__PURE__ */ jsx("div", {
+					className: "fd-page-action-menu",
+					role: "menu",
+					children: (connectMcp.providers ?? DEFAULT_MCP_PROVIDERS).map((provider) => {
+						const endpoint = resolveAbsoluteUrl(connectMcp.endpoint ?? "/mcp");
+						const key = `mcp:${provider}`;
+						return /* @__PURE__ */ jsxs("button", {
+							type: "button",
+							role: "menuitem",
+							className: "fd-page-action-menu-item",
+							onClick: async () => {
+								await copySetup(key, buildMcpSetupInstruction(provider, endpoint));
+								setMcpOpen(false);
+							},
+							children: [/* @__PURE__ */ jsx("span", {
+								className: "fd-page-action-menu-label",
+								children: copiedSetup === key ? "Copied" : MCP_PROVIDER_LABELS[provider]
+							}), copiedSetup === key ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {})]
+						}, provider);
+					})
+				})]
+			}),
+			installSkills && /* @__PURE__ */ jsxs("div", {
+				className: "fd-page-action-dropdown",
+				children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: "fd-page-action-btn",
+					onClick: openSkills,
+					children: /* @__PURE__ */ jsx("span", { children: installSkills.label ?? "Install skills" })
+				}), skillsOpen && /* @__PURE__ */ jsxs("div", {
+					className: "fd-page-action-menu",
+					role: "dialog",
+					"aria-label": "Install Agent Skills",
+					children: [publishedSkills.map((skill) => /* @__PURE__ */ jsx("div", {
+						className: "fd-page-action-menu-item",
+						children: /* @__PURE__ */ jsx("span", {
+							className: "fd-page-action-menu-label",
+							children: skill.name
+						})
+					}, skill.name)), /* @__PURE__ */ jsxs("button", {
 						type: "button",
-						role: "menuitem",
 						className: "fd-page-action-menu-item",
-						onClick: () => handleOpen(provider),
-						children: [
-							iconHtml && /* @__PURE__ */ jsx("span", {
-								className: "fd-page-action-menu-icon",
-								dangerouslySetInnerHTML: { __html: iconHtml }
-							}),
-							/* @__PURE__ */ jsxs("span", {
-								className: "fd-page-action-menu-label",
-								children: ["Open in ", provider.name]
-							}),
-							/* @__PURE__ */ jsx(ExternalLinkIcon, {})
-						]
-					}, provider.name);
-				})
-			})]
-		})]
+						onClick: async () => {
+							await copySetup("skills", installSkills.command ?? `npx skills add ${window.location.origin}`);
+							setSkillsOpen(false);
+						},
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "fd-page-action-menu-label",
+							children: copiedSetup === "skills" ? "Copied install command" : "Copy install command"
+						}), copiedSetup === "skills" ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {})]
+					})]
+				})]
+			})
+		]
 	});
 }
 
 //#endregion
-export { PageActions, formatCopyMarkdownContent };
+export { PageActions, buildMcpSetupInstruction, formatCopyMarkdownContent };

package/dist/tanstack-layout.mjs

@@ -249,6 +249,8 @@ function TanstackDocsLayout({ config, tree, browserRuntime = false, locale, desc
 	const copyMarkdownEnabled = resolveBool(pageActions?.copyMarkdown);
 	const copyMarkdownConfig = pageActions?.copyMarkdown && typeof pageActions.copyMarkdown === "object" ? pageActions.copyMarkdown : void 0;
 	const openDocsEnabled = resolveBool(pageActions?.openDocs);
+	const connectMcp = resolveBool(pageActions?.connectMcp) ? pageActions?.connectMcp && typeof pageActions.connectMcp === "object" ? pageActions.connectMcp : {} : void 0;
+	const installSkills = resolveBool(pageActions?.installSkills) ? pageActions?.installSkills && typeof pageActions.installSkills === "object" ? pageActions.installSkills : {} : void 0;
 	const pageActionsPosition = pageActions?.position ?? "below-title";
 	const pageActionsAlignment = pageActions?.alignment ?? "left";
 	const lastUpdatedRaw = config.lastUpdated;
@@ -377,6 +379,8 @@ function TanstackDocsLayout({ config, tree, browserRuntime = false, locale, desc
 					openDocsProviders,
 					openDocsTarget: openDocsConfig?.target,
 					openDocsPrompt: openDocsConfig?.prompt,
+					connectMcp,
+					installSkills,
 					pageActionsPosition,
 					pageActionsAlignment,
 					editOnGithubUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.2.103",
+  "version": "0.2.105",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -161,7 +161,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.103"
+    "@farming-labs/docs": "0.2.105"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",