@farming-labs/svelte 0.1.102 → 0.1.103

package/dist/server.d.ts

@@ -12,7 +12,7 @@
  * import config from "./docs.config";
  *
  * // Bundle content at build time for serverless deployments
- * const contentFiles = import.meta.glob(["/docs/**\/*.{md,mdx,svx}", "/skill.md"], {
+ * const contentFiles = import.meta.glob(["/docs/**\/*.{md,mdx,svx}", "/AGENTS.md", "/skill.md"], {
  *   query: "?raw", import: "default", eager: true,
  * }) as Record<string, string>;
  *

package/dist/server.js

@@ -12,7 +12,7 @@
  * import config from "./docs.config";
  *
  * // Bundle content at build time for serverless deployments
- * const contentFiles = import.meta.glob(["/docs/**\/*.{md,mdx,svx}", "/skill.md"], {
+ * const contentFiles = import.meta.glob(["/docs/**\/*.{md,mdx,svx}", "/AGENTS.md", "/skill.md"], {
  *   query: "?raw", import: "default", eager: true,
  * }) as Record<string, string>;
  *
@@ -30,7 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-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 { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsSkillRequest, normalizeDocsRelated, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -137,6 +137,34 @@ function readRootSkillDocument(contentMap, rootDir) {
     }
     return null;
 }
+function readRootAgentsDocument(contentMap, rootDir) {
+    if (contentMap) {
+        for (const key of [
+            "/AGENTS.md",
+            "AGENTS.md",
+            "./AGENTS.md",
+            "/AGENT.md",
+            "AGENT.md",
+            "./AGENT.md",
+        ]) {
+            const raw = contentMap[key];
+            if (typeof raw === "string")
+                return raw;
+        }
+    }
+    for (const fileName of ["AGENTS.md", "AGENT.md"]) {
+        const candidate = path.join(rootDir, fileName);
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                return fs.readFileSync(candidate, "utf-8");
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
 function navTreeFromMap(contentMap, dirPrefix, entry, ordering) {
     const dirs = [];
     for (const key of Object.keys(contentMap)) {
@@ -707,6 +735,36 @@ 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,
+                    },
+                }), {
+                headers: {
+                    "Content-Type": "text/markdown; 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({

package/package.json

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