@farm.js/core 0.1.27 → 0.1.28

package/dist/{chunk-KAERLFD3.cjs → chunk-KOQ555NR.cjs}

@@ -28,7 +28,7 @@ var _chunkPSV6XKPOcjs = require('./chunk-PSV6XKPO.cjs');
 
 
 
-var _chunkDQMTHWPIcjs = require('./chunk-DQMTHWPI.cjs');
+var _chunk55ZY4ZA7cjs = require('./chunk-55ZY4ZA7.cjs');
 
 
 var _chunkYFPGHF5Fcjs = require('./chunk-YFPGHF5F.cjs');
@@ -47,7 +47,7 @@ var _chunkVEKFLAQMcjs = require('./chunk-VEKFLAQM.cjs');
 var _chunkOHY2ZWUGcjs = require('./chunk-OHY2ZWUG.cjs');
 
 
-var _chunkZSO5GWGDcjs = require('./chunk-ZSO5GWGD.cjs');
+var _chunkXSPGWQWAcjs = require('./chunk-XSPGWQWA.cjs');
 
 
 var _chunkUYIHRDE4cjs = require('./chunk-UYIHRDE4.cjs');
@@ -129,13 +129,16 @@ async function resolveFarmMCPPlugin(config, options) {
 _chunkS3JO3N4Hcjs.__name.call(void 0, resolveFarmMCPPlugin, "resolveFarmMCPPlugin");
 
 // src/agent-config.ts
-function resolveFarmAgentConfig(input) {
+var DEFAULT_JSON_LD = { type: "WebSite" };
+function resolveFarmAgentConfig(input, context = {}) {
   const jsonLd = _optionalChain([input, 'optionalAccess', _ => _.jsonLd]);
   return {
-    jsonLd: !jsonLd ? false : jsonLd === true ? {} : jsonLd,
-    noindexPreviews: _chunkDQMTHWPIcjs.resolveFarmNoindexPreviews.call(void 0, _optionalChain([input, 'optionalAccess', _2 => _2.noindexPreviews])),
-    llmsTxt: _chunkDQMTHWPIcjs.resolveFarmLlmsTxtConfig.call(void 0, _optionalChain([input, 'optionalAccess', _3 => _3.llmsTxt])),
-    crawlers: _chunkDQMTHWPIcjs.resolveFarmAgentCrawlers.call(void 0, _optionalChain([input, 'optionalAccess', _4 => _4.crawlers])),
+    jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
+    noindexPreviews: _chunk55ZY4ZA7cjs.resolveFarmNoindexPreviews.call(void 0, _optionalChain([input, 'optionalAccess', _2 => _2.noindexPreviews])),
+    // The docs engine answers /llms.txt with its own pages; a default here would replace it.
+    // llms-full.txt renders every listed page, so it stays opt-in.
+    llmsTxt: _chunk55ZY4ZA7cjs.resolveFarmLlmsTxtConfig.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _3 => _3.llmsTxt]), () => ( (context.docs ? false : { full: false })))),
+    crawlers: _chunk55ZY4ZA7cjs.resolveFarmAgentCrawlers.call(void 0, _optionalChain([input, 'optionalAccess', _4 => _4.crawlers])),
     apiCatalog: resolveFarmApiCatalogEnabled(_optionalChain([input, 'optionalAccess', _5 => _5.apiCatalog]))
   };
 }
