@farming-labs/farmjs 0.2.119 → 0.2.121

package/dist/mdx-core.js

@@ -0,0 +1,23 @@
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+let compilerEntry;
+try {
+    compilerEntry = import.meta.resolve("@farming-labs/docs/mdx");
+}
+catch (error) {
+    // Fall back only when the older core lacks this export. A broken compiler
+    // must still report its error instead of silently loading another module.
+    if (error.code !== "ERR_PACKAGE_PATH_NOT_EXPORTED")
+        throw error;
+}
+// Farm requires Node >=22.13, which supports synchronous ESM loading. Avoid
+// top-level await so existing CommonJS configs can still require the adapter.
+const require = createRequire(import.meta.url);
+const helpers = compilerEntry
+    ? require(fileURLToPath(compilerEntry))
+    : {
+        ...require(fileURLToPath(import.meta.resolve("@farming-labs/docs"))),
+        ...require(fileURLToPath(import.meta.resolve("@farming-labs/docs/server"))),
+    };
+export const { applyDocsMarkdownHeadingAnchors, encodeDocsHeadingTocUrls, isolateDocsMarkdownPromptReferences, remarkCodeGroup, withDocsMarkdownRenderableHeadings, } = helpers;
+//# sourceMappingURL=mdx-core.js.map

package/dist/mdx-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-core.js","sourceRoot":"","sources":["../src/mdx-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAczC,IAAI,aAAiC,CAAC;AACtC,IAAI,CAAC;IACH,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAChE,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAK,KAA+B,CAAC,IAAI,KAAK,+BAA+B;QAAE,MAAM,KAAK,CAAC;AAC7F,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,OAAO,GAAY,aAAa;IACpC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC,CAAC;QACE,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACpE,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC;KAC5E,CAAC;AAEN,MAAM,CAAC,MAAM,EACX,+BAA+B,EAC/B,wBAAwB,EACxB,mCAAmC,EACnC,eAAe,EACf,kCAAkC,GACnC,GAAG,OAAO,CAAC"}

package/dist/react.d.ts

