@farming-labs/docs 0.2.57 → 0.2.59

package/dist/{search-OHp36znm.mjs → search-D57JXQLj.mjs}

@@ -1,4 +1,4 @@
-import { G as isDocsAgentsRequest, Kt as PAGE_AGENT_CONTRACT_START_MARKER, Ut as PAGE_AGENT_CONTRACT_END_MARKER, W as isDocsAgentDiscoveryRequest, Z as isDocsSkillRequest, Zt as renderPageAgentContractMarkdown, ct as resolveDocsAgentFeedbackConfig, en as upsertPageAgentContractMarkdown, ft as resolveDocsLlmsTxtRequest, gt as resolveDocsMarkdownRequest, lt as resolveDocsAgentFeedbackRequest, ut as resolveDocsAgentsFormat, vt as resolveDocsSkillFormat } from "./agent-CxDzPqtl.mjs";
+import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Q as isDocsSkillRequest, Sn as upsertPageAgentContractMarkdown, _t as resolveDocsMarkdownRequest, bt as resolveDocsSkillFormat, dn as PAGE_AGENT_CONTRACT_END_MARKER, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, mn as PAGE_AGENT_CONTRACT_START_MARKER, pt as resolveDocsLlmsTxtRequest, ut as resolveDocsAgentFeedbackRequest, yn as renderPageAgentContractMarkdown } from "./agent-BFqyqEnC.mjs";
 
 //#region src/telemetry.ts
 const DOCS_PACKAGE_NAME = "@farming-labs/docs";
