@farming-labs/svelte 0.2.58 → 0.2.59

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, buildDocsConfigMap, buildDocsDiagnostics, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsRequestApiRoute, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -45,6 +45,7 @@ function resolveApiReferenceOpenApiDiscovery(value) {
     return {
         enabled: true,
         url: "/api/docs?format=openapi",
+        urlSource: "default",
         source: apiReference.specUrl ? "configured" : "generated",
         specUrl: apiReference.specUrl,
         apiReferencePath: `/${apiReference.path}`,
@@ -639,6 +640,13 @@ export function createDocsServer(config = {}) {
     const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
     const llmsEnabled = llmsTxtConfig !== false &&
         !(llmsTxtConfig && typeof llmsTxtConfig === "object" && llmsTxtConfig.enabled === false);
+    const apiCatalogEnabled = typeof llmsTxtConfig !== "object" || llmsTxtConfig.apiCatalog !== false;
+    const configuredApiRoute = typeof config.cloud?.apiRoute === "string" && config.cloud.apiRoute.trim()
+        ? config.cloud.apiRoute
+        : undefined;
+    const discoveryLinkHeader = getDocsDiscoveryLinkHeader({
+        includeApiCatalog: apiCatalogEnabled,
+    });
     const openapiDiscovery = resolveApiReferenceOpenApiDiscovery(config.apiReference);
     const mcpConfig = resolveDocsMcpConfig(config.mcp, {
         defaultName: llmsTitle,
@@ -668,20 +676,21 @@ export function createDocsServer(config = {}) {
             surface,
         });
     }
-    function getLlmsContent(ctx) {
-        const key = ctx.locale ?? "__default__";
-        const cached = llmsCache.get(key);
-        if (cached)
-            return cached;
+    function getLlmsContent(ctx, apiRoute) {
+        const cached = llmsCache.get(ctx.locale);
+        if (cached?.apiRoute === apiRoute)
+            return cached.content;
         const next = renderDocsLlmsTxt(getSearchIndex(ctx), {
             siteTitle: llmsTitle,
             siteDescription: llmsDesc,
             baseUrl: llmsBaseUrl,
+            apiRoute,
             maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
             sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
             openapi: openapiDiscovery,
+            apiCatalog: apiCatalogEnabled,
         });
-        llmsCache.set(key, next);
+        llmsCache.set(ctx.locale, { apiRoute, content: next });
         return next;
     }
     function resolveLocaleForMcp(locale) {
@@ -704,6 +713,7 @@ export function createDocsServer(config = {}) {
     async function GET(event) {
         trackTelemetryRequest(event.request);
         const ctx = resolveContextFromRequest(event.request);
+        const requestApiRoute = resolveDocsRequestApiRoute(event.url, configuredApiRoute);
         if (isDocsConfigRequest(event.url)) {
             return new Response(JSON.stringify(buildDocsConfigMap(config), null, 2), {
                 headers: {
@@ -717,6 +727,7 @@ export function createDocsServer(config = {}) {
             return new Response(JSON.stringify(buildDocsDiagnostics(config, {
                 adapter: "sveltekit",
                 entry,
+                apiRoute: requestApiRoute,
                 i18n,
                 mcp: mcpConfig,
                 feedback: agentFeedbackDiscovery,
@@ -729,33 +740,50 @@ export function createDocsServer(config = {}) {
                 },
             });
         }
-        if (isDocsAgentDiscoveryRequest(event.url)) {
-            return new Response(JSON.stringify(buildDocsAgentDiscoverySpec({
-                origin: event.url.origin,
-                entry,
-                i18n,
-                search: config.search,
-                mcp: mcpConfig,
-                feedback: agentFeedbackDiscovery,
-                llms: {
-                    enabled: llmsEnabled,
-                    baseUrl: llmsBaseUrl || undefined,
-                    siteTitle: llmsTitle,
-                    siteDescription: llmsDesc,
-                    maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
-                    sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
-                },
-                sitemap: config.sitemap,
-                robots: config.robots,
-                openapi: openapiDiscovery,
-                markdown: {
-                    acceptHeader: false,
-                },
-            }), null, 2), {
+        const discoveryApiRoute = requestApiRoute;
+        const discoveryOptions = {
+            origin: event.url.origin,
+            entry,
+            apiRoute: discoveryApiRoute,
+            docsPath: config.docsPath,
+            apiCatalog: apiCatalogEnabled,
+            i18n,
+            search: config.search,
+            mcp: mcpConfig,
+            feedback: agentFeedbackDiscovery,
+            llms: {
+                enabled: llmsEnabled,
+                apiCatalog: apiCatalogEnabled,
+                baseUrl: llmsBaseUrl || undefined,
+                siteTitle: llmsTitle,
+                siteDescription: llmsDesc,
+                maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
+                sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
+            },
+            sitemap: config.sitemap,
+            robots: config.robots,
+            openapi: openapiDiscovery,
+            markdown: {
+                acceptHeader: false,
+            },
+        };
+        if (isDocsStandardsDiscoveryRequest(event.url, { apiRoute: discoveryApiRoute })) {
+            const standardsDiscoveryResponse = await createDocsStandardsDiscoveryResponse({
+                request: event.request,
+                ...discoveryOptions,
+                preferredSkillDocument: readRootSkillDocument(preloaded, rootDir),
+                fallbackSkillDocument: renderDocsSkillDocument(discoveryOptions),
+            });
+            if (standardsDiscoveryResponse)
+                return standardsDiscoveryResponse;
+        }
+        if (isDocsAgentDiscoveryRequest(event.url, { apiRoute: discoveryApiRoute })) {
+            return new Response(JSON.stringify(buildDocsAgentDiscoverySpec(discoveryOptions), null, 2), {
                 headers: {
                     "Content-Type": "application/json; charset=utf-8",
                     "Cache-Control": "public, max-age=0, s-maxage=3600",
                     "X-Robots-Tag": "noindex",
+                    Link: discoveryLinkHeader,
                 },
             });
         }
@@ -801,68 +829,31 @@ export function createDocsServer(config = {}) {
                 },
             });
         }
-        if (isDocsAgentsRequest(event.url) || resolveDocsAgentsFormat(event.url) === "agents") {
-            return new Response(readRootAgentsDocument(preloaded, rootDir) ??
-                renderDocsAgentsDocument({
-                    origin: event.url.origin,
-                    entry,
-                    search: config.search,
-                    mcp: mcpConfig,
-                    feedback: agentFeedbackDiscovery,
-                    llms: {
-                        enabled: llmsEnabled,
-                        baseUrl: llmsBaseUrl || undefined,
-                        siteTitle: llmsTitle,
-                        siteDescription: llmsDesc,
-                        maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
-                        sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
-                    },
-                    sitemap: config.sitemap,
-                    robots: config.robots,
-                    openapi: openapiDiscovery,
-                    markdown: {
-                        acceptHeader: false,
-                    },
-                }), {
+        if (isDocsAgentsRequest(event.url, { apiRoute: discoveryApiRoute }) ||
+            resolveDocsAgentsFormat(event.url) === "agents") {
+            return new Response(readRootAgentsDocument(preloaded, rootDir) ?? renderDocsAgentsDocument(discoveryOptions), {
                 headers: {
                     "Content-Type": "text/markdown; charset=utf-8",
                     "Cache-Control": "public, max-age=0, s-maxage=3600",
                     "X-Robots-Tag": "noindex",
+                    Link: discoveryLinkHeader,
                 },
             });
         }
-        if (isDocsSkillRequest(event.url) || resolveDocsSkillFormat(event.url) === "skill") {
-            return new Response(readRootSkillDocument(preloaded, rootDir) ??
-                renderDocsSkillDocument({
-                    origin: event.url.origin,
-                    entry,
-                    search: config.search,
-                    mcp: mcpConfig,
-                    feedback: agentFeedbackDiscovery,
-                    llms: {
-                        enabled: llmsEnabled,
-                        baseUrl: llmsBaseUrl || undefined,
-                        siteTitle: llmsTitle,
-                        siteDescription: llmsDesc,
-                        maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
-                        sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
-                    },
-                    sitemap: config.sitemap,
-                    robots: config.robots,
-                    openapi: openapiDiscovery,
-                    markdown: {
-                        acceptHeader: false,
-                    },
-                }), {
+        if (isDocsSkillRequest(event.url, { apiRoute: discoveryApiRoute }) ||
+            resolveDocsSkillFormat(event.url) === "skill") {
+            return new Response(readRootSkillDocument(preloaded, rootDir) ?? renderDocsSkillDocument(discoveryOptions), {
                 headers: {
                     "Content-Type": "text/markdown; charset=utf-8",
                     "Cache-Control": "public, max-age=0, s-maxage=3600",
                     "X-Robots-Tag": "noindex",
+                    Link: discoveryLinkHeader,
                 },
             });
         }
         const sitemapResponse = createDocsSitemapResponse({
             request: event.request,
+            apiRoute: discoveryApiRoute,
             sitemap: config.sitemap,
             entry,
             siteTitle: llmsTitle,
@@ -875,18 +866,22 @@ export function createDocsServer(config = {}) {
         const robotsResponse = createDocsRobotsResponse({
             request: event.request,
             entry,
+            apiCatalog: apiCatalogEnabled,
             sitemap: config.sitemap,
             baseUrl: llmsBaseUrl || event.url.origin,
             robots: config.robots,
         });
         if (robotsResponse)
             return robotsResponse;
-        const markdownRequest = resolveDocsMarkdownRequest(entry, event.url, event.request);
+        const markdownRequest = resolveDocsMarkdownRequest(entry, event.url, event.request, {
+            apiRoute: discoveryApiRoute,
+        });
         if (markdownRequest) {
             const markdownOrigin = markdownMetadataBaseUrl || event.url.origin;
             const representation = getMarkdownRepresentation(ctx, markdownRequest.requestedPath, markdownOrigin);
             return createDocsMarkdownResponse({
                 request: event.request,
+                apiRoute: discoveryApiRoute,
                 document: representation?.document ?? null,
                 entry,
                 requestedPath: markdownRequest.requestedPath,
@@ -897,7 +892,9 @@ export function createDocsServer(config = {}) {
                 sitemap: config.sitemap,
             });
         }
-        const llmsRequest = resolveDocsLlmsTxtRequest(event.url, llmsTxtConfig, entry);
+        const llmsRequest = resolveDocsLlmsTxtRequest(event.url, llmsTxtConfig, entry, {
+            apiRoute: discoveryApiRoute,
+        });
         if (llmsRequest) {
             if (!llmsEnabled) {
                 return new Response("Not Found", {
@@ -908,7 +905,7 @@ export function createDocsServer(config = {}) {
                     },
                 });
             }
-            const selected = selectDocsLlmsTxtContent(getLlmsContent(ctx), llmsRequest);
+            const selected = selectDocsLlmsTxtContent(getLlmsContent(ctx, requestApiRoute), llmsRequest);
             if (!selected) {
                 return new Response("Not Found", {
                     status: 404,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.2.58",
+  "version": "0.2.59",
   "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.2.58"
+    "@farming-labs/docs": "0.2.59"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"