@farming-labs/docs 0.1.70 → 0.1.72

package/dist/{agent-BMOtZLMC.mjs → agent-D87B57Wv.mjs}

@@ -1,4 +1,4 @@
-import { _ as renderDocsRelatedMarkdownLines } from "./search-BhXicuww.mjs";
+import { x as renderDocsRelatedMarkdownLines } from "./search-Bk7rg-AY.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts
@@ -18,6 +18,7 @@ function defineDocs(config) {
 		sidebar: config.sidebar,
 		components: config.components,
 		analytics: config.analytics,
+		observability: config.observability,
 		onCopyClick: config.onCopyClick,
 		feedback: config.feedback,
 		search: config.search,
@@ -309,78 +310,6 @@ function resolveReadingTimeFromSource(source, wordsPerMinute) {
 	return resolveReadingTimeFromContent(data, content, wordsPerMinute);
 }
 
-//#endregion
-//#region src/sidebar.ts
-function resolvePageSidebarFolderIndexBehavior(sidebar) {
-	if (!sidebar || typeof sidebar !== "object") return void 0;
-	const value = sidebar.folderIndexBehavior;
-	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
-}
-function normalizeSidebarFolderBehaviorPath(path) {
-	if (!path) return void 0;
-	let value = path.trim();
-	if (!value) return void 0;
-	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
-		value = new URL(value).pathname;
-	} catch {
-		return;
-	}
-	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
-	if (!value.startsWith("/")) value = `/${value}`;
-	return value.replace(/\/$/, "") || "/";
-}
-function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
-	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
-	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
-	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
-	if (sidebar.folderIndexBehavior === "link") return "link";
-	return defaultBehavior;
-}
-function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
-	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
-	if (!sidebar || typeof sidebar !== "object") return fallback;
-	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
-	if (!normalizedPath) return fallback;
-	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
-	return fallback;
-}
-function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
-	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
-	function mapNode(node) {
-		if (!node || typeof node !== "object") return node;
-		const candidate = node;
-		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
-		const children = candidate.children.map(mapNode);
-		const index = candidate.index ? mapNode(candidate.index) : void 0;
-		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
-		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
-		if (behavior === "link") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index,
-			children
-		};
-		if (behavior === "hidden") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children
-		};
-		return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children: index ? [index, ...children] : children
-		};
-	}
-	return {
-		...tree,
-		children: tree.children.map(mapNode)
-	};
-}
-
 //#endregion
 //#region src/agent.ts
 const DEFAULT_DOCS_API_ROUTE = "/api/docs";
@@ -700,4 +629,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { resolvePageSidebarFolderIndexBehavior as A, resolveOGImage as B, renderDocsMarkdownDocument as C, resolveDocsMarkdownRequest as D, resolveDocsLlmsTxtFormat as E, resolveReadingTimeFromContent as F, createTheme as G, resolveDocsI18n as H, resolveReadingTimeFromSource as I, resolveChangelogConfig as J, extendTheme as K, resolveReadingTimeOptions as L, resolveSidebarFolderIndexBehaviorForPath as M, estimateReadingTimeMinutes as N, resolveDocsSkillFormat as O, resolvePageReadingTime as P, buildPageOpenGraph as R, normalizeDocsUrlPath as S, resolveDocsAgentMdxContent as T, resolveDocsLocale as U, resolveTitle as V, resolveDocsPath as W, defineDocs as Y, isDocsAgentDiscoveryRequest as _, DEFAULT_DOCS_API_ROUTE as a, isDocsSkillRequest as b, DEFAULT_LLMS_TXT_ROUTE as c, DEFAULT_MCP_ROUTE as d, DEFAULT_MCP_WELL_KNOWN_ROUTE as f, findDocsMarkdownPage as g, buildDocsAgentDiscoverySpec as h, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as i, resolveSidebarFolderIndexBehavior as j, applySidebarFolderIndexBehavior as k, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as l, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as m, DEFAULT_AGENT_SPEC_ROUTE as n, DEFAULT_LLMS_FULL_TXT_ROUTE as o, DEFAULT_SKILL_MD_ROUTE as p, deepMerge as q, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as r, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as s, DEFAULT_AGENT_FEEDBACK_ROUTE as t, DEFAULT_MCP_PUBLIC_ROUTE as u, isDocsMcpRequest as v, renderDocsSkillDocument as w, normalizeDocsPathSegment as x, isDocsPublicGetRequest as y, buildPageTwitter as z };
+export { resolvePageReadingTime as A, resolveDocsPath as B, renderDocsMarkdownDocument as C, resolveDocsMarkdownRequest as D, resolveDocsLlmsTxtFormat as E, buildPageTwitter as F, defineDocs as G, extendTheme as H, resolveOGImage as I, resolveTitle as L, resolveReadingTimeFromSource as M, resolveReadingTimeOptions as N, resolveDocsSkillFormat as O, buildPageOpenGraph as P, resolveDocsI18n as R, normalizeDocsUrlPath as S, resolveDocsAgentMdxContent as T, deepMerge as U, createTheme as V, resolveChangelogConfig as W, isDocsAgentDiscoveryRequest as _, DEFAULT_DOCS_API_ROUTE as a, isDocsSkillRequest as b, DEFAULT_LLMS_TXT_ROUTE as c, DEFAULT_MCP_ROUTE as d, DEFAULT_MCP_WELL_KNOWN_ROUTE as f, findDocsMarkdownPage as g, buildDocsAgentDiscoverySpec as h, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as i, resolveReadingTimeFromContent as j, estimateReadingTimeMinutes as k, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as l, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as m, DEFAULT_AGENT_SPEC_ROUTE as n, DEFAULT_LLMS_FULL_TXT_ROUTE as o, DEFAULT_SKILL_MD_ROUTE as p, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as r, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as s, DEFAULT_AGENT_FEEDBACK_ROUTE as t, DEFAULT_MCP_PUBLIC_ROUTE as u, isDocsMcpRequest as v, renderDocsSkillDocument as w, normalizeDocsPathSegment as x, isDocsPublicGetRequest as y, resolveDocsLocale as z };

package/dist/{agent-Pbf5iqr6.mjs → agent-beh4aVYP.mjs}

@@ -1,5 +1,5 @@
-import { C as renderDocsMarkdownDocument, g as findDocsMarkdownPage } from "./agent-BMOtZLMC.mjs";
-import { d as hashGeneratedAgentContent, m as serializeGeneratedAgentDocument, p as parseGeneratedAgentDocument, u as GENERATED_AGENT_PROVENANCE_VERSION } from "./search-BhXicuww.mjs";
+import { C as renderDocsMarkdownDocument, g as findDocsMarkdownPage } from "./agent-D87B57Wv.mjs";
+import { d as hashGeneratedAgentContent, m as serializeGeneratedAgentDocument, p as parseGeneratedAgentDocument, u as GENERATED_AGENT_PROVENANCE_VERSION } from "./search-Bk7rg-AY.mjs";
 import "./index.mjs";
 import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";

package/dist/cli/index.mjs

