@farming-labs/docs 0.2.75 → 0.2.78

package/dist/search-BmC8wVr0.mjs

@@ -1,3490 +0,0 @@
-import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, jt as resolveDocsAudienceMdxContent, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-BHqaZx-X.mjs";
-import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-
-//#region src/telemetry.ts
-const DOCS_PACKAGE_NAME = "@farming-labs/docs";
-const DOCS_PACKAGE_VERSION = "0.2.25";
-const DEFAULT_DOCS_TELEMETRY_ENDPOINT = "https://docs.farming-labs.dev/api/telemetry/events";
-const PROJECT_TELEMETRY_CACHE_TTL_MS = 1440 * 60 * 1e3;
-const PROJECT_TELEMETRY_CACHE_MAX_KEYS = 256;
-function getRuntimeEnv() {
-	if (typeof process === "undefined" || !process.env) return;
-	return process.env;
-}
-function readRuntimeEnv(name) {
-	const value = getRuntimeEnv()?.[name]?.trim();
-	return value ? value : void 0;
-}
-function isTruthyEnv(value) {
-	return /^(1|true|yes|on)$/i.test(value ?? "");
-}
-function isFalsyEnv(value) {
-	return /^(0|false|no|off)$/i.test(value ?? "");
-}
-function isBrowserRuntime() {
-	return typeof window !== "undefined" && typeof document !== "undefined";
-}
-function isProductionTelemetryRuntime() {
-	if (isBrowserRuntime()) return false;
-	const env = getRuntimeEnv();
-	if (!env) return true;
-	if (env.NODE_ENV === "test") return false;
-	if (env.VERCEL_ENV === "production") return true;
-	if (env.CONTEXT === "production" && isTruthyEnv(env.NETLIFY)) return true;
-	if (isTruthyEnv(env.CF_PAGES)) return true;
-	if (env.RENDER_SERVICE_ID || env.FLY_APP_NAME || env.RAILWAY_ENVIRONMENT) return true;
-	return env.NODE_ENV === "production";
-}
-function resolveDocsTelemetryConfig(telemetry) {
-	const envToggle = readRuntimeEnv("DOCS_TELEMETRY");
-	const envDisabled = readRuntimeEnv("DOCS_TELEMETRY_DISABLED");
-	if (isFalsyEnv(envToggle) || isTruthyEnv(envDisabled) || telemetry === false) return { enabled: false };
-	const objectConfig = telemetry && typeof telemetry === "object" ? telemetry : void 0;
-	if (objectConfig?.enabled === false) return { enabled: false };
-	return {
-		enabled: telemetry === true || objectConfig?.enabled === true || isTruthyEnv(envToggle) || isProductionTelemetryRuntime(),
-		endpoint: objectConfig?.endpoint?.trim() || readRuntimeEnv("DOCS_TELEMETRY_ENDPOINT") || DEFAULT_DOCS_TELEMETRY_ENDPOINT
-	};
-}
-function readRequestOrigin(request) {
-	if (!request?.url) return void 0;
-	try {
-		return new URL(request.url).origin;
-	} catch {
-		return;
-	}
-}
-/** Normalize an HTTP(S) telemetry site value to its origin. */
-function normalizeDocsTelemetryOrigin(candidate) {
-	if (typeof candidate !== "string") return void 0;
-	const trimmed = candidate.trim();
-	if (!trimmed) return void 0;
-	try {
-		const hasScheme = /^[a-z][a-z\d+.-]*:(?!\d)/i.test(trimmed);
-		const url = new URL(hasScheme ? trimmed : `https://${trimmed}`);
-		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
-		return url.origin;
-	} catch {
-		return;
-	}
-}
-/** Return whether a telemetry origin points at a local development server. */
-function isLocalDocsTelemetryOrigin(candidate) {
-	const origin = normalizeDocsTelemetryOrigin(candidate);
-	if (!origin) return false;
-	const hostname = new URL(origin).hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.+$/, "");
-	if ([
-		"localhost",
-		"localhost.localdomain",
-		"localhost6",
-		"localhost6.localdomain6",
-		"ip6-localhost",
-		"ip6-loopback"
-	].includes(hostname) || hostname.endsWith(".localhost")) return true;
-	if (hostname === "::" || hostname === "::1") return true;
-	const ipv4 = hostname.split(".").map((part) => Number(part));
-	if (ipv4.length === 4 && ipv4.every((part) => Number.isInteger(part) && part >= 0 && part <= 255)) return ipv4[0] === 127 || ipv4.every((part) => part === 0);
-	return /^::ffff:7f[0-9a-f]{2}:/.test(hostname) || hostname === "::ffff:0:0";
-}
-function isBlockedDocsTelemetryOrigin(candidate) {
-	if (candidate === void 0) return false;
-	return !normalizeDocsTelemetryOrigin(candidate) || isLocalDocsTelemetryOrigin(candidate);
-}
-function readDeploymentOrigin() {
-	const candidates = [
-		readRuntimeEnv("DOCS_SITE_URL"),
-		readRuntimeEnv("NEXT_PUBLIC_BASE_URL"),
-		readRuntimeEnv("NEXT_PUBLIC_SITE_URL"),
-		readRuntimeEnv("SITE_URL"),
-		readRuntimeEnv("URL"),
-		readRuntimeEnv("CF_PAGES_URL"),
-		readRuntimeEnv("VERCEL_PROJECT_PRODUCTION_URL"),
-		readRuntimeEnv("VERCEL_URL"),
-		readRuntimeEnv("DEPLOY_PRIME_URL")
-	];
-	for (const candidate of candidates) {
-		const origin = normalizeDocsTelemetryOrigin(candidate);
-		if (origin) return origin;
-	}
-}
-function detectDeployment() {
-	const env = getRuntimeEnv();
-	if (!env) return void 0;
-	if (env.VERCEL || env.VERCEL_ENV) return {
-		provider: "vercel",
-		environment: env.VERCEL_ENV,
-		id: env.VERCEL_DEPLOYMENT_ID ?? env.VERCEL_GIT_COMMIT_SHA,
-		region: env.VERCEL_REGION
-	};
-	if (env.NETLIFY) return {
-		provider: "netlify",
-		environment: env.CONTEXT,
-		id: env.DEPLOY_ID ?? env.COMMIT_REF
-	};
-	if (env.CF_PAGES) return {
-		provider: "cloudflare-pages",
-		environment: env.CF_PAGES_BRANCH,
-		id: env.CF_PAGES_COMMIT_SHA
-	};
-	if (env.RENDER_SERVICE_ID) return {
-		provider: "render",
-		environment: env.RENDER_ENV,
-		id: env.RENDER_SERVICE_ID
-	};
-	if (env.FLY_APP_NAME) return {
-		provider: "fly",
-		environment: env.FLY_APP_NAME,
-		id: env.FLY_ALLOC_ID,
-		region: env.FLY_REGION
-	};
-	if (env.RAILWAY_ENVIRONMENT) return {
-		provider: "railway",
-		environment: env.RAILWAY_ENVIRONMENT,
-		id: env.RAILWAY_DEPLOYMENT_ID
-	};
-	return env.NODE_ENV === "production" ? { environment: "production" } : void 0;
-}
-function detectRuntime() {
-	if (typeof process !== "undefined" && process.versions?.node) return {
-		name: "node",
-		version: process.versions.node
-	};
-	if (typeof navigator !== "undefined" && navigator.userAgent) return { name: "web-standard" };
-}
-function isObjectConfigEnabled(value, defaultEnabled) {
-	if (value === false) return false;
-	if (value === true) return true;
-	if (value && typeof value === "object" && !Array.isArray(value)) {
-		const enabled = value.enabled;
-		return enabled === false ? false : defaultEnabled || enabled === true;
-	}
-	return defaultEnabled;
-}
-function hasObjectConfig(value) {
-	return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-function getDocsTelemetryFeatures(config) {
-	const pageActions = config.pageActions;
-	const feedback = config.feedback;
-	return {
-		search: isObjectConfigEnabled(config.search, true),
-		ai: isObjectConfigEnabled(config.ai, false),
-		mcp: isObjectConfigEnabled(config.mcp, true),
-		llmsTxt: isObjectConfigEnabled(config.llmsTxt, true),
-		pageActions: hasObjectConfig(pageActions),
-		feedback: feedback === true || hasObjectConfig(feedback) && feedback.enabled !== false,
-		agentFeedback: feedback !== false && !(hasObjectConfig(feedback) && feedback.agent === false) && !(hasObjectConfig(feedback) && hasObjectConfig(feedback.agent) && feedback.agent.enabled === false),
-		sitemap: isObjectConfigEnabled(config.sitemap, true),
-		robots: isObjectConfigEnabled(config.robots, true),
-		apiReference: isObjectConfigEnabled(config.apiReference, false),
-		staticExport: config.staticExport === true,
-		changelog: isObjectConfigEnabled(config.changelog, false),
-		cloud: typeof config.cloud !== "undefined" && isObjectConfigEnabled(config.cloud, true),
-		review: isObjectConfigEnabled(config.review, true),
-		codeBlocksValidate: hasObjectConfig(config.codeBlocks) && Boolean(config.codeBlocks.validate)
-	};
-}
-function createDocsTelemetryEvent(config, input, context = {}) {
-	const telemetryConfig = config.telemetry && typeof config.telemetry === "object" ? config.telemetry : void 0;
-	const siteOriginCandidates = [
-		context.siteOrigin,
-		input.site?.origin,
-		telemetryConfig?.siteOrigin,
-		readRequestOrigin(context.request),
-		readDeploymentOrigin()
-	];
-	if (siteOriginCandidates.some(isBlockedDocsTelemetryOrigin)) return void 0;
-	const siteOrigin = siteOriginCandidates.map(normalizeDocsTelemetryOrigin).find((origin) => Boolean(origin));
-	const deployment = input.deployment ?? detectDeployment();
-	const properties = context.properties || input.properties ? {
-		...input.properties,
-		...context.properties
-	} : void 0;
-	return {
-		...input,
-		timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
-		package: {
-			name: DOCS_PACKAGE_NAME,
-			version: DOCS_PACKAGE_VERSION,
-			...input.package
-		},
-		framework: input.framework ?? context.framework,
-		runtime: input.runtime ?? detectRuntime(),
-		site: siteOrigin ? { origin: siteOrigin } : input.site,
-		deployment,
-		features: input.features ?? getDocsTelemetryFeatures(config),
-		properties
-	};
-}
-function projectEventKey(event) {
-	return [
-		event.package.name,
-		event.package.version,
-		event.framework ?? "",
-		event.site?.origin ?? "",
-		event.deployment?.provider ?? "",
-		event.deployment?.environment ?? "",
-		event.deployment?.id ?? ""
-	].join("|");
-}
-function getSentProjectKeys() {
-	const globalValue = globalThis;
-	globalValue.__farmingLabsDocsTelemetryProjectKeys__ ??= /* @__PURE__ */ new Map();
-	return globalValue.__farmingLabsDocsTelemetryProjectKeys__;
-}
-function pruneSentProjectKeys(sent, now) {
-	for (const [key, expiresAt] of sent) if (expiresAt <= now) sent.delete(key);
-	while (sent.size >= PROJECT_TELEMETRY_CACHE_MAX_KEYS) {
-		const oldestKey = sent.keys().next().value;
-		if (!oldestKey) return;
-		sent.delete(oldestKey);
-	}
-}
-async function emitDocsTelemetryEvent(telemetry, event) {
-	const resolved = resolveDocsTelemetryConfig(telemetry);
-	const eventSiteOrigin = event.site?.origin;
-	const normalizedSiteOrigin = normalizeDocsTelemetryOrigin(eventSiteOrigin);
-	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function" || eventSiteOrigin !== void 0 && (!normalizedSiteOrigin || isLocalDocsTelemetryOrigin(eventSiteOrigin))) return;
-	const eventToSend = normalizedSiteOrigin ? {
-		...event,
-		site: { origin: normalizedSiteOrigin }
-	} : event;
-	try {
-		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
-		const headers = { "content-type": "application/json" };
-		if (ingestKey) headers["x-docs-telemetry-key"] = ingestKey;
-		await fetch(resolved.endpoint, {
-			method: "POST",
-			headers,
-			body: JSON.stringify({ event: eventToSend }),
-			keepalive: true
-		});
-	} catch {}
-}
-function emitDocsTelemetryProjectEvent(config, context = {}) {
-	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
-	if (!event) return;
-	const key = projectEventKey(event);
-	const sent = getSentProjectKeys();
-	const now = Date.now();
-	const expiresAt = sent.get(key);
-	if (expiresAt && expiresAt > now) return;
-	if (typeof expiresAt === "number") sent.delete(key);
-	pruneSentProjectKeys(sent, now);
-	sent.set(key, now + PROJECT_TELEMETRY_CACHE_TTL_MS);
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-function emitDocsTelemetryAgentSurfaceEvent(config, context) {
-	const event = createDocsTelemetryEvent(config, {
-		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
-		properties: { surface: context.surface }
-	}, context);
-	if (!event) return;
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-function emitDocsTelemetryMcpToolEvent(config, context) {
-	const event = createDocsTelemetryEvent(config, {
-		type: "mcp_tool_used",
-		properties: {
-			tool: context.tool,
-			locale: context.locale,
-			resultCount: context.resultCount
-		}
-	}, context);
-	if (!event) return;
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-function inferDocsTelemetryAgentSurface(request, options) {
-	const url = new URL(request.url);
-	const method = request.method.toUpperCase();
-	const feedbackRequest = resolveDocsAgentFeedbackRequest(url, resolveDocsAgentFeedbackConfig(options.feedback));
-	if ((method === "GET" || method === "HEAD") && isDocsAgentDiscoveryRequest(url)) return "agent_spec";
-	if ((method === "GET" || method === "HEAD") && feedbackRequest?.kind === "schema") return "agent_feedback_schema";
-	if (method === "POST" && feedbackRequest?.kind === "submit") return "agent_feedback_submit";
-	if (method === "GET" || method === "HEAD") {
-		if (isDocsAgentsRequest(url) || resolveDocsAgentsFormat(url) === "agents") return "agents";
-		if (isDocsSkillRequest(url) || resolveDocsSkillFormat(url) === "skill") return "skill";
-		if (resolveDocsMarkdownRequest(options.entry, url, request)) return "markdown";
-		if (resolveDocsLlmsTxtRequest(url, options.llmsTxt, options.entry)) return "llms";
-	}
-	if (method === "POST") return "ask_ai";
-}
-
-//#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";
-const GENERATED_AGENT_PROVENANCE_VERSION = 1;
-function normalizeLineEndings(value) {
-	return value.replace(/\r\n?/g, "\n").replace(/^\uFEFF/, "");
-}
-function normalizeGeneratedAgentContent(value) {
-	return normalizeLineEndings(value).trimEnd();
-}
-function hashGeneratedAgentContent(value) {
-	const normalized = normalizeGeneratedAgentContent(value);
-	const bytes = new TextEncoder().encode(normalized);
-	let hash = 14695981039346656037n;
-	for (const byte of bytes) {
-		hash ^= BigInt(byte);
-		hash = BigInt.asUintN(64, hash * 1099511628211n);
-	}
-	return `fnv1a64:${hash.toString(16).padStart(16, "0")}`;
-}
-function parseProvenanceBlock(rawBlock) {
-	const entries = /* @__PURE__ */ new Map();
-	for (const line of rawBlock.split("\n")) {
-		const trimmed = line.trim();
-		if (!trimmed) continue;
-		const separatorIndex = trimmed.indexOf("=");
-		if (separatorIndex <= 0) continue;
-		const key = trimmed.slice(0, separatorIndex).trim();
-		const value = trimmed.slice(separatorIndex + 1).trim();
-		if (!key || !value) continue;
-		entries.set(key, value);
-	}
-	const version = Number.parseInt(entries.get("version") ?? "", 10);
-	const sourceKind = entries.get("sourceKind");
-	const sourceHash = entries.get("sourceHash");
-	const settingsHash = entries.get("settingsHash");
-	const outputHash = entries.get("outputHash");
-	const generatedAt = entries.get("generatedAt");
-	if (!Number.isFinite(version) || sourceKind !== "resolved-page" && sourceKind !== "agent-md" || !sourceHash || !settingsHash || !outputHash || !generatedAt) return;
-	return {
-		version,
-		sourceKind,
-		sourceHash,
-		settingsHash,
-		outputHash,
-		generatedAt
-	};
-}
-function parseGeneratedAgentDocument(raw) {
-	const normalized = normalizeLineEndings(raw);
-	const headerPattern = new RegExp(`^<!-- ${GENERATED_AGENT_PROVENANCE_MARKER}\\n([\\s\\S]*?)\\n-->\\n?`);
-	const match = normalized.match(headerPattern);
-	if (!match) return { content: normalized };
-	return {
-		provenance: parseProvenanceBlock(match[1]),
-		content: normalized.slice(match[0].length)
-	};
-}
-function stripGeneratedAgentProvenance(raw) {
-	return parseGeneratedAgentDocument(raw).content;
-}
-function serializeGeneratedAgentDocument(content, provenance) {
-	const normalizedContent = normalizeGeneratedAgentContent(content);
-	return `${[
-		`<!-- ${GENERATED_AGENT_PROVENANCE_MARKER}`,
-		`version=${provenance.version}`,
-		`sourceKind=${provenance.sourceKind}`,
-		`sourceHash=${provenance.sourceHash}`,
-		`settingsHash=${provenance.settingsHash}`,
-		`outputHash=${provenance.outputHash}`,
-		`generatedAt=${provenance.generatedAt}`,
-		"-->",
-		normalizedContent
-	].join("\n")}\n`;
-}
-
-//#endregion
-//#region src/retrieval-digest.ts
-const SHA256_INITIAL_STATE = [
-	1779033703,
-	3144134277,
-	1013904242,
-	2773480762,
-	1359893119,
-	2600822924,
-	528734635,
-	1541459225
-];
-const SHA256_ROUND_CONSTANTS = [
-	1116352408,
-	1899447441,
-	3049323471,
-	3921009573,
-	961987163,
-	1508970993,
-	2453635748,
-	2870763221,
-	3624381080,
-	310598401,
-	607225278,
-	1426881987,
-	1925078388,
-	2162078206,
-	2614888103,
-	3248222580,
-	3835390401,
-	4022224774,
-	264347078,
-	604807628,
-	770255983,
-	1249150122,
-	1555081692,
-	1996064986,
-	2554220882,
-	2821834349,
-	2952996808,
-	3210313671,
-	3336571891,
-	3584528711,
-	113926993,
-	338241895,
-	666307205,
-	773529912,
-	1294757372,
-	1396182291,
-	1695183700,
-	1986661051,
-	2177026350,
-	2456956037,
-	2730485921,
-	2820302411,
-	3259730800,
-	3345764771,
-	3516065817,
-	3600352804,
-	4094571909,
-	275423344,
-	430227734,
-	506948616,
-	659060556,
-	883997877,
-	958139571,
-	1322822218,
-	1537002063,
-	1747873779,
-	1955562222,
-	2024104815,
-	2227730452,
-	2361852424,
-	2428436474,
-	2756734187,
-	3204031479,
-	3329325298
-];
-function rotateRight(value, bits) {
-	return value >>> bits | value << 32 - bits;
-}
-function normalizeDigestContent(value) {
-	return value.replace(/\r\n?/gu, "\n").replace(/^\uFEFF/u, "").trimEnd();
-}
-/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
-function isDocsRetrievalCanonicalUrl(value) {
-	const hasUnsafeCharacter = value.includes("\\") || Array.from(value).some((character) => {
-		const codePoint = character.codePointAt(0) ?? 0;
-		return codePoint <= 31 || codePoint === 127;
-	});
-	if (!value || value !== value.trim() || value.length > 4096 || hasUnsafeCharacter) return false;
-	if (/^\/(?!\/)/u.test(value)) try {
-		new URL(value, "https://docs.local");
-		return true;
-	} catch {
-		return false;
-	}
-	try {
-		const url = new URL(value);
-		return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
-	} catch {
-		return false;
-	}
-}
-/**
-* Hash a retrieval source projection with portable SHA-256.
-*
-* The projection is normalized by removing one leading BOM, converting CRLF/CR
-* line endings to LF, and trimming trailing whitespace. The helper is exported so
-* agents can independently verify provenance in Node, edge, and browser runtimes.
-*/
-function digestDocsRetrievalContent(value) {
-	const input = new TextEncoder().encode(normalizeDigestContent(value));
-	const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
-	const padded = new Uint8Array(paddedLength);
-	padded.set(input);
-	padded[input.length] = 128;
-	const bitLength = input.length * 8;
-	const dataView = new DataView(padded.buffer);
-	dataView.setUint32(paddedLength - 8, Math.floor(bitLength / 4294967296), false);
-	dataView.setUint32(paddedLength - 4, bitLength >>> 0, false);
-	const state = Uint32Array.from(SHA256_INITIAL_STATE);
-	const words = new Uint32Array(64);
-	for (let offset = 0; offset < padded.length; offset += 64) {
-		for (let index = 0; index < 16; index += 1) words[index] = dataView.getUint32(offset + index * 4, false);
-		for (let index = 16; index < 64; index += 1) {
-			const previous15 = words[index - 15];
-			const previous2 = words[index - 2];
-			const sigma0 = rotateRight(previous15, 7) ^ rotateRight(previous15, 18) ^ previous15 >>> 3;
-			const sigma1 = rotateRight(previous2, 17) ^ rotateRight(previous2, 19) ^ previous2 >>> 10;
-			words[index] = words[index - 16] + sigma0 + words[index - 7] + sigma1 >>> 0;
-		}
-		let a = state[0];
-		let b = state[1];
-		let c = state[2];
-		let d = state[3];
-		let e = state[4];
-		let f = state[5];
-		let g = state[6];
-		let h = state[7];
-		for (let index = 0; index < 64; index += 1) {
-			const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
-			const choice = e & f ^ ~e & g;
-			const temporary1 = h + sum1 + choice + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
-			const temporary2 = (rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
-			h = g;
-			g = f;
-			f = e;
-			e = d + temporary1 >>> 0;
-			d = c;
-			c = b;
-			b = a;
-			a = temporary1 + temporary2 >>> 0;
-		}
-		state[0] = state[0] + a >>> 0;
-		state[1] = state[1] + b >>> 0;
-		state[2] = state[2] + c >>> 0;
-		state[3] = state[3] + d >>> 0;
-		state[4] = state[4] + e >>> 0;
-		state[5] = state[5] + f >>> 0;
-		state[6] = state[6] + g >>> 0;
-		state[7] = state[7] + h >>> 0;
-	}
-	return `sha256:${Array.from(state, (word) => word.toString(16).padStart(8, "0")).join("")}`;
-}
-
-//#endregion
-//#region src/agent-scope.ts
-/** Normalize framework aliases used by page metadata, agent contracts, MCP, and evaluations. */
-function normalizeAgentFramework(value) {
-	const normalized = value.toLowerCase().replace(/[^a-z0-9]/gu, "");
-	if ([
-		"next",
-		"nextjs",
-		"nextjsapp",
-		"reactnext"
-	].includes(normalized)) return "nextjs";
-	if ([
-		"tanstack",
-		"tanstackstart",
-		"start"
-	].includes(normalized)) return "tanstackstart";
-	if (["svelte", "sveltekit"].includes(normalized)) return "sveltekit";
-	if (["nuxt", "nuxtjs"].includes(normalized)) return "nuxt";
-	return normalized;
-}
-function normalizeAgentLocale(value) {
-	return value.trim().toLowerCase().replace(/_/gu, "-");
-}
-function normalizeAgentVersion(value) {
-	return value.trim().toLowerCase().replace(/^v(?=\d)/u, "");
-}
-function normalizeAgentScopeValues(value) {
-	const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
-	return Array.from(new Set(values.map((item) => item.trim()).filter(Boolean)));
-}
-function compareVersions(left, right) {
-	for (let index = 0; index < 3; index += 1) if (left[index] !== right[index]) return left[index] > right[index] ? 1 : -1;
-	return 0;
-}
-function parseExactVersion(value) {
-	const match = normalizeAgentVersion(value).match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-[0-9a-z.-]+)?(?:\+[0-9a-z.-]+)?$/iu);
-	if (!match) return void 0;
-	return [
-		Number(match[1]),
-		Number(match[2] ?? 0),
-		Number(match[3] ?? 0)
-	];
-}
-function parseVersionOperand(value) {
-	const normalized = normalizeAgentVersion(value);
-	if (normalized === "*" || normalized === "x") return {
-		version: [
-			0,
-			0,
-			0
-		],
-		components: 0,
-		wildcard: true
-	};
-	const match = normalized.match(/^(\d+)(?:\.(\d+|x|\*))?(?:\.(\d+|x|\*))?$/iu);
-	if (!match) return void 0;
-	const raw = [
-		match[1],
-		match[2],
-		match[3]
-	];
-	const wildcardIndex = raw.findIndex((part, index) => index > 0 && (part?.toLowerCase() === "x" || part === "*"));
-	if (wildcardIndex >= 0 && raw.slice(wildcardIndex + 1).some((part) => part && part.toLowerCase() !== "x" && part !== "*")) return;
-	const components = wildcardIndex >= 0 ? wildcardIndex : raw.filter(Boolean).length;
-	return {
-		version: [
-			Number(raw[0]),
-			Number(raw[1] ?? 0) || 0,
-			Number(raw[2] ?? 0) || 0
-		],
-		components,
-		wildcard: wildcardIndex >= 0
-	};
-}
-function nextVersionBoundary(operand) {
-	const [major, minor] = operand.version;
-	if (operand.components <= 0) return void 0;
-	if (operand.components === 1) return [
-		major + 1,
-		0,
-		0
-	];
-	return [
-		major,
-		minor + 1,
-		0
-	];
-}
-function operandRange(operand) {
-	if (operand.components === 0) return {
-		minimumInclusive: true,
-		maximumInclusive: false
-	};
-	if (operand.components < 3 || operand.wildcard) return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum: nextVersionBoundary(operand),
-		maximumInclusive: false
-	};
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum: operand.version,
-		maximumInclusive: true
-	};
-}
-function caretRange(operand) {
-	const [major, minor, patch] = operand.version;
-	let maximum;
-	if (major > 0) maximum = [
-		major + 1,
-		0,
-		0
-	];
-	else if (operand.components <= 1) maximum = [
-		1,
-		0,
-		0
-	];
-	else if (minor > 0 || operand.components === 2) maximum = [
-		0,
-		minor + 1,
-		0
-	];
-	else maximum = [
-		0,
-		0,
-		patch + 1
-	];
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum,
-		maximumInclusive: false
-	};
-}
-function tildeRange(operand) {
-	const [major, minor] = operand.version;
-	const maximum = operand.components <= 1 ? [
-		major + 1,
-		0,
-		0
-	] : [
-		major,
-		minor + 1,
-		0
-	];
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum,
-		maximumInclusive: false
-	};
-}
-function intersectRanges(left, right) {
-	let minimum = left.minimum;
-	let minimumInclusive = left.minimumInclusive;
-	if (!minimum || right.minimum && compareVersions(right.minimum, minimum) > 0) {
-		minimum = right.minimum;
-		minimumInclusive = right.minimumInclusive;
-	} else if (right.minimum && compareVersions(right.minimum, minimum) === 0) minimumInclusive = minimumInclusive && right.minimumInclusive;
-	let maximum = left.maximum;
-	let maximumInclusive = left.maximumInclusive;
-	if (!maximum || right.maximum && compareVersions(right.maximum, maximum) < 0) {
-		maximum = right.maximum;
-		maximumInclusive = right.maximumInclusive;
-	} else if (right.maximum && compareVersions(right.maximum, maximum) === 0) maximumInclusive = maximumInclusive && right.maximumInclusive;
-	if (minimum && maximum) {
-		const compared = compareVersions(minimum, maximum);
-		if (compared > 0 || compared === 0 && !(minimumInclusive && maximumInclusive)) return void 0;
-	}
-	return {
-		minimum,
-		minimumInclusive,
-		maximum,
-		maximumInclusive
-	};
-}
-function comparatorRange(operator, operand) {
-	if (!operator || operator === "=") return operandRange(operand);
-	if (operator === ">=") return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximumInclusive: false
-	};
-	if (operator === ">") {
-		const partialBoundary = operand.components < 3 ? nextVersionBoundary(operand) : void 0;
-		return {
-			minimum: partialBoundary ?? operand.version,
-			minimumInclusive: Boolean(partialBoundary),
-			maximumInclusive: false
-		};
-	}
-	if (operator === "<") return {
-		minimumInclusive: true,
-		maximum: operand.version,
-		maximumInclusive: false
-	};
-	const partialBoundary = operand.components < 3 ? nextVersionBoundary(operand) : void 0;
-	return {
-		minimumInclusive: true,
-		maximum: partialBoundary ?? operand.version,
-		maximumInclusive: !partialBoundary
-	};
-}
-function parseVersionRangeBranch(value) {
-	const branch = normalizeAgentVersion(value).trim();
-	if (!branch) return void 0;
-	const hyphen = branch.match(/^(.+?)\s+-\s+(.+)$/u);
-	if (hyphen) {
-		const minimumOperand = parseVersionOperand(hyphen[1]);
-		const maximumOperand = parseVersionOperand(hyphen[2]);
-		if (!minimumOperand || !maximumOperand) return void 0;
-		const maximumBoundary = maximumOperand.components < 3 ? nextVersionBoundary(maximumOperand) : maximumOperand.version;
-		return intersectRanges({
-			minimum: minimumOperand.version,
-			minimumInclusive: true,
-			maximumInclusive: false
-		}, {
-			minimumInclusive: true,
-			maximum: maximumBoundary,
-			maximumInclusive: maximumOperand.components === 3
-		});
-	}
-	const special = branch.match(/^(\^|~)\s*(.+)$/u);
-	if (special) {
-		const operand = parseVersionOperand(special[2]);
-		if (!operand || operand.components === 0) return void 0;
-		return special[1] === "^" ? caretRange(operand) : tildeRange(operand);
-	}
-	const comparators = Array.from(branch.matchAll(/(>=|<=|>|<|=)\s*([^\s]+)/gu));
-	if (comparators.length > 0) {
-		if (comparators.map((match) => match[0]).join(" ").replace(/\s+/gu, " ") !== branch.replace(/\s+/gu, " ")) return void 0;
-		let range = {
-			minimumInclusive: true,
-			maximumInclusive: false
-		};
-		for (const comparator of comparators) {
-			const operand = parseVersionOperand(comparator[2]);
-			if (!operand) return void 0;
-			const next = intersectRanges(range, comparatorRange(comparator[1], operand));
-			if (!next) return void 0;
-			range = next;
-		}
-		return range;
-	}
-	const operand = parseVersionOperand(branch);
-	return operand ? operandRange(operand) : void 0;
-}
-function parseVersionRanges(value) {
-	return normalizeAgentVersion(value).split("||").map((branch) => parseVersionRangeBranch(branch)).filter((range) => Boolean(range));
-}
-function parseVersionConstraintBranches(value) {
-	const ranges = parseVersionRanges(value);
-	if (ranges.length > 0) return ranges.map((range) => ({
-		kind: "range",
-		range
-	}));
-	const normalized = normalizeAgentVersion(value);
-	return normalized ? [{
-		kind: "opaque",
-		value: normalized
-	}] : [];
-}
-function intersectVersionConstraintBranches(left, right) {
-	if (left.kind === "opaque" || right.kind === "opaque") return left.kind === "opaque" && right.kind === "opaque" && left.value === right.value ? left : void 0;
-	const range = intersectRanges(left.range, right.range);
-	return range ? {
-		kind: "range",
-		range
-	} : void 0;
-}
-/**
-* Return true when choosing one alternative from every group can select one shared version.
-*
-* Each inner group is an OR list while the groups themselves are intersected. Computing the
-* accumulated range prevents pairwise matches from accepting three mutually incompatible scopes.
-*/
-function agentVersionConstraintGroupsOverlap(groups) {
-	if (groups.length === 0) return false;
-	let intersections = groups[0].flatMap(parseVersionConstraintBranches);
-	if (intersections.length === 0) return false;
-	for (const group of groups.slice(1)) {
-		const branches = group.flatMap(parseVersionConstraintBranches);
-		if (branches.length === 0) return false;
-		intersections = intersections.flatMap((intersection) => branches.map((branch) => intersectVersionConstraintBranches(intersection, branch)).filter((value) => Boolean(value)));
-		if (intersections.length === 0) return false;
-	}
-	return true;
-}
-function rangeContains(range, version) {
-	if (range.minimum) {
-		const compared = compareVersions(version, range.minimum);
-		if (compared < 0 || compared === 0 && !range.minimumInclusive) return false;
-	}
-	if (range.maximum) {
-		const compared = compareVersions(version, range.maximum);
-		if (compared > 0 || compared === 0 && !range.maximumInclusive) return false;
-	}
-	return true;
-}
-function rangesOverlap(left, right) {
-	return Boolean(intersectRanges(left, right));
-}
-/** Match an exact requested version against an exact or range-like documented constraint. */
-function agentVersionConstraintMatches(requested, constraint) {
-	if (normalizeAgentVersion(requested) === normalizeAgentVersion(constraint)) return Boolean(normalizeAgentVersion(requested));
-	const wanted = parseExactVersion(requested);
-	if (!wanted) return false;
-	return parseVersionRanges(constraint).some((range) => rangeContains(range, wanted));
-}
-/** Return true when two exact or range-like documented version constraints can select one version. */
-function agentVersionConstraintsOverlap(left, right) {
-	const normalizedLeft = normalizeAgentVersion(left);
-	if (normalizedLeft === normalizeAgentVersion(right)) return Boolean(normalizedLeft);
-	const leftRanges = parseVersionRanges(left);
-	const rightRanges = parseVersionRanges(right);
-	return leftRanges.some((leftRange) => rightRanges.some((rightRange) => rangesOverlap(leftRange, rightRange)));
-}
-
-//#endregion
-//#region src/search.ts
-const DEFAULT_SEARCH_LIMIT = 10;
-const MAX_SEARCH_SNIPPET_CHARS = 160;
-const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
-const MCP_SESSION_CLEANUP_TIMEOUT_MS = 1e3;
-const syncedIndexes = /* @__PURE__ */ new Map();
-const syncingIndexes = /* @__PURE__ */ new Map();
-const ALGOLIA_MAX_RECORD_BYTES = 9500;
-const DEFAULT_ASK_AI_CONTEXT_CHARS = 24e3;
-const DEFAULT_ASK_AI_RESULT_CHARS = 6e3;
-const MAX_SEARCH_FILTER_VALUES = 16;
-const MAX_SEARCH_FILTER_VALUE_CHARS = 128;
-const MAX_SEARCH_FILTER_RAW_CHARS = 4096;
-const MAX_SEARCH_FILTER_SEGMENTS = 64;
-const MAX_PROVIDER_SCOPE_FILTER_IDS = 1e3;
-const MAX_PROVIDER_SCOPE_FILTER_CHARS = 16e3;
-const ALGOLIA_BATCH_OPERATIONS = 1e3;
-const MAX_SEARCH_WARNINGS = 16;
-const MAX_SEARCH_WARNING_VALUES = 16;
-const MAX_SEARCH_WARNING_PAGE_URLS = 8;
-const RETRIEVAL_INDEX_FORMAT = "docs-retrieval-index.v1";
-const MAX_RETRIEVAL_SOURCE_URL_CHARS = 4096;
-const MAX_RETRIEVAL_SOURCE_VALUE_CHARS = 256;
-const SEARCH_FILTER_FIELDS = [
-	"framework",
-	"version",
-	"package",
-	"tags"
-];
-const SEARCH_AMBIGUITY_FIELDS = [
-	"framework",
-	"version",
-	"package"
-];
-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 normalizeDocsSearchFilterValue(field, value) {
-	const bounded = value.trim().slice(0, MAX_SEARCH_FILTER_VALUE_CHARS).trim();
-	if (!bounded) return "";
-	if (field === "framework") return normalizeAgentFramework(bounded);
-	if (field === "version") return normalizeAgentVersion(bounded);
-	return bounded.toLowerCase();
-}
-function normalizeDocsSearchFilterValues(field, input) {
-	const values = typeof input === "string" ? [input] : input ?? [];
-	const normalized = [];
-	const seen = /* @__PURE__ */ new Set();
-	let remainingChars = MAX_SEARCH_FILTER_RAW_CHARS;
-	let remainingSegments = MAX_SEARCH_FILTER_SEGMENTS;
-	for (const item of values) {
-		if (remainingChars <= 0 || remainingSegments <= 0) break;
-		const boundedItem = item.slice(0, remainingChars);
-		remainingChars -= boundedItem.length;
-		for (const part of boundedItem.split(",")) {
-			if (remainingSegments <= 0) break;
-			remainingSegments -= 1;
-			const value = normalizeDocsSearchFilterValue(field, part);
-			if (!value || seen.has(value)) continue;
-			seen.add(value);
-			normalized.push(value);
-			if (normalized.length >= MAX_SEARCH_FILTER_VALUES) return normalized;
-		}
-	}
-	return normalized;
-}
-/** Normalize scalar or array-valued scope filters for programmatic, HTTP, and MCP callers. */
-function normalizeDocsSearchFilters(input = {}) {
-	const filters = {};
-	for (const field of SEARCH_FILTER_FIELDS) {
-		const values = normalizeDocsSearchFilterValues(field, input[field]);
-		if (values.length > 0) filters[field] = values;
-	}
-	return filters;
-}
-/** Parse the public search scope parameters from a URL query string. */
-function resolveDocsSearchFilters(searchParams) {
-	return normalizeDocsSearchFilters({
-		framework: searchParams.getAll("framework"),
-		version: searchParams.getAll("version"),
-		package: searchParams.getAll("package"),
-		tags: searchParams.getAll("tags")
-	});
-}
-/** Resolve search filters and the backwards-compatible structured response opt-in. */
-function resolveDocsSearchRequest(searchParams) {
-	return {
-		filters: resolveDocsSearchFilters(searchParams),
-		structured: searchParams.get("response") === "structured"
-	};
-}
-function hasDocsSearchFilters(filters) {
-	return SEARCH_FILTER_FIELDS.some((field) => (filters[field]?.length ?? 0) > 0);
-}
-function resolveProviderScopeDocumentIds(query, context, corpusId) {
-	if (!hasDocsSearchFilters(query.filters ?? {})) return void 0;
-	const documents = corpusId ? buildDocsSearchDocuments(context.pages, context.chunking ?? { strategy: "section" }, "human") : context.documents;
-	const ids = Array.from(new Set(documents.map((document) => corpusId ? makeHostedProviderDocumentId(corpusId, document.id) : document.id)));
-	return ids.length <= MAX_PROVIDER_SCOPE_FILTER_IDS ? ids : [];
-}
-function docsSearchFiltersMatch(expected, actual) {
-	return SEARCH_FILTER_FIELDS.every((field) => {
-		const expectedValues = expected[field] ?? [];
-		const actualValues = actual[field] ?? [];
-		return expectedValues.length === actualValues.length && expectedValues.every((value) => actualValues.includes(value));
-	});
-}
-function parseVerifiedMcpSearchFilters(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-	const record = value;
-	const filterFields = SEARCH_FILTER_FIELDS;
-	if (Object.keys(record).some((field) => !filterFields.includes(field))) return;
-	const input = {};
-	for (const field of SEARCH_FILTER_FIELDS) {
-		const values = record[field];
-		if (values === void 0) continue;
-		if (!Array.isArray(values) || values.length > MAX_SEARCH_FILTER_VALUES || values.some((item) => typeof item !== "string" || item.length > MAX_SEARCH_FILTER_VALUE_CHARS)) return;
-		input[field] = values;
-	}
-	const normalized = normalizeDocsSearchFilters(input);
-	for (const field of SEARCH_FILTER_FIELDS) {
-		const values = record[field];
-		if (values === void 0) continue;
-		if (!Array.isArray(values) || values.length !== (normalized[field]?.length ?? 0) || values.some((value, index) => value !== normalized[field]?.[index])) return;
-	}
-	return normalized;
-}
-function normalizeDocsSearchMetadataValues(field, value) {
-	const values = normalizeAgentScopeValues(value);
-	return Array.from(new Set(values.map((item) => normalizeDocsSearchFilterValue(field, item)).filter((item) => Boolean(item))));
-}
-function valuesOverlap(left, right, matches) {
-	return left.some((leftValue) => right.some((rightValue) => matches(leftValue, rightValue)));
-}
-function resolveDocsSearchPageScope(page) {
-	const topFramework = normalizeDocsSearchMetadataValues("framework", page.framework);
-	const contractFramework = normalizeDocsSearchMetadataValues("framework", page.agent?.appliesTo?.framework);
-	const topVersion = normalizeDocsSearchMetadataValues("version", page.version);
-	const contractVersion = normalizeDocsSearchMetadataValues("version", page.agent?.appliesTo?.version);
-	const packageValues = normalizeDocsSearchMetadataValues("package", page.agent?.appliesTo?.package);
-	const tags = normalizeDocsSearchMetadataValues("tags", page.tags);
-	const conflicts = [];
-	if (topFramework.length > 0 && contractFramework.length > 0 && !valuesOverlap(topFramework, contractFramework, (left, right) => left === right)) conflicts.push("framework");
-	if (topVersion.length > 0 && contractVersion.length > 0 && !valuesOverlap(topVersion, contractVersion, agentVersionConstraintsOverlap)) conflicts.push("version");
-	return {
-		framework: topFramework.length > 0 && contractFramework.length > 0 ? topFramework.filter((value) => contractFramework.includes(value)) : Array.from(new Set([...topFramework, ...contractFramework])),
-		version: Array.from(new Set([...topVersion, ...contractVersion])),
-		package: packageValues,
-		tags,
-		declarations: {
-			framework: [topFramework, contractFramework].filter((values) => values.length > 0),
-			version: [topVersion, contractVersion].filter((values) => values.length > 0),
-			package: packageValues.length > 0 ? [packageValues] : [],
-			tags: tags.length > 0 ? [tags] : []
-		},
-		conflicts
-	};
-}
-function docsSearchScopeValueMatches(field, requested, candidate) {
-	return field === "version" ? agentVersionConstraintsOverlap(requested, candidate) : requested === candidate;
-}
-function docsSearchPageMatchesFilters(scope, filters) {
-	if (scope.conflicts.length > 0) return false;
-	return SEARCH_FILTER_FIELDS.every((field) => {
-		const requested = filters[field];
-		if (!requested || requested.length === 0) return true;
-		return docsSearchScopeFieldMatches(scope, field, requested);
-	});
-}
-function docsSearchScopeFieldMatches(scope, field, requested) {
-	const declarations = scope.declarations[field];
-	if (declarations.length === 0) return false;
-	if (field === "version") return agentVersionConstraintGroupsOverlap([requested, ...declarations]);
-	return requested.some((value) => declarations.every((candidates) => candidates.some((candidate) => docsSearchScopeValueMatches(field, value, candidate))));
-}
-function stripMarkdownText(content) {
-	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, "");
-}
-function normalizeMcpSsePayload(body) {
-	const payload = body.split("\n").filter((line) => line.startsWith("data: ")).map((line) => line.slice(6).trim()).filter(Boolean).at(-1);
-	return payload ? JSON.parse(payload) : null;
-}
-function normalizeWhitespace(value) {
-	return value.replace(/\s+/g, " ").trim();
-}
-function normalizeSearchPhrase(value) {
-	return normalizeWhitespace(value.toLowerCase().replace(/[?!.,;:]+$/g, ""));
-}
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function literalMatchPriority(query, value) {
-	const q = normalizeSearchPhrase(query);
-	const text = normalizeSearchPhrase(value ?? "");
-	if (!q || !text) return 0;
-	if (text === q) return 2;
-	const boundary = "[^\\p{L}\\p{N}]";
-	return new RegExp(`(^|${boundary})${escapeRegExp(q)}(?=$|${boundary})`, "u").test(text) ? 1 : 0;
-}
-function isLiteralLookupQuery(query) {
-	const q = normalizeSearchPhrase(query);
-	const words = tokenizeSearchQuery(q);
-	return words.length > 0 && words.length <= 3 && words.join(" ") === q;
-}
-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 normalizeUrlRouteKey(value) {
-	try {
-		const url = new URL(value, "https://docs.local");
-		return `${url.pathname || "/"}${url.search}`;
-	} catch {
-		return value.split("#", 1)[0] || "/";
-	}
-}
-function normalizeAuthoredUrlIdentity(value) {
-	const trimmed = value.trim();
-	const explicitScheme = trimmed.match(/^([a-z][a-z\d+.-]*):/iu)?.[1]?.toLowerCase();
-	if (explicitScheme && explicitScheme !== "http" && explicitScheme !== "https") return normalizeUrlRouteKey("/");
-	try {
-		const url = new URL(trimmed, "https://docs.local");
-		const route = `${url.pathname || "/"}${url.search}`;
-		if (explicitScheme) return `${url.origin}${route}`;
-		if (trimmed.startsWith("//")) return `//${url.host}${route}`;
-		return route;
-	} catch {
-		return normalizeUrlRouteKey(trimmed);
-	}
-}
-function appendDocsLocaleQuery(value, locale) {
-	const hashIndex = value.indexOf("#");
-	const withoutHash = hashIndex >= 0 ? value.slice(0, hashIndex) : value;
-	const hash = hashIndex >= 0 ? value.slice(hashIndex) : "";
-	const queryIndex = withoutHash.indexOf("?");
-	const rawQuery = queryIndex >= 0 ? withoutHash.slice(queryIndex + 1) : "";
-	if (new URLSearchParams(rawQuery).has("lang")) return value;
-	return `${withoutHash}${queryIndex >= 0 ? "&" : "?"}lang=${encodeURIComponent(locale)}${hash}`;
-}
-function localizeDocsSearchPage(page, localeFallback) {
-	const rawLocale = (page.locale ?? localeFallback)?.trim();
-	if (!rawLocale) return page;
-	const locale = rawLocale;
-	const url = appendDocsLocaleQuery(page.url, locale);
-	if (url === page.url && page.locale === locale) return page;
-	return {
-		...page,
-		url,
-		locale
-	};
-}
-function safeDecodeUrlSegment(value) {
-	try {
-		return decodeURIComponent(value);
-	} catch {
-		return value;
-	}
-}
-function getUrlSearchSegments(value) {
-	let pathname = "";
-	try {
-		pathname = new URL(value, "https://docs.local").pathname;
-	} catch {
-		pathname = value.split(/[?#]/)[0] ?? "";
-	}
-	return Array.from(new Set(pathname.split("/").flatMap((segment) => {
-		const decoded = safeDecodeUrlSegment(segment);
-		return [decoded, decoded.replace(/[-_]+/g, " ")];
-	}).map(normalizeSearchPhrase).filter(Boolean)));
-}
-function resolveAskAIContextUrl(value, baseUrl) {
-	if (!baseUrl) return value;
-	try {
-		return new URL(value, baseUrl).toString();
-	} catch {
-		return value;
-	}
-}
-function cleanGeneratedAgentContractMarkers(content) {
-	return stripDocsGeneratedAgentContractMarkers(content);
-}
-function getAskAIPageSectionContent(page) {
-	return getPageAudienceSectionContent(page, "agent");
-}
-function getAskAIPageContent(page) {
-	return cleanGeneratedAgentContractMarkers(getAskAIPageSectionContent(page));
-}
-function getPageAgentContractSearchText(page) {
-	return stripMarkdownText(renderPageAgentContractMarkdown(page.agent).replace(PAGE_AGENT_CONTRACT_START_MARKER, "").replace(PAGE_AGENT_CONTRACT_END_MARKER, ""));
-}
-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 findPageForSearchResult(pages, result, baseUrl, pagesByRoute) {
-	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) 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 = normalizeUrlRouteKey(result.url);
-	return pagesByRoute?.get(resultPath) ?? pages.find((page) => normalizeUrlRouteKey(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 sectionSelector = getSearchResultAnchor(result.url) ?? section;
-	const contextContent = clampText(cleanAskAIContextMarkdown(page ? sectionSelector ? cleanGeneratedAgentContractMarkers(findDocsMarkdownSection(getAskAIPageSectionContent(page), sectionSelector)?.content ?? "") : getAskAIPageContent(page) : [result.content, result.description].filter(Boolean).join("\n\n")), maxChars);
-	return {
-		...result,
-		url: resolveAskAIContextUrl(result.url, baseUrl),
-		title,
-		contextContent
-	};
-}
-function getSearchResultKey(result) {
-	const anchor = getSearchResultAnchor(result.url);
-	const sectionFallback = normalizeWhitespace(result.section ?? "").toLowerCase();
-	return `${normalizeUrlRouteKey(result.url)}#${anchor ?? sectionFallback}`;
-}
-function getSearchResultAnchor(value) {
-	let hash = "";
-	try {
-		hash = new URL(value, "https://docs.local").hash.replace(/^#/, "");
-	} catch {
-		const hashIndex = value.indexOf("#");
-		hash = hashIndex >= 0 ? value.slice(hashIndex + 1) : "";
-	}
-	if (!hash) return void 0;
-	try {
-		return decodeURIComponent(hash);
-	} catch {
-		return hash;
-	}
-}
-function getAskAIResultPageKey(value, baseUrl, strictExternalOrigins = false) {
-	const path = normalizeUrlRouteKey(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) {
-	const anchor = getSearchResultAnchor(result.url);
-	const sectionFallback = normalizeWhitespace(result.section ?? "").toLowerCase();
-	return `${getAskAIResultPageKey(result.url, baseUrl, strictExternalOrigins)}#${anchor ?? sectionFallback}`;
-}
-function mergeSearchResults(groups, getResultKey = getSearchResultKey) {
-	const seen = /* @__PURE__ */ new Set();
-	const results = [];
-	for (const group of groups) for (const result of group) {
-		const key = getResultKey(result);
-		if (seen.has(key)) continue;
-		seen.add(key);
-		results.push(result);
-	}
-	return results;
-}
-function buildAudienceProjectionSearchResults(documents, query) {
-	return documents.map((document) => {
-		const score = scoreDocument(query, document);
-		return {
-			id: document.id,
-			url: document.url,
-			content: document.section ? `${document.title} — ${document.section}` : document.title,
-			description: cleanSearchResultText(buildSnippet(document, query) ?? document.description),
-			type: document.type,
-			score,
-			section: document.section
-		};
-	});
-}
-function sanitizeExternalAudienceSearchResults(results, localAudienceResults, baseUrl, preserveUnmatched, fallbackSectionToLocalPage = false) {
-	const localByKey = new Map(localAudienceResults.map((result) => [getSearchResultKey(result), result]));
-	const localPageResults = /* @__PURE__ */ new Map();
-	for (const result of localAudienceResults) {
-		const pageUrl = normalizeUrlRouteKey(result.url);
-		if (!localPageResults.get(pageUrl) || result.type === "page") localPageResults.set(pageUrl, result);
-	}
-	return results.flatMap((result) => {
-		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;
-		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 && !fallbackSectionToLocalPage ? void 0 : localPageResults.get(normalizeUrlRouteKey(result.url))) : void 0;
-		if (!local) return preserveUnmatched?.(result) ? [result] : [];
-		return [{
-			...local,
-			id: result.id,
-			score: result.score ?? local.score
-		}];
-	});
-}
-function shouldPreserveUnmatchedExternalResult(options) {
-	const { result, localPagePaths, baseUrl } = options;
-	const path = normalizeUrlRouteKey(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);
-	const knownLocalPath = localPagePaths.has(path);
-	if (!explicitlyHosted) return !knownLocalPath;
-	if (!baseUrl) return true;
-	try {
-		if (new URL(result.url, baseUrl).origin !== new URL(baseUrl).origin) return true;
-	} catch {
-		return false;
-	}
-	return !knownLocalPath;
-}
-function getPageAudienceSource(page, audience) {
-	return audience === "agent" ? page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content : page.rawContent ?? page.content;
-}
-function getPageAudienceRawContent(page, audience) {
-	return resolveDocsAudienceMdxContent(getPageAudienceSource(page, audience), audience);
-}
-function getPageAudienceSectionContent(page, audience) {
-	const content = getPageAudienceRawContent(page, audience);
-	return audience === "agent" ? upsertPageAgentContractMarkdown(content, page.agent) : content;
-}
-/**
-* Build the exact normalized-input projection represented by a retrieval source digest.
-* This is public so consumers can independently reproduce `source.digest`.
-*/
-function buildDocsRetrievalDigestProjection(page, audience = "human") {
-	const audienceContent = getPageAudienceRawContent(page, audience);
-	return audience === "agent" ? upsertPageAgentContractMarkdown(audienceContent, page.agent) : [audienceContent, renderPageAgentContractMarkdown(page.agent)].filter(Boolean).join("\n\n");
-}
-function getPageAudienceSearchText(page, audience) {
-	return stripMarkdownText(getPageAudienceRawContent(page, audience));
-}
-function getPageAudienceIndexContent(page, audience) {
-	return normalizeWhitespace([getPageAudienceSearchText(page, audience), getPageAgentContractSearchText(page)].join(" "));
-}
-function sortRetrievalSourceValues(values) {
-	const sorted = Array.from(new Set(values)).sort(compareSearchMetadataValues).slice(0, MAX_SEARCH_FILTER_VALUES);
-	return sorted.length > 0 ? sorted : void 0;
-}
-function buildDocsRetrievalSourceScope(page, audience, localeFallback) {
-	const resolved = resolveDocsSearchPageScope(page);
-	const rawLocale = (page.locale ?? localeFallback)?.trim();
-	const locale = rawLocale ? normalizeAgentLocale(rawLocale).slice(0, MAX_SEARCH_FILTER_VALUE_CHARS) : void 0;
-	const framework = sortRetrievalSourceValues(resolved.framework);
-	const version = sortRetrievalSourceValues(resolved.version);
-	const versionGroups = resolved.declarations.version.map((group) => sortRetrievalSourceValues(group)).filter((group) => Boolean(group)).slice(0, MAX_SEARCH_FILTER_VALUES);
-	const packageNames = sortRetrievalSourceValues(resolved.package);
-	const tags = sortRetrievalSourceValues(resolved.tags);
-	const truncated = SEARCH_FILTER_FIELDS.filter((field) => {
-		if (field === "version") return resolved.version.length > MAX_SEARCH_FILTER_VALUES || resolved.declarations.version.length > MAX_SEARCH_FILTER_VALUES || resolved.declarations.version.some((group) => group.length > MAX_SEARCH_FILTER_VALUES);
-		return resolved[field].length > MAX_SEARCH_FILTER_VALUES;
-	});
-	return {
-		audience,
-		...locale ? { locale: [locale] } : {},
-		...framework ? { framework } : {},
-		...version ? { version } : {},
-		...versionGroups.length > 1 ? { versionGroups } : {},
-		...packageNames ? { package: packageNames } : {},
-		...tags ? { tags } : {},
-		...truncated.length > 0 ? { truncated } : {},
-		...resolved.conflicts.length > 0 ? { conflicts: [...resolved.conflicts].sort((left, right) => SEARCH_FILTER_FIELDS.indexOf(left) - SEARCH_FILTER_FIELDS.indexOf(right)) } : {}
-	};
-}
-function buildDocsRetrievalScopeIdentity(page, audience, localeFallback) {
-	const resolved = resolveDocsSearchPageScope(page);
-	const sortValues = (values) => Array.from(new Set(values)).sort(compareSearchMetadataValues);
-	const declarations = Object.fromEntries(SEARCH_FILTER_FIELDS.map((field) => [field, resolved.declarations[field].map(sortValues).sort((left, right) => compareSearchMetadataValues(JSON.stringify(left), JSON.stringify(right)))]));
-	return hashDocsRetrievalValue(JSON.stringify({
-		audience,
-		locale: (page.locale ?? localeFallback)?.trim(),
-		declarations,
-		conflicts: [...resolved.conflicts].sort((left, right) => SEARCH_FILTER_FIELDS.indexOf(left) - SEARCH_FILTER_FIELDS.indexOf(right))
-	}));
-}
-function getUrlHash(value) {
-	const hashIndex = value.indexOf("#");
-	return hashIndex >= 0 ? value.slice(hashIndex) : "";
-}
-function resolveDocsRetrievalCanonicalUrl(page, resultUrl, baseUrl) {
-	const requestedCanonical = page.canonicalUrl?.trim();
-	const requested = requestedCanonical && requestedCanonical.length <= MAX_RETRIEVAL_SOURCE_URL_CHARS ? requestedCanonical : page.url;
-	const explicitScheme = requested.match(/^([a-z][a-z\d+.-]*):/iu)?.[1]?.toLowerCase();
-	const pageScheme = page.url.match(/^([a-z][a-z\d+.-]*):/iu)?.[1]?.toLowerCase();
-	const safePageUrl = pageScheme && pageScheme !== "http" && pageScheme !== "https" ? "/" : page.url;
-	const configured = explicitScheme && explicitScheme !== "http" && explicitScheme !== "https" ? safePageUrl : requested;
-	let canonical = configured;
-	if (baseUrl) try {
-		canonical = new URL(configured, baseUrl).toString();
-	} catch {
-		canonical = configured;
-	}
-	else if (configured.startsWith("//")) canonical = `https:${configured}`;
-	const withSection = `${canonical.split("#", 1)[0]}${getUrlHash(resultUrl)}`;
-	if (withSection.length <= MAX_RETRIEVAL_SOURCE_URL_CHARS && isDocsRetrievalCanonicalUrl(withSection)) return withSection;
-	const fallback = (baseUrl ? (() => {
-		try {
-			return new URL(safePageUrl, baseUrl).toString();
-		} catch {
-			return safePageUrl;
-		}
-	})() : safePageUrl).split("#", 1)[0];
-	if (fallback.length <= MAX_RETRIEVAL_SOURCE_URL_CHARS && isDocsRetrievalCanonicalUrl(fallback)) return fallback;
-	if (baseUrl) try {
-		const root = new URL("/", baseUrl).toString();
-		if (root.length <= MAX_RETRIEVAL_SOURCE_URL_CHARS && isDocsRetrievalCanonicalUrl(root)) return root;
-	} catch {}
-	return "/";
-}
-function hashDocsRetrievalValue(value) {
-	return digestDocsRetrievalContent(value);
-}
-const docsRetrievalDigestMemo = /* @__PURE__ */ new WeakMap();
-function getDocsRetrievalSourceDigest(page, audience, cache) {
-	const cached = cache?.get(page);
-	if (cached) return cached;
-	const source = getPageAudienceSource(page, audience);
-	let agentContractKey = "";
-	let cacheable = true;
-	try {
-		agentContractKey = JSON.stringify(page.agent ?? null);
-	} catch {
-		cacheable = false;
-	}
-	const memo = docsRetrievalDigestMemo.get(page)?.[audience];
-	if (cacheable && memo && memo.source === source && memo.agentContractKey === agentContractKey) {
-		cache?.set(page, memo.digest);
-		return memo.digest;
-	}
-	const digest = hashDocsRetrievalValue(buildDocsRetrievalDigestProjection(page, audience));
-	if (cacheable) {
-		const pageMemo = docsRetrievalDigestMemo.get(page) ?? {};
-		pageMemo[audience] = {
-			source,
-			agentContractKey,
-			digest
-		};
-		docsRetrievalDigestMemo.set(page, pageMemo);
-	}
-	cache?.set(page, digest);
-	return digest;
-}
-function resolveDocsRetrievalLastModified(page, audience) {
-	const parseCandidate = (value) => {
-		const normalized = value?.trim();
-		if (!normalized) return void 0;
-		const timestamp = Date.parse(normalized);
-		return Number.isFinite(timestamp) ? {
-			value: normalized,
-			timestamp
-		} : void 0;
-	};
-	const pageModified = parseCandidate(page.lastmod) ?? parseCandidate(page.lastModified);
-	if (!(audience === "agent" && (page.agentRawContent !== void 0 || page.agentContent !== void 0))) return pageModified?.value;
-	const agentModified = parseCandidate(page.agentLastModified);
-	if (!renderPageAgentContractMarkdown(page.agent)) return agentModified?.value ?? pageModified?.value;
-	if (!agentModified) return pageModified?.value;
-	if (!pageModified) return agentModified.value;
-	return agentModified.timestamp >= pageModified.timestamp ? agentModified.value : pageModified.value;
-}
-async function buildDocsSearchIndexGeneration(pages, options) {
-	const sources = (await Promise.all(pages.map(async (rawPage) => {
-		const page = localizeDocsSearchPage(rawPage, options.locale);
-		const authoredLastModified = page.lastmod?.trim();
-		return {
-			canonicalIdentity: normalizeAuthoredUrlIdentity(page.canonicalUrl?.trim() || page.url),
-			url: normalizeAuthoredUrlIdentity(page.url),
-			indexedUrl: page.url,
-			title: page.title,
-			description: page.description,
-			type: page.type,
-			scope: buildDocsRetrievalSourceScope(page, options.audience, options.locale),
-			scopeIdentity: buildDocsRetrievalScopeIdentity(page, options.audience, options.locale),
-			lastModified: authoredLastModified && Number.isFinite(Date.parse(authoredLastModified)) ? authoredLastModified : void 0,
-			digest: getDocsRetrievalSourceDigest(rawPage, options.audience, options.digestCache),
-			agentContract: getPageAgentContractSearchText(rawPage)
-		};
-	}))).sort((left, right) => {
-		const canonical = compareSearchMetadataValues(left.canonicalIdentity, right.canonicalIdentity);
-		if (canonical !== 0) return canonical;
-		const url = compareSearchMetadataValues(left.url, right.url);
-		if (url !== 0) return url;
-		const digest = compareSearchMetadataValues(left.digest, right.digest);
-		if (digest !== 0) return digest;
-		const title = compareSearchMetadataValues(left.title, right.title);
-		return title !== 0 ? title : compareSearchMetadataValues(JSON.stringify(left), JSON.stringify(right));
-	});
-	return hashDocsRetrievalValue(JSON.stringify({
-		format: RETRIEVAL_INDEX_FORMAT,
-		audience: options.audience,
-		chunking: options.chunking.strategy ?? "section",
-		sources
-	}));
-}
-async function buildDocsRetrievalSource(rawPage, resultUrl, options) {
-	const page = localizeDocsSearchPage(rawPage, options.locale);
-	const lastModified = resolveDocsRetrievalLastModified(rawPage, options.audience);
-	return {
-		canonicalUrl: resolveDocsRetrievalCanonicalUrl(page, resultUrl, options.baseUrl),
-		scope: buildDocsRetrievalSourceScope(page, options.audience, options.locale),
-		...lastModified ? { lastModified } : {},
-		digest: getDocsRetrievalSourceDigest(rawPage, options.audience, options.digestCache),
-		indexGeneration: options.indexGeneration
-	};
-}
-function parseRetrievalSourceString(value, maxChars = MAX_RETRIEVAL_SOURCE_VALUE_CHARS) {
-	if (typeof value !== "string") return void 0;
-	const normalized = value.trim();
-	if (!normalized || normalized.length > maxChars) return void 0;
-	if (Array.from(normalized).some((character) => {
-		const codePoint = character.codePointAt(0) ?? 0;
-		return codePoint <= 31 || codePoint === 127;
-	})) return void 0;
-	return normalized;
-}
-function parseRetrievalSourceValues(field, value) {
-	if (!Array.isArray(value) || value.length > MAX_SEARCH_FILTER_VALUES) return { valid: false };
-	const parsed = [];
-	for (const item of value) {
-		const stringValue = parseRetrievalSourceString(item, MAX_SEARCH_FILTER_VALUE_CHARS);
-		if (!stringValue) return { valid: false };
-		if (field === "locale") {
-			const normalizedLocale = normalizeAgentLocale(stringValue);
-			if (!normalizedLocale) return { valid: false };
-			parsed.push(normalizedLocale);
-			continue;
-		}
-		const normalized = normalizeDocsSearchFilterValue(field, stringValue);
-		if (!normalized) return { valid: false };
-		parsed.push(normalized);
-	}
-	return {
-		valid: true,
-		values: sortRetrievalSourceValues(parsed)
-	};
-}
-function parseRetrievalSourceVersionGroups(value) {
-	if (!Array.isArray(value) || value.length === 0 || value.length > MAX_SEARCH_FILTER_VALUES) return { valid: false };
-	const groups = value.map((group) => parseRetrievalSourceValues("version", group));
-	if (groups.some((group) => !group.valid || !group.values || group.values.length === 0)) return { valid: false };
-	return {
-		valid: true,
-		groups: groups.map((group) => group.values)
-	};
-}
-function parseDocsRetrievalSource(value, options = {}) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-	const record = value;
-	const canonicalUrl = parseRetrievalSourceString(record.canonicalUrl, MAX_RETRIEVAL_SOURCE_URL_CHARS);
-	const digest = parseRetrievalSourceString(record.digest);
-	const indexGeneration = parseRetrievalSourceString(record.indexGeneration);
-	if (!canonicalUrl || !digest || !indexGeneration) return void 0;
-	const digestPattern = /^sha256:[a-f\d]{64}$/iu;
-	if (!digestPattern.test(digest) || !digestPattern.test(indexGeneration)) return void 0;
-	if (!isDocsRetrievalCanonicalUrl(canonicalUrl) || /^\/(?!\/)/u.test(canonicalUrl) && !options.allowRootRelativeCanonical) return;
-	if (!record.scope || typeof record.scope !== "object" || Array.isArray(record.scope)) return;
-	const rawScope = record.scope;
-	const audience = rawScope.audience === "human" || rawScope.audience === "agent" ? rawScope.audience : void 0;
-	if (!audience) return void 0;
-	const parseScopeFields = (value) => {
-		if (!Array.isArray(value) || value.length > SEARCH_FILTER_FIELDS.length || value.some((field) => typeof field !== "string" || !SEARCH_FILTER_FIELDS.includes(field))) return { valid: false };
-		return {
-			valid: true,
-			values: Array.from(new Set(value)).sort((left, right) => SEARCH_FILTER_FIELDS.indexOf(left) - SEARCH_FILTER_FIELDS.indexOf(right))
-		};
-	};
-	const parseOptionalValues = (field, value) => value === void 0 ? { valid: true } : parseRetrievalSourceValues(field, value);
-	const parseOptionalScopeFields = (value) => value === void 0 ? { valid: true } : parseScopeFields(value);
-	const conflicts = parseOptionalScopeFields(rawScope.conflicts);
-	const truncated = parseOptionalScopeFields(rawScope.truncated);
-	const locale = parseOptionalValues("locale", rawScope.locale);
-	const framework = parseOptionalValues("framework", rawScope.framework);
-	const version = parseOptionalValues("version", rawScope.version);
-	const versionGroups = rawScope.versionGroups === void 0 ? {
-		valid: true,
-		groups: void 0
-	} : parseRetrievalSourceVersionGroups(rawScope.versionGroups);
-	const packageNames = parseOptionalValues("package", rawScope.package);
-	const tags = parseOptionalValues("tags", rawScope.tags);
-	if (!conflicts.valid || !truncated.valid || !locale.valid || !framework.valid || !version.valid || !versionGroups.valid || !packageNames.valid || !tags.valid) return;
-	const scope = {
-		audience,
-		...locale.values ? { locale: locale.values } : {},
-		...framework.values ? { framework: framework.values } : {},
-		...version.values ? { version: version.values } : {},
-		...versionGroups.groups ? { versionGroups: versionGroups.groups } : {},
-		...packageNames.values ? { package: packageNames.values } : {},
-		...tags.values ? { tags: tags.values } : {},
-		...truncated.values && truncated.values.length > 0 ? { truncated: truncated.values } : {},
-		...conflicts.values && conflicts.values.length > 0 ? { conflicts: conflicts.values } : {}
-	};
-	const rawLastModified = parseRetrievalSourceString(record.lastModified);
-	if (record.lastModified !== void 0 && (!rawLastModified || !Number.isFinite(Date.parse(rawLastModified)))) return;
-	const lastModified = rawLastModified && Number.isFinite(Date.parse(rawLastModified)) ? rawLastModified : void 0;
-	return {
-		canonicalUrl,
-		scope,
-		...lastModified ? { lastModified } : {},
-		digest,
-		indexGeneration
-	};
-}
-function docsRetrievalSourceMatchesRequest(source, audience, filters, locale) {
-	if (source.scope.audience !== audience) return false;
-	for (const field of SEARCH_FILTER_FIELDS) {
-		const requested = filters?.[field];
-		if (!requested?.length) continue;
-		if (source.scope.conflicts?.includes(field)) return false;
-		if (source.scope.truncated?.includes(field)) return false;
-		if (field === "version" && source.scope.versionGroups?.length) {
-			if (!agentVersionConstraintGroupsOverlap([requested, ...source.scope.versionGroups])) return false;
-			continue;
-		}
-		const candidates = source.scope[field];
-		if (!candidates?.length) return false;
-		if (!requested.some((requestedValue) => candidates.some((candidate) => docsSearchScopeValueMatches(field, requestedValue, candidate)))) return false;
-	}
-	const requestedLocale = locale ? normalizeAgentLocale(locale) : void 0;
-	if (requestedLocale && (!source.scope.locale?.length || !source.scope.locale.some((candidate) => normalizeAgentLocale(candidate) === requestedLocale))) return false;
-	return true;
-}
-const HOSTED_RETRIEVAL_SOURCE_FIELDS = [
-	"source_canonical_url",
-	"source_scope_audience",
-	"source_scope_locale",
-	"source_scope_framework",
-	"source_scope_version",
-	"source_scope_version_groups",
-	"source_scope_package",
-	"source_scope_tags",
-	"source_scope_truncated",
-	"source_scope_conflicts",
-	"source_last_modified",
-	"source_digest",
-	"source_index_generation"
-];
-function readFlattenedHostedRetrievalSource(record) {
-	return parseDocsRetrievalSource({
-		canonicalUrl: record.source_canonical_url,
-		scope: {
-			audience: record.source_scope_audience,
-			locale: record.source_scope_locale,
-			framework: record.source_scope_framework,
-			version: record.source_scope_version,
-			versionGroups: (() => {
-				const value = record.source_scope_version_groups;
-				if (typeof value !== "string") return value;
-				try {
-					return JSON.parse(value);
-				} catch {
-					return null;
-				}
-			})(),
-			package: record.source_scope_package,
-			tags: record.source_scope_tags,
-			truncated: record.source_scope_truncated,
-			conflicts: record.source_scope_conflicts
-		},
-		lastModified: record.source_last_modified,
-		digest: record.source_digest,
-		indexGeneration: record.source_index_generation
-	}, { allowRootRelativeCanonical: true });
-}
-function readHostedRetrievalSource(record) {
-	const hasNested = record.source !== void 0;
-	const hasFlattened = HOSTED_RETRIEVAL_SOURCE_FIELDS.some((key) => key in record);
-	if (hasNested) {
-		const nested = parseDocsRetrievalSource(record.source, { allowRootRelativeCanonical: true });
-		if (!nested) return void 0;
-		if (!hasFlattened) return nested;
-		const flattened = readFlattenedHostedRetrievalSource(record);
-		return flattened && JSON.stringify(flattened) === JSON.stringify(nested) ? nested : void 0;
-	}
-	return readFlattenedHostedRetrievalSource(record);
-}
-function hasHostedRetrievalSource(record) {
-	return record.source !== void 0 || [
-		"source_corpus_id",
-		"source_document_id",
-		...HOSTED_RETRIEVAL_SOURCE_FIELDS
-	].some((key) => key in record);
-}
-function serializeHostedRetrievalSource(source, corpusId, sourceDocumentId) {
-	if (!source) return {};
-	return {
-		source_corpus_id: corpusId,
-		source_document_id: sourceDocumentId,
-		source_canonical_url: source.canonicalUrl,
-		source_scope_audience: source.scope.audience,
-		source_scope_locale: source.scope.locale,
-		source_scope_framework: source.scope.framework,
-		source_scope_version: source.scope.version,
-		source_scope_version_groups: source.scope.versionGroups ? JSON.stringify(source.scope.versionGroups) : void 0,
-		source_scope_package: source.scope.package,
-		source_scope_tags: source.scope.tags,
-		source_scope_truncated: source.scope.truncated,
-		source_scope_conflicts: source.scope.conflicts,
-		source_last_modified: source.lastModified,
-		source_digest: source.digest,
-		source_index_generation: source.indexGeneration
-	};
-}
-function resolveHostedCorpusId(syncNamespace, context) {
-	const explicitNamespace = syncNamespace?.trim();
-	if (explicitNamespace && explicitNamespace.length > 1024) throw new Error("Search syncNamespace must be 1024 characters or fewer.");
-	let canonicalIdentity;
-	const indexBaseUrl = context.indexBaseUrl;
-	if (!explicitNamespace && indexBaseUrl) try {
-		const url = new URL(indexBaseUrl);
-		if ((url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password) canonicalIdentity = `${url.origin}${url.pathname.replace(/\/+$/u, "") || "/"}`;
-	} catch {}
-	const identity = explicitNamespace ? `namespace:${explicitNamespace}` : canonicalIdentity ? `canonical:${canonicalIdentity}` : void 0;
-	if (!identity) return void 0;
-	return hashDocsRetrievalValue(JSON.stringify({
-		format: "docs-hosted-corpus.v1",
-		identity,
-		audience: resolveDocsSearchAudience(context.audience),
-		locale: context.locale ? normalizeAgentLocale(context.locale) : "__all__"
-	}));
-}
-function resolveHostedHumanCorpusId(syncNamespace, context) {
-	return resolveHostedCorpusId(syncNamespace, {
-		audience: "human",
-		locale: context.locale,
-		baseUrl: context.baseUrl,
-		indexBaseUrl: context.indexBaseUrl
-	});
-}
-function makeHostedProviderDocumentId(corpusId, sourceDocumentId) {
-	return `docs_${hashDocsRetrievalValue(JSON.stringify({
-		format: "docs-hosted-document.v1",
-		corpusId,
-		sourceDocumentId
-	})).slice(7)}`;
-}
-function readHostedSourceDocumentId(record) {
-	return parseRetrievalSourceString(record.source_document_id, MAX_RETRIEVAL_SOURCE_URL_CHARS);
-}
-function hostedRecordMatchesCorpus(record, corpusId) {
-	if (!corpusId) return true;
-	if (record.source_corpus_id === corpusId) return true;
-	return record.source_corpus_id === void 0 && !hasHostedRetrievalSource(record);
-}
-async function enrichDocsSearchResultsWithSources(options) {
-	const digestCache = /* @__PURE__ */ new Map();
-	const localizedPages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale));
-	const pagesByRoute = /* @__PURE__ */ new Map();
-	for (const page of localizedPages) {
-		const route = normalizeUrlRouteKey(page.url);
-		if (!pagesByRoute.has(route)) pagesByRoute.set(route, page);
-	}
-	let resolvedIndexGeneration;
-	const getIndexGeneration = () => {
-		resolvedIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
-			audience: options.audience,
-			chunking: options.chunking,
-			locale: options.locale,
-			baseUrl: options.baseUrl,
-			digestCache
-		});
-		return resolvedIndexGeneration;
-	};
-	return (await Promise.all(options.results.map(async (result) => {
-		const { source: rawSource, ...resultWithoutSource } = result;
-		const page = findPageForSearchResult(localizedPages, result, options.baseUrl, pagesByRoute);
-		if (page) return {
-			...resultWithoutSource,
-			source: await buildDocsRetrievalSource(page, result.url, {
-				audience: options.audience,
-				chunking: options.chunking,
-				locale: options.locale,
-				baseUrl: options.baseUrl,
-				indexGeneration: await getIndexGeneration(),
-				digestCache
-			})
-		};
-		if (rawSource === void 0) return resultWithoutSource;
-		const source = parseDocsRetrievalSource(rawSource, { allowRootRelativeCanonical: options.requireCurrentIndexGeneration });
-		if (!source) return null;
-		if (!docsRetrievalSourceMatchesRequest(source, options.audience, options.filters, options.locale)) return null;
-		if (options.requireCurrentIndexGeneration && source.indexGeneration !== await getIndexGeneration()) return null;
-		return {
-			...resultWithoutSource,
-			source
-		};
-	}))).filter((result) => Boolean(result));
-}
-async function enrichDocsSearchDocumentsWithSources(options) {
-	const results = await enrichDocsSearchResultsWithSources({
-		results: options.documents.map((document) => ({
-			id: document.id,
-			url: document.url,
-			content: document.title,
-			description: document.description,
-			type: document.type,
-			section: document.section,
-			source: document.source
-		})),
-		pages: options.pages,
-		audience: options.audience,
-		chunking: options.chunking,
-		locale: options.locale,
-		baseUrl: options.baseUrl,
-		indexGeneration: options.indexGeneration
-	});
-	const sources = new Map(results.map((result) => [result.id, result.source]));
-	return options.documents.map((document) => {
-		const source = sources.get(document.id);
-		return source ? {
-			...document,
-			source
-		} : document;
-	});
-}
-/**
-* Attach the same canonical provenance used by built-in search providers.
-* Custom adapters can call this before persisting their own hosted records.
-*/
-function enrichDocsSearchDocumentsWithProvenance(options) {
-	return enrichDocsSearchDocumentsWithSources({
-		...options,
-		audience: resolveDocsSearchAudience(options.audience),
-		chunking: options.chunking ?? { strategy: "section" }
-	});
-}
-function isLocalProviderResult(result, baseUrl) {
-	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;
-	if (!(/^[a-z][a-z\d+.-]*:/iu.test(rawUrl) || /^[\\/]{2}/u.test(rawUrl))) return true;
-	if (!baseUrl) return false;
-	try {
-		return new URL(result.url, baseUrl).origin === new URL(baseUrl).origin;
-	} catch {
-		return false;
-	}
-}
-function hasOppositeAudienceEvidence(options) {
-	const { result, pages, query, audience, baseUrl } = options;
-	if (!isLocalProviderResult(result, baseUrl)) return false;
-	const pagePath = normalizeUrlRouteKey(result.url);
-	const page = pages.find((candidate) => normalizeUrlRouteKey(candidate.url) === pagePath);
-	if (!page) return false;
-	if (scoreDocument(query, pageToSearchDocument(page, audience)) > 0) return false;
-	const oppositeAudience = audience === "agent" ? "human" : "agent";
-	if (scoreDocument(query, pageToSearchDocument(page, oppositeAudience)) > 0) return true;
-	const evidence = cleanSearchResultText(result.description);
-	if (!evidence) return false;
-	const selectedTokens = new Set(tokenizeSearchQuery(getPageAudienceSearchText(page, audience)));
-	const oppositeTokens = new Set(tokenizeSearchQuery(getPageAudienceSearchText(page, oppositeAudience)));
-	const evidenceTokens = [...new Set(tokenizeSearchQuery(evidence))];
-	let selectedOnlyMatches = 0;
-	let oppositeOnlyMatches = 0;
-	for (const token of evidenceTokens) {
-		const inSelected = selectedTokens.has(token);
-		const inOpposite = oppositeTokens.has(token);
-		if (inSelected && !inOpposite) selectedOnlyMatches += 1;
-		if (inOpposite && !inSelected) oppositeOnlyMatches += 1;
-	}
-	return oppositeOnlyMatches > selectedOnlyMatches;
-}
-function pageToSearchDocument(rawPage, audience = "human") {
-	const page = localizeDocsSearchPage(rawPage, rawPage.locale);
-	const scope = resolveDocsSearchPageScope(page);
-	return {
-		id: makeDocumentId(page.url, "page"),
-		url: page.url,
-		title: page.title,
-		content: getPageAudienceIndexContent(page, audience),
-		description: page.description,
-		type: "page",
-		locale: page.locale,
-		framework: scope.framework[0],
-		version: scope.version[0],
-		package: scope.package.length > 0 ? scope.package : void 0,
-		tags: scope.tags.length > 0 ? scope.tags : void 0
-	};
-}
-function buildExactPageSearchResults(query, pages, audience = "human") {
-	const normalizedQuery = normalizeSearchPhrase(query);
-	if (!normalizedQuery) return [];
-	const results = [];
-	for (const page of pages) {
-		const document = pageToSearchDocument(page, audience);
-		const title = normalizeSearchPhrase(page.title);
-		const urlSegments = getUrlSearchSegments(page.url);
-		if (!(title === normalizedQuery || urlSegments.includes(normalizedQuery))) continue;
-		results.push({
-			id: document.id,
-			url: document.url,
-			content: cleanSearchResultText(document.title) ?? document.title,
-			description: cleanSearchResultText(buildSnippet(document, query) ?? document.description),
-			type: "page",
-			score: scoreDocument(query, document) + 2e3
-		});
-	}
-	return results.sort((a, b) => (b.score ?? 0) - (a.score ?? 0) || a.url.localeCompare(b.url));
-}
-function hasDistinctResultSection(result) {
-	if (result.type === "page") return false;
-	const section = normalizeSearchPhrase(stripHtml(result.section ?? ""));
-	if (!section) return true;
-	return section !== normalizeSearchPhrase(normalizeSearchPhrase(stripHtml(result.content)).split(/\s+[—–]\s+/)[0] ?? "");
-}
-function insideLiteralResultPriority(query, result) {
-	if (!hasDistinctResultSection(result) || !isLiteralLookupQuery(query)) return 0;
-	return Math.max(literalMatchPriority(query, stripHtml(result.section ?? "")), literalMatchPriority(query, stripHtml(result.description ?? "")));
-}
-function prioritizeLiteralInsideResults(query, results) {
-	if (!isLiteralLookupQuery(query)) return results;
-	return [...results].sort((a, b) => {
-		const literalDelta = insideLiteralResultPriority(query, b) - insideLiteralResultPriority(query, a);
-		if (literalDelta) return literalDelta;
-		return 0;
-	});
-}
-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}`);
-	if (result.source) {
-		const scope = result.source.scope;
-		const scopeEntries = [
-			`audience=${scope.audience}`,
-			scope.locale?.length ? `locale=${scope.locale.join(",")}` : void 0,
-			scope.framework?.length ? `framework=${scope.framework.join(",")}` : void 0,
-			scope.version?.length ? `version=${scope.version.join(",")}` : void 0,
-			scope.package?.length ? `package=${scope.package.join(",")}` : void 0,
-			scope.tags?.length ? `tags=${scope.tags.join(",")}` : void 0,
-			scope.conflicts?.length ? `conflicts=${scope.conflicts.join(",")}` : void 0
-		].filter((value) => Boolean(value));
-		lines.push(`Canonical URL: ${result.source.canonicalUrl}`);
-		lines.push(`Source scope: ${scopeEntries.join("; ")}`);
-		if (result.source.lastModified) lines.push(`Source modified: ${result.source.lastModified}`);
-		lines.push(`Source digest: ${result.source.digest}`);
-		lines.push(`Index generation: ${result.source.indexGeneration}`);
-	}
-	lines.push("", result.contextContent);
-	return lines.join("\n").trim();
-}
-function makeDocumentId(url, suffix) {
-	return `${url}#${suffix}`;
-}
-function splitPageIntoSections(page, audience = "human") {
-	const raw = getPageAudienceSectionContent(page, audience);
-	const generatedContract = audience === "agent" ? findDocsGeneratedAgentContractRanges(raw)[0] : void 0;
-	const scope = resolveDocsSearchPageScope(page);
-	let documentIndex = 0;
-	return parseDocsMarkdownSections(raw).flatMap((section) => {
-		if (generatedContract && section.startLine > generatedContract.startLine && section.startLine < generatedContract.endLine) return [];
-		const content = normalizeWhitespace(stripMarkdownText(section.content));
-		if (!content) return [];
-		const index = documentIndex;
-		documentIndex += 1;
-		return [{
-			id: makeDocumentId(page.url, `section-${index}`),
-			url: `${page.url.split("#", 1)[0]}#${encodeURIComponent(section.anchor)}`,
-			title: page.title,
-			section: section.title,
-			content,
-			description: page.description,
-			type: "heading",
-			locale: page.locale,
-			framework: scope.framework[0],
-			version: scope.version[0],
-			package: scope.package.length > 0 ? scope.package : void 0,
-			tags: scope.tags.length > 0 ? scope.tags : void 0
-		}];
-	});
-}
-function buildDocsSearchDocuments(pages, chunking = {}, audience = "human") {
-	const strategy = chunking.strategy ?? "section";
-	return pages.flatMap((rawPage) => {
-		const page = localizeDocsSearchPage(rawPage, rawPage.locale);
-		const base = pageToSearchDocument(page, audience);
-		if (strategy === "page") return [base];
-		const sections = splitPageIntoSections(page, audience);
-		if (sections.length === 0) return [base];
-		return [...base.content ? [base] : [], ...sections];
-	});
-}
-function scoreDocument(query, document) {
-	const q = normalizeSearchPhrase(query);
-	if (!q) return 0;
-	const words = tokenizeSearchQuery(q);
-	const title = normalizeSearchPhrase(document.title);
-	const section = document.section ? normalizeSearchPhrase(document.section) : "";
-	const hasDistinctSection = Boolean(section && section !== title);
-	const titleSection = section ? normalizeSearchPhrase(`${document.title} ${document.section}`) : "";
-	const description = document.description ? normalizeSearchPhrase(document.description) : "";
-	const content = normalizeSearchPhrase(document.content);
-	const url = normalizeSearchPhrase(document.url);
-	const urlSegments = getUrlSearchSegments(document.url);
-	const titleTokens = tokenizeSearchQuery(title);
-	const sectionTokens = tokenizeSearchQuery(section);
-	let score = 0;
-	const insideLiteralPriority = document.type !== "page" && hasDistinctSection && isLiteralLookupQuery(q) ? Math.max(literalMatchPriority(q, section), literalMatchPriority(q, description), literalMatchPriority(q, content)) : 0;
-	if (insideLiteralPriority > 0) score += insideLiteralPriority * 2250;
-	if (title === q) score += 1120;
-	else if (title.startsWith(q)) score += 70;
-	else if (title.includes(q)) score += 45;
-	if (hasDistinctSection) {
-		if (section === q) score += 1080;
-		else if (section.startsWith(q)) score += 55;
-		else if (section.includes(q)) score += 30;
-		if (titleSection === q) score += 1e3;
-		else if (titleSection.startsWith(q)) score += 50;
-		else if (titleSection.includes(q)) score += 28;
-	}
-	if (urlSegments.includes(q)) score += 950;
-	if (url.includes(q)) score += 12;
-	if (description.includes(q)) score += 18;
-	if (content.includes(q)) score += 12;
-	let matchedWords = 0;
-	for (const word of words) {
-		let matched = false;
-		if (title === word) {
-			score += 28;
-			matched = true;
-		} else if (title.startsWith(word)) {
-			score += 20;
-			matched = true;
-		} else if (title.includes(word)) {
-			score += 12;
-			matched = true;
-		}
-		if (hasDistinctSection) {
-			if (section === word) {
-				score += 22;
-				matched = true;
-			} else if (section.startsWith(word)) {
-				score += 16;
-				matched = true;
-			} else if (section.includes(word)) {
-				score += 10;
-				matched = true;
-			}
-		}
-		if (description.includes(word)) {
-			score += 6;
-			matched = true;
-		}
-		if (content.includes(word)) {
-			score += 4;
-			matched = true;
-		}
-		if (matched) matchedWords += 1;
-	}
-	if (words.length > 1) {
-		if (hasDistinctSection && 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 (score > 0 && document.type === "heading" && hasDistinctSection) score += 6;
-	return score;
-}
-function buildSnippet(document, query) {
-	const q = query.trim().toLowerCase();
-	const sources = [normalizeWhitespace(stripMarkdownText(document.content)), normalizeWhitespace(stripMarkdownText(document.description ?? ""))].filter(Boolean);
-	for (const source of sources) {
-		if (!q) return clampSearchSnippet(source);
-		const idx = source.toLowerCase().indexOf(q);
-		if (idx === -1) continue;
-		const start = Math.max(0, idx - 48);
-		const end = Math.min(source.length, idx + q.length + 96);
-		const prefix = start > 0 ? "..." : "";
-		const suffix = end < source.length ? "..." : "";
-		return clampSearchSnippet(`${prefix}${source.slice(start, end).trim()}${suffix}`);
-	}
-	return sources[0] ? clampSearchSnippet(sources[0]) : void 0;
-}
-function clampSearchSnippet(value) {
-	if (value.length <= MAX_SEARCH_SNIPPET_CHARS) return value;
-	return `${value.slice(0, MAX_SEARCH_SNIPPET_CHARS - 3).trimEnd()}...`;
-}
-function cleanSearchResultText(value) {
-	if (!value) return void 0;
-	return normalizeWhitespace(stripHtml(stripMarkdownText(value))) || void 0;
-}
-function buildAlgoliaRecord(document, corpusId) {
-	const providerDocumentId = corpusId ? makeHostedProviderDocumentId(corpusId, document.id) : document.id;
-	const record = {
-		objectID: providerDocumentId,
-		id: providerDocumentId,
-		url: document.url,
-		title: document.title,
-		section: document.section,
-		content: document.content,
-		description: document.description,
-		type: document.type,
-		locale: document.locale ?? document.source?.scope.locale?.[0],
-		framework: document.framework,
-		version: document.version,
-		package: document.package,
-		tags: document.tags,
-		_tags: corpusId ? [corpusId] : void 0,
-		...serializeHostedRetrievalSource(document.source, corpusId, document.id)
-	};
-	const encoder = new TextEncoder();
-	const sizeOf = (value) => encoder.encode(JSON.stringify(value)).length;
-	if (sizeOf(record) <= ALGOLIA_MAX_RECORD_BYTES) return record;
-	delete record.description;
-	if (sizeOf(record) <= ALGOLIA_MAX_RECORD_BYTES) return record;
-	record.content = "";
-	for (const field of [
-		"package",
-		"tags",
-		"framework",
-		"version"
-	]) {
-		if (sizeOf(record) <= ALGOLIA_MAX_RECORD_BYTES) break;
-		delete record[field];
-	}
-	const trimFieldToFit = (field, value) => {
-		let low = 0;
-		let high = value.length;
-		let best = "";
-		while (low <= high) {
-			const middle = Math.floor((low + high) / 2);
-			const candidate = middle < value.length ? `${value.slice(0, middle).trimEnd()}...` : value;
-			record[field] = candidate;
-			if (sizeOf(record) <= ALGOLIA_MAX_RECORD_BYTES) {
-				best = candidate;
-				low = middle + 1;
-			} else high = middle - 1;
-		}
-		record[field] = best;
-	};
-	if (sizeOf(record) > ALGOLIA_MAX_RECORD_BYTES && typeof record.section === "string") trimFieldToFit("section", record.section);
-	if (sizeOf(record) > ALGOLIA_MAX_RECORD_BYTES && typeof record.title === "string") trimFieldToFit("title", record.title);
-	if (sizeOf(record) > ALGOLIA_MAX_RECORD_BYTES) throw new Error(`Algolia record ${document.id} exceeds the record limit with required provenance.`);
-	trimFieldToFit("content", document.content);
-	if (sizeOf(record) > ALGOLIA_MAX_RECORD_BYTES) throw new Error(`Algolia record ${document.id} still exceeds the record limit after trimming.`);
-	return record;
-}
-function createSimpleSearchAdapter() {
-	return {
-		name: "simple",
-		async search(query, context) {
-			const limit = query.limit ?? DEFAULT_SEARCH_LIMIT;
-			const results = context.documents.map((document) => ({
-				document,
-				score: scoreDocument(query.query, document)
-			})).filter((item) => item.score > 0).sort((a, b) => {
-				if (b.score !== a.score) return b.score - a.score;
-				return a.document.url.localeCompare(b.document.url);
-			}).slice(0, limit).map(({ document, score }) => ({
-				id: document.id,
-				url: document.url,
-				content: cleanSearchResultText(document.section ? `${document.title} — ${document.section}` : document.title) ?? (document.section ? `${document.title} — ${document.section}` : document.title),
-				description: cleanSearchResultText(buildSnippet(document, query.query) ?? document.description),
-				type: document.type,
-				score,
-				section: document.section,
-				source: document.source
-			}));
-			if (context.deferSourceProvenance) return results;
-			return enrichDocsSearchResultsWithSources({
-				results,
-				pages: context.pages,
-				audience: resolveDocsSearchAudience(context.audience),
-				chunking: context.chunking ?? { strategy: "section" },
-				locale: query.locale ?? context.locale,
-				baseUrl: context.baseUrl,
-				indexGeneration: context.indexGeneration,
-				filters: query.filters
-			});
-		}
-	};
-}
-function normalizeDocsSearchConfig(search) {
-	if (search === false) return {
-		enabled: false,
-		provider: "simple",
-		maxResults: DEFAULT_SEARCH_LIMIT,
-		chunking: { strategy: "section" }
-	};
-	if (!search || search === true) return {
-		enabled: true,
-		provider: "simple",
-		maxResults: DEFAULT_SEARCH_LIMIT,
-		chunking: { strategy: "section" },
-		raw: typeof search === "object" ? search : void 0
-	};
-	const provider = search.provider ?? "simple";
-	const maxResults = search.maxResults ?? DEFAULT_SEARCH_LIMIT;
-	const chunking = search.chunking ?? { strategy: "section" };
-	return {
-		enabled: search.enabled ?? true,
-		provider,
-		maxResults,
-		chunking,
-		raw: search
-	};
-}
-async function readResponseJson(response) {
-	const text = await response.text();
-	return text ? JSON.parse(text) : null;
-}
-async function readMcpResponsePayload(response) {
-	const text = await response.text();
-	if (!text) return null;
-	if ((response.headers.get("content-type") ?? "").includes("application/json")) return JSON.parse(text);
-	return normalizeMcpSsePayload(text);
-}
-function ensureOk(response, message) {
-	if (response.ok) return;
-	throw new Error(`${message} (${response.status} ${response.statusText})`);
-}
-function ensureJsonRpcOk(payload, message) {
-	if (payload && typeof payload === "object" && "error" in payload && payload.error && typeof payload.error === "object" && "message" in payload.error) throw new Error(`${message}: ${String(payload.error.message)}`);
-}
-function resolveMcpEndpoint(endpoint) {
-	if (/^https?:\/\//i.test(endpoint)) return endpoint;
-	throw new Error("Relative MCP search endpoints must be resolved before creating the MCP adapter.");
-}
-function isDocsSearchResultType(value) {
-	return value === "page" || value === "heading" || value === "text";
-}
-function mapMcpSearchResult(value, sourceBaseUrl) {
-	if (!value || typeof value !== "object") return null;
-	const item = value;
-	const section = typeof item.section === "string" ? item.section : void 0;
-	const title = typeof item.title === "string" ? item.title : void 0;
-	const content = typeof item.content === "string" ? item.content : title ? section ? `${title} — ${section}` : title : void 0;
-	const url = typeof item.url === "string" ? item.url : void 0;
-	if (!content || !url) return null;
-	const hasSource = item.source !== void 0;
-	let sourceValue = item.source;
-	if (hasSource && sourceBaseUrl && sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue)) {
-		const sourceRecord = sourceValue;
-		if (typeof sourceRecord.canonicalUrl === "string" && /^\/(?!\/)/u.test(sourceRecord.canonicalUrl)) try {
-			sourceValue = {
-				...sourceRecord,
-				canonicalUrl: new URL(sourceRecord.canonicalUrl, sourceBaseUrl).toString()
-			};
-		} catch {}
-	}
-	const source = hasSource ? parseDocsRetrievalSource(sourceValue) : void 0;
-	if (hasSource && !source) return null;
-	return {
-		id: typeof item.id === "string" ? item.id : typeof item.slug === "string" ? item.slug : url,
-		url,
-		content: cleanSearchResultText(content) ?? content,
-		description: cleanSearchResultText(typeof item.description === "string" ? item.description : typeof item.excerpt === "string" ? item.excerpt : void 0) ?? void 0,
-		type: isDocsSearchResultType(item.type) ? item.type : section ? "heading" : "page",
-		score: typeof item.score === "number" ? item.score : void 0,
-		section,
-		...source ? { source } : {}
-	};
-}
-function readMcpSearchToolPayload(payload) {
-	if (!payload || typeof payload !== "object" || !("result" in payload) || !payload.result || typeof payload.result !== "object") return null;
-	const result = payload.result;
-	if (result.structuredContent && typeof result.structuredContent === "object" && !Array.isArray(result.structuredContent)) return result.structuredContent;
-	const content = Array.isArray(result.content) ? result.content : [];
-	const resultText = content.length > 0 && content[0] && typeof content[0] === "object" && "text" in content[0] && typeof content[0].text === "string" ? content[0].text : null;
-	return resultText ? JSON.parse(resultText) : null;
-}
-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);
-	if (Array.isArray(payload.embeddings?.[0])) return payload.embeddings[0];
-	if (Array.isArray(payload.embedding)) return payload.embedding;
-	throw new Error("Ollama embedding response did not include an embedding vector.");
-}
-function getTypesenseSearchBase(config) {
-	return config.baseUrl.replace(/\/$/, "");
-}
-function quoteTypesenseFilterValue(value) {
-	return `\`${value.replace(/\\/gu, "\\\\").replace(/`/gu, "\\`")}\``;
-}
-const TYPESENSE_RETRIEVAL_SOURCE_FIELDS = [
-	{
-		name: "source_corpus_id",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_document_id",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_canonical_url",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_scope_audience",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_scope_locale",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_framework",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_version",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_version_groups",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_scope_package",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_tags",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_truncated",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_scope_conflicts",
-		type: "string[]",
-		optional: true
-	},
-	{
-		name: "source_last_modified",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_digest",
-		type: "string",
-		optional: true
-	},
-	{
-		name: "source_index_generation",
-		type: "string",
-		optional: true
-	}
-];
-async function ensureTypesenseCollection(config, dimensions, signal, retryAfterCreateConflict = true, retryAfterAlterFailure = true) {
-	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,
-		signal
-	});
-	if (existing.ok) {
-		const existingPayload = await readResponseJson(existing);
-		if (!Array.isArray(existingPayload?.fields)) throw new Error("Typesense collection response did not include a fields array.");
-		const existingFields = new Map(existingPayload.fields.flatMap((field) => typeof field.name === "string" ? [[field.name, field]] : []));
-		const incompatibleFields = TYPESENSE_RETRIEVAL_SOURCE_FIELDS.flatMap((expected) => {
-			const name = typeof expected.name === "string" ? expected.name : void 0;
-			const existingField = name ? existingFields.get(name) : void 0;
-			if (!name || !existingField) return [];
-			return existingField.type === expected.type && existingField.optional === true ? [] : [name];
-		});
-		if (incompatibleFields.length > 0) throw new Error(`Typesense collection has incompatible provenance fields: ${incompatibleFields.join(", ")}.`);
-		const missingFields = TYPESENSE_RETRIEVAL_SOURCE_FIELDS.filter((field) => typeof field.name === "string" && !existingFields.has(field.name));
-		const embeddingField = existingPayload.fields.find((field) => field.name === "embedding");
-		const expectedEmbeddingField = config.embeddings && dimensions ? {
-			name: "embedding",
-			type: "float[]",
-			num_dim: dimensions,
-			optional: true
-		} : void 0;
-		const replaceEmbedding = Boolean(expectedEmbeddingField && embeddingField && (embeddingField.type !== "float[]" || embeddingField.num_dim !== dimensions));
-		if (replaceEmbedding) ensureOk(await fetch(`${baseUrl}/collections/${encodeURIComponent(config.collection)}`, {
-			method: "PATCH",
-			headers,
-			body: JSON.stringify({ fields: [{
-				name: "embedding",
-				drop: true
-			}] }),
-			signal
-		}), "Failed to replace an incompatible Typesense embedding field");
-		const fieldsToAdd = [...missingFields, ...expectedEmbeddingField && (!embeddingField || replaceEmbedding) ? [expectedEmbeddingField] : []];
-		if (fieldsToAdd.length === 0) return;
-		const altered = await fetch(`${baseUrl}/collections/${encodeURIComponent(config.collection)}`, {
-			method: "PATCH",
-			headers,
-			body: JSON.stringify({ fields: fieldsToAdd }),
-			signal
-		});
-		if (!altered.ok && retryAfterAlterFailure) {
-			await ensureTypesenseCollection(config, dimensions, signal, retryAfterCreateConflict, false);
-			return;
-		}
-		ensureOk(altered, "Failed to update the Typesense search schema");
-		return;
-	}
-	if (existing.status !== 404) ensureOk(existing, "Failed to inspect Typesense collection");
-	const fields = [
-		{
-			name: "id",
-			type: "string"
-		},
-		{
-			name: "url",
-			type: "string"
-		},
-		{
-			name: "title",
-			type: "string"
-		},
-		{
-			name: "section",
-			type: "string",
-			optional: true
-		},
-		{
-			name: "content",
-			type: "string"
-		},
-		{
-			name: "description",
-			type: "string",
-			optional: true
-		},
-		{
-			name: "type",
-			type: "string"
-		},
-		{
-			name: "locale",
-			type: "string",
-			optional: true
-		},
-		{
-			name: "framework",
-			type: "string",
-			optional: true
-		},
-		{
-			name: "version",
-			type: "string",
-			optional: true
-		},
-		{
-			name: "package",
-			type: "string[]",
-			optional: true
-		},
-		{
-			name: "tags",
-			type: "string[]",
-			optional: true
-		},
-		...TYPESENSE_RETRIEVAL_SOURCE_FIELDS
-	];
-	if (config.embeddings && dimensions) fields.push({
-		name: "embedding",
-		type: "float[]",
-		num_dim: dimensions,
-		optional: true
-	});
-	const response = await fetch(`${baseUrl}/collections`, {
-		method: "POST",
-		headers,
-		body: JSON.stringify({
-			name: config.collection,
-			fields
-		}),
-		signal
-	});
-	if (response.status === 409 && retryAfterCreateConflict) {
-		await ensureTypesenseCollection(config, dimensions, signal, false, retryAfterAlterFailure);
-		return;
-	}
-	ensureOk(response, "Failed to create Typesense collection");
-}
-async function ensureTypesenseImportSucceeded(response, expectedRecords) {
-	ensureOk(response, "Failed to sync documents to Typesense");
-	const lines = (await response.text()).split(/\r?\n/u).filter((line) => line.trim());
-	if (lines.length !== expectedRecords) throw new Error(`Typesense acknowledged ${lines.length} of ${expectedRecords} imported records.`);
-	for (const [index, line] of lines.entries()) {
-		let result;
-		try {
-			result = JSON.parse(line);
-		} catch {
-			throw new Error(`Typesense import returned invalid JSON on record ${index + 1}.`);
-		}
-		if (result.success !== true) {
-			const detail = typeof result.error === "string" ? `: ${result.error}` : "";
-			throw new Error(`Typesense failed to import record ${index + 1}${detail}`);
-		}
-	}
-}
-function createTypesenseSearchAdapter(config) {
-	return {
-		name: "typesense",
-		async index(context) {
-			const adminApiKey = config.adminApiKey ?? config.apiKey;
-			const corpusId = resolveHostedHumanCorpusId(config.syncNamespace, context);
-			const documents = await enrichDocsSearchDocumentsWithSources({
-				documents: context.documents,
-				pages: context.pages,
-				audience: resolveDocsSearchAudience(context.audience),
-				chunking: context.chunking ?? { strategy: "section" },
-				locale: context.locale,
-				baseUrl: context.baseUrl,
-				indexGeneration: context.indexGeneration
-			});
-			const docsForImport = await Promise.all(documents.map(async (document) => {
-				const next = {
-					id: corpusId ? makeHostedProviderDocumentId(corpusId, document.id) : document.id,
-					url: document.url,
-					title: document.title,
-					section: document.section,
-					content: document.content,
-					description: document.description,
-					type: document.type,
-					locale: document.locale ?? document.source?.scope.locale?.[0],
-					framework: document.framework,
-					version: document.version,
-					package: document.package,
-					tags: document.tags,
-					...serializeHostedRetrievalSource(document.source, corpusId, document.id)
-				};
-				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;
-			}));
-			await ensureTypesenseCollection(config, Array.isArray(docsForImport[0]?.embedding) ? docsForImport[0].embedding.length : void 0, context.signal);
-			if (docsForImport.length > 0) await ensureTypesenseImportSucceeded(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"),
-				signal: context.signal
-			}), docsForImport.length);
-		},
-		async search(query, context) {
-			const corpusId = resolveHostedHumanCorpusId(config.syncNamespace, context);
-			const scopedDocumentIds = resolveProviderScopeDocumentIds(query, context, corpusId);
-			if (scopedDocumentIds?.length === 0) return [];
-			const params = new URLSearchParams({
-				q: query.query,
-				query_by: (config.queryBy ?? [
-					"title",
-					"section",
-					"content",
-					"description"
-				]).join(","),
-				per_page: String(query.limit ?? config.maxResults ?? DEFAULT_SEARCH_LIMIT),
-				prioritize_exact_match: "true",
-				num_typos: "2",
-				highlight_fields: "content,title,section,description"
-			});
-			if (config.mode === "hybrid" && 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 filterClauses = [corpusId ? `source_corpus_id:=${quoteTypesenseFilterValue(corpusId)}` : void 0, scopedDocumentIds ? `id:=[${scopedDocumentIds.map(quoteTypesenseFilterValue).join(",")}]` : void 0].filter((value) => Boolean(value));
-			const filterBy = filterClauses.length > 0 ? filterClauses.join(" && ") : void 0;
-			if (filterBy && filterBy.length > MAX_PROVIDER_SCOPE_FILTER_CHARS) return [];
-			const response = filterBy ? await fetch(`${getTypesenseSearchBase(config)}/multi_search`, {
-				method: "POST",
-				headers: {
-					"Content-Type": "application/json",
-					"X-TYPESENSE-API-KEY": config.apiKey
-				},
-				body: JSON.stringify({ searches: [{
-					collection: config.collection,
-					...Object.fromEntries(params),
-					filter_by: filterBy
-				}] }),
-				signal: context.signal
-			}) : 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");
-			const rawPayload = await readResponseJson(response);
-			return ((filterBy ? rawPayload.results?.[0] ?? {} : rawPayload).hits ?? []).flatMap((hit) => {
-				const document = hit.document ?? {};
-				if (!hostedRecordMatchesCorpus(document, corpusId)) return [];
-				const section = typeof document.section === "string" ? document.section : void 0;
-				const content = typeof document.title === "string" ? section ? `${document.title} — ${section}` : document.title : typeof document.content === "string" ? document.content : "Untitled result";
-				const description = hit.highlights?.find((item) => item.field === "content")?.snippet ?? hit.highlights?.find((item) => item.field === "description")?.snippet ?? (typeof document.description === "string" ? document.description : void 0);
-				const source = readHostedRetrievalSource(document);
-				if (hasHostedRetrievalSource(document) && !source) return [];
-				return [{
-					id: readHostedSourceDocumentId(document) ?? (typeof document.id === "string" ? document.id : String(document.url ?? content)),
-					url: typeof document.url === "string" ? document.url : "/docs",
-					content: cleanSearchResultText(content) ?? content,
-					description: cleanSearchResultText(description),
-					type: typeof document.type === "string" && [
-						"page",
-						"heading",
-						"text"
-					].includes(document.type) ? document.type : section ? "heading" : "page",
-					score: hit.text_match,
-					section,
-					...source ? { source } : {}
-				}];
-			});
-		}
-	};
-}
-function resolveSearchRequestConfig(search, requestUrl) {
-	if (!search || search === true || typeof search !== "object" || search.provider !== "mcp") return search;
-	if (!requestUrl) return search;
-	const resolvedEndpoint = new URL(search.endpoint, requestUrl);
-	const usesDefaultSearchTool = (search.toolName ?? "search_docs") === "search_docs";
-	const isSameOrigin = resolvedEndpoint.origin === new URL(requestUrl).origin;
-	return {
-		...search,
-		endpoint: resolvedEndpoint.toString(),
-		forwardAudience: search.forwardAudience ?? (usesDefaultSearchTool && isSameOrigin)
-	};
-}
-/**
-* Resolve the public search audience without allowing malformed values to opt into agent content.
-* Human search remains the default for omitted, legacy, and unknown query values.
-*/
-function resolveDocsSearchAudience(value) {
-	return value === "agent" ? "agent" : "human";
-}
-function resolveAskAISearchRequestConfig(options) {
-	if (!options.useMcp) return resolveSearchRequestConfig(options.search, options.requestUrl);
-	if (typeof options.useMcp === "object") return resolveSearchRequestConfig({
-		...options.useMcp,
-		provider: "mcp"
-	}, options.requestUrl);
-	if (options.mcpEnabled === false || options.mcpSearchEnabled === false || !options.mcpEndpoint) return resolveSearchRequestConfig(options.search, options.requestUrl);
-	return resolveSearchRequestConfig({
-		provider: "mcp",
-		endpoint: options.mcpEndpoint
-	}, options.requestUrl);
-}
-function createMcpSearchAdapter(config) {
-	return {
-		name: "mcp",
-		async search(query, context) {
-			const endpoint = resolveMcpEndpoint(config.endpoint);
-			const protocolVersion = config.protocolVersion ?? DEFAULT_MCP_PROTOCOL_VERSION;
-			const toolName = config.toolName ?? "search_docs";
-			const forwardAudience = config.forwardAudience === true;
-			const audience = resolveDocsSearchAudience(query.audience);
-			const baseHeaders = config.headers ?? {};
-			if (audience === "human" && !forwardAudience) throw new Error("MCP human-projection search requires forwardAudience: true on an audience-aware tool.");
-			const initializeResponse = await fetch(endpoint, {
-				method: "POST",
-				headers: {
-					...baseHeaders,
-					"Content-Type": "application/json",
-					accept: "application/json, text/event-stream",
-					"mcp-protocol-version": protocolVersion
-				},
-				body: JSON.stringify({
-					jsonrpc: "2.0",
-					id: 1,
-					method: "initialize",
-					params: {
-						protocolVersion,
-						capabilities: {},
-						clientInfo: {
-							name: "@farming-labs/docs-search",
-							version: "0.1.2"
-						}
-					}
-				}),
-				signal: context.signal
-			});
-			const initializePayload = await readMcpResponsePayload(initializeResponse);
-			ensureOk(initializeResponse, "MCP search initialization failed");
-			ensureJsonRpcOk(initializePayload, "MCP search initialization failed");
-			const sessionId = initializeResponse.headers.get("mcp-session-id") ?? void 0;
-			try {
-				const searchResponse = await fetch(endpoint, {
-					method: "POST",
-					headers: {
-						...baseHeaders,
-						"Content-Type": "application/json",
-						accept: "application/json, text/event-stream",
-						"mcp-protocol-version": protocolVersion,
-						...sessionId ? { "mcp-session-id": sessionId } : {}
-					},
-					body: JSON.stringify({
-						jsonrpc: "2.0",
-						id: 2,
-						method: "tools/call",
-						params: {
-							name: toolName,
-							arguments: {
-								query: query.query,
-								limit: query.limit ?? config.maxResults ?? DEFAULT_SEARCH_LIMIT,
-								locale: query.locale,
-								...forwardAudience ? { audience } : {},
-								...query.filters?.framework ? { framework: query.filters.framework } : {},
-								...query.filters?.version ? { version: query.filters.version } : {},
-								...query.filters?.package ? { package: query.filters.package } : {},
-								...query.filters?.tags ? { tags: query.filters.tags } : {}
-							}
-						}
-					}),
-					signal: context.signal
-				});
-				const payload = await readMcpResponsePayload(searchResponse);
-				ensureOk(searchResponse, "MCP search request failed");
-				ensureJsonRpcOk(payload, "MCP search request failed");
-				const parsed = readMcpSearchToolPayload(payload);
-				if (!parsed) return [];
-				if (hasDocsSearchFilters(query.filters ?? {})) {
-					if (Array.isArray(parsed) || parsed.format !== "docs-search.v1") return [];
-					const echoedFilters = parseVerifiedMcpSearchFilters(parsed.filters);
-					if (!echoedFilters || !docsSearchFiltersMatch(query.filters ?? {}, echoedFilters)) return [];
-				}
-				return (Array.isArray(parsed) ? parsed : Array.isArray(parsed.results) ? parsed.results : Array.isArray(parsed.pages) ? parsed.pages : []).map((result) => mapMcpSearchResult(result, endpoint)).filter((result) => Boolean(result));
-			} finally {
-				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);
-					}
-				}
-			}
-		}
-	};
-}
-function getAlgoliaSearchBase(config) {
-	return `https://${config.appId}-dsn.algolia.net`;
-}
-function getAlgoliaAdminBase(config) {
-	return `https://${config.appId}.algolia.net`;
-}
-function getAlgoliaAdminHeaders(config) {
-	return {
-		"Content-Type": "application/json",
-		"X-Algolia-Application-Id": config.appId,
-		"X-Algolia-API-Key": config.adminApiKey ?? config.searchApiKey
-	};
-}
-async function waitForAlgoliaTask(config, taskId, signal) {
-	const deadline = Date.now() + 6e4;
-	for (let attempt = 0; Date.now() < deadline; attempt += 1) {
-		const response = await fetch(`${getAlgoliaAdminBase(config)}/1/indexes/${encodeURIComponent(config.indexName)}/task/${encodeURIComponent(String(taskId))}`, {
-			headers: getAlgoliaAdminHeaders(config),
-			signal
-		});
-		ensureOk(response, "Failed to inspect Algolia sync task");
-		const payload = await readResponseJson(response);
-		if (payload?.status === "published") return;
-		if (payload?.status !== "notPublished") throw new Error("Algolia sync task returned an unknown status.");
-		const delay = Math.min(100 * 2 ** Math.min(attempt, 4), 2e3);
-		await new Promise((resolve, reject) => {
-			let timer;
-			const onAbort = () => {
-				clearTimeout(timer);
-				reject(signal?.reason ?? /* @__PURE__ */ new Error("Algolia sync was aborted."));
-			};
-			timer = setTimeout(() => {
-				signal?.removeEventListener("abort", onAbort);
-				resolve();
-			}, Math.min(delay, Math.max(1, deadline - Date.now())));
-			if (signal?.aborted) onAbort();
-			else signal?.addEventListener("abort", onAbort, { once: true });
-		});
-	}
-	throw new Error("Timed out waiting for Algolia to publish the synced index.");
-}
-async function executeAlgoliaBatch(config, requests, message, signal) {
-	for (let offset = 0; offset < requests.length; offset += ALGOLIA_BATCH_OPERATIONS) {
-		const batch = requests.slice(offset, offset + ALGOLIA_BATCH_OPERATIONS);
-		const response = await fetch(`${getAlgoliaAdminBase(config)}/1/indexes/${encodeURIComponent(config.indexName)}/batch`, {
-			method: "POST",
-			headers: getAlgoliaAdminHeaders(config),
-			body: JSON.stringify({ requests: batch }),
-			signal
-		});
-		ensureOk(response, message);
-		const payload = await readResponseJson(response);
-		if (typeof payload?.taskID !== "string" && typeof payload?.taskID !== "number") throw new Error("Algolia sync response did not include a task ID.");
-		await waitForAlgoliaTask(config, payload.taskID, signal);
-	}
-}
-function quoteAlgoliaFilterValue(value) {
-	return `"${value.replace(/\\/gu, "\\\\").replace(/"/gu, "\\\"")}"`;
-}
-function createAlgoliaSearchAdapter(config) {
-	return {
-		name: "algolia",
-		async index(context) {
-			if (!config.adminApiKey) return;
-			const corpusId = resolveHostedHumanCorpusId(config.syncNamespace, context);
-			await executeAlgoliaBatch(config, (await enrichDocsSearchDocumentsWithSources({
-				documents: context.documents,
-				pages: context.pages,
-				audience: resolveDocsSearchAudience(context.audience),
-				chunking: context.chunking ?? { strategy: "section" },
-				locale: context.locale,
-				baseUrl: context.baseUrl,
-				indexGeneration: context.indexGeneration
-			})).map((document) => ({
-				action: "addObject",
-				body: buildAlgoliaRecord(document, corpusId)
-			})), "Failed to sync documents to Algolia", context.signal);
-		},
-		async search(query, context) {
-			const corpusId = resolveHostedHumanCorpusId(config.syncNamespace, context);
-			const scopedDocumentIds = resolveProviderScopeDocumentIds(query, context, corpusId);
-			if (scopedDocumentIds?.length === 0) return [];
-			const scopedIdsFilter = scopedDocumentIds?.map((id) => `objectID:${quoteAlgoliaFilterValue(id)}`).join(" OR ");
-			const filterClauses = [corpusId ? `_tags:${quoteAlgoliaFilterValue(corpusId)}` : void 0, scopedIdsFilter ? corpusId ? `(${scopedIdsFilter})` : scopedIdsFilter : void 0].filter((value) => Boolean(value));
-			const filters = filterClauses.length > 0 ? filterClauses.join(" AND ") : void 0;
-			if (filters && filters.length > MAX_PROVIDER_SCOPE_FILTER_CHARS) return [];
-			const response = await fetch(`${getAlgoliaSearchBase(config)}/1/indexes/${encodeURIComponent(config.indexName)}/query`, {
-				method: "POST",
-				headers: {
-					"Content-Type": "application/json",
-					"X-Algolia-Application-Id": config.appId,
-					"X-Algolia-API-Key": config.searchApiKey
-				},
-				body: JSON.stringify({
-					query: query.query,
-					hitsPerPage: query.limit ?? config.maxResults ?? DEFAULT_SEARCH_LIMIT,
-					restrictSearchableAttributes: [
-						"title",
-						"section",
-						"content",
-						"description"
-					],
-					attributesToSnippet: ["content:20"],
-					...filters ? { filters } : {}
-				}),
-				signal: context.signal
-			});
-			ensureOk(response, "Algolia search failed");
-			return ((await readResponseJson(response)).hits ?? []).flatMap((hit) => {
-				if (!hostedRecordMatchesCorpus(hit, corpusId)) return [];
-				const title = typeof hit.title === "string" ? hit.title : "Untitled result";
-				const section = typeof hit.section === "string" ? hit.section : void 0;
-				const source = readHostedRetrievalSource(hit);
-				if (hasHostedRetrievalSource(hit) && !source) return [];
-				return [{
-					id: readHostedSourceDocumentId(hit) ?? hit.objectID ?? String(hit.url ?? title),
-					url: typeof hit.url === "string" ? hit.url : "/docs",
-					content: cleanSearchResultText(section ? `${title} — ${section}` : title) ?? title,
-					description: cleanSearchResultText(hit._snippetResult?.content?.value ?? hit._snippetResult?.description?.value ?? (typeof hit.description === "string" ? hit.description : void 0)),
-					type: typeof hit.type === "string" && [
-						"page",
-						"heading",
-						"text"
-					].includes(hit.type) ? hit.type : section ? "heading" : "page",
-					score: hit._rankingInfo?.nbTypos != null ? 100 - hit._rankingInfo.nbTypos : void 0,
-					section,
-					...source ? { source } : {}
-				}];
-			});
-		}
-	};
-}
-async function resolveSearchAdapter(search, context) {
-	const raw = search.raw;
-	if (search.provider === "custom" && raw?.provider === "custom") return typeof raw.adapter === "function" ? await raw.adapter(context) : raw.adapter;
-	if (search.provider === "typesense" && raw?.provider === "typesense") return createTypesenseSearchAdapter(raw);
-	if (search.provider === "mcp" && raw?.provider === "mcp") return createMcpSearchAdapter(raw);
-	if (search.provider === "algolia" && raw?.provider === "algolia") return createAlgoliaSearchAdapter(raw);
-	return createSimpleSearchAdapter();
-}
-function shouldSyncOnSearch(search) {
-	const raw = search.raw;
-	if (search.provider === "algolia" && raw?.provider === "algolia") return (raw.syncOnSearch ?? Boolean(raw.adminApiKey)) && Boolean(raw.adminApiKey);
-	if (search.provider === "typesense" && raw?.provider === "typesense") return (raw.syncOnSearch ?? Boolean(raw.adminApiKey)) && Boolean(raw.adminApiKey);
-	return false;
-}
-function getSyncKey(search, context) {
-	const raw = search.raw;
-	if (search.provider === "algolia" && raw?.provider === "algolia") {
-		const corpusId = resolveHostedHumanCorpusId(raw.syncNamespace, context) ?? "__unowned__";
-		return `algolia:${raw.appId}:${raw.indexName}:${corpusId}:${context.locale ?? "__default__"}`;
-	}
-	if (search.provider === "typesense" && raw?.provider === "typesense") {
-		const corpusId = resolveHostedHumanCorpusId(raw.syncNamespace, context) ?? "__unowned__";
-		return `typesense:${raw.baseUrl}:${raw.collection}:${corpusId}:${context.locale ?? "__default__"}`;
-	}
-	if (search.provider === "mcp" && raw?.provider === "mcp") return `mcp:${raw.endpoint}:${context.locale ?? "__default__"}`;
-	return `${search.provider}:${context.locale ?? "__default__"}`;
-}
-function getSearchSyncFingerprint(search, context, indexGeneration) {
-	const raw = search.raw;
-	const providerConfig = search.provider === "typesense" && raw?.provider === "typesense" ? {
-		syncNamespace: raw.syncNamespace?.trim() || void 0,
-		mode: raw.mode ?? "keyword",
-		embeddings: raw.embeddings ? {
-			provider: raw.embeddings.provider,
-			model: raw.embeddings.model,
-			baseUrl: raw.embeddings.baseUrl
-		} : void 0
-	} : search.provider === "algolia" && raw?.provider === "algolia" ? { syncNamespace: raw.syncNamespace?.trim() || void 0 } : void 0;
-	return hashDocsRetrievalValue(JSON.stringify({
-		format: "docs-search-sync.v1",
-		indexGeneration,
-		canonicalBaseUrl: context.baseUrl,
-		provider: search.provider,
-		providerConfig
-	}));
-}
-async function maybeSyncSearchIndex(adapter, search, context) {
-	if (!shouldSyncOnSearch(search) || typeof adapter.index !== "function") return;
-	const syncKey = getSyncKey(search, context);
-	const indexGeneration = context.indexGeneration ?? await buildDocsSearchIndexGeneration(context.pages, {
-		audience: resolveDocsSearchAudience(context.audience),
-		chunking: context.chunking ?? search.chunking,
-		locale: context.locale,
-		baseUrl: context.baseUrl
-	});
-	context.indexGeneration = indexGeneration;
-	const syncFingerprint = getSearchSyncFingerprint(search, context, indexGeneration);
-	while (true) {
-		const inFlight = syncingIndexes.get(syncKey);
-		if (inFlight) {
-			try {
-				await inFlight.promise;
-			} catch (error) {
-				if (inFlight.fingerprint === syncFingerprint) throw error;
-			}
-			continue;
-		}
-		if (syncedIndexes.get(syncKey) === syncFingerprint) return;
-		const sync = adapter.index(context).then(() => {
-			syncedIndexes.set(syncKey, syncFingerprint);
-		});
-		syncingIndexes.set(syncKey, {
-			fingerprint: syncFingerprint,
-			promise: sync
-		});
-		try {
-			await sync;
-		} finally {
-			if (syncingIndexes.get(syncKey)?.promise === sync) syncingIndexes.delete(syncKey);
-		}
-	}
-}
-async function performDocsSearch(options) {
-	const search = normalizeDocsSearchConfig(options.search);
-	if (!search.enabled) return [];
-	const audience = resolveDocsSearchAudience(options.audience);
-	const filters = normalizeDocsSearchFilters(options.filters);
-	const hasFilters = hasDocsSearchFilters(filters);
-	const corpusPages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale));
-	const indexBaseUrl = options.syncBaseUrl === null ? void 0 : options.syncBaseUrl ?? options.baseUrl;
-	const scopedPages = hasFilters ? corpusPages.filter((page) => docsSearchPageMatchesFilters(resolveDocsSearchPageScope(page), filters)) : corpusPages;
-	let resolvedDocuments;
-	const getDocuments = () => {
-		if (!resolvedDocuments) resolvedDocuments = buildDocsSearchDocuments(scopedPages, search.chunking, audience);
-		return resolvedDocuments;
-	};
-	const context = {
-		pages: scopedPages,
-		get documents() {
-			return getDocuments();
-		},
-		set documents(documents) {
-			resolvedDocuments = documents;
-		},
-		audience,
-		locale: options.locale,
-		pathname: options.pathname,
-		siteTitle: options.siteTitle,
-		baseUrl: options.baseUrl,
-		indexBaseUrl,
-		chunking: search.chunking,
-		deferSourceProvenance: true,
-		signal: options.signal
-	};
-	const query = {
-		query: options.query,
-		limit: options.limit ?? search.maxResults,
-		locale: options.locale,
-		pathname: options.pathname,
-		audience,
-		...hasFilters ? { filters } : {}
-	};
-	let currentIndexGeneration;
-	const getCurrentIndexGeneration = () => {
-		currentIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
-			audience,
-			chunking: search.chunking,
-			locale: options.locale,
-			baseUrl: options.baseUrl
-		});
-		return currentIndexGeneration;
-	};
-	const requireCurrentIndexGeneration = search.provider === "algolia" || search.provider === "typesense";
-	const finalizeResults = async (results) => enrichDocsSearchResultsWithSources({
-		results,
-		pages: scopedPages,
-		generationPages: options.generationPages ?? options.pages,
-		audience,
-		chunking: search.chunking,
-		locale: options.locale,
-		baseUrl: options.baseUrl,
-		indexGeneration: options.indexGeneration,
-		strictExternalOrigins: options.strictExternalOrigins,
-		filters,
-		requireCurrentIndexGeneration
-	});
-	try {
-		const adapter = await resolveSearchAdapter(search, context);
-		if (shouldSyncOnSearch(search) && typeof adapter.index === "function") {
-			const syncPages = audience === "agent" || hasFilters ? corpusPages : scopedPages;
-			await maybeSyncSearchIndex(adapter, search, {
-				pages: syncPages,
-				documents: buildDocsSearchDocuments(syncPages, search.chunking, "human"),
-				audience: "human",
-				locale: options.locale,
-				pathname: options.pathname,
-				siteTitle: options.siteTitle,
-				baseUrl: indexBaseUrl,
-				indexBaseUrl,
-				chunking: search.chunking,
-				signal: options.signal
-			});
-		}
-		const adapterSearch = adapter.search(query, context);
-		let documents;
-		try {
-			documents = getDocuments();
-		} catch (error) {
-			adapterSearch.catch(() => void 0);
-			throw error;
-		}
-		const results = await adapterSearch;
-		if (search.provider === "simple") return finalizeResults(results);
-		const localAudienceProjectionResults = buildAudienceProjectionSearchResults(documents, options.query);
-		const localPagePaths = new Set(scopedPages.map((page) => normalizeUrlRouteKey(page.url)));
-		const allLocalPagePaths = hasFilters && search.provider === "mcp" ? new Set(options.pages.map((page) => normalizeUrlRouteKey(page.url))) : localPagePaths;
-		const preserveUnmatched = !hasFilters && audience === "human" || search.provider === "mcp" ? (result) => shouldPreserveUnmatchedExternalResult({
-			result,
-			localPagePaths: allLocalPagePaths,
-			baseUrl: options.baseUrl
-		}) : void 0;
-		const isKnownLocalProviderResult = (result) => isLocalProviderResult(result, options.baseUrl) && localPagePaths.has(normalizeUrlRouteKey(result.url));
-		const expectedProviderGeneration = requireCurrentIndexGeneration ? audience === "human" ? await getCurrentIndexGeneration() : await buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
-			audience: "human",
-			chunking: search.chunking,
-			locale: options.locale,
-			baseUrl: indexBaseUrl
-		}) : void 0;
-		const providerAudience = requireCurrentIndexGeneration ? "human" : audience;
-		const safeAdapterResults = sanitizeExternalAudienceSearchResults(results.filter((result) => {
-			if (result.source === void 0) return !requireCurrentIndexGeneration || isKnownLocalProviderResult(result);
-			const source = parseDocsRetrievalSource(result.source, { allowRootRelativeCanonical: requireCurrentIndexGeneration || isKnownLocalProviderResult(result) });
-			const knownLocal = isKnownLocalProviderResult(result);
-			return Boolean(source && docsRetrievalSourceMatchesRequest(source, providerAudience, knownLocal ? void 0 : filters, options.locale) && (!expectedProviderGeneration || source.indexGeneration === expectedProviderGeneration));
-		}).filter((result) => requireCurrentIndexGeneration && isKnownLocalProviderResult(result) || !hasOppositeAudienceEvidence({
-			result,
-			pages: scopedPages,
-			query: options.query,
-			audience,
-			baseUrl: options.baseUrl
-		})), localAudienceProjectionResults, options.baseUrl, preserveUnmatched, requireCurrentIndexGeneration && audience === "agent");
-		if (options.supplementExternalResults === false) return finalizeResults(safeAdapterResults.slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT));
-		const simpleAudienceResults = audience === "agent" || results.length === 0 || safeAdapterResults.length < results.length ? await createSimpleSearchAdapter().search(query, context) : [];
-		const combinedResults = mergeSearchResults([
-			buildExactPageSearchResults(options.query, scopedPages, audience),
-			safeAdapterResults,
-			simpleAudienceResults
-		], audience === "agent" ? (result) => getAskAIResultKey(result, options.baseUrl, options.strictExternalOrigins) : void 0);
-		return finalizeResults(prioritizeLiteralInsideResults(options.query, combinedResults).slice(0, query.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT));
-	} catch (error) {
-		if (options.failureMode === "throw") throw error;
-		return finalizeResults(await createSimpleSearchAdapter().search(query, context));
-	}
-}
-function compareSearchMetadataValues(left, right) {
-	if (left === right) return 0;
-	return left < right ? -1 : 1;
-}
-function boundedSearchWarningValues(values) {
-	const bounded = Array.from(new Set(values)).sort(compareSearchMetadataValues).slice(0, MAX_SEARCH_WARNING_VALUES);
-	return bounded.length > 0 ? bounded : void 0;
-}
-function boundedSearchWarningPageUrls(pages) {
-	const bounded = Array.from(new Set(pages.map((page) => page.url))).sort(compareSearchMetadataValues).slice(0, MAX_SEARCH_WARNING_PAGE_URLS);
-	return bounded.length > 0 ? bounded : void 0;
-}
-function findSearchResultPages(pages, results, baseUrl) {
-	const pagesByPath = new Map(pages.map((page) => [normalizeUrlRouteKey(page.url), page]));
-	const found = /* @__PURE__ */ new Map();
-	for (const result of results) {
-		if (!isLocalProviderResult(result, baseUrl)) continue;
-		const page = pagesByPath.get(normalizeUrlRouteKey(result.url));
-		if (page) found.set(page.url, page);
-	}
-	return [...found.values()].sort((left, right) => compareSearchMetadataValues(left.url, right.url));
-}
-function searchScopeIsAmbiguous(field, values) {
-	if (values.length < 2) return false;
-	if (field !== "version") return true;
-	return values.some((left, index) => values.slice(index + 1).some((right) => !agentVersionConstraintsOverlap(left, right)));
-}
-function buildDocsSearchWarnings(options) {
-	const pageScopes = options.pages.map((page) => ({
-		page,
-		scope: resolveDocsSearchPageScope(page)
-	}));
-	const relevantPageScopes = pageScopes.filter(({ page }) => scoreDocument(options.query, pageToSearchDocument(page, options.audience)) > 0);
-	const warnings = [];
-	for (const field of SEARCH_FILTER_FIELDS) {
-		const conflicting = relevantPageScopes.filter(({ scope }) => scope.conflicts.includes(field));
-		if (conflicting.length > 0) warnings.push({
-			code: "conflicting_scope_metadata",
-			field,
-			message: `${conflicting.length} page${conflicting.length === 1 ? "" : "s"} declare conflicting ${field} metadata and cannot be selected safely by scoped search.`,
-			pageUrls: boundedSearchWarningPageUrls(conflicting.map(({ page }) => page)),
-			count: conflicting.length
-		});
-		const requested = options.filters[field];
-		if (!requested || requested.length === 0) continue;
-		const missing = relevantPageScopes.filter(({ scope }) => scope.declarations[field].length === 0);
-		if (missing.length > 0) warnings.push({
-			code: "missing_scope_metadata",
-			field,
-			message: `${missing.length} page${missing.length === 1 ? "" : "s"} lack ${field} metadata and were excluded by the strict scope filter.`,
-			pageUrls: boundedSearchWarningPageUrls(missing.map(({ page }) => page)),
-			count: missing.length
-		});
-		const unknown = requested.filter((value) => !pageScopes.some(({ scope }) => !scope.conflicts.includes(field) && docsSearchScopeFieldMatches(scope, field, [value])));
-		if (unknown.length > 0) warnings.push({
-			code: "unknown_filter_value",
-			field,
-			message: `No page metadata matches ${field} filter value${unknown.length === 1 ? "" : "s"}: ${unknown.join(", ")}.`,
-			values: boundedSearchWarningValues(unknown),
-			count: unknown.length
-		});
-	}
-	const resultPages = findSearchResultPages(options.pages, options.results, options.baseUrl);
-	for (const field of SEARCH_AMBIGUITY_FIELDS) {
-		if ((options.filters[field]?.length ?? 0) > 0) continue;
-		const values = resultPages.flatMap((page) => {
-			const scope = resolveDocsSearchPageScope(page);
-			return scope.conflicts.includes(field) ? [] : scope[field];
-		});
-		const unique = Array.from(new Set(values)).sort(compareSearchMetadataValues);
-		if (!searchScopeIsAmbiguous(field, unique)) continue;
-		const contributingPages = resultPages.filter((page) => {
-			const scope = resolveDocsSearchPageScope(page);
-			return !scope.conflicts.includes(field) && scope[field].length > 0;
-		});
-		warnings.push({
-			code: "ambiguous_scope",
-			field,
-			message: `Search results span multiple ${field} scopes; add a ${field} filter before acting on scope-specific guidance.`,
-			values: boundedSearchWarningValues(unique),
-			pageUrls: boundedSearchWarningPageUrls(contributingPages),
-			count: unique.length
-		});
-	}
-	const codeOrder = {
-		ambiguous_scope: 0,
-		unknown_filter_value: 1,
-		missing_scope_metadata: 2,
-		conflicting_scope_metadata: 3
-	};
-	return warnings.sort((left, right) => {
-		const codeDelta = codeOrder[left.code] - codeOrder[right.code];
-		if (codeDelta !== 0) return codeDelta;
-		return SEARCH_FILTER_FIELDS.indexOf(left.field) - SEARCH_FILTER_FIELDS.indexOf(right.field);
-	}).slice(0, MAX_SEARCH_WARNINGS);
-}
-async function performDocsSearchWithMetadata(options) {
-	const audience = resolveDocsSearchAudience(options.audience);
-	const filters = normalizeDocsSearchFilters(options.filters);
-	const search = normalizeDocsSearchConfig(options.search);
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
-		audience,
-		chunking: search.chunking,
-		locale: options.locale,
-		baseUrl: options.baseUrl
-	});
-	const results = options.query.trim() ? await performDocsSearch({
-		...options,
-		audience,
-		filters,
-		indexGeneration
-	}) : [];
-	return {
-		format: "docs-search.v1",
-		query: options.query,
-		audience,
-		filters,
-		indexGeneration,
-		resultCount: results.length,
-		results,
-		warnings: buildDocsSearchWarnings({
-			pages: options.pages,
-			results,
-			filters,
-			query: options.query,
-			audience,
-			baseUrl: options.baseUrl
-		})
-	};
-}
-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 searchResults = await performDocsSearch({
-		pages: options.pages,
-		query: options.query,
-		search: primarySearch,
-		audience: "agent",
-		locale: options.locale,
-		pathname: options.pathname,
-		siteTitle: options.siteTitle,
-		baseUrl: options.baseUrl,
-		syncBaseUrl: options.syncBaseUrl,
-		limit: searchLimit,
-		filters: options.filters,
-		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, options.baseUrl),
-			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) => 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;
-	}).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,
-		blocks: blocks.map((text, index) => ({
-			text,
-			result: results[index]
-		})),
-		results: results.slice(0, blocks.length),
-		searchResults: rankedResults.map((item) => item.result),
-		packageHints: inferDocsAskAIPackageHints(context)
-	};
-}
-function createCustomSearchAdapter(adapter) {
-	return {
-		provider: "custom",
-		adapter
-	};
-}
-
-//#endregion
-export { GENERATED_AGENT_PROVENANCE_MARKER as A, resolveSidebarFolderIndexBehaviorForPath as B, agentVersionConstraintsOverlap as C, normalizeAgentVersion as D, normalizeAgentScopeValues as E, serializeGeneratedAgentDocument as F, getDocsTelemetryFeatures as G, emitDocsTelemetryEvent as H, stripGeneratedAgentProvenance as I, normalizeDocsTelemetryOrigin as J, inferDocsTelemetryAgentSurface as K, applySidebarFolderIndexBehavior as L, hashGeneratedAgentContent as M, normalizeGeneratedAgentContent as N, digestDocsRetrievalContent as O, parseGeneratedAgentDocument as P, resolvePageSidebarFolderIndexBehavior as R, agentVersionConstraintMatches as S, normalizeAgentLocale as T, emitDocsTelemetryMcpToolEvent as U, emitDocsTelemetryAgentSurfaceEvent as V, emitDocsTelemetryProjectEvent as W, resolveDocsTelemetryConfig as Y, resolveDocsSearchAudience as _, createCustomSearchAdapter as a, resolveSearchRequestConfig as b, createTypesenseSearchAdapter as c, inferDocsAskAIPackageHints as d, normalizeDocsSearchFilters as f, resolveDocsRetrievalLastModified as g, resolveAskAISearchRequestConfig as h, createAlgoliaSearchAdapter as i, GENERATED_AGENT_PROVENANCE_VERSION as j, isDocsRetrievalCanonicalUrl as k, enrichDocsSearchDocumentsWithProvenance as l, performDocsSearchWithMetadata as m, buildDocsRetrievalDigestProjection as n, createMcpSearchAdapter as o, performDocsSearch as p, isLocalDocsTelemetryOrigin as q, buildDocsSearchDocuments as r, createSimpleSearchAdapter as s, buildDocsAskAIContext as t, formatDocsAskAIPackageHints as u, resolveDocsSearchFilters as v, normalizeAgentFramework as w, agentVersionConstraintGroupsOverlap as x, resolveDocsSearchRequest as y, resolveSidebarFolderIndexBehavior as z };