@farm.js/core 0.1.31 → 0.1.35

package/dist/internal/production-runtime.d.ts

@@ -1,23 +1,23 @@
 export { _runWithAfterRequest } from '../after.js';
-export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-D4XpMjam.js';
-import { R as ResolvedFarmServerConfig } from '../workflows-CR9ex-gz.js';
-export { a as FarmServerConfig, b as bufferFarmRequestBody, c as cloneFarmRequestWithContext, d as createFarmNodeRequestAbortSignal, e as createFarmRequestBodyErrorResponse, m as matchesFarmIfNoneMatch, r as readFarmRequestBody, f as readNodeRequestBody, g as resolveFarmServerConfig } from '../workflows-CR9ex-gz.js';
-export { _ as _runWithCurrentRequest, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-BcY4RYPC.js';
-import { aN as APIRequestRuntime, aO as ResolvedFarmMCPConfig, J as FarmConfig, $ as FarmContextFactoryInput } from '../client-plugins-BmxM5KW_.js';
-export { aX as FarmLlmsTxtUserConfig, aY as ResolvedFarmLlmsTxtConfig, b1 as applyFarmCspNonceToResponse, aR as collectFarmLlmsTxtPages, aQ as createFarmAgentRobots, aS as createFarmDefaultLlmsTxt, aV as createFarmLlmsFullRenderer, aT as createFarmLlmsMarkdownReader, aP as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, aZ as manageFarmDocumentPreloads, a_ as manageFarmHtmlPreloads, a$ as manageFarmLinkHeaderPreloads, aU as renderFarmLlmsFullTxt, b0 as reportFarmPreloadWarnings, aW as resolveFarmLlmsTxtConfig, b2 as resolveFarmSecurityConfig } from '../client-plugins-BmxM5KW_.js';
+import { aH as FarmMCPCatalogDetails, fM as APIRequestRuntime, bT as ResolvedFarmMCPConfig, fN as FarmLlmsTxtLink, J as FarmConfig, $ as FarmContextFactoryInput } from '../client-plugins-HIyulDym.js';
+export { fW as FarmLlmsTxtUserConfig, fX as ResolvedFarmLlmsTxtConfig, g0 as applyFarmCspNonceToResponse, fQ as collectFarmLlmsTxtPages, fP as createFarmAgentRobots, fR as createFarmDefaultLlmsTxt, fU as createFarmLlmsFullRenderer, fS as createFarmLlmsMarkdownReader, fO as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, fY as manageFarmDocumentPreloads, fZ as manageFarmHtmlPreloads, f_ as manageFarmLinkHeaderPreloads, aG as registerFarmMCPServer, fT as renderFarmLlmsFullTxt, f$ as reportFarmPreloadWarnings, fV as resolveFarmLlmsTxtConfig, g1 as resolveFarmSecurityConfig } from '../client-plugins-HIyulDym.js';
+export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-lS5nUMua.js';
+import { R as ResolvedFarmServerConfig } from '../workflows-jZ4BcdoZ.js';
+export { a as FarmServerConfig, y as bufferFarmRequestBody, z as cloneFarmRequestWithContext, A as createFarmNodeRequestAbortSignal, B as createFarmRequestBodyErrorResponse, C as matchesFarmIfNoneMatch, E as readFarmRequestBody, G as readNodeRequestBody, H as resolveFarmServerConfig } from '../workflows-jZ4BcdoZ.js';
+export { _ as _getRequestReadCount, a as _runWithCurrentRequest, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-B5G8rLBH.js';
 export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.js';
-import { g as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from '../types-Z0aotQ8w.js';
-export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-PPEeiJ6M.js';
-import { F as FarmLocalePathConfig } from '../index-BWVfxIsO.js';
-export { l as localizeFarmHref, a as localizeFarmPathname, s as stripFarmLocaleFromPathname } from '../index-BWVfxIsO.js';
-export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, m as mergeMetadata, r as renderMetadataHead, c as resolveFarmNotFoundMetadata } from '../metadata-fwZ3gfG6.js';
-export { _ as _runWithMiddlewareContext, b as _runWithMiddlewareData, a as applyProductionMiddlewareHeaders, c as createProductionMiddlewareRunner } from '../production-runtime-DNkpFnmg.js';
-export { c as configureFarmObservability, e as emitFarmEvent, r as runWithFarmRequestSpan } from '../observability-BupkiN0m.js';
+import { k as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from '../types-CnH8DOqo.js';
+export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-DadfRL6F.js';
+import { F as FarmLocalePathConfig } from '../index-CwoOP-MW.js';
+export { l as localizeFarmHref, a as localizeFarmPathname, s as stripFarmLocaleFromPathname } from '../index-CwoOP-MW.js';
+export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, m as mergeMetadata, c as mergeModuleViewport, r as renderMetadataHead, d as renderViewportHead, e as resolveFarmNotFoundMetadata } from '../metadata-BnLDsUOS.js';
+export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-Crq6CJ-2.js';
+export { L as configureFarmObservability, P as emitFarmEvent, Q as runWithFarmRequestSpan } from '../observability-CoXunYhS.js';
 export { f as createFarmInstrumentationLifecycle, r as resolveFarmInstrumentationRuntime } from '../instrumentation-runtime-CE06JLHZ.js';
 export { _setDefaultFarmThemeConfig, getTheme } from '../theme/server.js';
 import { c as FarmThemeRuntime, d as FarmThemeConfig, R as ResolvedFarmThemeConfig, a as FarmThemePreference } from '../types-DQnyD3VD.js';
 export { d as applyFarmBasePath, r as resolveFarmTrailingSlashRedirect, s as searchParamsToObject, b as setFarmBasePath, a as setFarmTrailingSlashPreference, c as stripFarmBasePath } from '../base-path-BU16ETmo.js';
-export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-DMD1Hzta.js';
+export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-BXLmFsVR.js';
 import 'node:http';
 import '../lifecycle-DK06VuKP.js';
 import '../integration-api-BPJo5oXb.js';
@@ -35,7 +35,6 @@ import 'unstorage';
 import '../schema.js';
 import 'react';
 import '@farming-labs/orm';
-import '../types-DFbjpjXX.js';
 import '@farming-labs/docs';
 import 'vite';
 import '../cron.js';
@@ -48,6 +47,113 @@ import '../font.js';
 import '../island-CfGru1MO.js';
 import '@opentelemetry/api';
 
+interface FarmAppManifestWebMCPTool {
+    name: string;
+    title?: string;
+    description?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    /** The input JSON Schema when the source writes it out; omitted when it's computed. */
+    inputSchema?: Record<string, unknown>;
+    /** `"computed"` when the schema is built at runtime, so it can't be read from source. */
+    inputSchemaSource: "literal" | "computed" | "none";
+}
+
+/**
+ * `/.well-known/farmjs`: one document describing a Farm app, so tools can discover it
+ * instead of each rebuilding the picture: Farm's version, renderer and packages, the app's
+ * MCP servers with every tool (however it was defined) and its schemas, their resources and
+ * prompts, its WebMCP browser tools, its integrations, its agent surfaces and its plugins.
+ * Never environment values, settings or secrets.
+ *
+ * Development serves it to anyone on the dev server. Production answers only a request
+ * signed for the app's Farm Infra key, so the public never reads the app's internals; any
+ * other request gets a 404. Kept free of Node built-ins: Web Crypto only.
+ */
+
+type FarmAppManifestToolSource = "endpoint" | "defineTool" | "serverFunction";
+interface FarmAppManifestTool {
+    name: string;
+    title?: string;
+    description?: string;
+    /** How the app defined it: an API endpoint, `defineTool`, or a server function. */
+    source: FarmAppManifestToolSource;
+    /** The endpoint's method and route, for `source: "endpoint"`. */
+    method?: string;
+    path?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    /** JSON Schemas, when the server published them (`@farm.js/mcp` does). */
+    inputSchema?: Readonly<Record<string, unknown>>;
+    outputSchema?: Readonly<Record<string, unknown>>;
+}
+type ServerDetails = NonNullable<FarmMCPCatalogDetails>;
+interface FarmAppManifest {
+    schemaVersion: 1;
+    app: {
+        farm: string;
+        renderer: string;
+        basePath: string;
+        build: string;
+    };
+    /** Installed versions of the app's `@farm.js/*` and `@farming-labs/*` packages. */
+    packages: Record<string, string>;
+    mcp: {
+        servers: {
+            name: string;
+            version: string;
+            path: string;
+            tools: FarmAppManifestTool[];
+            resources: NonNullable<ServerDetails["resources"]>;
+            prompts: NonNullable<ServerDetails["prompts"]>;
+        }[];
+    };
+    /** Browser tools from `@farm.js/webmcp`, read from the app's source. */
+    webmcp: {
+        enabled: boolean;
+        tools: FarmAppManifestWebMCPTool[];
+    };
+    /** The app's integrations: which slot each fills and which provider, never their config. */
+    integrations: {
+        key: string;
+        category: string;
+        type: string;
+    }[];
+    agent: {
+        apiCatalog: string | null;
+        llmsTxt: boolean;
+        openapi: string | null;
+    };
+    plugins: string[];
+}
+/** What the manifest reads from config; serializable, so a production build embeds it. */
+interface FarmAppManifestInput {
+    renderer: string;
+    basePath: string;
+    /** The build's ID, or "development". */
+    build: string;
+    packages: Record<string, string>;
+    webmcp: FarmAppManifest["webmcp"];
+    integrations: FarmAppManifest["integrations"];
+    agent: FarmAppManifest["agent"];
+    plugins: string[];
+    /** `analytics: false` keeps the production manifest off: the app talks to no Farm Infra. */
+    analytics: boolean;
+}
+type Env = Record<string, string | undefined>;
+/**
+ * Answers `/.well-known/farmjs`, or `null` to let the request go on as if Farm served nothing
+ * there: methods other than GET and HEAD, and production apps not linked to Farm Infra.
+ */
+declare function createFarmAppManifestResponse(request: Request, input: FarmAppManifestInput, options: {
+    development: boolean;
+    env?: Env;
+}): Promise<Response | null>;
+
 /**
  * Compare a caller-supplied secret against the configured one without leaking
  * how much of it matched.
@@ -63,10 +169,23 @@ import '@opentelemetry/api';
  */
 declare function farmSecretsMatch(provided: string, expected: string): boolean;
 
-/** Internal: the production builder owns these immutable, depth-ordered descriptors. */
+/**
+ * Internal: the production builder owns these immutable, depth-ordered descriptors.
+ *
+ * A layout's pattern is its directory, so a route group stays in it (`/(auth)`).
+ * The URL decides whether a layout covers a pathname; a layout inside a group also
+ * needs the selected page to sit in that group. `resolveRouteDirectory` finds that
+ * page's directory, and runs only when such a layout's URL matches.
+ */
 declare function createFarmLayoutSelector<T extends {
     pattern: string;
-}>(layouts: readonly T[]): (pathname: string) => T[];
+}>(layouts: readonly T[], resolveRouteDirectory?: (pathname: string) => string | null | undefined): (pathname: string, routeDirectory?: string | null) => T[];
+
+/**
+ * Whether a page directory sits inside a group scope. A null scope covers every page;
+ * a missing directory (no page matched) is inside no group.
+ */
+declare function isInRouteGroupScope(directory: string | null | undefined, scope: string | null): boolean;
 
 type FarmProductionLifecycleState = "starting" | "ready" | "draining" | "failed" | "closed";
 interface FarmProductionLifecycleOptions {
@@ -152,6 +271,14 @@ interface FarmLocaleAlternateLinkOptions {
  */
 declare function renderFarmLocaleAlternateLinks(pathname: string, config: FarmLocalePathConfig, options?: FarmLocaleAlternateLinkOptions): string;
 
+/**
+ * Start the head with `<meta charset>` and the viewport tags, as Next.js always renders both,
+ * skipping each one the layout's document already writes (a viewport, theme-color, or
+ * color-scheme tag of its own). The charset comes first because browsers only look for it in the
+ * document's first 1024 bytes. The production server uses this same function.
+ */
+declare function ensureFarmDocumentMeta(markup: string, viewport?: string): string;
+
 /**
  * Runtime source that remounts the top-level `mcp` configuration in a built server.
  *
@@ -179,6 +306,26 @@ declare function _isFarmOwnedResponse(response: Response): boolean;
  */
 declare function _withFarmResponseHeaders(response: Response, edit: (headers: Headers) => void): Response;
 
+interface FarmAiCatalogInput {
+    /** The app's basePath; the catalog lives beneath it, like the API catalog. */
+    basePath?: string;
+    /** The app's public API path, which maps to Farm's canonical `/api`. */
+    apiServerBasePath?: string;
+}
+/**
+ * The llms.txt links for the app's MCP servers: each endpoint, then the catalog
+ * that lists their cards. Empty when the app mounts no MCP server.
+ */
+declare function listFarmMCPLlmsTxtLinks(origin: string, input?: FarmAiCatalogInput): FarmLlmsTxtLink[];
+/**
+ * Answers `/.well-known/ai-catalog.json`, `/.well-known/ard.json`, and each
+ * `<endpoint>/server-card`, or returns `null` for any other request and when
+ * the app mounts no MCP server, so the request goes on as if Farm served nothing.
+ * Every request passes through here; `requestUrl`, the caller's parse of
+ * `request.url`, saves parsing it again.
+ */
+declare function createFarmAiCatalogResponse(request: Request, input?: FarmAiCatalogInput, requestUrl?: URL): Response | null;
+
 /**
  * `/.well-known/api-catalog` (RFC 9727): a Linkset listing the APIs an app
  * publishes, so an agent that knows only the origin can find the OpenAPI
@@ -277,4 +424,4 @@ declare function appendFarmRedirectQuery(destination: string, search: string): s
 
 declare function appendFarmLinkHeader(headers: Headers, value: string): void;
 
-export { _isFarmOwnedResponse, _markFarmOwnedResponse, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, createDefaultErrorMarkup, createFarmApiCatalogResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };
+export { _isFarmOwnedResponse, _markFarmOwnedResponse, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, createDefaultErrorMarkup, createFarmAiCatalogResponse, createFarmApiCatalogResponse, createFarmAppManifestResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, ensureFarmDocumentMeta, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };

package/dist/internal/production-runtime.mjs

@@ -4,7 +4,7 @@ import {
 import {
   applyProductionMiddlewareHeaders,
   createProductionMiddlewareRunner
-} from "../chunk-2FQHH5SC.mjs";
+} from "../chunk-IHNMMXHV.mjs";
 import {
   createFarmInstrumentationLifecycle,
   resolveFarmInstrumentationRuntime
@@ -18,15 +18,21 @@ import {
 import {
   applyFarmThemeDocument,
   createDefaultErrorMarkup,
+  createFarmAiCatalogResponse,
   createFarmApiCatalogResponse,
+  createFarmAppManifestResponse,
   createFarmMetadataRouteResponse,
   createFarmThemeDocumentParts,
   createLateNotFoundRecovery,
   createLateRedirectRecovery,
+  ensureFarmDocumentMeta,
   getDefaultErrorStatusText,
+  getRouteGroupScope,
+  isInRouteGroupScope,
+  listFarmMCPLlmsTxtLinks,
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus
-} from "../chunk-TEN4FIZU.mjs";
+} from "../chunk-6ETPZTJI.mjs";
 import {
   mergeRouteRenderingDirectiveConfig
 } from "../chunk-DAO7JGTS.mjs";
@@ -37,7 +43,7 @@ import "../chunk-XAXTTBUT.mjs";
 import {
   _setDefaultFarmThemeConfig,
   getTheme
-} from "../chunk-WBIH66JK.mjs";
+} from "../chunk-2ELDTQRN.mjs";
 import {
   applyFarmCspNonceToResponse,
   applyFarmPreviewRobotsTag,
@@ -53,8 +59,8 @@ import {
   reportFarmPreloadWarnings,
   resolveFarmLlmsTxtConfig,
   resolveFarmSecurityConfig
-} from "../chunk-6VYZOPOT.mjs";
-import "../chunk-JBC2FKRW.mjs";
+} from "../chunk-UJD4PHYB.mjs";
+import "../chunk-WWIKMBRN.mjs";
 import "../chunk-MVL2RAJW.mjs";
 import {
   farmSecretsMatch
@@ -67,8 +73,8 @@ import {
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData
-} from "../chunk-NRVGEI5I.mjs";
-import "../chunk-5TISYEQF.mjs";
+} from "../chunk-2NNMOPDN.mjs";
+import "../chunk-JG6DJF5A.mjs";
 import {
   _runWithAPIRequestRuntime
 } from "../chunk-R3DS7A2T.mjs";
@@ -76,13 +82,14 @@ import {
   _runWithAfterRequest
 } from "../chunk-IOEH4VWN.mjs";
 import "../chunk-5WI2S4CO.mjs";
-import "../chunk-O6XNAMBV.mjs";
-import "../chunk-I6XDAKWQ.mjs";
+import {
+  registerFarmMCPServer
+} from "../chunk-ZLAT2CWY.mjs";
 import {
   configureFarmCache,
   getFarmDataCache,
   normalizeRevalidatePath
-} from "../chunk-IV6CQY7O.mjs";
+} from "../chunk-MSSFIQGM.mjs";
 import {
   bufferFarmRequestBody,
   cloneFarmRequestWithContext,
@@ -92,10 +99,10 @@ import {
   readFarmRequestBody,
   readNodeRequestBody,
   resolveFarmServerConfig
-} from "../chunk-XF7Q24PF.mjs";
+} from "../chunk-Y7RKTKYI.mjs";
 import {
   resolveFarmI18nConfig
-} from "../chunk-YMCXWPWK.mjs";
+} from "../chunk-BCMSYSN2.mjs";
 import {
   matchRoute,
   parseRoutePath
@@ -103,11 +110,13 @@ import {
 import {
   searchParamsToObject
 } from "../chunk-QVKYGNVM.mjs";
+import "../chunk-BTHHUD7Q.mjs";
 import {
   configureFarmObservability,
   emitFarmEvent,
   runWithFarmRequestSpan
 } from "../chunk-FUZEBRP3.mjs";
+import "../chunk-3PXS2MHU.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -119,14 +128,17 @@ import "../chunk-7LTCDQRS.mjs";
 import {
   createFarmLocaleCookie,
   getFarmLocaleVaryHeaders
-} from "../chunk-IXUY2F5U.mjs";
+} from "../chunk-GCXWJJKH.mjs";
+import "../chunk-JM5XPKWH.mjs";
 import {
   addMetadataImageReference,
   addMetadataMarkdownAlternate,
   mergeMetadata,
+  mergeModuleViewport,
   renderMetadataHead,
+  renderViewportHead,
   resolveFarmNotFoundMetadata
-} from "../chunk-QZCT2CQ4.mjs";
+} from "../chunk-CXEN47J3.mjs";
 import "../chunk-SKNL7VA2.mjs";
 import "../chunk-C4NCTZLM.mjs";
 import {
@@ -147,10 +159,11 @@ import {
   isFarmRedirectError
 } from "../chunk-CBBLJMR5.mjs";
 import {
+  _getRequestReadCount,
   _runWithCurrentRequest,
   getCurrentRequest,
   resolveFarmWebRequestOrigin
-} from "../chunk-BSPQVJ4A.mjs";
+} from "../chunk-FDR64H6B.mjs";
 import "../chunk-CQ6OSQ3K.mjs";
 import "../chunk-IZY3V5XW.mjs";
 import {
@@ -172,21 +185,29 @@ import {
 } from "../chunk-LPEX4YW6.mjs";
 
 // src/routing/layout-selector.ts
-function createFarmLayoutSelector(layouts) {
-  const prepared = layouts.map((layout) => ({
-    layout,
-    segments: layout.pattern === "/" ? null : parseRoutePattern(layout.pattern)
-  }));
-  return (pathname) => {
+function createFarmLayoutSelector(layouts, resolveRouteDirectory) {
+  const prepared = layouts.map((layout) => {
+    const segments = layout.pattern === "/" ? [] : parseRoutePattern(layout.pattern);
+    return {
+      layout,
+      segments: segments.length === 0 ? null : segments,
+      groupScope: getRouteGroupScope(layout.pattern)
+    };
+  });
+  return (pathname, routeDirectory) => {
     const applicable = [];
     let parts;
-    for (const { layout, segments } of prepared) {
-      if (segments === null) {
-        applicable.push(layout);
-        continue;
+    let directory = routeDirectory;
+    for (const { layout, segments, groupScope } of prepared) {
+      if (segments !== null) {
+        parts ?? (parts = splitNormalizedPathname(normalizePathname(pathname.replace(/\/$/, "") || "/")));
+        if (matchSegmentParts(segments, parts, true) === null) continue;
+      }
+      if (groupScope !== null) {
+        if (directory === void 0) directory = resolveRouteDirectory?.(pathname) ?? null;
+        if (!isInRouteGroupScope(directory, groupScope)) continue;
       }
-      parts ?? (parts = splitNormalizedPathname(normalizePathname(pathname.replace(/\/$/, "") || "/")));
-      if (matchSegmentParts(segments, parts, true) !== null) applicable.push(layout);
+      applicable.push(layout);
     }
     return applicable;
   };
@@ -492,6 +513,7 @@ function appendFarmLinkHeader(headers, value) {
 }
 __name(appendFarmLinkHeader, "appendFarmLinkHeader");
 export {
+  _getRequestReadCount,
   _isFarmOwnedResponse,
   _markFarmOwnedResponse,
   _runWithAPIRequestRuntime,
@@ -518,7 +540,9 @@ export {
   configureFarmObservability,
   createDefaultErrorMarkup,
   createFarmAgentRobots,
+  createFarmAiCatalogResponse,
   createFarmApiCatalogResponse,
+  createFarmAppManifestResponse,
   createFarmCacheKey,
   createFarmDefaultLlmsTxt,
   createFarmInstrumentationLifecycle,
@@ -536,6 +560,7 @@ export {
   createLateRedirectRecovery,
   createProductionMiddlewareRunner,
   emitFarmEvent,
+  ensureFarmDocumentMeta,
   farmSecretsMatch,
   generateNativeMCPPluginSource,
   getCurrentRequest,
@@ -547,6 +572,8 @@ export {
   getTheme,
   isFarmNotFoundError,
   isFarmRedirectError,
+  isInRouteGroupScope as isInFarmRouteGroupScope,
+  listFarmMCPLlmsTxtLinks,
   localizeFarmHref,
   localizeFarmPathname,
   manageFarmDocumentPreloads,
@@ -555,16 +582,19 @@ export {
   matchRoute as matchFarmPageRoute,
   matchesFarmIfNoneMatch,
   mergeMetadata,
+  mergeModuleViewport,
   mergeRouteRenderingDirectiveConfig,
   normalizeRevalidatePath,
   parseRoutePath,
   readFarmRequestBody,
   readNodeRequestBody,
+  registerFarmMCPServer,
   renderFarmLegacyErrorHtml,
   renderFarmLegacyHtml,
   renderFarmLlmsFullTxt,
   renderFarmLocaleAlternateLinks,
   renderMetadataHead,
+  renderViewportHead,
   reportFarmPreloadWarnings,
   resolveDefaultErrorStatus,
   resolveFarmI18nConfig,

package/dist/internal/request-cookies.cjs

@@ -1,7 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkRG3ZOTG5cjs = require('../chunk-RG3ZOTG5.cjs');
+
+var _chunkAI7QMY7Ocjs = require('../chunk-AI7QMY7O.cjs');
 require('../chunk-S3JO3N4H.cjs');
 
 
-exports.parseRequestCookieHeader = _chunkRG3ZOTG5cjs.parseRequestCookieHeader;
+
+exports.decodeCookieName = _chunkAI7QMY7Ocjs.decodeCookieName; exports.parseRequestCookieHeader = _chunkAI7QMY7Ocjs.parseRequestCookieHeader;

package/dist/internal/request-cookies.d.mts

@@ -4,5 +4,13 @@ interface ParsedRequestCookie {
 }
 /** Parse request cookies in wire order without collapsing duplicate names. */
 declare function parseRequestCookieHeader(header: string | null | undefined): ParsedRequestCookie[];
+/**
+ * A cookie name as Farm wrote it: names are percent-encoded when set, so they are decoded when read.
+ * A browser enforces the `__Host-` / `__Secure-` prefixes on the raw name only, so an encoded name
+ * like `__Host%2Dsid` reaches the server without the guarantees. Decoded, it would read as the
+ * protected `__Host-sid`: a sibling subdomain could set it with a longer Path, which browsers send
+ * first, and shadow the real one. A name keeps its raw form when decoding would add the prefix.
+ */
+declare function decodeCookieName(raw: string): string;
 
-export { type ParsedRequestCookie, parseRequestCookieHeader };
+export { type ParsedRequestCookie, decodeCookieName, parseRequestCookieHeader };

package/dist/internal/request-cookies.d.ts

@@ -4,5 +4,13 @@ interface ParsedRequestCookie {
 }
 /** Parse request cookies in wire order without collapsing duplicate names. */
 declare function parseRequestCookieHeader(header: string | null | undefined): ParsedRequestCookie[];
+/**
+ * A cookie name as Farm wrote it: names are percent-encoded when set, so they are decoded when read.
+ * A browser enforces the `__Host-` / `__Secure-` prefixes on the raw name only, so an encoded name
+ * like `__Host%2Dsid` reaches the server without the guarantees. Decoded, it would read as the
+ * protected `__Host-sid`: a sibling subdomain could set it with a longer Path, which browsers send
+ * first, and shadow the real one. A name keeps its raw form when decoding would add the prefix.
+ */
+declare function decodeCookieName(raw: string): string;
 
-export { type ParsedRequestCookie, parseRequestCookieHeader };
+export { type ParsedRequestCookie, decodeCookieName, parseRequestCookieHeader };

package/dist/internal/request-cookies.mjs

@@ -1,7 +1,9 @@
 import {
+  decodeCookieName,
   parseRequestCookieHeader
-} from "../chunk-5TISYEQF.mjs";
+} from "../chunk-JM5XPKWH.mjs";
 import "../chunk-LPEX4YW6.mjs";
 export {
+  decodeCookieName,
   parseRequestCookieHeader
 };

package/dist/internal/server-tree.cjs

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkYSLWRWWPcjs = require('../chunk-YSLWRWWP.cjs');
+require('../chunk-WWFTAUFG.cjs');
+require('../chunk-S3JO3N4H.cjs');
+
+
+
+
+exports.FARM_SERVER_TREE_ATTRIBUTE = _chunkYSLWRWWPcjs.FARM_SERVER_TREE_ATTRIBUTE; exports.createFarmServerTreeElement = _chunkYSLWRWWPcjs.createFarmServerTreeElement; exports.renderFarmServerTreePage = _chunkYSLWRWWPcjs.renderFarmServerTreePage;

package/dist/internal/server-tree.d.mts

@@ -0,0 +1,27 @@
+import React__default from 'react';
+
+declare const FARM_SERVER_TREE_ATTRIBUTE = "data-farm-server-tree";
+interface FarmServerTreeRenderOptions {
+    /** Renders a subtree the resolver could not represent with its client components as islands. */
+    isolate(element: React__default.ReactNode): React__default.ReactNode;
+}
+/**
+ * @internal Resolves a server page and returns the page boundary's children: the resolved tree
+ * and its payload. Errors from the page's own code, including redirect and notFound controls,
+ * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
+ */
+declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
+interface FarmServerTreeElementOptions {
+    load(reference: string): Promise<Record<string, unknown>>;
+    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
+    ServerHtml: React__default.ComponentType<any>;
+    /** Remounts the page's client components when it changes, as a navigation does. */
+    key?: string;
+}
+/**
+ * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
+ * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
+ */
+declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
+
+export { FARM_SERVER_TREE_ATTRIBUTE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/internal/server-tree.d.ts

@@ -0,0 +1,27 @@
+import React__default from 'react';
+
+declare const FARM_SERVER_TREE_ATTRIBUTE = "data-farm-server-tree";
+interface FarmServerTreeRenderOptions {
+    /** Renders a subtree the resolver could not represent with its client components as islands. */
+    isolate(element: React__default.ReactNode): React__default.ReactNode;
+}
+/**
+ * @internal Resolves a server page and returns the page boundary's children: the resolved tree
+ * and its payload. Errors from the page's own code, including redirect and notFound controls,
+ * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
+ */
+declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
+interface FarmServerTreeElementOptions {
+    load(reference: string): Promise<Record<string, unknown>>;
+    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
+    ServerHtml: React__default.ComponentType<any>;
+    /** Remounts the page's client components when it changes, as a navigation does. */
+    key?: string;
+}
+/**
+ * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
+ * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
+ */
+declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
+
+export { FARM_SERVER_TREE_ATTRIBUTE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/internal/server-tree.mjs

@@ -0,0 +1,12 @@
+import {
+  FARM_SERVER_TREE_ATTRIBUTE,
+  createFarmServerTreeElement,
+  renderFarmServerTreePage
+} from "../chunk-OFZUJMCU.mjs";
+import "../chunk-NRDBW4MP.mjs";
+import "../chunk-LPEX4YW6.mjs";
+export {
+  FARM_SERVER_TREE_ATTRIBUTE,
+  createFarmServerTreeElement,
+  renderFarmServerTreePage
+};

package/dist/markdown.cjs

@@ -14,10 +14,10 @@
 
 
 
-var _chunkKJ2TIHZZcjs = require('./chunk-KJ2TIHZZ.cjs');
+var _chunkEUV4YR3Vcjs = require('./chunk-EUV4YR3V.cjs');
 require('./chunk-J63ZH5OQ.cjs');
-require('./chunk-5MKEDGLD.cjs');
-require('./chunk-WPYFSQKK.cjs');
+require('./chunk-75RZHGLS.cjs');
+require('./chunk-KNBBQHO2.cjs');
 require('./chunk-E3UK5IIB.cjs');
 require('./chunk-G7HXGLEC.cjs');
 require('./chunk-S3A45T7F.cjs');
@@ -41,4 +41,4 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkKJ2TIHZZcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.applyMarkdownNegotiationHeaders = _chunkKJ2TIHZZcjs.applyMarkdownNegotiationHeaders; exports.createFarmMarkdownErrorBody = _chunkKJ2TIHZZcjs.createFarmMarkdownErrorBody; exports.createMarkdownMirrorResponse = _chunkKJ2TIHZZcjs.createMarkdownMirrorResponse; exports.extractFarmPageActions = _chunkKJ2TIHZZcjs.extractFarmPageActions; exports.farmAcceptQuality = _chunkKJ2TIHZZcjs.farmAcceptQuality; exports.farmRequestWantsMarkdown = _chunkKJ2TIHZZcjs.farmRequestWantsMarkdown; exports.getFarmMarkdownAlternatePath = _chunkKJ2TIHZZcjs.getFarmMarkdownAlternatePath; exports.getFarmMarkdownMirrorPath = _chunkKJ2TIHZZcjs.getFarmMarkdownMirrorPath; exports.htmlToMarkdown = _chunkKJ2TIHZZcjs.htmlToMarkdown; exports.isFarmMarkdownMirrorExposed = _chunkKJ2TIHZZcjs.isFarmMarkdownMirrorExposed; exports.matchesFarmMarkdownRoutePattern = _chunkKJ2TIHZZcjs.matchesFarmMarkdownRoutePattern; exports.requestAcceptsMarkdown = _chunkKJ2TIHZZcjs.requestAcceptsMarkdown; exports.resolveMarkdownConfig = _chunkKJ2TIHZZcjs.resolveMarkdownConfig; exports.resolveMarkdownMirrorTarget = _chunkKJ2TIHZZcjs.resolveMarkdownMirrorTarget;
+exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkEUV4YR3Vcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.applyMarkdownNegotiationHeaders = _chunkEUV4YR3Vcjs.applyMarkdownNegotiationHeaders; exports.createFarmMarkdownErrorBody = _chunkEUV4YR3Vcjs.createFarmMarkdownErrorBody; exports.createMarkdownMirrorResponse = _chunkEUV4YR3Vcjs.createMarkdownMirrorResponse; exports.extractFarmPageActions = _chunkEUV4YR3Vcjs.extractFarmPageActions; exports.farmAcceptQuality = _chunkEUV4YR3Vcjs.farmAcceptQuality; exports.farmRequestWantsMarkdown = _chunkEUV4YR3Vcjs.farmRequestWantsMarkdown; exports.getFarmMarkdownAlternatePath = _chunkEUV4YR3Vcjs.getFarmMarkdownAlternatePath; exports.getFarmMarkdownMirrorPath = _chunkEUV4YR3Vcjs.getFarmMarkdownMirrorPath; exports.htmlToMarkdown = _chunkEUV4YR3Vcjs.htmlToMarkdown; exports.isFarmMarkdownMirrorExposed = _chunkEUV4YR3Vcjs.isFarmMarkdownMirrorExposed; exports.matchesFarmMarkdownRoutePattern = _chunkEUV4YR3Vcjs.matchesFarmMarkdownRoutePattern; exports.requestAcceptsMarkdown = _chunkEUV4YR3Vcjs.requestAcceptsMarkdown; exports.resolveMarkdownConfig = _chunkEUV4YR3Vcjs.resolveMarkdownConfig; exports.resolveMarkdownMirrorTarget = _chunkEUV4YR3Vcjs.resolveMarkdownMirrorTarget;