@@ -83,10 +83,10 @@ async function main() {
 		const { dev } = await import("../dev-BQIDeAoL.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-vNQt0NUC.mjs");
+		const { runMcp } = await import("../mcp-obMYAPqu.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-Pbf5iqr6.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-beh4aVYP.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,11 +96,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-Pbf5iqr6.mjs");
+		const { printAgentCompactHelp } = await import("../agent-beh4aVYP.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CndGrKwy.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BUI3LchV.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -108,7 +108,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-DcXwu_8y.mjs");
+		const { syncSearch } = await import("../search-BzMf2w0H.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));

package/dist/{doctor-CndGrKwy.mjs → doctor-BUI3LchV.mjs}

@@ -1,10 +1,10 @@
-import { c as DEFAULT_LLMS_TXT_ROUTE, f as DEFAULT_MCP_WELL_KNOWN_ROUTE, i as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, o as DEFAULT_LLMS_FULL_TXT_ROUTE, p as DEFAULT_SKILL_MD_ROUTE, r as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, t as DEFAULT_AGENT_FEEDBACK_ROUTE, u as DEFAULT_MCP_PUBLIC_ROUTE } from "./agent-BMOtZLMC.mjs";
-import "./search-BhXicuww.mjs";
+import { c as DEFAULT_LLMS_TXT_ROUTE, f as DEFAULT_MCP_WELL_KNOWN_ROUTE, i as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, o as DEFAULT_LLMS_FULL_TXT_ROUTE, p as DEFAULT_SKILL_MD_ROUTE, r as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, t as DEFAULT_AGENT_FEEDBACK_ROUTE, u as DEFAULT_MCP_PUBLIC_ROUTE } from "./agent-D87B57Wv.mjs";
+import "./search-Bk7rg-AY.mjs";
 import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Si-yUfM_.mjs";
-import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-Pbf5iqr6.mjs";
+import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-beh4aVYP.mjs";
 import { t as detectFramework } from "./utils-DSMXVnEu.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as PageFrontmatter, A as DocsSearchAdapterContext, B as DocsTheme, C as DocsI18nConfig, D as DocsNav, E as DocsMetadata, F as DocsSearchEmbeddingsConfig, G as LlmsTxtConfig, H as FontStyle, I as DocsSearchQuery, J as OpenDocsConfig, K as McpDocsSearchConfig, L as DocsSearchResult, M as DocsSearchChunkingConfig, N as DocsSearchConfig, O as DocsRelatedItem, P as DocsSearchDocument, Q as PageActionsConfig, R as DocsSearchResultType, S as DocsFeedbackValue, T as DocsMcpToolsConfig, U as GithubConfig, V as FeedbackConfig, W as LastUpdatedConfig, X as OpenGraphImage, Y as OpenDocsProvider, Z as OrderingItem, _ as DocsAnalyticsEventType, a as ApiReferenceRenderer, at as SidebarComponentProps, b as DocsConfig, c as ChangelogFrontmatter, ct as SidebarFolderNode, d as CustomDocsSearchConfig, dt as SidebarTree, et as PageOpenGraph, f as DocsAgentFeedbackContext, ft as SimpleDocsSearchConfig, g as DocsAnalyticsEventInput, gt as UIConfig, h as DocsAnalyticsEvent, ht as TypographyConfig, i as ApiReferenceConfig, it as ResolvedDocsRelatedLink, j as DocsSearchAdapterFactory, k as DocsSearchAdapter, l as CodeBlockCopyData, lt as SidebarNode, m as DocsAnalyticsConfig, mt as TypesenseDocsSearchConfig, n as AgentFeedbackConfig, nt as PageTwitter, o as BreadcrumbConfig, ot as SidebarConfig, p as DocsAgentFeedbackData, pt as ThemeToggleConfig, q as OGConfig, r as AlgoliaDocsSearchConfig, rt as ReadingTimeConfig, s as ChangelogConfig, st as SidebarFolderIndexBehavior, t as AIConfig, tt as PageSidebarFrontmatter, u as CopyMarkdownConfig, ut as SidebarPageNode, v as DocsAnalyticsInput, w as DocsMcpConfig, x as DocsFeedbackData, y as DocsAnalyticsSource, z as DocsSearchSourcePage } from "./types-BXgTvFFE.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, d as resolveDocsAnalyticsConfig, f as DocsCloudAnalyticsOptions, i as createMcpSearchAdapter, l as ResolvedDocsAnalyticsConfig, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as createDocsCloudAnalytics, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as emitDocsAnalyticsEvent } from "./search-Gvi81BSo.mjs";
+import { $ as OGConfig, A as DocsNav, B as DocsSearchDocument, C as DocsConfig, D as DocsMcpConfig, E as DocsI18nConfig, F as DocsSearchAdapter, G as DocsSearchSourcePage, H as DocsSearchQuery, I as DocsSearchAdapterContext, J as FontStyle, K as DocsTheme, L as DocsSearchAdapterFactory, M as DocsObservabilityEvent, N as DocsObservabilityEventInput, O as DocsMcpToolsConfig, P as DocsRelatedItem, Q as McpDocsSearchConfig, R as DocsSearchChunkingConfig, S as DocsAnalyticsSource, St as UIConfig, T as DocsFeedbackValue, U as DocsSearchResult, V as DocsSearchEmbeddingsConfig, W as DocsSearchResultType, X as LastUpdatedConfig, Y as GithubConfig, Z as LlmsTxtConfig, _ as DocsAnalyticsConfig, _t as SidebarTree, a as ApiReferenceRenderer, at as PageFrontmatter, b as DocsAnalyticsEventType, bt as TypesenseDocsSearchConfig, c as ChangelogFrontmatter, ct as PageTwitter, d as CustomDocsSearchConfig, dt as SidebarComponentProps, et as OpenDocsConfig, f as DocsAgentFeedbackContext, ft as SidebarConfig, g as DocsAgentTraceStatus, gt as SidebarPageNode, h as DocsAgentTraceEventType, ht as SidebarNode, i as ApiReferenceConfig, it as PageActionsConfig, j as DocsObservabilityConfig, k as DocsMetadata, l as CodeBlockCopyData, lt as ReadingTimeConfig, m as DocsAgentTraceEventInput, mt as SidebarFolderNode, n as AgentFeedbackConfig, nt as OpenGraphImage, o as BreadcrumbConfig, ot as PageOpenGraph, p as DocsAgentFeedbackData, pt as SidebarFolderIndexBehavior, q as FeedbackConfig, r as AlgoliaDocsSearchConfig, rt as OrderingItem, s as ChangelogConfig, st as PageSidebarFrontmatter, t as AIConfig, tt as OpenDocsProvider, u as CopyMarkdownConfig, ut as ResolvedDocsRelatedLink, v as DocsAnalyticsEvent, vt as SimpleDocsSearchConfig, w as DocsFeedbackData, x as DocsAnalyticsInput, xt as TypographyConfig, y as DocsAnalyticsEventInput, yt as ThemeToggleConfig, z as DocsSearchConfig } from "./types-CgBlM_yI.mjs";
+import { _ as emitDocsObservabilityEvent, a as createSimpleSearchAdapter, b as DocsCloudAnalyticsOptions, c as resolveSearchRequestConfig, d as ResolvedDocsAnalyticsConfig, f as ResolvedDocsObservabilityConfig, g as emitDocsAnalyticsEvent, h as emitDocsAgentTraceEvent, i as createMcpSearchAdapter, l as DOCS_AGENT_TRACE_EVENT_TYPES, m as createDocsAgentTraceId, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as createDocsAgentTraceContext, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as DocsAgentTraceContext, v as resolveDocsAnalyticsConfig, x as createDocsCloudAnalytics, y as resolveDocsObservabilityConfig } from "./search-COyfvf6H.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts
@@ -372,4 +372,4 @@ declare function buildDocsAgentDiscoverySpec({
   };
 };
 //#endregion
-export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsCloudAnalyticsOptions, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsRelatedItem, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSkillDocumentOptions, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type ReadingTimeConfig, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsRelatedLink, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsCloudAnalytics, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAnalyticsEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, hashGeneratedAgentContent, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseGeneratedAgentDocument, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance };
+export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsCloudAnalyticsOptions, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsPathMatch, type DocsRelatedItem, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSkillDocumentOptions, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type ReadingTimeConfig, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, hashGeneratedAgentContent, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseGeneratedAgentDocument, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsObservabilityConfig, resolveDocsPath, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as resolvePageSidebarFolderIndexBehavior, B as resolveOGImage, C as renderDocsMarkdownDocument, D as resolveDocsMarkdownRequest, E as resolveDocsLlmsTxtFormat, F as resolveReadingTimeFromContent, G as createTheme, H as resolveDocsI18n, I as resolveReadingTimeFromSource, J as resolveChangelogConfig, K as extendTheme, L as resolveReadingTimeOptions, M as resolveSidebarFolderIndexBehaviorForPath, N as estimateReadingTimeMinutes, O as resolveDocsSkillFormat, P as resolvePageReadingTime, R as buildPageOpenGraph, S as normalizeDocsUrlPath, T as resolveDocsAgentMdxContent, U as resolveDocsLocale, V as resolveTitle, W as resolveDocsPath, Y as defineDocs, _ as isDocsAgentDiscoveryRequest, a as DEFAULT_DOCS_API_ROUTE, b as isDocsSkillRequest, c as DEFAULT_LLMS_TXT_ROUTE, d as DEFAULT_MCP_ROUTE, f as DEFAULT_MCP_WELL_KNOWN_ROUTE, g as findDocsMarkdownPage, h as buildDocsAgentDiscoverySpec, i as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, j as resolveSidebarFolderIndexBehavior, k as applySidebarFolderIndexBehavior, l as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, m as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, n as DEFAULT_AGENT_SPEC_ROUTE, o as DEFAULT_LLMS_FULL_TXT_ROUTE, p as DEFAULT_SKILL_MD_ROUTE, q as deepMerge, r as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, s as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, t as DEFAULT_AGENT_FEEDBACK_ROUTE, u as DEFAULT_MCP_PUBLIC_ROUTE, v as isDocsMcpRequest, w as renderDocsSkillDocument, x as normalizeDocsPathSegment, y as isDocsPublicGetRequest, z as buildPageTwitter } from "./agent-BMOtZLMC.mjs";
-import { _ as renderDocsRelatedMarkdownLines, a as createSimpleSearchAdapter, b as createDocsCloudAnalytics, c as resolveSearchRequestConfig, d as hashGeneratedAgentContent, f as normalizeGeneratedAgentContent, g as normalizeDocsRelated, h as stripGeneratedAgentProvenance, i as createMcpSearchAdapter, l as GENERATED_AGENT_PROVENANCE_MARKER, m as serializeGeneratedAgentDocument, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as parseGeneratedAgentDocument, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as GENERATED_AGENT_PROVENANCE_VERSION, v as emitDocsAnalyticsEvent, y as resolveDocsAnalyticsConfig } from "./search-BhXicuww.mjs";
+import { A as resolvePageReadingTime, B as resolveDocsPath, C as renderDocsMarkdownDocument, D as resolveDocsMarkdownRequest, E as resolveDocsLlmsTxtFormat, F as buildPageTwitter, G as defineDocs, H as extendTheme, I as resolveOGImage, L as resolveTitle, M as resolveReadingTimeFromSource, N as resolveReadingTimeOptions, O as resolveDocsSkillFormat, P as buildPageOpenGraph, R as resolveDocsI18n, S as normalizeDocsUrlPath, T as resolveDocsAgentMdxContent, U as deepMerge, V as createTheme, W as resolveChangelogConfig, _ as isDocsAgentDiscoveryRequest, a as DEFAULT_DOCS_API_ROUTE, b as isDocsSkillRequest, c as DEFAULT_LLMS_TXT_ROUTE, d as DEFAULT_MCP_ROUTE, f as DEFAULT_MCP_WELL_KNOWN_ROUTE, g as findDocsMarkdownPage, h as buildDocsAgentDiscoverySpec, i as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, j as resolveReadingTimeFromContent, k as estimateReadingTimeMinutes, l as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, m as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, n as DEFAULT_AGENT_SPEC_ROUTE, o as DEFAULT_LLMS_FULL_TXT_ROUTE, p as DEFAULT_SKILL_MD_ROUTE, r as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, s as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, t as DEFAULT_AGENT_FEEDBACK_ROUTE, u as DEFAULT_MCP_PUBLIC_ROUTE, v as isDocsMcpRequest, w as renderDocsSkillDocument, x as normalizeDocsPathSegment, y as isDocsPublicGetRequest, z as resolveDocsLocale } from "./agent-D87B57Wv.mjs";
+import { A as createDocsCloudAnalytics, C as createDocsAgentTraceContext, D as emitDocsObservabilityEvent, E as emitDocsAnalyticsEvent, O as resolveDocsAnalyticsConfig, S as DOCS_AGENT_TRACE_EVENT_TYPES, T as emitDocsAgentTraceEvent, _ as resolvePageSidebarFolderIndexBehavior, a as createSimpleSearchAdapter, b as normalizeDocsRelated, c as resolveSearchRequestConfig, d as hashGeneratedAgentContent, f as normalizeGeneratedAgentContent, g as applySidebarFolderIndexBehavior, h as stripGeneratedAgentProvenance, i as createMcpSearchAdapter, k as resolveDocsObservabilityConfig, l as GENERATED_AGENT_PROVENANCE_MARKER, m as serializeGeneratedAgentDocument, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as parseGeneratedAgentDocument, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as GENERATED_AGENT_PROVENANCE_VERSION, v as resolveSidebarFolderIndexBehavior, w as createDocsAgentTraceId, x as renderDocsRelatedMarkdownLines, y as resolveSidebarFolderIndexBehaviorForPath } from "./search-Bk7rg-AY.mjs";
 
