@sonordev/site-kit 7.2.0 → 7.3.0

package/dist/{chunk-IAM3D3RL.js → chunk-WGIDC6QP.js}

@@ -1,8 +1,8 @@
 'use client';
-import { countStageViews, countStageQuestions, useFieldControls } from './chunk-D5DCBD4Y.js';
+import { countStageViews, countStageQuestions, useFieldControls } from './chunk-ZKHI4E2B.js';
 import { HoneypotField } from './chunk-DXO6SBMD.js';
 import { DelightStyles, FormMomentum, FormField } from './chunk-4NTBQNHA.js';
-import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-FR6BYFPC.js';
+import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-EPT6FJUY.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isFieldVisible, validateField, isFieldComplete, isDisplayOnly, unseenControlValues } from './chunk-C2FZBUSS.js';
 import { DEFAULT_FORM_SUCCESS_MESSAGE } from './chunk-5SQK3D53.js';
@@ -63,7 +63,7 @@ function FormClient({
       return;
     }
     let cancelled = false;
-    const load = resolvedExperience === "stage" ? import('./FormStage-BI5R5CNC.js').then((m) => m.FormStage) : import('./FormSpotlight-F2AAEGBN.js').then((m) => m.FormSpotlight);
+    const load = resolvedExperience === "stage" ? import('./FormStage-OOPQC27J.js').then((m) => m.FormStage) : import('./FormSpotlight-PE5YZBFZ.js').then((m) => m.FormSpotlight);
     load.then((Component) => {
       if (!cancelled) setExperience(() => Component);
     }).catch((err) => {

package/dist/{chunk-5V2V5C3Y.js → chunk-XLSQTTUE.js}

@@ -1,4 +1,4 @@
-import { FormEnhancer } from './chunk-OWZ7ATLZ.js';
+import { FormEnhancer } from './chunk-MVR4FY5R.js';
 import { StaticForm } from './chunk-ZTLMPUO6.js';
 import { serverApiFetch } from './chunk-X6F6SO4S.js';
 import { jsx } from 'react/jsx-runtime';

package/dist/{chunk-R46IQIGK.js → chunk-Y6LP36UW.js}

@@ -1,5 +1,5 @@
 import { getSiteConfig } from './chunk-Z22QVHT4.js';
-import { writeLLMsTxtToPublic } from './chunk-QL6XNPSD.js';
+import { writeLLMsTxtToPublic } from './chunk-Z65DHMTW.js';
 import { buildFetch } from './chunk-VX5CMNMM.js';
 import { findAppDirForDiscovery } from './chunk-ZEGVKVD5.js';
 import { stripEmbeddedDomain, locToPath, inferPageType, isMalformedSitemapPath, resolveTrailingSlash, stripTrailingSlash, llmsWriteTimeoutMs, applyTrailingSlash } from './chunk-YVKRYQRG.js';

package/dist/{chunk-EJVQJCG5.js → chunk-YJLS6JBI.js}

@@ -2,7 +2,7 @@
 import { DEFAULT_WIDGET_Z_INDEX } from './chunk-27FISYK4.js';
 import { getOrCreateVisitorId } from './chunk-24QZEO3Q.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
-import { sonorFetch } from './chunk-D6ZC7XKZ.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
 import { useState, useEffect, useCallback, useRef } from 'react';
 import ReactDOM from 'react-dom';
 import dynamic from 'next/dynamic';
@@ -160,7 +160,7 @@ function activatePopup(active, id, popups) {
   return [...active, id];
 }
 var LazyBlocksPopup = dynamic(
-  () => import('./BlocksPopup-YJNJIVPO.js').then((m) => ({ default: m.BlocksPopup })),
+  () => import('./BlocksPopup-AHDU34TL.js').then((m) => ({ default: m.BlocksPopup })),
   { ssr: false }
 );
 function SitePopups(props) {

package/dist/{chunk-QL6XNPSD.js → chunk-Z65DHMTW.js}

@@ -19,24 +19,39 @@ function formatAgentAccessSection(baseUrl, options = {}) {
   return [
     AGENT_ACCESS_HEADING,
     "",
-    "This site answers AI assistants directly through the Model Context Protocol, so an assistant can look things up (and, where offered, send an inquiry for someone) instead of reading pages.",
+    "AI assistants can use this site\u2019s Model Context Protocol tools to look up information and, with the user\u2019s approval, take supported actions.",
     "",
     `- [MCP endpoint](${endpoint}): Streamable HTTP. Call tools/list for the current tools.`,
     `- [Server card](${card}): what the server is and how to connect.`,
+    ...options.catalog ? [`- [AI catalog](${absolute(baseUrl, options.catalog)}): experimental domain discovery.`] : [],
     ...tools.length ? ["", `Tools include ${tools.map((t) => `\`${t}\``).join(", ")}.`] : []
   ].join("\n");
 }
 function appendAgentAccessSection(markdown, baseUrl, options = {}) {
   if (!baseUrl || describesMcp(markdown)) return markdown;
+  const section = formatAgentAccessSection(baseUrl, options);
+  if (options.position === "after-intro") {
+    const firstSection = /^## /m.exec(markdown);
+    if (firstSection) {
+      const intro = markdown.slice(0, firstSection.index).trimEnd().replace(/\n---$/, "").trimEnd();
+      return `${intro}
+
+${section}
+
+---
+
+${markdown.slice(firstSection.index)}`;
+    }
+  }
   return `${markdown.trimEnd()}
 
 ---
 
-${formatAgentAccessSection(baseUrl, options)}
+${section}
 `;
 }
 function describesMcp(markdown) {
-  return markdown.includes(AGENT_ACCESS_HEADING) || markdown.includes("/.well-known/mcp-server-card") || markdown.includes("/.well-known/mcp.json");
+  return markdown.includes(AGENT_ACCESS_HEADING) || markdown.includes("/.well-known/mcp-server-card") || markdown.includes("/.well-known/mcp.json") || markdown.includes("/api/mcp/server-card");
 }
 var MCP_ROUTE_FILES = ["route.ts", "route.tsx", "route.js", "route.jsx", "route.mjs"];
 var SERVER_CARD_DIRS = ["mcp-server-card", "mcp.json"];
@@ -362,16 +377,18 @@ async function generateLLMsTxt(options) {
       }
     }
   }
-  if (options.mcp && baseUrl) {
-    sections.push(formatAgentAccessSection(baseUrl, options.mcp === true ? {} : options.mcp));
-    sectionNames.push("agent-access");
-  }
   for (const custom of customSections) {
     sections.push(`## ${custom.title}
 
 ${custom.content}`);
     sectionNames.push(custom.title.toLowerCase().replace(/\s+/g, "-"));
   }
+  if (options.mcp && baseUrl) {
+    const agentOptions = options.mcp === true ? {} : options.mcp;
+    const index = agentOptions.position === "after-intro" ? sectionNames[0] === "header" ? 1 : 0 : sections.length;
+    sections.splice(index, 0, formatAgentAccessSection(baseUrl, agentOptions));
+    sectionNames.splice(index, 0, "agent-access");
+  }
   return {
     // Every own-site link (pages, clusters, portfolio, custom sections) takes
     // the site's trailing-slash shape in one pass.

package/dist/{chunk-JMLK6MH7.js → chunk-ZHS2XFLV.js}

@@ -1,5 +1,5 @@
 'use client';
-import { sonorFetch } from './chunk-D6ZC7XKZ.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
 import { useState, useCallback, useEffect } from 'react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 

package/dist/{chunk-D5DCBD4Y.js → chunk-ZKHI4E2B.js}

@@ -26,7 +26,7 @@ function useFieldControls(fields) {
     }
     if (needsFile && !requested.current.file) {
       requested.current.file = true;
-      import('./FileField-CI4UL5SH.js').then((m) => {
+      import('./FileField-J5W5MIAZ.js').then((m) => {
         if (!cancelled) setControls((prev) => ({ ...prev, File: m.FileField }));
       }).catch(() => {
         requested.current.file = false;

package/dist/client/index.js

@@ -1,5 +1,5 @@
 'use client';
-import { publishSiteCredential } from '../chunk-HGFAEDG3.js';
+import { publishSiteCredential } from '../chunk-VF4F5WXZ.js';
 export { useDeferredActivation } from '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
@@ -7,8 +7,8 @@ export { trackConversion, trackEvent } from '../chunk-LCDVPAMR.js';
 export { VISUAL_VIEWPORT_GAP_PROPERTY, VisualViewportGap, useVisualViewportGap } from '../chunk-6T6CQVNL.js';
 export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity } from '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/client/SiteKitCredential.tsx

package/dist/commerce/index.js

@@ -1,15 +1,15 @@
 'use client';
 import '../chunk-P5GB6NEO.js';
-import { useAnalyticsOptional } from '../chunk-JWTQS5F5.js';
+import { useAnalyticsOptional } from '../chunk-MKMD2HJW.js';
 import '../chunk-LCDVPAMR.js';
 import '../chunk-24QZEO3Q.js';
 import '../chunk-L2V5PUFN.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import { sonorFetch } from '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import { sonorFetch } from '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import React5, { useState, useEffect, useMemo, useRef, useCallback } from 'react';

package/dist/engage/index.js

@@ -1,12 +1,12 @@
 'use client';
 export { SONOR_PUBLIC_ECHO_DEFAULTS, getEchoWidgetProps } from '../chunk-HODO5BX5.js';
-export { ChatWidget } from '../chunk-64DKGVEI.js';
-import { SiteChat } from '../chunk-NV72HZ4W.js';
+export { ChatWidget } from '../chunk-O5RGXTWU.js';
+import { SiteChat } from '../chunk-RDPW4D33.js';
 import '../chunk-6T6CQVNL.js';
 import '../chunk-JE4A5S4F.js';
-import { SitePopups } from '../chunk-EJVQJCG5.js';
+import { SitePopups } from '../chunk-YJLS6JBI.js';
 import '../chunk-27FISYK4.js';
-import '../chunk-FR6BYFPC.js';
+import '../chunk-EPT6FJUY.js';
 import '../chunk-Q6E4OPGG.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-5SQK3D53.js';
@@ -18,9 +18,9 @@ import '../chunk-L2V5PUFN.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 

package/dist/fleet/index.js

@@ -1,10 +1,10 @@
 'use client';
-export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-CF5QNFYU.js';
+export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-UPRSH6Q4.js';
 export { FLEET_CONTRACT_VERSION, FLEET_MODULES, FLEET_MODULES_MAX, FLEET_SITE_MAX_LENGTH, FLEET_VERSION_MAX_LENGTH, FLEET_VERSION_PATTERN, buildFleetHeartbeatPayload, isFleetModule, normalizeFleetModules, normalizeFleetSite, sanitizeFleetVersion } from '../chunk-ZTZQPYP6.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';

package/dist/forms/index.js

@@ -1,13 +1,13 @@
 'use client';
 export { FormCelebration } from '../chunk-YGGDU6C3.js';
-export { FormClient, ManagedForm } from '../chunk-IAM3D3RL.js';
-import '../chunk-D5DCBD4Y.js';
+export { FormClient, ManagedForm } from '../chunk-WGIDC6QP.js';
+import '../chunk-ZKHI4E2B.js';
 export { DatePicker } from '../chunk-SOD2F6C2.js';
-export { FormEnhancer } from '../chunk-OWZ7ATLZ.js';
+export { FormEnhancer } from '../chunk-MVR4FY5R.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-DXO6SBMD.js';
 export { FormField as FormFieldComponent } from '../chunk-4NTBQNHA.js';
-export { useForm, useFormTracking } from '../chunk-FR6BYFPC.js';
+export { useForm, useFormTracking } from '../chunk-EPT6FJUY.js';
 import '../chunk-Q6E4OPGG.js';
 import '../chunk-C2FZBUSS.js';
 export { DEFAULT_FORM_SUCCESS_MESSAGE } from '../chunk-5SQK3D53.js';
@@ -15,9 +15,9 @@ import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
 import '../chunk-L2V5PUFN.js';
 import '../chunk-GJWI74ZZ.js';
-import { sonorFetch } from '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import { sonorFetch } from '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/forms/formsApi.ts

package/dist/forms/server.js

@@ -1,5 +1,5 @@
-export { ServerForm, getFormConfig } from '../chunk-5V2V5C3Y.js';
-import '../chunk-OWZ7ATLZ.js';
+export { ServerForm, getFormConfig } from '../chunk-XLSQTTUE.js';
+import '../chunk-MVR4FY5R.js';
 import '../chunk-YC7ELZS3.js';
 export { StaticForm } from '../chunk-ZTLMPUO6.js';
 import '../chunk-DXO6SBMD.js';

package/dist/images/index.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-JMLK6MH7.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-ZHS2XFLV.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';

package/dist/index.js

@@ -1,2 +1,2 @@
-export { SITE_KIT_VERSION } from './chunk-F24FNCTK.js';
+export { SITE_KIT_VERSION } from './chunk-56KNHB4U.js';
 import './chunk-PKBMQBKP.js';

package/dist/layout/client.js

@@ -1,10 +1,10 @@
 'use client';
-export { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
+export { SiteKitClientProviders } from '../chunk-2AD3CDRR.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-HGFAEDG3.js';
-import '../chunk-CF5QNFYU.js';
+import '../chunk-VF4F5WXZ.js';
+import '../chunk-UPRSH6Q4.js';
 import '../chunk-ZTZQPYP6.js';
-import '../chunk-S54ECQGY.js';
+import '../chunk-CYUFBKJQ.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
@@ -12,7 +12,7 @@ import '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';

package/dist/layout/index.js

@@ -1,12 +1,12 @@
-import { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
+import { SiteKitClientProviders } from '../chunk-2AD3CDRR.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-HGFAEDG3.js';
-import '../chunk-CF5QNFYU.js';
+import '../chunk-VF4F5WXZ.js';
+import '../chunk-UPRSH6Q4.js';
 import '../chunk-ZTZQPYP6.js';
 import { ManagedFavicon } from '../chunk-GW7GSBO7.js';
-import '../chunk-S54ECQGY.js';
+import '../chunk-CYUFBKJQ.js';
 import '../chunk-YC7ELZS3.js';
-import { resolveClientCredential } from '../chunk-RPZ7OQGD.js';
+import { resolveClientCredential } from '../chunk-DNPNYWVL.js';
 import '../chunk-VX5CMNMM.js';
 import { ManagedScripts } from '../chunk-MVLMXC44.js';
 import { resolveApiOrigin } from '../chunk-X6F6SO4S.js';
@@ -17,9 +17,9 @@ import '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/dist/llms/agent-access.d.ts

@@ -14,6 +14,10 @@ export interface AgentAccessOptions {
     endpoint?: string;
     /** The server card's path (default `/.well-known/mcp-server-card`). */
     card?: string;
+    /** Optional AI catalog path. Only set when the site serves this experimental discovery document. */
+    catalog?: string;
+    /** Place discovery before the first content section, preserving the title and introduction. */
+    position?: 'after-intro' | 'end';
     /** Tool names worth naming, e.g. the built-in ones. Optional. */
     tools?: string[];
 }

package/dist/llms/index.js

@@ -1,10 +1,10 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-BC4Y3S3D.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-WDQB4OXY.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-VHKEF5ZB.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-NI2XNEMR.js';
 import '../chunk-XTRZGXB2.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-QL6XNPSD.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-Z65DHMTW.js';
 export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-6U3VLV2C.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
@@ -15,5 +15,5 @@ import '../chunk-MJP63SSS.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-F24FNCTK.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';

package/dist/maps/index.js

@@ -1,8 +1,8 @@
 'use client';
 import { monotonicMs } from '../chunk-MH2DSGC6.js';
-import { sonorFetch } from '../chunk-D6ZC7XKZ.js';
-import '../chunk-K4ZHAURD.js';
-import '../chunk-F24FNCTK.js';
+import { sonorFetch } from '../chunk-BEBR4OJD.js';
+import '../chunk-WGG6GTKW.js';
+import '../chunk-56KNHB4U.js';
 import '../chunk-PKBMQBKP.js';
 import { useState, useCallback, useEffect } from 'react';
 import { APIProvider, Map as Map$1, AdvancedMarker, Pin, InfoWindow } from '@vis.gl/react-google-maps';

package/dist/mcp/WebMcpTools.d.ts

@@ -29,11 +29,12 @@ export interface WebMcpToolsProps {
     /** MCP endpoint on this origin (default `/api/mcp`). */
     endpoint?: string;
     /**
-     * Wait for the page to go quiet before registering (default true).
+     * Wait for the page to go quiet before registering (default false).
      *
-     * Registration is not user-visible and must never compete with hydration.
-     * An agent arriving at the page polls or listens for `toolchange`, so a
-     * couple of hundred milliseconds costs nothing; a blocked LCP costs a lot.
+     * Supported browsers discover tools as soon as this component mounts, so
+     * an agent need not wait for window load, idle, or a human interaction.
+     * Pass true to retain load + idle activation. Unsupported browsers never
+     * fetch a catalog or register tools, regardless of this setting.
      */
     defer?: boolean;
     /**

package/dist/mcp/client.js

@@ -6,21 +6,28 @@ import { useEffect } from 'react';
 function getModelContext() {
   if (typeof window === "undefined") return null;
   const doc = document;
-  if (doc.modelContext) return doc.modelContext;
   const nav = navigator;
-  return nav.modelContext ?? null;
+  for (const context of [doc.modelContext, nav.modelContext]) {
+    if (typeof context?.registerTool === "function" || typeof context?.provideContext === "function") {
+      return context;
+    }
+  }
+  return null;
 }
 function isWebMcpAvailable() {
   return getModelContext() !== null;
 }
+var EMPTY_TOOLS = [];
+var EMPTY_LOCAL_TOOLS = [];
 function WebMcpTools({
-  tools = [],
-  localTools = [],
+  tools = EMPTY_TOOLS,
+  localTools = EMPTY_LOCAL_TOOLS,
   endpoint = "/api/mcp",
-  defer = true,
+  defer = false,
   discover = true
 }) {
-  const ready = useDeferredActivation(defer);
+  const deferredReady = useDeferredActivation(defer);
+  const ready = !defer || deferredReady;
   useEffect(() => {
     if (!ready) return;
     const modelContext = getModelContext();
@@ -113,7 +120,7 @@ function WebMcpTools({
           await modelContext.provideContext({ tools: definitions });
         }
       } catch (error) {
-        if (process.env.NODE_ENV !== "production") {
+        if (!controller.signal.aborted && process.env.NODE_ENV !== "production") {
           console.warn("[site-kit/mcp] WebMCP registration failed:", error);
         }
       }

package/dist/mcp/discovery.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Experimental domain discovery from the MCP Server Cards discovery draft.
+ * The catalog points at the existing card; it never copies tools or identity
+ * metadata whose authoritative source is the server/card itself.
+ *
+ * @see https://github.com/modelcontextprotocol/ext-server-card/blob/main/docs/discovery.md
+ */
+import type { McpServerInfo } from './types';
+import { MCP_SERVER_CARD_MEDIA_TYPE } from './serverCard';
+export declare const MCP_AI_CATALOG_PATH = "/.well-known/ai-catalog.json";
+export declare const MCP_AI_CATALOG_MEDIA_TYPE = "application/ai-catalog+json";
+export interface McpAiCatalog {
+    specVersion: '1.0';
+    entries: {
+        identifier: string;
+        type: typeof MCP_SERVER_CARD_MEDIA_TYPE;
+        url: string;
+    }[];
+}
+export interface BuildMcpAiCatalogOptions {
+    /** Reuse the server identity; `io.example/weather` becomes `mcp:weather`. */
+    info: Pick<McpServerInfo, 'name'>;
+    /** Explicit public site origin. Never inferred from an untrusted Host header. */
+    baseUrl: string;
+    /** Origin-relative card path, e.g. `/api/mcp/server-card`. */
+    serverCardPath: string;
+}
+/** Build the small, experimental catalog without duplicating the server card. */
+export declare function buildMcpAiCatalog(options: BuildMcpAiCatalogOptions): McpAiCatalog;
+export interface McpAiCatalogHandlerOptions extends BuildMcpAiCatalogOptions {
+    /** Seconds for `Cache-Control: public, max-age=…` (default 3600). */
+    maxAge?: number;
+}
+export interface McpDiscoveryRouteHandlers {
+    GET: (request?: Request) => Promise<Response>;
+    OPTIONS: () => Promise<Response>;
+}
+/**
+ * Serve the experimental catalog at `MCP_AI_CATALOG_PATH`. This static-safe
+ * handler leaves conditional ETag requests to the host/CDN, like llms.txt and
+ * the default card handler; it never reads incoming request headers.
+ */
+export declare function createMcpAiCatalogHandler(options: McpAiCatalogHandlerOptions): McpDiscoveryRouteHandlers;
+/** Shared public response policy for catalogs and cards; not an auth surface. */
+export declare function createMcpDiscoveryHandlers(document: unknown, options: {
+    mediaType: string;
+    maxAge?: number;
+}): McpDiscoveryRouteHandlers;

package/dist/mcp/handlers.d.ts

@@ -14,7 +14,8 @@
  */
 import { MCP_SUPPORTED_PROTOCOL_VERSIONS, type DispatchOutcome, type JsonRpcRequest, type McpServerDefinition } from './protocol';
 import type { McpToolCallRecord } from './types';
-import { type BuildMcpServerCardOptions } from './serverCard';
+import { type BuildMcpServerCardOptions, MCP_SERVER_CARD_MEDIA_TYPE } from './serverCard';
+import { type McpDiscoveryRouteHandlers } from './discovery';
 /**
  * Undo the spec's Base64 sentinel wrapper: `=?base64?{b64}?=`.
  * Values that aren't wrapped come back untouched.
@@ -74,18 +75,23 @@ export declare function createMcpHandler(options: McpHandlerOptions): McpRouteHa
 export interface McpServerCardHandlerOptions extends BuildMcpServerCardOptions {
     /** Seconds for `Cache-Control: public, max-age=…` (default 3600). */
     maxAge?: number;
+    /**
+     * Use the draft media type for a new canonical card URL. Existing routes
+     * default to application/json for compatibility. Both remain static-safe.
+     */
+    contentType?: 'application/json' | typeof MCP_SERVER_CARD_MEDIA_TYPE;
 }
-export interface McpServerCardRouteHandlers {
-    GET: () => Promise<Response>;
-    OPTIONS: () => Promise<Response>;
+export interface McpServerCardRouteHandlers extends McpDiscoveryRouteHandlers {
 }
 /**
- * Serve the SEP-2127 server card. Mount at BOTH well-known paths.
+ * Serve the server card. Keep both existing well-known paths available; the
+ * experimental AI Catalog can also point to an alias under the MCP endpoint.
  *
- * The handler never reads the incoming Request, so the route stays statically
+ * The handler never reads Request, so the route stays statically
  * prerenderable — the same constraint the llms.txt handlers document, and for
  * the same reason: touching `request.headers` opts the route into dynamic
- * rendering and it stops being served from the CDN.
+ * rendering. ETag validation is left to the host/CDN. Canonical card routes
+ * can use `contentType: MCP_SERVER_CARD_MEDIA_TYPE`; legacy aliases keep JSON.
  *
  * @example
  * ```ts

package/dist/mcp/index.d.ts

@@ -8,8 +8,8 @@
  *
  *   1. Remote MCP endpoint — `createMcpHandler`. Streamable HTTP, dual-era
  *      (2026-07-28 modern + the `initialize` handshake older clients speak).
- *   2. Discovery — `createMcpServerCardHandler`, the SEP-2127 card served at
- *      `/.well-known/mcp-server-card` and `/.well-known/mcp.json`.
+ *   2. Discovery — `createMcpAiCatalogHandler` (experimental draft) points to
+ *      `createMcpServerCardHandler`; existing well-known card URLs still work.
  *   3. In-page WebMCP — `<WebMcpTools>` (imperative) and
  *      `declarativeToolForm` (declarative), for browser-driving agents.
  *
@@ -20,8 +20,10 @@ export type { JsonSchemaNode, JsonSchemaObject, McpContent, McpTextContent, McpR
 export { defineMcpTool } from './types';
 export { MCP_PROTOCOL_VERSION_MODERN, MCP_PROTOCOL_VERSIONS_LEGACY, MCP_SUPPORTED_PROTOCOL_VERSIONS, META_PROTOCOL_VERSION, META_CLIENT_INFO, META_SERVER_INFO, MCP_ERROR_HEADER_MISMATCH, MCP_ERROR_UNSUPPORTED_PROTOCOL_VERSION, JSONRPC_METHOD_NOT_FOUND, dispatch, toToolResult, toolErrorResult, toToolDescriptor, validateArgs, isSupportedVersion, } from './protocol';
 export type { JsonRpcRequest, JsonRpcResponse, JsonRpcError, DispatchOutcome, DispatchOptions, McpServerDefinition, McpToolDescriptor, } from './protocol';
-export { buildMcpServerCard, validateMcpServerCard, MCP_SERVER_CARD_SCHEMA, MCP_SERVER_CARD_PATH, MCP_SERVER_CARD_LEGACY_PATH, SITE_KIT_CARD_META_KEY, } from './serverCard';
+export { buildMcpServerCard, validateMcpServerCard, MCP_SERVER_CARD_SCHEMA, MCP_SERVER_CARD_PATH, MCP_SERVER_CARD_LEGACY_PATH, MCP_SERVER_CARD_MEDIA_TYPE, SITE_KIT_CARD_META_KEY, } from './serverCard';
 export type { McpServerCard, McpRemote, BuildMcpServerCardOptions, } from './serverCard';
+export { buildMcpAiCatalog, createMcpAiCatalogHandler, MCP_AI_CATALOG_PATH, MCP_AI_CATALOG_MEDIA_TYPE, } from './discovery';
+export type { McpAiCatalog, BuildMcpAiCatalogOptions, McpAiCatalogHandlerOptions, McpDiscoveryRouteHandlers, } from './discovery';
 export { createMcpHandler, createMcpServerCardHandler, decodeHeaderValue, toolCallRecord, WEBMCP_SURFACE_HEADER, } from './handlers';
 export type { McpHandlerOptions, McpRouteHandlers, McpServerCardHandlerOptions, McpServerCardRouteHandlers, } from './handlers';
 export { declarativeToolForm, declarativeToolField } from './declarative';