@sonordev/site-kit 7.1.2 → 7.3.0

package/dist/{chunk-TXBAOEKG.js → chunk-PKGN32AU.js}

@@ -1,5 +1,6 @@
 import { generateArticleAuthorNode, resolveArticleArtwork, withArticleAuthorIdentity } from './chunk-QXMIKDOL.js';
 import { resolveArticleUrl, createPublicationRoutes, resolvePublicationUrl, articleCategorySlug } from './chunk-WMVK77ND.js';
+import { withoutSchemaPlaceholders } from './chunk-VWWITFWM.js';
 import { withSiteParam, withSiteBody } from './chunk-MJP63SSS.js';
 import { resolveServerApiConfig } from './chunk-X6F6SO4S.js';
 import { notFound } from 'next/navigation';
@@ -959,10 +960,10 @@ function generateBreadcrumbSchema(post, options = {}) {
 }
 function generateAllArticleSchemas(post, options = {}) {
   const schemas = [];
-  const eeatSchema = post.schema ?? post.schema_json;
-  if (eeatSchema) {
-    const arr = Array.isArray(eeatSchema) ? eeatSchema : [eeatSchema];
-    schemas.push(...arr.map((node) => withArticleAuthorIdentity(node, post.author, options)));
+  const eeatSchema = withoutSchemaPlaceholders(post.schema ?? post.schema_json).value;
+  const eeatNodes = eeatSchema ? Array.isArray(eeatSchema) ? eeatSchema : [eeatSchema] : [];
+  if (eeatNodes.length > 0) {
+    schemas.push(...eeatNodes.map((node) => withArticleAuthorIdentity(node, post.author, options)));
   } else {
     schemas.push(generateArticleSchema(post, options));
     const faqItems = post.faq_items ?? post.faqItems;

package/dist/chunk-Q6E4OPGG.js

@@ -0,0 +1,40 @@
+import { declarativeToolForm } from './chunk-HW7B43E5.js';
+
+// src/forms/webmcp.ts
+var DESCRIPTION_BY_TYPE = {
+  prospect: "Send this business an inquiry: a question, a quote request or a project to discuss.",
+  contact: "Send this business a message through its contact form.",
+  support: "Ask this business for help with an existing order, project or account.",
+  feedback: "Send this business feedback.",
+  newsletter: "Sign an email address up for this business's newsletter.",
+  custom: "Submit this form to the business."
+};
+function formToolName(config) {
+  const base = String(config.slug || "").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return `submit_${base || "form"}`.slice(0, 64);
+}
+function formToolDescription(config) {
+  const lead = DESCRIPTION_BY_TYPE[config.form_type] ?? DESCRIPTION_BY_TYPE.custom;
+  const named = config.name ? ` The form is called "${config.name}".` : "";
+  const extra = typeof config.description === "string" ? config.description.trim() : "";
+  return `${lead}${named}${extra ? ` ${extra}` : ""}`.slice(0, 500);
+}
+function formToolAttributes(config) {
+  return declarativeToolForm({ name: formToolName(config), description: formToolDescription(config) });
+}
+function readAgentSubmit(event) {
+  const fields = event ?? {};
+  const invoked = fields.agentInvoked === true;
+  return {
+    invoked,
+    respond: (outcome) => {
+      if (!invoked || typeof fields.respondWith !== "function") return;
+      try {
+        fields.respondWith.call(event, outcome);
+      } catch {
+      }
+    }
+  };
+}
+
+export { formToolAttributes, readAgentSubmit };

package/dist/chunk-RDPW4D33.js

@@ -0,0 +1,45 @@
+'use client';
+import { DEFAULT_WIDGET_Z_INDEX } from './chunk-27FISYK4.js';
+import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
+import { useState, useEffect } from 'react';
+import ReactDOM from 'react-dom';
+import dynamic from 'next/dynamic';
+import { jsx } from 'react/jsx-runtime';
+
+var LazyChatWidget = dynamic(
+  () => import('./ChatWidget-FHBAHFZX.js').then((m) => ({ default: m.ChatWidget })),
+  { ssr: false }
+);
+function SiteChat(props) {
+  const target = resolveAnalyticsTarget(props);
+  if (!target) return null;
+  return /* @__PURE__ */ jsx(IdleChat, { ...props });
+}
+function IdleChat({ projectId, position = "bottom-right", offsetBottom, zIndex = DEFAULT_WIDGET_Z_INDEX }) {
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    const id = typeof requestIdleCallback !== "undefined" ? requestIdleCallback(() => setReady(true), { timeout: 3e3 }) : setTimeout(() => setReady(true), 1);
+    return () => {
+      typeof cancelIdleCallback !== "undefined" ? cancelIdleCallback(id) : clearTimeout(id);
+    };
+  }, []);
+  if (!ready || typeof document === "undefined") return null;
+  return ReactDOM.createPortal(
+    /* @__PURE__ */ jsx(
+      LazyChatWidget,
+      {
+        projectId: projectId ?? void 0,
+        config: {
+          position,
+          offsetBottom,
+          zIndex,
+          buttonColor: "#2563eb"
+          // Default blue-600 (AA on white), overridden by --sk-primary CSS var or API brand_primary
+        }
+      }
+    ),
+    document.body
+  );
+}
+
+export { SiteChat };

package/dist/{chunk-UXOGCKL6.js → chunk-T4DLETKR.js}

@@ -1,7 +1,7 @@
 'use client';
 import { locToPath, isMalformedSitemapPath, inferPageType } from './chunk-YVKRYQRG.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
-import { sonorFetch } from './chunk-3SDOQUUF.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
 import { useRef, useEffect } from 'react';
 
 var SYNC_STAMP_KEY = "_sk_sitemap_synced_at";

package/dist/{chunk-NK4CSJNP.js → chunk-UPRSH6Q4.js}

@@ -2,8 +2,8 @@
 import { sanitizeFleetVersion, buildFleetHeartbeatPayload } from './chunk-ZTZQPYP6.js';
 import { useDeferredActivation } from './chunk-YC7ELZS3.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
-import { sonorFetch } from './chunk-3SDOQUUF.js';
-import { SITE_KIT_VERSION } from './chunk-AH5Q262S.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
+import { SITE_KIT_VERSION } from './chunk-56KNHB4U.js';
 import { useRef, useEffect } from 'react';
 
 // src/fleet/heartbeat.ts

package/dist/{chunk-ERXXITG4.js → chunk-VF4F5WXZ.js}

@@ -1,5 +1,5 @@
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
-import { configureSiteCredential, currentCredential } from './chunk-VDF5DFWT.js';
+import { configureSiteCredential, currentCredential } from './chunk-WGG6GTKW.js';
 
 // src/shared/publishCredential.ts
 function publishSiteCredential({

package/dist/chunk-VWWITFWM.js

@@ -0,0 +1,300 @@
+// src/contracts/schema-placeholders.ts
+var RESERVED_EXAMPLE_DOMAINS = ["example.com", "example.net", "example.org"];
+var RESERVED_EXAMPLE_TLD = "example";
+var PLACEHOLDER_NAMES = /* @__PURE__ */ new Set([
+  "example",
+  "example business",
+  "example company",
+  "example organization",
+  "your business",
+  "your business name",
+  "your company",
+  "your company name",
+  "your organization",
+  "your organization name",
+  "business name",
+  "company name",
+  "organization name",
+  "your name",
+  "lorem ipsum"
+]);
+var NAME_KEYS = /* @__PURE__ */ new Set([
+  "name",
+  "legalName",
+  "alternateName",
+  "author",
+  "creator",
+  "publisher",
+  "brand",
+  "provider",
+  "seller",
+  "manufacturer",
+  "organizer",
+  "founder"
+]);
+var PHONE_KEYS = /* @__PURE__ */ new Set(["telephone", "faxNumber"]);
+var URI_TEMPLATE_KEYS = /* @__PURE__ */ new Set(["target", "urlTemplate"]);
+var BODY_TEXT_KEYS = /* @__PURE__ */ new Set(["articleBody"]);
+var ANNOTATION_KEYS = /* @__PURE__ */ new Set(["note", "notes", "_note", "_notes", "_comment", "_comments", "__comment", "$comment"]);
+var STRUCTURAL_KEYS = /* @__PURE__ */ new Set(["@context", "@type", "@id", "position"]);
+var MUSTACHE_SLOT = /\{\{\s*[#^/>&]?\s*[A-Za-z_$][\w$.[\]-]*\s*\}\}/;
+var JSX_EXPRESSION_VALUE = /^\{\s*[A-Za-z_$][\w$]*(?:\??\.[A-Za-z_$][\w$]*|\[[^\]]*\])+[^{}]*\}$/;
+var JSX_MEMBER_IN_TEXT = /\{\s*[A-Za-z_$][\w$]*(?:\??\.[A-Za-z_$][\w$]*)+\s*\}/;
+var BRACKET_SLOT_VALUE = /^\[\s*[A-Za-z][^[\]"{}<>]{0,80}\]$/;
+var BRACKET_SLOT_IN_TEXT = /\[\s*((?:your|insert your|enter your|add your)\s+[^[\]]{1,60}?|(?:(?:business|company|organization|brand|full|first|last|resident|client|customer|author)\s+)?(?:name|phone(?:\s+number)?|telephone|email(?:\s+address)?|(?:street\s+)?address|city|state|zip(?:\s+code)?|postal\s+code|website|url|logo|date))\s*\](?!\()/gi;
+var REPLACE_MARKER = /\bREPLACE(?:_WITH_\w*|_ME\b)/;
+var UPPER_SLOT_VALUE = /^YOUR_[A-Z0-9_]+$/;
+var MAX_DEPTH = 40;
+var MAX_EVIDENCE = 5;
+var EVIDENCE_VALUE_LENGTH = 120;
+function withoutSchemaPlaceholders(value) {
+  const state = { dropped: [], notes: [] };
+  if (value === null || value === void 0) return { value: null, ...state };
+  const result = visitRoot(value, state);
+  return { value: result, ...state };
+}
+function visitRoot(value, state) {
+  if (Array.isArray(value)) {
+    const out = visitArray(value, "$", state, 0, true);
+    return out.removed && out.value.length === 0 ? null : out.value;
+  }
+  if (!isPlainObject(value)) return value;
+  if (isGraphWrapper(value)) {
+    const out = visitContainer(value, "$", state, 0);
+    return out.removedChild && !hasContentBeyond(out.value, /* @__PURE__ */ new Set(["@context"])) ? null : out.value;
+  }
+  const visit = visitNode(value, "$", state, 0);
+  return visit.keep ? visit.value : null;
+}
+function visitNode(node, path, state, depth) {
+  if (isAnnotationOnly(node)) {
+    state.dropped.push({ path, type: null, reasons: ["annotation"], evidence: annotationEvidence(node) });
+    return { keep: false };
+  }
+  const evidence = [];
+  collectEvidence(node, evidence, depth);
+  if (evidence.length) {
+    state.dropped.push({ path, type: typeOf(node), reasons: unique(evidence.map((e) => e.reason)), evidence });
+    return { keep: false };
+  }
+  const droppedMark = state.dropped.length;
+  const notesMark = state.notes.length;
+  const pruned = visitContainer(node, path, state, depth);
+  if (pruned.removedChild && !hasContentBeyond(pruned.value, STRUCTURAL_KEYS)) {
+    const children = state.dropped.splice(droppedMark);
+    state.notes.length = notesMark;
+    state.dropped.push({
+      path,
+      type: typeOf(node),
+      reasons: unique(["emptied", ...children.flatMap((c) => c.reasons)]),
+      evidence: children.flatMap((c) => c.evidence).slice(0, MAX_EVIDENCE)
+    });
+    return { keep: false };
+  }
+  return { keep: true, value: pruned.value };
+}
+function visitContainer(obj, path, state, depth) {
+  if (depth >= MAX_DEPTH) return { value: obj, removedChild: false };
+  let changed = false;
+  let removedChild = false;
+  const out = {};
+  for (const [key, child] of Object.entries(obj)) {
+    if (key === "@context") {
+      out[key] = child;
+      continue;
+    }
+    if (ANNOTATION_KEYS.has(key)) {
+      state.notes.push({ path, key });
+      changed = true;
+      continue;
+    }
+    const childPath = stepKey(path, key);
+    if (Array.isArray(child)) {
+      const pruned = visitArray(child, childPath, state, depth + 1, key === "@graph");
+      if (pruned.removed) removedChild = true;
+      if (pruned.value !== child) changed = true;
+      if (pruned.removed && pruned.value.length === 0) continue;
+      out[key] = pruned.value;
+      continue;
+    }
+    if (isPlainObject(child)) {
+      if (isNestedNode(child)) {
+        const visit = visitNode(child, childPath, state, depth + 1);
+        if (!visit.keep) {
+          changed = true;
+          removedChild = true;
+          continue;
+        }
+        if (visit.value !== child) changed = true;
+        out[key] = visit.value;
+        continue;
+      }
+      const pruned = visitContainer(child, childPath, state, depth + 1);
+      if (pruned.removedChild) removedChild = true;
+      if (pruned.value !== child) changed = true;
+      out[key] = pruned.value;
+      continue;
+    }
+    out[key] = child;
+  }
+  return { value: changed ? out : obj, removedChild };
+}
+function visitArray(items, path, state, depth, units) {
+  if (depth >= MAX_DEPTH) return { value: items, removed: false };
+  let changed = false;
+  let removed = false;
+  const out = [];
+  items.forEach((item, index) => {
+    const itemPath = `${path}[${index}]`;
+    if (Array.isArray(item)) {
+      const pruned = visitArray(item, itemPath, state, depth + 1, units);
+      if (pruned.removed) removed = true;
+      if (pruned.value !== item) changed = true;
+      out.push(pruned.value);
+      return;
+    }
+    if (isPlainObject(item) && (units || isNestedNode(item))) {
+      const visit = visitNode(item, itemPath, state, depth + 1);
+      if (!visit.keep) {
+        changed = true;
+        removed = true;
+        return;
+      }
+      if (visit.value !== item) changed = true;
+      out.push(visit.value);
+      return;
+    }
+    if (isPlainObject(item)) {
+      const pruned = visitContainer(item, itemPath, state, depth + 1);
+      if (pruned.removedChild) removed = true;
+      if (pruned.value !== item) changed = true;
+      out.push(pruned.value);
+      return;
+    }
+    out.push(item);
+  });
+  return { value: changed ? out : items, removed };
+}
+function collectEvidence(holder, out, depth) {
+  for (const [key, value] of Object.entries(holder)) {
+    if (key === "@context" || ANNOTATION_KEYS.has(key)) continue;
+    collectFromValue(holder, key, value, out, depth);
+  }
+}
+function collectFromValue(holder, key, value, out, depth) {
+  if (depth >= MAX_DEPTH || out.length >= MAX_EVIDENCE) return;
+  if (typeof value === "string") {
+    for (const reason of placeholderReasons(key, value, holder)) {
+      if (out.length >= MAX_EVIDENCE) return;
+      out.push({ reason, key, value: cutForLog(value) });
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectFromValue(holder, key, item, out, depth + 1);
+    return;
+  }
+  if (isPlainObject(value) && !isNestedNode(value)) collectEvidence(value, out, depth + 1);
+}
+function placeholderReasons(key, raw, holder) {
+  const value = raw.trim();
+  if (!value) return [];
+  const reasons = [];
+  const host = urlHost(value);
+  if (host && isReservedExampleHost(host)) reasons.push("example_domain");
+  if ((PHONE_KEYS.has(key) || /^tel:/i.test(value)) && isPlaceholderPhone(value)) reasons.push("placeholder_phone");
+  if (NAME_KEYS.has(key) && !("value" in holder) && PLACEHOLDER_NAMES.has(normalizeName(value))) {
+    reasons.push("placeholder_name");
+  }
+  if (isTemplateSlot(key, value)) reasons.push("template_token");
+  return reasons;
+}
+function isTemplateSlot(key, value) {
+  if (JSX_EXPRESSION_VALUE.test(value) || BRACKET_SLOT_VALUE.test(value) || UPPER_SLOT_VALUE.test(value)) return true;
+  if (REPLACE_MARKER.test(value)) return true;
+  if (!BODY_TEXT_KEYS.has(key)) {
+    if (MUSTACHE_SLOT.test(value)) return true;
+    for (const match of value.matchAll(BRACKET_SLOT_IN_TEXT)) {
+      if (/^[A-Z]/.test(match[1])) return true;
+    }
+  }
+  return !URI_TEMPLATE_KEYS.has(key) && isUrlOrPath(value) && JSX_MEMBER_IN_TEXT.test(value);
+}
+function urlHost(value) {
+  const mailto = /^mailto:[^@\s?]+@([^?\s#/]+)/i.exec(value);
+  if (mailto) return mailto[1];
+  const url = /^(?:[a-z][a-z0-9+.-]*:)?\/\/(?:[^/?#@\s]*@)?([^/?#:\s]+)/i.exec(value);
+  if (url) return url[1];
+  const email = /^[^\s@/:]+@([^\s@/:?#]+)$/.exec(value);
+  if (email) return email[1];
+  const bare = /^((?:[a-z0-9-]+\.)+[a-z][a-z0-9-]*)\.?(?::\d+)?(?:[/?#]\S*)?$/i.exec(value);
+  return bare ? bare[1] : null;
+}
+function isReservedExampleHost(host) {
+  const h = host.toLowerCase().replace(/\.$/, "");
+  if (h === RESERVED_EXAMPLE_TLD || h.endsWith(`.${RESERVED_EXAMPLE_TLD}`)) return true;
+  return RESERVED_EXAMPLE_DOMAINS.some((domain) => h === domain || h.endsWith(`.${domain}`));
+}
+function isUrlOrPath(value) {
+  return /^(?:[a-z][a-z0-9+.-]*:)?\/\//i.test(value) || value.startsWith("/");
+}
+function isPlaceholderPhone(raw) {
+  const value = raw.replace(/^tel:/i, "").trim();
+  if (/^[+\d\s().xX-]+$/.test(value) && (value.match(/x/gi)?.length ?? 0) >= 4) return true;
+  let digits = value.replace(/\D/g, "");
+  if (digits.length === 11 && digits.startsWith("1")) digits = digits.slice(1);
+  if (digits.length >= 7 && /^0+$/.test(digits)) return true;
+  if (digits === "1234567890" || digits === "1234567") return true;
+  const local = digits.length === 10 ? digits.slice(3) : digits.length === 7 ? digits : null;
+  return local !== null && /^55501\d\d$/.test(local);
+}
+function normalizeName(value) {
+  return value.replace(/\s+/g, " ").trim().replace(/[.,]+$/, "").toLowerCase();
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNestedNode(value) {
+  return "@type" in value || "@id" in value || isAnnotationOnly(value);
+}
+function isGraphWrapper(value) {
+  return "@graph" in value && !("@type" in value) && !("@id" in value);
+}
+function isAnnotationOnly(value) {
+  if ("@type" in value || "@id" in value || "@graph" in value) return false;
+  const keys = Object.keys(value).filter((key) => key !== "@context");
+  return keys.length > 0 && keys.every((key) => ANNOTATION_KEYS.has(key));
+}
+function annotationEvidence(node) {
+  return Object.entries(node).filter(([key]) => ANNOTATION_KEYS.has(key)).slice(0, MAX_EVIDENCE).map(([key, value]) => ({
+    reason: "annotation",
+    key,
+    value: cutForLog(typeof value === "string" ? value : JSON.stringify(value) ?? "")
+  }));
+}
+function hasContentBeyond(obj, ignored) {
+  return Object.entries(obj).some(([key, value]) => !ignored.has(key) && hasContent(value));
+}
+function hasContent(value) {
+  if (value === null || value === void 0 || value === "") return false;
+  if (Array.isArray(value)) return value.length > 0;
+  if (isPlainObject(value)) return Object.keys(value).length > 0;
+  return true;
+}
+function typeOf(node) {
+  const type = node["@type"];
+  if (typeof type === "string") return type;
+  if (Array.isArray(type)) return type.filter((t) => typeof t === "string").join(",") || null;
+  return null;
+}
+function stepKey(path, key) {
+  return /^[A-Za-z_$][\w$]*$/.test(key) ? `${path}.${key}` : `${path}[${JSON.stringify(key)}]`;
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+function cutForLog(value) {
+  return value.length > EVIDENCE_VALUE_LENGTH ? `${value.slice(0, EVIDENCE_VALUE_LENGTH)}...` : value;
+}
+
+export { withoutSchemaPlaceholders };

package/dist/{chunk-WWSHFRDL.js → chunk-WDQB4OXY.js}

@@ -1,8 +1,12 @@
-import { generateLLMsTxt, generateLLMsFullTxt } from './chunk-QEDHRBAT.js';
+import { generateLLMsTxt, generateLLMsFullTxt, appendAgentAccessSection } from './chunk-Z65DHMTW.js';
 import { createHash } from 'crypto';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 
+function withAgentAccess(markdown, options) {
+  const baseUrl = options.baseUrl || process.env.NEXT_PUBLIC_SITE_URL || process.env.SITE_URL || "";
+  return options.mcp ? appendAgentAccessSection(markdown, baseUrl, options.mcp === true ? {} : options.mcp) : markdown;
+}
 function weakEtag(body) {
   const h = createHash("sha1").update(body, "utf8").digest("base64url");
   return `W/"${h}"`;
@@ -25,7 +29,7 @@ function createLLMsTxtHandler(options = {}) {
       if (preferStatic) {
         const staticPath = join(process.cwd(), "public", "llms.txt");
         if (existsSync(staticPath)) {
-          const markdown2 = readFileSync(staticPath, "utf-8");
+          const markdown2 = withAgentAccess(readFileSync(staticPath, "utf-8"), generateOptions);
           return new Response(markdown2, {
             status: 200,
             headers: llmsResponseHeaders(markdown2, { ...robots, "X-Sections": "static" })
@@ -61,7 +65,7 @@ function createLLMsFullTxtHandler(options = {}) {
       if (preferStatic) {
         const staticPath = join(process.cwd(), "public", "llms-full.txt");
         if (existsSync(staticPath)) {
-          const markdown2 = readFileSync(staticPath, "utf-8");
+          const markdown2 = withAgentAccess(readFileSync(staticPath, "utf-8"), generateOptions);
           return new Response(markdown2, {
             status: 200,
             headers: llmsResponseHeaders(markdown2, { ...robots, "X-Sections": "static" })

package/dist/{chunk-VDF5DFWT.js → chunk-WGG6GTKW.js}

@@ -1,4 +1,4 @@
-import { SITE_KIT_VERSION } from './chunk-AH5Q262S.js';
+import { SITE_KIT_VERSION } from './chunk-56KNHB4U.js';
 
 // src/shared/siteToken.ts
 var SITE_TOKEN_PREFIX = "st1.";

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

@@ -1,9 +1,10 @@
 'use client';
-import { countStageViews, countStageQuestions, useFieldControls } from './chunk-D5EC5KVO.js';
+import { countStageViews, countStageQuestions, useFieldControls } from './chunk-ZKHI4E2B.js';
 import { HoneypotField } from './chunk-DXO6SBMD.js';
-import { DelightStyles, FormMomentum, FormField } from './chunk-LUXVWITO.js';
-import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-V6FDQLR7.js';
-import { isFieldVisible, validateField, isFieldComplete, isDisplayOnly } from './chunk-AQSNPZY4.js';
+import { DelightStyles, FormMomentum, FormField } from './chunk-4NTBQNHA.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';
 import { DEFAULT_HONEYPOT_FIELD } from './chunk-NJCTQH2P.js';
 import { useState, useRef, useMemo, useEffect, useCallback } from 'react';
@@ -62,7 +63,7 @@ function FormClient({
       return;
     }
     let cancelled = false;
-    const load = resolvedExperience === "stage" ? import('./FormStage-FDTLTP3B.js').then((m) => m.FormStage) : import('./FormSpotlight-AQTIA5TP.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) => {
@@ -130,15 +131,16 @@ function FormClient({
     setErrors(newErrors);
     return Object.keys(newErrors).length === 0;
   }, [currentFields, validateField2]);
-  const validateAll = useCallback(() => {
+  const validateAllFor = useCallback((vals) => {
     const allFields = config.fields || [];
+    const visible = (field) => isFieldVisible(field, vals);
     const newErrors = {};
     for (const field of allFields) {
-      const error = validateField2(field);
+      const error = validateField(field, vals, visible);
       if (error) newErrors[field.slug] = error;
     }
     setErrors(newErrors);
-    if (Object.keys(newErrors).length === 0) return { ok: true, firstErrorStep: null };
+    if (Object.keys(newErrors).length === 0) return { ok: true, firstErrorStep: null, errors: newErrors };
     let firstErrorStep = null;
     if (config.is_multi_step && config.steps) {
       const ordered = [...config.steps].sort((a, b) => a.step_number - b.step_number);
@@ -149,16 +151,16 @@ function FormClient({
         }
       }
     }
-    return { ok: false, firstErrorStep };
-  }, [config, validateField2]);
-  const buildVisibleValues = useCallback(() => {
+    return { ok: false, firstErrorStep, errors: newErrors };
+  }, [config]);
+  const buildVisibleValues = useCallback((vals) => {
     const out = {};
     for (const field of config.fields || []) {
-      if (!isFieldVisible2(field)) continue;
-      if (field.slug in values) out[field.slug] = values[field.slug];
+      if (!isFieldVisible(field, vals)) continue;
+      if (field.slug in vals) out[field.slug] = vals[field.slug];
     }
     return out;
-  }, [config, values, isFieldVisible2]);
+  }, [config]);
   const setFieldValue = useCallback((key, value) => {
     setTouched((prev) => prev[key] ? prev : { ...prev, [key]: true });
     setValues((prev) => ({ ...prev, [key]: value }));
@@ -197,15 +199,19 @@ function FormClient({
       trackStepChange(targetStep);
     }
   }, [step, config.total_steps, trackStepChange]);
-  const submit = useCallback(async () => {
-    if (isSubmittingRef.current) return;
-    const { ok, firstErrorStep } = validateAll();
+  const submit = useCallback(async (options) => {
+    if (isSubmittingRef.current) return { status: "busy" };
+    const domFills = options && typeof options === "object" && options.domFills && typeof options.domFills === "object" ? options.domFills : null;
+    const agentInvoked = !!options && typeof options === "object" && options.agentInvoked === true;
+    const vals = domFills && Object.keys(domFills).length > 0 ? { ...values, ...domFills } : values;
+    if (vals !== values) setValues(vals);
+    const { ok, firstErrorStep, errors: invalid } = validateAllFor(vals);
     if (!ok) {
       if (firstErrorStep != null) {
         setStepDirection("back");
         setStep(firstErrorStep);
       }
-      return;
+      return { status: "invalid", errors: invalid };
     }
     isSubmittingRef.current = true;
     setIsSubmitting(true);
@@ -213,9 +219,10 @@ function FormClient({
     try {
       const data = await submitForm({
         config,
-        values: buildVisibleValues(),
+        values: buildVisibleValues(vals),
         honeypotValue: config.honeypot_enabled ? honeypotValue : "",
-        formLoadedAt: formLoadedAt()
+        formLoadedAt: formLoadedAt(),
+        agentInvoked
       });
       trackComplete();
       setIsComplete(true);
@@ -223,15 +230,19 @@ function FormClient({
       if (config.redirect_url) {
         window.location.href = config.redirect_url;
       }
+      const confirmation = typeof config.success_message === "string" && config.success_message.trim() ? config.success_message.trim() : DEFAULT_FORM_SUCCESS_MESSAGE;
+      return { status: "sent", message: confirmation, submissionId: data.submissionId || void 0 };
     } catch (error) {
       console.error("[Forms] Submission error:", error);
-      setSubmitError("Something went wrong sending your submission. Please try again.");
+      const message = "Something went wrong sending your submission. Please try again.";
+      setSubmitError(message);
       onError?.(error);
+      return { status: "failed", message };
     } finally {
       isSubmittingRef.current = false;
       setIsSubmitting(false);
     }
-  }, [config, honeypotValue, validateAll, buildVisibleValues, trackComplete, onSuccess, onError]);
+  }, [config, values, honeypotValue, validateAllFor, buildVisibleValues, trackComplete, onSuccess, onError]);
   const progress = useMemo(() => {
     return Math.round(step / config.total_steps * 100);
   }, [step, config.total_steps]);
@@ -316,13 +327,21 @@ function FormClient({
       "data-sk-state": isSubmitting ? "submitting" : "idle",
       "data-sk-ready": momentum.total > 0 && momentum.done >= momentum.total && step >= config.total_steps ? "true" : void 0,
       className: `sk-form ${className || ""}`,
+      ...formToolAttributes(config),
       method: "post",
       onSubmit: (e) => {
         e.preventDefault();
+        const agent = readAgentSubmit(e.nativeEvent);
         if (step < config.total_steps) {
-          nextStep();
+          const moved = nextStep();
+          agent.respond(
+            Promise.resolve(
+              moved ? { status: "next_step", step: step + 1, totalSteps: config.total_steps } : { status: "invalid", errors: {} }
+            )
+          );
         } else {
-          submit();
+          const domFills = unseenControlValues(e.currentTarget, config.fields, honeypotFieldName, values);
+          agent.respond(submit({ agentInvoked: agent.invoked, domFills }));
         }
       },
       children: [

package/dist/{chunk-V3PUVBME.js → chunk-XLSQTTUE.js}

@@ -1,5 +1,5 @@
-import { FormEnhancer } from './chunk-VLARKWZU.js';
-import { StaticForm } from './chunk-CIG5UL2S.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';
 
@@ -8,7 +8,6 @@ async function ServerForm({
   className,
   experience,
   enter = "fade",
-  enhance = true,
   defer = true,
   initialConfig,
   configOptions,
@@ -16,7 +15,6 @@ async function ServerForm({
 }) {
   const config = initialConfig ?? await getFormConfig(formId, configOptions);
   const shell = /* @__PURE__ */ jsx(StaticForm, { config, className });
-  if (!enhance) return shell;
   return /* @__PURE__ */ jsx(
     FormEnhancer,
     {

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

@@ -1,5 +1,5 @@
 import { getSiteConfig } from './chunk-Z22QVHT4.js';
-import { writeLLMsTxtToPublic } from './chunk-QEDHRBAT.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';