@farm.js/core 0.1.51-beta.0 → 0.1.51-beta.2

package/dist/{chunk-YLNBWUVS.mjs → chunk-E6LTONL4.mjs}

@@ -1,6 +1,6 @@
 import {
   getFarmRouteLabel
-} from "./chunk-R5P4KFPM.mjs";
+} from "./chunk-E73PGHSR.mjs";
 import {
   classifyFarmAgent
 } from "./chunk-N77JBPLC.mjs";

package/dist/{chunk-R5P4KFPM.mjs → chunk-E73PGHSR.mjs}

@@ -23,7 +23,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-6CYQQQGR.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-SF3JB56B.mjs";
@@ -441,14 +441,16 @@ function resolveFarmDocsRouteLabel(routePathname, docs) {
   const apiPath = normalize(docs.apiPath ?? "/api/docs");
   if (pathname === apiPath) return apiPath;
   if (pathname.startsWith(`${apiPath}/`)) return `${apiPath}/[...path]`;
-  const entry = normalize(docs.path);
-  const base = entry === "/" ? "" : entry;
   const markdown = pathname.toLowerCase().endsWith(".md");
   const page = markdown ? pathname.slice(0, -".md".length) : pathname;
-  if (page === entry || entry === "/" && page === "/index") {
-    return markdown ? getFarmMarkdownMirrorPath(entry) : entry;
+  const entries = [docs.path, ...docs.roots ?? []].map(normalize).sort((a, b) => b.length - a.length);
+  for (const entry of entries) {
+    const base = entry === "/" ? "" : entry;
+    if (page === entry || entry === "/" && page === "/index") {
+      return markdown ? getFarmMarkdownMirrorPath(entry) : entry;
+    }
+    if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   }
-  if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   return null;
 }
 function resolveFarmDocsEngineRouteLabel(routePathname, docs) {

package/dist/{chunk-4GJJ65RB.mjs → chunk-EIMK7D2D.mjs}

@@ -651,16 +651,34 @@ function resolveFarmDocsContentDir(docs, options) {
   if (existsSync2(appDocsDir)) return appDocsDir;
   return path2.join(root, entryDir);
 }
+function getFarmDocsRoots(docs) {
+  return [
+    docs,
+    ...(docs.roots ?? []).map((root) => ({
+      ...docs,
+      entry: root.entry,
+      contentDir: root.contentDir,
+      config: root.config,
+      runtimeConfig: root.runtimeConfig,
+      configOverrides: root.configOverrides,
+      roots: void 0
+    }))
+  ];
+}
 function getFarmDocsRouteTypeEntries(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry2(docs.entry);
-  if (entry === "/") return ["/", "/[...docs]"];
-  return [entry, `${entry}/[...docs]`];
+  return getFarmDocsRoots(docs).flatMap((root) => {
+    const entry = normalizeEntry2(root.entry);
+    if (entry === "/") return ["/", "/[...docs]"];
+    return [entry, `${entry}/[...docs]`];
+  });
 }
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry2(docs.entry);
-  return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
+  return getFarmDocsRoots(docs).map((root) => {
+    const entry = normalizeEntry2(root.entry);
+    return entry === "/" ? "/(.*)" : `${entry}(.*)`;
+  });
 }
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
@@ -1921,6 +1939,7 @@ export {
   createFarmDocsLastModifiedManifest,
   isFarmDocsRequest,
   resolveFarmDocsContentDir,
+  getFarmDocsRoots,
   getFarmDocsRouteTypeEntries,
   getFarmDocsDocumentNavigationMatchers,
   loadFarmDocsPage,

package/dist/{chunk-CY7H5KS4.cjs → chunk-EKJYE4Y7.cjs}

@@ -29,7 +29,7 @@ var _chunkSYW346ZNcjs = require('./chunk-SYW346ZN.cjs');
 var _chunkGBMWLDCCcjs = require('./chunk-GBMWLDCC.cjs');
 
 
-var _chunkWAPQWAE6cjs = require('./chunk-WAPQWAE6.cjs');
+var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
 
 // src/schema-dependencies.ts
 function collectSchemaDependencies(owners) {
@@ -115,7 +115,7 @@ async function withTimeout(work, timeoutMs) {
 var formatSeconds = (ms) => ms < 1e3 ? `${ms}ms` : `${Number((ms / 1e3).toFixed(1))}s`;
 function collectSchemaOwners(config) {
   const owners = [];
-  const integrationSchemas = _chunkWAPQWAE6cjs.getIntegrationSchemas.call(void 0, config.integrations);
+  const integrationSchemas = _chunkCECUDGXQcjs.getIntegrationSchemas.call(void 0, config.integrations);
   let integrationClient;
   for (const [name, schema] of Object.entries(integrationSchemas)) {
     owners.push({

package/dist/{chunk-3HA7PP72.mjs → chunk-FM2UEKS2.mjs}

@@ -1,17 +1,18 @@
 import {
   discoverFarmDocsPages,
   getFarmDocsMarkdownPath,
+  getFarmDocsRoots,
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-4GJJ65RB.mjs";
+} from "./chunk-EIMK7D2D.mjs";
 import {
   docsEngine,
   loadFarmDocsEngine
 } from "./chunk-VE3FWJBO.mjs";
 import {
   resolveDocsConfig
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-CTM4SPB3.mjs";
 import {
   getFarmDocsAdapterConfigModule,
   isSecretDocsConfigKey
@@ -26,7 +27,7 @@ function hasFarmDocsRuntimeAdapter(docs) {
 }
 function assertFarmDocsAdapterServesNoGuardedPages(docs, options, isPathGuarded) {
   if (!isPathGuarded || !hasFarmDocsRuntimeAdapter(docs)) return;
-  const guarded = discoverFarmDocsPages(resolveFarmDocsContentDir(docs, options), docs).filter((page) => isPathGuarded(page.href) || isPathGuarded(getFarmDocsMarkdownPath(page.href))).map((page) => page.href);
+  const guarded = getFarmDocsRoots(docs).flatMap((root) => discoverFarmDocsPages(resolveFarmDocsContentDir(root, options), root)).filter((page) => isPathGuarded(page.href) || isPathGuarded(getFarmDocsMarkdownPath(page.href))).map((page) => page.href);
   if (guarded.length === 0) return;
   throw new Error(
     `Docs pages behind a path guard (${guarded.join(", ")}) would be public: the docs adapter ${JSON.stringify(docs.adapter.id)} serves their content in llms-full.txt, search, Markdown, and MCP without running the app's guards. Move those pages out of the docs content directory, or set docs.adapter = false to use Farm's built-in docs runtime, which keeps guarded pages off anonymous surfaces.`
@@ -39,9 +40,17 @@ async function loadFarmDocsConfigModule(docs, loadModule) {
   const config = loaded?.default ?? loaded;
   return config && typeof config === "object" ? config : void 0;
 }
+function getFarmDocsConfigModuleRoot(moduleConfig, entry) {
+  const { roots, ...shared } = moduleConfig;
+  const route = entry.replace(/^\/+|\/+$/g, "");
+  const own = Array.isArray(roots) ? roots.find(
+    (root) => Boolean(root) && typeof root === "object" && typeof root.entry === "string" && root.entry.replace(/^\/+|\/+$/g, "") === route
+  ) : void 0;
+  return own ? { ...shared, ...own } : shared;
+}
 function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
   return {
-    ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : docs.runtimeConfig ?? docs.config,
+    ...moduleConfig ? { ...getFarmDocsConfigModuleRoot(moduleConfig, docs.entry), ...docs.configOverrides } : docs.runtimeConfig ?? docs.config,
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
     contentDir: resolveFarmDocsContentDir(docs, options)
@@ -56,6 +65,11 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
   }
+  if (docs.roots?.length) {
+    throw new Error(
+      "Several docs roots are not supported on edge deployments yet; they need a Node.js deployment target."
+    );
+  }
   const compilerEntry = docs.adapter.edgeCompiler;
   if (!compilerEntry) {
     throw new Error(
@@ -96,6 +110,27 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   }
   return manifest;
 }
+async function listFarmDocsAdapterPages(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) return null;
+  const requireFromApp = createRequire(path.join(options.root, "package.json"));
+  const serverModule = await import(
+    /* @vite-ignore */
+    pathToFileURL(requireFromApp.resolve(docs.adapter.server)).href
+  );
+  if (typeof serverModule.listFarmDocsPages !== "function") return null;
+  const listPages = serverModule.listFarmDocsPages;
+  const pages = (await Promise.all(
+    getFarmDocsRoots(docs).map(
+      (root) => listPages(createFarmDocsAdapterRuntimeConfig(root, options), { rootDir: options.root })
+    )
+  )).flat();
+  if (!Array.isArray(pages) || pages.some((page) => typeof page !== "string" || !page.startsWith("/"))) {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} listed docs pages that are not absolute paths.`
+    );
+  }
+  return [...new Set(pages)];
+}
 async function createFarmDocsAdapterHandler(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
@@ -104,26 +139,36 @@ async function createFarmDocsAdapterHandler(docs, options) {
   const serverModule = await options.loadModule(
     docs.adapter.server
   );
-  if (typeof serverModule.createFarmDocsRuntimeHandler !== "function") {
+  const multiRoot = Boolean(docs.roots?.length);
+  const handlerExport = multiRoot ? "createFarmDocsMultiRuntimeHandler" : "createFarmDocsRuntimeHandler";
+  if (typeof serverModule[handlerExport] !== "function") {
     const adapterId = JSON.stringify(docs.adapter.id);
     const serverEntry = JSON.stringify(docs.adapter.server);
     throw new Error(
-      `Farm docs adapter ${adapterId} does not export createFarmDocsRuntimeHandler from ${serverEntry}. Upgrade the adapter to a runtime-enabled release.`
+      `Farm docs adapter ${adapterId} does not export ${handlerExport} from ${serverEntry}. ` + (multiRoot ? "Upgrade the adapter to a release that serves several docs roots, or remove the roots." : "Upgrade the adapter to a runtime-enabled release.")
     );
   }
-  const runtimeConfig = createFarmDocsAdapterRuntimeConfig(
-    docs,
-    options,
-    await loadFarmDocsConfigModule(docs, options.loadModule)
-  );
-  return serverModule.createFarmDocsRuntimeHandler(runtimeConfig, {
+  const moduleConfig = await loadFarmDocsConfigModule(docs, options.loadModule);
+  const handlerOptions = {
     rootDir: options.root,
     clientEntry: options.clientEntry,
     stylesheets: getFarmDocsAdapterStylesheets(options),
     resolveLayoutFonts: options.resolveLayoutFonts,
     loadReactModule: () => options.loadModule(docs.adapter.react),
     ...options.registerMCPServer ? { registerMCPServer: options.registerMCPServer } : {}
-  });
+  };
+  if (multiRoot) {
+    return serverModule.createFarmDocsMultiRuntimeHandler(
+      getFarmDocsRoots(docs).map(
+        (root) => createFarmDocsAdapterRuntimeConfig(root, options, moduleConfig)
+      ),
+      handlerOptions
+    );
+  }
+  return serverModule.createFarmDocsRuntimeHandler(
+    createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig),
+    handlerOptions
+  );
 }
 
 // src/docs/api.ts
@@ -658,7 +703,9 @@ function createFarmDocsAPIHandler(options = {}, cloudIntegration) {
 export {
   hasFarmDocsRuntimeAdapter,
   assertFarmDocsAdapterServesNoGuardedPages,
+  getFarmDocsConfigModuleRoot,
   compileFarmDocsAdapterEdgeManifest,
+  listFarmDocsAdapterPages,
   createFarmDocsAdapterHandler,
   isFarmDocsAPIRequest,
   createDocsAPI,

package/dist/{chunk-VIFPE5RG.cjs → chunk-GNJIYJMS.cjs}

@@ -4,14 +4,15 @@
 
 
 
-var _chunkIOUOGRDXcjs = require('./chunk-IOUOGRDX.cjs');
+
+var _chunk5N7QAGEAcjs = require('./chunk-5N7QAGEA.cjs');
 
 
 
 var _chunkV3UOEWCBcjs = require('./chunk-V3UOEWCB.cjs');
 
 
-var _chunkO3MMJPC2cjs = require('./chunk-O3MMJPC2.cjs');
+var _chunkNPQLMP7Mcjs = require('./chunk-NPQLMP7M.cjs');
 
 
 
@@ -26,7 +27,7 @@ function hasFarmDocsRuntimeAdapter(docs) {
 }
 function assertFarmDocsAdapterServesNoGuardedPages(docs, options, isPathGuarded) {
   if (!isPathGuarded || !hasFarmDocsRuntimeAdapter(docs)) return;
-  const guarded = _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, docs, options), docs).filter((page) => isPathGuarded(page.href) || isPathGuarded(_chunkIOUOGRDXcjs.getFarmDocsMarkdownPath.call(void 0, page.href))).map((page) => page.href);
+  const guarded = _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).flatMap((root) => _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, root, options), root)).filter((page) => isPathGuarded(page.href) || isPathGuarded(_chunk5N7QAGEAcjs.getFarmDocsMarkdownPath.call(void 0, page.href))).map((page) => page.href);
   if (guarded.length === 0) return;
   throw new Error(
     `Docs pages behind a path guard (${guarded.join(", ")}) would be public: the docs adapter ${JSON.stringify(docs.adapter.id)} serves their content in llms-full.txt, search, Markdown, and MCP without running the app's guards. Move those pages out of the docs content directory, or set docs.adapter = false to use Farm's built-in docs runtime, which keeps guarded pages off anonymous surfaces.`
@@ -39,12 +40,20 @@ async function loadFarmDocsConfigModule(docs, loadModule) {
   const config = _nullishCoalesce(_optionalChain([loaded, 'optionalAccess', _4 => _4.default]), () => ( loaded));
   return config && typeof config === "object" ? config : void 0;
 }
+function getFarmDocsConfigModuleRoot(moduleConfig, entry) {
+  const { roots, ...shared } = moduleConfig;
+  const route = entry.replace(/^\/+|\/+$/g, "");
+  const own = Array.isArray(roots) ? roots.find(
+    (root) => Boolean(root) && typeof root === "object" && typeof root.entry === "string" && root.entry.replace(/^\/+|\/+$/g, "") === route
+  ) : void 0;
+  return own ? { ...shared, ...own } : shared;
+}
 function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
   return {
-    ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
+    ...moduleConfig ? { ...getFarmDocsConfigModuleRoot(moduleConfig, docs.entry), ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
-    contentDir: _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+    contentDir: _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
   };
 }
 function getFarmDocsAdapterStylesheets(options) {
@@ -56,6 +65,11 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
   }
+  if (_optionalChain([docs, 'access', _5 => _5.roots, 'optionalAccess', _6 => _6.length])) {
+    throw new Error(
+      "Several docs roots are not supported on edge deployments yet; they need a Node.js deployment target."
+    );
+  }
   const compilerEntry = docs.adapter.edgeCompiler;
   if (!compilerEntry) {
     throw new Error(
@@ -96,6 +110,27 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   }
   return manifest;
 }
+async function listFarmDocsAdapterPages(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) return null;
+  const requireFromApp = _module.createRequire.call(void 0, _path2.default.join(options.root, "package.json"));
+  const serverModule = await import(
+    /* @vite-ignore */
+    _url.pathToFileURL.call(void 0, requireFromApp.resolve(docs.adapter.server)).href
+  );
+  if (typeof serverModule.listFarmDocsPages !== "function") return null;
+  const listPages = serverModule.listFarmDocsPages;
+  const pages = (await Promise.all(
+    _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).map(
+      (root) => listPages(createFarmDocsAdapterRuntimeConfig(root, options), { rootDir: options.root })
+    )
+  )).flat();
+  if (!Array.isArray(pages) || pages.some((page) => typeof page !== "string" || !page.startsWith("/"))) {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} listed docs pages that are not absolute paths.`
+    );
+  }
+  return [...new Set(pages)];
+}
 async function createFarmDocsAdapterHandler(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
@@ -104,26 +139,36 @@ async function createFarmDocsAdapterHandler(docs, options) {
   const serverModule = await options.loadModule(
     docs.adapter.server
   );
-  if (typeof serverModule.createFarmDocsRuntimeHandler !== "function") {
+  const multiRoot = Boolean(_optionalChain([docs, 'access', _7 => _7.roots, 'optionalAccess', _8 => _8.length]));
+  const handlerExport = multiRoot ? "createFarmDocsMultiRuntimeHandler" : "createFarmDocsRuntimeHandler";
+  if (typeof serverModule[handlerExport] !== "function") {
     const adapterId = JSON.stringify(docs.adapter.id);
     const serverEntry = JSON.stringify(docs.adapter.server);
     throw new Error(
-      `Farm docs adapter ${adapterId} does not export createFarmDocsRuntimeHandler from ${serverEntry}. Upgrade the adapter to a runtime-enabled release.`
+      `Farm docs adapter ${adapterId} does not export ${handlerExport} from ${serverEntry}. ` + (multiRoot ? "Upgrade the adapter to a release that serves several docs roots, or remove the roots." : "Upgrade the adapter to a runtime-enabled release.")
     );
   }
-  const runtimeConfig = createFarmDocsAdapterRuntimeConfig(
-    docs,
-    options,
-    await loadFarmDocsConfigModule(docs, options.loadModule)
-  );
-  return serverModule.createFarmDocsRuntimeHandler(runtimeConfig, {
+  const moduleConfig = await loadFarmDocsConfigModule(docs, options.loadModule);
+  const handlerOptions = {
     rootDir: options.root,
     clientEntry: options.clientEntry,
     stylesheets: getFarmDocsAdapterStylesheets(options),
     resolveLayoutFonts: options.resolveLayoutFonts,
     loadReactModule: () => options.loadModule(docs.adapter.react),
     ...options.registerMCPServer ? { registerMCPServer: options.registerMCPServer } : {}
-  });
+  };
+  if (multiRoot) {
+    return serverModule.createFarmDocsMultiRuntimeHandler(
+      _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).map(
+        (root) => createFarmDocsAdapterRuntimeConfig(root, options, moduleConfig)
+      ),
+      handlerOptions
+    );
+  }
+  return serverModule.createFarmDocsRuntimeHandler(
+    createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig),
+    handlerOptions
+  );
 }
 
 // src/docs/api.ts
@@ -158,7 +203,7 @@ function omitHeadBody(response) {
   });
 }
 function normalizeAction(value) {
-  return _optionalChain([value, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6(), 'access', _7 => _7.toLowerCase, 'call', _8 => _8(), 'access', _9 => _9.replace, 'call', _10 => _10(/_/g, "-")]) || void 0;
+  return _optionalChain([value, 'optionalAccess', _9 => _9.trim, 'call', _10 => _10(), 'access', _11 => _11.toLowerCase, 'call', _12 => _12(), 'access', _13 => _13.replace, 'call', _14 => _14(/_/g, "-")]) || void 0;
 }
 function getDocsTitle(docs) {
   return typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Documentation") : "Documentation";
@@ -257,25 +302,25 @@ function getDocsAPIFormat(request) {
   return normalizeAction(url.searchParams.get("format") || url.searchParams.get("type")) || getDocsAPIPathTarget(request).format;
 }
 function getDocsDescription(docs) {
-  return _optionalChain([docs, 'access', _11 => _11.config, 'access', _12 => _12.metadata, 'optionalAccess', _13 => _13.description]);
+  return _optionalChain([docs, 'access', _15 => _15.config, 'access', _16 => _16.metadata, 'optionalAccess', _17 => _17.description]);
 }
 function getLoadedDocsPages(context) {
-  return _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter((page) => !context.isPathGuarded(page.href)).map((page) => _chunkIOUOGRDXcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+  return _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter((page) => !context.isPathGuarded(page.href)).map((page) => _chunk5N7QAGEAcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
 }
 function toDocsSourcePage(page) {
   return {
-    ..._chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsSitemapPage(page) {
   return {
-    ..._chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsLlmsPage(page) {
-  return _chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page);
+  return _chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page);
 }
 function getDocsLlmsOptions(context, request) {
   const configured = isRecord(context.docs.config.llmsTxt) ? context.docs.config.llmsTxt : {};
@@ -362,7 +407,7 @@ function renderAgentsDocument(context, request) {
 function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
-  const pages = _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter(
+  const pages = _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter(
     (page) => !context.isPathGuarded(page.href)
   );
   const spec = _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
@@ -450,7 +495,7 @@ function buildPublicConfig(context) {
   };
 }
 function buildDiagnostics(context) {
-  const pages = _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const diagnostics = _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).buildDocsDiagnostics(context.docs.config, {
     entry: context.docs.entry,
     mcp: {
@@ -500,19 +545,19 @@ async function searchDocs(context, request, query) {
     const page = sourcePageByUrl.get(pageUrl);
     return {
       ...result,
-      title: _optionalChain([page, 'optionalAccess', _14 => _14.title]) || result.content,
-      href: _optionalChain([page, 'optionalAccess', _15 => _15.url]) || pageUrl,
-      description: result.description || _optionalChain([page, 'optionalAccess', _16 => _16.description])
+      title: _optionalChain([page, 'optionalAccess', _18 => _18.title]) || result.content,
+      href: _optionalChain([page, 'optionalAccess', _19 => _19.url]) || pageUrl,
+      description: result.description || _optionalChain([page, 'optionalAccess', _20 => _20.description])
     };
   });
 }
 async function resolveAPIContext(options) {
   await _chunkV3UOEWCBcjs.loadFarmDocsEngine.call(void 0, );
   const runtimeConfig = globalThis.__FARM_DOCS_RUNTIME_CONFIG__;
-  const root = options.rootDir || options.root || _optionalChain([runtimeConfig, 'optionalAccess', _17 => _17.root]) || process.cwd();
-  const srcDir = options.srcDir || _optionalChain([runtimeConfig, 'optionalAccess', _18 => _18.srcDir]) || "src";
+  const root = options.rootDir || options.root || _optionalChain([runtimeConfig, 'optionalAccess', _21 => _21.root]) || process.cwd();
+  const srcDir = options.srcDir || _optionalChain([runtimeConfig, 'optionalAccess', _22 => _22.srcDir]) || "src";
   const canUseRuntimeDocs = options.docs === void 0 && options.config === void 0 && options.configPath === void 0 && options.entry === void 0 && options.docsPath === void 0 && options.contentDir === void 0 && options.root === void 0 && options.rootDir === void 0 && options.srcDir === void 0;
-  const docsInput = _nullishCoalesce(_nullishCoalesce(options.docs, () => ( (canUseRuntimeDocs ? _optionalChain([runtimeConfig, 'optionalAccess', _19 => _19.docs]) : void 0))), () => ( {
+  const docsInput = _nullishCoalesce(_nullishCoalesce(options.docs, () => ( (canUseRuntimeDocs ? _optionalChain([runtimeConfig, 'optionalAccess', _23 => _23.docs]) : void 0))), () => ( {
     enabled: true,
     entry: options.entry,
     docsPath: options.docsPath,
@@ -520,13 +565,13 @@ async function resolveAPIContext(options) {
     config: options.config,
     configPath: options.configPath
   }));
-  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkO3MMJPC2cjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
-  const guardedPaths = new Set(_nullishCoalesce(_optionalChain([runtimeConfig, 'optionalAccess', _20 => _20.guardedPaths]), () => ( [])));
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkNPQLMP7Mcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  const guardedPaths = new Set(_nullishCoalesce(_optionalChain([runtimeConfig, 'optionalAccess', _24 => _24.guardedPaths]), () => ( [])));
   return {
     root,
     srcDir,
     docs,
-    contentDir: _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir }),
+    contentDir: _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir }),
     diagnostics: options.diagnostics === true,
     isPathGuarded: _nullishCoalesce(options.isPathGuarded, () => ( ((pathname) => guardedPaths.has(pathname))))
   };
@@ -585,12 +630,12 @@ async function handleDocsAPIGet(request, context) {
   if (format === "markdown" || url.pathname.endsWith(".md")) {
     const pathParam = url.searchParams.get("path") || url.searchParams.get("slug");
     const slug = normalizeDocsApiSlug(_nullishCoalesce(_nullishCoalesce(pathParam, () => ( pathTarget.slug)), () => ( "")), context.docs);
-    const page = _chunkIOUOGRDXcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    const page = _chunk5N7QAGEAcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
     if (!page || context.isPathGuarded(page.href)) {
       return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
     }
     return text(
-      _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page), {
+      _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap
@@ -663,4 +708,6 @@ function createFarmDocsAPIHandler(options = {}, cloudIntegration) {
 
 
 
-exports.hasFarmDocsRuntimeAdapter = hasFarmDocsRuntimeAdapter; exports.assertFarmDocsAdapterServesNoGuardedPages = assertFarmDocsAdapterServesNoGuardedPages; exports.compileFarmDocsAdapterEdgeManifest = compileFarmDocsAdapterEdgeManifest; exports.createFarmDocsAdapterHandler = createFarmDocsAdapterHandler; exports.isFarmDocsAPIRequest = isFarmDocsAPIRequest; exports.createDocsAPI = createDocsAPI; exports.createFarmDocsAPIHandler = createFarmDocsAPIHandler;
+
+
+exports.hasFarmDocsRuntimeAdapter = hasFarmDocsRuntimeAdapter; exports.assertFarmDocsAdapterServesNoGuardedPages = assertFarmDocsAdapterServesNoGuardedPages; exports.getFarmDocsConfigModuleRoot = getFarmDocsConfigModuleRoot; exports.compileFarmDocsAdapterEdgeManifest = compileFarmDocsAdapterEdgeManifest; exports.listFarmDocsAdapterPages = listFarmDocsAdapterPages; exports.createFarmDocsAdapterHandler = createFarmDocsAdapterHandler; exports.isFarmDocsAPIRequest = isFarmDocsAPIRequest; exports.createDocsAPI = createDocsAPI; exports.createFarmDocsAPIHandler = createFarmDocsAPIHandler;

package/dist/{chunk-X5BCMLGP.cjs → chunk-GUJTVM36.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.51-beta.0";
+var version = "0.1.51-beta.2";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-XWC5NAHV.mjs → chunk-IBSAYAWB.mjs}

@@ -7,11 +7,11 @@ import {
 } from "./chunk-LMFJCXDD.mjs";
 import {
   resolveDeployOutputPath
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-CTM4SPB3.mjs";
 import {
   farmDesktopDevGuardPlugin,
   loadFarmReactPlugin
-} from "./chunk-75WWOZ5C.mjs";
+} from "./chunk-QOSDWGKT.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";

package/dist/{chunk-J22JD5YJ.cjs → chunk-J3LBO2O4.cjs}

@@ -23,7 +23,7 @@ var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkX5BCMLGPcjs = require('./chunk-X5BCMLGP.cjs');
+var _chunkGUJTVM36cjs = require('./chunk-GUJTVM36.cjs');
 
 
 var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
@@ -282,7 +282,7 @@ function createFarmAppManifest(input) {
   return {
     schemaVersion: 1,
     app: app ? {
-      ...app.version ? { farm: _chunkX5BCMLGPcjs.FARM_VERSION } : {},
+      ...app.version ? { farm: _chunkGUJTVM36cjs.FARM_VERSION } : {},
       ...app.renderer ? { renderer: input.renderer } : {},
       basePath: input.basePath,
       ...app.build ? { build: input.build } : {}
@@ -441,14 +441,16 @@ function resolveFarmDocsRouteLabel(routePathname, docs) {
   const apiPath = normalize(_nullishCoalesce(docs.apiPath, () => ( "/api/docs")));
   if (pathname === apiPath) return apiPath;
   if (pathname.startsWith(`${apiPath}/`)) return `${apiPath}/[...path]`;
-  const entry = normalize(docs.path);
-  const base = entry === "/" ? "" : entry;
   const markdown = pathname.toLowerCase().endsWith(".md");
   const page = markdown ? pathname.slice(0, -".md".length) : pathname;
-  if (page === entry || entry === "/" && page === "/index") {
-    return markdown ? _chunkWJFFPXCVcjs.getFarmMarkdownMirrorPath.call(void 0, entry) : entry;
+  const entries = [docs.path, ..._nullishCoalesce(docs.roots, () => ( []))].map(normalize).sort((a, b) => b.length - a.length);
+  for (const entry of entries) {
+    const base = entry === "/" ? "" : entry;
+    if (page === entry || entry === "/" && page === "/index") {
+      return markdown ? _chunkWJFFPXCVcjs.getFarmMarkdownMirrorPath.call(void 0, entry) : entry;
+    }
+    if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   }
-  if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   return null;
 }
 function resolveFarmDocsEngineRouteLabel(routePathname, docs) {