@farming-labs/docs 0.1.71 → 0.1.73

package/dist/{search-DQTtxgAV.mjs → search-DBZ6Tkij.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("[farming-labs:analytics] onEvent failed", 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(`${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
@@ -334,8 +420,41 @@ const DEFAULT_SEARCH_LIMIT = 10;
 const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
 const syncedIndexes = /* @__PURE__ */ new Set();
 const ALGOLIA_MAX_RECORD_BYTES = 9500;
+const DEFAULT_ASK_AI_CONTEXT_CHARS = 24e3;
+const DEFAULT_ASK_AI_RESULT_CHARS = 6e3;
+const SEARCH_STOP_WORDS = new Set([
+	"a",
+	"an",
+	"and",
+	"are",
+	"as",
+	"at",
+	"be",
+	"can",
+	"do",
+	"does",
+	"for",
+	"from",
+	"how",
+	"i",
+	"in",
+	"is",
+	"it",
+	"of",
+	"on",
+	"or",
+	"the",
+	"this",
+	"to",
+	"use",
+	"what",
+	"when",
+	"where",
+	"which",
+	"with"
+]);
 function stripMarkdownText(content) {
-	return content.replace(/```[\s\S]*?```/g, "").replace(/~~~[\s\S]*?~~~/g, "").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(/^\|?[\s:-]+(\|[\s:-]+)+\|?\s*$/gm, "").replace(/\|/g, " ").replace(/^[-*+]\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/`{3,}[^\n]*$/gm, "").replace(/`([^`]+)`/g, "$1").replace(/`+/g, "").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").replace(/\s{2,}/g, " ").trim();
+	return removeMdxModuleLinesOutsideFences(content).replace(/```[^\n]*\n([\s\S]*?)```/g, "$1").replace(/```([\s\S]*?)```/g, "$1").replace(/~~~[^\n]*\n([\s\S]*?)~~~/g, "$1").replace(/~~~([\s\S]*?)~~~/g, "$1").replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^\|?[\s:-]+(\|[\s:-]+)+\|?\s*$/gm, "").replace(/\|/g, " ").replace(/^[-*+]\s+/gm, "").replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2").replace(/`{3,}[^\n]*$/gm, "").replace(/`([^`]+)`/g, "$1").replace(/`+/g, "").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/\n{3,}/g, "\n\n").replace(/\s{2,}/g, " ").trim();
 }
 function stripHtml(text) {
 	return text.replace(/<[^>]+>/g, "");
@@ -347,6 +466,194 @@ function normalizeMcpSsePayload(body) {
 function normalizeWhitespace(value) {
 	return value.replace(/\s+/g, " ").trim();
 }
+function tokenizeSearchQuery(query) {
+	return Array.from(new Set(query.toLowerCase().replace(/[^\p{L}\p{N}@/_:.-]+/gu, " ").split(/\s+/).map((word) => word.replace(/^[^\p{L}\p{N}@]+|[^\p{L}\p{N}]+$/gu, "")).filter((word) => word.length > 1 && !SEARCH_STOP_WORDS.has(word))));
+}
+function normalizeUrlPathname(value) {
+	try {
+		return new URL(value, "https://docs.local").pathname.replace(/\/+$/, "") || "/";
+	} catch {
+		return value.split(/[?#]/)[0]?.replace(/\/+$/, "") || "/";
+	}
+}
+function resolveAskAIContextUrl(value, baseUrl) {
+	if (!baseUrl) return value;
+	try {
+		return new URL(value, baseUrl).toString();
+	} catch {
+		return value;
+	}
+}
+function getAskAIPageContent(page) {
+	return page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent ?? page.content;
+}
+function removeMdxModuleLinesOutsideFences(content) {
+	let inFence = false;
+	return content.split("\n").filter((line) => {
+		const trimmed = line.trimStart();
+		if (trimmed.startsWith("```") || trimmed.startsWith("~~~")) {
+			inFence = !inFence;
+			return true;
+		}
+		return inFence || !/^(import|export)\s/.test(trimmed);
+	}).join("\n");
+}
+function cleanAskAIContextMarkdown(content) {
+	return removeMdxModuleLinesOutsideFences(content).replace(/<[^>]+\/>/g, "").replace(/<\/?[A-Z][^>]*>/g, "").replace(/<\/?[a-z][^>]*>/g, "").replace(/\n{3,}/g, "\n\n").trim();
+}
+function packageRootFromSpecifier(specifier) {
+	if (!specifier || specifier.startsWith(".") || specifier.startsWith("/") || specifier.startsWith("@/") || specifier.startsWith("~/") || specifier.startsWith("#")) return null;
+	const parts = specifier.split("/").filter(Boolean);
+	if (parts.length === 0) return null;
+	if (parts[0]?.startsWith("@")) return parts.length > 1 ? `${parts[0]}/${parts[1]}` : null;
+	return parts[0];
+}
+function cleanPackageToken(token) {
+	const trimmed = token.trim().replace(/^["'`]+|["'`,;]+$/g, "").replace(/\\$/g, "");
+	if (!trimmed || trimmed.startsWith("-") || /^[A-Z_][A-Z0-9_]*=/.test(trimmed)) return null;
+	if (/^(npm|pnpm|yarn|bun|install|add|i|x|dlx|run|exec)$/.test(trimmed)) return null;
+	return packageRootFromSpecifier(trimmed.startsWith("@") ? trimmed.replace(/^(@[^/]+\/[^@]+)@.+$/, "$1") : trimmed.replace(/^([^@]+)@.+$/, "$1"));
+}
+function inferDocsAskAIPackageHints(content) {
+	const packages = /* @__PURE__ */ new Set();
+	const imports = /* @__PURE__ */ new Set();
+	const installCommands = /* @__PURE__ */ new Set();
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const importSpecifier = trimmed.match(/^(?:import|export)\s+(?:type\s+)?[\s\S]*?\s+from\s+["']([^"']+)["']/)?.[1];
+		const bareImportSpecifier = trimmed.match(/^import\s+["']([^"']+)["']/)?.[1];
+		const requireSpecifier = trimmed.match(/require\(["']([^"']+)["']\)/)?.[1];
+		const specifier = importSpecifier ?? bareImportSpecifier ?? requireSpecifier;
+		const packageName = specifier ? packageRootFromSpecifier(specifier) : null;
+		if (packageName) {
+			packages.add(packageName);
+			if (/^(?:import|export)\s/.test(trimmed)) imports.add(trimmed);
+		}
+		const installMatch = trimmed.match(/^(?:npm\s+(?:install|i)|pnpm\s+add|yarn\s+add|bun\s+add)\s+(.+)$/);
+		if (!installMatch) continue;
+		const commandPackages = installMatch[1].split(/\s+/).map(cleanPackageToken).filter((value) => Boolean(value));
+		if (commandPackages.length > 0) {
+			installCommands.add(trimmed);
+			for (const name of commandPackages) packages.add(name);
+		}
+	}
+	return {
+		packages: Array.from(packages).slice(0, 8),
+		imports: Array.from(imports).slice(0, 12),
+		installCommands: Array.from(installCommands).slice(0, 8)
+	};
+}
+function formatDocsAskAIPackageHints(hints, packageName) {
+	const packages = packageName ? Array.from(new Set([packageName, ...hints.packages])) : hints.packages;
+	if (packages.length === 0 && hints.imports.length === 0 && hints.installCommands.length === 0) return;
+	const lines = ["Package and import hints inferred from the retrieved documentation context:"];
+	if (packages.length > 0) lines.push(`- Package names found in install/import examples: ${packages.join(", ")}`);
+	if (hints.imports.length > 0) lines.push(`- Exact import lines found in context: ${hints.imports.map((line) => `\`${line}\``).join("; ")}`);
+	if (hints.installCommands.length > 0) lines.push(`- Exact install commands found in context: ${hints.installCommands.map((line) => `\`${line}\``).join("; ")}`);
+	lines.push("Use these exact package names, install commands, and import lines when relevant. Do not replace them with placeholders.");
+	return lines.join("\n");
+}
+function clampText(value, maxChars) {
+	if (maxChars <= 0) return "";
+	if (value.length <= maxChars) return value;
+	return `${value.slice(0, maxChars).trimEnd()}...`;
+}
+function extractHeadingText(line) {
+	const match = line.match(/^(#{1,6})\s+(.+?)\s*#*\s*$/);
+	if (!match) return null;
+	return {
+		level: match[1].length,
+		text: normalizeWhitespace(match[2].replace(/[`*_~]/g, ""))
+	};
+}
+function extractSectionMarkdown(content, section) {
+	if (!section) return content;
+	const target = normalizeWhitespace(section).toLowerCase();
+	const lines = content.split("\n");
+	let start = -1;
+	let level = 0;
+	for (let i = 0; i < lines.length; i += 1) {
+		const heading = extractHeadingText(lines[i]);
+		if (!heading) continue;
+		if (heading.text.toLowerCase() === target) {
+			start = i;
+			level = heading.level;
+			break;
+		}
+	}
+	if (start === -1) return content;
+	let end = lines.length;
+	for (let i = start + 1; i < lines.length; i += 1) {
+		const heading = extractHeadingText(lines[i]);
+		if (heading && heading.level <= level) {
+			end = i;
+			break;
+		}
+	}
+	return lines.slice(start, end).join("\n");
+}
+function findPageForSearchResult(pages, result) {
+	const resultPath = normalizeUrlPathname(result.url);
+	return pages.find((page) => normalizeUrlPathname(page.url) === resultPath);
+}
+function inferResultTitle(result, page) {
+	if (page) return page.title;
+	return stripHtml(result.content).trim().split("—")[0]?.trim() || result.url;
+}
+function formatAskAIContextResult(options) {
+	const { result, page, maxChars, baseUrl } = options;
+	const title = inferResultTitle(result, page);
+	const section = result.section;
+	const contextContent = clampText(cleanAskAIContextMarkdown(page ? extractSectionMarkdown(getAskAIPageContent(page), section) : [result.content, result.description].filter(Boolean).join("\n\n")), maxChars);
+	return {
+		...result,
+		url: resolveAskAIContextUrl(result.url, baseUrl),
+		title,
+		contextContent
+	};
+}
+function getSearchResultKey(result) {
+	let hash = "";
+	try {
+		hash = new URL(result.url, "https://docs.local").hash.replace(/^#/, "");
+	} catch {
+		hash = result.url.split("#")[1]?.split(/[?&]/)[0] ?? "";
+	}
+	return `${normalizeUrlPathname(result.url)}#${normalizeWhitespace(hash || result.section || "").toLowerCase()}`;
+}
+function mergeSearchResults(...groups) {
+	const seen = /* @__PURE__ */ new Set();
+	const results = [];
+	for (const group of groups) for (const result of group) {
+		const key = getSearchResultKey(result);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		results.push(result);
+	}
+	return results;
+}
+function shouldSupplementAskAIWithSimpleSearch(search) {
+	return search.enabled && search.provider !== "simple";
+}
+function rankAskAIContextResult(query, result) {
+	return scoreDocument(query, {
+		id: result.id,
+		url: result.url,
+		title: result.title,
+		content: result.contextContent,
+		description: result.description,
+		type: result.type,
+		section: result.section
+	});
+}
+function buildAskAIContextBlock(result) {
+	const lines = [`## ${result.title}`, `URL: ${result.url}`];
+	if (result.section) lines.push(`Section: ${result.section}`);
+	if (result.description) lines.push(`Search snippet: ${result.description}`);
+	lines.push("", result.contextContent);
+	return lines.join("\n").trim();
+}
 function makeDocumentId(url, suffix) {
 	return `${url}#${suffix}`;
 }
@@ -421,14 +728,16 @@ function buildDocsSearchDocuments(pages, chunking = {}) {
 	});
 }
 function scoreDocument(query, document) {
-	const q = query.toLowerCase().trim();
+	const q = normalizeWhitespace(query.toLowerCase().replace(/[?!.,;:]+$/g, ""));
 	if (!q) return 0;
-	const words = Array.from(new Set(q.split(/\s+/).filter(Boolean)));
+	const words = tokenizeSearchQuery(q);
 	const title = document.title.toLowerCase();
 	const section = document.section?.toLowerCase() ?? "";
 	const description = document.description?.toLowerCase() ?? "";
 	const content = document.content.toLowerCase();
 	const url = document.url.toLowerCase();
+	const titleTokens = tokenizeSearchQuery(title);
+	const sectionTokens = tokenizeSearchQuery(section);
 	let score = 0;
 	if (title === q) score += 120;
 	else if (title.startsWith(q)) score += 70;
@@ -472,6 +781,10 @@ function scoreDocument(query, document) {
 		}
 		if (matched) matchedWords += 1;
 	}