@@ -601,6 +601,7 @@ function findDocsMarkdownSection(markdown, requestedSection) {
 //#region src/search.ts
 const DEFAULT_SEARCH_LIMIT = 10;
 const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
+const MCP_SESSION_CLEANUP_TIMEOUT_MS = 1e3;
 const syncedIndexes = /* @__PURE__ */ new Set();
 const ALGOLIA_MAX_RECORD_BYTES = 9500;
 const DEFAULT_ASK_AI_CONTEXT_CHARS = 24e3;
@@ -783,7 +784,17 @@ function clampText(value, maxChars) {
 	if (value.length <= maxChars) return value;
 	return `${value.slice(0, maxChars).trimEnd()}...`;
 }
-function findPageForSearchResult(pages, result) {
+function findPageForSearchResult(pages, result, baseUrl, strictExternalOrigins = false) {
+	const rawUrl = result.url.trim();
+	const explicitlySchemed = /^[a-z][a-z\d+.-]*:/iu.test(rawUrl);
+	const explicitlyHosted = explicitlySchemed || /^[\\/]{2}/u.test(rawUrl);
+	if (explicitlySchemed && !/^https?:/iu.test(rawUrl)) return void 0;
+	if (explicitlyHosted && !baseUrl && strictExternalOrigins) return void 0;
+	if (explicitlyHosted && baseUrl) try {
+		if (new URL(result.url, baseUrl).origin !== new URL(baseUrl).origin) return void 0;
+	} catch {
+		return;
+	}
 	const resultPath = normalizeUrlPathname(result.url);
 	return pages.find((page) => normalizeUrlPathname(page.url) === resultPath);
 }
@@ -827,18 +838,45 @@ function getSearchResultAnchor(value) {
 		return hash;
 	}
 }
-function mergeSearchResults(...groups) {
+function getAskAIResultPageKey(value, baseUrl, strictExternalOrigins = false) {
+	const path = normalizeUrlPathname(value);
+	const rawValue = value.trim();
+	if (!(/^[a-z][a-z\d+.-]*:/iu.test(rawValue) || /^[\\/]{2}/u.test(rawValue)) || !baseUrl && !strictExternalOrigins) return path;
+	try {
+		const fallbackBase = baseUrl ?? "https://docs.local";
+		const parsed = new URL(value, fallbackBase);
+		const configuredBase = baseUrl ? new URL(baseUrl) : void 0;
+		if (configuredBase && parsed.origin === configuredBase.origin) return path;
+		return `${parsed.protocol}//${parsed.host}${path}`;
+	} catch {
+		return `${value.split("#", 1)[0]}::${path}`;
+	}
+}
+function getAskAIResultKey(result, baseUrl, strictExternalOrigins = false) {
+	return `${getAskAIResultPageKey(result.url, baseUrl, strictExternalOrigins)}#${normalizeWhitespace(getSearchResultAnchor(result.url) || result.section || "").toLowerCase()}`;
+}
+function mergeSearchResults(groups, getResultKey = getSearchResultKey) {
 	const seen = /* @__PURE__ */ new Set();
 	const results = [];
 	for (const group of groups) for (const result of group) {
-		const key = getSearchResultKey(result);
+		const key = getResultKey(result);
 		if (seen.has(key)) continue;
 		seen.add(key);
 		results.push(result);
 	}
 	return results;
 }
-function sanitizeExternalAgentSearchResults(results, localAgentResults, preserveUnmatched) {
+function buildAgentProjectionSearchResults(documents) {
+	return documents.map((document) => ({
+		id: document.id,
+		url: document.url,
+		content: document.section ? `${document.title} — ${document.section}` : document.title,
+		description: document.content || document.description,
+		type: document.type,
+		section: document.section
+	}));
+}
+function sanitizeExternalAgentSearchResults(results, localAgentResults, baseUrl, strictExternalOrigins = false, preserveUnmatched) {
 	const localByKey = new Map(localAgentResults.map((result) => [getSearchResultKey(result), result]));
 	const localPageResults = /* @__PURE__ */ new Map();
 	for (const result of localAgentResults) {
@@ -846,7 +884,19 @@ function sanitizeExternalAgentSearchResults(results, localAgentResults, preserve
 		if (!localPageResults.get(pageUrl) || result.type === "page") localPageResults.set(pageUrl, result);
 	}
 	return results.flatMap((result) => {
-		const local = localByKey.get(getSearchResultKey(result)) ?? localPageResults.get(normalizeUrlPathname(result.url));
+		const rawUrl = result.url.trim();
+		const explicitlySchemed = /^[a-z][a-z\d+.-]*:/iu.test(rawUrl);
+		const externallyHosted = explicitlySchemed && /^https?:/iu.test(rawUrl) || /^[\\/]{2}/u.test(rawUrl);
+		const unsupportedScheme = explicitlySchemed && !/^https?:/iu.test(rawUrl);
+		let sameOriginOrUnknown = !externallyHosted || !baseUrl && !strictExternalOrigins;
+		if (unsupportedScheme) sameOriginOrUnknown = false;
+		if (externallyHosted && baseUrl) try {
+			sameOriginOrUnknown = new URL(result.url, baseUrl).origin === new URL(baseUrl).origin;
+		} catch {
+			sameOriginOrUnknown = false;
+		}
+		const hasSection = Boolean(getSearchResultAnchor(result.url) || result.section);
+		const local = sameOriginOrUnknown ? localByKey.get(getSearchResultKey(result)) ?? (hasSection ? void 0 : localPageResults.get(normalizeUrlPathname(result.url))) : void 0;
 		if (!local) return preserveUnmatched?.(result) ? [result] : [];
 		return [{
 			...local,
@@ -855,6 +905,23 @@ function sanitizeExternalAgentSearchResults(results, localAgentResults, preserve
 		}];
 	});
 }
+function shouldPreserveUnmatchedMcpResult(options) {
+	const { result, localPagePaths, baseUrl, strictExternalOrigins } = options;
+	const path = normalizeUrlPathname(result.url);
+	const rawUrl = result.url.trim();
+	const explicitScheme = rawUrl.match(/^([a-z][a-z\d+.-]*):/iu)?.[1]?.toLowerCase();
+	if (explicitScheme && explicitScheme !== "http" && explicitScheme !== "https") return false;
+	const explicitlyHosted = /^[a-z][a-z\d+.-]*:/iu.test(rawUrl) || /^[\\/]{2}/u.test(rawUrl);
+	if (!strictExternalOrigins) return explicitlyHosted || !localPagePaths.has(path);
+	if (!explicitlyHosted) return !localPagePaths.has(path);
+	if (!baseUrl) return true;
+	try {
+		if (new URL(result.url, baseUrl).origin !== new URL(baseUrl).origin) return true;
+	} catch {
+		return false;
+	}
+	return !localPagePaths.has(path);
+}
 function getPageAudienceRawContent(page, audience) {
 	if (audience === "agent") return page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
 	return page.rawContent ?? page.content;
@@ -1190,14 +1257,15 @@ function mapMcpSearchResult(value) {
 		section
 	};
 }
-async function createOllamaEmbedding(text, config) {
+async function createOllamaEmbedding(text, config, signal) {
 	const response = await fetch(`${(config.baseUrl ?? "http://127.0.0.1:11434").replace(/\/$/, "")}/api/embed`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
 			model: config.model,
 			input: text
-		})
+		}),
+		signal
 	});
 	ensureOk(response, "Failed to create Ollama embedding");
 	const payload = await readResponseJson(response);
@@ -1208,13 +1276,16 @@ async function createOllamaEmbedding(text, config) {
 function getTypesenseSearchBase(config) {
 	return config.baseUrl.replace(/\/$/, "");
 }
-async function ensureTypesenseCollection(config, dimensions) {
+async function ensureTypesenseCollection(config, dimensions, signal) {
 	const baseUrl = getTypesenseSearchBase(config);
 	const headers = {
 		"X-TYPESENSE-API-KEY": config.adminApiKey ?? config.apiKey,
 		"Content-Type": "application/json"
 	};
-	const existing = await fetch(`${baseUrl}/collections/${encodeURIComponent(config.collection)}`, { headers });
+	const existing = await fetch(`${baseUrl}/collections/${encodeURIComponent(config.collection)}`, {
+		headers,
+		signal
+	});
 	if (existing.ok) return;
 	if (existing.status !== 404) ensureOk(existing, "Failed to inspect Typesense collection");
 	const fields = [
@@ -1281,7 +1352,8 @@ async function ensureTypesenseCollection(config, dimensions) {
 		body: JSON.stringify({
 			name: config.collection,
 			fields
-		})
+		}),
+		signal
 	}), "Failed to create Typesense collection");
 }
 function createTypesenseSearchAdapter(config) {
@@ -1303,21 +1375,22 @@ function createTypesenseSearchAdapter(config) {
 					version: document.version,
 					tags: document.tags
 				};
-				if (config.mode === "hybrid" && config.embeddings) next.embedding = await createOllamaEmbedding(`${document.title}\n${document.section ?? ""}\n${document.content}`.trim(), config.embeddings);
+				if (config.mode === "hybrid" && config.embeddings) next.embedding = await createOllamaEmbedding(`${document.title}\n${document.section ?? ""}\n${document.content}`.trim(), config.embeddings, context.signal);
 				return next;
 			}));
 			if (docsForImport.length === 0) return;
