@farm.js/core 0.1.34 → 0.1.35

package/dist/{chunk-TA5G2HWD.cjs → chunk-4MMGO7YW.cjs}

@@ -6,7 +6,7 @@ var _chunk4PPEPOZZcjs = require('./chunk-4PPEPOZZ.cjs');
 var _chunkMQ3H6LT5cjs = require('./chunk-MQ3H6LT5.cjs');
 
 
-var _chunkMIDIZJZCcjs = require('./chunk-MIDIZJZC.cjs');
+var _chunkXBML5KMGcjs = require('./chunk-XBML5KMG.cjs');
 
 
 var _chunkSJNMVDDFcjs = require('./chunk-SJNMVDDF.cjs');
@@ -20,7 +20,7 @@ var _chunk2CQ74SP6cjs = require('./chunk-2CQ74SP6.cjs');
 
 
 
-var _chunkG26MUMKLcjs = require('./chunk-G26MUMKL.cjs');
+var _chunkXCACDAZZcjs = require('./chunk-XCACDAZZ.cjs');
 
 
 var _chunk6V4TDWECcjs = require('./chunk-6V4TDWEC.cjs');
@@ -28,7 +28,7 @@ var _chunk6V4TDWECcjs = require('./chunk-6V4TDWEC.cjs');
 
 
 
-var _chunkEM6SBQKMcjs = require('./chunk-EM6SBQKM.cjs');
+var _chunkOMVAU7NTcjs = require('./chunk-OMVAU7NT.cjs');
 
 
 var _chunkM2L4MYDQcjs = require('./chunk-M2L4MYDQ.cjs');
