@sonordev/site-kit 7.1.1 → 7.2.0

package/dist/forms/submitForm.d.ts

@@ -24,17 +24,24 @@ export interface SubmitFormArgs {
     honeypotValue: string;
     /** Timestamp (ms) the form was first rendered — a weak anti-bot timing signal. */
     formLoadedAt: number;
+    /**
+     * The browser reported that an AI agent pressed submit (WebMCP's
+     * `SubmitEvent.agentInvoked`). Sent so Sonor can tag the lead for the
+     * business; it is the browser's word, so it never changes how the
+     * submission is checked.
+     */
+    agentInvoked?: boolean;
 }
 /**
  * Submit a managed form. Throws on failure (network, timeout, or a non-2xx
  * response) with a human-readable message; resolves with the parsed API
  * response on success.
  */
-export declare function submitForm({ config, values, honeypotValue, formLoadedAt, }: SubmitFormArgs): Promise<FormSubmitResult>;
+export declare function submitForm({ config, values, honeypotValue, formLoadedAt, agentInvoked, }: SubmitFormArgs): Promise<FormSubmitResult>;
 /**
  * The receipt Sonor returns plus the values that were sent. `onSuccess`
  * callers need the values (free-audit reads the website and email back), and
- * the receipt alone never carried them: upforge.io's free-audit handler read
+ * the receipt alone never carried them: a site's free-audit handler read
  * `submission.data`, always got undefined, and sent its audit request with no
  * email or URL.
  */

package/dist/forms/types.d.ts

