@aglyn/plugins-ai 1.0.0-beta.270 → 1.0.0-beta.272

package/src/lib/model/ai-site-details.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-details.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AREA_SERVED_MAX,\n  PRICE_RANGE_MAX_LENGTH,\n  normalizeAreaServed,\n  parseOpeningHours,\n  type OpeningHoursRow,\n} from '@aglyn/aglyn/app-utils/local-business'\n\n/**\n * The business details a guided start may be given beyond what the site is\n * for (AGL-3979): how to reach it, where it is, when it is open, where it\n * works and the profiles that are its own. Every one is optional. Given,\n * they are what makes a new site read as this business the first time its\n * owner opens it — the phone number in the footer, the email on the contact\n * page — and what its structured data and its `/llms.txt` say about it.\n *\n * They travel as flat strings among the `site` job's scalar inputs, like the\n * answers before them, so a failed start's summary carries them back and Try\n * again reopens the questions filled in. Each one has its own rule here,\n * shared by the questions (which say what is wrong beside the field) and the\n * create door (`parseAiSiteJobInputs`, which refuses what the questions would\n * not have sent).\n *\n * Pure: strings in, strings out.\n */\n\n/** Every detail, by its input key. */\nexport const AI_SITE_DETAIL_KEYS = [\n  'phone',\n  'email',\n  'tagline',\n  'founded',\n  'serviceArea',\n  'priceRange',\n  'languages',\n  'street',\n  'region',\n  'postalCode',\n  'country',\n  'hours',\n  'social',\n] as const\n\nexport type AiSiteDetailKey = (typeof AI_SITE_DETAIL_KEYS)[number]\n\n/** The details as a job's inputs carry them, each `''` where nobody said. */\nexport type AiSiteDetails = Record<AiSiteDetailKey, string>\n\n/** The longest each detail may be, in characters. Together far under the door's 8,000. */\nexport const AI_SITE_DETAIL_MAX_CHARS: Readonly<Record<AiSiteDetailKey, number>> = {\n  phone: 32,\n  email: 254,\n  tagline: 120,\n  founded: 4,\n  serviceArea: 400,\n  priceRange: PRICE_RANGE_MAX_LENGTH,\n  languages: 120,\n  street: 120,\n  region: 80,\n  postalCode: 20,\n  country: 80,\n  hours: 600,\n  social: 1_200,\n}\n\n/** The most profile links a start takes. */\nexport const AI_SITE_SOCIAL_MAX = 6\n\n/** No details at all. */\nexport const AI_SITE_NO_DETAILS: Readonly<AiSiteDetails> = Object.fromEntries(\n  AI_SITE_DETAIL_KEYS.map((key) => [key, '']),\n) as unknown as AiSiteDetails\n\n/** Why a detail cannot be used, as a closed code the funnel counts and a sentence beside the field. */\nexport interface AiSiteDetailProblem {\n  code: 'too_long' | 'invalid'\n  message: string\n}\n\nconst PHONE_CHARS = /^\\+?[\\d\\s().-]+$/\n\n/** Whether a phone number reads as one: digits with the usual separators, a `+` only first, 7 to 15 digits. */\nexport function aiSitePhoneValid(value: string): boolean {\n  const text = value.trim()\n  if (!PHONE_CHARS.test(text)) return false\n  const digits = text.replace(/\\D/g, '')\n  return digits.length >= 7 && digits.length <= 15\n}\n\n/**\n * The `tel:` address of a phone number, or `''` for one that does not read.\n *\n * Its digits are the number's own, with a `+` only where the person typed one:\n * no country is inferred, so the link dials the number exactly as given, and\n * the layout's own check, which reads a number by its digits, finds the same\n * digits in the brief as in the link.\n */\nexport function aiSitePhoneHref(value: string): string {\n  if (!aiSitePhoneValid(value)) return ''\n  const text = value.trim()\n  return `tel:${text.startsWith('+') ? '+' : ''}${text.replace(/\\D/g, '')}`\n}\n\nconst EMAIL = /^[^\\s@<>()[\\]\\\\,;:\"]+@[^\\s@<>()[\\]\\\\,;:\"]+\\.[^\\s@<>()[\\]\\\\,;:\".]{2,}$/\n\n/** Whether an email address reads as one. */\nexport function aiSiteEmailValid(value: string): boolean {\n  const text = value.trim()\n  return text.length <= AI_SITE_DETAIL_MAX_CHARS.email && EMAIL.test(text)\n}\n\n/** The `mailto:` address of an email, or `''` for one that does not read. */\nexport function aiSiteEmailHref(value: string): string {\n  return aiSiteEmailValid(value) ? `mailto:${value.trim()}` : ''\n}\n\n/** A link typed without its scheme is the https page it names; a plain `http:` one is read as https. */\nfunction asHttps(value: string): string {\n  const text = value.trim()\n  if (/^https:\\/\\//i.test(text)) return text\n  if (/^http:\\/\\//i.test(text)) return `https://${text.slice(7)}`\n  if (/^(?:www\\.)?[a-z0-9-]+(?:\\.[a-z0-9-]+)*\\.[a-z]{2,}(?:[/?#]\\S*)?$/i.test(text)) return `https://${text}`\n  return text\n}\n\nfunction isHttps(value: string): boolean {\n  try {\n    const url = new URL(value)\n    return url.protocol === 'https:' && url.hostname.includes('.')\n  } catch {\n    return false\n  }\n}\n\n/**\n * The profile links a detail names, one a line (commas and spaces separate\n * them too), each an https page, at most {@link AI_SITE_SOCIAL_MAX}, each\n * once; `null` when one of them is not a link at all.\n */\nexport function aiSiteSocialLinks(value: string): string[] | null {\n  const links: string[] = []\n  for (const part of value.split(/[\\s,]+/)) {\n    if (!part.trim()) continue\n    const link = asHttps(part)\n    if (!isHttps(link)) return null\n    if (!links.some((seen) => seen.toLowerCase() === link.toLowerCase())) links.push(link)\n  }\n  return links.slice(0, AI_SITE_SOCIAL_MAX)\n}\n\n/** The areas a detail names, one a line or separated by commas, each once, at most twenty. */\nexport function aiSiteServiceAreas(value: string): string[] {\n  return normalizeAreaServed(value.split(/\\r?\\n|,|;/)).slice(0, AREA_SERVED_MAX)\n}\n\n/** The opening hours a detail holds, as the lines that read (`Mo-Fr 09:00-17:00`), one a line. */\nexport function aiSiteHoursText(value: string): string {\n  return value\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line && parseOpeningHours(line).length)\n    .join('\\n')\n}\n\nconst DAY_SHORT: Readonly<Record<string, string>> = {\n  Monday: 'Mon',\n  Tuesday: 'Tue',\n  Wednesday: 'Wed',\n  Thursday: 'Thu',\n  Friday: 'Fri',\n  Saturday: 'Sat',\n  Sunday: 'Sun',\n}\nconst WEEK = Object.keys(DAY_SHORT)\n\n/** \"09:00\" as \"9am\", \"17:30\" as \"5:30pm\", \"00:00\" as \"12am\". */\nfunction clock(time: string): string {\n  const [h = 0, m = 0] = time.split(':').map(Number)\n  const suffix = h < 12 ? 'am' : 'pm'\n  const hour = h % 12 === 0 ? 12 : h % 12\n  return `${hour}${m ? `:${String(m).padStart(2, '0')}` : ''}${suffix}`\n}\n\n/** A row's days as a reader says them: \"Mon–Fri\" for a run, \"Mon, Wed\" otherwise. */\nfunction daysOf(row: OpeningHoursRow): string {\n  const at = row.days.map((day) => WEEK.indexOf(day)).sort((a, b) => a - b)\n  const run = at.every((index, position) => position === 0 || index === at[position - 1] + 1)\n  if (run && at.length > 2) return `${DAY_SHORT[WEEK[at[0]]]}–${DAY_SHORT[WEEK[at[at.length - 1]]]}`\n  return at.map((index) => DAY_SHORT[WEEK[index]]).join(', ')\n}\n\n/**\n * The opening hours as a person reads them — \"Mon–Fri 9am–5pm; Sat 10am–2pm\"\n * — which is how the brief states them: the layout's own check admits a\n * footer's hours only where the brief gives hours it can read as hours, and\n * `Mo-Fr 09:00-17:00` is written for a machine.\n */\nexport function aiSiteHoursSentence(value: string): string {\n  return parseOpeningHours(value)\n    .map((row) => `${daysOf(row)} ${clock(row.opens)}–${clock(row.closes)}`)\n    .join('; ')\n}\n\n/**\n * What is wrong with one detail, worded for the person beside its field; `null`\n * when it may be used. An empty detail is always fine: every one is optional.\n */\nexport function aiSiteDetailProblem(\n  key: AiSiteDetailKey,\n  raw: unknown,\n  options: { now?: Date } = {},\n): AiSiteDetailProblem | null {\n  if (raw === undefined || raw === null || raw === '') return null\n  if (typeof raw !== 'string') return { code: 'invalid', message: 'Use plain text here.' }\n  const value = raw.trim()\n  if (!value) return null\n  const max = AI_SITE_DETAIL_MAX_CHARS[key]\n  if (value.length > max) return { code: 'too_long', message: `Keep this under ${max} characters.` }\n  switch (key) {\n    case 'phone':\n      return aiSitePhoneValid(value)\n        ? null\n        : { code: 'invalid', message: 'Enter the phone number with its area code, like (512) 555-0142 or +44 20 7946 0958.' }\n    case 'email':\n      return aiSiteEmailValid(value) ? null : { code: 'invalid', message: 'Enter an email address, like hello@yourbusiness.com.' }\n    case 'founded': {\n      const year = Number(value)\n      const latest = (options.now ?? new Date()).getFullYear()\n      return /^\\d{4}$/.test(value) && year >= 1000 && year <= latest\n        ? null\n        : { code: 'invalid', message: `Enter the year as four digits, like ${latest - 10}.` }\n    }\n    case 'social':\n      return aiSiteSocialLinks(value)\n        ? null\n        : { code: 'invalid', message: 'Paste each profile’s address, one a line, like instagram.com/yourbusiness.' }\n    default:\n      return null\n  }\n}\n\n/**\n * The details a job's inputs carry, each held to its rule and tidied — the\n * profile links as https pages one a line, the areas one a line, only the\n * opening hours that read — or the sentence the create door refuses them\n * with. A key the inputs leave out is `''`.\n */\nexport function parseAiSiteDetails(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { now?: Date } = {},\n): AiSiteDetails | string {\n  const details = { ...AI_SITE_NO_DETAILS }\n  for (const key of AI_SITE_DETAIL_KEYS) {\n    const raw = inputs?.[key]\n    const problem = aiSiteDetailProblem(key, raw, options)\n    if (problem) return `${key}: ${problem.message}`\n    const value = typeof raw === 'string' ? raw.trim() : ''\n    if (!value) continue\n    details[key] =\n      key === 'social'\n        ? (aiSiteSocialLinks(value) ?? []).join('\\n')\n        : key === 'serviceArea'\n          ? aiSiteServiceAreas(value).join('\\n')\n          : key === 'hours'\n            ? aiSiteHoursText(value)\n            : value.replace(/[ \\t]+/g, ' ')\n  }\n  return details\n}\n\n/** A job's details, read leniently: anything that breaks its rule reads as not given. */\nexport function aiSiteDetailsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteDetails {\n  const details = { ...AI_SITE_NO_DETAILS }\n  for (const key of AI_SITE_DETAIL_KEYS) {\n    const one = parseAiSiteDetails({ [key]: inputs?.[key] })\n    if (typeof one !== 'string') details[key] = one[key]\n  }\n  return details\n}\n\n/** How a visitor reaches the business, as the pages link it; `null` when neither was given. */\nexport interface AiSiteContact {\n  /** The number as the person wrote it, which is how the pages show it. */\n  phone: string\n  phoneHref: string\n  email: string\n  emailHref: string\n}\n\n/** The phone and email a job's inputs give, with the links they make; `null` for neither. */\nexport function aiSiteContactOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteContact | null {\n  const details = aiSiteDetailsOf(inputs)\n  const phoneHref = aiSitePhoneHref(details.phone)\n  const emailHref = aiSiteEmailHref(details.email)\n  if (!phoneHref && !emailHref) return null\n  return {\n    phone: phoneHref ? details.phone : '',\n    phoneHref,\n    email: emailHref ? details.email : '',\n    emailHref,\n  }\n}\n\n/** The street address the details and the city make, as one line: \"214 Main Street, Austin, TX 78701, US\". */\nexport function aiSiteAddressLine(details: Pick<AiSiteDetails, 'street' | 'region' | 'postalCode' | 'country'>, city = ''): string {\n  const regional = [details.region, details.postalCode].map((part) => part.trim()).filter(Boolean).join(' ')\n  return [details.street, city, regional, details.country]\n    .map((part) => part.trim())\n    .filter(Boolean)\n    .join(', ')\n}\n\n/**\n * What every unit of a site job is told about the business beyond what it is\n * (AGL-3979), on the job's own turn: its contact details, place and hours,\n * then everything else the person gave, then — where there is a phone or an\n * email — that the pages show them as written and how a link calls or writes.\n * Empty when the person gave no details, so a start without them is told\n * exactly what it was told before.\n */\nexport function aiSiteDetailsBriefLines(details: AiSiteDetails, options: { city?: string } = {}): string[] {\n  const lines: string[] = []\n  const address = details.street ? aiSiteAddressLine(details, options.city ?? '') : ''\n  const hours = aiSiteHoursSentence(details.hours)\n  const contact = [\n    details.phone ? `phone: ${details.phone}` : '',\n    details.email ? `email: ${details.email}` : '',\n    address ? `address: ${address}` : '',\n    hours ? `hours: ${hours}` : '',\n  ].filter(Boolean)\n  if (contact.length) lines.push(`Contact — ${contact.join('; ')}.`)\n  const areas = aiSiteServiceAreas(details.serviceArea)\n  const social = details.social ? details.social.split('\\n').filter(Boolean) : []\n  const more = [\n    details.tagline ? `tagline: ${details.tagline}` : '',\n    details.founded ? `founded: ${details.founded}` : '',\n    areas.length ? `serves: ${areas.join(', ')}` : '',\n    details.priceRange ? `price range: ${details.priceRange}` : '',\n    details.languages ? `languages: ${details.languages}` : '',\n    social.length ? `profiles: ${social.join(', ')}` : '',\n  ].filter(Boolean)\n  if (more.length) lines.push(`About the business — ${more.join('; ')}.`)\n  if (details.phone || details.email) {\n    const what = details.phone && details.email ? 'phone number and email' : details.phone ? 'phone number' : 'email'\n    const links = [details.phone ? 'a link that calls goes to \"phone\"' : '', details.email ? 'a link that writes goes to \"email\"' : '']\n      .filter(Boolean)\n      .join(' and ')\n    lines.push(\n      `Show the ${what} exactly as written wherever a visitor looks for a way to get in touch: the contact page, the footer, and the buttons that ask a visitor to call or write; ${links}.`,\n    )\n  }\n  return lines\n}\n"],"names":["AREA_SERVED_MAX","PRICE_RANGE_MAX_LENGTH","normalizeAreaServed","parseOpeningHours","AI_SITE_DETAIL_KEYS","AI_SITE_DETAIL_MAX_CHARS","phone","email","tagline","founded","serviceArea","priceRange","languages","street","region","postalCode","country","hours","social","AI_SITE_SOCIAL_MAX","AI_SITE_NO_DETAILS","Object","fromEntries","map","key","PHONE_CHARS","aiSitePhoneValid","value","text","trim","test","digits","replace","length","aiSitePhoneHref","startsWith","EMAIL","aiSiteEmailValid","aiSiteEmailHref","asHttps","slice","isHttps","url","URL","protocol","hostname","includes","aiSiteSocialLinks","links","part","split","link","some","seen","toLowerCase","push","aiSiteServiceAreas","aiSiteHoursText","line","filter","join","DAY_SHORT","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday","WEEK","keys","clock","time","h","m","Number","suffix","hour","String","padStart","daysOf","row","at","days","day","indexOf","sort","a","b","run","every","index","position","aiSiteHoursSentence","opens","closes","aiSiteDetailProblem","raw","options","undefined","code","message","max","year","latest","now","Date","getFullYear","parseAiSiteDetails","inputs","details","problem","aiSiteDetailsOf","one","aiSiteContactOf","phoneHref","emailHref","aiSiteAddressLine","city","regional","Boolean","aiSiteDetailsBriefLines","lines","address","contact","areas","more","what"],"mappings":"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"}

