@farming-labs/docs 0.1.115 → 0.1.117

package/dist/cli/index.mjs

@@ -83,7 +83,7 @@ async function main() {
 		const { dev } = await import("../dev-FC6Fh7nT.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-Cv95rruE.mjs");
+		const { runMcp } = await import("../mcp-BUf-9KXn.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
 		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-D8DpCgt_.mjs");
@@ -114,7 +114,7 @@ async function main() {
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CgCcBScE.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CaDyUn0F.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();

package/dist/{doctor-CgCcBScE.mjs → doctor-CaDyUn0F.mjs}

@@ -955,7 +955,9 @@ async function probeMcpRoute(baseUrl, route) {
 			"list_pages",
 			"get_navigation",
 			"search_docs",
-			"read_page"
+			"read_page",
+			"get_code_examples",
+			"get_config_schema"
 		].filter((tool) => !toolNames.includes(tool));
 		if (missingTools.length > 0) return {
 			ok: false,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsSearchResultType, A as DocsConfig, At as SidebarFolderNode, B as DocsObservabilityEventInput, C as DocsAskAIActionData, Ct as PageSidebarFrontmatter, D as DocsAskAIFeedbackMessage, Dt as SidebarComponentProps, E as DocsAskAIFeedbackData, Et as ResolvedDocsRelatedLink, F as DocsMcpToolsConfig, Ft as ThemeToggleConfig, G as DocsSearchAdapterContext, H as DocsRobotsConfig, I as DocsMetadata, It as TypesenseDocsSearchConfig, J as DocsSearchConfig, K as DocsSearchAdapterFactory, L as DocsNav, Lt as TypographyConfig, M as DocsFeedbackValue, Mt as SidebarPageNode, N as DocsI18nConfig, Nt as SidebarTree, O as DocsAskAIFeedbackValue, Ot as SidebarConfig, P as DocsMcpConfig, Pt as SimpleDocsSearchConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, Rt as UIConfig, S as DocsAnalyticsSource, St as PageOpenGraph, T as DocsAskAIFeedbackConfig, Tt as ReadingTimeConfig, U as DocsRobotsRule, V as DocsRelatedItem, W as DocsSearchAdapter, X as DocsSearchEmbeddingsConfig, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, _t as OpenDocsTarget, a as ApiReferenceRenderer, at as GithubConfig, b as DocsAnalyticsEventType, bt as PageActionsConfig, c as ChangelogFrontmatter, ct as LlmsTxtMaxCharsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, f as DocsAgentFeedbackContext, ft as OGConfig, g as DocsAgentTraceStatus, gt as OpenDocsProviderId, h as DocsAgentTraceEventType, ht as OpenDocsProviderConfig, i as ApiReferenceConfig, it as FontStyle, j as DocsFeedbackData, jt as SidebarNode, k as DocsAskAIMcpConfig, kt as SidebarFolderIndexBehavior, l as CodeBlockCopyData, lt as LlmsTxtMaxCharsMode, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, n as AgentFeedbackConfig, nt as DocsTheme, o as BreadcrumbConfig, ot as LastUpdatedConfig, p as DocsAgentFeedbackData, pt as OpenDocsConfig, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, rt as FeedbackConfig, s as ChangelogConfig, st as LlmsTxtConfig, t as AIConfig, tt as DocsSitemapConfig, u as CopyMarkdownConfig, ut as LlmsTxtSectionConfig, v as DocsAnalyticsEvent, vt as OpenGraphImage, w as DocsAskAIActionType, wt as PageTwitter, x as DocsAnalyticsInput, xt as PageFrontmatter, y as DocsAnalyticsEventInput, yt as OrderingItem, z as DocsObservabilityEvent } from "./types-Zk0mIMGI.mjs";
-import { $ as emitDocsAgentTraceEvent, A as toDocsSitemapMarkdownUrl, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as PromptAction, I as PromptProviderChoice, J as DocsAgentTraceContext, L as SerializeOpenDocsProviderOptions, O as resolveDocsSitemapPageLastmod, Q as createDocsAgentTraceId, R as SerializedOpenDocsProvider, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, X as ResolvedDocsObservabilityConfig, Y as ResolvedDocsAnalyticsConfig, Z as createDocsAgentTraceContext, _ as DocsSitemapFormat, a as createMcpSearchAdapter, at as createDocsCloudAnalytics, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAnalyticsEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, it as DocsCloudAnalyticsOptions, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, nt as resolveDocsAnalyticsConfig, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as DOCS_AGENT_TRACE_EVENT_TYPES, r as createAlgoliaSearchAdapter, rt as resolveDocsObservabilityConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsObservabilityEvent, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage } from "./search-DjVbXEmb.mjs";
+import { $ as DocsSearchResultType, A as DocsConfig, At as SidebarFolderNode, B as DocsObservabilityEventInput, C as DocsAskAIActionData, Ct as PageSidebarFrontmatter, D as DocsAskAIFeedbackMessage, Dt as SidebarComponentProps, E as DocsAskAIFeedbackData, Et as ResolvedDocsRelatedLink, F as DocsMcpToolsConfig, Ft as ThemeToggleConfig, G as DocsSearchAdapterContext, H as DocsRobotsConfig, I as DocsMetadata, It as TypesenseDocsSearchConfig, J as DocsSearchConfig, K as DocsSearchAdapterFactory, L as DocsNav, Lt as TypographyConfig, M as DocsFeedbackValue, Mt as SidebarPageNode, N as DocsI18nConfig, Nt as SidebarTree, O as DocsAskAIFeedbackValue, Ot as SidebarConfig, P as DocsMcpConfig, Pt as SimpleDocsSearchConfig, Q as DocsSearchResult, R as DocsObservabilityConfig, Rt as UIConfig, S as DocsAnalyticsSource, St as PageOpenGraph, T as DocsAskAIFeedbackConfig, Tt as ReadingTimeConfig, U as DocsRobotsRule, V as DocsRelatedItem, W as DocsSearchAdapter, X as DocsSearchEmbeddingsConfig, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, _t as OpenDocsTarget, a as ApiReferenceRenderer, at as GithubConfig, b as DocsAnalyticsEventType, bt as PageActionsConfig, c as ChangelogFrontmatter, ct as LlmsTxtMaxCharsConfig, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, f as DocsAgentFeedbackContext, ft as OGConfig, g as DocsAgentTraceStatus, gt as OpenDocsProviderId, h as DocsAgentTraceEventType, ht as OpenDocsProviderConfig, i as ApiReferenceConfig, it as FontStyle, j as DocsFeedbackData, jt as SidebarNode, k as DocsAskAIMcpConfig, kt as SidebarFolderIndexBehavior, l as CodeBlockCopyData, lt as LlmsTxtMaxCharsMode, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, n as AgentFeedbackConfig, nt as DocsTheme, o as BreadcrumbConfig, ot as LastUpdatedConfig, p as DocsAgentFeedbackData, pt as OpenDocsConfig, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, rt as FeedbackConfig, s as ChangelogConfig, st as LlmsTxtConfig, t as AIConfig, tt as DocsSitemapConfig, u as CopyMarkdownConfig, ut as LlmsTxtSectionConfig, v as DocsAnalyticsEvent, vt as OpenGraphImage, w as DocsAskAIActionType, wt as PageTwitter, x as DocsAnalyticsInput, xt as PageFrontmatter, y as DocsAnalyticsEventInput, yt as OrderingItem, z as DocsObservabilityEvent } from "./types-D-cNOo-t.mjs";
+import { $ as emitDocsAgentTraceEvent, A as toDocsSitemapMarkdownUrl, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as PromptAction, I as PromptProviderChoice, J as DocsAgentTraceContext, L as SerializeOpenDocsProviderOptions, O as resolveDocsSitemapPageLastmod, Q as createDocsAgentTraceId, R as SerializedOpenDocsProvider, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, X as ResolvedDocsObservabilityConfig, Y as ResolvedDocsAnalyticsConfig, Z as createDocsAgentTraceContext, _ as DocsSitemapFormat, a as createMcpSearchAdapter, at as createDocsCloudAnalytics, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAnalyticsEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, it as DocsCloudAnalyticsOptions, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, nt as resolveDocsAnalyticsConfig, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as DOCS_AGENT_TRACE_EVENT_TYPES, r as createAlgoliaSearchAdapter, rt as resolveDocsObservabilityConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsObservabilityEvent, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage } from "./search-Dlwp88qb.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts
@@ -601,6 +601,8 @@ declare function buildDocsAgentDiscoverySpec({
       readPage: boolean;
       searchDocs: boolean;
       getNavigation: boolean;
+      getCodeExamples: boolean;
+      getConfigSchema: boolean;
     };
   };
   feedback: {

package/dist/{mcp-Cv95rruE.mjs → mcp-BUf-9KXn.mjs}

@@ -38,7 +38,9 @@ function readMcpConfig(content) {
 			listPages: readBooleanProperty(block, "listPages"),
 			readPage: readBooleanProperty(block, "readPage"),
 			searchDocs: readBooleanProperty(block, "searchDocs"),
-			getNavigation: readBooleanProperty(block, "getNavigation")
+			getNavigation: readBooleanProperty(block, "getNavigation"),
+			getCodeExamples: readBooleanProperty(block, "getCodeExamples"),
+			getConfigSchema: readBooleanProperty(block, "getConfigSchema")
 		}
 	};
 }

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { J as DocsSearchConfig, P as DocsMcpConfig, R as DocsObservabilityConfig, _ as DocsAnalyticsConfig, et as DocsSearchSourcePage, yt as OrderingItem } from "./types-Zk0mIMGI.mjs";
+import { J as DocsSearchConfig, P as DocsMcpConfig, R as DocsObservabilityConfig, _ as DocsAnalyticsConfig, et as DocsSearchSourcePage, yt as OrderingItem } from "./types-D-cNOo-t.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -18,6 +18,49 @@ interface DocsMcpPage {
   agentFallbackContent?: string;
   agentFallbackRawContent?: string;
 }
+interface DocsMcpCodeExample {
+  id: string;
+  page: {
+    slug: string;
+    url: string;
+    title: string;
+    description?: string;
+    sourcePath?: string;
+    lastModified?: string;
+  };
+  language?: string;
+  title?: string;
+  framework?: string;
+  packageManager?: string;
+  runnable: boolean;
+  meta: Record<string, string | boolean>;
+  code: string;
+}
+interface DocsMcpConfigSchemaOption {
+  path: string;
+  name: string;
+  type: string;
+  default?: string | boolean | number | null;
+  description: string;
+  docs?: string;
+  values?: string[];
+  children?: DocsMcpConfigSchemaOption[];
+}
+interface DocsMcpConfigSchema {
+  schemaVersion: 1;
+  configFile: "docs.config.ts";
+  description: string;
+  filters?: {
+    option?: string;
+    query?: string;
+  };
+  resultCount: number;
+  options: DocsMcpConfigSchemaOption[];
+  examples: Array<{
+    title: string;
+    code: string;
+  }>;
+}
 interface DocsMcpPageNode {
   type: "page";
   name: string;
@@ -53,6 +96,8 @@ interface DocsMcpResolvedConfig {
     readPage: boolean;
     searchDocs: boolean;
     getNavigation: boolean;
+    getCodeExamples: boolean;
+    getConfigSchema: boolean;
   };
 }
 interface DocsMcpHttpHandlers {
@@ -93,4 +138,4 @@ declare function createDocsMcpServer(options: CreateDocsMcpServerOptions): Promi
 declare function createDocsMcpHttpHandler(options: CreateDocsMcpServerOptions): DocsMcpHttpHandlers;
 declare function runDocsMcpStdio(options: CreateDocsMcpServerOptions): Promise<void>;
 //#endregion
-export { DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+export { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };

package/dist/mcp.mjs

@@ -13,6 +13,404 @@ import * as z from "zod/v4";
 const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
 const DEFAULT_MCP_VERSION = "0.0.0";
 const DEFAULT_MCP_NAME = "@farming-labs/docs";
+const DOCS_CONFIG_SCHEMA_OPTIONS = [
+	{
+		path: "entry",
+		name: "entry",
+		type: "string",
+		default: "docs",
+		description: "URL path prefix for documentation routes, for example \"docs\" creates /docs.",
+		docs: "/docs/overview"
+	},
+	{
+		path: "contentDir",
+		name: "contentDir",
+		type: "string",
+		default: "same as entry",
+		description: "Path to markdown content files. Adapters outside Next.js usually need this when content does not live under the route prefix.",
+		docs: "/docs/overview"
+	},
+	{
+		path: "staticExport",
+		name: "staticExport",
+		type: "boolean",
+		default: false,
+		description: "Enable full static builds. Search, AI, and runtime API routes are hidden.",
+		docs: "/docs/overview"
+	},
+	{
+		path: "theme",
+		name: "theme",
+		type: "DocsTheme",
+		description: "Theme instance from a theme factory such as fumadocs() or pixelBorder().",
+		docs: "/docs/customization/themes"
+	},
+	{
+		path: "nav",
+		name: "nav",
+		type: "{ title?: string; url?: string }",
+		description: "Sidebar and discovery metadata for the docs site. Non-Next.js adapters usually require it.",
+		children: [{
+			path: "nav.title",
+			name: "title",
+			type: "string",
+			description: "Human-readable docs site title."
+		}, {
+			path: "nav.url",
+			name: "url",
+			type: "string",
+			description: "Public base URL for generated absolute links and metadata."
+		}]
+	},
+	{
+		path: "github",
+		name: "github",
+		type: "string | GithubConfig",
+		description: "GitHub repository metadata for \"Edit on GitHub\" links and page action prompt templates.",
+		docs: "/docs/customization/page-actions"
+	},
+	{
+		path: "themeToggle",
+		name: "themeToggle",
+		type: "boolean | ThemeToggleConfig",
+		default: true,
+		description: "Enable or customize the light/dark mode toggle."
+	},
+	{
+		path: "breadcrumb",
+		name: "breadcrumb",
+		type: "boolean | BreadcrumbConfig",
+		default: true,
+		description: "Enable or customize breadcrumb navigation."
+	},
+	{
+		path: "sidebar",
+		name: "sidebar",
+		type: "boolean | SidebarConfig",
+		default: true,
+		description: "Enable or customize the docs sidebar.",
+		children: [{
+			path: "sidebar.style",
+			name: "style",
+			type: "string",
+			description: "Theme-specific sidebar style variant when supported."
+		}, {
+			path: "sidebar.defaultOpen",
+			name: "defaultOpen",
+			type: "boolean",
+			description: "Whether collapsible sidebar groups start open by default."
+		}]
+	},
+	{
+		path: "icons",
+		name: "icons",
+		type: "Record<string, Component>",
+		description: "Shared icon registry for frontmatter icon fields and built-in MDX components."
+	},
+	{
+		path: "components",
+		name: "components",
+		type: "Record<string, Component>",
+		description: "Custom MDX component registry and built-in component overrides."
+	},
+	{
+		path: "onCopyClick",
+		name: "onCopyClick",
+		type: "(data: CodeBlockCopyData) => void",
+		description: "Callback fired when a visitor copies a code block, including title, content, url, and language."
+	},
+	{
+		path: "feedback",
+		name: "feedback",
+		type: "boolean | FeedbackConfig",
+		default: false,
+		description: "Human page feedback UI. Agent feedback endpoints remain default-on unless opted out.",
+		docs: "/docs/customization/feedback"
+	},
+	{
+		path: "readingTime",
+		name: "readingTime",
+		type: "boolean | ReadingTimeConfig",
+		default: false,
+		description: "Opt-in estimated reading time label with per-page overrides."
+	},
+	{
+		path: "agent",
+		name: "agent",
+		type: "DocsAgentConfig",
+		description: "Defaults for docs agent compact and generated agent-facing files.",
+		docs: "/docs/getting-started/agent-ready-docs"
+	},
+	{
+		path: "pageActions",
+		name: "pageActions",
+		type: "PageActionsConfig",
+		description: "Copy Markdown and Open in LLM actions for docs pages.",
+		docs: "/docs/customization/page-actions",
+		children: [{
+			path: "pageActions.copyMarkdown",
+			name: "copyMarkdown",
+			type: "boolean | PageActionConfig",
+			description: "Show a Copy Markdown action for the current page."
+		}, {
+			path: "pageActions.openDocs",
+			name: "openDocs",
+			type: "boolean | OpenDocsActionConfig",
+			description: "Show provider actions that open the current docs page in an LLM.",
+			children: [
+				{
+					path: "pageActions.openDocs.target",
+					name: "target",
+					type: "\"page\" | \"markdown\"",
+					default: "page",
+					description: "Whether provider URLs receive the rendered page URL or the .md markdown route."
+				},
+				{
+					path: "pageActions.openDocs.providers",
+					name: "providers",
+					type: "Array<string | PromptProviderConfig>",
+					description: "Provider IDs or provider objects. Built-ins include chatgpt, claude, cursor, and t3."
+				},
+				{
+					path: "pageActions.openDocs.prompt",
+					name: "prompt",
+					type: "string",
+					description: "Prompt text prepended to the provider URL when opening docs."
+				}
+			]
+		}]
+	},
+	{
+		path: "ai",
+		name: "ai",
+		type: "AIConfig",
+		description: "RAG-powered Ask AI configuration.",
+		docs: "/docs/customization/ask-ai",
+		children: [
+			{
+				path: "ai.enabled",
+				name: "enabled",
+				type: "boolean",
+				description: "Enable or disable Ask AI."
+			},
+			{
+				path: "ai.model",
+				name: "model",
+				type: "string | AIModelConfig",
+				description: "Model ID or model routing config."
+			},
+			{
+				path: "ai.providers",
+				name: "providers",
+				type: "Record<string, AIProviderConfig>",
+				description: "Provider base URLs and optional API keys."
+			},
+			{
+				path: "ai.systemPrompt",
+				name: "systemPrompt",
+				type: "string",
+				description: "Additional instruction text for generated answers."
+			},
+			{
+				path: "ai.useMcp",
+				name: "useMcp",
+				type: "boolean | DocsAskAIMcpConfig",
+				description: "Use the built-in MCP search tool as Ask AI's retrieval provider."
+			}
+		]
+	},
+	{
+		path: "search",
+		name: "search",
+		type: "boolean | DocsSearchConfig",
+		default: true,
+		description: "Built-in simple search, Typesense, Algolia, MCP, or a custom adapter.",
+		docs: "/docs/customization/search",
+		children: [{
+			path: "search.provider",
+			name: "provider",
+			type: "\"simple\" | \"typesense\" | \"algolia\" | \"mcp\" | \"custom\"",
+			default: "simple",
+			description: "Search backend used by the docs UI and MCP search tool."
+		}, {
+			path: "search.maxResults",
+			name: "maxResults",
+			type: "number",
+			description: "Maximum result count returned by search requests."
+		}]
+	},
+	{
+		path: "llmsTxt",
+		name: "llmsTxt",
+		type: "boolean | LlmsTxtConfig",
+		default: true,
+		description: "Generated /llms.txt, /llms-full.txt, optional section files, and basePath-aware aliases.",
+		docs: "/docs/getting-started/agent-ready-docs"
+	},
+	{
+		path: "changelog",
+		name: "changelog",
+		type: "boolean | ChangelogConfig",
+		default: false,
+		description: "Generate changelog feed and entry pages from dated MDX entries.",
+		docs: "/docs/customization/changelog"
+	},
+	{
+		path: "mcp",
+		name: "mcp",
+		type: "boolean | DocsMcpConfig",
+		default: true,
+		description: "Built-in MCP server over stdio plus HTTP routes at /mcp and /.well-known/mcp, backed by /api/docs/mcp.",
+		docs: "/docs/customization/mcp",
+		children: [
+			{
+				path: "mcp.enabled",
+				name: "enabled",
+				type: "boolean",
+				default: true,
+				description: "Enable the built-in MCP server."
+			},
+			{
+				path: "mcp.route",
+				name: "route",
+				type: "string",
+				default: "/api/docs/mcp",
+				description: "Canonical Streamable HTTP route used by the MCP endpoint."
+			},
+			{
+				path: "mcp.name",
+				name: "name",
+				type: "string",
+				default: "nav.title or @farming-labs/docs",
+				description: "Human-readable MCP server name reported to clients."
+			},
+			{
+				path: "mcp.version",
+				name: "version",
+				type: "string",
+				default: "0.0.0",
+				description: "Version string reported to MCP clients."
+			},
+			{
+				path: "mcp.tools",
+				name: "tools",
+				type: "DocsMcpToolsConfig",
+				default: "all enabled",
+				description: "Fine-grained built-in MCP tool toggles.",
+				children: [
+					{
+						path: "mcp.tools.listPages",
+						name: "listPages",
+						type: "boolean",
+						default: true,
+						description: "Expose the list_pages tool."
+					},
+					{
+						path: "mcp.tools.getNavigation",
+						name: "getNavigation",
+						type: "boolean",
+						default: true,
+						description: "Expose the get_navigation tool."
+					},
+					{
+						path: "mcp.tools.searchDocs",
+						name: "searchDocs",
+						type: "boolean",
+						default: true,
+						description: "Expose the search_docs tool."
+					},
+					{
+						path: "mcp.tools.readPage",
+						name: "readPage",
+						type: "boolean",
+						default: true,
+						description: "Expose the read_page tool."
+					},
+					{
+						path: "mcp.tools.getCodeExamples",
+						name: "getCodeExamples",
+						type: "boolean",
+						default: true,
+						description: "Expose the get_code_examples tool."
+					},
+					{
+						path: "mcp.tools.getConfigSchema",
+						name: "getConfigSchema",
+						type: "boolean",
+						default: true,
+						description: "Expose the get_config_schema tool."
+					}
+				]
+			}
+		]
+	},
+	{
+		path: "apiReference",
+		name: "apiReference",
+		type: "boolean | ApiReferenceConfig",
+		default: false,
+		description: "Generated API reference pages from framework route conventions or a hosted OpenAPI document.",
+		docs: "/docs/customization/api-reference",
+		children: [{
+			path: "apiReference.specUrl",
+			name: "specUrl",
+			type: "string",
+			description: "Remote OpenAPI JSON URL when the backend owns the schema."
+		}, {
+			path: "apiReference.path",
+			name: "path",
+			type: "string",
+			description: "Docs route where the API reference is rendered."
+		}]
+	},
+	{
+		path: "sitemap",
+		name: "sitemap",
+		type: "boolean | DocsSitemapConfig",
+		default: true,
+		description: "Generated sitemap.xml, sitemap.md, and /.well-known/sitemap.md."
+	},
+	{
+		path: "robots",
+		name: "robots",
+		type: "boolean | DocsRobotsConfig",
+		default: true,
+		description: "Runtime or generated robots.txt policy for docs routes, agent-readable files, and AI crawler user agents."
+	},
+	{
+		path: "metadata",
+		name: "metadata",
+		type: "DocsMetadata",
+		description: "SEO and JSON-LD inputs such as titleTemplate and description."
+	},
+	{
+		path: "og",
+		name: "og",
+		type: "OGConfig",
+		description: "Dynamic Open Graph image configuration."
+	}
+];
+const DOCS_CONFIG_SCHEMA_EXAMPLES = [{
+	title: "Minimal config",
+	code: `import { defineDocs } from "@farming-labs/docs";
+import { fumadocs } from "@farming-labs/theme";
+
+export default defineDocs({
+  entry: "docs",
+  theme: fumadocs(),
+});`
+}, {
+	title: "MCP tool toggles",
+	code: `export default defineDocs({
+  entry: "docs",
+  mcp: {
+    tools: {
+      getConfigSchema: true,
+      getCodeExamples: true,
+    },
+  },
+});`
+}];
 const searchDocsInputSchema = z.object({
 	query: z.string().trim().min(1),
 	limit: z.number().int().min(1).max(25).optional(),
@@ -24,6 +422,20 @@ const readPageInputSchema = z.object({
 });
 const listPagesInputSchema = z.object({ locale: z.string().min(1).optional() });
 const getNavigationInputSchema = z.object({ locale: z.string().min(1).optional() });
+const getConfigSchemaInputSchema = z.object({
+	option: z.string().trim().min(1).optional(),
+	query: z.string().trim().min(1).optional()
+});
+const getCodeExamplesInputSchema = z.object({
+	query: z.string().trim().min(1).optional(),
+	path: z.string().min(1).optional(),
+	framework: z.string().trim().min(1).optional(),
+	packageManager: z.string().trim().min(1).optional(),
+	language: z.string().trim().min(1).optional(),
+	runnable: z.boolean().optional(),
+	limit: z.number().int().min(1).max(50).optional(),
+	locale: z.string().min(1).optional()
+});
 function normalizeDocsMcpRoute(route) {
 	if (!route || route.trim().length === 0) return DEFAULT_MCP_ROUTE;
 	const normalized = `/${route}`.replace(/\/+/g, "/");
@@ -39,7 +451,9 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			listPages: true,
 			readPage: true,
 			searchDocs: true,
-			getNavigation: true
+			getNavigation: true,
+			getCodeExamples: true,
+			getConfigSchema: true
 		}
 	};
 	const config = mcp && typeof mcp === "object" ? mcp : {};
@@ -52,7 +466,9 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			listPages: config.tools?.listPages ?? true,
 			readPage: config.tools?.readPage ?? true,
 			searchDocs: config.tools?.searchDocs ?? true,
-			getNavigation: config.tools?.getNavigation ?? true
+			getNavigation: config.tools?.getNavigation ?? true,
+			getCodeExamples: config.tools?.getCodeExamples ?? true,
+			getConfigSchema: config.tools?.getConfigSchema ?? true
 		}
 	};
 }
@@ -264,6 +680,82 @@ async function createDocsMcpServer(options) {
 			throw error;
 		}
 	});