@@ -16,6 +16,8 @@ export declare function FarmDocsPage({ config, data, navigation, }: {
 export declare function hydrateFarmDocs(input: {
     config: DocsConfig;
     data: DocsServerLoadResult;
+    /** The docs config module, when the server flagged values its JSON copy dropped. */
+    configModule?: unknown;
     container?: Element | null;
 }): Promise<Root>;
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAgBxD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;AAED,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,IAAI,EACJ,UAAU,GACX,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC,2CAUA;AAgHD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAkBxD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;AAED,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,IAAI,EACJ,UAAU,GACX,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC,2CAYA;AAgHD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB"}

package/dist/react.js

@@ -2,6 +2,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { startTransition, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { hydrateRoot } from "react-dom/client";
 import { createFarmDocsNavigator, } from "./navigation.js";
+import { restoreUnserializableValues } from "./config-values.js";
+import FarmDocsShell from "@farming-labs/farmjs/shell";
 import { FarmDocsPageRenderer } from "./page.js";
 import { createFarmDocsPageModules } from "./page-modules.js";
 // One chunk per Markdown page, loaded only for the page being shown. An eager
@@ -18,7 +20,7 @@ export function loadFarmDocsPageModule(data) {
 }
 export function FarmDocsPage({ config, data, navigation, }) {
     const module = pageModules.get(data);
-    return (_jsx(FarmDocsPageRenderer, { config: config, data: data, Content: module?.default, navigation: navigation }));
+    return (_jsx(FarmDocsShell, { children: _jsx(FarmDocsPageRenderer, { config: config, data: data, Content: module?.default, navigation: navigation }) }));
 }
 function scrollToNavigationTarget(url) {
     if (!url.hash) {
@@ -115,6 +117,9 @@ export async function hydrateFarmDocs(input) {
     }
     // Hydrate with the page's Markdown in hand, so the first render matches the server's.
     await loadFarmDocsPageModule(input.data);
-    return hydrateRoot(container, _jsx(FarmDocsClient, { config: input.config, data: input.data }));
+    const config = input.configModule
+        ? restoreUnserializableValues(input.config, input.configModule)
+        : input.config;
+    return hydrateRoot(container, _jsx(FarmDocsClient, { config: config, data: input.data }));
 }
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AA8E7E,OAAO,KAAK,EAAgD,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAanG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,eAAe,EAMhB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAiC,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAqH9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACzC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtF,GAAG,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,GAAG,EAAE,mBAAmB,CAAC;IACzB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACxD;AAED,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD;AAED,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,YAAY,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;IAChF,oFAAoF;IACpF,sBAAsB,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,6BAA6B;IAC5C,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CACnB,QAAQ,EAAE,MAAM,KACb,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAClF,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtD;AAuhBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,UAAU,CAsnDxE;AA8LD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxC,OAAO,GAAE,6BAAkC,IAQQ,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8F/F"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -6,13 +6,34 @@ import { createElement } from "react";
 import * as ReactDOMServer from "react-dom/server";
 import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsSearchFacets, buildDocsAgentDiscoverySpec, compactDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsCacheableResponse, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, formatDocsLastModifiedDate, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsContentChangesRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, normalizeDocsOkfTrustMetadataInput, parseDocsAgentFeedbackData, performDocsSearch, performDocsSearchWithMetadata, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsContentChangesConfig, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsPublishedAgentSkill, resolveDocsStandardsDiscoveryRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, withDocsOpenApiOperationCounts, } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, buildApiReferenceOperationPagesAsync, createApiReferenceOperationMarkdownResponse, createDocsMcpHttpHandler, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveDocsMcpConfig, resolveConfiguredAgentSkills, } from "@farming-labs/docs/server";
+import { bundledAgentSkills, bundledRootDocuments } from "@farming-labs/docs/agent-skills-bundle";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree, normalizeDocsFrontmatterLastmod, readFarmDocsLastModifiedManifest, resolveFarmDocsLastModified, } from "./content.js";
 import farmDocsBrowserCss from "./browser-css.generated.js";
+import { hasUnserializableValues } from "./config-values.js";
 import { FARM_DOCS_NAVIGATION_HEADER } from "./runtime.js";
 export { createFarmjsApiReference } from "./api-reference.js";
 const FARM_DOCS_BROWSER_CSS_PATH = "/__farm_docs/browser.css";
+const FARM_DOCS_BROWSER_CSS_LAYER = "farm-docs-adapter";
+/**
+ * The theme's precompiled browser CSS carries Tailwind's preflight and utilities outside any
+ * cascade layer, and unlayered rules beat every layered one. Served as is, `.border` from it
+ * overrode a host app's own `border-l-4` in `@layer utilities`. Inside a layer declared before
+ * the host's stylesheets, it stays the lowest-priority default the host overrides, as it does
+ * when the host compiles the theme itself. `@property` rules stay top-level: they register custom
+ * properties and do not take part in the cascade.
+ */
+function layerFarmDocsBrowserCss(css) {
+    const properties = [];
+    const rules = css.replace(/@property\s+[^{]+\{[^}]*\}\s*/g, (rule) => {
+        properties.push(rule.trim());
+        return "";
+    });
+    return `${properties.join("\n")}\n@layer ${FARM_DOCS_BROWSER_CSS_LAYER} {\n${rules}\n}\n`;
+}
+let layeredFarmDocsBrowserCss;
 function loadFarmDocsBrowserCss() {
-    return farmDocsBrowserCss;
+    layeredFarmDocsBrowserCss ??= layerFarmDocsBrowserCss(farmDocsBrowserCss);
+    return layeredFarmDocsBrowserCss;
 }
 async function renderFarmDocsMarkup(element) {
     const server = ReactDOMServer;
@@ -470,7 +491,7 @@ function findPageInMap(contentMap, dirPrefix, slug) {
     }
     return null;
 }
-function readRootSkillDocument(contentMap, rootDir) {
+function readRootSkillDocument(contentMap, rootDir, rootDocuments) {
     if (contentMap) {
         for (const key of ["/skill.md", "skill.md", "./skill.md"]) {
             const raw = contentMap[key];
@@ -478,6 +499,8 @@ function readRootSkillDocument(contentMap, rootDir) {
                 return raw;
         }
     }
+    if (typeof rootDocuments?.["skill.md"] === "string")
+        return rootDocuments["skill.md"];
     const candidate = path.join(rootDir, "skill.md");
     try {
         if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
@@ -489,7 +512,7 @@ function readRootSkillDocument(contentMap, rootDir) {
     }
     return null;
 }
-function readRootAgentsDocument(contentMap, rootDir) {
+function readRootAgentsDocument(contentMap, rootDir, rootDocuments) {
     if (contentMap) {
         for (const key of [
             "/AGENTS.md",
@@ -504,6 +527,10 @@ function readRootAgentsDocument(contentMap, rootDir) {
                 return raw;
         }
     }
+    for (const fileName of ["AGENTS.md", "AGENT.md"]) {
+        if (typeof rootDocuments?.[fileName] === "string")
+            return rootDocuments[fileName];
+    }
     for (const fileName of ["AGENTS.md", "AGENT.md"]) {
         const candidate = path.join(rootDir, fileName);
         try {
@@ -524,10 +551,14 @@ export function createDocsServer(config) {
     const ordering = config.ordering;
     const contentDirBase = config.contentDir ?? entry;
     const rootDir = path.resolve(config.rootDir ?? process.cwd());
+    // Production builds snapshot the configured skills and root agent documents into these
+    // (agent-skills.ts), because a deployed function does not contain the project's files.
+    const preloadedAgentSkills = config._preloadedAgentSkills ?? bundledAgentSkills;
+    const rootAgentDocuments = config._preloadedRootDocuments ?? bundledRootDocuments;
     let publishedAgentSkills;
     function getPublishedAgentSkills() {
-        publishedAgentSkills ??= Array.isArray(config._preloadedAgentSkills)
-            ? Promise.resolve(config._preloadedAgentSkills)
+        publishedAgentSkills ??= Array.isArray(preloadedAgentSkills)
+            ? Promise.resolve(preloadedAgentSkills)
             : resolveConfiguredAgentSkills(config.agent?.skills, { rootDir });
         return publishedAgentSkills;
     }
@@ -897,7 +928,9 @@ export function createDocsServer(config) {
         return createDocsStandardsDiscoveryResponse({
             request,
             ...discoveryOptions,
-            preferredSkillDocument: needsSkill ? readRootSkillDocument(preloaded, rootDir) : null,
+            preferredSkillDocument: needsSkill
+                ? readRootSkillDocument(preloaded, rootDir, rootAgentDocuments)
+                : null,
             fallbackSkillDocument: needsSkill ? renderDocsSkillDocument(discoveryOptions) : "",
             publishedSkills: needsSkill ? await getPublishedAgentSkills() : [],
             agentCard: config.agent?.a2a,
@@ -955,7 +988,7 @@ export function createDocsServer(config) {
                 ...discoveryOptions,
                 publishedSkills: [
                     await resolveDocsPublishedAgentSkill({
-                        preferredDocument: readRootSkillDocument(preloaded, rootDir),
+                        preferredDocument: readRootSkillDocument(preloaded, rootDir, rootAgentDocuments),
                         fallbackDocument: renderDocsSkillDocument(discoveryOptions),
                     }),
                     ...(await getPublishedAgentSkills()),
@@ -1046,7 +1079,8 @@ export function createDocsServer(config) {
         }
         if (isDocsAgentsRequest(url, { apiRoute: discoveryApiRoute }) ||
             resolveDocsAgentsFormat(url) === "agents") {
-            const content = readRootAgentsDocument(preloaded, rootDir) ?? renderDocsAgentsDocument(discoveryOptions);
+            const content = readRootAgentsDocument(preloaded, rootDir, rootAgentDocuments) ??
+                renderDocsAgentsDocument(discoveryOptions);
             return createDocsCacheableResponse({
                 request: event.request,
                 content,
@@ -1060,7 +1094,8 @@ export function createDocsServer(config) {
         }
         if (isDocsSkillRequest(url, { apiRoute: discoveryApiRoute }) ||
             resolveDocsSkillFormat(url) === "skill") {
-            const content = readRootSkillDocument(preloaded, rootDir) ?? renderDocsSkillDocument(discoveryOptions);
+            const content = readRootSkillDocument(preloaded, rootDir, rootAgentDocuments) ??
+                renderDocsSkillDocument(discoveryOptions);
             return createDocsCacheableResponse({
                 request: event.request,
                 content,
@@ -1826,7 +1861,7 @@ export function createDocsServer(config) {
                     openapi: openapiDiscovery,
                 };
                 const rootSkill = await resolveDocsPublishedAgentSkill({
-                    preferredDocument: readRootSkillDocument(preloaded, rootDir),
+                    preferredDocument: readRootSkillDocument(preloaded, rootDir, rootAgentDocuments),
                     fallbackDocument: renderDocsSkillDocument(skillOptions),
                 });
                 return [rootSkill, ...(await getPublishedAgentSkills())];
@@ -1885,6 +1920,8 @@ export function createDocsServer(config) {
             ? config.apiReference.path
             : "api-reference";
         const apiReferencePath = `/${configuredApiReferencePath.replace(/^\/+|\/+$/g, "")}`;
+        // Unconfigured, the path belongs to the app, as with the other framework integrations.
+        const apiReferenceEnabled = resolveApiReferenceConfig(config.apiReference).enabled;
         const publicDocsPaths = new Set([
             "/llms.txt",
             "/llms-full.txt",
@@ -1909,8 +1946,8 @@ export function createDocsServer(config) {
             pathname.startsWith(`${docsPath}/`) ||
             pathname === apiPath ||
             pathname.startsWith(`${apiPath}/`) ||
-            pathname === apiReferencePath ||
-            pathname.startsWith(`${apiReferencePath}/`) ||
+            (apiReferenceEnabled &&
+                (pathname === apiReferencePath || pathname.startsWith(`${apiReferencePath}/`))) ||
             publicDocsPaths.has(pathname) ||
             pathname.startsWith("/.well-known/agent-skills/");
         if (mcpConfig.enabled && mcpRoutes.has(pathname)) {
@@ -1955,7 +1992,7 @@ function serializeInlineJson(value) {
         .replace(/\u2029/g, "\\u2029");
 }
 function createClientDocsConfig(config) {
-    const { apiKey: _apiKey, rootDir: _rootDir, contentDir: _contentDir, _preloadedContent, _preloadedAgentSkills, socialImage, ...clientConfig } = config;
+    const { apiKey: _apiKey, rootDir: _rootDir, contentDir: _contentDir, _preloadedContent, _preloadedAgentSkills, _preloadedRootDocuments, socialImage, ...clientConfig } = config;
     const ai = clientConfig.ai && typeof clientConfig.ai === "object"
         ? {
             ...clientConfig.ai,
@@ -2046,6 +2083,8 @@ function renderThemeBootstrap(config) {
 }
 function renderFarmDocsDocument(input) {
     const { config, data } = input;
+    const markdownHref = `${input.origin ?? ""}${data.url.replace(/\/+$/, "")}.md`;
+    const clientConfig = createClientDocsConfig(config);
     const description = data.description ?? config.metadata?.description;
     const themeName = config.theme?.name ?? "default";
     const favicon = typeof config.favicon === "string" ? config.favicon : undefined;
@@ -2062,6 +2101,7 @@ function renderFarmDocsDocument(input) {
   <meta name="generator" content="@farming-labs/farmjs">
   <title>${escapeDocumentText(data.title)}</title>
   ${description ? `<meta name="description" content="${escapeDocumentText(description)}">` : ""}
+  <link rel="alternate" type="text/markdown" href="${escapeDocumentText(markdownHref)}">
   ${favicon ? `<link rel="icon" href="${escapeDocumentText(favicon)}">` : ""}
   ${renderThemeBootstrap(config)}
   ${fontPreloads}
@@ -2072,7 +2112,7 @@ function renderFarmDocsDocument(input) {
 </head>
 <body>
   <div id="root"><div id="farm-docs-root"${rootClasses ? ` class="${escapeDocumentText(rootClasses)}"` : ""}${rootStyle ? ` style="${escapeDocumentText(rootStyle)}"` : ""}>${input.markup}</div></div>
-  <script>window.__FARM_DOCS_ADAPTER__={config:${serializeInlineJson(createClientDocsConfig(config))},data:${serializeInlineJson(data)}};</script>
+  <script>window.__FARM_DOCS_ADAPTER__={config:${serializeInlineJson(clientConfig)},data:${serializeInlineJson(data)}${hasUnserializableValues(clientConfig) ? ",configModule:true" : ""}};</script>
   <script type="module" src="${escapeDocumentText(input.clientEntry)}"></script>
 </body>
 </html>`;
@@ -2159,6 +2199,7 @@ export function createFarmDocsRuntimeHandler(config, options = {}) {
             clientEntry: options.clientEntry ?? "/farm-client.js",
             stylesheets: options.stylesheets ?? [],
             fonts,
+            origin: new URL(request.url).origin,
         });
         return new Response(request.method.toUpperCase() === "HEAD" ? null : html, {
             status: 200,