@farming-labs/theme 0.1.137 → 0.1.138

package/dist/docs-api.mjs

@@ -1301,8 +1301,13 @@ function safeUrlOrigin(value) {
 		return value;
 	}
 }
+function getRequestAnalyticsProperties(request) {
+	const userAgent = request.headers.get("user-agent")?.trim();
+	return userAgent ? { userAgent } : {};
+}
 async function handleAskAI(request, indexes, aiConfig, search, analytics, observability, analyticsContext = {}) {
 	const url = new URL(request.url);
+	const requestAnalyticsProperties = getRequestAnalyticsProperties(request);
 	const requestStartedAt = Date.now();
 	const trace = createDocsAgentTraceContext("ask-ai");
 	const runSpanId = createDocsAgentTraceId("span");
@@ -1373,6 +1378,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			path: url.pathname,
 			locale: analyticsContext.locale,
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "invalid_json",
 				durationMs: Math.max(0, Date.now() - requestStartedAt)
 			}
@@ -1389,6 +1395,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			path: url.pathname,
 			locale: analyticsContext.locale,
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "missing_messages",
 				durationMs: Math.max(0, Date.now() - requestStartedAt)
 			}
@@ -1405,6 +1412,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			path: url.pathname,
 			locale: analyticsContext.locale,
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "missing_user_message",
 				messageCount: messages.length,
 				durationMs: Math.max(0, Date.now() - requestStartedAt)
@@ -1515,6 +1523,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			locale: analyticsContext.locale,
 			input: { question: query },
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "missing_api_key",
 				messageCount: messages.length,
 				questionLength: query.length,