+	if (resolved.tools.getConfigSchema) server.registerTool("get_config_schema", {
+		title: "Get docs config schema",
+		description: "Return structured docs.config.ts option metadata, optionally filtered by option path or query.",
+		inputSchema: getConfigSchemaInputSchema,
+		annotations: { readOnlyHint: true }
+	}, async ({ option, query }) => {
+		const startedAt = nowMs();
+		const trace = createDocsAgentTraceContext("mcp.tool.get_config_schema");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
+			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "get_config_schema",
+			startedAt: trace.startedAt,
+			status: "started",
+			inputPreview: {
+				option,
+				queryLength: query?.length
+			},
+			metadata: { tool: "get_config_schema" }
+		});
+		try {
+			const schema = getDocsConfigSchema({
+				option,
+				query
+			});
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				input: query ? { query } : void 0,
+				properties: {
+					tool: "get_config_schema",
+					option,
+					queryLength: query?.length,
+					resultCount: schema.resultCount,
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_config_schema",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				outputPreview: { resultCount: schema.resultCount },
+				metadata: { tool: "get_config_schema" }
+			});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(schema, null, 2)
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_config_schema",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "error",
+				outputPreview: { message: error instanceof Error ? error.message : "Unknown error" },
+				metadata: { tool: "get_config_schema" }
+			});
+			throw error;
+		}
+	});
 	if (resolved.tools.searchDocs) server.registerTool("search_docs", {
 		title: "Search documentation",
 		description: "Search the docs by keyword across titles, descriptions, and page content.",
@@ -350,6 +842,103 @@ async function createDocsMcpServer(options) {
 			throw error;
 		}
 	});
