@farming-labs/docs 0.1.116 → 0.1.118

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-aGYzIAb_.mjs");
+		const { runMcp } = await import("../mcp-BMgH1Q33.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-Cey7sqh9.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CU4knIej.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();

package/dist/{doctor-Cey7sqh9.mjs → doctor-CU4knIej.mjs}

@@ -952,11 +952,13 @@ async function probeMcpRoute(baseUrl, route) {
 		const tools = toolsPayload.result?.tools;
 		const toolNames = Array.isArray(tools) ? tools.map((tool) => tool.name).filter((name) => typeof name === "string") : [];
 		const missingTools = [
+			"list_docs",
 			"list_pages",
 			"get_navigation",
 			"search_docs",
 			"read_page",
-			"get_code_examples"
+			"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-qqx8SjH4.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-DYPyHTz_.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-Dts3a32G.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-Dqu1Q27e.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts
@@ -597,11 +597,13 @@ declare function buildDocsAgentDiscoverySpec({
     name: string;
     version: string;
     tools: {
+      listDocs: boolean;
       listPages: boolean;
       readPage: boolean;
       searchDocs: boolean;
       getNavigation: boolean;
       getCodeExamples: boolean;
+      getConfigSchema: boolean;
     };
   };
   feedback: {

package/dist/{mcp-aGYzIAb_.mjs → mcp-BMgH1Q33.mjs}

@@ -35,11 +35,13 @@ function readMcpConfig(content) {
 		name: readStringProperty(block, "name"),
 		version: readStringProperty(block, "version"),
 		tools: {
+			listDocs: readBooleanProperty(block, "listDocs"),
 			listPages: readBooleanProperty(block, "listPages"),
 			readPage: readBooleanProperty(block, "readPage"),
 			searchDocs: readBooleanProperty(block, "searchDocs"),
 			getNavigation: readBooleanProperty(block, "getNavigation"),
-			getCodeExamples: readBooleanProperty(block, "getCodeExamples")
+			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-qqx8SjH4.mjs";
+import { J as DocsSearchConfig, P as DocsMcpConfig, R as DocsObservabilityConfig, _ as DocsAnalyticsConfig, et as DocsSearchSourcePage, yt as OrderingItem } from "./types-Dts3a32G.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -36,6 +36,58 @@ interface DocsMcpCodeExample {
   meta: Record<string, string | boolean>;
   code: string;
 }
+interface DocsMcpDocsPageSummary {
+  slug: string;
+  url: string;
+  title: string;
+  description?: string;
+  icon?: string;
+  sourcePath?: string;
+  lastModified?: string;
+}
+interface DocsMcpDocsSection {
+  slug: string;
+  title: string;
+  url?: string;
+  description?: string;
+  icon?: string;
+  pageCount: number;
+  pages: DocsMcpDocsPageSummary[];
+  sections: DocsMcpDocsSection[];
+}
+interface DocsMcpDocsList {
+  section?: string;
+  resultCount: number;
+  sectionCount: number;
+  pages: DocsMcpDocsPageSummary[];
+  rootPages: DocsMcpDocsPageSummary[];
+  sections: DocsMcpDocsSection[];
+}
+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;
@@ -67,11 +119,13 @@ interface DocsMcpResolvedConfig {
   name: string;
   version: string;
   tools: {
+    listDocs: boolean;
     listPages: boolean;
     readPage: boolean;
     searchDocs: boolean;
     getNavigation: boolean;
     getCodeExamples: boolean;
+    getConfigSchema: boolean;
   };
 }
 interface DocsMcpHttpHandlers {
@@ -112,4 +166,4 @@ declare function createDocsMcpServer(options: CreateDocsMcpServerOptions): Promi
 declare function createDocsMcpHttpHandler(options: CreateDocsMcpServerOptions): DocsMcpHttpHandlers;
 declare function runDocsMcpStdio(options: CreateDocsMcpServerOptions): Promise<void>;
 //#endregion
-export { DocsMcpCodeExample, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+export { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };

package/dist/mcp.mjs

@@ -13,6 +13,412 @@ 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.listDocs",
+						name: "listDocs",
+						type: "boolean",
+						default: true,
+						description: "Expose the list_docs tool."
+					},
+					{
+						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: {
+      listDocs: true,
+      getConfigSchema: true,
+      getCodeExamples: true,
+    },
+  },
+});`
+}];
 const searchDocsInputSchema = z.object({
 	query: z.string().trim().min(1),
 	limit: z.number().int().min(1).max(25).optional(),
@@ -23,7 +429,15 @@ const readPageInputSchema = z.object({
 	locale: z.string().min(1).optional()
 });
 const listPagesInputSchema = z.object({ locale: z.string().min(1).optional() });
+const listDocsInputSchema = z.object({
+	section: z.string().trim().min(1).optional(),
+	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(),
@@ -46,11 +460,13 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 		name: defaults.defaultName ?? DEFAULT_MCP_NAME,
 		version: defaults.defaultVersion ?? DEFAULT_MCP_VERSION,
 		tools: {
+			listDocs: true,
 			listPages: true,
 			readPage: true,
 			searchDocs: true,
 			getNavigation: true,
-			getCodeExamples: true
+			getCodeExamples: true,
+			getConfigSchema: true
 		}
 	};
 	const config = mcp && typeof mcp === "object" ? mcp : {};
@@ -60,11 +476,13 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 		name: config.name ?? defaults.defaultName ?? DEFAULT_MCP_NAME,
 		version: config.version ?? defaults.defaultVersion ?? DEFAULT_MCP_VERSION,
 		tools: {
+			listDocs: config.tools?.listDocs ?? true,
 			listPages: config.tools?.listPages ?? true,
 			readPage: config.tools?.readPage ?? true,
 			searchDocs: config.tools?.searchDocs ?? true,
 			getNavigation: config.tools?.getNavigation ?? true,
-			getCodeExamples: config.tools?.getCodeExamples ?? true
+			getCodeExamples: config.tools?.getCodeExamples ?? true,
+			getConfigSchema: config.tools?.getConfigSchema ?? true
 		}
 	};
 }
@@ -206,6 +624,88 @@ async function createDocsMcpServer(options) {
 			throw error;
 		}
 	});
+	if (resolved.tools.listDocs) server.registerTool("list_docs", {
+		title: "List docs by section",
+		description: "List documentation pages grouped by section, optionally narrowed to one section.",
+		inputSchema: listDocsInputSchema,
+		annotations: { readOnlyHint: true }
+	}, async ({ section, locale }) => {
+		const startedAt = nowMs();
+		const trace = createDocsAgentTraceContext("mcp.tool.list_docs");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
+			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "list_docs",
+			startedAt: trace.startedAt,
+			status: "started",
+			locale,
+			inputPreview: {
+				section,
+				locale
+			},
+			metadata: { tool: "list_docs" }
+		});
+		try {
+			const docs = listDocsBySection(dedupePages(await options.source.getPages(locale)), {
+				section,
+				entry: options.source.entry
+			});
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				properties: {
+					tool: "list_docs",
+					section,
+					resultCount: docs.resultCount,
+					sectionCount: docs.sectionCount,
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "list_docs",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				outputPreview: {
+					resultCount: docs.resultCount,
+					sectionCount: docs.sectionCount
+				},
+				metadata: { tool: "list_docs" }
+			});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(docs, null, 2)
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "list_docs",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "error",
+				locale,
+				outputPreview: { message: error instanceof Error ? error.message : "Unknown error" },
+				metadata: { tool: "list_docs" }
+			});
+			throw error;
+		}
+	});
 	if (resolved.tools.getNavigation) server.registerTool("get_navigation", {
 		title: "Get docs navigation",
 		description: "Return the documentation navigation tree for the current docs site.",
@@ -276,6 +776,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.",
@@ -989,6 +1565,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();
@@ -1014,6 +1655,190 @@ function toPageSummaries(pages) {
 		icon: page.icon
 	}));
 }
+function toDocsListPageSummary(page) {
+	return {
+		slug: page.slug,
+		url: page.url,
+		title: page.title,
+		description: page.description,
+		icon: page.icon,
+		sourcePath: page.sourcePath,
+		lastModified: page.lastModified
+	};
+}
+function listDocsBySection(pages, filters) {
+	const allPages = pages.map(toDocsListPageSummary);
+	const tree = buildDocsSectionTree(pages);
+	const requestedSection = filters.section?.trim();
+	if (!requestedSection) return {
+		resultCount: allPages.length,
+		sectionCount: countDocsSections(tree.sections),
+		pages: allPages,
+		rootPages: tree.rootPages,
+		sections: tree.sections
+	};
+	const section = findDocsSection(tree.sections, requestedSection, filters.entry);
+	if (section) {
+		const sections = [cloneDocsSection(section)];
+		const matchedPages = flattenDocsSectionPages(sections[0]);
+		return {
+			section: requestedSection,
+			resultCount: matchedPages.length,
+			sectionCount: countDocsSections(sections),
+			pages: matchedPages,
+			rootPages: [],
+			sections
+		};
+	}
+	const page = allPages.find((candidate) => docsListPageMatches(candidate, requestedSection, filters.entry));
+	if (page) return {
+		section: requestedSection,
+		resultCount: 1,
+		sectionCount: 0,
+		pages: [page],
+		rootPages: [page],
+		sections: []
+	};
+	return {
+		section: requestedSection,
+		resultCount: 0,
+		sectionCount: 0,
+		pages: [],
+		rootPages: [],
+		sections: []
+	};
+}
+function buildDocsSectionTree(pages) {
+	const sectionSlugs = /* @__PURE__ */ new Set();
+	for (const page of pages) {
+		const parts = page.slug.split("/").filter(Boolean);
+		for (let index = 1; index < parts.length; index += 1) sectionSlugs.add(parts.slice(0, index).join("/"));
+	}
+	const rootPages = [];
+	const sections = [];
+	const sectionBySlug = /* @__PURE__ */ new Map();
+	function getOrCreateSection(slug) {
+		const existing = sectionBySlug.get(slug);
+		if (existing) return existing;
+		const parts = slug.split("/").filter(Boolean);
+		const section = {
+			slug,
+			title: titleize(parts.at(-1) ?? slug),
+			pageCount: 0,
+			pages: [],
+			sections: []
+		};
+		sectionBySlug.set(slug, section);
+		if (parts.length <= 1) sections.push(section);
+		else getOrCreateSection(parts.slice(0, -1).join("/")).sections.push(section);
+		return section;
+	}
+	for (const page of pages) {
+		const summary = toDocsListPageSummary(page);
+		const parts = page.slug.split("/").filter(Boolean);
+		if (parts.length === 0) {
+			rootPages.push(summary);
+			continue;
+		}
+		const isSectionIndex = sectionSlugs.has(page.slug);
+		if (parts.length === 1 && !isSectionIndex) {
+			rootPages.push(summary);
+			continue;
+		}
+		if (isSectionIndex) {
+			const section = getOrCreateSection(page.slug);
+			hydrateDocsSection(section, summary);
+			pushUniqueDocsPage(section.pages, summary, "start");
+			continue;
+		}
+		pushUniqueDocsPage(getOrCreateSection(parts.slice(0, -1).join("/")).pages, summary, "end");
+	}
+	updateDocsSectionPageCounts(sections);
+	return {
+		rootPages,
+		sections
+	};
+}
+function hydrateDocsSection(section, page) {
+	section.title = page.title;
+	section.url = page.url;
+	section.description = page.description;
+	section.icon = page.icon;
+}
+function pushUniqueDocsPage(pages, page, position) {
+	if (pages.some((candidate) => candidate.url === page.url)) return;
+	if (position === "start") {
+		pages.unshift(page);
+		return;
+	}
+	pages.push(page);
+}
+function updateDocsSectionPageCounts(sections) {
+	let total = 0;
+	for (const section of sections) {
+		section.pageCount = section.pages.length + updateDocsSectionPageCounts(section.sections);
+		total += section.pageCount;
+	}
+	return total;
+}
+function findDocsSection(sections, section, entry) {
+	for (const candidate of sections) {
+		if (docsListSectionMatches(candidate, section, entry)) return candidate;
+		const child = findDocsSection(candidate.sections, section, entry);
+		if (child) return child;
+	}
+}
+function docsListSectionMatches(section, value, entry) {
+	return docsListCandidates(section, entry).includes(normalizeDocsListMatchValue(value));
+}
+function docsListPageMatches(page, value, entry) {
+	return docsListCandidates(page, entry).includes(normalizeDocsListMatchValue(value));
+}
+function docsListCandidates(value, entry) {
+	return [
+		value.slug,
+		value.url,
+		value.title,
+		value.url ? stripDocsEntryFromPath(value.url, entry) : void 0,
+		stripDocsEntryFromPath(value.slug, entry)
+	].filter((candidate) => Boolean(candidate)).map(normalizeDocsListMatchValue);
+}
+function stripDocsEntryFromPath(value, entry) {
+	const normalized = normalizePathSegment(value.replace(/\.md$/i, ""));
+	const normalizedEntry = normalizePathSegment(entry ?? "");
+	if (!normalizedEntry) return normalized;
+	if (normalized === normalizedEntry) return "";
+	if (normalized.startsWith(`${normalizedEntry}/`)) return normalized.slice(normalizedEntry.length + 1);
+	return normalized;
+}
+function normalizeDocsListMatchValue(value) {
+	return normalizePathSegment(value.replace(/^https?:\/\/[^/]+/i, "").replace(/\.md$/i, "")).trim().toLowerCase().replace(/\s+/g, "-").replace(/_+/g, "-").replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "");
+}
+function cloneDocsSection(section) {
+	return {
+		...section,
+		pages: section.pages.map((page) => ({ ...page })),
+		sections: section.sections.map(cloneDocsSection)
+	};
+}
+function flattenDocsSectionPages(section) {
+	const seen = /* @__PURE__ */ new Set();
+	const pages = [];
+	function add(page) {
+		if (seen.has(page.url)) return;
+		seen.add(page.url);
+		pages.push({ ...page });
+	}
+	function visit(current) {
+		current.pages.forEach(add);
+		current.sections.forEach(visit);
+	}
+	visit(section);
+	return pages;
+}
+function countDocsSections(sections) {
+	return sections.reduce((total, section) => total + 1 + countDocsSections(section.sections), 0);
+}
 function extractDocsMcpCodeExamples(page) {
 	const source = page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent;
 	if (!source) return [];

package/dist/{search-DYPyHTz_.d.mts → search-Dqu1Q27e.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-qqx8SjH4.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-Dts3a32G.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-qqx8SjH4.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-DYPyHTz_.mjs";
-import { DocsMcpCodeExample, 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-Dts3a32G.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-Dqu1Q27e.mjs";
+import { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, 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 DocsMcpCodeExample, 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 DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, 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-qqx8SjH4.d.mts → types-Dts3a32G.d.mts}

@@ -979,6 +979,8 @@ interface DocsRobotsConfig {
  * All tools default to `true` when omitted.
  */
 interface DocsMcpToolsConfig {
+  /** Expose a `list_docs` tool that returns docs pages grouped by section. */
+  listDocs?: boolean;
   /** Expose a `list_pages` tool that returns the known docs pages. */
   listPages?: boolean;
   /** Expose a `read_page` tool that returns a page by slug or URL path. */
@@ -989,6 +991,8 @@ interface DocsMcpToolsConfig {
   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.116",
+  "version": "0.1.118",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",