-export { DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsCloudAnalytics, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAnalyticsEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, hashGeneratedAgentContent, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseGeneratedAgentDocument, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance };
+export { DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, hashGeneratedAgentContent, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, parseGeneratedAgentDocument, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, renderDocsSkillDocument, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsObservabilityConfig, resolveDocsPath, resolveDocsSkillFormat, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance };

package/dist/{mcp-vNQt0NUC.mjs → mcp-obMYAPqu.mjs}

@@ -1,4 +1,4 @@
-import "./search-BhXicuww.mjs";
+import "./search-Bk7rg-AY.mjs";
 import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { N as DocsSearchConfig, Z as OrderingItem, m as DocsAnalyticsConfig, w as DocsMcpConfig, z as DocsSearchSourcePage } from "./types-BXgTvFFE.mjs";
+import { D as DocsMcpConfig, G as DocsSearchSourcePage, _ as DocsAnalyticsConfig, j as DocsObservabilityConfig, rt as OrderingItem, z as DocsSearchConfig } from "./types-CgBlM_yI.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -69,6 +69,7 @@ interface CreateDocsMcpServerOptions {
   mcp?: boolean | DocsMcpConfig;
   search?: boolean | DocsSearchConfig;
   analytics?: boolean | DocsAnalyticsConfig;
+  observability?: boolean | DocsObservabilityConfig;
   defaultName?: string;
   defaultVersion?: string;
 }

package/dist/mcp.mjs