package/src/lib/model/ai-site-entity.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { LocalBusinessType } from '@aglyn/aglyn/app-utils/local-business';
+import { type AiSiteSeoProposal } from './ai-site-start-seo';
+/**
+ * Who publishes a site a guided start built, as its structured data and its
+ * `/llms.txt` say (AGL-3979).
+ *
+ * Every tenant page publishes a top-level Organization (or Person) node, and
+ * `/llms.txt` carries the site's agent guidance, both read off the host's
+ * Setup → SEO → Entity and AI agents fields (`siteEntityJsonLd`,
+ * `buildLlmsTxt`). Before this, a guided start wrote none of those fields:
+ * every AI-built site published a node holding its name and nothing else — no
+ * contact point, no address, no business type — and the guidance was the
+ * platform's own default. The answers the person gave are the facts those
+ * fields ask for, so the publish writes them.
+ *
+ * ── Derived, never generated ─────────────────────────────────────────────
+ *
+ * Each value is the person's own words or arithmetic on them: the schema
+ * type from the kind of site they picked (and, for a few kinds, the words
+ * they used), the description from the same composition as the site's
+ * search listing, the guidance from what they said and gave. No model is
+ * asked, and nothing is invented: a field the answers say nothing about is
+ * left alone.
+ *
+ * ── Never over the owner ─────────────────────────────────────────────────
+ *
+ * {@link aiSiteEntityUpdates} writes only fields that are empty, so a site
+ * whose owner already filled its Entity keeps every word of it, and a second
+ * publish (Try again) writes nothing it wrote before.
+ *
+ * ── The site's own listing ───────────────────────────────────────────────
+ *
+ * `/llms.txt` opens with the site's title and description, and every page
+ * without its own title falls back to them. A new site is created with its
+ * name and a "Welcome to …" line there, which nobody chose, so
+ * {@link aiSiteListingUpdates} puts the start's listing over that seeded
+ * default, and only over it: a title or description the owner changed keeps
+ * their words, and the SEO section offers the start's beside them.
+ *
+ * Pure: no Firestore and no React.
+ */
+/** How a kind of site publishes: as a person, or as a business of a `schema.org` LocalBusiness type. */
+interface KindSchema {
+    person?: true;
+    businessType?: LocalBusinessType;
+    /** A narrower type the person's words name, first match wins. */
+    refine?: ReadonlyArray<readonly [RegExp, LocalBusinessType]>;
+}
+/**
+ * Each `AI_SITE_KINDS` entry's `schema.org` type (`ai-site-entity.spec.ts`
+ * holds every kind to an entry). A kind with no business type publishes as an
+ * Organization — a blog, a band, an event, a course — unless the person gave
+ * a street address or opening hours, which make it a place a visitor goes:
+ * a LocalBusiness. Only types on the platform's `LOCAL_BUSINESS_TYPES` list
+ * are used, since only those publish.
+ */
+export declare const AI_SITE_KIND_SCHEMA: Readonly<Record<string, KindSchema>>;
+/** The schema a site's answers publish under: a Person, or an Organization with a business type or none. */
+export interface AiSiteSchema {
+    person: boolean;
+    businessType: LocalBusinessType | null;
+}
+/** What a job's inputs say the site publishes as. */
+export declare function aiSiteSchemaOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteSchema;
+/** The Entity and AI-agent values a job's answers give; a field they say nothing about is `''` or `[]`. */
+export interface AiSiteEntityValues {
+    person: boolean;
+    name: string;
+    description: string;
+    email: string;
+    telephone: string;
+    address: {
+        streetAddress: string;
+        addressLocality: string;
+        addressRegion: string;
+        postalCode: string;
+        addressCountry: string;
+    };
+    /** The street address as one line, as Setup → Details → Business details holds it; `''` without a street. */
+    postalAddress: string;
+    businessType: string;
+    areaServed: string[];
+    openingHours: string;
+    priceRange: string;
+    sameAs: string[];
+    whenToUse: string;
+    howToUse: string;
+}
+/**
+ * The site's agent guidance from its answers (AGL-3979): when an agent should
+ * use the site — what the business is, then what the site answers — and,
+ * where the person gave a way to reach it, how to reach a person. Written in
+ * English, as the rest of `/llms.txt` is.
+ */
+export declare function aiSiteAgentGuidance(input: {
+    name: string;
+    description: string;
+    areas: readonly string[];
+    hours: boolean;
+    prices: boolean;
+    languages: string;
+    phone: string;
+    email: string;
+    address: string;
+}): {
+    whenToUse: string;
+    howToUse: string;
+};
+/**
+ * The Entity and AI-agent values a site job's inputs imply, in the language
+ * its plan writes the site in. `siteName` is the site's own name: it leads
+ * the description and the guidance where the inputs name no business, and is
+ * never written as the Entity's name, which falls back to it at render and so
+ * follows a rename.
+ */
+export declare function aiSiteEntityValues(inputs: Readonly<Record<string, unknown>> | null | undefined, options?: {
+    language?: string | null;
+    siteName?: string | null;
+}): AiSiteEntityValues;
+/** The contact a start's phone or email answers, as the Setup form's **Contact is for** says it: its default. */
+export declare const AI_SITE_CONTACT_TYPE = "customer support";
+/**
+ * The host updates that put a start's Entity and AI-agent values on its site,
+ * as field paths (`seo.entity.telephone`), for the publish's own batch: only
+ * fields that are empty on the site, so nothing the owner wrote is replaced.
+ * The address is written whole or not at all — a start's street beside the
+ * owner's own city would be an address of neither. `{}` when there is
+ * nothing to write.
+ *
+ * Beside the Entity, from what the site already has and the same answers:
+ * - the Entity logo is the site's own logo, where it has one and the Entity
+ *   names none (a Person's Entity picture is their photo, never a logo);
+ * - **Contact is for** says what the phone or email this start wrote answers;
+ * - Setup → Details → Business details gets the email as the support email
+ *   (which `{{host.supportEmail}}` and a form that cannot take a message name)
+ *   and the street address as its one block of text.
+ */
+export declare function aiSiteEntityUpdates(seo: unknown, values: AiSiteEntityValues, site?: {
+    logoUrl?: unknown;
+    business?: unknown;
+}): Record<string, unknown>;
+/**
+ * Which half of a site's own listing is still the one its creation seeded
+ * (AGL-3979): `defaultSiteSeo(name)` — the site's name as its title and
+ * "Welcome to {name}. See what we do, browse our work and get in touch." as
+ * its description. Blank counts as seeded too: nobody chose it.
+ *
+ * The title is seeded when it is the site's name, or when it still pairs with
+ * a seeded description, as it does on a site renamed after it was made. The
+ * description is seeded when it is the welcome line for the site's name, for
+ * the title's, or for no name. Anything else is the owner's own words.
+ */
+export declare function aiSiteListingSeeded(seo: unknown, displayName: unknown): {
+    title: boolean;
+    description: boolean;
+};
+/**
+ * The host updates that put a start's own listing on its site (AGL-3979), as
+ * field paths for the publish's batch: each half only where it is still the
+ * seeded default and differs from the listing, so the owner's own title or
+ * description is never written over, and a second publish writes nothing.
+ * `{}` with no listing to write.
+ */
+export declare function aiSiteListingUpdates(seo: unknown, displayName: unknown, listing: AiSiteSeoProposal | null): Record<string, string>;
+export {};