@@ -88,7 +88,7 @@ export interface FormField {
     destination_field?: string;
     /**
      * What the form says back once this field's row is answered, replacing the
-     * built-in sentence ("Nice to meet you, Ramsey."). Set per field in Sonor;
+     * built-in sentence ("Nice to meet you, Jordan."). Set per field in Sonor;
      * the first field in a row that defines one wins. Supports tokens:
      * `{value}` (this field's answer), `{label}`, `{first_name}`, and
      * `{slug}` for any other field's answer, e.g.
@@ -127,6 +127,45 @@ export interface ConditionalLogic {
  * on purpose (a bot must not learn it was caught), so nothing here says
  * whether the lead was accepted, routed or scored.
  */
+/**
+ * Options for a managed form's `submit()`. All optional; `submit()` with no
+ * argument behaves exactly as it always has.
+ */
+export interface FormSubmitOptions {
+    /**
+     * The browser reported that an AI agent pressed submit (WebMCP's
+     * `SubmitEvent.agentInvoked`). Sonor tags the lead so the business can see
+     * how agent-sent leads compare; it changes nothing else about the submit.
+     */
+    agentInvoked?: boolean;
+    /**
+     * Values found in the form's controls that React state never received (a
+     * control set without an input event). Merged over blank state values
+     * before validating. See form-dom-values.ts.
+     */
+    domFills?: Record<string, unknown>;
+}
+/**
+ * What `submit()` resolves with. Callers that ignore it keep working; an
+ * agent that submitted through WebMCP is handed this as its result.
+ */
+export type FormSubmitOutcome = {
+    status: 'sent';
+    message: string;
+    submissionId?: string;
+} | {
+    status: 'invalid';
+    errors: Record<string, string>;
+} | {
+    status: 'failed';
+    message: string;
+} | {
+    status: 'busy';
+} | {
+    status: 'next_step';
+    step: number;
+    totalSteps: number;
+};
 export interface FormSubmitResult {
     success: boolean;
     /** The form_submissions row id (same as submissionId). */
@@ -166,7 +205,7 @@ export interface FormAnalytics {
  * - 'spotlight' — THE 4.0 DEFAULT. The classic layout, alive: a glowing ring
  *                 visits the active field, and each completed row collapses
  *                 into a sentence the form says back ("Nice to meet you,
- *                 Ramsey.") with an edit affordance to reopen it.
+ *                 Jordan.") with an edit affordance to reopen it.
  * - 'stage'     — accordion: beats expand/collapse on one surface, answered
  *                 beats settle into filled rows
  * - 'classic'   — the plain grid form, no choreography
@@ -197,7 +236,7 @@ export interface ExperienceRenderProps {
     isFieldVisible: (field: FormField) => boolean;
     fieldIsComplete: (field: FormField) => boolean;
     applyFieldError: (slug: string, error: string) => void;
-    submit: () => Promise<void>;
+    submit: (options?: FormSubmitOptions) => Promise<FormSubmitOutcome>;
     trackStepChange: (step: number) => void;
     /** Pass to each FormField's onFocus/onBlur (field_interactions). */
     trackFieldFocus: (slug: string) => void;
@@ -206,7 +245,7 @@ export interface ExperienceRenderProps {
     honeypot: React.ReactNode;
 }
 export interface ManagedFormProps {
-    /** Form key from Portal */
+    /** Form key from Sonor */
     formId: string;
     /** @deprecated Project is resolved from API key by the backend. Omit this prop. */
     projectId?: string;
@@ -269,7 +308,7 @@ export interface FormRenderProps {
     /** Go to specific step */
     goToStep: (step: number) => void;
     /** Submit the form */
-    submit: () => Promise<void>;
+    submit: (options?: FormSubmitOptions) => Promise<FormSubmitOutcome>;
     /** Set field value */
     setFieldValue: (key: string, value: unknown) => void;
     /** Check if field should be visible (conditional logic) */

package/dist/forms/useForm.d.ts

@@ -9,7 +9,7 @@
  * const { form, fields, values, errors, setFieldValue, submit, isSubmitting } = useForm('contact-form')
  *
  * return (
- *   <form onSubmit={(e) => { e.preventDefault(); submit() }}>
+ *   <form {...toolAttributes} onSubmit={handleSubmit}>
  *     {fields.map(field => (
  *       <MyCustomInput
  *         key={field.slug}
@@ -24,7 +24,9 @@
  * )
  * ```
  */
-import type { ManagedFormConfig, FormField, FormSubmitResult } from './types';
+import type { DeclarativeToolFormAttributes } from '../mcp/declarative';
+import type { FormEvent } from 'react';
+import type { ManagedFormConfig, FormField, FormSubmitOptions, FormSubmitOutcome, FormSubmitResult } from './types';
 export interface UseFormOptions {
     /** Project ID (defaults to SiteKitLayout config) */
     projectId?: string;
@@ -98,8 +100,23 @@ export interface UseFormReturn {
     validateField: (field: FormField) => string | null;
     /** Check if a field is visible (conditional logic) */
     isFieldVisible: (field: FormField) => boolean;
-    /** Submit the form */
-    submit: () => Promise<void>;
+    /**
+     * Submit the form. Resolves with what happened (sent, invalid, failed,
+     * busy); ignoring the result is fine.
+     */
+    submit: (options?: FormSubmitOptions) => Promise<FormSubmitOutcome>;
+    /**
+     * A ready-made `<form onSubmit>`: prevents the native submit, moves to the
+     * next step or submits, and hands an AI agent that submitted through
+     * WebMCP the outcome. Prefer it to calling `submit()` yourself.
+     */
+    handleSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    /**
+     * WebMCP attributes for your `<form>` (`toolname`, `tooldescription`), so
+     * a browser agent can fill it as a tool. Spread them on the form element.
+     * Null until the form config loads.
+     */
+    toolAttributes: DeclarativeToolFormAttributes | null;
     /** Submission state */
     isSubmitting: boolean;
     isComplete: boolean;

package/dist/forms/webmcp.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @sonordev/site-kit/forms - managed forms as WebMCP tools
+ *
+ * Every managed form carries the declarative WebMCP attributes (`toolname`,
+ * `tooldescription`), so a browser agent can treat it as a tool: it fills the
+ * same controls a person would and the submit runs the same validation and
+ * files the same lead. There is deliberately no `toolautosubmit`. The agent
+ * fills the fields and the person it's helping presses Send, which is the
+ * right default for anything that files a lead or sends a message.
+ *
+ * Browsers that don't implement WebMCP ignore the attributes. Each field's
+ * label is what an agent reads to understand it (FormField adds the help
+ * text as `toolparamdescription` where there is some).
+ *
+ * Single source of truth for a managed form's tool name and description, and
+ * for reading an agent's submit (`SubmitEvent.agentInvoked`, `respondWith`).
+ * FormClient, FormSpotlight, FormStage, StaticForm and useForm all use it.
+ */
+import { type DeclarativeToolFormAttributes } from '../mcp/declarative';
+import type { ManagedFormConfig } from './types';
+/** `contact-page` -> `submit_contact_page`. Stable, snake_case, unique per form. */
+export declare function formToolName(config: Pick<ManagedFormConfig, 'slug'>): string;
+/** The tool description an agent reads to decide whether this form is the one. */
+export declare function formToolDescription(config: Pick<ManagedFormConfig, 'name' | 'form_type' | 'description'>): string;
+/** Spread onto the managed form's `<form>` element. */
+export declare function formToolAttributes(config: Pick<ManagedFormConfig, 'slug' | 'name' | 'form_type' | 'description'>): DeclarativeToolFormAttributes;
+export interface AgentSubmit {
+    /** True when the browser reports that an AI agent submitted the form. */
+    invoked: boolean;
+    /**
+     * Hand the agent the outcome of its submit. Call it synchronously inside
+     * the submit handler, after `preventDefault()`. A no-op unless an agent
+     * submitted and the browser supports `respondWith`.
+     */
+    respond: (outcome: Promise<unknown>) => void;
+}
+/** Read an agent's submit off a native SubmitEvent (`e.nativeEvent` in React). */
+export declare function readAgentSubmit(event: Event | null | undefined): AgentSubmit;

package/dist/images/ManagedFavicon.d.ts

@@ -30,7 +30,7 @@
 import React from 'react';
 export interface ManagedFaviconProps {
     /**
-     * API key for Portal API authentication
+     * API key for Sonor API authentication
      * Defaults to SONOR_API_KEY env var
      */
     apiKey?: string;

package/dist/images/ManagedImage.d.ts

@@ -1,8 +1,8 @@
 /**
- * ManagedImage - Portal-managed image component
+ * ManagedImage - Sonor-managed image component
  *
  * Features:
- * - Fetches images from Portal API via API key (never direct Supabase)
+ * - Fetches images from Sonor API via API key (never direct Supabase)
  * - Dev mode: Click to open image picker modal
  * - Supports responsive variants
  * - Automatic focal point handling
@@ -43,7 +43,7 @@ export interface ImageFile {
     public_url?: string;
 }
 export interface ManagedImageProps {
-    /** API key for Portal API */
+    /** API key for Sonor API */
     apiKey?: string;
     /** API URL (defaults to https://api.sonor.io) */
     apiUrl?: string;
@@ -51,7 +51,7 @@ export interface ManagedImageProps {
     slotId: string;
     /** Page path for page-specific slots (defaults to current path) */
     pagePath?: string;
-    /** Fallback alt text if not set in Portal */
+    /** Fallback alt text if not set in Sonor */
     alt?: string;
     /** CSS class names */
     className?: string;

package/dist/images/api.d.ts

@@ -1,7 +1,7 @@
 /**
  * Images API functions
  *
- * All functions use Portal API with API key authentication.
+ * All functions use Sonor API with API key authentication.
  * Never makes direct Supabase calls.
  */
 import type { ManagedImageData, ImageFile } from './ManagedImage';

package/dist/images/index.d.ts

@@ -1,8 +1,8 @@
 /**
  * @sonordev/site-kit Images Module
  *
- * Provides managed image components for Portal integration.
- * All API calls go through Portal API with API key auth.
+ * Provides managed image components for Sonor integration.
+ * All API calls go through Sonor API with API key auth.
  */
 export { ManagedImage } from './ManagedImage';
 export type { ManagedImageProps, ManagedImageData, ImageFile } from './ManagedImage';

package/dist/images/index.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-542MIHNP.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-JMLK6MH7.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/index.d.ts

@@ -15,7 +15,10 @@
 export { SITE_KIT_VERSION } from './shared/version';
 export type { ManagedMetadataResult, ManagedSchemaProps, ManagedFAQData } from './seo/types';
 export type { AnalyticsConfig, AnalyticsEvent, PageView } from './analytics/types';
-export type { EngageElement, WidgetConfig, ChatConfig } from './engage/types';
+export type { ChatConfig } from './chat/types';
+export type { SitePopup } from './website/popup-types';
+/** Deprecated names (engage was retired): SitePopup and SitePopupConfig. */
+export type { EngageElement, WidgetConfig } from './engage/types';
 export type { ManagedFormConfig, FormSubmission, FormSubmitResult, FormField } from './forms/types';
 export type { Article as ArticleType, ArticleAuthor, ArticleCategory } from './articles/types';
 export type { CommerceOffering, CommerceCategory, CommerceVariant, CommerceSchedule, OfferingType, Cart, CartItem, } from './commerce/types';

package/dist/index.js

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

package/dist/landing/contract.d.ts

@@ -1,10 +1,9 @@
 /**
  * Landing-page campaign contract.
  *
- * normalizeCampaignSlug is an inlined MIRROR of sonor-api's
- * `src/modules/analytics/utils/campaign.util.ts` (the CANONICAL copy) —
- * keep the function body byte-identical. Both suites assert the same fixed
- * vectors (sonor-api's campaign.util.spec.ts and this package's
+ * normalizeCampaignSlug is an inlined MIRROR of the Sonor API's campaign
+ * normalizer (the CANONICAL copy); keep the function body byte-identical.
+ * Both sides assert the same fixed vectors (this package's
  * landing/contract.test.ts), so silent drift fails CI on either side.
  *
  * A slug normalized here always matches the server's canonical form, so the

package/dist/layout/SiteKitClientProviders.d.ts

@@ -2,7 +2,7 @@
  * SiteKitClientProviders — Client Island
  *
  * This is the 'use client' boundary for SiteKitLayout.
- * It composes the client-only providers (Analytics, Engage, Signal, SitemapSync)
+ * It composes the client-only providers (Analytics, chat, popups, Signal, SitemapSync)
  * that require React context or browser APIs.
  *
  * All modules are lazy-loaded via next/dynamic so their JS is only downloaded
@@ -10,7 +10,7 @@
  *
  * All modules share a unified identity (visitor ID + session ID) read from
  * the storage-backed singleton (shared/identity), ensuring consistent
- * tracking across Analytics, Signal, and Engage.
+ * tracking across Analytics, Signal, chat and popups.
  *
  * 4.0 INVARIANT — CHILDREN ARE NEVER WRAPPED. Every module here renders as a
  * childless sibling AFTER {children}; nothing provides context around page
@@ -37,7 +37,7 @@ export interface SiteKitClientProvidersProps {
     signal?: boolean | SignalConfig;
     /**
      * Runtime SitemapSync from the visitor's browser. Default FALSE — sitemap
-     * registration belongs to build time and to sonor-api's nightly reconciler,
+     * registration belongs to build time and to Sonor's nightly reconciler,
      * not to whoever happens to load the page. See SiteKitLayout for the full
      * reasoning; in short, its guards live in session/localStorage, so every new
      * visitor missed them and re-POSTed the whole sitemap.
@@ -56,7 +56,7 @@ export interface SiteKitClientProvidersProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer Analytics / Engage / SitemapSync until window load + idle or first
+     * Defer Analytics / chat / popups / SitemapSync until window load + idle or first
      * interaction (default true). Pass false to restore legacy eager mounting
      * on hydration. SignalBridge is never deferred — it must apply experiment
      * variants as early as possible.

package/dist/layout/SiteKitLayout.d.ts

@@ -5,15 +5,15 @@
  * site-kit feature your layout needs:
  *
  * Server-side (RSC):
- *   - ManagedFavicon (link tags from Portal logo)
+ *   - ManagedFavicon (link tags from the project logo in Sonor)
  *   - ManagedScripts position="head" (tracking pixels, analytics tags)
  *   - ManagedScripts position="body-end"
  *
  * Client-side (island):
  *   - AnalyticsProvider (page views, scroll depth, heatmap, web vitals)
- *   - EngageWidget (popups, nudges, chat)
+ *   - SitePopups (Website → Popups & Banners) and SiteChat (Website chat)
  *   - SignalBridge (A/B experiments, behavior tracking)
- *   - SitemapSync (keeps Portal seo_pages in sync)
+ *   - SitemapSync (keeps Sonor seo_pages in sync)
  *
  * @example
  * ```tsx
@@ -37,7 +37,7 @@
  *
  * @example Opt out of specific features:
  * ```tsx
- * <SiteKitLayout engage={false} signal={false}>
+ * <SiteKitLayout chat={false} popups={false} signal={false}>
  *   {children}
  * </SiteKitLayout>
  * ```
@@ -46,11 +46,11 @@ import * as React from 'react';
 import type { AnalyticsConfig, ChatLayoutConfig, DesignConfig, EngageConfig, SignalConfig } from './types';
 export interface SiteKitLayoutProps {
     children: React.ReactNode;
-    /** Portal API key. Defaults to SONOR_API_KEY env var. */
+    /** Sonor API key. Defaults to SONOR_API_KEY env var. */
     apiKey?: string;
-    /** Portal API URL. Defaults to env or https://api.sonor.io */
+    /** Sonor API URL. Defaults to env or https://api.sonor.io */
     apiUrl?: string;
-    /** Project ID (for Engage chat room routing). Auto-resolved if not provided. */
+    /** Project ID (for chat routing). Auto-resolved if not provided. */
     projectId?: string;
     /** Analytics tracking. true (default) | false | config object */
     analytics?: boolean | AnalyticsConfig;
@@ -69,13 +69,13 @@ export interface SiteKitLayoutProps {
      * Runtime SitemapSync from the visitor's browser. **Default: false.**
      *
      * Sitemap registration is a build-time and server-side job. Build-time
-     * `createSitemap` is canonical, and sonor-api's nightly reconciler fetches
+     * `createSitemap` is canonical, and Sonor's nightly reconciler fetches
      * each host's /sitemap.xml itself, so nothing here needs a visitor.
      *
      * This defaulted to true, and because its throttle lives in sessionStorage
      * and its content hash in localStorage, every first-time visitor, incognito
-     * tab and crawler missed both guards and re-POSTed the entire sitemap:
-     * upforge.io took ~140 full syncs in a day, queencityriverboats.com ~76.
+     * tab and crawler missed both guards and re-POSTed the entire sitemap, so
+     * a busy site took well over a hundred full syncs a day.
      * That coupled sitemap traffic to VISITOR COUNT rather than to content
      * changes — exactly backwards — and made every reader pay for platform
      * bookkeeping in bandwidth, XML parsing and an API round-trip.
@@ -100,7 +100,7 @@ export interface SiteKitLayoutProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer client modules (Analytics, Engage, SitemapSync) until window load +
+     * Defer client modules (Analytics, chat, popups, SitemapSync) until window load +
      * idle or the first user interaction, keeping their JS and mount work out of
      * the critical hydration path. Default: true. Pass false to restore legacy
      * eager mounting. SignalBridge is never deferred.

package/dist/layout/client.d.ts

@@ -2,7 +2,7 @@
  * SiteKitClientProviders — Client Island
  *
  * This is the 'use client' boundary for SiteKitLayout.
- * It composes the client-only providers (Analytics, Engage, Signal, SitemapSync)
+ * It composes the client-only providers (Analytics, chat, popups, Signal, SitemapSync)
  * that require React context or browser APIs.
  *
  * All modules are lazy-loaded via next/dynamic so their JS is only downloaded
@@ -10,7 +10,7 @@
  *
  * All modules share a unified identity (visitor ID + session ID) read from
  * the storage-backed singleton (shared/identity), ensuring consistent
- * tracking across Analytics, Signal, and Engage.
+ * tracking across Analytics, Signal, chat and popups.
  *
  * 4.0 INVARIANT — CHILDREN ARE NEVER WRAPPED. Every module here renders as a
  * childless sibling AFTER {children}; nothing provides context around page
@@ -37,7 +37,7 @@ export interface SiteKitClientProvidersProps {
     signal?: boolean | SignalConfig;
     /**
      * Runtime SitemapSync from the visitor's browser. Default FALSE — sitemap
-     * registration belongs to build time and to sonor-api's nightly reconciler,
+     * registration belongs to build time and to Sonor's nightly reconciler,
      * not to whoever happens to load the page. See SiteKitLayout for the full
      * reasoning; in short, its guards live in session/localStorage, so every new
      * visitor missed them and re-POSTed the whole sitemap.
@@ -56,7 +56,7 @@ export interface SiteKitClientProvidersProps {
      */
     design?: boolean | DesignConfig;
     /**
-     * Defer Analytics / Engage / SitemapSync until window load + idle or first
+     * Defer Analytics / chat / popups / SitemapSync until window load + idle or first
      * interaction (default true). Pass false to restore legacy eager mounting
      * on hydration. SignalBridge is never deferred — it must apply experiment
      * variants as early as possible.

package/dist/layout/client.js

@@ -1,10 +1,10 @@
 'use client';
-export { SiteKitClientProviders } from '../chunk-ILAW3XKD.js';
+export { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-DUQMSNF2.js';
-import '../chunk-H42PZKVC.js';
+import '../chunk-HGFAEDG3.js';
+import '../chunk-CF5QNFYU.js';
 import '../chunk-ZTZQPYP6.js';
-import '../chunk-Q3S26EQA.js';
+import '../chunk-S54ECQGY.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-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/layout/index.js

@@ -1,12 +1,12 @@
-import { SiteKitClientProviders } from '../chunk-ILAW3XKD.js';
+import { SiteKitClientProviders } from '../chunk-VO3JYRT5.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-DUQMSNF2.js';
-import '../chunk-H42PZKVC.js';
+import '../chunk-HGFAEDG3.js';
+import '../chunk-CF5QNFYU.js';
 import '../chunk-ZTZQPYP6.js';
 import { ManagedFavicon } from '../chunk-GW7GSBO7.js';
-import '../chunk-Q3S26EQA.js';
+import '../chunk-S54ECQGY.js';
 import '../chunk-YC7ELZS3.js';
-import { resolveClientCredential } from '../chunk-R3VKF43H.js';
+import { resolveClientCredential } from '../chunk-RPZ7OQGD.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-PXZ7LAOY.js';
-import '../chunk-OUNRFXDC.js';
-import '../chunk-6OL23QYD.js';
+import '../chunk-D6ZC7XKZ.js';
+import '../chunk-K4ZHAURD.js';
+import '../chunk-F24FNCTK.js';
 import '../chunk-PKBMQBKP.js';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/dist/layout/types.d.ts

@@ -3,7 +3,7 @@
  * Kept in a shared file so both server (SiteKitLayout) and client
  * (SiteKitClientProviders) components can reference them.
  */
-import type { ChatLauncherPlacement } from '../engage/types';
+import type { ChatLauncherPlacement } from '../chat/types';
 import type { SiteDesignConfig } from '../website/design';
 /**
  * The site's design, for popups (Website → Popups & Banners). site-kit
@@ -20,7 +20,7 @@ export interface AnalyticsConfig {
     excludePaths?: string[];
     /**
      * Sub-site identifier — the domain/brand this set of pages belongs to under
-     * the Sonor project (e.g. `ohiopowerstudies.com`, `truepowersystems.com`).
+     * the Sonor project (e.g. `ohio.example.com`, `example.com`).
      * Every analytics event is tagged with this dimension so a single Sonor
      * project can host many sites and the dashboard can filter / roll up per
      * site. If omitted, SiteKitLayout falls back to the host of
@@ -33,7 +33,7 @@ export interface AnalyticsConfig {
      *
      * A framed page's visitor is on whoever framed it, not on this site, so by
      * default an embed reports nothing — see `analytics/send-gate.ts` for the
-     * phantom traffic that prompted this (Upforge case studies embed live
+     * phantom traffic that prompted this (agency case studies embed live
      * client sites, and every view was writing page views into the client's own
      * project). Same-origin frames are never blocked: a site embedding itself
      * is a real visit to that site.
@@ -47,9 +47,10 @@ export interface AnalyticsConfig {
     allowLocalhost?: boolean;
 }
 /**
- * Launcher placement (`position`, `offsetBottom`, `zIndex`) comes from
- * ChatLauncherPlacement in engage/types, the one definition every Engage
- * config surface extends.
+ * The deprecated `engage` prop's config. Launcher placement (`position`,
+ * `offsetBottom`, `zIndex`) comes from ChatLauncherPlacement in chat/types,
+ * the one definition every chat config surface extends; `zIndex` also stacks
+ * popups.
  */
 export interface EngageConfig extends ChatLauncherPlacement {
     chatEnabled?: boolean;

package/dist/llms/SpeakableSchema.d.ts

@@ -17,8 +17,8 @@ import type { SpeakableSchemaProps, SpeakableConfig } from './types';
  * // In a page component
  * <SpeakableSchema
  *   type="Article"
- *   name="Family Law Services in Cincinnati"
- *   url="https://heinrichlaw.com/family-law"
+ *   name="Family Law Services in Springfield"
+ *   url="https://example.com/family-law"
  *   speakable={{
  *     cssSelectors: ['.page-summary', '.key-points', 'h1']
  *   }}

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

@@ -24,7 +24,7 @@ export declare function formatAgentAccessSection(baseUrl: string, options?: Agen
 /**
  * Add the section to finished markdown, once. Left out when the markdown
  * already points agents at a server card: a site describing its own MCP
- * server (upforge.io's "Agent interface" section) keeps its own words.
+ * server in a section of its own keeps its own words.
  */
 export declare function appendAgentAccessSection(markdown: string, baseUrl: string, options?: AgentAccessOptions): string;
 /** The markdown already tells agents where an MCP server is. */
@@ -33,7 +33,7 @@ export declare function describesMcp(markdown: string): boolean;
  * - `built-in`: site-kit's Sonor tools (`sonorMcpServer` / `sonorMcpTools`),
  *   what `npx sonor-setup mcp` writes. site-kit's automatic MCP extras (the
  *   llms.txt section) are on for these.
- * - `custom`: the site runs an MCP server of its own (upforge.io). site-kit
+ * - `custom`: the site runs an MCP server of its own. site-kit
  *   leaves it alone: nothing automatic, `sonor-setup mcp` won't write over
  *   it, and anything it adds is opt-in.
  * - `null`: no MCP server.

package/dist/llms/aiRobots.d.ts

@@ -11,8 +11,8 @@
  * - createRobotsTxtHandler(): a plain-text robots.txt route handler.
  *
  * No `Content-Signal` line is ever emitted (6.3.4). Google's robots.txt
- * parser reports it as an "Unknown directive" error in Search Console
- * (cincinnaticondoconnection.com, 2026-09-22), and robots.txt is the one file
+ * parser reports it as an "Unknown directive" error in Search Console, and
+ * robots.txt is the one file
  * that must parse cleanly for every crawler. Training/retrieval preferences
  * are expressed by the per-crawler Allow/Disallow rules instead, which every
  * crawler understands.
@@ -28,8 +28,8 @@
  * Retrieval/search agents — fetch on demand or index for AI search, cite sources.
  *
  * MistralAI-User (Le Chat fetching a page for a user) and YouBot (You.com's
- * search index) were added 2026-09-15: vsf-consulting-nextjs named them in
- * its own robots.txt and had to keep a NOT_YET_IN_KIT list beside this one.
+ * search index) were added 2026-09-15, after a site had to name them in its
+ * own robots.txt beside this list.
  */
 export declare const AI_RETRIEVAL_CRAWLERS: readonly ['OAI-SearchBot', 'ChatGPT-User', 'Claude-SearchBot', 'Claude-User', 'PerplexityBot', 'Perplexity-User', 'GoogleOther', 'Applebot', 'DuckAssistBot', 'MistralAI-User', 'YouBot'];
 /**

package/dist/llms/api.d.ts

@@ -35,7 +35,7 @@ export declare const getFAQItems: (projectId?: string, limit?: number, site?: st
  */
 export declare const getPageSummaries: (projectId?: string, limit?: number, site?: string) => Promise<LLMPageSummary[]>;
 /**
- * Fetch AI-optimized llms.txt markdown from Portal API (build-time)
+ * Fetch AI-optimized llms.txt markdown from Sonor API (build-time)
  * Used by writeLLMsTxtToPublic for static file generation
  *
  * Always fresh (shared/fresh-fetch.ts). With Next's patched fetch and no cache
@@ -44,7 +44,7 @@ export declare const getPageSummaries: (projectId?: string, limit?: number, site
  */
 export declare function getOptimizedLLMsTxt(options?: {
     full?: boolean;
-    /** Matches Portal GET /api/public/llms/txt?publicSummaryOnly=true */
+    /** Matches Sonor GET /api/public/llms/txt?publicSummaryOnly=true */
     publicSummaryOnly?: boolean;
     /**
      * Sub-site host — scopes the page index to THIS domain on multi-site

package/dist/llms/contract.js

@@ -1,2 +1,2 @@
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-4Y5FWDPM.js';
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, clipAtWordBoundary, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-NZ4RXN3G.js';
 import '../chunk-PKBMQBKP.js';

package/dist/llms/generateLLMsTxt.d.ts

@@ -10,7 +10,7 @@
  */
 import type { GenerateLLMSTxtOptions, LLMSTxtContent } from './types';
 /**
- * Generate llms.txt content from Portal data
+ * Generate llms.txt content from Sonor data
  *
  * @example
  * ```ts