@@ -58,7 +58,7 @@ var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
 function farmApiPlugin(options = {}) {
   const srcDir = _nullishCoalesce(options.srcDir, () => ( "src"));
   const debug = _nullishCoalesce(options.debug, () => ( false));
-  const bodySizeLimit = _chunkEM6SBQKMcjs.resolveFarmServerConfig.call(void 0, {
+  const bodySizeLimit = _chunkOMVAU7NTcjs.resolveFarmServerConfig.call(void 0, {
     bodySizeLimit: options.bodySizeLimit
   }).bodySizeLimit;
   const basePath = options.basePath;
@@ -110,7 +110,7 @@ function farmApiPlugin(options = {}) {
     const existing = apiRoutesCache.get(routePath);
     const existingFile = _optionalChain([endpointSources, 'access', _ => _.get, 'call', _2 => _2(routePath), 'optionalAccess', _3 => _3.get, 'call', _4 => _4(normalizedMethod)]);
     if (existingFile) {
-      throw new (0, _chunkMIDIZJZCcjs.APIRouteConflictError)(routePath, normalizedMethod, existingFile, filePath);
+      throw new (0, _chunkXBML5KMGcjs.APIRouteConflictError)(routePath, normalizedMethod, existingFile, filePath);
     }
     if (existing) {
       if (!existing.methods.includes(normalizedMethod)) {
@@ -186,7 +186,7 @@ function farmApiPlugin(options = {}) {
   const createRouter = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async () => {
     const plugins = options.plugins ? await (_nullishCoalesce(routePlugins, () => ( (routePlugins = Promise.resolve(options.plugins({ root: projectRoot })))))) : [];
     pluginMergedRoutes = plugins.length ? new Map(
-      _chunkG26MUMKLcjs.mergePluginAPIRoutes.call(void 0, [...apiRoutesCache.values()], plugins, void 0, {
+      _chunkXCACDAZZcjs.mergePluginAPIRoutes.call(void 0, [...apiRoutesCache.values()], plugins, void 0, {
         bodySizeLimit
       }).map((route) => [route.path, route])
     ) : null;
@@ -200,7 +200,7 @@ function farmApiPlugin(options = {}) {
         const url = new URL(request.url);
         const method = request.method.toUpperCase();
         const pathname = url.pathname;
-        const match = _chunkG26MUMKLcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath);
+        const match = _chunkXCACDAZZcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath);
         if (!match) {
           return new Response(JSON.stringify({ error: "Not Found" }), {
             status: 404,
@@ -208,18 +208,18 @@ function farmApiPlugin(options = {}) {
           });
         }
         const { route, params } = match;
-        const endpoint = _chunkG26MUMKLcjs.resolveAPIRouteEndpoint.call(void 0, route, method);
+        const endpoint = _chunkXCACDAZZcjs.resolveAPIRouteEndpoint.call(void 0, route, method);
         if (!endpoint) {
           return new Response(JSON.stringify({ error: "Method Not Allowed" }), {
             status: 405,
             headers: {
-              Allow: _chunkG26MUMKLcjs.getAllowedAPIRouteMethods.call(void 0, route).join(", "),
+              Allow: _chunkXCACDAZZcjs.getAllowedAPIRouteMethods.call(void 0, route).join(", "),
               "Content-Type": "application/json"
             }
           });
         }
         try {
-          return await _chunkG26MUMKLcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params, bodySizeLimit);
+          return await _chunkXCACDAZZcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params, bodySizeLimit);
         } catch (error) {
           return new Response(JSON.stringify({ error: error.message || "Internal Server Error" }), {
             status: 500,
@@ -267,7 +267,7 @@ function farmApiPlugin(options = {}) {
             const routeModule = await _chunkBMWDEBXOcjs.loadFarmDevModule.call(void 0, server, filePath);
             const endpoints = {};
             const availableMethods = [];
-            for (const method of _chunkG26MUMKLcjs.API_ROUTE_METHODS) {
+            for (const method of _chunkXCACDAZZcjs.API_ROUTE_METHODS) {
               if (routeModule[method]) {
                 availableMethods.push(method);
                 endpoints[method] = routeModule[method];
@@ -280,7 +280,7 @@ function farmApiPlugin(options = {}) {
               log(`API route discovered: ${availableMethods.join(", ")} ${routePath}`);
             }
           } catch (e) {
-            if (e instanceof _chunkMIDIZJZCcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
+            if (e instanceof _chunkXBML5KMGcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
             log(`API route load failed at ${filePath}: ${e.message}`);
           }
         }
@@ -307,7 +307,7 @@ function farmApiPlugin(options = {}) {
                 }
               }
             } catch (e) {
-              if (e instanceof _chunkMIDIZJZCcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
+              if (e instanceof _chunkXBML5KMGcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
               log(`Root routes.ts load failed: ${e.message}`);
             }
             break;
@@ -338,7 +338,7 @@ function farmApiPlugin(options = {}) {
               }
             }
           } catch (e) {
-            if (e instanceof _chunkMIDIZJZCcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
+            if (e instanceof _chunkXBML5KMGcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
             log(`Programmatic routes file load failed at ${routeFile}: ${e.message}`);
           }
         }
@@ -390,7 +390,7 @@ function farmApiPlugin(options = {}) {
           const pathname = url.split("?")[0];
           const method = req.method || "GET";
           if (discoveryPromise) await waitForDiscovery();
-          if (!_chunkG26MUMKLcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath)) {
+          if (!_chunkXCACDAZZcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath)) {
             return next();
           }
           if (!apiRouterHandler) {
@@ -411,7 +411,7 @@ function farmApiPlugin(options = {}) {
             }
             const currentUrl = req.url || url;
             const currentPathname = currentUrl.split("?")[0];
-            if (currentPathname !== pathname && !_chunkG26MUMKLcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), currentPathname, basePath)) {
+            if (currentPathname !== pathname && !_chunkXCACDAZZcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), currentPathname, basePath)) {
               return next();
             }
             const fullUrl = _chunkUXFQ3UDAcjs.resolveFarmRequestURL.call(void 0, req);
@@ -423,7 +423,7 @@ function farmApiPlugin(options = {}) {
             }
             let body;
             if (method !== "GET" && method !== "HEAD") {
-              body = await _chunkEM6SBQKMcjs.readNodeRequestBody.call(void 0, req, bodySizeLimit);
+              body = await _chunkOMVAU7NTcjs.readNodeRequestBody.call(void 0, req, bodySizeLimit);
             }
             const request = new Request(fullUrl, {
               method,
@@ -438,7 +438,7 @@ function farmApiPlugin(options = {}) {
             logResponse(method, currentPathname, response.status, duration);
             await _chunkUQZ4AYTHcjs.sendWebResponse.call(void 0, res, response);
           } catch (error) {
-            const bodyErrorResponse = _chunkEM6SBQKMcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
+            const bodyErrorResponse = _chunkOMVAU7NTcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
             if (bodyErrorResponse) {
               await _chunkUQZ4AYTHcjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
               return;
@@ -515,7 +515,7 @@ function farmApiPlugin(options = {}) {
           log(`API router recreated`);
         } catch (e) {
           restoreRouteState(previousState);
-          if (e instanceof _chunkMIDIZJZCcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
+          if (e instanceof _chunkXBML5KMGcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
           log(`Root routes.ts HMR failed: ${e.message}`);
         }
         return [];
@@ -543,7 +543,7 @@ function farmApiPlugin(options = {}) {
           const routeModule = await _chunkBMWDEBXOcjs.loadFarmDevModule.call(void 0, server, file);
           removeEndpointsFromFile(file);
           const availableMethods = [];
-          for (const method of _chunkG26MUMKLcjs.API_ROUTE_METHODS) {
+          for (const method of _chunkXCACDAZZcjs.API_ROUTE_METHODS) {
             if (!routeModule[method]) continue;
             availableMethods.push(method);
             addEndpoint(routePath, file, method, routeModule[method]);
@@ -553,7 +553,7 @@ function farmApiPlugin(options = {}) {
           log(`API router recreated`);
         } catch (e) {
           restoreRouteState(previousState);
-          if (e instanceof _chunkMIDIZJZCcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
+          if (e instanceof _chunkXBML5KMGcjs.APIRouteConflictError || e instanceof _chunkNO3WWW3Ncjs.AmbiguousRouteError) throw e;
           log(`API route HMR failed: ${e.message}`);
         }
         return [];

package/dist/{chunk-7BT4H4P7.cjs → chunk-62XKI4Z3.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkU74I55WBcjs = require('./chunk-U74I55WB.cjs');
+var _chunkULAWS2PAcjs = require('./chunk-ULAWS2PA.cjs');
 
 
 var _chunkHLJ6MBUZcjs = require('./chunk-HLJ6MBUZ.cjs');
@@ -415,7 +415,7 @@ function farmMiddlewarePlugin(options = {}) {
       mode: server.config.mode === "production" ? "production" : "development",
       basePath: _nullishCoalesce(options.basePath, () => ( "/"))
     });
-    manager = new (0, _chunkU74I55WBcjs.MiddlewareManager)(
+    manager = new (0, _chunkULAWS2PAcjs.MiddlewareManager)(
       getMiddlewareAppDirectory(server.config.root, srcDir),
       server,
       options.middleware,

package/dist/{chunk-ZKP7C2B6.mjs → chunk-6DU6UFUE.mjs}

@@ -29,7 +29,7 @@ import {
   resolveFarmNoindexPreviews,
   resolveFarmPerformanceConfig,
   resolveFarmSecurityConfig
-} from "./chunk-NGVORZVZ.mjs";
+} from "./chunk-UJD4PHYB.mjs";
 import {
   resolveFarmImageConfig
 } from "./chunk-G2KY33I6.mjs";
@@ -38,7 +38,7 @@ import {
 } from "./chunk-YHOCRI4H.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-QCFFHV5H.mjs";
+} from "./chunk-SMHH4VDG.mjs";
 import {
   resolveEnv,
   setEnv
@@ -48,22 +48,22 @@ import {
 } from "./chunk-FA2W42OV.mjs";
 import {
   resolveMarkdownConfig
-} from "./chunk-ZUSJDQ2Q.mjs";
+} from "./chunk-WWIKMBRN.mjs";
 import {
   bundleNodeModule
 } from "./chunk-SFGWNC43.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-3ATMYLLJ.mjs";
+} from "./chunk-6WCPV6G2.mjs";
 import {
   resolveFarmThemeConfig
 } from "./chunk-AELACLOB.mjs";
 import {
   resolveIntegrationPlugins
-} from "./chunk-GNSDTTWZ.mjs";
+} from "./chunk-HMIJDL7S.mjs";
 import {
   resolveFarmServerConfig
-} from "./chunk-XF7Q24PF.mjs";
+} from "./chunk-Y7RKTKYI.mjs";
 import {
   resolveFarmI18nConfig
 } from "./chunk-BCMSYSN2.mjs";
@@ -140,16 +140,17 @@ function resolveFarmAgentConfig(input, context = {}) {
     // llms-full.txt renders every listed page, so it stays opt-in.
     llmsTxt: resolveFarmLlmsTxtConfig(input?.llmsTxt ?? (context.docs ? false : { full: false })),
     crawlers: resolveFarmAgentCrawlers(input?.crawlers),
-    apiCatalog: resolveFarmApiCatalogEnabled(input?.apiCatalog)
+    apiCatalog: resolveFarmAgentBoolean(input?.apiCatalog, "apiCatalog", false),
+    aiCatalog: resolveFarmAgentBoolean(input?.aiCatalog, "aiCatalog", true)
   };
 }
 __name(resolveFarmAgentConfig, "resolveFarmAgentConfig");
-function resolveFarmApiCatalogEnabled(input) {
-  if (input === void 0) return false;
-  if (typeof input !== "boolean") throw new TypeError("agent.apiCatalog must be a boolean.");
+function resolveFarmAgentBoolean(input, key, fallback) {
+  if (input === void 0) return fallback;
+  if (typeof input !== "boolean") throw new TypeError(`agent.${key} must be a boolean.`);
   return input;
 }
-__name(resolveFarmApiCatalogEnabled, "resolveFarmApiCatalogEnabled");
+__name(resolveFarmAgentBoolean, "resolveFarmAgentBoolean");
 
 // src/docs/framework-detect.ts
 import { readFile } from "fs/promises";

package/dist/{chunk-GOABMOX3.mjs → chunk-6ETPZTJI.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XAXTTBUT.mjs";
 import {
   serializeFarmLlmsTxt
-} from "./chunk-NGVORZVZ.mjs";
+} from "./chunk-UJD4PHYB.mjs";
 import {
   emitFarmAgentRead
 } from "./chunk-MVL2RAJW.mjs";
@@ -14,15 +14,19 @@ import {
   omitFarmResponseBody
 } from "./chunk-5WI2S4CO.mjs";
 import {
-  _listFarmMCPCatalogs
-} from "./chunk-QLQ32WC4.mjs";
+  _listFarmMCPCatalogs,
+  _listFarmRegisteredMCPServers
+} from "./chunk-ZLAT2CWY.mjs";
+import {
+  matchesFarmIfNoneMatch
+} from "./chunk-Y7RKTKYI.mjs";
 import {
   resolveFarmAPIServerBasePath,
   resolveFarmAPIServerRoutePath
 } from "./chunk-BTHHUD7Q.mjs";
 import {
   FARM_VERSION
-} from "./chunk-X242HVD5.mjs";
+} from "./chunk-3PXS2MHU.mjs";
 import {
   localizeFarmPathname
 } from "./chunk-L3KT7IXV.mjs";
@@ -33,6 +37,184 @@ import {
   __name
 } from "./chunk-LPEX4YW6.mjs";
 
+// src/routing/route-groups.ts
+function isRouteGroupSegment(part) {
+  return part.startsWith("(") && part.endsWith(")");
+}
+__name(isRouteGroupSegment, "isRouteGroupSegment");
+function formatRouteSegment(segment) {
+  if (!segment.isDynamic) return segment.segment;
+  if (segment.isCatchAll) {
+    return segment.isOptional ? `[[...${segment.segment}]]` : `[...${segment.segment}]`;
+  }
+  return `[${segment.segment}]`;
+}
+__name(formatRouteSegment, "formatRouteSegment");
+function createRouteDirectoryPattern(route) {
+  const parts = route.filePath.replace(/\\/g, "/").split("/").filter(Boolean);
+  parts.pop();
+  if (parts.length === 0) return "/";
+  let segmentIndex = 0;
+  const directory = parts.map((part) => {
+    if (isRouteGroupSegment(part)) return part;
+    const segment = route.segments[segmentIndex++];
+    return segment ? formatRouteSegment(segment) : part;
+  });
+  return `/${directory.join("/")}`;
+}
+__name(createRouteDirectoryPattern, "createRouteDirectoryPattern");
+function stripRouteGroups(pattern) {
+  if (!pattern.includes("(")) return pattern;
+  const parts = pattern.split("/").filter((part) => part && !isRouteGroupSegment(part));
+  return parts.length === 0 ? "/" : `/${parts.join("/")}`;
+}
+__name(stripRouteGroups, "stripRouteGroups");
+function getRouteGroupScope(pattern) {
+  if (!pattern.includes("(")) return null;
+  const parts = pattern.split("/");
+  for (let index = parts.length - 1; index > 0; index--) {
+    if (isRouteGroupSegment(parts[index])) return parts.slice(0, index + 1).join("/");
+  }
+  return null;
+}
+__name(getRouteGroupScope, "getRouteGroupScope");
+function isInRouteGroupScope(directory, scope) {
+  if (scope === null) return true;
+  if (typeof directory !== "string") return false;
+  return directory === scope || directory.startsWith(`${scope}/`);
+}
+__name(isInRouteGroupScope, "isInRouteGroupScope");
+function getRouteDirectoryDepth(pattern) {
+  return pattern.split("/").filter(Boolean).length;
+}
+__name(getRouteDirectoryDepth, "getRouteDirectoryDepth");
+function routeBoundaryCoversDirectory(boundaryPattern, directory) {
+  const boundaryUrl = stripRouteGroups(boundaryPattern);
+  const routeUrl = stripRouteGroups(directory);
+  return (boundaryUrl === "/" || routeUrl === boundaryUrl || routeUrl.startsWith(`${boundaryUrl.replace(/\/$/, "")}/`)) && isInRouteGroupScope(directory, getRouteGroupScope(boundaryPattern));
+}
+__name(routeBoundaryCoversDirectory, "routeBoundaryCoversDirectory");
+
+// src/server/full-document.ts
+var CONTENTS_WRAPPER = /^<div\b[^>]*style="display\s*:\s*contents"[^>]*>/i;
+var HOISTED_HEAD_ELEMENT = /^(?:<(?:meta|link|base)\b[^>]*>|<title\b[^>]*>[\s\S]*?<\/title>|<script\b[^>]*\basync\b[^>]*><\/script>|<style\b[^>]*\bdata-precedence\b[^>]*>[\s\S]*?<\/style>)/i;
+function peelDocumentPrefix(markup) {
+  let inner = markup.replace(/^\s+/, "");
+  let hoisted = "";
+  let match;
+  while (match = CONTENTS_WRAPPER.exec(inner) ?? HOISTED_HEAD_ELEMENT.exec(inner)) {
+    if (!/^<div/i.test(match[0])) hoisted += match[0];
+    inner = inner.slice(match[0].length).replace(/^\s+/, "");
+  }
+  return { inner, hoisted };
+}
+__name(peelDocumentPrefix, "peelDocumentPrefix");
+function restoreHoistedHead(document, hoisted) {
+  if (!hoisted) return document;
+  if (/<head[\s>]/i.test(document)) {
+    return document.replace(/<head\b[^>]*>/i, (open) => open + hoisted);
+  }
+  return document.replace(/<html\b[^>]*>/i, (open) => `${open}<head>${hoisted}</head>`);
+}
+__name(restoreHoistedHead, "restoreHoistedHead");
+function extractFarmFullDocument(markup) {
+  const { inner, hoisted } = peelDocumentPrefix(markup);
+  if (!/^<!doctype/i.test(inner) && !/^<html[\s>]/i.test(inner)) return null;
+  const start = markup.search(/<!doctype|<html[\s>]/i);
+  const lower = markup.toLowerCase();
+  let closeIndex = lower.lastIndexOf("</html>");
+  if (lower.length !== markup.length) {
+    closeIndex = -1;
+    const closing = /<\/html>/gi;
+    let match;
+    while (match = closing.exec(markup)) closeIndex = match.index;
+  }
+  if (start < 0 || closeIndex < 0) return null;
+  const closeEnd = closeIndex + "</html>".length;
+  let document = markup.slice(start, closeEnd);
+  const streamedTail = markup.slice(closeEnd).replace(/^(?:\s*<\/div>)+/i, "").trim();
+  if (streamedTail) {
+    document = document.replace(/<\/body>/i, () => `${streamedTail}</body>`);
+  }
+  return restoreHoistedHead(document, hoisted);
+}
+__name(extractFarmFullDocument, "extractFarmFullDocument");
+function classifyFarmDocumentPrefix(markup) {
+  const { inner } = peelDocumentPrefix(markup);
+  if (/^<!doctype/i.test(inner) || /^<html[\s>]/i.test(inner)) return "document";
+  return inner === "" ? "pending" : "fragment";
+}
+__name(classifyFarmDocumentPrefix, "classifyFarmDocumentPrefix");
+function ensureFarmDocumentHead(markup) {
+  if (/<head[\s>]/i.test(markup)) return markup;
+  return markup.replace(/<html([^>]*)>/i, (_match, attributes) => {
+    return `<html${attributes}><head></head>`;
+  });
+}
+__name(ensureFarmDocumentHead, "ensureFarmDocumentHead");
+function ensureFarmDocumentRoot(markup) {
+  if (/\sid=["']root["']/i.test(markup)) return markup;
+  return markup.replace(
+    /<body\b([^>]*)>/i,
+    (_match, attributes) => `<body${attributes}><div id="root">`
+  ).replace(/<\/body>/i, () => "</div></body>");
+}
+__name(ensureFarmDocumentRoot, "ensureFarmDocumentRoot");
+function hasFarmDocumentIcon(markup) {
+  return /<link\b[^>]*\brel=["']?(?:shortcut )?icon\b/i.test(markup);
+}
+__name(hasFarmDocumentIcon, "hasFarmDocumentIcon");
+function removeFarmDocumentTitles(markup) {
+  return markup.replace(/<title\b[^>]*>[\s\S]*?<\/title>\s*/gi, "");
+}
+__name(removeFarmDocumentTitles, "removeFarmDocumentTitles");
+function ensureFarmDocumentMeta(markup, viewport = "") {
+  const head = /<head\b[^>]*>([\s\S]*?)<\/head>/i.exec(markup)?.[1] ?? "";
+  const hasNamedMeta = /* @__PURE__ */ __name((name) => new RegExp(`<meta\\b[^>]*\\bname=["']?${name}(?=["'\\s/>])`, "i").test(head), "hasNamedMeta");
+  const tags = [
+    /<meta\b[^>]*\bcharset\s*=/i.test(head) ? "" : '<meta charset="utf-8">',
+    ...(viewport.match(/<meta\b[^>]*>/gi) ?? []).filter((tag) => {
+      const name = /\bname="([\w-]+)"/.exec(tag)?.[1];
+      return !name || !hasNamedMeta(name);
+    })
+  ].filter(Boolean);
+  if (tags.length === 0) return markup;
+  return markup.replace(/<head\b[^>]*>/i, (open) => `${open}${tags.join("")}`);
+}
+__name(ensureFarmDocumentMeta, "ensureFarmDocumentMeta");
+function composeFarmFullDocument(documentHtml, assets) {
+  let html = ensureFarmDocumentMeta(ensureFarmDocumentHead(documentHtml), assets.viewport);
+  if (assets.htmlAttributes) {
+    html = html.replace(/<html\b([^>]*)>/i, (_match, attrs) => {
+      let nextAttributes = attrs;
+      for (const name of assets.replaceHtmlAttributes ?? []) {
+        const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        nextAttributes = nextAttributes.replace(
+          new RegExp("\\s+" + escapedName + `=(?:"[^"]*"|'[^']*'|[^\\s>]+)`, "gi"),
+          ""
+        );
+      }
+      return `<html${nextAttributes}${assets.htmlAttributes}>`;
+    });
+  }
+  html = ensureFarmDocumentRoot(html);
+  const headAssets = [
+    assets.fallbackIcon && !hasFarmDocumentIcon(html) ? '<link rel="icon" href="data:,">' : "",
+    assets.headAssets
+  ].filter(Boolean).join("\n  ");
+  if (headAssets) {
+    html = html.replace(/<\/head>/i, () => `  ${headAssets}
+</head>`);
+  }
+  if (assets.bodyFooter) {
+    html = html.replace(/<\/body>/i, () => `  ${assets.bodyFooter}
+</body>`);
+  }
+  return /^\s*<!doctype/i.test(html) ? html : `<!DOCTYPE html>
+${html}`;
+}
+__name(composeFarmFullDocument, "composeFarmFullDocument");
+
 // src/i18n/alternates.ts
 function renderFarmLocaleAlternateLinks(pathname, config, options = {}) {
   if (config.routing === "none") return "";
@@ -228,6 +410,171 @@ function createFarmMetadataRouteResponse(kind, value, routeModule = {}, options
 }
 __name(createFarmMetadataRouteResponse, "createFarmMetadataRouteResponse");
 
+// src/ai-catalog.ts
+var FARM_AI_CATALOG_PATH = "/.well-known/ai-catalog.json";
+var FARM_ARD_PATH = "/.well-known/ard.json";
+var FARM_MCP_SERVER_CARD_SUFFIX = "/server-card";
+var SERVER_CARD_SCHEMA = "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json";
+var SERVER_CARD_TYPE = "application/mcp-server-card+json";
+var AI_CATALOG_TYPE = "application/ai-catalog+json";
+var CARD_DESCRIPTION_MAX = 100;
+var REVERSE_DNS_NAME = /^[a-zA-Z0-9.-]+\/[a-zA-Z0-9._-]+$/;
+function listFarmMCPServerSources(input) {
+  const sources = /* @__PURE__ */ new Map();
+  for (const { server, details } of _listFarmMCPCatalogs()) {
+    const endpoint = resolveFarmAPIServerRoutePath(server.path, input.apiServerBasePath);
+    if (sources.has(endpoint)) continue;
+    sources.set(endpoint, {
+      ...server,
+      protocolVersions: details?.protocolVersions,
+      endpoint,
+      local: true
+    });
+  }
+  for (const server of _listFarmRegisteredMCPServers()) {
+    const endpoint = server.path ? applyFarmBasePath(server.path, input.basePath) : server.url;
+    if (sources.has(endpoint)) continue;
+    sources.set(endpoint, { ...server, endpoint, local: Boolean(server.path) });
+  }
+  return [...sources.values()];
+}
+__name(listFarmMCPServerSources, "listFarmMCPServerSources");
+function serverCardLocation(endpoint) {
+  return `${endpoint.replace(/\/$/, "")}${FARM_MCP_SERVER_CARD_SUFFIX}`;
+}
+__name(serverCardLocation, "serverCardLocation");
+function listFarmMCPServerCards(origin, input = {}) {
+  const host = new URL(origin).hostname;
+  return listFarmMCPServerSources(input).map((server) => {
+    const endpointUrl = server.local ? `${origin}${server.endpoint}` : server.endpoint;
+    const cardPath = server.local ? serverCardLocation(server.endpoint) : void 0;
+    const slug = cardSlug(server.name);
+    const description = truncate(server.description?.trim() || `MCP server for ${host}`);
+    const card = {
+      $schema: SERVER_CARD_SCHEMA,
+      // The card's name is reverse-DNS; a plain server name is namespaced by the host.
+      name: REVERSE_DNS_NAME.test(server.name) ? server.name : `${cardNamespace(host)}/${slug}`,
+      version: server.version,
+      description,
+      ...server.title ? { title: server.title } : {},
+      websiteUrl: `${origin}${applyFarmBasePath("/", input.basePath).replace(/(.)\/$/, "$1")}`,
+      remotes: [
+        {
+          type: "streamable-http",
+          url: endpointUrl,
+          ...server.protocolVersions?.length ? { supportedProtocolVersions: [...server.protocolVersions] } : {}
+        }
+      ]
+    };
+    return {
+      ...cardPath ? { cardPath } : {},
+      card,
+      entry: {
+        identifier: `urn:air:${host}:mcp:${slug}`,
+        type: SERVER_CARD_TYPE,
+        url: cardPath ? `${origin}${cardPath}` : serverCardLocation(endpointUrl),
+        displayName: server.title ?? server.name,
+        description,
+        version: server.version
+      }
+    };
+  });
+}
+__name(listFarmMCPServerCards, "listFarmMCPServerCards");
+function listFarmMCPLlmsTxtLinks(origin, input = {}) {
+  const servers = listFarmMCPServerCards(origin, input);
+  if (!servers.length) return [];
+  return [
+    ...servers.map(({ card, entry }) => ({
+      title: entry.displayName,
+      url: card.remotes[0].url,
+      description: `${card.description} (Streamable HTTP MCP endpoint; server card at ${entry.url})`
+    })),
+    {
+      title: "AI catalog",
+      url: `${origin}${applyFarmBasePath(FARM_AI_CATALOG_PATH, input.basePath)}`,
+      description: "MCP server cards for this site"
+    }
+  ];
+}
+__name(listFarmMCPLlmsTxtLinks, "listFarmMCPLlmsTxtLinks");
+function createFarmAiCatalogResponse(request, input = {}, requestUrl) {
+  let url;
+  try {
+    url = requestUrl ?? new URL(request.url);
+  } catch {
+    return null;
+  }
+  const { pathname } = url;
+  if (!pathname.endsWith(FARM_MCP_SERVER_CARD_SUFFIX) && !pathname.includes("/.well-known/")) {
+    return null;
+  }
+  const ard = pathname === applyFarmBasePath(FARM_ARD_PATH, input.basePath);
+  const catalogPath = ard || pathname === applyFarmBasePath(FARM_AI_CATALOG_PATH, input.basePath);
+  if (!catalogPath && !pathname.endsWith(FARM_MCP_SERVER_CARD_SUFFIX)) return null;
+  const servers = listFarmMCPServerCards(url.origin, input);
+  const card = catalogPath ? void 0 : servers.find((server) => server.cardPath === pathname);
+  if (!servers.length || !catalogPath && !card) return null;
+  const method = request.method.toUpperCase();
+  if (method === "OPTIONS") return new Response(null, { status: 204, headers: corsHeaders() });
+  if (method !== "GET" && method !== "HEAD") {
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { ...corsHeaders(), Allow: "GET, HEAD, OPTIONS", "Content-Type": "text/plain" }
+    });
+  }
+  const body = JSON.stringify(
+    card ? card.card : { specVersion: "1.0", entries: servers.map(({ entry }) => entry) }
+  );
+  const etag = `W/"${fnv1a(body)}"`;
+  const headers = {
+    ...corsHeaders(),
+    "Content-Type": card ? `${SERVER_CARD_TYPE}; charset=utf-8` : ard ? "application/json; charset=utf-8" : `${AI_CATALOG_TYPE}; charset=utf-8`,
+    // The body names the request's origin, so caches revalidate rather than reuse it.
+    "Cache-Control": "public, max-age=0, must-revalidate",
+    ETag: etag,
+    "X-Content-Type-Options": "nosniff"
+  };
+  if (matchesFarmIfNoneMatch(request.headers.get("if-none-match"), etag)) {
+    return new Response(null, { status: 304, headers });
+  }
+  emitFarmAgentRead(request, card ? "mcp-server-card" : "ai-catalog", 200);
+  return new Response(method === "HEAD" ? null : body, { status: 200, headers });
+}
+__name(createFarmAiCatalogResponse, "createFarmAiCatalogResponse");
+function corsHeaders() {
+  return {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, HEAD, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type, If-None-Match",
+    "Access-Control-Expose-Headers": "ETag"
+  };
+}
+__name(corsHeaders, "corsHeaders");
+function cardNamespace(host) {
+  if (host.includes(":") || /^\d+(?:\.\d+){3}$/.test(host)) return "local";
+  return host.split(".").reverse().join(".");
+}
+__name(cardNamespace, "cardNamespace");
+function cardSlug(name) {
+  const last = name.includes("/") ? name.slice(name.lastIndexOf("/") + 1) : name;
+  return last.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "mcp";
+}
+__name(cardSlug, "cardSlug");
+function truncate(text) {
+  return text.length <= CARD_DESCRIPTION_MAX ? text : `${text.slice(0, CARD_DESCRIPTION_MAX - 1).trimEnd()}\u2026`;
+}
+__name(truncate, "truncate");
+function fnv1a(value) {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index++) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+__name(fnv1a, "fnv1a");
+
 // src/components/error-page.ts
 var ERROR_STATUS_TEXT = {
   400: "Bad Request",
@@ -660,10 +1007,25 @@ async function createFarmAppManifestResponse(request, input, options) {
 __name(createFarmAppManifestResponse, "createFarmAppManifestResponse");
 
 export {
+  formatRouteSegment,
+  createRouteDirectoryPattern,
+  stripRouteGroups,
+  getRouteGroupScope,
+  isInRouteGroupScope,
+  getRouteDirectoryDepth,
+  routeBoundaryCoversDirectory,
+  HOISTED_HEAD_ELEMENT,
+  extractFarmFullDocument,
+  classifyFarmDocumentPrefix,
+  removeFarmDocumentTitles,
+  ensureFarmDocumentMeta,
+  composeFarmFullDocument,
   renderFarmLocaleAlternateLinks,
   createLateRedirectRecovery,
   createLateNotFoundRecovery,
   createFarmMetadataRouteResponse,
+  listFarmMCPLlmsTxtLinks,
+  createFarmAiCatalogResponse,
   resolveDefaultErrorStatus,
   getDefaultErrorStatusText,
   createDefaultErrorMarkup,