@@ -1,4 +1,4 @@
-import { _ as renderDocsRelatedMarkdownLines, g as normalizeDocsRelated, h as stripGeneratedAgentProvenance, s as performDocsSearch, v as emitDocsAnalyticsEvent } from "./search-BhXicuww.mjs";
+import { C as createDocsAgentTraceContext, E as emitDocsAnalyticsEvent, T as emitDocsAgentTraceEvent, _ as resolvePageSidebarFolderIndexBehavior, b as normalizeDocsRelated, h as stripGeneratedAgentProvenance, s as performDocsSearch, w as createDocsAgentTraceId, x as renderDocsRelatedMarkdownLines } from "./search-Bk7rg-AY.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -130,21 +130,69 @@ async function createDocsMcpServer(options) {
 		annotations: { readOnlyHint: true }
 	}, async ({ locale }) => {
 		const startedAt = nowMs();
-		const pages = toPageSummaries(dedupePages(await options.source.getPages(locale)));
-		await emitDocsAnalyticsEvent(options.analytics, {
-			type: "mcp_tool",
+		const trace = createDocsAgentTraceContext("mcp.tool.list_pages");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
 			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "list_pages",
+			startedAt: trace.startedAt,
+			status: "started",
 			locale,
-			properties: {
-				tool: "list_pages",
-				resultCount: pages.length,
-				durationMs: durationMs(startedAt)
-			}
+			inputPreview: { locale },
+			metadata: { tool: "list_pages" }
 		});
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({ pages }, null, 2)
-		}] };
+		try {
+			const pages = toPageSummaries(dedupePages(await options.source.getPages(locale)));
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				properties: {
+					tool: "list_pages",
+					resultCount: pages.length,
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "list_pages",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				outputPreview: { resultCount: pages.length },
+				metadata: { tool: "list_pages" }
+			});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify({ pages }, null, 2)
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "list_pages",
+				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_pages" }
+			});
+			throw error;
+		}
 	});
 	if (resolved.tools.getNavigation) server.registerTool("get_navigation", {
 		title: "Get docs navigation",
@@ -153,20 +201,68 @@ async function createDocsMcpServer(options) {
 		annotations: { readOnlyHint: true }
 	}, async ({ locale }) => {
 		const startedAt = nowMs();
-		const tree = await options.source.getNavigation(locale);
-		await emitDocsAnalyticsEvent(options.analytics, {
-			type: "mcp_tool",
+		const trace = createDocsAgentTraceContext("mcp.tool.get_navigation");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
 			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "get_navigation",
+			startedAt: trace.startedAt,
+			status: "started",
 			locale,
-			properties: {
-				tool: "get_navigation",
-				durationMs: durationMs(startedAt)
-			}
+			inputPreview: { locale },
+			metadata: { tool: "get_navigation" }
 		});
-		return { content: [{
-			type: "text",
-			text: renderNavigationTree(tree)
-		}] };
+		try {
+			const text = renderNavigationTree(await options.source.getNavigation(locale));
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				properties: {
+					tool: "get_navigation",
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_navigation",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				outputPreview: { chars: text.length },
+				metadata: { tool: "get_navigation" }
+			});
+			return { content: [{
+				type: "text",
+				text
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "get_navigation",
+				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_navigation" }
+			});
+			throw error;
+		}
 	});
 	if (resolved.tools.searchDocs) server.registerTool("search_docs", {
 		title: "Search documentation",
@@ -175,31 +271,84 @@ async function createDocsMcpServer(options) {
 		annotations: { readOnlyHint: true }
 	}, async ({ query, limit, locale }) => {
 		const startedAt = nowMs();
-		const results = await performDocsSearch({
-			pages: toSearchSourcePages(dedupePages(await options.source.getPages(locale))),
-			query,
-			search: toolSearchConfig ?? true,
-			locale,
-			siteTitle: options.source.siteTitle,
-			limit: limit ?? 10
-		});
-		await emitDocsAnalyticsEvent(options.analytics, {
-			type: "mcp_tool",
+		const resolvedLimit = limit ?? 10;
+		const trace = createDocsAgentTraceContext("mcp.tool.search_docs");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
 			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "search_docs",
+			startedAt: trace.startedAt,
+			status: "started",
 			locale,
-			input: { query },
-			properties: {
-				tool: "search_docs",
+			inputPreview: {
 				queryLength: query.length,
-				limit: limit ?? 10,
-				resultCount: results.length,
-				durationMs: durationMs(startedAt)
-			}
+				limit: resolvedLimit,
+				locale
+			},
+			metadata: { tool: "search_docs" }
 		});
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({ results }, null, 2)
-		}] };
+		try {
+			const results = await performDocsSearch({
+				pages: toSearchSourcePages(dedupePages(await options.source.getPages(locale))),
+				query,
+				search: toolSearchConfig ?? true,
+				locale,
+				siteTitle: options.source.siteTitle,
+				limit: resolvedLimit
+			});
+			const elapsed = durationMs(startedAt);
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				input: { query },
+				properties: {
+					tool: "search_docs",
+					queryLength: query.length,
+					limit: resolvedLimit,
+					resultCount: results.length,
+					durationMs: elapsed
+				}
+			});
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "search_docs",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				outputPreview: { resultCount: results.length },
+				metadata: { tool: "search_docs" }
+			});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify({ results }, null, 2)
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "search_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: "search_docs" }
+			});
+			throw error;
+		}
 	});
 	if (resolved.tools.readPage) server.registerTool("read_page", {
 		title: "Read a docs page",
@@ -208,73 +357,150 @@ async function createDocsMcpServer(options) {
 		annotations: { readOnlyHint: true }
 	}, async ({ path: requestedPath, locale }) => {
 		const startedAt = nowMs();
-		const page = findDocsPage(dedupePages(await options.source.getPages(locale)), requestedPath, options.source.entry);
-		if (!page) {
+		const trace = createDocsAgentTraceContext("mcp.tool.read_page");
+		const callSpanId = createDocsAgentTraceId("span");
+		await emitDocsAgentTraceEvent(options.observability, {
+			type: "tool.call",
+			source: "mcp",
+			traceId: trace.traceId,
+			spanId: callSpanId,
+			name: "read_page",
+			startedAt: trace.startedAt,
+			status: "started",
+			locale,
+			inputPreview: {
+				path: requestedPath,
+				locale
+			},
+			metadata: { tool: "read_page" }
+		});
+		try {
+			const page = findDocsPage(dedupePages(await options.source.getPages(locale)), requestedPath, options.source.entry);
+			if (!page) {
+				const elapsed = durationMs(startedAt);
+				await emitDocsAnalyticsEvent(options.analytics, {
+					type: "agent_read",
+					source: "mcp",
+					locale,
+					properties: {
+						delivery: "mcp_tool",
+						tool: "read_page",
+						requestedPath,
+						found: false,
+						durationMs: elapsed
+					}
+				});
+				await emitDocsAnalyticsEvent(options.analytics, {
+					type: "mcp_tool",
+					source: "mcp",
+					locale,
+					properties: {
+						tool: "read_page",
+						path: requestedPath,
+						found: false,
+						durationMs: elapsed
+					}
+				});
+				await emitDocsAgentTraceEvent(options.observability, {
+					type: "tool.error",
+					source: "mcp",
+					traceId: trace.traceId,
+					parentSpanId: callSpanId,
+					name: "read_page",
+					startedAt: trace.startedAt,
+					endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					durationMs: elapsed,
+					status: "error",
+					locale,
+					outputPreview: {
+						found: false,
+						path: requestedPath
+					},
+					metadata: {
+						tool: "read_page",
+						reason: "not_found"
+					}
+				});
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify({ error: `No docs page matched "${requestedPath}".` }, null, 2)
+					}],
+					isError: true
+				};
+			}
+			const document = renderPageDocument(page);
+			const elapsed = durationMs(startedAt);
 			await emitDocsAnalyticsEvent(options.analytics, {
 				type: "agent_read",
 				source: "mcp",
 				locale,
+				path: page.url,
 				properties: {
 					delivery: "mcp_tool",
 					tool: "read_page",
 					requestedPath,
-					found: false,
-					durationMs: durationMs(startedAt)
+					slug: page.slug,
+					found: true,
+					contentLength: document.length,
+					durationMs: elapsed
 				}
 			});
 			await emitDocsAnalyticsEvent(options.analytics, {
 				type: "mcp_tool",
 				source: "mcp",
 				locale,
+				path: page.url,
 				properties: {
 					tool: "read_page",
-					path: requestedPath,
-					found: false,
-					durationMs: durationMs(startedAt)
+					requestedPath,
+					slug: page.slug,
+					found: true,
+					contentLength: document.length,
+					durationMs: elapsed
 				}
 			});
-			return {
-				content: [{
-					type: "text",
-					text: JSON.stringify({ error: `No docs page matched "${requestedPath}".` }, null, 2)
-				}],
-				isError: true
-			};
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.result",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "read_page",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "success",
+				locale,
+				path: page.url,
+				outputPreview: {
+					found: true,
+					chars: document.length,
+					slug: page.slug
+				},
+				metadata: { tool: "read_page" }
+			});
+			return { content: [{
+				type: "text",
+				text: document
+			}] };
+		} catch (error) {
+			const elapsed = durationMs(startedAt);
+			await emitDocsAgentTraceEvent(options.observability, {
+				type: "tool.error",
+				source: "mcp",
+				traceId: trace.traceId,
+				parentSpanId: callSpanId,
+				name: "read_page",
+				startedAt: trace.startedAt,
+				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				durationMs: elapsed,
+				status: "error",
+				locale,
+				outputPreview: { message: error instanceof Error ? error.message : "Unknown error" },
+				metadata: { tool: "read_page" }
+			});
+			throw error;
 		}