-			await ensureTypesenseCollection(config, Array.isArray(docsForImport[0]?.embedding) ? docsForImport[0].embedding.length : void 0);
+			await ensureTypesenseCollection(config, Array.isArray(docsForImport[0]?.embedding) ? docsForImport[0].embedding.length : void 0, context.signal);
 			ensureOk(await fetch(`${getTypesenseSearchBase(config)}/collections/${encodeURIComponent(config.collection)}/documents/import?action=upsert`, {
 				method: "POST",
 				headers: {
 					"X-TYPESENSE-API-KEY": adminApiKey,
 					"Content-Type": "text/plain"
 				},
-				body: docsForImport.map((document) => JSON.stringify(document)).join("\n")
+				body: docsForImport.map((document) => JSON.stringify(document)).join("\n"),
+				signal: context.signal
 			}), "Failed to sync documents to Typesense");
 		},
-		async search(query, _context) {
+		async search(query, context) {
 			const params = new URLSearchParams({
 				q: query.query,
 				query_by: (config.queryBy ?? [
@@ -1332,10 +1405,13 @@ function createTypesenseSearchAdapter(config) {
 				highlight_fields: "content,title,section,description"
 			});
 			if (config.mode === "hybrid" && config.embeddings) {
-				const vector = await createOllamaEmbedding(query.query, config.embeddings);
+				const vector = await createOllamaEmbedding(query.query, config.embeddings, context.signal);
 				params.set("vector_query", `embedding:([${vector.join(",")}],k:${Math.max((query.limit ?? 10) * 4, 20)})`);
 			}
-			const response = await fetch(`${getTypesenseSearchBase(config)}/collections/${encodeURIComponent(config.collection)}/documents/search?${params.toString()}`, { headers: { "X-TYPESENSE-API-KEY": config.apiKey } });
+			const response = await fetch(`${getTypesenseSearchBase(config)}/collections/${encodeURIComponent(config.collection)}/documents/search?${params.toString()}`, {
+				headers: { "X-TYPESENSE-API-KEY": config.apiKey },
+				signal: context.signal
+			});
 			ensureOk(response, "Typesense search failed");
 			return ((await readResponseJson(response)).hits ?? []).map((hit) => {
 				const document = hit.document ?? {};
@@ -1382,7 +1458,7 @@ function resolveAskAISearchRequestConfig(options) {
 function createMcpSearchAdapter(config) {
 	return {
 		name: "mcp",
-		async search(query) {
+		async search(query, context) {
 			const endpoint = resolveMcpEndpoint(config.endpoint);
 			const protocolVersion = config.protocolVersion ?? DEFAULT_MCP_PROTOCOL_VERSION;
 			const toolName = config.toolName ?? "search_docs";
@@ -1407,7 +1483,8 @@ function createMcpSearchAdapter(config) {
 							version: "0.1.2"
 						}
 					}
-				})
+				}),
+				signal: context.signal
 			});
 			const initializePayload = await readMcpResponsePayload(initializeResponse);
 			ensureOk(initializeResponse, "MCP search initialization failed");
@@ -1435,7 +1512,8 @@ function createMcpSearchAdapter(config) {
 								locale: query.locale
 							}
 						}
-					})
+					}),
+					signal: context.signal
 				});
 				const payload = await readMcpResponsePayload(searchResponse);
 				ensureOk(searchResponse, "MCP search request failed");