+	if (resolved.tools.getCodeExamples) server.registerTool("get_code_examples", {
+		title: "Get docs code examples",
+		description: "Return fenced code examples from the docs with parsed metadata such as title, framework, packageManager, and runnable.",
+		inputSchema: getCodeExamplesInputSchema,
+		annotations: { readOnlyHint: true }
+	}, async ({ query, path: requestedPath, framework, packageManager, language, runnable, limit, locale }) => {
+		const startedAt = nowMs();
+		const resolvedLimit = limit ?? 25;
+		const trace = createDocsAgentTraceContext("mcp.tool.get_code_examples");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
+			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "get_code_examples",
+			startedAt: trace.startedAt,
+			status: "started",
+			locale,
+			inputPreview: {
+				queryLength: query?.length,
+				path: requestedPath,
+				framework,
+				packageManager,
+				language,
+				runnable,
+				limit: resolvedLimit
+			},
+			metadata: { tool: "get_code_examples" }
+		});
+		try {
+			const pages = dedupePages(await options.source.getPages(locale));
+			const matchedPage = requestedPath ? findDocsPage(pages, requestedPath, options.source.entry) : null;
+			const examples = filterDocsCodeExamples((requestedPath ? matchedPage ? [matchedPage] : [] : pages).flatMap((page) => extractDocsMcpCodeExamples(page)), {
+				query,
+				framework,
+				packageManager,
+				language,
+				runnable,
+				limit: resolvedLimit
+			});
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				input: query ? { query } : void 0,
+				properties: {
+					tool: "get_code_examples",
+					queryLength: query?.length,
+					path: requestedPath,
+					framework,
+					packageManager,
+					language,
+					runnable,
+					limit: resolvedLimit,
+					resultCount: examples.length,
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_code_examples",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				outputPreview: { resultCount: examples.length },
+				metadata: { tool: "get_code_examples" }
+			});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify({ examples }, null, 2)
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_code_examples",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "error",
+				locale,
+				outputPreview: { message: error instanceof Error ? error.message : "Unknown error" },
+				metadata: { tool: "get_code_examples" }
+			});
+			throw error;
+		}
+	});
 	if (resolved.tools.readPage) server.registerTool("read_page", {
 		title: "Read a docs page",
 		description: "Read a documentation page by slug or URL path.",
@@ -880,6 +1469,71 @@ function toSearchSourcePages(pages) {
 		related: page.related
 	}));
 }