@@ -684,9 +687,9 @@ async function resolveConfig(userConfig, mode) {
   const routeRules = _chunkQ5B3KJBPcjs.normalizeRouteRules.call(void 0, userConfig.routeRules);
   const routeRuleRedirects = _chunkQ5B3KJBPcjs.routeRulesToRedirects.call(void 0, routeRules);
   const routeRuleHeaders = _chunkQ5B3KJBPcjs.routeRulesToHeaders.call(void 0, routeRules);
-  const security = _chunkDQMTHWPIcjs.resolveFarmSecurityConfig.call(void 0, userConfig.security);
-  const securityHeader = _chunkDQMTHWPIcjs.getFarmSecurityHeader.call(void 0, security);
-  if (_chunkDQMTHWPIcjs.farmCspBlocksFrameworkInlineScripts.call(void 0, security)) {
+  const security = _chunk55ZY4ZA7cjs.resolveFarmSecurityConfig.call(void 0, userConfig.security);
+  const securityHeader = _chunk55ZY4ZA7cjs.getFarmSecurityHeader.call(void 0, security);
+  if (_chunk55ZY4ZA7cjs.farmCspBlocksFrameworkInlineScripts.call(void 0, security)) {
     _chunk5QIKR7RRcjs.logger.warn(
       "security.csp blocks the inline scripts Farm injects for theming and hydration. Set security.csp.nonce to true for managed dynamic nonces and prerendered hashes, or make the governing script directive allow 'unsafe-inline' without a nonce, hash, or 'strict-dynamic' source."
     );
@@ -695,7 +698,7 @@ async function resolveConfig(userConfig, mode) {
   const root = userConfig.root || process.cwd();
   const srcDir = userConfig.srcDir || "src";
   const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
-  const md = _chunkZSO5GWGDcjs.resolveMarkdownConfig.call(void 0, userConfig.md);
+  const md = _chunkXSPGWQWAcjs.resolveMarkdownConfig.call(void 0, userConfig.md);
   const mdx = _chunkOHY2ZWUGcjs.resolveMdxConfig.call(void 0, userConfig.mdx);
   const env = _chunkVEKFLAQMcjs.resolveEnv.call(void 0, userConfig.env, process.env);
   _chunkVEKFLAQMcjs.setEnv.call(void 0, env);
@@ -769,7 +772,7 @@ async function resolveConfig(userConfig, mode) {
       ppr: false,
       ...userConfig.experimental
     },
-    agent: resolveFarmAgentConfig(userConfig.agent),
+    agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
     plugins: [
       ..._chunkZ5HIWVDPcjs.resolveIntegrationPlugins.call(void 0, integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
@@ -786,7 +789,7 @@ async function resolveConfig(userConfig, mode) {
     ], "headers"),
     routeRules,
     images: _chunkYFPGHF5Fcjs.resolveFarmImageConfig.call(void 0, userConfig.images),
-    performance: _chunkDQMTHWPIcjs.resolveFarmPerformanceConfig.call(void 0, userConfig.performance),
+    performance: _chunk55ZY4ZA7cjs.resolveFarmPerformanceConfig.call(void 0, userConfig.performance),
     theme: _chunkOI6CMLWXcjs.resolveFarmThemeConfig.call(void 0, userConfig.theme, basePath),
     publicDir: userConfig.publicDir || "public",
     i18n: _chunkHBTUGXHScjs.resolveFarmI18nConfig.call(void 0, userConfig.i18n, { root, mode, basePath }),

package/dist/{chunk-O2LV5XDG.mjs → chunk-KXGDXYUC.mjs}

@@ -6,10 +6,10 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteConflictError
-} from "./chunk-Q4BHBO6V.mjs";
+} from "./chunk-BXFWA23T.mjs";
 import {
   findProgrammaticRouteFilesInDir
-} from "./chunk-YOYF2E4U.mjs";
+} from "./chunk-LNZ7JZUS.mjs";
 import {
   isFarmAPIRouteFileName
 } from "./chunk-CU625VAY.mjs";
@@ -19,7 +19,7 @@ import {
   invokeAPIRouteEndpoint,
   matchAPIRouteAtBasePath,
   resolveAPIRouteEndpoint
-} from "./chunk-6EG7U4NF.mjs";
+} from "./chunk-X7WVQMIB.mjs";
 import {
   isProgrammaticRoutesFileName
 } from "./chunk-EA5K5BKU.mjs";

package/dist/{chunk-3IL5UC5I.cjs → chunk-KZLND3D2.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 _chunkWM6HL7E7cjs = require('./chunk-WM6HL7E7.cjs');
+var _chunkZHVYQL3Hcjs = require('./chunk-ZHVYQL3H.cjs');
 
 
 var _chunkHBTUGXHScjs = require('./chunk-HBTUGXHS.cjs');
@@ -415,7 +415,7 @@ function farmMiddlewarePlugin(options = {}) {
       mode: server.config.mode === "production" ? "production" : "development",
       basePath: _nullishCoalesce(options.basePath, () => ( "/"))
     });
-    manager = new (0, _chunkWM6HL7E7cjs.MiddlewareManager)(
+    manager = new (0, _chunkZHVYQL3Hcjs.MiddlewareManager)(
       getMiddlewareAppDirectory(server.config.root, srcDir),
       server,
       void 0,

package/dist/{chunk-NPFGGBM5.cjs → chunk-MH24QDVJ.cjs}

@@ -3,14 +3,14 @@
 
 
 
-var _chunkQI7WQSMIcjs = require('./chunk-QI7WQSMI.cjs');
+var _chunkVQXDC5UVcjs = require('./chunk-VQXDC5UV.cjs');
 
 
 
 var _chunkIK6LVLKCcjs = require('./chunk-IK6LVLKC.cjs');
 
 
-var _chunkKAERLFD3cjs = require('./chunk-KAERLFD3.cjs');
+var _chunkKOQ555NRcjs = require('./chunk-KOQ555NR.cjs');
 
 
 var _chunk75WGQVQAcjs = require('./chunk-75WGQVQA.cjs');
@@ -39,7 +39,7 @@ function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
     ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
-    contentDir: _chunkQI7WQSMIcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+    contentDir: _chunkVQXDC5UVcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterRuntimeConfig, "createFarmDocsAdapterRuntimeConfig");
@@ -274,25 +274,25 @@ function getDocsDescription(docs) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getDocsDescription, "getDocsDescription");
 function getLoadedDocsPages(context) {
-  return _chunkQI7WQSMIcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkQI7WQSMIcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+  return _chunkVQXDC5UVcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkVQXDC5UVcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getLoadedDocsPages, "getLoadedDocsPages");
 function toDocsSourcePage(page) {
   return {
-    ..._chunkQI7WQSMIcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkVQXDC5UVcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSourcePage, "toDocsSourcePage");
 function toDocsSitemapPage(page) {
   return {
-    ..._chunkQI7WQSMIcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkVQXDC5UVcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSitemapPage, "toDocsSitemapPage");
 function toDocsLlmsPage(page) {
-  return _chunkQI7WQSMIcjs.toFarmDocsMarkdownPage.call(void 0, page);
+  return _chunkVQXDC5UVcjs.toFarmDocsMarkdownPage.call(void 0, page);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsLlmsPage, "toDocsLlmsPage");
 function getDocsLlmsOptions(context, request) {
@@ -386,7 +386,7 @@ _chunkS3JO3N4Hcjs.__name.call(void 0, renderAgentsDocument, "renderAgentsDocumen
 function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
-  const pages = _chunkQI7WQSMIcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkVQXDC5UVcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const spec = _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
   const title = getDocsTitle(context.docs);
   return {
@@ -428,7 +428,7 @@ function buildAgentSpec(context, request) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, buildAgentSpec, "buildAgentSpec");
 function buildDiagnostics(context) {
-  const pages = _chunkQI7WQSMIcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkVQXDC5UVcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const diagnostics = _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsDiagnostics(context.docs.config, {
     entry: context.docs.entry,
     mcp: {
@@ -500,12 +500,12 @@ async function resolveAPIContext(options) {
     config: options.config,
     configPath: options.configPath
   }));
-  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkKAERLFD3cjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkKOQ555NRcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
   return {
     root,
     srcDir,
     docs,
-    contentDir: _chunkQI7WQSMIcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
+    contentDir: _chunkVQXDC5UVcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, resolveAPIContext, "resolveAPIContext");
@@ -568,10 +568,10 @@ 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 = _chunkQI7WQSMIcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    const page = _chunkVQXDC5UVcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
     if (!page) return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
     return text(
-      _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkQI7WQSMIcjs.toFarmDocsMarkdownPage.call(void 0, page), {
+      _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkVQXDC5UVcjs.toFarmDocsMarkdownPage.call(void 0, page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap

package/dist/{chunk-TKDY6AJP.mjs → chunk-MKMBQSNQ.mjs}

@@ -7,7 +7,7 @@ import {
   notifyHistoryChange,
   readPageState,
   subscribeHistoryChange
-} from "./chunk-6D242YGO.mjs";
+} from "./chunk-JATSG2ZO.mjs";
 import {
   getFarmI18nClientState
 } from "./chunk-TOVMYGYW.mjs";

package/dist/{chunk-OCE65DDM.mjs → chunk-MNUGPHLN.mjs}

@@ -1,6 +1,6 @@
 import {
   MiddlewareManager
-} from "./chunk-TIKNUAU7.mjs";
+} from "./chunk-VUMAE7NC.mjs";
 import {
   resolveFarmI18nConfig
 } from "./chunk-YMCXWPWK.mjs";

package/dist/{chunk-3PTVHMLD.mjs → chunk-NVBS5WSZ.mjs}

@@ -1,6 +1,6 @@
 import {
   createFarmMarkdownRouteModule
-} from "./chunk-MBFURXAC.mjs";
+} from "./chunk-2DLN6HG4.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";

package/dist/chunk-NYJMY3JA.cjs

@@ -0,0 +1,156 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/cache-key.ts
+function createRouteDataCacheKey(key) {
+  return createFarmCacheKey(Array.isArray(key) ? key : [key]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createRouteDataCacheKey, "createRouteDataCacheKey");
+function createFarmCacheKey(parts) {
+  return stableSerialize(parts);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createFarmCacheKey, "createFarmCacheKey");
+function getFunctionCacheIdentity(fn) {
+  const name = fn.name || "anonymous";
+  return `${name}:${hashFunctionSource(String(fn))}`;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getFunctionCacheIdentity, "getFunctionCacheIdentity");
+function hashFunctionSource(source) {
+  let hash = 2166136261;
+  for (let index = 0; index < source.length; index++) {
+    hash ^= source.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(36);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, hashFunctionSource, "hashFunctionSource");
+function compareCodepoint(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, compareCodepoint, "compareCodepoint");
+function serializeBinaryBytes(bytes) {
+  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, serializeBinaryBytes, "serializeBinaryBytes");
+function serializeCanonicalStringEntries(entries, seen) {
+  const valuesByKey = /* @__PURE__ */ new Map();
+  for (const [key, item] of entries) {
+    const values = valuesByKey.get(key);
+    if (values) values.push(item);
+    else valuesByKey.set(key, [item]);
+  }
+  return Array.from(valuesByKey.keys()).sort(compareCodepoint).flatMap(
+    (key) => valuesByKey.get(key).map((item) => `[${stableSerialize(key, seen)},${stableSerialize(item, seen)}]`)
+  ).join(",");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, serializeCanonicalStringEntries, "serializeCanonicalStringEntries");
+function isPlainCacheKeyObject(value) {
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype === null) return true;
+  const constructor = _optionalChain([Object, 'access', _ => _.getOwnPropertyDescriptor, 'call', _2 => _2(prototype, "constructor"), 'optionalAccess', _3 => _3.value]);
+  return Object.getPrototypeOf(prototype) === null && typeof constructor === "function" && constructor.name === "Object";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isPlainCacheKeyObject, "isPlainCacheKeyObject");
+function getCacheKeyValueType(value) {
+  const prototype = Object.getPrototypeOf(value);
+  const constructor = prototype ? _optionalChain([Object, 'access', _4 => _4.getOwnPropertyDescriptor, 'call', _5 => _5(prototype, "constructor"), 'optionalAccess', _6 => _6.value]) : void 0;
+  if (typeof constructor === "function" && constructor.name) {
+    return constructor.name;
+  }
+  return Object.prototype.toString.call(value).slice(8, -1) || "object";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getCacheKeyValueType, "getCacheKeyValueType");
+function stableSerialize(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  const valueType = typeof value;
+  if (valueType === "string") return JSON.stringify(value);
+  if (valueType === "number" || valueType === "boolean" || valueType === "bigint") {
+    return `${valueType}:${String(value)}`;
+  }
+  if (valueType === "symbol") {
+    return `symbol:${String(value)}`;
+  }
+  if (valueType === "function") {
+    return `function:${getFunctionCacheIdentity(value)}`;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "date:invalid" : `date:${value.toISOString()}`;
+  }
+  if (value instanceof URL) {
+    return `url:${value.toString()}`;
+  }
+  if (value instanceof RegExp) {
+    return `regexp:${value.toString()}`;
+  }
+  if (value instanceof ArrayBuffer) {
+    return `arraybuffer:${serializeBinaryBytes(new Uint8Array(value))}`;
+  }
+  if (typeof SharedArrayBuffer !== "undefined" && value instanceof SharedArrayBuffer) {
+    return `sharedarraybuffer:${serializeBinaryBytes(new Uint8Array(value))}`;
+  }
+  if (ArrayBuffer.isView(value)) {
+    const viewType = Object.prototype.toString.call(value).slice(8, -1);
+    const bytes = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    return `binary:${viewType}:${serializeBinaryBytes(bytes)}`;
+  }
+  if (value && typeof value === "object") {
+    if (seen.has(value)) {
+      return "[Circular]";
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+      const items = [];
+      for (let index = 0; index < value.length; index++) {
+        items.push(
+          Object.prototype.hasOwnProperty.call(value, index) ? stableSerialize(value[index], seen) : "[Hole]"
+        );
+      }
+      seen.delete(value);
+      return `[${items.join(",")}]`;
+    }
+    if (value instanceof Set) {
+      const items = Array.from(value, (item) => stableSerialize(item, seen)).sort(compareCodepoint);
+      seen.delete(value);
+      return `set:[${items.join(",")}]`;
+    }
+    if (value instanceof Map) {
+      const items = Array.from(
+        value,
+        ([key, item]) => `[${stableSerialize(key, seen)},${stableSerialize(item, seen)}]`
+      ).sort(compareCodepoint);
+      seen.delete(value);
+      return `map:[${items.join(",")}]`;
+    }
+    if (value instanceof URLSearchParams) {
+      const serialized2 = serializeCanonicalStringEntries(value, seen);
+      seen.delete(value);
+      return `urlsearchparams:[${serialized2}]`;
+    }
+    if (value instanceof Headers) {
+      const serialized2 = serializeCanonicalStringEntries(value, seen);
+      seen.delete(value);
+      return `headers:[${serialized2}]`;
+    }
+    if (!isPlainCacheKeyObject(value)) {
+      throw new TypeError(
+        `Cache keys do not support ${getCacheKeyValueType(value)} values. Convert the value to an explicit stable string or structured key before caching.`
+      );
+    }
+    const entries = Object.entries(value).sort(
+      ([a], [b]) => compareCodepoint(a, b)
+    );
+    const serialized = entries.map(([key, item]) => `${JSON.stringify(key)}:${stableSerialize(item, seen)}`).join(",");
+    seen.delete(value);
+    return `{${serialized}}`;
+  }
+  return String(value);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, stableSerialize, "stableSerialize");
+
+
+
+
+
+exports.createRouteDataCacheKey = createRouteDataCacheKey; exports.createFarmCacheKey = createFarmCacheKey; exports.getFunctionCacheIdentity = getFunctionCacheIdentity;

package/dist/{chunk-VVJCWBIE.mjs → chunk-O3DTUAX2.mjs}

@@ -26,13 +26,13 @@ import {
 } from "./chunk-DAATZTKJ.mjs";
 import {
   discoverProgrammaticRoutePaths
-} from "./chunk-YOYF2E4U.mjs";
+} from "./chunk-LNZ7JZUS.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-FV45CKBC.mjs";
 import {
   resolvePluginRoutes
-} from "./chunk-SYGGPS4A.mjs";
+} from "./chunk-4IEPYMHF.mjs";
 import {
   parseRoutePath
 } from "./chunk-KI3MESHB.mjs";

package/dist/{chunk-C7OUJ6JI.cjs → chunk-PZNCMPJF.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkI4J452B7cjs = require('./chunk-I4J452B7.cjs');
+var _chunkVHJGDMCGcjs = require('./chunk-VHJGDMCG.cjs');
 
 
 var _chunkWMAPPDMMcjs = require('./chunk-WMAPPDMM.cjs');
@@ -64,7 +64,7 @@ function mergePluginAPIRoutes(existing, plugins, expected, options = {}) {
     });
   }
   const api = createPluginLocalAPI(existing, options.bodySizeLimit);
-  for (const definition of _chunkI4J452B7cjs.resolvePluginRoutes.call(void 0, plugins, { api })) {
+  for (const definition of _chunkVHJGDMCGcjs.resolvePluginRoutes.call(void 0, plugins, { api })) {
     _chunkWMAPPDMMcjs.registerAPIRouteShape.call(void 0, shapes, definition.path, `plugin:${definition.path}`, "app");
     let route = routes.get(definition.path);
     if (_optionalChain([route, 'optionalAccess', _ => _.methods, 'access', _2 => _2.includes, 'call', _3 => _3(definition.method)])) {
@@ -256,7 +256,7 @@ async function invokeAPIRouteEndpointInContext(endpoint, request, params) {
       invalidations: []
     };
   } catch (error) {
-    if (_chunkI4J452B7cjs.isEndpointFailure.call(void 0, error)) {
+    if (_chunkVHJGDMCGcjs.isEndpointFailure.call(void 0, error)) {
       return createEndpointFailureResponse(error);
     }
     throw error;

package/dist/{chunk-WIVTGKLY.mjs → chunk-PZPDGOU5.mjs}

@@ -28,7 +28,7 @@ import {
   resolveFarmNoindexPreviews,
   resolveFarmPerformanceConfig,
   resolveFarmSecurityConfig
-} from "./chunk-JT25KHDI.mjs";
+} from "./chunk-REGFZJEJ.mjs";
 import {
   resolveFarmImageConfig
 } from "./chunk-G2KY33I6.mjs";
@@ -47,7 +47,7 @@ import {
 } from "./chunk-FA2W42OV.mjs";
 import {
   resolveMarkdownConfig
-} from "./chunk-POXI72VV.mjs";
+} from "./chunk-K3YEZLSY.mjs";
 import {
   bundleNodeModule
 } from "./chunk-SFGWNC43.mjs";
@@ -129,12 +129,15 @@ async function resolveFarmMCPPlugin(config, options) {
 __name(resolveFarmMCPPlugin, "resolveFarmMCPPlugin");
 
 // src/agent-config.ts
-function resolveFarmAgentConfig(input) {
+var DEFAULT_JSON_LD = { type: "WebSite" };
+function resolveFarmAgentConfig(input, context = {}) {
   const jsonLd = input?.jsonLd;
   return {
-    jsonLd: !jsonLd ? false : jsonLd === true ? {} : jsonLd,
+    jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
     noindexPreviews: resolveFarmNoindexPreviews(input?.noindexPreviews),
-    llmsTxt: resolveFarmLlmsTxtConfig(input?.llmsTxt),
+    // The docs engine answers /llms.txt with its own pages; a default here would replace it.
+    // 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)
   };
@@ -769,7 +772,7 @@ async function resolveConfig(userConfig, mode) {
       ppr: false,
       ...userConfig.experimental
     },
-    agent: resolveFarmAgentConfig(userConfig.agent),
+    agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
     plugins: [
       ...resolveIntegrationPlugins(integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],

package/dist/{chunk-52SH7TKB.mjs → chunk-QG5HNS7P.mjs}

@@ -1,9 +1,9 @@
 import {
   useRouter
-} from "./chunk-TKDY6AJP.mjs";
+} from "./chunk-MKMBQSNQ.mjs";
 import {
   getRouter
-} from "./chunk-6D242YGO.mjs";
+} from "./chunk-JATSG2ZO.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-4RB44K6Z.mjs";

package/dist/{chunk-CEYUWDWA.mjs → chunk-QZCT2CQ4.mjs}

@@ -182,7 +182,10 @@ function renderMetadataHead(metadata, options = {}) {
     );
   }
   appendNamedMetaRecord(tags, resolvedMetadata.other);
-  appendOpenGraph(tags, resolvedMetadata.openGraph, metadataBase);
+  appendOpenGraph(tags, resolvedMetadata.openGraph, metadataBase, {
+    title: explicitTitle,
+    description: resolvedMetadata.description
+  });
   appendTwitter(tags, resolvedMetadata.twitter, metadataBase);
   appendVerification(tags, resolvedMetadata.verification);
   if (options.jsonLd) {
@@ -220,10 +223,12 @@ function mergeNestedMetadata(base, next) {
   return next ?? base;
 }
 __name(mergeNestedMetadata, "mergeNestedMetadata");
-function appendOpenGraph(tags, openGraph, metadataBase) {
-  if (!isRecord(openGraph)) return;
-  appendMetaProperty(tags, "og:title", openGraph.title);
-  appendMetaProperty(tags, "og:description", openGraph.description);
+function appendOpenGraph(tags, input, metadataBase, page) {
+  const description = typeof page.description === "string" ? page.description : void 0;
+  if (!isRecord(input) && !page.title && !description) return;
+  const openGraph = isRecord(input) ? input : {};
+  appendMetaProperty(tags, "og:title", openGraph.title ?? page.title);
+  appendMetaProperty(tags, "og:description", openGraph.description ?? description);
   appendMetaProperty(tags, "og:url", resolveMetadataUrl(openGraph.url, metadataBase));
   appendMetaProperty(tags, "og:site_name", openGraph.siteName);
   appendMetaProperty(tags, "og:type", openGraph.type ?? "website");

package/dist/{chunk-JT25KHDI.mjs → chunk-REGFZJEJ.mjs}

@@ -2,7 +2,7 @@ import {
   getFarmMarkdownMirrorPath,
   isFarmMarkdownMirrorExposed,
   matchesFarmMarkdownRoutePattern
-} from "./chunk-POXI72VV.mjs";
+} from "./chunk-K3YEZLSY.mjs";
 import {
   FARM_INTERNAL_READ_HEADER
 } from "./chunk-MVL2RAJW.mjs";

package/dist/{chunk-QMV4QELL.mjs → chunk-S5GDHOE4.mjs}

@@ -9,10 +9,12 @@ import {
   normalizeFarmRouteRuntimeConfig
 } from "./chunk-2J7W2WND.mjs";
 import {
-  createFarmCacheKey,
   createRouteDataCacheTag,
   getFarmDataCache
-} from "./chunk-F6SJAKFJ.mjs";
+} from "./chunk-IV6CQY7O.mjs";
+import {
+  createFarmCacheKey
+} from "./chunk-CNOQY6Z7.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";