@@ -1445,14 +1523,23 @@ function createMcpSearchAdapter(config) {
 				const parsed = JSON.parse(resultText);
 				return (Array.isArray(parsed) ? parsed : Array.isArray(parsed.results) ? parsed.results : Array.isArray(parsed.pages) ? parsed.pages : []).map(mapMcpSearchResult).filter((result) => Boolean(result));
 			} finally {
-				if (sessionId) await fetch(endpoint, {
-					method: "DELETE",
-					headers: {
-						...baseHeaders,
-						"mcp-protocol-version": protocolVersion,
-						"mcp-session-id": sessionId
+				if (sessionId) {
+					const cleanupController = new AbortController();
+					const cleanupTimeout = setTimeout(() => cleanupController.abort(), MCP_SESSION_CLEANUP_TIMEOUT_MS);
+					try {
+						await fetch(endpoint, {
+							method: "DELETE",
+							headers: {
+								...baseHeaders,
+								"mcp-protocol-version": protocolVersion,
+								"mcp-session-id": sessionId
+							},
+							signal: cleanupController.signal
+						});
+					} catch {} finally {
+						clearTimeout(cleanupTimeout);
 					}
-				}).catch(() => void 0);
+				}
 			}
 		}
 	};
@@ -1475,10 +1562,11 @@ function createAlgoliaSearchAdapter(config) {
 				body: JSON.stringify({ requests: context.documents.map((document) => ({
 					action: "addObject",
 					body: buildAlgoliaRecord(document)
-				})) })
+				})) }),
+				signal: context.signal
 			}), "Failed to sync documents to Algolia");
 		},
-		async search(query) {
+		async search(query, context) {
 			const response = await fetch(`${getAlgoliaBase(config)}/1/indexes/${encodeURIComponent(config.indexName)}/query`, {
 				method: "POST",
 				headers: {
@@ -1490,7 +1578,8 @@ function createAlgoliaSearchAdapter(config) {
 					query: query.query,
 					hitsPerPage: query.limit ?? config.maxResults ?? DEFAULT_SEARCH_LIMIT,
 					attributesToSnippet: ["content:20"]
-				})
+				}),
+				signal: context.signal
 			});
 			ensureOk(response, "Algolia search failed");
 			return ((await readResponseJson(response)).hits ?? []).map((hit) => {
@@ -1551,7 +1640,8 @@ async function performDocsSearch(options) {
 		documents,
 		locale: options.locale,
 		pathname: options.pathname,
-		siteTitle: options.siteTitle
+		siteTitle: options.siteTitle,
+		signal: options.signal
 	};
 	const query = {
 		query: options.query,
@@ -1568,10 +1658,23 @@ async function performDocsSearch(options) {
 		const results = await adapter.search(query, context);
 		if (search.provider === "simple") return results;
 		const localAudienceResults = audience === "agent" ? await createSimpleSearchAdapter().search(query, context) : [];
+		const localAgentProjectionResults = audience === "agent" ? buildAgentProjectionSearchResults(documents) : [];
 		const localPagePaths = new Set(options.pages.map((page) => normalizeUrlPathname(page.url)));
-		const safeAdapterResults = audience !== "agent" ? results : sanitizeExternalAgentSearchResults(results, localAudienceResults, search.provider === "mcp" ? (result) => !localPagePaths.has(normalizeUrlPathname(result.url)) : void 0);
-		return prioritizeLiteralInsideResults(options.query, mergeSearchResults(buildExactPageSearchResults(options.query, options.pages, audience), safeAdapterResults, localAudienceResults)).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
-	} catch {
+		const safeAdapterResults = audience !== "agent" ? results : sanitizeExternalAgentSearchResults(results, localAgentProjectionResults, options.baseUrl, options.strictExternalOrigins, search.provider === "mcp" ? (result) => shouldPreserveUnmatchedMcpResult({
+			result,
+			localPagePaths,
+			baseUrl: options.baseUrl,
+			strictExternalOrigins: options.strictExternalOrigins === true
+		}) : void 0);
+		if (options.supplementExternalResults === false) return safeAdapterResults.slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
+		const combinedResults = mergeSearchResults([
+			buildExactPageSearchResults(options.query, options.pages, audience),
+			safeAdapterResults,
+			localAudienceResults
+		], audience === "agent" ? (result) => getAskAIResultKey(result, options.baseUrl, options.strictExternalOrigins) : void 0);
+		return prioritizeLiteralInsideResults(options.query, combinedResults).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT);
+	} catch (error) {
+		if (options.failureMode === "throw") throw error;
 		return createSimpleSearchAdapter().search(query, context);
 	}
 }
@@ -1588,14 +1691,18 @@ async function buildDocsAskAIContext(options) {
 		locale: options.locale,
 		pathname: options.pathname,
 		siteTitle: options.siteTitle,
-		limit: searchLimit
+		baseUrl: options.baseUrl,
+		limit: searchLimit,
+		failureMode: options.searchFailureMode,
+		strictExternalOrigins: options.strictExternalOrigins,
+		signal: options.signal
 	});
 	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),