+function getDocsConfigSchema(filters) {
+	const option = filters.option?.trim();
+	const query = filters.query?.trim();
+	let options = DOCS_CONFIG_SCHEMA_OPTIONS.map(cloneConfigSchemaOption);
+	if (option) options = selectConfigSchemaOptions(option);
+	if (query) options = filterConfigSchemaOptionsByQuery(options, query);
+	return {
+		schemaVersion: 1,
+		configFile: "docs.config.ts",
+		description: "Configuration schema for @farming-labs/docs defineDocs(). Use option for an exact top-level or nested path, or query for keyword filtering.",
+		filters: option || query ? {
+			...option ? { option } : {},
+			...query ? { query } : {}
+		} : void 0,
+		resultCount: countConfigSchemaOptions(options),
+		options,
+		examples: DOCS_CONFIG_SCHEMA_EXAMPLES
+	};
+}
+function cloneConfigSchemaOption(option) {
+	return {
+		...option,
+		children: option.children?.map(cloneConfigSchemaOption)
+	};
+}
+function selectConfigSchemaOptions(optionPath) {
+	const needle = normalizeConfigSchemaToken(optionPath);
+	return flattenConfigSchemaOptions(DOCS_CONFIG_SCHEMA_OPTIONS).filter((option) => {
+		return normalizeConfigSchemaToken(option.path) === needle;
+	}).map(cloneConfigSchemaOption);
+}
+function filterConfigSchemaOptionsByQuery(options, query) {
+	return options.flatMap((option) => {
+		if (configSchemaOptionMatchesQuery(option, query)) return [cloneConfigSchemaOption(option)];
+		const children = option.children ? filterConfigSchemaOptionsByQuery(option.children, query) : [];
+		if (children.length === 0) return [];
+		return [{
+			...cloneConfigSchemaOption(option),
+			children
+		}];
+	});
+}
+function configSchemaOptionMatchesQuery(option, query) {
+	const searchText = [
+		option.path,
+		option.name,
+		option.type,
+		option.default,
+		option.description,
+		option.docs,
+		option.values?.join(" ")
+	].filter((value) => value !== void 0 && value !== null).join(" ");
+	const lowerSearchText = searchText.toLowerCase();
+	const lowerQuery = query.toLowerCase();
+	return lowerSearchText.includes(lowerQuery) || normalizeConfigSchemaToken(searchText).includes(normalizeConfigSchemaToken(query));
+}
+function flattenConfigSchemaOptions(options) {
+	return options.flatMap((option) => [option, ...option.children ? flattenConfigSchemaOptions(option.children) : []]);
+}
+function countConfigSchemaOptions(options) {
+	return flattenConfigSchemaOptions(options).length;
+}
+function normalizeConfigSchemaToken(value) {
+	return value.trim().toLowerCase().replace(/^docs\.config\.?/, "").replace(/[`'"]/g, "").replace(/[_\-\s]+/g, "");
+}
 function isSelfMcpSearchEndpoint(search, route) {
 	if (!search || search === true || typeof search !== "object" || search.provider !== "mcp") return false;
 	const endpoint = search.endpoint.trim();
@@ -905,6 +1559,123 @@ function toPageSummaries(pages) {
 		icon: page.icon
 	}));
 }
+function extractDocsMcpCodeExamples(page) {
+	const source = page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent;
+	if (!source) return [];
+	const examples = [];
+	const lines = source.split("\n");
+	let index = 0;
+	let openFence = null;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!openFence) {
+			const openMatch = trimmed.match(/^(`{3,}|~{3,})(.*)$/);
+			if (!openMatch) continue;
+			openFence = {
+				marker: openMatch[1],
+				info: openMatch[2]?.trim() ?? "",
+				code: []
+			};
+			continue;
+		}
+		if (isClosingFence(trimmed, openFence.marker)) {
+			const parsed = parseCodeFenceInfo(openFence.info);
+			const meta = parsed.meta;
+			const title = readStringMeta(meta, "title");
+			const framework = readStringMeta(meta, "framework");
+			const packageManager = readStringMeta(meta, "packageManager");
+			const runnable = readBooleanMeta(meta, "runnable") ?? false;
+			index += 1;
+			examples.push({
+				id: `${page.url}#code-${index}`,
+				page: {
+					slug: page.slug,
+					url: page.url,
+					title: page.title,
+					description: page.description,
+					sourcePath: page.sourcePath,
+					lastModified: page.lastModified
+				},
+				language: parsed.language,
+				title,
+				framework,
+				packageManager,
+				runnable,
+				meta,
+				code: openFence.code.join("\n")
+			});
+			openFence = null;
+			continue;
+		}
+		openFence.code.push(line);
+	}
+	return examples;
+}
+function filterDocsCodeExamples(examples, filters) {
+	const query = filters.query?.toLowerCase();
+	const framework = filters.framework?.toLowerCase();
+	const packageManager = filters.packageManager?.toLowerCase();
+	const language = filters.language?.toLowerCase();
+	return examples.filter((example) => {
+		if (framework && example.framework?.toLowerCase() !== framework) return false;
+		if (packageManager && example.packageManager?.toLowerCase() !== packageManager) return false;
+		if (language && example.language?.toLowerCase() !== language) return false;
+		if (filters.runnable !== void 0 && example.runnable !== filters.runnable) return false;
+		if (!query) return true;
+		return getCodeExampleSearchText(example).toLowerCase().includes(query);
+	}).slice(0, filters.limit);
+}
+function isClosingFence(trimmedLine, marker) {
+	if (!trimmedLine.startsWith(marker)) return false;
+	return trimmedLine.slice(marker.length).trim().length === 0;
+}
+function parseCodeFenceInfo(info) {
+	const trimmed = info.trim();
+	if (!trimmed) return { meta: {} };
+	const firstToken = trimmed.match(/^(\S+)/)?.[1] ?? "";
+	const language = firstToken && !firstToken.includes("=") ? firstToken : void 0;
+	const attributeSource = language ? trimmed.slice(firstToken.length).trim() : trimmed;
+	const meta = {};
+	const attributePattern = /([A-Za-z_:][\w:.-]*)(?:=(?:"([^"]*)"|'([^']*)'|([^\s"']+)))?/g;
+	let match;
+	while (match = attributePattern.exec(attributeSource)) {
+		const key = match[1];
+		meta[key] = match[2] ?? match[3] ?? match[4] ?? true;
+	}
+	return {
+		language,
+		meta
+	};
+}
+function readStringMeta(meta, key) {
+	const value = meta[key];
+	return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+function readBooleanMeta(meta, key) {
+	const value = meta[key];
+	if (typeof value === "boolean") return value;
+	if (typeof value !== "string") return void 0;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized || normalized === "true" || normalized === "1" || normalized === "yes") return true;
+	if (normalized === "false" || normalized === "0" || normalized === "no") return false;
+	return true;
+}
+function getCodeExampleSearchText(example) {
+	return [
+		example.id,
+		example.page.slug,
+		example.page.url,
+		example.page.title,
+		example.page.description,
+		example.page.sourcePath,
+		example.language,
+		example.title,
+		example.framework,
+		example.packageManager,
+		...Object.entries(example.meta).map(([key, value]) => `${key} ${String(value)}`),
+		example.code
+	].filter((value) => typeof value === "string").join("\n");
+}
 function findDocsPage(pages, requestedPath, entry) {
 	const normalizedRequest = normalizeRequestedPath(requestedPath, entry);
 	for (const page of pages) if (normalizeUrlPath(page.url) === normalizedRequest) return page;

package/dist/{search-DjVbXEmb.d.mts → search-Dlwp88qb.d.mts}

@@ -1,4 +1,4 @@
-import { B as DocsObservabilityEventInput, Et as ResolvedDocsRelatedLink, It as TypesenseDocsSearchConfig, J as DocsSearchConfig, K as DocsSearchAdapterFactory, Q as DocsSearchResult, R as DocsObservabilityConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, _ as DocsAnalyticsConfig, _t as OpenDocsTarget, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-Zk0mIMGI.mjs";
+import { B as DocsObservabilityEventInput, Et as ResolvedDocsRelatedLink, It as TypesenseDocsSearchConfig, J as DocsSearchConfig, K as DocsSearchAdapterFactory, Q as DocsSearchResult, R as DocsObservabilityConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, _ as DocsAnalyticsConfig, _t as OpenDocsTarget, d as CustomDocsSearchConfig, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, mt as OpenDocsProvider, q as DocsSearchChunkingConfig, r as AlgoliaDocsSearchConfig, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-D-cNOo-t.mjs";
 
 //#region src/cloud-analytics.d.ts
 interface DocsCloudAnalyticsOptions {

package/dist/server.d.mts

@@ -1,6 +1,6 @@
-import { A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, G as DocsSearchAdapterContext, J as DocsSearchConfig, K as DocsSearchAdapterFactory, O as DocsAskAIFeedbackValue, Q as DocsSearchResult, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-Zk0mIMGI.mjs";
-import { $ as emitDocsAgentTraceEvent, A as toDocsSitemapMarkdownUrl, B as parsePromptStringArray, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as PromptAction, G as serializeOpenDocsProvider, H as sanitizePromptText, I as PromptProviderChoice, J as DocsAgentTraceContext, K as serializeOpenDocsProviders, L as SerializeOpenDocsProviderOptions, M as DEFAULT_OPEN_DOCS_PROVIDER_IDS, N as DEFAULT_OPEN_DOCS_TARGET, O as resolveDocsSitemapPageLastmod, P as DEFAULT_PROMPT_PROVIDER_TEMPLATES, Q as createDocsAgentTraceId, R as SerializedOpenDocsProvider, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as serializeDocsIcon, V as resolvePromptProviderChoices, W as serializeDocsIconRegistry, X as ResolvedDocsObservabilityConfig, Y as ResolvedDocsAnalyticsConfig, Z as createDocsAgentTraceContext, _ as DocsSitemapFormat, a as createMcpSearchAdapter, at as createDocsCloudAnalytics, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAnalyticsEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, it as DocsCloudAnalyticsOptions, j as DEFAULT_OPEN_DOCS_PROMPT, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, nt as resolveDocsAnalyticsConfig, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as DOCS_AGENT_TRACE_EVENT_TYPES, r as createAlgoliaSearchAdapter, rt as resolveDocsObservabilityConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsObservabilityEvent, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as normalizePromptProviderName } from "./search-DjVbXEmb.mjs";
-import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
+import { A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, G as DocsSearchAdapterContext, J as DocsSearchConfig, K as DocsSearchAdapterFactory, O as DocsAskAIFeedbackValue, Q as DocsSearchResult, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, W as DocsSearchAdapter, Y as DocsSearchDocument, Z as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, dt as McpDocsSearchConfig, et as DocsSearchSourcePage, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, tt as DocsSitemapConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-D-cNOo-t.mjs";
+import { $ as emitDocsAgentTraceEvent, A as toDocsSitemapMarkdownUrl, B as parsePromptStringArray, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as PromptAction, G as serializeOpenDocsProvider, H as sanitizePromptText, I as PromptProviderChoice, J as DocsAgentTraceContext, K as serializeOpenDocsProviders, L as SerializeOpenDocsProviderOptions, M as DEFAULT_OPEN_DOCS_PROVIDER_IDS, N as DEFAULT_OPEN_DOCS_TARGET, O as resolveDocsSitemapPageLastmod, P as DEFAULT_PROMPT_PROVIDER_TEMPLATES, Q as createDocsAgentTraceId, R as SerializedOpenDocsProvider, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, U as serializeDocsIcon, V as resolvePromptProviderChoices, W as serializeDocsIconRegistry, X as ResolvedDocsObservabilityConfig, Y as ResolvedDocsAnalyticsConfig, Z as createDocsAgentTraceContext, _ as DocsSitemapFormat, a as createMcpSearchAdapter, at as createDocsCloudAnalytics, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAnalyticsEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, it as DocsCloudAnalyticsOptions, j as DEFAULT_OPEN_DOCS_PROMPT, k as resolveDocsSitemapRequest, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, nt as resolveDocsAnalyticsConfig, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as DOCS_AGENT_TRACE_EVENT_TYPES, r as createAlgoliaSearchAdapter, rt as resolveDocsObservabilityConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsObservabilityEvent, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as normalizePromptProviderName } from "./search-Dlwp88qb.mjs";
+import { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
@@ -55,4 +55,4 @@ declare function buildApiReferenceHtmlDocumentAsync(config: DocsConfig, options:
 //#region src/sitemap-server.d.ts
 declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, 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 DocsCloudAnalyticsOptions, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
+export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, 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 DocsCloudAnalyticsOptions, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/{types-Zk0mIMGI.d.mts → types-D-cNOo-t.d.mts}

@@ -987,6 +987,10 @@ interface DocsMcpToolsConfig {
   searchDocs?: boolean;
   /** Expose a `get_navigation` tool for the docs tree. */
   getNavigation?: boolean;
+  /** Expose a `get_code_examples` tool for fenced code blocks and their metadata. */
+  getCodeExamples?: boolean;
+  /** Expose a `get_config_schema` tool for docs.config option metadata. */
+  getConfigSchema?: boolean;
 }
 /**
  * Built-in MCP server configuration.

package/package.json

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