@farm.js/core 0.1.35 → 0.1.37

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

@@ -1,23 +1,24 @@
 export { _runWithAfterRequest } from '../after.mjs';
-import { aH as FarmMCPCatalogDetails, fM as APIRequestRuntime, bT as ResolvedFarmMCPConfig, fN as FarmLlmsTxtLink, J as FarmConfig, $ as FarmContextFactoryInput } from '../client-plugins-CvIslxWi.mjs';
-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-CvIslxWi.mjs';
-export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-CLnS7AZj.mjs';
+import { aJ as FarmMCPCatalogDetails, fN as APIRequestRuntime, bT as ResolvedFarmMCPConfig, aE as FarmMCPServerRegistration, fO as FarmLlmsTxtLink, I as FarmConfig, _ as FarmContextFactoryInput } from '../client-plugins-CV4eJ9De.mjs';
+export { fY as FarmLlmsTxtUserConfig, fZ as ResolvedFarmLlmsTxtConfig, g2 as applyFarmCspNonceToResponse, fS as collectFarmLlmsTxtPages, fQ as createFarmAgentRobots, fT as createFarmDefaultLlmsTxt, fR as createFarmDefaultSitemap, fW as createFarmLlmsFullRenderer, fU as createFarmLlmsMarkdownReader, fP as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, f_ as manageFarmDocumentPreloads, f$ as manageFarmHtmlPreloads, g0 as manageFarmLinkHeaderPreloads, aI as registerFarmMCPServer, fV as renderFarmLlmsFullTxt, g1 as reportFarmPreloadWarnings, fX as resolveFarmLlmsTxtConfig, g3 as resolveFarmSecurityConfig } from '../client-plugins-CV4eJ9De.mjs';
+export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-DWFp3Yq4.mjs';
 import { R as ResolvedFarmServerConfig } from '../workflows-jZ4BcdoZ.mjs';
 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.mjs';