+			page: findPageForSearchResult(options.pages, result, options.baseUrl, options.strictExternalOrigins),
 			maxChars: maxResultChars,
 			baseUrl: options.baseUrl
 		});
@@ -1607,9 +1714,9 @@ async function buildDocsAskAIContext(options) {
 		};
 	}).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);
+	const sectionResultPaths = new Set(formattedResults.filter((result) => result.section).map((result) => getAskAIResultPageKey(result.url, options.baseUrl, options.strictExternalOrigins)));
+	const results = formattedResults.filter((result) => result.section || !sectionResultPaths.has(getAskAIResultPageKey(result.url, options.baseUrl, options.strictExternalOrigins))).filter((result) => {
+		const key = getAskAIResultKey(result, options.baseUrl, options.strictExternalOrigins);
 		if (seen.has(key)) return false;
 		seen.add(key);
 		return result.contextContent.length > 0;
@@ -1631,6 +1738,10 @@ async function buildDocsAskAIContext(options) {
 	const context = blocks.join("\n\n---\n\n");
 	return {
 		context,
+		blocks: blocks.map((text, index) => ({
+			text,
+			result: results[index]
+		})),
 		results: results.slice(0, blocks.length),
 		searchResults: rankedResults.map((item) => item.result),
 		packageHints: inferDocsAskAIPackageHints(context)

package/dist/{search-AMEoabYU.mjs → search-o4Ud6OXv.mjs}

@@ -1,11 +1,11 @@
-import "./agent-CxDzPqtl.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-OHp36znm.mjs";
-import "./sitemap-server-zFYctvCa.mjs";
-import "./agent-evals-BD17jOqL.mjs";
+import "./agent-BFqyqEnC.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-D57JXQLj.mjs";
+import "./sitemap-server-C1ibVKOy.mjs";
+import "./agent-evals-kJs2Y9xR.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-C9awWzEQ.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
 import "./server.mjs";
-import { h as resolveDocsContentDir, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty } from "./config-DZbZiYEa.mjs";
+import { h as resolveDocsContentDir, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty } from "./config-DASewQ0x.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/server.d.mts

@@ -1,7 +1,7 @@
-import { $t as McpDocsSearchConfig, At as DocsSearchDocument, C as DocsAgentTraceEventType, D as DocsAnalyticsEventInput, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, Et as DocsSearchAdapterContext, F as DocsAskAIFeedbackMessage, Ft as DocsSearchSourcePage, I as DocsAskAIFeedbackValue, It as DocsSitemapConfig, L as DocsAskAIMcpConfig, Mt as DocsSearchQuery, N as DocsAskAIFeedbackConfig, Nt as DocsSearchResult, P as DocsAskAIFeedbackData, S as DocsAgentTraceEventInput, T as DocsAnalyticsConfig, Tt as DocsSearchAdapter, Z as DocsConfig, a as ApiReferenceRenderer, b as DocsAgentGoldenTaskExpectation, bt as DocsReviewRulesConfig, ht as DocsObservabilityEventInput, kt as DocsSearchConfig, mt as DocsObservabilityEvent, pt as DocsObservabilityConfig, v as DocsAgentGoldenExpectedExample, vt as DocsReviewCiMode, w as DocsAgentTraceStatus, x as DocsAgentGoldenTaskFilters, y as DocsAgentGoldenTask, yt as DocsReviewConfig } from "./types-R-DN23yw.mjs";
-import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-CvRVnwdK.mjs";
+import { A as DocsAgentGoldenTaskExpectation, At as DocsReviewRulesConfig, Bt as DocsSearchDocument, Ct as DocsObservabilityConfig, D as DocsAgentGoldenExampleVerification, E as DocsAgentGoldenAnswerExpectation, F as DocsAnalyticsConfig, Ft as DocsSearchAdapter, G as DocsAskAIFeedbackMessage, Gt as DocsSearchSourcePage, Ht as DocsSearchQuery, I as DocsAnalyticsEvent, It as DocsSearchAdapterContext, K as DocsAskAIFeedbackValue, Kt as DocsSitemapConfig, L as DocsAnalyticsEventInput, Lt as DocsSearchAdapterFactory, M as DocsAgentTraceEventInput, N as DocsAgentTraceEventType, O as DocsAgentGoldenExpectedExample, Ot as DocsReviewCiMode, P as DocsAgentTraceStatus, S as DocsAgentEvaluationTaskInput, Tt as DocsObservabilityEventInput, U as DocsAskAIFeedbackConfig, Ut as DocsSearchResult, W as DocsAskAIFeedbackData, _ as DocsAgentEvaluationAnswerRequest, a as ApiReferenceRenderer, b as DocsAgentEvaluationSourceReference, g as DocsAgentEvaluationAnswerProvider, h as DocsAgentEvaluationAnswerInput, it as DocsCodeBlocksValidateConfig, j as DocsAgentGoldenTaskFilters, k as DocsAgentGoldenTask, kt as DocsReviewConfig, ln as McpDocsSearchConfig, q as DocsAskAIMcpConfig, st as DocsConfig, tt as DocsCodeBlocksPlannerProvider, v as DocsAgentEvaluationAnswerResult, wt as DocsObservabilityEvent, x as DocsAgentEvaluationSurface, y as DocsAgentEvaluationAnswerRunner, zt as DocsSearchConfig } from "./types-XHABMh_f.mjs";
+import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-B2WnG4fF.mjs";
 import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import { A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceId, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, ct as emitDocsObservabilityEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsObservabilityConfig, et as DOCS_AGENT_TRACE_EVENT_TYPES, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as createDocsAgentTraceContext, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, lt as getDocsRequestAnalyticsProperties, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as ResolvedDocsAnalyticsConfig, o as createSimpleSearchAdapter, ot as emitDocsAgentTraceEvent, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as ResolvedDocsObservabilityConfig, s as createTypesenseSearchAdapter, st as emitDocsAnalyticsEvent, t as buildDocsAskAIContext, tt as DocsAgentTraceContext, u as performDocsSearch, ut as resolveDocsAnalyticsConfig, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-9uEaC23e.mjs";
+import { A as resolveDocsSitemapRequest, B as normalizePromptProviderName, Bt as emitDocsObservabilityEvent, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, Ft as ResolvedDocsObservabilityConfig, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, Ht as resolveDocsAnalyticsConfig, I as PromptAction, It as createDocsAgentTraceContext, K as serializeOpenDocsProvider, L as PromptProviderChoice, Lt as createDocsAgentTraceId, M as DEFAULT_OPEN_DOCS_PROMPT, Mt as DOCS_AGENT_TRACE_EVENT_TYPES, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, Nt as DocsAgentTraceContext, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Pt as ResolvedDocsAnalyticsConfig, R as SerializeOpenDocsProviderOptions, Rt as emitDocsAgentTraceEvent, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, Ut as resolveDocsObservabilityConfig, V as parsePromptStringArray, Vt as getDocsRequestAnalyticsProperties, W as serializeDocsIcon, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider, zt as emitDocsAnalyticsEvent } from "./search-C1JitPwi.mjs";
 import { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/code-group-mdx.d.ts
@@ -38,6 +38,7 @@ interface ResolvedApiReferenceConfig {
 interface ApiReferenceOpenApiDiscovery {
   enabled: boolean;
   url?: string;
+  urlSource?: "default" | "configured";
   source?: "generated" | "configured";
   specUrl?: string;
   apiReferencePath?: string;
@@ -130,6 +131,54 @@ declare function buildDocsReviewWorkflowPathFilters(options: {
   configContent?: string;
 }): string[];
 //#endregion
+//#region src/code-blocks.d.ts
+interface DocsCodeBlockTarget {
+  id: string;
+  filePath: string;
+  relativePath: string;
+  lineStart: number;
+  lineEnd: number;
+  language?: string;
+  title?: string;
+  framework?: string;
+  packageManager?: string;
+  runnable: boolean;
+  env: string[];
+  meta: Record<string, string | boolean>;
+  code: string;
+}
+interface DocsCodeBlockCommand {
+  cmd: string;
+  args: string[];
+}
+interface DocsCodeBlockExecutionPlan {
+  id: string;
+  target: DocsCodeBlockTarget;
+  action: "execute" | "validate-syntax" | "skip";
+  template: string;
+  runtime?: string;
+  filePath?: string;
+  command?: DocsCodeBlockCommand;
+  requiredEnv: string[];
+  reason?: string;
+  planner: DocsCodeBlocksPlannerProvider;
+}
+type DocsCodeBlockValidationStatus = "PLAN" | "PASS" | "SKIP" | "FAIL";
+interface DocsCodeBlockValidationResult {
+  id: string;
+  target: DocsCodeBlockTarget;
+  plan: DocsCodeBlockExecutionPlan;
+  status: DocsCodeBlockValidationStatus;
+  stdout?: string;
+  stderr?: string;
+  exitCode?: number | null;
+  reason?: string;
+}
+type OptionalModuleImporter = (specifier: string) => Promise<unknown>;
+declare global {
+  var __DOCS_CODE_BLOCKS_MODULE_IMPORTER__: OptionalModuleImporter | undefined;
+}
+//#endregion
 //#region src/agent-evals.d.ts
 type DocsGoldenEvaluationStatus = "unmeasured" | "passed" | "failed";
 type DocsGoldenTaskFilters = DocsAgentGoldenTaskFilters;
@@ -156,6 +205,8 @@ interface DocsGoldenRetrievalMetrics {
   passed: boolean;
 }
 interface DocsGoldenCitationMetrics {
+  /** Where the citation evidence came from. Context/results are not model-answer citations. */
+  evidence: "context" | "results";
   expected: string[];
   actual: string[];
   missing: string[];
@@ -169,8 +220,13 @@ interface DocsGoldenCitationMetrics {
 interface DocsGoldenSelectionMetrics {
   requestedFramework?: string;
   requestedVersion?: string;
+  requestedLocale?: string;
+  expectedFramework?: string;
+  expectedVersion?: string;
+  expectedLocale?: string;
   firstFrameworkMatchRank: number | null;
   firstVersionMatchRank: number | null;
+  firstLocaleMatchRank: number | null;
   conflictingSources: string[];
   ambiguousSources: string[];
   passed: boolean;
@@ -179,12 +235,22 @@ interface DocsGoldenExampleResult {
   expected: DocsGoldenExpectedExample;
   matchedId?: string;
   source?: string;
+  verification: "present" | "syntax" | "execute";
+  status: "passed" | "failed" | "skipped";
+  reason?: string;
+  syntaxValid: boolean;
+  executed: boolean;
+  executionStatus?: DocsCodeBlockValidationResult["status"];
+  /** @deprecated Static/planner executability signal retained for report compatibility. */
   executable: boolean;
   passed: boolean;
 }
 interface DocsGoldenExampleMetrics {
   expected: number;
   matched: number;
+  syntaxValid: number;
+  executed: number;
+  /** @deprecated Count of statically/planner-executable examples retained for compatibility. */
   executable: number;
   results: DocsGoldenExampleResult[];
   passed: boolean;
@@ -203,9 +269,24 @@ interface DocsGoldenUsageMetrics {
   withinBudget: boolean;
   passed: boolean;
 }
+interface DocsGoldenAnswerMetrics {
+  evidence: "answer";
+  expected: boolean;
+  provided: boolean;
+  textIncludesMissing: string[];
+  textExcludesPresent: string[];
+  citations: string[];
+  requiredCitations: string[];
+  missingCitations: string[];
+  unexpectedCitations: string[];
+  forbiddenCitations: string[];
+  passed: boolean;
+}
 interface DocsGoldenTaskReport {
   id: string;
   query: string;
+  surface: DocsAgentEvaluationSurface;
+  provider: string;
   status: "passed" | "failed";
   passed: boolean;
   score: number;
@@ -213,6 +294,7 @@ interface DocsGoldenTaskReport {
   sources: DocsGoldenRetrievedSource[];
   retrieval: DocsGoldenRetrievalMetrics;
   citations: DocsGoldenCitationMetrics;
+  answer: DocsGoldenAnswerMetrics;
   selection: DocsGoldenSelectionMetrics;
   examples: DocsGoldenExampleMetrics;
   usage: DocsGoldenUsageMetrics;
@@ -227,13 +309,33 @@ interface DocsGoldenTasksReport {
   failedTaskCount: number;
   tasks: DocsGoldenTaskReport[];
 }
+interface RunDocsGoldenTasksOptions {
+  /** Default evaluation surface. Tasks may override this with `task.surface`. */
+  surface?: DocsAgentEvaluationSurface;
+  /** Search configuration used by configured-search and ask-ai-context. */
+  search?: boolean | DocsSearchConfig;
+  /** Production-resolved Ask AI retrieval config, including `ai.useMcp`. */
+  askAISearch?: boolean | DocsSearchConfig;
+  siteTitle?: string;
+  baseUrl?: string;
+  rootDir?: string;
+  /** Permit external configured search or HTTP answer calls. @default false */
+  allowNetwork?: boolean;
+  /** Per-task configured-search/Ask-AI retrieval timeout in milliseconds. @default 30000 */
+  searchTimeoutMs?: number;
+  /** Project code-block validation config used only by explicit execute expectations. */
+  codeBlocksValidate?: boolean | DocsCodeBlocksValidateConfig;
+  /** Optional actual-answer runner. No model or HTTP request is made when omitted. */
+  answer?: DocsAgentEvaluationAnswerProvider;
+}
 /**
- * Run deterministic, offline golden-task evaluations against MCP-ready docs pages.
+ * Run offline-by-default golden-task evaluations against MCP-ready docs pages.
+ * Configured external retrieval, HTTP answers, and runtime execution require explicit opt-in.
  * An empty task list is intentionally unmeasured so CI cannot turn absent coverage into a pass.
  */
-declare function runDocsGoldenTasks(pages: readonly DocsMcpPage[], tasks: readonly DocsGoldenTask[] | undefined): Promise<DocsGoldenTasksReport>;
+declare function runDocsGoldenTasks(pages: readonly DocsMcpPage[], tasks: readonly DocsGoldenTask[] | undefined, options?: RunDocsGoldenTasksOptions): Promise<DocsGoldenTasksReport>;
 //#endregion
 //#region src/sitemap-server.d.ts
 declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, type CreateDocsMcpServerOptions, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsMcpAgentContractSummary, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
+export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, type CreateDocsMcpServerOptions, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsMcpAgentContractSummary, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/server.mjs

@@ -1,11 +1,11 @@
 import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Bt as toDocsSitemapMarkdownUrl, Dt as DEFAULT_SITEMAP_MANIFEST_PATH, Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, Mt as buildDocsSitemapManifest, Nt as createDocsSitemapResponse, Ot as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Pt as readDocsSitemapManifestFromContentMap, Rt as resolveDocsSitemapPageLastmod, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, zt as resolveDocsSitemapRequest } from "./agent-CxDzPqtl.mjs";
-import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-OHp36znm.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-zFYctvCa.mjs";
-import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
+import { At as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Bt as resolveDocsSitemapPageLastmod, Ft as createDocsSitemapResponse, Ht as toDocsSitemapMarkdownUrl, It as readDocsSitemapManifestFromContentMap, Lt as renderDocsSitemapMarkdown, Mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Nt as DEFAULT_SITEMAP_XML_ROUTE, Pt as buildDocsSitemapManifest, Rt as renderDocsSitemapXml, Vt as resolveDocsSitemapRequest, jt as DEFAULT_SITEMAP_MD_ROUTE, kt as DEFAULT_SITEMAP_MANIFEST_PATH, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
+import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-D57JXQLj.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-C1ibVKOy.mjs";
+import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-kJs2Y9xR.mjs";
 import { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-1k0q6OAH.mjs";
+import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-hnJfj8-X.mjs";
 import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import "./code-blocks-C9awWzEQ.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
 
 export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };