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

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-entity.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 { defaultHomeDescription, defaultSiteSeo } from '@aglyn/aglyn/app-utils/default-site'\nimport type { LocalBusinessType } from '@aglyn/aglyn/app-utils/local-business'\nimport { HostEntityType } from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport { aiSiteAddressLine, aiSiteDetailsOf, aiSiteHoursSentence, aiSiteServiceAreas } from './ai-site-details'\nimport { aiSiteKindOfInputs } from './ai-site-kinds'\nimport { aiSiteSeoProposalForInputs, AI_SITE_SEO_FORM_FIELDS, type AiSiteSeoProposal } from './ai-site-start-seo'\n\n/**\n * Who publishes a site a guided start built, as its structured data and its\n * `/llms.txt` say (AGL-3979).\n *\n * Every tenant page publishes a top-level Organization (or Person) node, and\n * `/llms.txt` carries the site's agent guidance, both read off the host's\n * Setup → SEO → Entity and AI agents fields (`siteEntityJsonLd`,\n * `buildLlmsTxt`). Before this, a guided start wrote none of those fields:\n * every AI-built site published a node holding its name and nothing else — no\n * contact point, no address, no business type — and the guidance was the\n * platform's own default. The answers the person gave are the facts those\n * fields ask for, so the publish writes them.\n *\n * ── Derived, never generated ─────────────────────────────────────────────\n *\n * Each value is the person's own words or arithmetic on them: the schema\n * type from the kind of site they picked (and, for a few kinds, the words\n * they used), the description from the same composition as the site's\n * search listing, the guidance from what they said and gave. No model is\n * asked, and nothing is invented: a field the answers say nothing about is\n * left alone.\n *\n * ── Never over the owner ─────────────────────────────────────────────────\n *\n * {@link aiSiteEntityUpdates} writes only fields that are empty, so a site\n * whose owner already filled its Entity keeps every word of it, and a second\n * publish (Try again) writes nothing it wrote before.\n *\n * ── The site's own listing ───────────────────────────────────────────────\n *\n * `/llms.txt` opens with the site's title and description, and every page\n * without its own title falls back to them. A new site is created with its\n * name and a \"Welcome to …\" line there, which nobody chose, so\n * {@link aiSiteListingUpdates} puts the start's listing over that seeded\n * default, and only over it: a title or description the owner changed keeps\n * their words, and the SEO section offers the start's beside them.\n *\n * Pure: no Firestore and no React.\n */\n\n/** How a kind of site publishes: as a person, or as a business of a `schema.org` LocalBusiness type. */\ninterface KindSchema {\n  person?: true\n  businessType?: LocalBusinessType\n  /** A narrower type the person's words name, first match wins. */\n  refine?: ReadonlyArray<readonly [RegExp, LocalBusinessType]>\n}\n\n/**\n * Each `AI_SITE_KINDS` entry's `schema.org` type (`ai-site-entity.spec.ts`\n * holds every kind to an entry). A kind with no business type publishes as an\n * Organization — a blog, a band, an event, a course — unless the person gave\n * a street address or opening hours, which make it a place a visitor goes:\n * a LocalBusiness. Only types on the platform's `LOCAL_BUSINESS_TYPES` list\n * are used, since only those publish.\n */\nexport const AI_SITE_KIND_SCHEMA: Readonly<Record<string, KindSchema>> = {\n  business: {\n    businessType: 'LocalBusiness',\n    refine: [\n      [/\\b(?:marketing|consult\\w*|agency|freelanc\\w*|staffing|bookkeep\\w*|design(?:er)?s?)\\b/i, 'ProfessionalService'],\n      [/\\b(?:car wash|detailing|auto repair|mechanic|tire|tyre)\\b/i, 'AutomotiveBusiness'],\n    ],\n  },\n  trades: {\n    businessType: 'HomeAndConstructionBusiness',\n    refine: [\n      [/\\bplumb\\w*/i, 'Plumber'],\n      [/\\belectric\\w*/i, 'Electrician'],\n      [/\\b(?:hvac|heating|air condition\\w*|furnace)\\b/i, 'HVACBusiness'],\n      [/\\broof\\w*/i, 'RoofingContractor'],\n      [/\\bpaint\\w*/i, 'HousePainter'],\n      [/\\blocksmith\\w*/i, 'Locksmith'],\n      [/\\bmov(?:ing|ers?)\\b/i, 'MovingCompany'],\n      [/\\b(?:contractor|remodel\\w*|renovat\\w*|builders?|construction)\\b/i, 'GeneralContractor'],\n    ],\n  },\n  professional: {\n    businessType: 'ProfessionalService',\n    refine: [\n      [/\\b(?:law|lawyers?|attorneys?|legal|solicitors?)\\b/i, 'LegalService'],\n      [/\\b(?:accounting|accountants?|bookkeep\\w*|tax|cpa)\\b/i, 'AccountingService'],\n    ],\n  },\n  wellness: {\n    businessType: 'HealthAndBeautyBusiness',\n    refine: [\n      [/\\b(?:dentist\\w*|dental|orthodont\\w*)\\b/i, 'Dentist'],\n      [/\\b(?:clinic|doctors?|physicians?|medical|therap\\w*|chiropract\\w*|physio\\w*|counsel\\w*)\\b/i, 'MedicalBusiness'],\n    ],\n  },\n  restaurant: {\n    businessType: 'Restaurant',\n    refine: [[/\\b(?:caf[eé]s?|coffee|bakery|bakeries|bars?|brewery|food truck|deli)\\b/i, 'FoodEstablishment']],\n  },\n  store: { businessType: 'Store' },\n  portfolio: {},\n  studio: { businessType: 'ProfessionalService' },\n  photography: { businessType: 'ProfessionalService' },\n  blog: {},\n  events: {},\n  fitness: { businessType: 'SportsActivityLocation' },\n  yoga: { businessType: 'SportsActivityLocation' },\n  beauty: { businessType: 'HealthAndBeautyBusiness' },\n  realestate: { businessType: 'RealEstateAgent' },\n  education: { refine: [[/\\b(?:day ?care|child ?care|preschool|nursery)\\b/i, 'ChildCare']] },\n  nonprofit: { refine: [[/\\b(?:animal (?:shelter|rescue)|pet rescue)\\b/i, 'AnimalShelter']] },\n  music: {},\n  personal: { person: true },\n  landing: {},\n  'coming-soon': {},\n}\n\n/** The schema a site's answers publish under: a Person, or an Organization with a business type or none. */\nexport interface AiSiteSchema {\n  person: boolean\n  businessType: LocalBusinessType | null\n}\n\n/** What a job's inputs say the site publishes as. */\nexport function aiSiteSchemaOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteSchema {\n  const kind = aiSiteKindOfInputs(inputs)\n  const entry = (kind && AI_SITE_KIND_SCHEMA[kind.id]) || {}\n  if (entry.person) return { person: true, businessType: null }\n  const words = [inputs?.['businessType'], inputs?.['audience']].filter((value) => typeof value === 'string').join(' ')\n  const refined = entry.refine?.find(([pattern]) => pattern.test(words))?.[1]\n  const details = aiSiteDetailsOf(inputs)\n  const place = Boolean(details.street || details.hours)\n  return { person: false, businessType: refined ?? entry.businessType ?? (place ? 'LocalBusiness' : null) }\n}\n\n/** The Entity and AI-agent values a job's answers give; a field they say nothing about is `''` or `[]`. */\nexport interface AiSiteEntityValues {\n  person: boolean\n  name: string\n  description: string\n  email: string\n  telephone: string\n  address: {\n    streetAddress: string\n    addressLocality: string\n    addressRegion: string\n    postalCode: string\n    addressCountry: string\n  }\n  /** The street address as one line, as Setup → Details → Business details holds it; `''` without a street. */\n  postalAddress: string\n  businessType: string\n  areaServed: string[]\n  openingHours: string\n  priceRange: string\n  sameAs: string[]\n  whenToUse: string\n  howToUse: string\n}\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : '')\n\n/** \"a, b and c\". */\nfunction listed(parts: readonly string[]): string {\n  if (parts.length < 2) return parts.join('')\n  return `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`\n}\n\n/**\n * The site's agent guidance from its answers (AGL-3979): when an agent should\n * use the site — what the business is, then what the site answers — and,\n * where the person gave a way to reach it, how to reach a person. Written in\n * English, as the rest of `/llms.txt` is.\n */\nexport function aiSiteAgentGuidance(input: {\n  name: string\n  description: string\n  areas: readonly string[]\n  hours: boolean\n  prices: boolean\n  languages: string\n  phone: string\n  email: string\n  address: string\n}): { whenToUse: string; howToUse: string } {\n  const who = input.name || 'this business'\n  const answers = [\n    `what ${who} offers`,\n    ...(input.areas.length ? [`the areas it serves (${input.areas.slice(0, 6).join(', ')})`] : []),\n    ...(input.hours ? ['its opening hours'] : []),\n    ...(input.prices ? ['its prices'] : []),\n    'how to get in touch',\n  ]\n  // A site the answers say nothing about gets no guidance: the platform's own\n  // derived \"When to use this site\" says more than a sentence about nobody.\n  const said = Boolean(input.name || input.description)\n  const when = said\n    ? [\n        input.description,\n        `Use this site for ${listed(answers)}.`,\n        input.languages ? `It serves customers in ${input.languages.replace(/[.\\s]+$/, '')}.` : '',\n      ]\n        .filter(Boolean)\n        .join(' ')\n    : ''\n  const reach = [input.phone ? `call ${input.phone}` : '', input.email ? `email ${input.email}` : ''].filter(Boolean)\n  const how = [\n    reach.length ? `To reach a person at ${who}, ${reach.join(' or ')}.` : '',\n    input.address ? `${input.name || 'The business'} is at ${input.address}.` : '',\n  ]\n    .filter(Boolean)\n    .join(' ')\n  return { whenToUse: when, howToUse: how }\n}\n\n/**\n * The Entity and AI-agent values a site job's inputs imply, in the language\n * its plan writes the site in. `siteName` is the site's own name: it leads\n * the description and the guidance where the inputs name no business, and is\n * never written as the Entity's name, which falls back to it at render and so\n * follows a rename.\n */\nexport function aiSiteEntityValues(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { language?: string | null; siteName?: string | null } = {},\n): AiSiteEntityValues {\n  const details = aiSiteDetailsOf(inputs)\n  const schema = aiSiteSchemaOf(inputs)\n  const name = text(inputs?.['businessName'])\n  const city = text(inputs?.['city'])\n  const listing = aiSiteSeoProposalForInputs(inputs, options.language ?? null, options.siteName ?? null)\n  const description = listing?.values[AI_SITE_SEO_FORM_FIELDS.description] ?? ''\n  const areas = aiSiteServiceAreas(details.serviceArea)\n  // A business that names no other area serves the city it is in.\n  const areaServed = schema.businessType ? (areas.length ? areas : city ? [city] : []) : []\n  const sameAs = details.social ? details.social.split('\\n').filter(Boolean) : []\n  const address = details.street ? aiSiteAddressLine(details, city) : ''\n  const guidance = aiSiteAgentGuidance({\n    name: name || text(options.siteName),\n    description,\n    areas,\n    hours: Boolean(aiSiteHoursSentence(details.hours)),\n    prices: Boolean(details.priceRange),\n    languages: details.languages,\n    phone: details.phone,\n    email: details.email,\n    address,\n  })\n  return {\n    person: schema.person,\n    name,\n    description,\n    email: details.email,\n    telephone: details.phone,\n    address: {\n      streetAddress: details.street,\n      // The city is where the business is only where it gave a street to be on.\n      addressLocality: details.street || details.postalCode ? city : '',\n      addressRegion: details.region,\n      postalCode: details.postalCode,\n      addressCountry: details.country,\n    },\n    postalAddress: address,\n    businessType: schema.businessType ?? '',\n    areaServed,\n    openingHours: details.hours,\n    priceRange: details.priceRange,\n    sameAs,\n    ...guidance,\n  }\n}\n\nconst isBlank = (value: unknown): boolean =>\n  value === undefined ||\n  value === null ||\n  (typeof value === 'string' && !value.trim()) ||\n  (Array.isArray(value) && !value.some((entry) => typeof entry === 'string' && entry.trim()))\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** The contact a start's phone or email answers, as the Setup form's **Contact is for** says it: its default. */\nexport const AI_SITE_CONTACT_TYPE = 'customer support'\n\n/**\n * The host updates that put a start's Entity and AI-agent values on its site,\n * as field paths (`seo.entity.telephone`), for the publish's own batch: only\n * fields that are empty on the site, so nothing the owner wrote is replaced.\n * The address is written whole or not at all — a start's street beside the\n * owner's own city would be an address of neither. `{}` when there is\n * nothing to write.\n *\n * Beside the Entity, from what the site already has and the same answers:\n * - the Entity logo is the site's own logo, where it has one and the Entity\n *   names none (a Person's Entity picture is their photo, never a logo);\n * - **Contact is for** says what the phone or email this start wrote answers;\n * - Setup → Details → Business details gets the email as the support email\n *   (which `{{host.supportEmail}}` and a form that cannot take a message name)\n *   and the street address as its one block of text.\n */\nexport function aiSiteEntityUpdates(\n  seo: unknown,\n  values: AiSiteEntityValues,\n  site: { logoUrl?: unknown; business?: unknown } = {},\n): Record<string, unknown> {\n  const current = isRecord(seo) ? seo : {}\n  const entity = isRecord(current['entity']) ? current['entity'] : {}\n  const agent = isRecord(current['agent']) ? current['agent'] : {}\n  const business = isRecord(site.business) ? site.business : {}\n  const updates: Record<string, unknown> = {}\n  const fill = (path: string, now: unknown, next: string | string[]) => {\n    if (!isBlank(next) && isBlank(now)) updates[path] = next\n  }\n  const person = values.person && isBlank(entity['type'])\n  // As the Setup form's select stores it: the enum's value as text.\n  if (person) updates['seo.entity.type'] = String(HostEntityType.PERSON)\n  fill('seo.entity.name', entity['name'], values.name)\n  fill('seo.entity.description', entity['description'], values.description)\n  fill('seo.entity.email', entity['email'], values.email)\n  fill('seo.entity.telephone', entity['telephone'], values.telephone)\n  if (updates['seo.entity.email'] || updates['seo.entity.telephone']) {\n    fill('seo.entity.contactType', entity['contactType'], AI_SITE_CONTACT_TYPE)\n  }\n  const address = isRecord(entity['address']) ? entity['address'] : {}\n  if (Object.values(address).every(isBlank)) {\n    for (const [field, value] of Object.entries(values.address)) {\n      if (value) updates[`seo.entity.address.${field}`] = value\n    }\n  }\n  // A Person carries none of a business's fields (`siteEntityJsonLd`).\n  const isPerson = person || Number(entity['type']) === HostEntityType.PERSON\n  if (!isPerson) {\n    fill('seo.entity.logo', entity['logo'], typeof site.logoUrl === 'string' ? site.logoUrl.trim() : '')\n    fill('seo.entity.businessType', entity['businessType'], values.businessType)\n    fill('seo.entity.areaServed', entity['areaServed'], values.areaServed)\n    fill('seo.entity.openingHours', entity['openingHours'], values.openingHours)\n    fill('seo.entity.priceRange', entity['priceRange'], values.priceRange)\n  }\n  fill('seo.entity.sameAs', entity['sameAs'], values.sameAs)\n  fill('seo.agent.whenToUse', agent['whenToUse'], values.whenToUse)\n  fill('seo.agent.howToUse', agent['howToUse'], values.howToUse)\n  fill('business.supportEmail', business['supportEmail'], values.email)\n  fill('business.address', business['address'], values.postalAddress)\n  return updates\n}\n\n/** Trimmed, or `''` for anything that is not a string: as site creation compares names. */\nconst trimmed = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/**\n * Which half of a site's own listing is still the one its creation seeded\n * (AGL-3979): `defaultSiteSeo(name)` — the site's name as its title and\n * \"Welcome to {name}. See what we do, browse our work and get in touch.\" as\n * its description. Blank counts as seeded too: nobody chose it.\n *\n * The title is seeded when it is the site's name, or when it still pairs with\n * a seeded description, as it does on a site renamed after it was made. The\n * description is seeded when it is the welcome line for the site's name, for\n * the title's, or for no name. Anything else is the owner's own words.\n */\nexport function aiSiteListingSeeded(seo: unknown, displayName: unknown): { title: boolean; description: boolean } {\n  const current = isRecord(seo) ? seo : {}\n  const title = trimmed(current['title'])\n  const description = trimmed(current['description'])\n  const name = trimmed(displayName)\n  const welcomes = new Set([name, title, ''].map((each) => defaultHomeDescription(each)))\n  const seededDescription = !description || welcomes.has(description)\n  const seededTitle =\n    !title ||\n    title === trimmed(defaultSiteSeo(name)['title']) ||\n    (Boolean(description) && description === defaultHomeDescription(title))\n  return { title: seededTitle, description: seededDescription }\n}\n\n/**\n * The host updates that put a start's own listing on its site (AGL-3979), as\n * field paths for the publish's batch: each half only where it is still the\n * seeded default and differs from the listing, so the owner's own title or\n * description is never written over, and a second publish writes nothing.\n * `{}` with no listing to write.\n */\nexport function aiSiteListingUpdates(\n  seo: unknown,\n  displayName: unknown,\n  listing: AiSiteSeoProposal | null,\n): Record<string, string> {\n  if (!listing) return {}\n  const current = isRecord(seo) ? seo : {}\n  const seeded = aiSiteListingSeeded(current, displayName)\n  const updates: Record<string, string> = {}\n  const title = trimmed(listing.values[AI_SITE_SEO_FORM_FIELDS.title])\n  const description = trimmed(listing.values[AI_SITE_SEO_FORM_FIELDS.description])\n  if (title && seeded.title && title !== trimmed(current['title'])) updates[AI_SITE_SEO_FORM_FIELDS.title] = title\n  if (description && seeded.description && description !== trimmed(current['description'])) {\n    updates[AI_SITE_SEO_FORM_FIELDS.description] = description\n  }\n  return updates\n}\n"],"names":["defaultHomeDescription","defaultSiteSeo","HostEntityType","aiSiteAddressLine","aiSiteDetailsOf","aiSiteHoursSentence","aiSiteServiceAreas","aiSiteKindOfInputs","aiSiteSeoProposalForInputs","AI_SITE_SEO_FORM_FIELDS","AI_SITE_KIND_SCHEMA","business","businessType","refine","trades","professional","wellness","restaurant","store","portfolio","studio","photography","blog","events","fitness","yoga","beauty","realestate","education","nonprofit","music","personal","person","landing","aiSiteSchemaOf","inputs","refined","entry","kind","id","words","filter","value","join","find","pattern","test","details","place","Boolean","street","hours","text","replace","trim","listed","parts","length","slice","aiSiteAgentGuidance","input","who","name","answers","areas","prices","said","description","when","languages","reach","phone","email","how","address","whenToUse","howToUse","aiSiteEntityValues","options","schema","city","listing","language","siteName","values","serviceArea","areaServed","sameAs","social","split","guidance","priceRange","telephone","streetAddress","addressLocality","postalCode","addressRegion","region","addressCountry","country","postalAddress","openingHours","isBlank","undefined","Array","isArray","some","isRecord","AI_SITE_CONTACT_TYPE","aiSiteEntityUpdates","seo","site","current","entity","agent","updates","fill","path","now","next","String","PERSON","Object","every","field","entries","isPerson","Number","logoUrl","trimmed","aiSiteListingSeeded","displayName","title","welcomes","Set","map","each","seededDescription","has","seededTitle","aiSiteListingUpdates","seeded"],"mappings":"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"}

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

@@ -0,0 +1,72 @@
+/**
+ * @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.
+ */
+/**
+ * Sites I like (AGL-3975, part of AGL-3973): the sites a person names in the
+ * guided start as inspiration, as the job carries them.
+ *
+ * Free names one site and a paid plan three. From each the site job takes
+ * SIGNALS only — how the sections run, the colors, the type's mood, the shape
+ * of buttons and cards, how the pages move and, on a paid plan, which
+ * features it offers — each read by code into the site job's own closed sets
+ * (`jobs/ai-site-inspiration-signals.ts`). Never a word, a picture or a logo
+ * of theirs: nothing a page says reaches a prompt.
+ *
+ * Behind `release_ai_site_inspiration`, off by default: with it off the
+ * guided start asks for no site and a job's inspiration is never read.
+ *
+ * Pure and console-safe: the input's name, the limits and how an answer is
+ * read. No network.
+ */
+/** The release flag the whole feature waits behind. */
+export declare const AI_SITE_INSPIRATION_FLAG: "release_ai_site_inspiration";
+/**
+ * The job input the sites travel in: one string, the addresses separated by
+ * spaces, because a job's inputs are scalars (`parseCreateAiJobBody`).
+ */
+export declare const AI_SITE_INSPIRATION_INPUT = "inspiration";
+/** How many sites a plan may name: Free one, every paid plan three. */
+export declare const AI_SITE_INSPIRATION_LIMITS: {
+    readonly free: 1;
+    readonly paid: 3;
+};
+/** The most any job may carry, whatever its plan. */
+export declare const AI_SITE_INSPIRATION_MAX: 3;
+/** The longest address one site may be given as. */
+export declare const AI_SITE_INSPIRATION_URL_MAX_CHARS = 300;
+/** What the guided start says a paid plan adds, beside a Free workspace's locked fields. */
+export declare const AI_SITE_INSPIRATION_PAID_NOTE: string;
+/** How many sites a workspace may name. */
+export declare function aiSiteInspirationLimit(freeTaste: boolean | null | undefined): number;
+/**
+ * One address as the job keeps it: https only, no credentials, the default
+ * port, no fragment. `null` for anything else. A bare host ("example.com")
+ * is read as its https address, the way a person types one.
+ */
+export declare function aiSiteInspirationUrl(value: unknown): string | null;
+/**
+ * The sites a job's inputs name, or the sentence the door refuses them with.
+ * Absent or empty is none. Each must be an https address; more than
+ * {@link AI_SITE_INSPIRATION_MAX} is refused, and the same site twice counts
+ * once. The plan's own limit is the door's (`aiSiteInspirationRefusal`).
+ */
+export declare function parseAiSiteInspiration(inputs: Readonly<Record<string, unknown>> | null | undefined): string[] | string;
+/** Why a workspace may not name this many sites, in a sentence a member reads; `null` when it may. */
+export declare function aiSiteInspirationRefusal(urls: readonly string[], freeTaste: boolean | null | undefined): string | null;
+/** The sites as the job input carries them; empty for none, which the start leaves out of its inputs. */
+export declare function aiSiteInspirationInput(urls: readonly string[]): string;
+/** A site as the review names it: its host, without `www.`. */
+export declare function aiSiteInspirationHost(url: string): string;

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

@@ -0,0 +1,109 @@
+/**
+ * @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.
+ */ /**
+ * Sites I like (AGL-3975, part of AGL-3973): the sites a person names in the
+ * guided start as inspiration, as the job carries them.
+ *
+ * Free names one site and a paid plan three. From each the site job takes
+ * SIGNALS only — how the sections run, the colors, the type's mood, the shape
+ * of buttons and cards, how the pages move and, on a paid plan, which
+ * features it offers — each read by code into the site job's own closed sets
+ * (`jobs/ai-site-inspiration-signals.ts`). Never a word, a picture or a logo
+ * of theirs: nothing a page says reaches a prompt.
+ *
+ * Behind `release_ai_site_inspiration`, off by default: with it off the
+ * guided start asks for no site and a job's inspiration is never read.
+ *
+ * Pure and console-safe: the input's name, the limits and how an answer is
+ * read. No network.
+ */ /** The release flag the whole feature waits behind. */ export const AI_SITE_INSPIRATION_FLAG = 'release_ai_site_inspiration';
+/**
+ * The job input the sites travel in: one string, the addresses separated by
+ * spaces, because a job's inputs are scalars (`parseCreateAiJobBody`).
+ */ export const AI_SITE_INSPIRATION_INPUT = 'inspiration';
+/** How many sites a plan may name: Free one, every paid plan three. */ export const AI_SITE_INSPIRATION_LIMITS = {
+    free: 1,
+    paid: 3
+};
+/** The most any job may carry, whatever its plan. */ export const AI_SITE_INSPIRATION_MAX = AI_SITE_INSPIRATION_LIMITS.paid;
+/** The longest address one site may be given as. */ export const AI_SITE_INSPIRATION_URL_MAX_CHARS = 300;
+/** What the guided start says a paid plan adds, beside a Free workspace's locked fields. */ export const AI_SITE_INSPIRATION_PAID_NOTE = `Paid plans can name up to ${AI_SITE_INSPIRATION_LIMITS.paid} sites, and also match the features they offer, like booking, a store or a blog.`;
+/** How many sites a workspace may name. */ export function aiSiteInspirationLimit(freeTaste) {
+    return freeTaste ? AI_SITE_INSPIRATION_LIMITS.free : AI_SITE_INSPIRATION_LIMITS.paid;
+}
+/**
+ * One address as the job keeps it: https only, no credentials, the default
+ * port, no fragment. `null` for anything else. A bare host ("example.com")
+ * is read as its https address, the way a person types one.
+ */ export function aiSiteInspirationUrl(value) {
+    if (typeof value !== 'string') return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > AI_SITE_INSPIRATION_URL_MAX_CHARS) return null;
+    const written = /^[a-z][a-z0-9+.-]*:/i.test(trimmed) ? trimmed : `https://${trimmed}`;
+    let url;
+    try {
+        url = new URL(written);
+    } catch (unused) {
+        return null;
+    }
+    if (url.protocol !== 'https:' || url.username || url.password) return null;
+    if (url.port && url.port !== '443') return null;
+    // A host with no dot is a typo or an internal name, never a public site.
+    if (!url.hostname.includes('.') || url.hostname.endsWith('.')) return null;
+    url.hash = '';
+    return url.toString();
+}
+/**
+ * The sites a job's inputs name, or the sentence the door refuses them with.
+ * Absent or empty is none. Each must be an https address; more than
+ * {@link AI_SITE_INSPIRATION_MAX} is refused, and the same site twice counts
+ * once. The plan's own limit is the door's (`aiSiteInspirationRefusal`).
+ */ export function parseAiSiteInspiration(inputs) {
+    const raw = inputs == null ? void 0 : inputs[AI_SITE_INSPIRATION_INPUT];
+    if (raw === undefined || raw === null || raw === '') return [];
+    if (typeof raw !== 'string') {
+        return `${AI_SITE_INSPIRATION_INPUT} must be text: the addresses of the sites you like, separated by spaces`;
+    }
+    const urls = [];
+    for (const word of raw.split(/\s+/).filter(Boolean)){
+        const url = aiSiteInspirationUrl(word);
+        if (!url) return 'Give each site you like as its https address, like https://example.com.';
+        if (!urls.includes(url)) urls.push(url);
+    }
+    if (urls.length > AI_SITE_INSPIRATION_MAX) return `Name at most ${AI_SITE_INSPIRATION_MAX} sites you like.`;
+    return urls;
+}
+/** Why a workspace may not name this many sites, in a sentence a member reads; `null` when it may. */ export function aiSiteInspirationRefusal(urls, freeTaste) {
+    const limit = aiSiteInspirationLimit(freeTaste);
+    if (urls.length <= limit) return null;
+    return freeTaste ? `A Free workspace can name ${AI_SITE_INSPIRATION_LIMITS.free} site you like. ${AI_SITE_INSPIRATION_PAID_NOTE}` : `Name at most ${limit} sites you like.`;
+}
+/** The sites as the job input carries them; empty for none, which the start leaves out of its inputs. */ export function aiSiteInspirationInput(urls) {
+    const kept = [];
+    for (const url of urls.map(aiSiteInspirationUrl)){
+        if (url && !kept.includes(url)) kept.push(url);
+    }
+    return kept.slice(0, AI_SITE_INSPIRATION_MAX).join(' ');
+}
+/** A site as the review names it: its host, without `www.`. */ export function aiSiteInspirationHost(url) {
+    try {
+        return new URL(url).hostname.replace(/^www\./, '');
+    } catch (unused) {
+        return url;
+    }
+}
+
+//# sourceMappingURL=ai-site-inspiration.js.map