-		const document = renderPageDocument(page);
-		await emitDocsAnalyticsEvent(options.analytics, {
-			type: "agent_read",
-			source: "mcp",
-			locale,
-			path: page.url,
-			properties: {
-				delivery: "mcp_tool",
-				tool: "read_page",
-				requestedPath,
-				slug: page.slug,
-				found: true,
-				contentLength: document.length,
-				durationMs: durationMs(startedAt)
-			}
-		});
-		await emitDocsAnalyticsEvent(options.analytics, {
-			type: "mcp_tool",
-			source: "mcp",
-			locale,
-			path: page.url,
-			properties: {
-				tool: "read_page",
-				requestedPath,
-				slug: page.slug,
-				found: true,
-				contentLength: document.length,
-				durationMs: durationMs(startedAt)
-			}
-		});
-		return { content: [{
-			type: "text",
-			text: document
-		}] };
 	});
 	return server;
 }
@@ -462,6 +688,39 @@ function resolveAgentMdxContent(content, audience) {
 function stripMarkdownForMcp(content) {
 	return content.replace(/^(import|export)\s.*$/gm, "").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
 }
+function resolveFilesystemDocsPageSource(dir) {
+	return [
+		"page.mdx",
+		"page.md",
+		"page.svx"
+	].map((fileName) => path.join(dir, fileName)).find((candidate) => fs.existsSync(candidate));
+}
+function hasVisibleDescendantFilesystemDocsPage(dir) {
+	let entries;
+	try {
+		entries = fs.readdirSync(dir);
+	} catch {
+		return false;
+	}
+	for (const name of entries.sort()) {
+		const full = path.join(dir, name);
+		try {
+			if (!fs.statSync(full).isDirectory()) continue;
+		} catch {
+			continue;
+		}
+		const pageSource = resolveFilesystemDocsPageSource(full);
+		if (pageSource) try {
+			const data = matter(fs.readFileSync(pageSource, "utf-8")).data;
+			const hiddenFolderIndex = resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden";
+			if (data.hidden !== true && !hiddenFolderIndex) return true;
+		} catch {
+			return true;
+		}
+		if (hasVisibleDescendantFilesystemDocsPage(full)) return true;
+	}
+	return false;
+}
 function scanFilesystemDocsPages(contentDirAbs, entry) {
 	const pages = [];
 	function scan(dir, slugParts) {
@@ -476,11 +735,12 @@ function scanFilesystemDocsPages(contentDirAbs, entry) {
 			if (name === "agent.md") continue;
 			if (!name.endsWith(".md") && !name.endsWith(".mdx") && !name.endsWith(".svx")) continue;
 			const { data, content } = matter(fs.readFileSync(full, "utf-8"));
+			const baseName = name.replace(/\.(md|mdx|svx)$/, "");
+			const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
+			if (isIndex && resolvePageSidebarFolderIndexBehavior(data.sidebar) === "hidden" && hasVisibleDescendantFilesystemDocsPage(dir)) continue;
 			const humanRawContent = resolveAgentMdxContent(content, "human");
 			const pageAgentRawContent = resolveAgentMdxContent(content, "agent");
 			const pageAgentContent = pageAgentRawContent !== humanRawContent ? stripMarkdownForMcp(pageAgentRawContent) : void 0;
-			const baseName = name.replace(/\.(md|mdx|svx)$/, "");
-			const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
 			const slug = isIndex ? slugParts.join("/") : [...slugParts, baseName].join("/");
 			const url = slug ? `/${entry}/${slug}` : `/${entry}`;
 			const agentDoc = isIndex ? readFilesystemAgentDoc(dir) : void 0;

package/dist/{search-BhXicuww.mjs → search-Bk7rg-AY.mjs}

@@ -54,6 +54,29 @@ function createDocsCloudAnalytics(options = {}) {
 
 //#endregion
 //#region src/analytics.ts
+const ANALYTICS_LOG_PREFIX = "[@farming-labs/docs:analytics]";
+const OBSERVABILITY_LOG_PREFIX = "[@farming-labs/docs:observability]";
+const DOCS_AGENT_TRACE_EVENT_TYPES = [
+	"run.start",
+	"run.end",
+	"run.error",
+	"user.input",
+	"prompt.build",
+	"retrieval.query",
+	"retrieval.result",
+	"retrieval.error",
+	"model.call",
+	"model.response",
+	"model.stream",
+	"model.error",
+	"tool.call",
+	"tool.result",
+	"tool.error",
+	"retry",
+	"timeout",
+	"error",
+	"agent.final"
+];
 function composeAnalyticsHandlers(userOnEvent, cloudOnEvent) {
 	if (typeof userOnEvent !== "function" && !cloudOnEvent) return;
 	return async (event) => {
@@ -75,6 +98,17 @@ function resolveConsoleLevel(value, hasEventHandler) {
 	if (value === "log" || value === "info" || value === "debug") return value;
 	return hasEventHandler ? false : "info";
 }
+function createDocsAgentTraceId(prefix = "trace") {
+	return `${prefix.replace(/[^a-zA-Z0-9_-]/g, "_") || "trace"}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function createDocsAgentTraceContext(name = "agent.run") {
+	return {
+		traceId: createDocsAgentTraceId("run"),
+		name,
+		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		startedMs: Date.now()
+	};
+}
 function resolveDocsAnalyticsConfig(analytics) {
 	const cloudOptions = resolveDocsCloudAnalyticsOptions(analytics);
 	const cloudOnEvent = cloudOptions ? async (event) => {
@@ -109,6 +143,25 @@ function resolveDocsAnalyticsConfig(analytics) {
 		onEvent
 	};
 }
+function resolveDocsObservabilityConfig(observability) {
+	if (!observability) return {
+		enabled: false,
+		console: false,
+		includeInputs: false
+	};
+	if (observability === true) return {
+		enabled: true,
+		console: "info",
+		includeInputs: false
+	};
+	const hasEventHandler = typeof observability.onEvent === "function";
+	return {
+		enabled: observability.enabled !== false,
+		console: resolveConsoleLevel(observability.console, hasEventHandler),
+		includeInputs: observability.includeInputs === true,
+		onEvent: observability.onEvent
+	};
+}
 function normalizeAnalyticsEvent(event, config) {
 	const normalized = {
 		...event,
@@ -118,18 +171,51 @@ function normalizeAnalyticsEvent(event, config) {
 	if (!config.includeInputs && normalized.input) delete normalized.input;
 	return normalized;
 }
+function normalizeObservabilityEvent(event, config) {
+	const normalized = {
+		...event,
+		source: event.source ?? "server",
+		timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (!config.includeInputs && normalized.input) delete normalized.input;
+	return normalized;
+}
 async function emitDocsAnalyticsEvent(analytics, event) {
 	const resolved = resolveDocsAnalyticsConfig(analytics);
 	if (!resolved.enabled) return;
 	const normalized = normalizeAnalyticsEvent(event, resolved);
-	if (resolved.console) (console[resolved.console] ?? console.info).call(console, "[farming-labs:analytics]", normalized);
+	if (resolved.console) (console[resolved.console] ?? console.info).call(console, ANALYTICS_LOG_PREFIX, normalized);
+	if (!resolved.onEvent) return;
+	try {
+		await resolved.onEvent(normalized);
+	} catch (error) {
+		if (resolved.console !== false) console.warn(`${ANALYTICS_LOG_PREFIX} onEvent failed`, error);
+	}
+}
+async function emitDocsObservabilityEvent(observability, event) {
+	const resolved = resolveDocsObservabilityConfig(observability);
+	if (!resolved.enabled) return;
+	const normalized = normalizeObservabilityEvent(event, resolved);
+	if (resolved.console) (console[resolved.console] ?? console.info).call(console, OBSERVABILITY_LOG_PREFIX, normalized);
 	if (!resolved.onEvent) return;
 	try {
 		await resolved.onEvent(normalized);
 	} catch (error) {
-		if (resolved.console !== false) console.warn("[farming-labs:analytics] onEvent failed", error);
+		if (resolved.console !== false) console.warn(`${OBSERVABILITY_LOG_PREFIX} onEvent failed`, error);
 	}
 }
+async function emitDocsAgentTraceEvent(observability, event) {
+	const timestamp = event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+	await emitDocsObservabilityEvent(observability, {
+		...event,
+		timestamp,
+		source: event.source ?? "server",
+		traceId: event.traceId ?? createDocsAgentTraceId("run"),
+		spanId: event.spanId ?? createDocsAgentTraceId("span"),
+		startedAt: event.startedAt ?? timestamp,
+		status: event.status ?? "success"
+	});
+}
 
 //#endregion
 //#region src/related.ts
@@ -180,6 +266,78 @@ function normalizeInlineText(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
 
+//#endregion
+//#region src/sidebar.ts
+function resolvePageSidebarFolderIndexBehavior(sidebar) {
+	if (!sidebar || typeof sidebar !== "object") return void 0;
+	const value = sidebar.folderIndexBehavior;
+	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
+}
+function normalizeSidebarFolderBehaviorPath(path) {
+	if (!path) return void 0;
+	let value = path.trim();
+	if (!value) return void 0;
+	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
+		value = new URL(value).pathname;
+	} catch {
+		return;
+	}
+	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
+	if (!value.startsWith("/")) value = `/${value}`;
+	return value.replace(/\/$/, "") || "/";
+}
+function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
+	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
+	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
+	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
+	if (sidebar.folderIndexBehavior === "link") return "link";
+	return defaultBehavior;
+}
+function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
+	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
+	if (!sidebar || typeof sidebar !== "object") return fallback;
+	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
+	if (!normalizedPath) return fallback;
+	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
+	return fallback;
+}
+function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
+	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
+	function mapNode(node) {
+		if (!node || typeof node !== "object") return node;
+		const candidate = node;
+		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
+		const children = candidate.children.map(mapNode);
+		const index = candidate.index ? mapNode(candidate.index) : void 0;
+		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
+		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
+		if (behavior === "link") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index,
+			children
+		};
+		if (behavior === "hidden") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children
+		};
+		return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children: index ? [index, ...children] : children
+		};
+	}
+	return {
+		...tree,
+		children: tree.children.map(mapNode)
+	};
+}
+
 //#endregion
 //#region src/agent-provenance.ts
 const GENERATED_AGENT_PROVENANCE_MARKER = "@farming-labs/docs:generated";
@@ -927,4 +1085,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { renderDocsRelatedMarkdownLines as _, createSimpleSearchAdapter as a, createDocsCloudAnalytics as b, resolveSearchRequestConfig as c, hashGeneratedAgentContent as d, normalizeGeneratedAgentContent as f, normalizeDocsRelated as g, stripGeneratedAgentProvenance as h, createMcpSearchAdapter as i, GENERATED_AGENT_PROVENANCE_MARKER as l, serializeGeneratedAgentDocument as m, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, parseGeneratedAgentDocument as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, GENERATED_AGENT_PROVENANCE_VERSION as u, emitDocsAnalyticsEvent as v, resolveDocsAnalyticsConfig as y };
+export { createDocsCloudAnalytics as A, createDocsAgentTraceContext as C, emitDocsObservabilityEvent as D, emitDocsAnalyticsEvent as E, resolveDocsAnalyticsConfig as O, DOCS_AGENT_TRACE_EVENT_TYPES as S, emitDocsAgentTraceEvent as T, resolvePageSidebarFolderIndexBehavior as _, createSimpleSearchAdapter as a, normalizeDocsRelated as b, resolveSearchRequestConfig as c, hashGeneratedAgentContent as d, normalizeGeneratedAgentContent as f, applySidebarFolderIndexBehavior as g, stripGeneratedAgentProvenance as h, createMcpSearchAdapter as i, resolveDocsObservabilityConfig as k, GENERATED_AGENT_PROVENANCE_MARKER as l, serializeGeneratedAgentDocument as m, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, parseGeneratedAgentDocument as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, GENERATED_AGENT_PROVENANCE_VERSION as u, resolveSidebarFolderIndexBehavior as v, createDocsAgentTraceId as w, renderDocsRelatedMarkdownLines as x, resolveSidebarFolderIndexBehaviorForPath as y };

package/dist/{search-DcXwu_8y.mjs → search-BzMf2w0H.mjs}

@@ -1,4 +1,4 @@
-import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-BhXicuww.mjs";
+import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-Bk7rg-AY.mjs";
 import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";

package/dist/search-COyfvf6H.d.mts

@@ -0,0 +1,59 @@
+import { B as DocsSearchDocument, F as DocsSearchAdapter, G as DocsSearchSourcePage, L as DocsSearchAdapterFactory, M as DocsObservabilityEvent, N as DocsObservabilityEventInput, Q as McpDocsSearchConfig, R as DocsSearchChunkingConfig, U as DocsSearchResult, _ as DocsAnalyticsConfig, bt as TypesenseDocsSearchConfig, d as CustomDocsSearchConfig, j as DocsObservabilityConfig, m as DocsAgentTraceEventInput, r as AlgoliaDocsSearchConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsSearchConfig } from "./types-CgBlM_yI.mjs";
+
+//#region src/cloud-analytics.d.ts
+interface DocsCloudAnalyticsOptions {
+  enabled?: boolean;
+  console?: DocsAnalyticsConfig["console"];
+  includeInputs?: boolean;
+  projectId?: string;
+  apiKey?: string;
+}
+declare function createDocsCloudAnalytics(options?: DocsCloudAnalyticsOptions): DocsAnalyticsConfig;
+//#endregion
+//#region src/analytics.d.ts
+declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];
+interface DocsAgentTraceContext {
+  traceId: string;
+  name: string;
+  startedAt: string;
+  startedMs: number;
+}
+interface ResolvedDocsAnalyticsConfig {
+  enabled: boolean;
+  console: false | "log" | "info" | "debug";
+  includeInputs: boolean;
+  onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
+}
+interface ResolvedDocsObservabilityConfig {
+  enabled: boolean;
+  console: false | "log" | "info" | "debug";
+  includeInputs: boolean;
+  onEvent?: (event: DocsObservabilityEvent) => void | Promise<void>;
+}
+declare function createDocsAgentTraceId(prefix?: string): string;
+declare function createDocsAgentTraceContext(name?: string): DocsAgentTraceContext;
+declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
+declare function resolveDocsObservabilityConfig(observability?: boolean | DocsObservabilityConfig): ResolvedDocsObservabilityConfig;
+declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
+declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
+declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
+//#endregion
+//#region src/search.d.ts
+declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
+declare function createSimpleSearchAdapter(): DocsSearchAdapter;
+declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
+declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
+declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
+declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
+declare function performDocsSearch(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  limit?: number;
+}): Promise<DocsSearchResult[]>;
+declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
+//#endregion
+export { emitDocsObservabilityEvent as _, createSimpleSearchAdapter as a, DocsCloudAnalyticsOptions as b, resolveSearchRequestConfig as c, ResolvedDocsAnalyticsConfig as d, ResolvedDocsObservabilityConfig as f, emitDocsAnalyticsEvent as g, emitDocsAgentTraceEvent as h, createMcpSearchAdapter as i, DOCS_AGENT_TRACE_EVENT_TYPES as l, createDocsAgentTraceId as m, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, createDocsAgentTraceContext as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, DocsAgentTraceContext as u, resolveDocsAnalyticsConfig as v, createDocsCloudAnalytics as x, resolveDocsObservabilityConfig as y };

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { A as DocsSearchAdapterContext, I as DocsSearchQuery, K as McpDocsSearchConfig, L as DocsSearchResult, N as DocsSearchConfig, P as DocsSearchDocument, Y as OpenDocsProvider, a as ApiReferenceRenderer, b as DocsConfig, g as DocsAnalyticsEventInput, h as DocsAnalyticsEvent, j as DocsSearchAdapterFactory, k as DocsSearchAdapter, m as DocsAnalyticsConfig, z as DocsSearchSourcePage } from "./types-BXgTvFFE.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, d as resolveDocsAnalyticsConfig, f as DocsCloudAnalyticsOptions, i as createMcpSearchAdapter, l as ResolvedDocsAnalyticsConfig, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as createDocsCloudAnalytics, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as emitDocsAnalyticsEvent } from "./search-Gvi81BSo.mjs";
+import { B as DocsSearchDocument, C as DocsConfig, F as DocsSearchAdapter, G as DocsSearchSourcePage, H as DocsSearchQuery, I as DocsSearchAdapterContext, L as DocsSearchAdapterFactory, M as DocsObservabilityEvent, N as DocsObservabilityEventInput, Q as McpDocsSearchConfig, U as DocsSearchResult, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, j as DocsObservabilityConfig, m as DocsAgentTraceEventInput, tt as OpenDocsProvider, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsSearchConfig } from "./types-CgBlM_yI.mjs";
+import { _ as emitDocsObservabilityEvent, a as createSimpleSearchAdapter, b as DocsCloudAnalyticsOptions, c as resolveSearchRequestConfig, d as ResolvedDocsAnalyticsConfig, f as ResolvedDocsObservabilityConfig, g as emitDocsAnalyticsEvent, h as emitDocsAgentTraceEvent, i as createMcpSearchAdapter, l as DOCS_AGENT_TRACE_EVENT_TYPES, m as createDocsAgentTraceId, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, p as createDocsAgentTraceContext, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as DocsAgentTraceContext, v as resolveDocsAnalyticsConfig, x as createDocsCloudAnalytics, y as resolveDocsObservabilityConfig } from "./search-COyfvf6H.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts
@@ -63,4 +63,4 @@ declare function parsePromptStringArray(value: unknown): string[] | undefined;
 declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
 declare function sanitizePromptText(text: string): string;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsCloudAnalyticsOptions, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAnalyticsEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };
+export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DOCS_AGENT_TRACE_EVENT_TYPES, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, 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 McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };

package/dist/server.mjs

@@ -1,5 +1,5 @@
-import { a as createSimpleSearchAdapter, b as createDocsCloudAnalytics, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, v as emitDocsAnalyticsEvent, y as resolveDocsAnalyticsConfig } from "./search-BhXicuww.mjs";
+import { A as createDocsCloudAnalytics, C as createDocsAgentTraceContext, D as emitDocsObservabilityEvent, E as emitDocsAnalyticsEvent, O as resolveDocsAnalyticsConfig, S as DOCS_AGENT_TRACE_EVENT_TYPES, T as emitDocsAgentTraceEvent, a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, k as resolveDocsObservabilityConfig, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, w as createDocsAgentTraceId } from "./search-Bk7rg-AY.mjs";
 import { a as sanitizePromptText, c as serializeOpenDocsProviders, d as buildApiReferenceOpenApiDocument, f as buildApiReferenceOpenApiDocumentAsync, g as resolveApiReferenceRenderer, h as resolveApiReferenceConfig, i as resolvePromptProviderChoices, l as buildApiReferenceHtmlDocument, m as buildApiReferenceScalarCss, n as normalizePromptProviderName, o as serializeDocsIcon, p as buildApiReferencePageTitle, r as parsePromptStringArray, s as serializeDocsIconRegistry, t as DEFAULT_PROMPT_PROVIDER_TEMPLATES, u as buildApiReferenceHtmlDocumentAsync } from "./prompt-utils-8nmFLQVH.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
-export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAnalyticsEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };
+export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };

package/dist/{types-BXgTvFFE.d.mts → types-CgBlM_yI.d.mts}

@@ -633,6 +633,8 @@ interface PageActionsConfig {
   alignment?: "left" | "right";
 }
 type DocsAnalyticsSource = "client" | "server" | "mcp";
+type DocsAgentTraceStatus = "started" | "success" | "error" | "retry" | "timeout";
+type DocsAgentTraceEventType = "run.start" | "run.end" | "run.error" | "user.input" | "prompt.build" | "retrieval.query" | "retrieval.result" | "retrieval.error" | "model.call" | "model.response" | "model.stream" | "model.error" | "tool.call" | "tool.result" | "tool.error" | "retry" | "timeout" | "error" | "agent.final";
 type DocsAnalyticsEventType = "page_view" | "search_open" | "search_close" | "search_query" | "search_result_click" | "search_error" | "ai_open" | "ai_close" | "ai_question" | "ai_response" | "ai_error" | "ai_clear" | "page_action_copy_markdown" | "page_action_open_docs_menu" | "page_action_open_docs" | "code_block_copy" | "feedback_select" | "feedback_submit" | "feedback_error" | "agent_read" | "agent_spec_request" | "agent_feedback_schema" | "agent_feedback_submit" | "agent_feedback_error" | "markdown_request" | "llms_request" | "skill_request" | "api_search" | "api_ai_request" | "api_ai_response" | "api_ai_error" | "mcp_request" | "mcp_tool";
 interface DocsAnalyticsInput {
   query?: string;
@@ -640,8 +642,7 @@ interface DocsAnalyticsInput {
   feedbackComment?: string;
   content?: string;
 }
-interface DocsAnalyticsEvent {
-  type: DocsAnalyticsEventType | (string & {});
+interface DocsEventBase {
   timestamp: string;
   source: DocsAnalyticsSource;
   url?: string;
@@ -649,17 +650,42 @@ interface DocsAnalyticsEvent {
   referrer?: string;
   locale?: string;
   input?: DocsAnalyticsInput;
+  metadata?: Record<string, unknown>;
   properties?: Record<string, unknown>;
 }
+interface DocsAnalyticsEvent extends DocsEventBase {
+  type: DocsAnalyticsEventType | (string & {});
+}
 type DocsAnalyticsEventInput = Omit<DocsAnalyticsEvent, "timestamp" | "source"> & {
   timestamp?: string;
   source?: DocsAnalyticsSource;
 };
+interface DocsObservabilityEvent extends DocsEventBase {
+  type: DocsAgentTraceEventType | (string & {});
+  traceId?: string;
+  spanId?: string;
+  parentSpanId?: string;
+  name?: string;
+  startedAt?: string;
+  endedAt?: string;
+  durationMs?: number;
+  status?: DocsAgentTraceStatus;
+  inputPreview?: Record<string, unknown>;
+  outputPreview?: Record<string, unknown>;
+}
+type DocsObservabilityEventInput = Omit<DocsObservabilityEvent, "timestamp" | "source"> & {
+  timestamp?: string;
+  source?: DocsAnalyticsSource;
+};
+type DocsAgentTraceEventInput = Omit<DocsObservabilityEventInput, "type"> & {
+  type: DocsAgentTraceEventType;
+  name: string;
+};
 interface DocsAnalyticsConfig {
-  /** Enable analytics event emission. Defaults to `true` when this object is provided. */
+  /** Enable event emission. Defaults to `true` when this object is provided. */
   enabled?: boolean;
   /**
-   * Log analytics events to the console.
+   * Log events to the console.
    *
    * `analytics: true` logs with `console.info`. When `onEvent` is provided,
    * console logging is disabled unless this is set.
@@ -673,9 +699,30 @@ interface DocsAnalyticsConfig {
    * counts, routes, status, and duration.
    */
   includeInputs?: boolean;
-  /** Callback fired for every analytics event. */
+  /** Callback fired for every emitted event. */
   onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
 }
+interface DocsObservabilityConfig {
+  /** Enable trace emission. Defaults to `true` when this object is provided. */
+  enabled?: boolean;
+  /**
+   * Log trace events to the console.
+   *
+   * `observability: true` logs with `console.info`. When `onEvent` is provided,
+   * console logging is disabled unless this is set.
+   */
+  console?: boolean | "log" | "info" | "debug";
+  /**
+   * Include raw `input` fields on observability events.
+   *
+   * Defaults to `false`; events still include safe metadata such as lengths,
+   * counts, routes, status, and duration. Built-in trace events use previews
+   * instead of raw user-authored text.
+   */
+  includeInputs?: boolean;
+  /** Callback fired for every emitted trace event. */
+  onEvent?: (event: DocsObservabilityEvent) => void | Promise<void>;
+}
 /**
  * Configuration for the "Last updated" date display.
  *
@@ -1674,13 +1721,27 @@ interface DocsConfig {
    * Built-in analytics event stream for docs interactions.
    *
    * - `false` or omitted -> analytics disabled (default)
-   * - `true` -> log all framework events to the console
+   * - `true` -> log product/usage events to the console
    * - `{ onEvent(event) { ... } }` -> send events to your analytics sink
    *
    * Raw queries, AI questions, feedback comments, and copied content are not
    * included unless `includeInputs: true` is set.
    */
   analytics?: boolean | DocsAnalyticsConfig;
+  /**
+   * Built-in observability stream for agent traces, timing, errors, and runtime debugging.
+   * This is separate from `analytics`; it emits span-like Ask AI and MCP trace events.
+   *
+   * ```ts
+   * observability: {
+   *   console: "debug",
+   *   onEvent(event) {
+   *     console.info(event.type, event.traceId, event.durationMs)
+   *   },
+   * }
+   * ```
+   */
+  observability?: boolean | DocsObservabilityConfig;
   /**
    * GitHub repository URL or config. Enables "Edit on GitHub" links
    * on each docs page footer, pointing to the source `.mdx` file.
@@ -2046,4 +2107,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { PageFrontmatter as $, DocsSearchAdapterContext as A, DocsTheme as B, DocsI18nConfig as C, DocsNav as D, DocsMetadata as E, DocsSearchEmbeddingsConfig as F, LlmsTxtConfig as G, FontStyle as H, DocsSearchQuery as I, OpenDocsConfig as J, McpDocsSearchConfig as K, DocsSearchResult as L, DocsSearchChunkingConfig as M, DocsSearchConfig as N, DocsRelatedItem as O, DocsSearchDocument as P, PageActionsConfig as Q, DocsSearchResultType as R, DocsFeedbackValue as S, DocsMcpToolsConfig as T, GithubConfig as U, FeedbackConfig as V, LastUpdatedConfig as W, OpenGraphImage as X, OpenDocsProvider as Y, OrderingItem as Z, DocsAnalyticsEventType as _, ApiReferenceRenderer as a, SidebarComponentProps as at, DocsConfig as b, ChangelogFrontmatter as c, SidebarFolderNode as ct, CustomDocsSearchConfig as d, SidebarTree as dt, PageOpenGraph as et, DocsAgentFeedbackContext as f, SimpleDocsSearchConfig as ft, DocsAnalyticsEventInput as g, UIConfig as gt, DocsAnalyticsEvent as h, TypographyConfig as ht, ApiReferenceConfig as i, ResolvedDocsRelatedLink as it, DocsSearchAdapterFactory as j, DocsSearchAdapter as k, CodeBlockCopyData as l, SidebarNode as lt, DocsAnalyticsConfig as m, TypesenseDocsSearchConfig as mt, AgentFeedbackConfig as n, PageTwitter as nt, BreadcrumbConfig as o, SidebarConfig as ot, DocsAgentFeedbackData as p, ThemeToggleConfig as pt, OGConfig as q, AlgoliaDocsSearchConfig as r, ReadingTimeConfig as rt, ChangelogConfig as s, SidebarFolderIndexBehavior as st, AIConfig as t, PageSidebarFrontmatter as tt, CopyMarkdownConfig as u, SidebarPageNode as ut, DocsAnalyticsInput as v, DocsMcpConfig as w, DocsFeedbackData as x, DocsAnalyticsSource as y, DocsSearchSourcePage as z };
+export { OGConfig as $, DocsNav as A, DocsSearchDocument as B, DocsConfig as C, DocsMcpConfig as D, DocsI18nConfig as E, DocsSearchAdapter as F, DocsSearchSourcePage as G, DocsSearchQuery as H, DocsSearchAdapterContext as I, FontStyle as J, DocsTheme as K, DocsSearchAdapterFactory as L, DocsObservabilityEvent as M, DocsObservabilityEventInput as N, DocsMcpToolsConfig as O, DocsRelatedItem as P, McpDocsSearchConfig as Q, DocsSearchChunkingConfig as R, DocsAnalyticsSource as S, UIConfig as St, DocsFeedbackValue as T, DocsSearchResult as U, DocsSearchEmbeddingsConfig as V, DocsSearchResultType as W, LastUpdatedConfig as X, GithubConfig as Y, LlmsTxtConfig as Z, DocsAnalyticsConfig as _, SidebarTree as _t, ApiReferenceRenderer as a, PageFrontmatter as at, DocsAnalyticsEventType as b, TypesenseDocsSearchConfig as bt, ChangelogFrontmatter as c, PageTwitter as ct, CustomDocsSearchConfig as d, SidebarComponentProps as dt, OpenDocsConfig as et, DocsAgentFeedbackContext as f, SidebarConfig as ft, DocsAgentTraceStatus as g, SidebarPageNode as gt, DocsAgentTraceEventType as h, SidebarNode as ht, ApiReferenceConfig as i, PageActionsConfig as it, DocsObservabilityConfig as j, DocsMetadata as k, CodeBlockCopyData as l, ReadingTimeConfig as lt, DocsAgentTraceEventInput as m, SidebarFolderNode as mt, AgentFeedbackConfig as n, OpenGraphImage as nt, BreadcrumbConfig as o, PageOpenGraph as ot, DocsAgentFeedbackData as p, SidebarFolderIndexBehavior as pt, FeedbackConfig as q, AlgoliaDocsSearchConfig as r, OrderingItem as rt, ChangelogConfig as s, PageSidebarFrontmatter as st, AIConfig as t, OpenDocsProvider as tt, CopyMarkdownConfig as u, ResolvedDocsRelatedLink as ut, DocsAnalyticsEvent as v, SimpleDocsSearchConfig as vt, DocsFeedbackData as w, DocsAnalyticsInput as x, TypographyConfig as xt, DocsAnalyticsEventInput as y, ThemeToggleConfig as yt, DocsSearchConfig as z };

package/package.json

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

package/dist/search-Gvi81BSo.d.mts

@@ -1,41 +0,0 @@
-import { K as McpDocsSearchConfig, L as DocsSearchResult, M as DocsSearchChunkingConfig, N as DocsSearchConfig, P as DocsSearchDocument, d as CustomDocsSearchConfig, g as DocsAnalyticsEventInput, h as DocsAnalyticsEvent, j as DocsSearchAdapterFactory, k as DocsSearchAdapter, m as DocsAnalyticsConfig, mt as TypesenseDocsSearchConfig, r as AlgoliaDocsSearchConfig, z as DocsSearchSourcePage } from "./types-BXgTvFFE.mjs";
-
-//#region src/cloud-analytics.d.ts
-interface DocsCloudAnalyticsOptions {
-  enabled?: boolean;
-  console?: DocsAnalyticsConfig["console"];
-  includeInputs?: boolean;
-  projectId?: string;
-  apiKey?: string;
-}
-declare function createDocsCloudAnalytics(options?: DocsCloudAnalyticsOptions): DocsAnalyticsConfig;
-//#endregion
-//#region src/analytics.d.ts
-interface ResolvedDocsAnalyticsConfig {
-  enabled: boolean;
-  console: false | "log" | "info" | "debug";
-  includeInputs: boolean;
-  onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
-}
-declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
-declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
-//#endregion
-//#region src/search.d.ts
-declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
-declare function createSimpleSearchAdapter(): DocsSearchAdapter;
-declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
-declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
-declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
-declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-declare function performDocsSearch(options: {
-  pages: DocsSearchSourcePage[];
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  limit?: number;
-}): Promise<DocsSearchResult[]>;
-declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
-//#endregion
-export { createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, resolveDocsAnalyticsConfig as d, DocsCloudAnalyticsOptions as f, createMcpSearchAdapter as i, ResolvedDocsAnalyticsConfig as l, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, createDocsCloudAnalytics as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, emitDocsAnalyticsEvent as u };