@farming-labs/docs 0.2.60 → 0.2.62

package/dist/cloud-analytics-CSyFE6SS.mjs

@@ -1,132 +0,0 @@
-//#region src/cloud-analytics.ts
-const DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT = "https://api.farming-labs.dev/v1/analytics/events";
-function normalizeRuntimeEnvValue(value) {
-	const normalized = value?.trim();
-	return normalized ? normalized : void 0;
-}
-function readRuntimeEnv(name) {
-	if (typeof process === "undefined" || !process.env) return;
-	switch (name) {
-		case "PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_PROJECT_ID);
-		case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
-		case "DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_PROJECT_ID);
-		case "PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
-		case "DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_KEY);
-		case "PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
-		case "DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_ENABLED);
-		case "PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
-		case "DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_ENDPOINT);
-		default: return;
-	}
-}
-function isFalsyEnv(value) {
-	if (!value) return false;
-	return /^(0|false|no|off)$/i.test(value);
-}
-function resolveDocsCloudAnalyticsOptions(analytics) {
-	if (analytics === false || analytics && typeof analytics === "object" && (analytics.enabled === false || analytics.cloud === false)) return null;
-	const projectId = readRuntimeEnv("PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv("DOCS_CLOUD_PROJECT_ID");
-	const apiKey = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_KEY");
-	const enabled = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENABLED");
-	const endpoint = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
-	if (isFalsyEnv(enabled)) return null;
-	if (!projectId) return null;
-	return {
-		endpoint,
-		projectId,
-		apiKey
-	};
-}
-function asRecord(value) {
-	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function asString(value) {
-	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function normalizeAnalyticsLabel(value) {
-	return value?.trim().toLowerCase().replace(/[-\s]+/g, "_") ?? "";
-}
-function isProtocolAgentEvent(event) {
-	const type = normalizeAnalyticsLabel(event.type);
-	return normalizeAnalyticsLabel(event.source) === "mcp" || type.startsWith("mcp_");
-}
-function inferAgentProvider(event) {
-	const type = normalizeAnalyticsLabel(event.type);
-	if (normalizeAnalyticsLabel(event.source) === "mcp" || type.startsWith("mcp_")) return "MCP client";
-	if (type.startsWith("agent_") || type === "agents_request") return "Docs agent";
-	if ([
-		"llms_request",
-		"markdown_request",
-		"skill_request"
-	].includes(type)) return "Docs reader";
-}
-function detectAgentProviderFromUserAgent(userAgent) {
-	const value = userAgent?.toLowerCase() ?? "";
-	if (!value) return;
-	for (const [pattern, provider] of [
-		[/cursor/i, "Cursor"],
-		[/codex/i, "Codex"],
-		[/chatgpt-user|chatgpt/i, "ChatGPT"],
-		[/gptbot/i, "GPTBot"],
-		[/oai-searchbot|openai-search/i, "ChatGPT Search"],
-		[/openai/i, "ChatGPT"],
-		[/github-copilot|githubcopilot|copilot/i, "GitHub Copilot"],
-		[/claudebot|claude-user|anthropic/i, "Claude"],
-		[/perplexitybot|perplexity-user/i, "Perplexity"],
-		[/google-extended|googlebot|apis-google/i, "Google"],
-		[/bingbot|msnbot/i, "Bing"],
-		[/duckduckbot/i, "DuckDuckGo"],
-		[/applebot/i, "Apple"],
-		[/bytespider|bytedance/i, "ByteDance"],
-		[/ccbot|common crawl/i, "Common Crawl"],
-		[/ahrefsbot/i, "Ahrefs"],
-		[/semrushbot/i, "Semrush"]
-	]) if (pattern.test(value)) return provider;
-	if (/bot|crawler|spider|slurp|facebookexternalhit|ia_archiver/.test(value)) return "Other bot";
-}
-function withDocsCloudAnalyticsHints(event) {
-	const properties = asRecord(event.properties);
-	const detectedAgent = detectAgentProviderFromUserAgent(asString(properties.userAgent) ?? asString(properties.user_agent));
-	const protocolAgent = isProtocolAgentEvent(event);
-	const incomingTrafficType = asString(properties.trafficType)?.toLowerCase();
-	const explicitAgent = incomingTrafficType === "agent" || incomingTrafficType === "bot";
-	const agentProvider = asString(properties.agentName) ?? asString(properties.agent) ?? asString(properties.botProvider) ?? asString(properties.provider) ?? asString(properties.crawler) ?? asString(asRecord(properties.bot).provider) ?? detectedAgent ?? (protocolAgent || explicitAgent ? inferAgentProvider(event) : void 0);
-	if (!explicitAgent && !protocolAgent && !detectedAgent && !agentProvider) return event;
-	return {
-		...event,
-		properties: {
-			...properties,
-			trafficType: "agent",
-			...agentProvider && !asString(properties.agentName) ? { agentName: agentProvider } : {},
-			...agentProvider && !asString(properties.botProvider) ? { botProvider: agentProvider } : {}
-		}
-	};
-}
-async function sendDocsCloudAnalyticsEvent(options, event) {
-	const fetcher = options.fetch ?? (typeof fetch === "function" ? fetch : void 0);
-	if (!fetcher) return;
-	const endpoint = options.endpoint?.trim() || DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
-	const projectId = options.projectId?.trim();
-	if (!endpoint || !projectId) return;
-	try {
-		const normalizedEvent = withDocsCloudAnalyticsHints(event);
-		await fetcher(endpoint, {
-			method: "POST",
-			headers: {
-				"content-type": "application/json",
-				...options.apiKey ? { authorization: `Bearer ${options.apiKey}` } : {}
-			},
-			body: JSON.stringify({
-				projectId,
-				event: normalizedEvent
-			}),
-			keepalive: true
-		});
-	} catch {}
-}
-
-//#endregion
-export { sendDocsCloudAnalyticsEvent as n, resolveDocsCloudAnalyticsOptions as t };

package/dist/cloud-ask-ai-B2WnG4fF.d.mts

@@ -1,23 +0,0 @@
-import { F as DocsAnalyticsConfig, Y as DocsCloudConfig, t as AIConfig } from "./types-XHABMh_f.mjs";
-
-//#region src/cloud-ask-ai.d.ts
-interface DocsCloudAskAIConfig {
-  ai?: Pick<AIConfig, "docsUrl" | "enabled" | "provider" | "stream">;
-  analytics?: boolean | DocsAnalyticsConfig;
-  cloud?: DocsCloudConfig;
-}
-interface DocsCloudAskAIResponseOptions {
-  config?: DocsCloudAskAIConfig;
-  /**
-   * Runtime env map for frameworks that expose environment variables outside
-   * `process.env`, for example SvelteKit's `$env/dynamic/private`.
-   */
-  env?: Record<string, string | undefined>;
-  fetch?: typeof fetch;
-  publicBaseUrl?: string;
-  locale?: string;
-}
-declare function isDocsCloudAskAIProvider(config: Pick<AIConfig, "enabled" | "provider"> | undefined): boolean;
-declare function createDocsCloudAskAIResponse(request: Request, options?: DocsCloudAskAIResponseOptions): Promise<Response>;
-//#endregion
-export { isDocsCloudAskAIProvider as i, DocsCloudAskAIResponseOptions as n, createDocsCloudAskAIResponse as r, DocsCloudAskAIConfig as t };

package/dist/cloud-ask-ai-hnJfj8-X.mjs

@@ -1,382 +0,0 @@
-import { a as emitDocsAnalyticsEvent } from "./analytics-Bx44lg6d.mjs";
-
-//#region src/cloud-ask-ai.ts
-const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
-const DEFAULT_DOCS_CLOUD_API_KEY_ENV = "DOCS_CLOUD_API_KEY";
-const DOCS_CLOUD_PROJECT_ID_ENVS = [
-	"PUBLIC_DOCS_CLOUD_PROJECT_ID",
-	"DOCS_CLOUD_PROJECT_ID",
-	"NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID"
-];
-const DOCS_CLOUD_API_BASE_URL_ENVS = [
-	"DOCS_CLOUD_API_BASE_URL",
-	"DOCS_CLOUD_API_URL",
-	"PUBLIC_DOCS_CLOUD_URL",
-	"NEXT_PUBLIC_DOCS_CLOUD_URL"
-];
-const DOCS_CLOUD_FOOTER_GUARD_CHARS = 256;
-const docsCloudRelevantDocsPattern = /\n{2,}(?:-{3,}|\*{3,}|_{3,})[ \t]*\n{1,3}(?:#{1,6}[ \t]+)?(?:\*\*)?Relevant docs(?:\*\*)?[ \t]*/i;
-const docsCloudThematicBreakPattern = /^[ \t]*(?:-{3,}|\*{3,}|_{3,})[ \t]*$/gm;
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readEnv(name, env) {
-	const trimmed = (env?.[name] ?? (typeof process !== "undefined" ? process.env?.[name] : void 0))?.trim();
-	return trimmed ? trimmed : void 0;
-}
-function readFirstEnv(names, env) {
-	for (const name of names) {
-		const value = readEnv(name, env);
-		if (value) return value;
-	}
-}
-function resolveDocsCloudApiBaseUrl(env) {
-	return (readFirstEnv(DOCS_CLOUD_API_BASE_URL_ENVS, env) ?? DEFAULT_DOCS_CLOUD_API_BASE_URL).replace(/\/+$/, "");
-}
-function resolveDocsCloudProjectId(env) {
-	return readFirstEnv(DOCS_CLOUD_PROJECT_ID_ENVS, env);
-}
-function resolveDocsCloudApiKey(cloudConfig, env) {
-	const envName = cloudConfig?.apiKey?.env?.trim() || DEFAULT_DOCS_CLOUD_API_KEY_ENV;
-	return {
-		envName,
-		apiKey: readEnv(envName, env)
-	};
-}
-function jsonError(message, status) {
-	return Response.json({ error: message }, { status });
-}
-function textFromMessageContent(content) {
-	if (typeof content === "string") return content;
-	if (!Array.isArray(content)) return "";
-	return content.map((part) => {
-		if (typeof part === "string") return part;
-		if (!isPlainObject(part)) return "";
-		if (typeof part.text === "string") return part.text;
-		if (typeof part.content === "string") return part.content;
-		return "";
-	}).filter(Boolean).join("\n");
-}
-function lastUserQuestion(messages) {
-	if (!Array.isArray(messages)) return "";
-	return textFromMessageContent([...messages].reverse().find((message) => message?.role === "user")?.content).trim();
-}
-function resolveQuestion(body) {
-	return typeof body.question === "string" && body.question.trim() ? body.question.trim() : lastUserQuestion(body.messages);
-}
-function shouldStreamResponse(request, body, aiConfig) {
-	if (typeof body.stream === "boolean") return body.stream;
-	if (aiConfig?.stream === false) return false;
-	const accept = request.headers.get("accept")?.toLowerCase();
-	return !accept || accept.includes("text/event-stream") || accept.includes("*/*");
-}
-function stripRelevantDocsFooter(content) {
-	return content.replace(new RegExp(`${docsCloudRelevantDocsPattern.source}[\\s\\S]*$`, "i"), "").trimEnd();
-}
-function stripMarkdownThematicBreaks(content) {
-	return content.replace(docsCloudThematicBreakPattern, "").replace(/\n{3,}/g, "\n\n").trimEnd();
-}
-function cleanDocsCloudAnswer(content) {
-	return stripMarkdownThematicBreaks(stripRelevantDocsFooter(content));
-}
-function safeDocsCloudContent(content, final = false) {
-	const footerStart = content.search(docsCloudRelevantDocsPattern);
-	if (footerStart >= 0) return stripMarkdownThematicBreaks(content.slice(0, footerStart));
-	if (final) return cleanDocsCloudAnswer(content);
-	return stripMarkdownThematicBreaks(content.slice(0, Math.max(0, content.length - DOCS_CLOUD_FOOTER_GUARD_CHARS)));
-}
-function createOpenAICompatibleSseChunk(content) {
-	return `data: ${JSON.stringify({ choices: [{ delta: { content } }] })}\n\n`;
-}
-function createOpenAICompatibleSseResponse(content) {
-	const encoder = new TextEncoder();
-	const stream = new ReadableStream({ start(controller) {
-		if (content) controller.enqueue(encoder.encode(createOpenAICompatibleSseChunk(content)));
-		controller.enqueue(encoder.encode("data: [DONE]\n\n"));
-		controller.close();
-	} });
-	return new Response(stream, { headers: {
-		"Content-Type": "text/event-stream",
-		"Cache-Control": "no-cache, no-transform",
-		Connection: "keep-alive"
-	} });
-}
-function openAICompatibleDeltaContent(value) {
-	if (!isPlainObject(value)) return void 0;
-	const firstChoice = Array.isArray(value.choices) ? value.choices[0] : void 0;
-	if (!isPlainObject(firstChoice) || !isPlainObject(firstChoice.delta)) return void 0;
-	return typeof firstChoice.delta.content === "string" ? firstChoice.delta.content : void 0;
-}
-function docsCloudStreamContent(value) {
-	if (typeof value === "string") return value;
-	if (!isPlainObject(value)) return void 0;
-	for (const key of [
-		"content",
-		"text",
-		"answer",
-		"delta"
-	]) {
-		const content = value[key];
-		if (typeof content === "string") return content;
-	}
-}
-function docsCloudAnswerFromPayload(payload) {
-	if (!isPlainObject(payload)) return "";
-	for (const key of [
-		"answer",
-		"text",
-		"content"
-	]) {
-		const content = payload[key];
-		if (typeof content === "string") return content;
-	}
-	return "";
-}
-function createCleanDocsCloudSseResponse(upstream) {
-	if (!upstream.ok || !upstream.body) return new Response(upstream.body, {
-		status: upstream.status,
-		statusText: upstream.statusText,
-		headers: {
-			"Content-Type": upstream.headers.get("Content-Type") ?? "text/event-stream",
-			"Cache-Control": upstream.headers.get("Cache-Control") ?? "no-cache, no-transform",
-			Connection: upstream.headers.get("Connection") ?? "keep-alive"
-		}
-	});
-	const decoder = new TextDecoder();
-	const encoder = new TextEncoder();
-	const stream = new ReadableStream({ async start(controller) {
-		const reader = upstream.body.getReader();
-		let buffer = "";
-		let content = "";
-		let emittedLength = 0;
-		const enqueue = (chunk) => {
-			controller.enqueue(encoder.encode(chunk));
-		};
-		const emitSafeContent = (final = false) => {
-			const safeContent = safeDocsCloudContent(content, final);
-			if (safeContent.length <= emittedLength) return;
-			enqueue(createOpenAICompatibleSseChunk(safeContent.slice(emittedLength)));
-			emittedLength = safeContent.length;
-		};
-		const flushEvent = (event) => {
-			const data = event.split(/\r?\n/).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trim()).filter(Boolean).join("\n").trim();
-			if (!data) return;
-			if (data === "[DONE]") return;
-			try {
-				const parsed = JSON.parse(data);
-				const delta = openAICompatibleDeltaContent(parsed) ?? docsCloudStreamContent(parsed);
-				if (delta) {
-					content += delta;
-					emitSafeContent();
-				}
-			} catch {
-				content += data;
-				emitSafeContent();
-			}
-		};
-		try {
-			while (true) {
-				const { value, done } = await reader.read();
-				if (done) break;
-				buffer += decoder.decode(value, { stream: true });
-				const events = buffer.split(/\r?\n\r?\n/);
-				buffer = events.pop() ?? "";
-				for (const event of events) flushEvent(event);
-			}
-			buffer += decoder.decode();
-			if (buffer.trim()) flushEvent(buffer);
-		} catch {}
-		emitSafeContent(true);
-		enqueue("data: [DONE]\n\n");
-		controller.close();
-	} });
-	return new Response(stream, {
-		status: upstream.status,
-		statusText: upstream.statusText,
-		headers: {
-			"Content-Type": "text/event-stream",
-			"Cache-Control": upstream.headers.get("Cache-Control") ?? "no-cache, no-transform",
-			Connection: upstream.headers.get("Connection") ?? "keep-alive"
-		}
-	});
-}
-function analyticsProperties(request) {
-	const userAgent = request.headers.get("user-agent")?.trim();
-	return userAgent ? { userAgent } : {};
-}
-function isDocsCloudAskAIProvider(config) {
-	return config?.enabled === true && config.provider === "docs-cloud";
-}
-async function createDocsCloudAskAIResponse(request, options = {}) {
-	const config = options.config;
-	const aiConfig = config?.ai;
-	const analytics = config?.analytics;
-	const requestUrl = new URL(request.url);
-	const requestStartedAt = Date.now();
-	const requestProperties = analyticsProperties(request);
-	let body;
-	try {
-		body = await request.json();
-	} catch {
-		await emitDocsAnalyticsEvent(analytics, {
-			type: "api_ai_error",
-			source: "server",
-			url: request.url,
-			path: requestUrl.pathname,
-			locale: options.locale,
-			properties: {
-				...requestProperties,
-				reason: "invalid_json",
-				provider: "docs-cloud",
-				durationMs: Math.max(0, Date.now() - requestStartedAt)
-			}
-		});
-		return jsonError("Invalid JSON body. Expected { messages: [...] }.", 400);
-	}
-	const question = resolveQuestion(body);
-	const messages = Array.isArray(body.messages) ? body.messages : void 0;
-	if (!question) {
-		await emitDocsAnalyticsEvent(analytics, {
-			type: "api_ai_error",
-			source: "server",
-			url: request.url,
-			path: requestUrl.pathname,
-			locale: options.locale,
-			properties: {
-				...requestProperties,
-				reason: "missing_user_message",
-				provider: "docs-cloud",
-				durationMs: Math.max(0, Date.now() - requestStartedAt)
-			}
-		});
-		return jsonError("At least one user message is required.", 400);
-	}
-	const projectId = resolveDocsCloudProjectId(options.env);
-	const { envName, apiKey } = resolveDocsCloudApiKey(config?.cloud, options.env);
-	if (!projectId || !apiKey) {
-		const reason = !projectId ? "missing_docs_cloud_project_id" : "missing_docs_cloud_api_key";
-		await emitDocsAnalyticsEvent(analytics, {
-			type: "api_ai_error",
-			source: "server",
-			url: request.url,
-			path: requestUrl.pathname,
-			locale: options.locale,
-			input: { question },
-			properties: {
-				...requestProperties,
-				reason,
-				provider: "docs-cloud",
-				envName: !apiKey ? envName : void 0,
-				durationMs: Math.max(0, Date.now() - requestStartedAt)
-			}
-		});
-		return jsonError(!projectId ? `Docs Cloud Ask AI is missing ${DOCS_CLOUD_PROJECT_ID_ENVS.join(" or ")}. Add the project id to the deployment environment.` : `Docs Cloud Ask AI is missing ${envName}. Add it to the deployment environment.`, 500);
-	}
-	const stream = shouldStreamResponse(request, body, aiConfig);
-	const apiBaseUrl = resolveDocsCloudApiBaseUrl(options.env);
-	const publicBaseUrl = aiConfig?.docsUrl ?? options.publicBaseUrl ?? requestUrl.origin;
-	const requestedModel = typeof body.model === "string" && body.model.trim() ? body.model.trim() : void 0;
-	await emitDocsAnalyticsEvent(analytics, {
-		type: "api_ai_request",
-		source: "server",
-		url: request.url,
-		path: requestUrl.pathname,
-		locale: options.locale,
-		input: { question },
-		properties: {
-			...requestProperties,
-			provider: "docs-cloud",
-			messageCount: messages?.length,
-			questionLength: question.length,
-			model: requestedModel ?? "docs-cloud"
-		}
-	});
-	let upstream;
-	try {
-		upstream = await (options.fetch ?? fetch)(`${apiBaseUrl}/v1/projects/${encodeURIComponent(projectId)}/knowledge/ask`, {
-			method: "POST",
-			headers: {
-				Accept: stream ? "text/event-stream, application/json" : "application/json",
-				Authorization: `Bearer ${apiKey}`,
-				"Content-Type": "application/json",
-				"X-Docs-Cloud-Public-Base-Url": publicBaseUrl
-			},
-			body: JSON.stringify({
-				messages,
-				question,
-				answerMode: "auto",
-				answerStyle: "public",
-				modelPreference: requestedModel,
-				stream,
-				publicBaseUrl
-			})
-		});
-	} catch {
-		await emitDocsAnalyticsEvent(analytics, {
-			type: "api_ai_error",
-			source: "server",
-			url: request.url,
-			path: requestUrl.pathname,
-			locale: options.locale,
-			input: { question },
-			properties: {
-				...requestProperties,
-				reason: "docs_cloud_fetch_error",
-				provider: "docs-cloud",
-				durationMs: Math.max(0, Date.now() - requestStartedAt)
-			}
-		});
-		return jsonError("Docs Cloud Ask AI request failed.", 502);
-	}
-	if (!upstream.ok) {
-		await upstream.text().catch(() => "");
-		await emitDocsAnalyticsEvent(analytics, {
-			type: "api_ai_error",
-			source: "server",
-			url: request.url,
-			path: requestUrl.pathname,
-			locale: options.locale,
-			input: { question },
-			properties: {
-				...requestProperties,
-				reason: "docs_cloud_error",
-				provider: "docs-cloud",
-				status: upstream.status,
-				durationMs: Math.max(0, Date.now() - requestStartedAt)
-			}
-		});
-		return jsonError(`Docs Cloud Ask AI error (${upstream.status}).`, 502);
-	}
-	await emitDocsAnalyticsEvent(analytics, {
-		type: "api_ai_response",
-		source: "server",
-		url: request.url,
-		path: requestUrl.pathname,
-		locale: options.locale,
-		input: { question },
-		properties: {
-			...requestProperties,
-			provider: "docs-cloud",
-			status: upstream.status,
-			durationMs: Math.max(0, Date.now() - requestStartedAt)
-		}
-	});
-	const contentType = upstream.headers.get("Content-Type") ?? "";
-	if (stream && contentType.includes("text/event-stream")) return createCleanDocsCloudSseResponse(upstream);
-	const upstreamBody = await upstream.text();
-	let payload;
-	let answer = upstreamBody;
-	try {
-		payload = JSON.parse(upstreamBody);
-		answer = docsCloudAnswerFromPayload(payload) || answer;
-	} catch {}
-	const cleanAnswer = cleanDocsCloudAnswer(answer);
-	if (stream) return createOpenAICompatibleSseResponse(cleanAnswer);
-	return Response.json(isPlainObject(payload) ? {
-		...payload,
-		answer: cleanAnswer
-	} : { answer: cleanAnswer });
-}
-
-//#endregion
-export { isDocsCloudAskAIProvider as n, createDocsCloudAskAIResponse as t };