@@ -1540,6 +1549,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 		locale: analyticsContext.locale,
 		input: { question: query },
 		properties: {
+			...requestAnalyticsProperties,
 			messageCount: messages.length,
 			questionLength: query.length,
 			retrievedCount: scored.length,
@@ -1603,6 +1613,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			locale: analyticsContext.locale,
 			input: { question: query },
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "llm_fetch_error",
 				messageCount: messages.length,
 				questionLength: query.length,
@@ -1648,6 +1659,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 			locale: analyticsContext.locale,
 			input: { question: query },
 			properties: {
+				...requestAnalyticsProperties,
 				reason: "llm_error",
 				status: llmResponse.status,
 				messageCount: messages.length,
@@ -1675,6 +1687,7 @@ async function handleAskAI(request, indexes, aiConfig, search, analytics, observ
 		locale: analyticsContext.locale,
 		input: { question: query },
 		properties: {
+			...requestAnalyticsProperties,
 			messageCount: messages.length,
 			questionLength: query.length,
 			retrievedCount: scored.length,
@@ -2074,6 +2087,7 @@ function createDocsAPI(options) {
 		async GET(request) {
 			const ctx = resolveContextFromRequest(request);
 			const url = new URL(request.url);
+			const requestAnalyticsProperties = getRequestAnalyticsProperties(request);
 			if (resolveAgentSpecRequest(url)) {
 				await emitDocsAnalyticsEvent(analytics, {
 					type: "agent_spec_request",
@@ -2081,7 +2095,10 @@ function createDocsAPI(options) {
 					url: request.url,
 					path: url.pathname,
 					locale: ctx.locale,
-					properties: { method: "GET" }
+					properties: {
+						...requestAnalyticsProperties,
+						method: "GET"
+					}
 				});
 				return Response.json(buildAgentSpec({
 					origin: url.origin,
@@ -2130,7 +2147,10 @@ function createDocsAPI(options) {
 					url: request.url,
 					path: url.pathname,
 					locale: ctx.locale,
-					properties: { method: "GET" }
+					properties: {
+						...requestAnalyticsProperties,
+						method: "GET"
+					}
 				});
 				return new Response(JSON.stringify(agentFeedbackConfig.schema, null, 2), { headers: {
 					"Content-Type": "application/schema+json; charset=utf-8",
@@ -2145,7 +2165,10 @@ function createDocsAPI(options) {
 					url: request.url,
 					path: url.pathname,
 					locale: ctx.locale,
-					properties: { method: "GET" }
+					properties: {
+						...requestAnalyticsProperties,
+						method: "GET"
+					}
 				});
 				return new Response(readRootAgentsDocument(root) ?? renderAgentsDocument({
 					origin: url.origin,
@@ -2170,7 +2193,10 @@ function createDocsAPI(options) {
 					url: request.url,
 					path: url.pathname,
 					locale: ctx.locale,
-					properties: { method: "GET" }
+					properties: {
+						...requestAnalyticsProperties,
+						method: "GET"
+					}
 				});
 				return new Response(readRootSkillDocument(root) ?? renderSkillDocument({
 					origin: url.origin,
@@ -2232,6 +2258,7 @@ function createDocsAPI(options) {
 						path: url.pathname,
 						locale: ctx.locale,
 						properties: {
+							...requestAnalyticsProperties,
 							requestedPath: markdownRequest.requestedPath,
 							delivery: markdownRequest.delivery,
 							found: false
@@ -2244,6 +2271,7 @@ function createDocsAPI(options) {
 						path: url.pathname,
 						locale: ctx.locale,
 						properties: {
+							...requestAnalyticsProperties,
 							requestedPath: markdownRequest.requestedPath,
 							delivery: markdownRequest.delivery,
 							found: false
@@ -2279,6 +2307,7 @@ function createDocsAPI(options) {
 					path: url.pathname,
 					locale: ctx.locale,
 					properties: {
+						...requestAnalyticsProperties,
 						requestedPath: markdownRequest.requestedPath,
 						delivery: markdownRequest.delivery,
 						found: true,
@@ -2292,6 +2321,7 @@ function createDocsAPI(options) {
 					path: url.pathname,
 					locale: ctx.locale,
 					properties: {
+						...requestAnalyticsProperties,
 						requestedPath: markdownRequest.requestedPath,
 						delivery: markdownRequest.delivery,
 						found: true,
@@ -2339,6 +2369,7 @@ function createDocsAPI(options) {
 					path: url.pathname,
 					locale: ctx.locale,
 					properties: {
+						...requestAnalyticsProperties,
 						format: llmsRequest.format,
 						section: llmsRequest.section?.route,
 						contentLength: selected.content.length
@@ -2368,6 +2399,7 @@ function createDocsAPI(options) {
 				locale: ctx.locale,
 				input: { query },
 				properties: {
+					...requestAnalyticsProperties,
 					queryLength: query.length,
 					resultCount: results.length,
 					pathname: url.searchParams.get("pathname") ?? void 0,
@@ -2378,6 +2410,7 @@ function createDocsAPI(options) {
 		},
 		async POST(request) {
 			const url = new URL(request.url);
+			const requestAnalyticsProperties = getRequestAnalyticsProperties(request);
 			const agentFeedbackRequest = resolveAgentFeedbackRequest(url, agentFeedbackConfig);
 			if (agentFeedbackRequest) {
 				if (agentFeedbackRequest.kind === "schema") return Response.json({ error: "Method Not Allowed" }, {
@@ -2391,7 +2424,10 @@ function createDocsAPI(options) {
 						source: "server",
 						url: request.url,
 						path: url.pathname,
-						properties: { reason: "invalid_body" }
+						properties: {
+							...requestAnalyticsProperties,
+							reason: "invalid_body"
+						}
 					});
 					return parsed.response;
 				}
@@ -2403,6 +2439,7 @@ function createDocsAPI(options) {
 						url: request.url,
 						path: url.pathname,
 						properties: {
+							...requestAnalyticsProperties,
 							reason: "invalid_payload",
 							error: payloadError
 						}
@@ -2416,6 +2453,7 @@ function createDocsAPI(options) {
 						url: request.url,
 						path: url.pathname,
 						properties: {
+							...requestAnalyticsProperties,
 							handled: false,
 							payloadKeys: Object.keys(parsed.data.payload),
 							hasContext: Boolean(parsed.data.context)
@@ -2433,6 +2471,7 @@ function createDocsAPI(options) {
 					url: request.url,
 					path: url.pathname,
 					properties: {
+						...requestAnalyticsProperties,
 						handled: true,
 						payloadKeys: Object.keys(parsed.data.payload),
 						hasContext: Boolean(parsed.data.context)
@@ -2449,7 +2488,10 @@ function createDocsAPI(options) {
 					source: "server",
 					url: request.url,
 					path: url.pathname,
-					properties: { reason: "disabled" }
+					properties: {
+						...requestAnalyticsProperties,
+						reason: "disabled"
+					}
 				});
 				return Response.json({ error: "AI is not enabled. Set `ai: { enabled: true }` in your docs.config to enable it." }, { status: 404 });
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.137",
+  "version": "0.1.138",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -139,7 +139,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.137"
+    "@farming-labs/docs": "0.1.138"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",