-export { _ as _getRequestReadCount, a as _runWithCurrentRequest, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-fkhiynXe.mjs';
+export { _ as _getRequestReadCount, a as _runWithCurrentRequest, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-sKayKcop.mjs';
 export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.mjs';
 import { k as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from '../types-CnH8DOqo.mjs';
 export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-khasx3fU.mjs';
 import { F as FarmLocalePathConfig } from '../index-BJJfLxJo.mjs';
 export { l as localizeFarmHref, a as localizeFarmPathname, s as stripFarmLocaleFromPathname } from '../index-BJJfLxJo.mjs';
-export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, m as mergeMetadata, c as mergeModuleViewport, r as renderMetadataHead, d as renderViewportHead, e as resolveFarmNotFoundMetadata } from '../metadata-WGpBYcGn.mjs';
-export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-0sRnuYc-.mjs';
+import { F as FarmDefaultMCPPage } from '../agent-mcp-BC0bAGVF.mjs';
+export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, g as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, h as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata } from '../agent-mcp-BC0bAGVF.mjs';
+export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-Du_FHb2-.mjs';
 export { L as configureFarmObservability, P as emitFarmEvent, Q as runWithFarmRequestSpan } from '../observability-CoXunYhS.mjs';
 export { f as createFarmInstrumentationLifecycle, r as resolveFarmInstrumentationRuntime } from '../instrumentation-runtime-CE06JLHZ.mjs';
 export { _setDefaultFarmThemeConfig, getTheme } from '../theme/server.mjs';
 import { c as FarmThemeRuntime, d as FarmThemeConfig, R as ResolvedFarmThemeConfig, a as FarmThemePreference } from '../types-DQnyD3VD.mjs';
 export { d as applyFarmBasePath, r as resolveFarmTrailingSlashRedirect, s as searchParamsToObject, b as setFarmBasePath, a as setFarmTrailingSlashPreference, c as stripFarmBasePath } from '../base-path-BU16ETmo.mjs';
-export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-XJn0c9bj.mjs';
+export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-p9Hs-jCc.mjs';
 import 'node:http';
 import '../lifecycle-DK06VuKP.mjs';
 import '../integration-api-0y4FXJpC.mjs';
@@ -61,18 +62,6 @@ interface FarmAppManifestWebMCPTool {
     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;
@@ -80,7 +69,7 @@ interface FarmAppManifestTool {
     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"`. */
+    /** The endpoint's method and route, for `source: "endpoint"`. Only in Farm Infra's view. */
     method?: string;
     path?: string;
     readOnlyHint?: boolean;
@@ -107,6 +96,11 @@ interface FarmAppManifest {
             name: string;
             version: string;
             path: string;
+            /**
+             * `"required"` when the server runs `authorize`: an anonymous client lists nothing,
+             * so the public view leaves `tools`, `resources` and `prompts` empty.
+             */
+            authorization: "none" | "required";
             tools: FarmAppManifestTool[];
             resources: NonNullable<ServerDetails["resources"]>;
             prompts: NonNullable<ServerDetails["prompts"]>;
@@ -141,18 +135,30 @@ interface FarmAppManifestInput {
     integrations: FarmAppManifest["integrations"];
     agent: FarmAppManifest["agent"];
     plugins: string[];
-    /** `analytics: false` keeps the production manifest off: the app talks to no Farm Infra. */
+    /**
+     * `analytics: false` turns off Farm Infra's signed view: the app talks to no Farm Infra.
+     * The public manifest is still served; `agent.manifest: false` turns that off.
+     */
     analytics: boolean;
+    /**
+     * The default read-only MCP server (`agent.mcp`) while the app would serve it. Set by the
+     * server at runtime, not serialized: it answers only while no other MCP server is listed.
+     */
+    defaultMCP?: () => {
+        name: string;
+        version: string;
+        path: string;
+    } | undefined;
 }
 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.
+ * Answers `/.well-known/farmjs.json` for anyone. A request Farm Infra signed for the app's
+ * `FARMJS_API_KEY` gets the full view, unless `analytics` is off; any other read gets the
+ * public one.
  */
-declare function createFarmAppManifestResponse(request: Request, input: FarmAppManifestInput, options: {
-    development: boolean;
+declare function createFarmAppManifestResponse(request: Request, input: FarmAppManifestInput, options?: {
     env?: Env;
-}): Promise<Response | null>;
+}): Promise<Response>;
 
 /**
  * Compare a caller-supplied secret against the configured one without leaking
@@ -306,11 +312,45 @@ declare function _isFarmOwnedResponse(response: Response): boolean;
  */
 declare function _withFarmResponseHeaders(response: Response, edit: (headers: Headers) => void): Response;
 
+/**
+ * The protocol side of the default MCP server (`agent.mcp`, see `agent-mcp.ts`): stateless
+ * Streamable HTTP with JSON responses, and three read-only tools over the app's public pages.
+ * A small JSON-RPC implementation rather than the MCP SDK, so apps that never receive an
+ * MCP request carry no SDK.
+ *
+ * Kept free of Node built-ins: the production server runs on edge runtimes too.
+ */
+
+interface FarmDefaultMCPContext {
+    server: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+    /** The app's public pages for this request's origin. */
+    listPages: () => FarmDefaultMCPPage[] | Promise<FarmDefaultMCPPage[]>;
+    /** Reads a Markdown URL anonymously; null when the page does not answer with Markdown. */
+    readMarkdown: (url: string) => Promise<string | null>;
+    basePath?: string;
+}
+/**
+ * Answers one request to the default MCP endpoint: stateless Streamable HTTP, JSON
+ * responses, no sessions, and no server-initiated stream (GET answers 405).
+ */
+declare function handleFarmDefaultMCPRequest(request: Request, context: FarmDefaultMCPContext): Promise<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 default read-only server (`agent.mcp`), when this app would serve it. It is
+     * listed only while no other MCP server is, the same rule that decides whether it answers.
+     */
+    defaultMCP?: () => (FarmMCPServerRegistration & {
+        path: `/${string}`;
+    }) | undefined;
 }
 /**
  * The llms.txt links for the app's MCP servers: each endpoint, then the catalog
@@ -424,4 +464,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, 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 };
+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, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };

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

@@ -1,23 +1,24 @@
 export { _runWithAfterRequest } from '../after.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 { aJ as FarmMCPCatalogDetails, fN as APIRequestRuntime, bT as ResolvedFarmMCPConfig, aE as FarmMCPServerRegistration, fO as FarmLlmsTxtLink, I as FarmConfig, _ as FarmContextFactoryInput } from '../client-plugins-C8DjftDF.js';
+export { fY as FarmLlmsTxtUserConfig, fZ as ResolvedFarmLlmsTxtConfig, g2 as applyFarmCspNonceToResponse, fS as collectFarmLlmsTxtPages, fQ as createFarmAgentRobots, fT as createFarmDefaultLlmsTxt, fR as createFarmDefaultSitemap, fW as createFarmLlmsFullRenderer, fU as createFarmLlmsMarkdownReader, fP as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, f_ as manageFarmDocumentPreloads, f$ as manageFarmHtmlPreloads, g0 as manageFarmLinkHeaderPreloads, aI as registerFarmMCPServer, fV as renderFarmLlmsFullTxt, g1 as reportFarmPreloadWarnings, fX as resolveFarmLlmsTxtConfig, g3 as resolveFarmSecurityConfig } from '../client-plugins-C8DjftDF.js';
+export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-Bx4Auw6Q.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 { _ as _getRequestReadCount, a as _runWithCurrentRequest, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-BNWr7r5e.js';
 export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.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';
+import { F as FarmDefaultMCPPage } from '../agent-mcp-jyDHbQKe.js';
+export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, g as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, h as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata } from '../agent-mcp-jyDHbQKe.js';
+export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-C2kkrPVZ.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-BXLmFsVR.js';
+export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-BwVcAfUR.js';
 import 'node:http';
 import '../lifecycle-DK06VuKP.js';
 import '../integration-api-BPJo5oXb.js';
@@ -61,18 +62,6 @@ interface FarmAppManifestWebMCPTool {
     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;
@@ -80,7 +69,7 @@ interface FarmAppManifestTool {
     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"`. */
+    /** The endpoint's method and route, for `source: "endpoint"`. Only in Farm Infra's view. */
     method?: string;
     path?: string;
     readOnlyHint?: boolean;
@@ -107,6 +96,11 @@ interface FarmAppManifest {
             name: string;
             version: string;
             path: string;
+            /**
+             * `"required"` when the server runs `authorize`: an anonymous client lists nothing,
+             * so the public view leaves `tools`, `resources` and `prompts` empty.
+             */
+            authorization: "none" | "required";
             tools: FarmAppManifestTool[];
             resources: NonNullable<ServerDetails["resources"]>;
             prompts: NonNullable<ServerDetails["prompts"]>;
@@ -141,18 +135,30 @@ interface FarmAppManifestInput {
     integrations: FarmAppManifest["integrations"];
     agent: FarmAppManifest["agent"];
     plugins: string[];
-    /** `analytics: false` keeps the production manifest off: the app talks to no Farm Infra. */
+    /**
+     * `analytics: false` turns off Farm Infra's signed view: the app talks to no Farm Infra.
+     * The public manifest is still served; `agent.manifest: false` turns that off.
+     */
     analytics: boolean;
+    /**
+     * The default read-only MCP server (`agent.mcp`) while the app would serve it. Set by the
+     * server at runtime, not serialized: it answers only while no other MCP server is listed.
+     */
+    defaultMCP?: () => {
+        name: string;
+        version: string;
+        path: string;
+    } | undefined;
 }
 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.
+ * Answers `/.well-known/farmjs.json` for anyone. A request Farm Infra signed for the app's
+ * `FARMJS_API_KEY` gets the full view, unless `analytics` is off; any other read gets the
+ * public one.
  */
-declare function createFarmAppManifestResponse(request: Request, input: FarmAppManifestInput, options: {
-    development: boolean;
+declare function createFarmAppManifestResponse(request: Request, input: FarmAppManifestInput, options?: {
     env?: Env;
-}): Promise<Response | null>;
+}): Promise<Response>;
 
 /**
  * Compare a caller-supplied secret against the configured one without leaking
@@ -306,11 +312,45 @@ declare function _isFarmOwnedResponse(response: Response): boolean;
  */
 declare function _withFarmResponseHeaders(response: Response, edit: (headers: Headers) => void): Response;
 
+/**
+ * The protocol side of the default MCP server (`agent.mcp`, see `agent-mcp.ts`): stateless
+ * Streamable HTTP with JSON responses, and three read-only tools over the app's public pages.
+ * A small JSON-RPC implementation rather than the MCP SDK, so apps that never receive an
+ * MCP request carry no SDK.
+ *
+ * Kept free of Node built-ins: the production server runs on edge runtimes too.
+ */
+
+interface FarmDefaultMCPContext {
+    server: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+    /** The app's public pages for this request's origin. */
+    listPages: () => FarmDefaultMCPPage[] | Promise<FarmDefaultMCPPage[]>;
+    /** Reads a Markdown URL anonymously; null when the page does not answer with Markdown. */
+    readMarkdown: (url: string) => Promise<string | null>;
+    basePath?: string;
+}
+/**
+ * Answers one request to the default MCP endpoint: stateless Streamable HTTP, JSON
+ * responses, no sessions, and no server-initiated stream (GET answers 405).
+ */
+declare function handleFarmDefaultMCPRequest(request: Request, context: FarmDefaultMCPContext): Promise<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 default read-only server (`agent.mcp`), when this app would serve it. It is
+     * listed only while no other MCP server is, the same rule that decides whether it answers.
+     */
+    defaultMCP?: () => (FarmMCPServerRegistration & {
+        path: `/${string}`;
+    }) | undefined;
 }
 /**
  * The llms.txt links for the app's MCP servers: each endpoint, then the catalog
@@ -424,4 +464,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, 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 };
+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, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };

package/dist/internal/production-runtime.mjs

@@ -1,20 +1,19 @@
 import {
+  handleFarmDefaultMCPRequest
+} from "../chunk-6SJ2KJTA.mjs";
+import {
+  createFarmLayoutSelector,
   generateNativeMCPPluginSource
-} from "../chunk-FXEF4PPL.mjs";
+} from "../chunk-WRPHYQVY.mjs";
 import {
   applyProductionMiddlewareHeaders,
   createProductionMiddlewareRunner
-} from "../chunk-IHNMMXHV.mjs";
+} from "../chunk-FGRYBX5X.mjs";
 import {
   createFarmInstrumentationLifecycle,
   resolveFarmInstrumentationRuntime
 } from "../chunk-H77NVNJ2.mjs";
-import {
-  matchSegmentParts,
-  normalizePathname,
-  parseRoutePattern,
-  splitNormalizedPathname
-} from "../chunk-OT6ZEW74.mjs";
+import "../chunk-OT6ZEW74.mjs";
 import {
   applyFarmThemeDocument,
   createDefaultErrorMarkup,
@@ -27,12 +26,15 @@ import {
   createLateRedirectRecovery,
   ensureFarmDocumentMeta,
   getDefaultErrorStatusText,
-  getRouteGroupScope,
   isInRouteGroupScope,
   listFarmMCPLlmsTxtLinks,
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus
-} from "../chunk-6ETPZTJI.mjs";
+} from "../chunk-LBGILORX.mjs";
+import {
+  collectFarmDefaultMCPPages,
+  resolveFarmDefaultMCPServer
+} from "../chunk-UH6QN5NL.mjs";
 import {
   mergeRouteRenderingDirectiveConfig
 } from "../chunk-DAO7JGTS.mjs";
@@ -43,23 +45,26 @@ import "../chunk-XAXTTBUT.mjs";
 import {
   _setDefaultFarmThemeConfig,
   getTheme
-} from "../chunk-2ELDTQRN.mjs";
+} from "../chunk-TDNWPAVR.mjs";
 import {
   applyFarmCspNonceToResponse,
   applyFarmPreviewRobotsTag,
-  collectFarmLlmsTxtPages,
   createFarmAgentRobots,
-  createFarmDefaultLlmsTxt,
-  createFarmLlmsFullRenderer,
-  createFarmLlmsMarkdownReader,
+  createFarmDefaultSitemap,
   manageFarmDocumentPreloads,
   manageFarmHtmlPreloads,
   manageFarmLinkHeaderPreloads,
-  renderFarmLlmsFullTxt,
   reportFarmPreloadWarnings,
-  resolveFarmLlmsTxtConfig,
   resolveFarmSecurityConfig
-} from "../chunk-UJD4PHYB.mjs";
+} from "../chunk-4E5WBPEG.mjs";
+import {
+  collectFarmLlmsTxtPages,
+  createFarmDefaultLlmsTxt,
+  createFarmLlmsFullRenderer,
+  createFarmLlmsMarkdownReader,
+  renderFarmLlmsFullTxt,
+  resolveFarmLlmsTxtConfig
+} from "../chunk-DTSROJ5J.mjs";
 import "../chunk-WWIKMBRN.mjs";
 import "../chunk-MVL2RAJW.mjs";
 import {
@@ -73,8 +78,8 @@ import {
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData
-} from "../chunk-2NNMOPDN.mjs";
-import "../chunk-JG6DJF5A.mjs";
+} from "../chunk-J3ANCZKA.mjs";
+import "../chunk-HZFM2LWQ.mjs";
 import {
   _runWithAPIRequestRuntime
 } from "../chunk-R3DS7A2T.mjs";
@@ -99,7 +104,7 @@ import {
   readFarmRequestBody,
   readNodeRequestBody,
   resolveFarmServerConfig
-} from "../chunk-Y7RKTKYI.mjs";
+} from "../chunk-ZMMBIVQM.mjs";
 import {
   resolveFarmI18nConfig
 } from "../chunk-BCMSYSN2.mjs";
@@ -110,13 +115,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 "../chunk-BTHHUD7Q.mjs";
+import "../chunk-YCKO6FRS.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -163,9 +168,9 @@ import {
   _runWithCurrentRequest,
   getCurrentRequest,
   resolveFarmWebRequestOrigin
-} from "../chunk-FDR64H6B.mjs";
+} from "../chunk-3KGDJLJK.mjs";
 import "../chunk-CQ6OSQ3K.mjs";
-import "../chunk-IZY3V5XW.mjs";
+import "../chunk-S3VWVTVA.mjs";
 import {
   localizeFarmHref,
   localizeFarmPathname,
@@ -184,36 +189,6 @@ import {
   __name
 } from "../chunk-LPEX4YW6.mjs";
 
-// src/routing/layout-selector.ts
-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;
-    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;
-      }
-      applicable.push(layout);
-    }
-    return applicable;
-  };
-}
-__name(createFarmLayoutSelector, "createFarmLayoutSelector");
-
 // src/production-lifecycle.ts
 function createFarmProductionLifecycle(options) {
   let state = "starting";
@@ -534,6 +509,7 @@ export {
   applyProductionMiddlewareHeaders,
   bufferFarmRequestBody,
   cloneFarmRequestWithContext,
+  collectFarmDefaultMCPPages,
   collectFarmLlmsTxtPages,
   compareRouteSpecificity,
   configureFarmCache,
@@ -545,6 +521,7 @@ export {
   createFarmAppManifestResponse,
   createFarmCacheKey,
   createFarmDefaultLlmsTxt,
+  createFarmDefaultSitemap,
   createFarmInstrumentationLifecycle,
   createFarmLayoutSelector,
   createFarmLegacyRequest,
@@ -570,6 +547,7 @@ export {
   getFarmRedirectError,
   getRoutePatternSpecificity,
   getTheme,
+  handleFarmDefaultMCPRequest,
   isFarmNotFoundError,
   isFarmRedirectError,
   isInRouteGroupScope as isInFarmRouteGroupScope,
@@ -597,6 +575,7 @@ export {
   renderViewportHead,
   reportFarmPreloadWarnings,
   resolveDefaultErrorStatus,
+  resolveFarmDefaultMCPServer,
   resolveFarmI18nConfig,
   resolveFarmInstrumentationRuntime,
   resolveFarmLlmsTxtConfig,

package/dist/{layers-BRQF5ETU.mjs → layers-UTB43B7A.mjs}

@@ -5,7 +5,7 @@ import {
   getFarmSourceRoots,
   loadFarmConfigFile,
   resolveFarmLayers
-} from "./chunk-JHWOVJ3M.mjs";
+} from "./chunk-BUGNQIHC.mjs";
 import "./chunk-SFGWNC43.mjs";
 import "./chunk-LPEX4YW6.mjs";
 export {

package/dist/layers-VUWIOFEO.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunkWBKEZXWEcjs = require('./chunk-WBKEZXWE.cjs');
+require('./chunk-UYIHRDE4.cjs');
+require('./chunk-S3JO3N4H.cjs');
+
+
+
+
+
+
+
+exports.createFarmConfigResolutionPlugin = _chunkWBKEZXWEcjs.createFarmConfigResolutionPlugin; exports.getFarmAppDirectories = _chunkWBKEZXWEcjs.getFarmAppDirectories; exports.getFarmLayerAliases = _chunkWBKEZXWEcjs.getFarmLayerAliases; exports.getFarmSourceRoots = _chunkWBKEZXWEcjs.getFarmSourceRoots; exports.loadFarmConfigFile = _chunkWBKEZXWEcjs.loadFarmConfigFile; exports.resolveFarmLayers = _chunkWBKEZXWEcjs.resolveFarmLayers;

package/dist/markdown.cjs

@@ -17,8 +17,8 @@
 var _chunkEUV4YR3Vcjs = require('./chunk-EUV4YR3V.cjs');
 require('./chunk-J63ZH5OQ.cjs');
 require('./chunk-75RZHGLS.cjs');
-require('./chunk-KNBBQHO2.cjs');
 require('./chunk-E3UK5IIB.cjs');
+require('./chunk-KNBBQHO2.cjs');
 require('./chunk-G7HXGLEC.cjs');
 require('./chunk-S3A45T7F.cjs');
 require('./chunk-FJ3M4CUX.cjs');

package/dist/markdown.d.mts

@@ -1,4 +1,4 @@
-export { fl as ApplyMarkdownNegotiationHeadersOptions, fk as CreateMarkdownMirrorResponseOptions, z as FARM_MARKDOWN_CONTENT_TYPE, fi as FarmMarkdownMirrorTarget, aN as FarmMarkdownResolvedConfig, fh as FarmMarkdownResolvedRoute, fg as FarmMarkdownRouteInput, cI as FarmMarkdownUserConfig, fA as FarmPageFormAction, fy as FarmPageFormField, fx as FarmPageFormOption, fz as FarmPageFormSubmit, fj as ResolveMarkdownMirrorTargetOptions, fp as applyMarkdownNegotiationHeaders, A as createFarmMarkdownErrorBody, fo as createMarkdownMirrorResponse, fB as extractFarmPageActions, fr as farmAcceptQuality, B as farmRequestWantsMarkdown, fu as getFarmMarkdownAlternatePath, ft as getFarmMarkdownMirrorPath, fq as htmlToMarkdown, fv as isFarmMarkdownMirrorExposed, fw as matchesFarmMarkdownRoutePattern, fs as requestAcceptsMarkdown, fm as resolveMarkdownConfig, fn as resolveMarkdownMirrorTarget } from './client-plugins-CvIslxWi.mjs';
+export { fm as ApplyMarkdownNegotiationHeadersOptions, fl as CreateMarkdownMirrorResponseOptions, z as FARM_MARKDOWN_CONTENT_TYPE, fj as FarmMarkdownMirrorTarget, aF as FarmMarkdownResolvedConfig, fi as FarmMarkdownResolvedRoute, fh as FarmMarkdownRouteInput, cI as FarmMarkdownUserConfig, fB as FarmPageFormAction, fz as FarmPageFormField, fy as FarmPageFormOption, fA as FarmPageFormSubmit, fk as ResolveMarkdownMirrorTargetOptions, fq as applyMarkdownNegotiationHeaders, A as createFarmMarkdownErrorBody, fp as createMarkdownMirrorResponse, fC as extractFarmPageActions, fs as farmAcceptQuality, B as farmRequestWantsMarkdown, fv as getFarmMarkdownAlternatePath, fu as getFarmMarkdownMirrorPath, fr as htmlToMarkdown, fw as isFarmMarkdownMirrorExposed, fx as matchesFarmMarkdownRoutePattern, ft as requestAcceptsMarkdown, fn as resolveMarkdownConfig, fo as resolveMarkdownMirrorTarget } from './client-plugins-CV4eJ9De.mjs';
 import './lifecycle-DK06VuKP.mjs';
 import './integration-api-0y4FXJpC.mjs';
 import './endpoint-CCHFqyTE.mjs';

package/dist/markdown.d.ts

@@ -1,4 +1,4 @@
-export { fl as ApplyMarkdownNegotiationHeadersOptions, fk as CreateMarkdownMirrorResponseOptions, z as FARM_MARKDOWN_CONTENT_TYPE, fi as FarmMarkdownMirrorTarget, aN as FarmMarkdownResolvedConfig, fh as FarmMarkdownResolvedRoute, fg as FarmMarkdownRouteInput, cI as FarmMarkdownUserConfig, fA as FarmPageFormAction, fy as FarmPageFormField, fx as FarmPageFormOption, fz as FarmPageFormSubmit, fj as ResolveMarkdownMirrorTargetOptions, fp as applyMarkdownNegotiationHeaders, A as createFarmMarkdownErrorBody, fo as createMarkdownMirrorResponse, fB as extractFarmPageActions, fr as farmAcceptQuality, B as farmRequestWantsMarkdown, fu as getFarmMarkdownAlternatePath, ft as getFarmMarkdownMirrorPath, fq as htmlToMarkdown, fv as isFarmMarkdownMirrorExposed, fw as matchesFarmMarkdownRoutePattern, fs as requestAcceptsMarkdown, fm as resolveMarkdownConfig, fn as resolveMarkdownMirrorTarget } from './client-plugins-HIyulDym.js';
+export { fm as ApplyMarkdownNegotiationHeadersOptions, fl as CreateMarkdownMirrorResponseOptions, z as FARM_MARKDOWN_CONTENT_TYPE, fj as FarmMarkdownMirrorTarget, aF as FarmMarkdownResolvedConfig, fi as FarmMarkdownResolvedRoute, fh as FarmMarkdownRouteInput, cI as FarmMarkdownUserConfig, fB as FarmPageFormAction, fz as FarmPageFormField, fy as FarmPageFormOption, fA as FarmPageFormSubmit, fk as ResolveMarkdownMirrorTargetOptions, fq as applyMarkdownNegotiationHeaders, A as createFarmMarkdownErrorBody, fp as createMarkdownMirrorResponse, fC as extractFarmPageActions, fs as farmAcceptQuality, B as farmRequestWantsMarkdown, fv as getFarmMarkdownAlternatePath, fu as getFarmMarkdownMirrorPath, fr as htmlToMarkdown, fw as isFarmMarkdownMirrorExposed, fx as matchesFarmMarkdownRoutePattern, ft as requestAcceptsMarkdown, fn as resolveMarkdownConfig, fo as resolveMarkdownMirrorTarget } from './client-plugins-C8DjftDF.js';
 import './lifecycle-DK06VuKP.js';
 import './integration-api-BPJo5oXb.js';
 import './endpoint-CA-TNX60.js';

package/dist/markdown.mjs

@@ -17,8 +17,8 @@ import {
 } from "./chunk-WWIKMBRN.mjs";
 import "./chunk-MVL2RAJW.mjs";
 import "./chunk-ZLAT2CWY.mjs";
-import "./chunk-BTHHUD7Q.mjs";
 import "./chunk-FUZEBRP3.mjs";
+import "./chunk-BTHHUD7Q.mjs";
 import "./chunk-O7BH5O46.mjs";
 import "./chunk-7LTCDQRS.mjs";
 import "./chunk-Z3HATSKO.mjs";