package/src/lib/model/ai-site-entity.js

@@ -0,0 +1,390 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { defaultHomeDescription, defaultSiteSeo } from "@aglyn/aglyn/app-utils/default-site";
+import { HostEntityType } from "@aglyn/aglyn/foundation/definitions/platform.types";
+import { aiSiteAddressLine, aiSiteDetailsOf, aiSiteHoursSentence, aiSiteServiceAreas } from "./ai-site-details.js";
+import { aiSiteKindOfInputs } from "./ai-site-kinds.js";
+import { aiSiteSeoProposalForInputs, AI_SITE_SEO_FORM_FIELDS } from "./ai-site-start-seo.js";
+/**
+ * Each `AI_SITE_KINDS` entry's `schema.org` type (`ai-site-entity.spec.ts`
+ * holds every kind to an entry). A kind with no business type publishes as an
+ * Organization — a blog, a band, an event, a course — unless the person gave
+ * a street address or opening hours, which make it a place a visitor goes:
+ * a LocalBusiness. Only types on the platform's `LOCAL_BUSINESS_TYPES` list
+ * are used, since only those publish.
+ */ export const AI_SITE_KIND_SCHEMA = {
+    business: {
+        businessType: 'LocalBusiness',
+        refine: [
+            [
+                /\b(?:marketing|consult\w*|agency|freelanc\w*|staffing|bookkeep\w*|design(?:er)?s?)\b/i,
+                'ProfessionalService'
+            ],
+            [
+                /\b(?:car wash|detailing|auto repair|mechanic|tire|tyre)\b/i,
+                'AutomotiveBusiness'
+            ]
+        ]
+    },
+    trades: {
+        businessType: 'HomeAndConstructionBusiness',
+        refine: [
+            [
+                /\bplumb\w*/i,
+                'Plumber'
+            ],
+            [
+                /\belectric\w*/i,
+                'Electrician'
+            ],
+            [
+                /\b(?:hvac|heating|air condition\w*|furnace)\b/i,
+                'HVACBusiness'
+            ],
+            [
+                /\broof\w*/i,
+                'RoofingContractor'
+            ],
+            [
+                /\bpaint\w*/i,
+                'HousePainter'
+            ],
+            [
+                /\blocksmith\w*/i,
+                'Locksmith'
+            ],
+            [
+                /\bmov(?:ing|ers?)\b/i,
+                'MovingCompany'
+            ],
+            [
+                /\b(?:contractor|remodel\w*|renovat\w*|builders?|construction)\b/i,
+                'GeneralContractor'
+            ]
+        ]
+    },
+    professional: {
+        businessType: 'ProfessionalService',
+        refine: [
+            [
+                /\b(?:law|lawyers?|attorneys?|legal|solicitors?)\b/i,
+                'LegalService'
+            ],
+            [
+                /\b(?:accounting|accountants?|bookkeep\w*|tax|cpa)\b/i,
+                'AccountingService'
+            ]
+        ]
+    },
+    wellness: {
+        businessType: 'HealthAndBeautyBusiness',
+        refine: [
+            [
+                /\b(?:dentist\w*|dental|orthodont\w*)\b/i,
+                'Dentist'
+            ],
+            [
+                /\b(?:clinic|doctors?|physicians?|medical|therap\w*|chiropract\w*|physio\w*|counsel\w*)\b/i,
+                'MedicalBusiness'
+            ]
+        ]
+    },
+    restaurant: {
+        businessType: 'Restaurant',
+        refine: [
+            [
+                /\b(?:caf[eé]s?|coffee|bakery|bakeries|bars?|brewery|food truck|deli)\b/i,
+                'FoodEstablishment'
+            ]
+        ]
+    },
+    store: {
+        businessType: 'Store'
+    },
+    portfolio: {},
+    studio: {
+        businessType: 'ProfessionalService'
+    },
+    photography: {
+        businessType: 'ProfessionalService'
+    },
+    blog: {},
+    events: {},
+    fitness: {
+        businessType: 'SportsActivityLocation'
+    },
+    yoga: {
+        businessType: 'SportsActivityLocation'
+    },
+    beauty: {
+        businessType: 'HealthAndBeautyBusiness'
+    },
+    realestate: {
+        businessType: 'RealEstateAgent'
+    },
+    education: {
+        refine: [
+            [
+                /\b(?:day ?care|child ?care|preschool|nursery)\b/i,
+                'ChildCare'
+            ]
+        ]
+    },
+    nonprofit: {
+        refine: [
+            [
+                /\b(?:animal (?:shelter|rescue)|pet rescue)\b/i,
+                'AnimalShelter'
+            ]
+        ]
+    },
+    music: {},
+    personal: {
+        person: true
+    },
+    landing: {},
+    'coming-soon': {}
+};
+/** What a job's inputs say the site publishes as. */ export function aiSiteSchemaOf(inputs) {
+    var _ref;
+    var _entry_refine_find, _entry_refine;
+    const kind = aiSiteKindOfInputs(inputs);
+    const entry = kind && AI_SITE_KIND_SCHEMA[kind.id] || {};
+    if (entry.person) return {
+        person: true,
+        businessType: null
+    };
+    const words = [
+        inputs == null ? void 0 : inputs['businessType'],
+        inputs == null ? void 0 : inputs['audience']
+    ].filter((value)=>typeof value === 'string').join(' ');
+    const refined = (_entry_refine = entry.refine) == null ? void 0 : (_entry_refine_find = _entry_refine.find(([pattern])=>pattern.test(words))) == null ? void 0 : _entry_refine_find[1];
+    const details = aiSiteDetailsOf(inputs);
+    const place = Boolean(details.street || details.hours);
+    return {
+        person: false,
+        businessType: (_ref = refined != null ? refined : entry.businessType) != null ? _ref : place ? 'LocalBusiness' : null
+    };
+}
+const text = (value)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+/** "a, b and c". */ function listed(parts) {
+    if (parts.length < 2) return parts.join('');
+    return `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;
+}
+/**
+ * The site's agent guidance from its answers (AGL-3979): when an agent should
+ * use the site — what the business is, then what the site answers — and,
+ * where the person gave a way to reach it, how to reach a person. Written in
+ * English, as the rest of `/llms.txt` is.
+ */ export function aiSiteAgentGuidance(input) {
+    const who = input.name || 'this business';
+    const answers = [
+        `what ${who} offers`,
+        ...input.areas.length ? [
+            `the areas it serves (${input.areas.slice(0, 6).join(', ')})`
+        ] : [],
+        ...input.hours ? [
+            'its opening hours'
+        ] : [],
+        ...input.prices ? [
+            'its prices'
+        ] : [],
+        'how to get in touch'
+    ];
+    // A site the answers say nothing about gets no guidance: the platform's own
+    // derived "When to use this site" says more than a sentence about nobody.
+    const said = Boolean(input.name || input.description);
+    const when = said ? [
+        input.description,
+        `Use this site for ${listed(answers)}.`,
+        input.languages ? `It serves customers in ${input.languages.replace(/[.\s]+$/, '')}.` : ''
+    ].filter(Boolean).join(' ') : '';
+    const reach = [
+        input.phone ? `call ${input.phone}` : '',
+        input.email ? `email ${input.email}` : ''
+    ].filter(Boolean);
+    const how = [
+        reach.length ? `To reach a person at ${who}, ${reach.join(' or ')}.` : '',
+        input.address ? `${input.name || 'The business'} is at ${input.address}.` : ''
+    ].filter(Boolean).join(' ');
+    return {
+        whenToUse: when,
+        howToUse: how
+    };
+}
+/**
+ * The Entity and AI-agent values a site job's inputs imply, in the language
+ * its plan writes the site in. `siteName` is the site's own name: it leads
+ * the description and the guidance where the inputs name no business, and is
+ * never written as the Entity's name, which falls back to it at render and so
+ * follows a rename.
+ */ export function aiSiteEntityValues(inputs, options = {}) {
+    var _options_language, _options_siteName, _ref, _schema_businessType;
+    const details = aiSiteDetailsOf(inputs);
+    const schema = aiSiteSchemaOf(inputs);
+    const name = text(inputs == null ? void 0 : inputs['businessName']);
+    const city = text(inputs == null ? void 0 : inputs['city']);
+    const listing = aiSiteSeoProposalForInputs(inputs, (_options_language = options.language) != null ? _options_language : null, (_options_siteName = options.siteName) != null ? _options_siteName : null);
+    const description = (_ref = listing == null ? void 0 : listing.values[AI_SITE_SEO_FORM_FIELDS.description]) != null ? _ref : '';
+    const areas = aiSiteServiceAreas(details.serviceArea);
+    // A business that names no other area serves the city it is in.
+    const areaServed = schema.businessType ? areas.length ? areas : city ? [
+        city
+    ] : [] : [];
+    const sameAs = details.social ? details.social.split('\n').filter(Boolean) : [];
+    const address = details.street ? aiSiteAddressLine(details, city) : '';
+    const guidance = aiSiteAgentGuidance({
+        name: name || text(options.siteName),
+        description,
+        areas,
+        hours: Boolean(aiSiteHoursSentence(details.hours)),
+        prices: Boolean(details.priceRange),
+        languages: details.languages,
+        phone: details.phone,
+        email: details.email,
+        address
+    });
+    return _extends({
+        person: schema.person,
+        name,
+        description,
+        email: details.email,
+        telephone: details.phone,
+        address: {
+            streetAddress: details.street,
+            // The city is where the business is only where it gave a street to be on.
+            addressLocality: details.street || details.postalCode ? city : '',
+            addressRegion: details.region,
+            postalCode: details.postalCode,
+            addressCountry: details.country
+        },
+        postalAddress: address,
+        businessType: (_schema_businessType = schema.businessType) != null ? _schema_businessType : '',
+        areaServed,
+        openingHours: details.hours,
+        priceRange: details.priceRange,
+        sameAs
+    }, guidance);
+}
+const isBlank = (value)=>value === undefined || value === null || typeof value === 'string' && !value.trim() || Array.isArray(value) && !value.some((entry)=>typeof entry === 'string' && entry.trim());
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The contact a start's phone or email answers, as the Setup form's **Contact is for** says it: its default. */ export const AI_SITE_CONTACT_TYPE = 'customer support';
+/**
+ * The host updates that put a start's Entity and AI-agent values on its site,
+ * as field paths (`seo.entity.telephone`), for the publish's own batch: only
+ * fields that are empty on the site, so nothing the owner wrote is replaced.
+ * The address is written whole or not at all — a start's street beside the
+ * owner's own city would be an address of neither. `{}` when there is
+ * nothing to write.
+ *
+ * Beside the Entity, from what the site already has and the same answers:
+ * - the Entity logo is the site's own logo, where it has one and the Entity
+ *   names none (a Person's Entity picture is their photo, never a logo);
+ * - **Contact is for** says what the phone or email this start wrote answers;
+ * - Setup → Details → Business details gets the email as the support email
+ *   (which `{{host.supportEmail}}` and a form that cannot take a message name)
+ *   and the street address as its one block of text.
+ */ export function aiSiteEntityUpdates(seo, values, site = {}) {
+    const current = isRecord(seo) ? seo : {};
+    const entity = isRecord(current['entity']) ? current['entity'] : {};
+    const agent = isRecord(current['agent']) ? current['agent'] : {};
+    const business = isRecord(site.business) ? site.business : {};
+    const updates = {};
+    const fill = (path, now, next)=>{
+        if (!isBlank(next) && isBlank(now)) updates[path] = next;
+    };
+    const person = values.person && isBlank(entity['type']);
+    // As the Setup form's select stores it: the enum's value as text.
+    if (person) updates['seo.entity.type'] = String(HostEntityType.PERSON);
+    fill('seo.entity.name', entity['name'], values.name);
+    fill('seo.entity.description', entity['description'], values.description);
+    fill('seo.entity.email', entity['email'], values.email);
+    fill('seo.entity.telephone', entity['telephone'], values.telephone);
+    if (updates['seo.entity.email'] || updates['seo.entity.telephone']) {
+        fill('seo.entity.contactType', entity['contactType'], AI_SITE_CONTACT_TYPE);
+    }
+    const address = isRecord(entity['address']) ? entity['address'] : {};
+    if (Object.values(address).every(isBlank)) {
+        for (const [field, value] of Object.entries(values.address)){
+            if (value) updates[`seo.entity.address.${field}`] = value;
+        }
+    }
+    // A Person carries none of a business's fields (`siteEntityJsonLd`).
+    const isPerson = person || Number(entity['type']) === HostEntityType.PERSON;
+    if (!isPerson) {
+        fill('seo.entity.logo', entity['logo'], typeof site.logoUrl === 'string' ? site.logoUrl.trim() : '');
+        fill('seo.entity.businessType', entity['businessType'], values.businessType);
+        fill('seo.entity.areaServed', entity['areaServed'], values.areaServed);
+        fill('seo.entity.openingHours', entity['openingHours'], values.openingHours);
+        fill('seo.entity.priceRange', entity['priceRange'], values.priceRange);
+    }
+    fill('seo.entity.sameAs', entity['sameAs'], values.sameAs);
+    fill('seo.agent.whenToUse', agent['whenToUse'], values.whenToUse);
+    fill('seo.agent.howToUse', agent['howToUse'], values.howToUse);
+    fill('business.supportEmail', business['supportEmail'], values.email);
+    fill('business.address', business['address'], values.postalAddress);
+    return updates;
+}
+/** Trimmed, or `''` for anything that is not a string: as site creation compares names. */ const trimmed = (value)=>typeof value === 'string' ? value.trim() : '';
+/**
+ * Which half of a site's own listing is still the one its creation seeded
+ * (AGL-3979): `defaultSiteSeo(name)` — the site's name as its title and
+ * "Welcome to {name}. See what we do, browse our work and get in touch." as
+ * its description. Blank counts as seeded too: nobody chose it.
+ *
+ * The title is seeded when it is the site's name, or when it still pairs with
+ * a seeded description, as it does on a site renamed after it was made. The
+ * description is seeded when it is the welcome line for the site's name, for
+ * the title's, or for no name. Anything else is the owner's own words.
+ */ export function aiSiteListingSeeded(seo, displayName) {
+    const current = isRecord(seo) ? seo : {};
+    const title = trimmed(current['title']);
+    const description = trimmed(current['description']);
+    const name = trimmed(displayName);
+    const welcomes = new Set([
+        name,
+        title,
+        ''
+    ].map((each)=>defaultHomeDescription(each)));
+    const seededDescription = !description || welcomes.has(description);
+    const seededTitle = !title || title === trimmed(defaultSiteSeo(name)['title']) || Boolean(description) && description === defaultHomeDescription(title);
+    return {
+        title: seededTitle,
+        description: seededDescription
+    };
+}
+/**
+ * The host updates that put a start's own listing on its site (AGL-3979), as
+ * field paths for the publish's batch: each half only where it is still the
+ * seeded default and differs from the listing, so the owner's own title or
+ * description is never written over, and a second publish writes nothing.
+ * `{}` with no listing to write.
+ */ export function aiSiteListingUpdates(seo, displayName, listing) {
+    if (!listing) return {};
+    const current = isRecord(seo) ? seo : {};
+    const seeded = aiSiteListingSeeded(current, displayName);
+    const updates = {};
+    const title = trimmed(listing.values[AI_SITE_SEO_FORM_FIELDS.title]);
+    const description = trimmed(listing.values[AI_SITE_SEO_FORM_FIELDS.description]);
+    if (title && seeded.title && title !== trimmed(current['title'])) updates[AI_SITE_SEO_FORM_FIELDS.title] = title;
+    if (description && seeded.description && description !== trimmed(current['description'])) {
+        updates[AI_SITE_SEO_FORM_FIELDS.description] = description;
+    }
+    return updates;
+}
+
+//# sourceMappingURL=ai-site-entity.js.map