@farming-labs/svelte 0.1.95 → 0.1.97

package/dist/server.js

@@ -30,7 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsLlmsTxt, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsLlmsTxt, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, readDocsSitemapManifest, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -582,6 +582,12 @@ export function createDocsServer(config = {}) {
     const mcpConfig = resolveDocsMcpConfig(config.mcp, {
         defaultName: llmsTitle,
     });
+    const agentFeedbackConfig = resolveDocsAgentFeedbackConfig(config.feedback);
+    const agentFeedbackDiscovery = {
+        enabled: agentFeedbackConfig.enabled,
+        route: "/api/docs?feedback=agent",
+        schemaRoute: "/api/docs?feedback=agent&schema=1",
+    };
     const llmsCache = new Map();
     function getLlmsContent(ctx) {
         const key = ctx.locale ?? "__default__";
@@ -619,6 +625,7 @@ export function createDocsServer(config = {}) {
                 i18n,
                 search: config.search,
                 mcp: mcpConfig,
+                feedback: agentFeedbackDiscovery,
                 llms: {
                     enabled: llmsEnabled,
                     baseUrl: llmsBaseUrl || undefined,
@@ -640,6 +647,25 @@ export function createDocsServer(config = {}) {
                 },
             });
         }
+        const agentFeedbackRequest = resolveDocsAgentFeedbackRequest(event.url, agentFeedbackConfig);
+        if (agentFeedbackRequest) {
+            if (agentFeedbackRequest.kind === "submit") {
+                return new Response(JSON.stringify({ error: "Method Not Allowed" }), {
+                    status: 405,
+                    headers: {
+                        Allow: "POST",
+                        "Content-Type": "application/json; charset=utf-8",
+                    },
+                });
+            }
+            return new Response(JSON.stringify(agentFeedbackConfig.schema, null, 2), {
+                headers: {
+                    "Content-Type": "application/schema+json; charset=utf-8",
+                    "Cache-Control": "public, max-age=0, s-maxage=3600",
+                    "X-Robots-Tag": "noindex",
+                },
+            });
+        }
         if (isDocsSkillRequest(event.url) || resolveDocsSkillFormat(event.url) === "skill") {
             return new Response(readRootSkillDocument(preloaded, rootDir) ??
                 renderDocsSkillDocument({
@@ -647,6 +673,7 @@ export function createDocsServer(config = {}) {
                     entry,
                     search: config.search,
                     mcp: mcpConfig,
+                    feedback: agentFeedbackDiscovery,
                     llms: {
                         enabled: llmsEnabled,
                         baseUrl: llmsBaseUrl || undefined,
@@ -679,6 +706,15 @@ export function createDocsServer(config = {}) {
         });
         if (sitemapResponse)
             return sitemapResponse;
+        const robotsResponse = createDocsRobotsResponse({
+            request: event.request,
+            entry,
+            sitemap: config.sitemap,
+            baseUrl: llmsBaseUrl || event.url.origin,
+            robots: config.robots,
+        });
+        if (robotsResponse)
+            return robotsResponse;
         const markdownRequest = resolveDocsMarkdownRequest(entry, event.url, event.request);
         if (markdownRequest) {
             const document = getMarkdownDocument(ctx, markdownRequest.requestedPath);
@@ -815,6 +851,29 @@ export function createDocsServer(config = {}) {
     const DEFAULT_SYSTEM_PROMPT = buildDefaultSystemPrompt();
     async function POST(event) {
         const requestUrl = new URL(event.request.url);
+        const agentFeedbackRequest = resolveDocsAgentFeedbackRequest(requestUrl, agentFeedbackConfig);
+        if (agentFeedbackRequest) {
+            if (agentFeedbackRequest.kind === "schema") {
+                return new Response(JSON.stringify({ error: "Method Not Allowed" }), {
+                    status: 405,
+                    headers: {
+                        Allow: "GET",
+                        "Content-Type": "application/json; charset=utf-8",
+                    },
+                });
+            }
+            const parsed = await parseDocsAgentFeedbackData(event.request);
+            if (!parsed.ok)
+                return parsed.response;
+            const payloadError = validateDocsAgentFeedbackPayload(parsed.data.payload, agentFeedbackConfig.payloadSchema);
+            if (payloadError)
+                return Response.json({ error: payloadError }, { status: 400 });
+            if (!agentFeedbackConfig.onFeedback) {
+                return Response.json({ ok: true, handled: false }, { status: 202 });
+            }
+            await agentFeedbackConfig.onFeedback(parsed.data);
+            return Response.json({ ok: true, handled: true }, { status: 201 });
+        }
         const requestStartedAt = Date.now();
         const trace = createDocsAgentTraceContext("ask-ai");
         const runSpanId = createDocsAgentTraceId("span");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
   "keywords": [
     "docs",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.1.95"
+    "@farming-labs/docs": "0.1.97"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"