+	if (words.length > 1) {
+		if (sectionTokens.length > 0 && words.every((word) => sectionTokens.includes(word))) score += 30;
+		if (document.type === "page" && titleTokens.length > 0 && words.every((word) => titleTokens.includes(word))) score += 24;
+	}
 	if (matchedWords === words.length && words.length > 1) score += 20;
 	if (document.type === "heading") score += 6;
 	return score;
@@ -991,6 +1304,80 @@ async function performDocsSearch(options) {
 		return createSimpleSearchAdapter().search(query, context);
 	}
 }
+async function buildDocsAskAIContext(options) {
+	const limit = options.limit ?? 5;
+	const searchLimit = Math.max(limit * 2, limit);
+	const initialSearch = options.search === false ? true : options.search;
+	const primarySearch = normalizeDocsSearchConfig(initialSearch).enabled ? initialSearch : true;
+	const primarySearchConfig = normalizeDocsSearchConfig(primarySearch);
+	const searchResults = mergeSearchResults(await performDocsSearch({
+		pages: options.pages,
+		query: options.query,
+		search: primarySearch,
+		locale: options.locale,
+		pathname: options.pathname,
+		siteTitle: options.siteTitle,
+		limit: searchLimit
+	}), shouldSupplementAskAIWithSimpleSearch(primarySearchConfig) ? await performDocsSearch({
+		pages: options.pages,
+		query: options.query,
+		search: {
+			provider: "simple",
+			enabled: true,
+			chunking: primarySearchConfig.chunking,
+			maxResults: searchLimit
+		},
+		locale: options.locale,
+		pathname: options.pathname,
+		siteTitle: options.siteTitle,
+		limit: searchLimit
+	}) : []);
+	const seen = /* @__PURE__ */ new Set();
+	const maxResultChars = options.maxResultChars ?? DEFAULT_ASK_AI_RESULT_CHARS;
+	const rankedResults = searchResults.map((result, index) => {
+		const formatted = formatAskAIContextResult({
+			result,
+			page: findPageForSearchResult(options.pages, result),
+			maxChars: maxResultChars,
+			baseUrl: options.baseUrl
+		});
+		return {
+			result,
+			formatted,
+			index,
+			rank: rankAskAIContextResult(options.query, formatted)
+		};
+	}).sort((a, b) => b.rank - a.rank || a.index - b.index);
+	const formattedResults = rankedResults.map((item) => item.formatted);
+	const sectionResultPaths = new Set(formattedResults.filter((result) => result.section).map((result) => normalizeUrlPathname(result.url)));
+	const results = formattedResults.filter((result) => result.section || !sectionResultPaths.has(normalizeUrlPathname(result.url))).filter((result) => {
+		const key = getSearchResultKey(result);
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return result.contextContent.length > 0;
+	}).slice(0, limit);
+	const maxContextChars = options.maxContextChars ?? DEFAULT_ASK_AI_CONTEXT_CHARS;
+	const blocks = [];
+	let usedChars = 0;
+	for (const result of results) {
+		const block = buildAskAIContextBlock(result);
+		const separatorChars = blocks.length === 0 ? 0 : 7;
+		if (usedChars + separatorChars + block.length > maxContextChars) {
+			const remaining = maxContextChars - usedChars - separatorChars;
+			if (remaining > 400) blocks.push(clampText(block, remaining));
+			break;
+		}
+		blocks.push(block);
+		usedChars += separatorChars + block.length;
+	}
+	const context = blocks.join("\n\n---\n\n");
+	return {
+		context,
+		results: results.slice(0, blocks.length),
+		searchResults: rankedResults.map((item) => item.result),
+		packageHints: inferDocsAskAIPackageHints(context)
+	};
+}
 function createCustomSearchAdapter(adapter) {
 	return {
 		provider: "custom",
@@ -999,4 +1386,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { resolveDocsAnalyticsConfig as C, emitDocsAnalyticsEvent as S, 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, 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, createDocsCloudAnalytics as w, renderDocsRelatedMarkdownLines as x, resolveSidebarFolderIndexBehaviorForPath as y };
+export { emitDocsObservabilityEvent as A, normalizeDocsRelated as C, createDocsAgentTraceId as D, createDocsAgentTraceContext as E, resolveDocsObservabilityConfig as M, createDocsCloudAnalytics as N, emitDocsAgentTraceEvent as O, resolveSidebarFolderIndexBehaviorForPath as S, DOCS_AGENT_TRACE_EVENT_TYPES as T, serializeGeneratedAgentDocument as _, createMcpSearchAdapter as a, resolvePageSidebarFolderIndexBehavior as b, formatDocsAskAIPackageHints as c, resolveSearchRequestConfig as d, GENERATED_AGENT_PROVENANCE_MARKER as f, parseGeneratedAgentDocument as g, normalizeGeneratedAgentContent as h, createCustomSearchAdapter as i, resolveDocsAnalyticsConfig as j, emitDocsAnalyticsEvent as k, inferDocsAskAIPackageHints as l, hashGeneratedAgentContent as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, GENERATED_AGENT_PROVENANCE_VERSION as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, stripGeneratedAgentProvenance as v, renderDocsRelatedMarkdownLines as w, resolveSidebarFolderIndexBehavior as x, applySidebarFolderIndexBehavior as y };

package/dist/search-DSKaQ2JH.d.mts

@@ -0,0 +1,88 @@
+import { Et as TypesenseDocsSearchConfig, G as DocsSearchConfig, K as DocsSearchDocument, L as DocsObservabilityConfig, R as DocsObservabilityEvent, U as DocsSearchAdapterFactory, V as DocsSearchAdapter, W as DocsSearchChunkingConfig, Y as DocsSearchResult, Z as DocsSearchSourcePage, _ as DocsAnalyticsConfig, d as CustomDocsSearchConfig, it as McpDocsSearchConfig, m as DocsAgentTraceEventInput, r as AlgoliaDocsSearchConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEventInput } from "./types-D-OvczD4.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
+interface DocsAskAIContextResult extends DocsSearchResult {
+  title: string;
+  contextContent: string;
+}
+interface DocsAskAIContext {
+  context: string;
+  results: DocsAskAIContextResult[];
+  searchResults: DocsSearchResult[];
+  packageHints: DocsAskAIPackageHints;
+}
+interface DocsAskAIPackageHints {
+  packages: string[];
+  imports: string[];
+  installCommands: string[];
+}
+declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
+declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
+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 buildDocsAskAIContext(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  limit?: number;
+  maxContextChars?: number;
+  maxResultChars?: number;
+}): Promise<DocsAskAIContext>;
+declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
+//#endregion
+export { DocsCloudAnalyticsOptions as C, resolveDocsObservabilityConfig as S, createDocsAgentTraceId as _, createMcpSearchAdapter as a, emitDocsObservabilityEvent as b, formatDocsAskAIPackageHints as c, resolveSearchRequestConfig as d, DOCS_AGENT_TRACE_EVENT_TYPES as f, createDocsAgentTraceContext as g, ResolvedDocsObservabilityConfig as h, createCustomSearchAdapter as i, inferDocsAskAIPackageHints as l, ResolvedDocsAnalyticsConfig as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, DocsAgentTraceContext as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, emitDocsAgentTraceEvent as v, createDocsCloudAnalytics as w, resolveDocsAnalyticsConfig as x, emitDocsAnalyticsEvent 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 { D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, G as DocsSearchConfig, H as DocsSearchAdapterContext, J as DocsSearchQuery, K as DocsSearchDocument, L as DocsObservabilityConfig, O as DocsAskAIFeedbackValue, R as DocsObservabilityEvent, T as DocsAskAIFeedbackConfig, U as DocsSearchAdapterFactory, V as DocsSearchAdapter, Y as DocsSearchResult, Z as DocsSearchSourcePage, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, it as McpDocsSearchConfig, k as DocsConfig, m as DocsAgentTraceEventInput, st as OpenDocsProvider, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEventInput } from "./types-D-OvczD4.mjs";
+import { C as DocsCloudAnalyticsOptions, S as resolveDocsObservabilityConfig, _ as createDocsAgentTraceId, a as createMcpSearchAdapter, b as emitDocsObservabilityEvent, c as formatDocsAskAIPackageHints, d as resolveSearchRequestConfig, f as DOCS_AGENT_TRACE_EVENT_TYPES, g as createDocsAgentTraceContext, h as ResolvedDocsObservabilityConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, m as ResolvedDocsAnalyticsConfig, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DocsAgentTraceContext, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as emitDocsAgentTraceEvent, w as createDocsCloudAnalytics, x as resolveDocsAnalyticsConfig, y as emitDocsAnalyticsEvent } from "./search-DSKaQ2JH.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 DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, 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, buildDocsAskAIContext, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, 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 { C as resolveDocsAnalyticsConfig, S as emitDocsAnalyticsEvent, a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, w as createDocsCloudAnalytics } from "./search-DQTtxgAV.mjs";
+import { A as emitDocsObservabilityEvent, D as createDocsAgentTraceId, E as createDocsAgentTraceContext, M as resolveDocsObservabilityConfig, N as createDocsCloudAnalytics, O as emitDocsAgentTraceEvent, T as DOCS_AGENT_TRACE_EVENT_TYPES, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as resolveDocsAnalyticsConfig, k as emitDocsAnalyticsEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-DBZ6Tkij.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, buildDocsAskAIContext, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };