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

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

@@ -13,7 +13,11 @@
  * 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 { aiSiteKind, aiSiteKindFor } from "./ai-site-kinds.js";
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { weeklyHoursFromText, weeklyHoursToText } from "@aglyn/shared-ui-jsx/utils/weekly-hours";
+import { AI_SITE_DETAIL_KEYS, AI_SITE_NO_DETAILS, aiSiteDetailProblem, aiSiteDetailsOf } from "./ai-site-details.js";
+import { aiSiteKind, aiSiteKindFor } from "./ai-site-kinds.js";
+import { AI_SITE_INSPIRATION_INPUT, aiSiteInspirationInput, aiSiteInspirationLimit, aiSiteInspirationRefusal, aiSiteInspirationUrl } from "./ai-site-inspiration.js";
 import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from "./ai-site-job.js";
 /**
  * The examples the start offers, in the order they are shown. The platform's
@@ -71,15 +75,49 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
  * unless it is told not to, and the Inbox because it is what every submission
  * does anyway — filing a lead as well is the addition, and an addition is the
  * thing a person should have to choose.
- */ export const AI_SITE_START_ANSWERS = {
+ */ export const AI_SITE_START_ANSWERS = _extends({
     siteType: '',
     audience: '',
     example: null,
     kind: null,
     pages: 5,
     submissions: 'inbox',
-    welcomeEmail: true
-};
+    welcomeEmail: true,
+    city: '',
+    brand: ''
+}, AI_SITE_NO_DETAILS);
+/** Every extra, in the order the review lists them. */ export const AI_SITE_START_EXTRA_KEYS = [
+    'phone',
+    'email',
+    'tagline',
+    'founded',
+    'serviceArea',
+    'priceRange',
+    'languages',
+    'brand',
+    'street',
+    'city',
+    'region',
+    'postalCode',
+    'country',
+    'hours',
+    'social'
+];
+/** What is wrong with one extra, worded for beside its field; `null` when it may be used. */ export function aiSiteStartExtraProblem(key, value) {
+    if (key === 'city' || key === 'brand') {
+        return value.trim().length > AI_SITE_INPUT_MAX_CHARS ? {
+            code: 'too_long',
+            message: `Keep this under ${AI_SITE_INPUT_MAX_CHARS} characters.`
+        } : null;
+    }
+    return aiSiteDetailProblem(key, value);
+}
+/** The extras a person gave, in the review's order: what "More details" was used for. */ export function aiSiteStartExtrasGiven(answers) {
+    return AI_SITE_START_EXTRA_KEYS.filter((key)=>{
+        var _answers_key;
+        return ((_answers_key = answers[key]) != null ? _answers_key : '').trim() !== '';
+    });
+}
 /** The kind of site the answers pick, else the one what the site is and who it is for suggest. */ export function aiSiteStartKind(answers) {
     var _aiSiteKind, _answers_audience;
     return (_aiSiteKind = aiSiteKind(answers.kind)) != null ? _aiSiteKind : aiSiteKindFor(answers.siteType, (_answers_audience = answers.audience) != null ? _answers_audience : '');
@@ -113,7 +151,23 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
     if (!AI_SITE_SUBMISSIONS.includes(answers.submissions)) {
         return 'Say where the contact form’s submissions go.';
     }
-    return null;
+    for (const key of AI_SITE_START_EXTRA_KEYS){
+        var _answers_key;
+        const problem = aiSiteStartExtraProblem(key, (_answers_key = answers[key]) != null ? _answers_key : '');
+        if (problem) return problem.message;
+    }
+    return aiSiteStartInspirationRefusal(answers, options);
+}
+/** The sites they typed, without the empty fields. */ export function aiSiteStartInspirationTyped(answers) {
+    var _answers_inspiration;
+    return ((_answers_inspiration = answers.inspiration) != null ? _answers_inspiration : []).map((entry)=>entry.trim()).filter(Boolean);
+}
+/** Why the sites they like cannot go forward, as the door would refuse them; `null` when they can. */ export function aiSiteStartInspirationRefusal(answers, options = {}) {
+    const typed = aiSiteStartInspirationTyped(answers);
+    if (typed.some((entry)=>!aiSiteInspirationUrl(entry))) {
+        return 'Give each site you like as its https address, like https://example.com.';
+    }
+    return aiSiteInspirationRefusal(typed, options.freeTaste);
 }
 /**
  * The answers as the brief the `site` job is created with: the plan step reads
@@ -157,21 +211,35 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
  * reached the model with no name had the model invent one for its header and
  * footer.
  */ export function aiSiteStartInputs(answers) {
-    var _ref;
+    var _ref, _answers_city, _answers_brand;
     const example = aiSiteStartExample(answers);
     const kind = aiSiteStartKind(answers);
-    return {
+    // The details are sent only where given (AGL-3979): the plan step lists
+    // every scalar input on a line of its own, and a start without them is
+    // asked exactly what it was asked before.
+    const details = {};
+    for (const key of AI_SITE_DETAIL_KEYS){
+        var _answers_key;
+        const value = ((_answers_key = answers[key]) != null ? _answers_key : '').trim();
+        if (value) details[key] = value;
+    }
+    // The sites they like travel only when there are some (AGL-3975), so a
+    // start without them asks for exactly what it always did.
+    const inspiration = aiSiteInspirationInput(aiSiteStartInspirationTyped(answers));
+    return _extends({
         businessType: answers.siteType.trim(),
         audience: answers.audience.trim(),
         starter: (_ref = example == null ? void 0 : example.id) != null ? _ref : kind.starter,
         siteKind: kind.id,
         pages: answers.pages,
         businessName: '',
-        city: '',
-        brand: '',
+        city: ((_answers_city = answers.city) != null ? _answers_city : '').trim(),
+        brand: ((_answers_brand = answers.brand) != null ? _answers_brand : '').trim(),
         submissions: answers.submissions,
         welcomeEmail: answers.welcomeEmail
-    };
+    }, details, inspiration ? {
+        [AI_SITE_INSPIRATION_INPUT]: inspiration
+    } : {});
 }
 /** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */ export const AI_SITE_START_INPUT_KEYS = [
     'businessType',
@@ -183,7 +251,9 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
     'city',
     'brand',
     'submissions',
-    'welcomeEmail'
+    'welcomeEmail',
+    ...AI_SITE_DETAIL_KEYS,
+    AI_SITE_INSPIRATION_INPUT
 ];
 /** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */ export function aiSiteStartInputsOf(inputs) {
     if (!inputs) return null;
@@ -210,15 +280,139 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
     const pages = typeof (inputs == null ? void 0 : inputs['pages']) === 'number' ? Math.round(inputs['pages']) : AI_SITE_START_ANSWERS.pages;
     const starter = text('starter');
     const submissions = text('submissions');
-    return {
+    return _extends({
         siteType,
         audience: text('audience'),
         example: AI_SITE_START_EXAMPLES.some((entry)=>entry.id === starter) ? starter : null,
         kind: (_ref = (_aiSiteKind = aiSiteKind(text('siteKind'))) == null ? void 0 : _aiSiteKind.id) != null ? _ref : null,
         pages: Math.min(band.max, Math.max(band.min, pages)),
         submissions: AI_SITE_SUBMISSIONS.includes(submissions) ? submissions : AI_SITE_START_ANSWERS.submissions,
-        welcomeEmail: options.freeTaste ? false : (inputs == null ? void 0 : inputs['welcomeEmail']) !== false
+        welcomeEmail: options.freeTaste ? false : (inputs == null ? void 0 : inputs['welcomeEmail']) !== false,
+        city: text('city'),
+        brand: text('brand')
+    }, Object.fromEntries(AI_SITE_DETAIL_KEYS.map((key)=>[
+            key,
+            text(key)
+        ])), text(AI_SITE_INSPIRATION_INPUT) ? {
+        inspiration: text(AI_SITE_INSPIRATION_INPUT).split(/\s+/).filter(Boolean).slice(0, aiSiteInspirationLimit(options.freeTaste))
+    } : {});
+}
+// ── A build staff run for a client (AGL-3958) ───────────────────────────────
+/** Shortens an answer to what a scalar input admits, on a word where it can. */ function bounded(value, max) {
+    const trimmed = value.trim().replace(/\s+/g, ' ');
+    if (trimmed.length <= max) return trimmed;
+    const cut = trimmed.slice(0, max);
+    const space = cut.lastIndexOf(' ');
+    return (space > max / 2 ? cut.slice(0, space) : cut).trim();
+}
+/** A time with am or pm: "9am", "5:30 pm", "12 a.m.". */ const TWELVE_HOUR_TIME = /\b(\d{1,2})(?::(\d{2}))?\s*([ap])\.?m\.?(?![a-z])/gi;
+/**
+ * The hours an owner gave, in the shape the Details step's hours picker
+ * writes (`Tu-Sa 09:00-17:00`, one set of days a line), so the plan reads
+ * them as it reads hours picked there. A time with am or pm is the time it
+ * names, "to" joins a range as a dash does, and days with their hours may be
+ * set apart by a comma, a semicolon or a line. Whatever still does not read
+ * as hours — "8–5", "Sat by appointment" — is left out rather than guessed at.
+ */ function clientBuildHours(hours) {
+    const lines = hours.replace(TWELVE_HOUR_TIME, (time, hour, minutes, half)=>{
+        const h = Number(hour);
+        if (h < 1 || h > 12) return time;
+        const clock = h % 12 + (half.toLowerCase() === 'p' ? 12 : 0);
+        return `${String(clock).padStart(2, '0')}:${minutes != null ? minutes : '00'}`;
+    }).replace(/\s+to\s+/gi, '-').replace(/(\d{1,2}:\d{2})\s*,\s*/g, '$1\n').replace(/;/g, '\n');
+    const week = weeklyHoursFromText(lines).hours;
+    return week.some((day)=>day.length) ? weeklyHoursToText(week) : '';
+}
+/**
+ * The towns an intake serves, one a line, as the Details step's "Areas you
+ * serve" holds them: "Austin, Round Rock and Pflugerville" is three.
+ */ function clientBuildServiceArea(towns) {
+    return towns.split(/\r?\n|[,;]|\s+(?:and|&)\s+/i).map((town)=>town.trim()).filter(Boolean).join('\n');
+}
+/**
+ * The questions' answers for a site staff are building for a client: what
+ * the business does is the kind of site, and the details the intake holds
+ * fill the Details step's own fields (AGL-3979, AGL-3995): the phone, the
+ * email, the towns as the areas it serves and the hours, each held to that
+ * detail's own rule, so one the Details step would refuse is left empty
+ * there. Every other answer keeps its default, which the review shows to
+ * change. The intake, a refused detail included, also reaches the job
+ * through {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.
+ */ export function aiSiteStartAnswersFromClientBuild(intake) {
+    const details = aiSiteDetailsOf({
+        phone: intake.phone,
+        email: intake.email,
+        serviceArea: clientBuildServiceArea(intake.towns),
+        hours: clientBuildHours(intake.hours)
+    });
+    return _extends({}, AI_SITE_START_ANSWERS, {
+        siteType: bounded(intake.whatTheyDo, AI_SITE_INPUT_MAX_CHARS),
+        phone: details.phone,
+        email: details.email,
+        serviceArea: details.serviceArea,
+        hours: details.hours
+    });
+}
+/**
+ * The per-site inputs the intake fills, which the guided start's own
+ * questions leave empty: the business's name for the header and footer, and
+ * the towns it serves as its place.
+ *
+ * The towns are the place only while no address is given. The Entity reads
+ * `city` as the address's own locality wherever there is a street or a
+ * postal code (`aiSiteEntity`), so once the answers carry either, `city` is
+ * the city the Details step was given with that address, never the towns
+ * (AGL-3995). The intake asks no address, so today that is the Details step's
+ * own, typed on the review; the towns still reach the site as the areas it
+ * serves.
+ */ export function aiSiteStartClientInputs(intake, answers) {
+    var _ref;
+    const addressed = Boolean((answers == null ? void 0 : answers.street.trim()) || (answers == null ? void 0 : answers.postalCode.trim()));
+    return {
+        businessName: bounded(intake.businessName, AI_SITE_INPUT_MAX_CHARS),
+        city: bounded(addressed ? (_ref = answers == null ? void 0 : answers.city) != null ? _ref : '' : intake.towns, AI_SITE_INPUT_MAX_CHARS)
     };
 }
+/**
+ * The intake as sentences added to the brief: how to reach the business and
+ * when it is open, which the site should say where a visitor looks for them,
+ * and the owner's own words, quoted, which the copy should sound like. Empty
+ * answers say nothing.
+ */ export function aiSiteStartClientBrief(intake) {
+    const name = intake.businessName.trim();
+    const towns = intake.towns.trim();
+    const phone = intake.phone.trim();
+    const email = intake.email.trim();
+    const hours = intake.hours.trim();
+    const words = intake.ownerWords.trim().replace(/\s+/g, ' ');
+    const sentences = [];
+    if (name) sentences.push(`The business is called ${name}.`);
+    if (towns) sentences.push(`It serves ${towns}.`);
+    const contact = [
+        phone ? `call ${phone}` : '',
+        email ? `email ${email}` : ''
+    ].filter(Boolean);
+    if (contact.length) {
+        sentences.push(`Visitors reach it to ${contact.join(' or ')}; say so wherever the site tells them how to get in touch.`);
+    }
+    if (hours) sentences.push(`Its hours are ${hours}.`);
+    if (words) sentences.push(`In the owner's own words: "${words}" Write the copy so it sounds like them.`);
+    return sentences.join(' ');
+}
+/**
+ * What the review says the client build adds beyond its own rows, so staff
+ * see the intake is used without it being asked again: the business's name
+ * and the owner's own words, which no row shows. The phone, email, towns and
+ * hours are the review's Details rows already (AGL-3995), so the note does
+ * not say them twice: "Also from the client's details: Harbor Plumbing and
+ * the owner's own words."
+ */ export function aiSiteStartClientNote(intake) {
+    const parts = [
+        intake.businessName.trim(),
+        intake.ownerWords.trim() ? "the owner's own words" : ''
+    ].filter(Boolean);
+    if (!parts.length) return 'Built from the client’s details.';
+    return `Also from the client’s details: ${parts.join(' and ')}.`;
+}
 
 //# sourceMappingURL=ai-site-start.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start.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 { aiSiteKind, aiSiteKindFor, type AiSiteKind } from './ai-site-kinds'\nimport {\n  AI_SITE_INPUT_MAX_CHARS,\n  AI_SITE_SUBMISSIONS,\n  aiSitePagesBand,\n  type AiSiteJobInputs,\n  type AiSiteSubmissions,\n} from './ai-site-job'\n\n/**\n * The guided start (AGL-2918): the questions a person answers on a site they\n * have just made, and the site job those answers become.\n *\n * A scaffold already exists — the `site` job plans four to eight pages, a\n * layout, a contact form, a palette and a welcome email, and builds every one\n * of them as a draft. What it had no way in through was a brief: somebody had\n * to know what to write, on a site where nothing has happened yet. So this\n * module is the QUESTIONS, and nothing else: what is asked, what an answer may\n * be, and how a set of answers becomes the brief and the scalar inputs the\n * `site` door already takes.\n *\n * ── Answering is never the way out ───────────────────────────────────────\n *\n * There is no answer here that means \"not this\". The way past the questions\n * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them\n * from the first one and creates nothing at all — see the zone in\n * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make\n * leaving a thing you answer your way to, and it is not.\n *\n * ── Every answer but the first is optional ───────────────────────────────\n *\n * Only what a site is FOR has no default worth guessing. The audience narrows\n * the copy, the example steers the shape, the page count and the welcome\n * email are defaults a person may change — so a person who types six words\n * and confirms gets a planned site, and the rest of the questions are there\n * for the person who wants to answer them.\n *\n * Pure: shapes, vocabularies and two string builders. No React, no network,\n * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names\n * the starters rather than reading them, so the console does not carry a\n * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the\n * two lists to each other.\n */\n\n/** A worked example a person picks to steer what the site should look like. */\nexport interface AiSiteStartExample {\n  /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */\n  id: string\n  /** The starter as its card names it. */\n  label: string\n  /** The starter's category, which is how the examples group. */\n  category: string\n  /** What the example is, in one line a person reads before picking it. */\n  blurb: string\n}\n\n/**\n * The examples the start offers, in the order they are shown. The platform's\n * own starter sites: a person who has no words for what they want has seen\n * these five shapes before, and picking one says more than a sentence would.\n */\nexport const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[] = [\n  {\n    id: 'business',\n    label: 'Business',\n    category: 'Business',\n    blurb: 'A home page led by what you do, an about page and a contact page',\n  },\n  {\n    id: 'landing',\n    label: 'Landing Page',\n    category: 'Marketing',\n    blurb: 'One page that leads to one action, with the reasons to take it',\n  },\n  {\n    id: 'portfolio',\n    label: 'Portfolio',\n    category: 'Personal',\n    blurb: 'An introduction, a grid of work and a way to get in touch',\n  },\n  {\n    id: 'physical-shop',\n    label: 'Shop (physical products)',\n    category: 'Commerce',\n    blurb: 'Featured products, a shop to browse, and a cart',\n  },\n  {\n    id: 'digital-shop',\n    label: 'Shop (digital products)',\n    category: 'Commerce',\n    blurb: 'Downloads up front, a shop to browse, and a cart',\n  },\n]\n\n/**\n * Kinds of site offered beside the first question's box, so answering it can\n * be a tap. They fill the box rather than replacing it: what somebody is\n * building is theirs to say, and a list of eight is a list somebody is not on.\n */\nexport const AI_SITE_START_TYPES: readonly string[] = [\n  'a local service business',\n  'a restaurant or cafe',\n  'a professional practice',\n  'a trades business',\n  'a shop',\n  'a nonprofit',\n  'a personal portfolio',\n  'an event',\n]\n\n/** What a person answered; the shape the card holds and the brief is built from. */\nexport interface AiSiteStartAnswers {\n  /** What kind of site this is. The one answer with no default. */\n  siteType: string\n  /** Who the site is for; empty when they did not say. */\n  audience: string\n  /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */\n  example: string | null\n  /**\n   * The kind of site they picked (AGL-3660), by its `AI_SITE_KINDS` id;\n   * `null` until they pick one, when the kind their first answer suggests is\n   * the one used ({@link aiSiteStartKind}).\n   */\n  kind: string | null\n  /** How many pages to plan. */\n  pages: number\n  /** Where the contact form's submissions go. */\n  submissions: AiSiteSubmissions\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n}\n\n/**\n * What the questions start on. Five pages because it is the middle of the\n * band the scaffold builds, a welcome email because the scaffold drafts one\n * unless it is told not to, and the Inbox because it is what every submission\n * does anyway — filing a lead as well is the addition, and an addition is the\n * thing a person should have to choose.\n */\nexport const AI_SITE_START_ANSWERS: AiSiteStartAnswers = {\n  siteType: '',\n  audience: '',\n  example: null,\n  kind: null,\n  pages: 5,\n  submissions: 'inbox',\n  welcomeEmail: true,\n}\n\n/** The kind of site the answers pick, else the one what the site is and who it is for suggest. */\nexport function aiSiteStartKind(\n  answers: Pick<AiSiteStartAnswers, 'kind' | 'siteType'> & Partial<Pick<AiSiteStartAnswers, 'audience'>>,\n): AiSiteKind {\n  return aiSiteKind(answers.kind) ?? aiSiteKindFor(answers.siteType, answers.audience ?? '')\n}\n\n/** The example an answer names, or `null` when it names none this list knows. */\nexport function aiSiteStartExample(\n  answers: AiSiteStartAnswers,\n): AiSiteStartExample | null {\n  if (!answers.example) return null\n  return AI_SITE_START_EXAMPLES.find((entry) => entry.id === answers.example) ?? null\n}\n\n/**\n * Why these answers cannot start a site, in a sentence a person reads; `null`\n * when they can. The door's own parser is what actually admits the job — this\n * is what the card says before it asks for one.\n */\nexport function aiSiteStartRefusal(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\n  const siteType = answers.siteType.trim()\n  if (!siteType) return 'Say what kind of site this is.'\n  if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.max} pages.`\n  }\n  if (answers.example !== null && !aiSiteStartExample(answers)) {\n    return 'Pick one of the examples, or none of them.'\n  }\n  if (!(AI_SITE_SUBMISSIONS as readonly string[]).includes(answers.submissions)) {\n    return 'Say where the contact form’s submissions go.'\n  }\n  return null\n}\n\n/**\n * The answers as the brief the `site` job is created with: the plan step reads\n * it as the person's own words, so it says what they said and asks for nothing\n * they did not.\n */\nexport function aiSiteStartBrief(answers: AiSiteStartAnswers): string {\n  const siteType = answers.siteType.trim()\n  const audience = answers.audience.trim()\n  const example = aiSiteStartExample(answers)\n  const sentences = [\n    `A ${answers.pages}-page website for ${siteType}.`,\n  ]\n  if (audience) sentences.push(`It is for ${audience}.`)\n  if (example) {\n    sentences.push(\n      `Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`,\n    )\n  }\n  // The kind they picked, or the one their answer suggests (AGL-3660).\n  sentences.push(`Make it a ${aiSiteStartKind(answers).label.toLowerCase()} site.`)\n  // The form on the page a visitor opens to get in touch, never every page's\n  // last band (AGL-3899): \"on the page that asks to be contacted\" read as\n  // the home's closing band on 16 of the 22 newest production starts.\n  sentences.push(\n    answers.pages === 1\n      ? 'Plan the page around what a visitor comes to do, with a contact form on it.'\n      : 'Plan a page for each thing a visitor comes to do, with the contact form on the page a visitor opens to get in touch.',\n  )\n  if (audience) {\n    // Said of the FORM as well as of the copy: who fills a form in is what\n    // decides which fields it asks for, and a brief that named the audience\n    // once, in a sentence about the pages, left the form to guess.\n    sentences.push(`Ask the contact form for what ${audience} would be asked for.`)\n  }\n  return sentences.join(' ')\n}\n\n/**\n * The answers as the `site` job's scalar inputs. Read by the door's\n * {@link parseAiSiteJobInputs}, and put in front of the model one per line by\n * the plan step, which is how the audience and the example reach the plan\n * without a prompt of their own.\n *\n * The per-site variables an agency batch fills — the business name, the city,\n * the brand — are left empty here: the questions never ask them. The name is\n * the site's own, and the create door fills it from the site\n * (`aiJobAdmittedInputs`, AGL-3596) when the job is started — a job that\n * reached the model with no name had the model invent one for its header and\n * footer.\n */\nexport function aiSiteStartInputs(\n  answers: AiSiteStartAnswers,\n): Omit<AiSiteJobInputs, 'batchId'> {\n  const example = aiSiteStartExample(answers)\n  const kind = aiSiteStartKind(answers)\n  return {\n    businessType: answers.siteType.trim(),\n    audience: answers.audience.trim(),\n    starter: example?.id ?? kind.starter,\n    siteKind: kind.id,\n    pages: answers.pages,\n    businessName: '',\n    city: '',\n    brand: '',\n    submissions: answers.submissions,\n    welcomeEmail: answers.welcomeEmail,\n  }\n}\n\n/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */\nexport const AI_SITE_START_INPUT_KEYS = [\n  'businessType',\n  'audience',\n  'starter',\n  'siteKind',\n  'pages',\n  'businessName',\n  'city',\n  'brand',\n  'submissions',\n  'welcomeEmail',\n] as const\n\n/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */\nexport function aiSiteStartInputsOf(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): Record<string, unknown> | null {\n  if (!inputs) return null\n  const kept: Record<string, unknown> = {}\n  for (const key of AI_SITE_START_INPUT_KEYS) {\n    const value = inputs[key]\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value\n  }\n  return Object.keys(kept).length ? kept : null\n}\n\n/**\n * A failed start's answers, back as the questions hold them (AGL-3596), so\n * Try again reopens the guided start filled in for the person to adjust:\n * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the\n * questions no longer offer goes back to its default — and held to the\n * workspace's page band. `null` when the inputs say no kind of site at all.\n */\nexport function aiSiteStartAnswersFromInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { freeTaste?: boolean } = {},\n): AiSiteStartAnswers | null {\n  const text = (key: string) => (typeof inputs?.[key] === 'string' ? (inputs[key] as string).trim() : '')\n  const siteType = text('businessType')\n  if (!siteType) return null\n  const band = aiSitePagesBand(options.freeTaste)\n  const pages = typeof inputs?.['pages'] === 'number' ? Math.round(inputs['pages'] as number) : AI_SITE_START_ANSWERS.pages\n  const starter = text('starter')\n  const submissions = text('submissions')\n  return {\n    siteType,\n    audience: text('audience'),\n    example: AI_SITE_START_EXAMPLES.some((entry) => entry.id === starter) ? starter : null,\n    kind: aiSiteKind(text('siteKind'))?.id ?? null,\n    pages: Math.min(band.max, Math.max(band.min, pages)),\n    submissions: (AI_SITE_SUBMISSIONS as readonly string[]).includes(submissions)\n      ? (submissions as AiSiteSubmissions)\n      : AI_SITE_START_ANSWERS.submissions,\n    welcomeEmail: options.freeTaste ? false : inputs?.['welcomeEmail'] !== false,\n  }\n}\n"],"names":["aiSiteKind","aiSiteKindFor","AI_SITE_INPUT_MAX_CHARS","AI_SITE_SUBMISSIONS","aiSitePagesBand","AI_SITE_START_EXAMPLES","id","label","category","blurb","AI_SITE_START_TYPES","AI_SITE_START_ANSWERS","siteType","audience","example","kind","pages","submissions","welcomeEmail","aiSiteStartKind","answers","aiSiteStartExample","find","entry","aiSiteStartRefusal","options","band","freeTaste","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","siteKind","businessName","city","brand","AI_SITE_START_INPUT_KEYS","aiSiteStartInputsOf","inputs","kept","key","value","Object","keys","aiSiteStartAnswersFromInputs","text","Math","round","some"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start.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 type { ClientBuildIntake } from '@aglyn/aglyn/app-utils/client-build'\nimport { weeklyHoursFromText, weeklyHoursToText } from '@aglyn/shared-ui-jsx/utils/weekly-hours'\nimport {\n  AI_SITE_DETAIL_KEYS,\n  AI_SITE_NO_DETAILS,\n  aiSiteDetailProblem,\n  aiSiteDetailsOf,\n  type AiSiteDetailKey,\n  type AiSiteDetails,\n} from './ai-site-details'\nimport { aiSiteKind, aiSiteKindFor, type AiSiteKind } from './ai-site-kinds'\nimport {\n  AI_SITE_INSPIRATION_INPUT,\n  aiSiteInspirationInput,\n  aiSiteInspirationLimit,\n  aiSiteInspirationRefusal,\n  aiSiteInspirationUrl,\n} from './ai-site-inspiration'\nimport {\n  AI_SITE_INPUT_MAX_CHARS,\n  AI_SITE_SUBMISSIONS,\n  aiSitePagesBand,\n  type AiSiteJobInputs,\n  type AiSiteSubmissions,\n} from './ai-site-job'\n\n/**\n * The guided start (AGL-2918): the questions a person answers on a site they\n * have just made, and the site job those answers become.\n *\n * A scaffold already exists — the `site` job plans four to eight pages, a\n * layout, a contact form, a palette and a welcome email, and builds every one\n * of them as a draft. What it had no way in through was a brief: somebody had\n * to know what to write, on a site where nothing has happened yet. So this\n * module is the QUESTIONS, and nothing else: what is asked, what an answer may\n * be, and how a set of answers becomes the brief and the scalar inputs the\n * `site` door already takes.\n *\n * ── Answering is never the way out ───────────────────────────────────────\n *\n * There is no answer here that means \"not this\". The way past the questions\n * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them\n * from the first one and creates nothing at all — see the zone in\n * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make\n * leaving a thing you answer your way to, and it is not.\n *\n * ── Every answer but the first is optional ───────────────────────────────\n *\n * Only what a site is FOR has no default worth guessing. The audience narrows\n * the copy, the example steers the shape, the page count and the welcome\n * email are defaults a person may change — so a person who types six words\n * and confirms gets a planned site, and the rest of the questions are there\n * for the person who wants to answer them.\n *\n * Pure: shapes, vocabularies and two string builders. No React, no network,\n * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names\n * the starters rather than reading them, so the console does not carry a\n * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the\n * two lists to each other.\n */\n\n/** A worked example a person picks to steer what the site should look like. */\nexport interface AiSiteStartExample {\n  /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */\n  id: string\n  /** The starter as its card names it. */\n  label: string\n  /** The starter's category, which is how the examples group. */\n  category: string\n  /** What the example is, in one line a person reads before picking it. */\n  blurb: string\n}\n\n/**\n * The examples the start offers, in the order they are shown. The platform's\n * own starter sites: a person who has no words for what they want has seen\n * these five shapes before, and picking one says more than a sentence would.\n */\nexport const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[] = [\n  {\n    id: 'business',\n    label: 'Business',\n    category: 'Business',\n    blurb: 'A home page led by what you do, an about page and a contact page',\n  },\n  {\n    id: 'landing',\n    label: 'Landing Page',\n    category: 'Marketing',\n    blurb: 'One page that leads to one action, with the reasons to take it',\n  },\n  {\n    id: 'portfolio',\n    label: 'Portfolio',\n    category: 'Personal',\n    blurb: 'An introduction, a grid of work and a way to get in touch',\n  },\n  {\n    id: 'physical-shop',\n    label: 'Shop (physical products)',\n    category: 'Commerce',\n    blurb: 'Featured products, a shop to browse, and a cart',\n  },\n  {\n    id: 'digital-shop',\n    label: 'Shop (digital products)',\n    category: 'Commerce',\n    blurb: 'Downloads up front, a shop to browse, and a cart',\n  },\n]\n\n/**\n * Kinds of site offered beside the first question's box, so answering it can\n * be a tap. They fill the box rather than replacing it: what somebody is\n * building is theirs to say, and a list of eight is a list somebody is not on.\n */\nexport const AI_SITE_START_TYPES: readonly string[] = [\n  'a local service business',\n  'a restaurant or cafe',\n  'a professional practice',\n  'a trades business',\n  'a shop',\n  'a nonprofit',\n  'a personal portfolio',\n  'an event',\n]\n\n/**\n * What a person answered; the shape the card holds and the brief is built from.\n *\n * Beside the answers each step asks, the business details its \"More details\"\n * offers (AGL-3979, `AiSiteDetails`): every one optional and `''` until given,\n * the phone number and email on the Details step itself.\n */\nexport interface AiSiteStartAnswers extends AiSiteDetails {\n  /** What kind of site this is. The one answer with no default. */\n  siteType: string\n  /** Who the site is for; empty when they did not say. */\n  audience: string\n  /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */\n  example: string | null\n  /**\n   * The kind of site they picked (AGL-3660), by its `AI_SITE_KINDS` id;\n   * `null` until they pick one, when the kind their first answer suggests is\n   * the one used ({@link aiSiteStartKind}).\n   */\n  kind: string | null\n  /** How many pages to plan. */\n  pages: number\n  /** Where the contact form's submissions go. */\n  submissions: AiSiteSubmissions\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n  /** The city or town the business is in (AGL-3979); empty when they did not say. */\n  city: string\n  /** The brand color, as a six-digit hex (AGL-3979); empty for the style's own. */\n  brand: string\n  /**\n   * The sites they like (AGL-3975), as typed, one a field; absent or empty\n   * for none. Asked only while `release_ai_site_inspiration` is on.\n   */\n  inspiration?: string[]\n}\n\n/**\n * What the questions start on. Five pages because it is the middle of the\n * band the scaffold builds, a welcome email because the scaffold drafts one\n * unless it is told not to, and the Inbox because it is what every submission\n * does anyway — filing a lead as well is the addition, and an addition is the\n * thing a person should have to choose.\n */\nexport const AI_SITE_START_ANSWERS: AiSiteStartAnswers = {\n  siteType: '',\n  audience: '',\n  example: null,\n  kind: null,\n  pages: 5,\n  submissions: 'inbox',\n  welcomeEmail: true,\n  city: '',\n  brand: '',\n  ...AI_SITE_NO_DETAILS,\n}\n\n/** The answers a person may give beyond the ones each step asks, by key (AGL-3979). */\nexport type AiSiteStartExtraKey = AiSiteDetailKey | 'city' | 'brand'\n\n/** Every extra, in the order the review lists them. */\nexport const AI_SITE_START_EXTRA_KEYS: readonly AiSiteStartExtraKey[] = [\n  'phone',\n  'email',\n  'tagline',\n  'founded',\n  'serviceArea',\n  'priceRange',\n  'languages',\n  'brand',\n  'street',\n  'city',\n  'region',\n  'postalCode',\n  'country',\n  'hours',\n  'social',\n]\n\n/** What is wrong with one extra, worded for beside its field; `null` when it may be used. */\nexport function aiSiteStartExtraProblem(\n  key: AiSiteStartExtraKey,\n  value: string,\n): { code: 'too_long' | 'invalid'; message: string } | null {\n  if (key === 'city' || key === 'brand') {\n    return value.trim().length > AI_SITE_INPUT_MAX_CHARS\n      ? { code: 'too_long', message: `Keep this under ${AI_SITE_INPUT_MAX_CHARS} characters.` }\n      : null\n  }\n  return aiSiteDetailProblem(key, value)\n}\n\n/** The extras a person gave, in the review's order: what \"More details\" was used for. */\nexport function aiSiteStartExtrasGiven(answers: AiSiteStartAnswers): AiSiteStartExtraKey[] {\n  return AI_SITE_START_EXTRA_KEYS.filter((key) => (answers[key] ?? '').trim() !== '')\n}\n\n/** The kind of site the answers pick, else the one what the site is and who it is for suggest. */\nexport function aiSiteStartKind(\n  answers: Pick<AiSiteStartAnswers, 'kind' | 'siteType'> & Partial<Pick<AiSiteStartAnswers, 'audience'>>,\n): AiSiteKind {\n  return aiSiteKind(answers.kind) ?? aiSiteKindFor(answers.siteType, answers.audience ?? '')\n}\n\n/** The example an answer names, or `null` when it names none this list knows. */\nexport function aiSiteStartExample(\n  answers: AiSiteStartAnswers,\n): AiSiteStartExample | null {\n  if (!answers.example) return null\n  return AI_SITE_START_EXAMPLES.find((entry) => entry.id === answers.example) ?? null\n}\n\n/**\n * Why these answers cannot start a site, in a sentence a person reads; `null`\n * when they can. The door's own parser is what actually admits the job — this\n * is what the card says before it asks for one.\n */\nexport function aiSiteStartRefusal(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\n  const siteType = answers.siteType.trim()\n  if (!siteType) return 'Say what kind of site this is.'\n  if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.max} pages.`\n  }\n  if (answers.example !== null && !aiSiteStartExample(answers)) {\n    return 'Pick one of the examples, or none of them.'\n  }\n  if (!(AI_SITE_SUBMISSIONS as readonly string[]).includes(answers.submissions)) {\n    return 'Say where the contact form’s submissions go.'\n  }\n  for (const key of AI_SITE_START_EXTRA_KEYS) {\n    const problem = aiSiteStartExtraProblem(key, answers[key] ?? '')\n    if (problem) return problem.message\n  }\n  return aiSiteStartInspirationRefusal(answers, options)\n}\n\n/** The sites they typed, without the empty fields. */\nexport function aiSiteStartInspirationTyped(answers: Pick<AiSiteStartAnswers, 'inspiration'>): string[] {\n  return (answers.inspiration ?? []).map((entry) => entry.trim()).filter(Boolean)\n}\n\n/** Why the sites they like cannot go forward, as the door would refuse them; `null` when they can. */\nexport function aiSiteStartInspirationRefusal(\n  answers: Pick<AiSiteStartAnswers, 'inspiration'>,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  const typed = aiSiteStartInspirationTyped(answers)\n  if (typed.some((entry) => !aiSiteInspirationUrl(entry))) {\n    return 'Give each site you like as its https address, like https://example.com.'\n  }\n  return aiSiteInspirationRefusal(typed, options.freeTaste)\n}\n\n/**\n * The answers as the brief the `site` job is created with: the plan step reads\n * it as the person's own words, so it says what they said and asks for nothing\n * they did not.\n */\nexport function aiSiteStartBrief(answers: AiSiteStartAnswers): string {\n  const siteType = answers.siteType.trim()\n  const audience = answers.audience.trim()\n  const example = aiSiteStartExample(answers)\n  const sentences = [\n    `A ${answers.pages}-page website for ${siteType}.`,\n  ]\n  if (audience) sentences.push(`It is for ${audience}.`)\n  if (example) {\n    sentences.push(\n      `Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`,\n    )\n  }\n  // The kind they picked, or the one their answer suggests (AGL-3660).\n  sentences.push(`Make it a ${aiSiteStartKind(answers).label.toLowerCase()} site.`)\n  // The form on the page a visitor opens to get in touch, never every page's\n  // last band (AGL-3899): \"on the page that asks to be contacted\" read as\n  // the home's closing band on 16 of the 22 newest production starts.\n  sentences.push(\n    answers.pages === 1\n      ? 'Plan the page around what a visitor comes to do, with a contact form on it.'\n      : 'Plan a page for each thing a visitor comes to do, with the contact form on the page a visitor opens to get in touch.',\n  )\n  if (audience) {\n    // Said of the FORM as well as of the copy: who fills a form in is what\n    // decides which fields it asks for, and a brief that named the audience\n    // once, in a sentence about the pages, left the form to guess.\n    sentences.push(`Ask the contact form for what ${audience} would be asked for.`)\n  }\n  return sentences.join(' ')\n}\n\n/**\n * The answers as the `site` job's scalar inputs. Read by the door's\n * {@link parseAiSiteJobInputs}, and put in front of the model one per line by\n * the plan step, which is how the audience and the example reach the plan\n * without a prompt of their own.\n *\n * The per-site variables an agency batch fills — the business name, the city,\n * the brand — are left empty here: the questions never ask them. The name is\n * the site's own, and the create door fills it from the site\n * (`aiJobAdmittedInputs`, AGL-3596) when the job is started — a job that\n * reached the model with no name had the model invent one for its header and\n * footer.\n */\nexport function aiSiteStartInputs(\n  answers: AiSiteStartAnswers,\n): Omit<AiSiteJobInputs, 'batchId' | 'inspiration' | AiSiteDetailKey> & Partial<AiSiteDetails> & { inspiration?: string } {\n  const example = aiSiteStartExample(answers)\n  const kind = aiSiteStartKind(answers)\n  // The details are sent only where given (AGL-3979): the plan step lists\n  // every scalar input on a line of its own, and a start without them is\n  // asked exactly what it was asked before.\n  const details: Partial<AiSiteDetails> = {}\n  for (const key of AI_SITE_DETAIL_KEYS) {\n    const value = (answers[key] ?? '').trim()\n    if (value) details[key] = value\n  }\n  // The sites they like travel only when there are some (AGL-3975), so a\n  // start without them asks for exactly what it always did.\n  const inspiration = aiSiteInspirationInput(aiSiteStartInspirationTyped(answers))\n  return {\n    businessType: answers.siteType.trim(),\n    audience: answers.audience.trim(),\n    starter: example?.id ?? kind.starter,\n    siteKind: kind.id,\n    pages: answers.pages,\n    businessName: '',\n    city: (answers.city ?? '').trim(),\n    brand: (answers.brand ?? '').trim(),\n    submissions: answers.submissions,\n    welcomeEmail: answers.welcomeEmail,\n    ...details,\n    ...(inspiration ? { [AI_SITE_INSPIRATION_INPUT]: inspiration } : {}),\n  }\n}\n\n/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */\nexport const AI_SITE_START_INPUT_KEYS = [\n  'businessType',\n  'audience',\n  'starter',\n  'siteKind',\n  'pages',\n  'businessName',\n  'city',\n  'brand',\n  'submissions',\n  'welcomeEmail',\n  ...AI_SITE_DETAIL_KEYS,\n  AI_SITE_INSPIRATION_INPUT,\n] as const\n\n/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */\nexport function aiSiteStartInputsOf(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): Record<string, unknown> | null {\n  if (!inputs) return null\n  const kept: Record<string, unknown> = {}\n  for (const key of AI_SITE_START_INPUT_KEYS) {\n    const value = inputs[key]\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value\n  }\n  return Object.keys(kept).length ? kept : null\n}\n\n/**\n * A failed start's answers, back as the questions hold them (AGL-3596), so\n * Try again reopens the guided start filled in for the person to adjust:\n * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the\n * questions no longer offer goes back to its default — and held to the\n * workspace's page band. `null` when the inputs say no kind of site at all.\n */\nexport function aiSiteStartAnswersFromInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { freeTaste?: boolean } = {},\n): AiSiteStartAnswers | null {\n  const text = (key: string) => (typeof inputs?.[key] === 'string' ? (inputs[key] as string).trim() : '')\n  const siteType = text('businessType')\n  if (!siteType) return null\n  const band = aiSitePagesBand(options.freeTaste)\n  const pages = typeof inputs?.['pages'] === 'number' ? Math.round(inputs['pages'] as number) : AI_SITE_START_ANSWERS.pages\n  const starter = text('starter')\n  const submissions = text('submissions')\n  return {\n    siteType,\n    audience: text('audience'),\n    example: AI_SITE_START_EXAMPLES.some((entry) => entry.id === starter) ? starter : null,\n    kind: aiSiteKind(text('siteKind'))?.id ?? null,\n    pages: Math.min(band.max, Math.max(band.min, pages)),\n    submissions: (AI_SITE_SUBMISSIONS as readonly string[]).includes(submissions)\n      ? (submissions as AiSiteSubmissions)\n      : AI_SITE_START_ANSWERS.submissions,\n    welcomeEmail: options.freeTaste ? false : inputs?.['welcomeEmail'] !== false,\n    city: text('city'),\n    brand: text('brand'),\n    ...(Object.fromEntries(AI_SITE_DETAIL_KEYS.map((key) => [key, text(key)])) as unknown as AiSiteDetails),\n    // The sites they liked come back as typed, within the workspace's limit (AGL-3975).\n    ...(text(AI_SITE_INSPIRATION_INPUT)\n      ? { inspiration: text(AI_SITE_INSPIRATION_INPUT).split(/\\s+/).filter(Boolean).slice(0, aiSiteInspirationLimit(options.freeTaste)) }\n      : {}),\n  }\n}\n\n// ── A build staff run for a client (AGL-3958) ───────────────────────────────\n\n/** Shortens an answer to what a scalar input admits, on a word where it can. */\nfunction bounded(value: string, max: number): string {\n  const trimmed = value.trim().replace(/\\s+/g, ' ')\n  if (trimmed.length <= max) return trimmed\n  const cut = trimmed.slice(0, max)\n  const space = cut.lastIndexOf(' ')\n  return (space > max / 2 ? cut.slice(0, space) : cut).trim()\n}\n\n/** A time with am or pm: \"9am\", \"5:30 pm\", \"12 a.m.\". */\nconst TWELVE_HOUR_TIME = /\\b(\\d{1,2})(?::(\\d{2}))?\\s*([ap])\\.?m\\.?(?![a-z])/gi\n\n/**\n * The hours an owner gave, in the shape the Details step's hours picker\n * writes (`Tu-Sa 09:00-17:00`, one set of days a line), so the plan reads\n * them as it reads hours picked there. A time with am or pm is the time it\n * names, \"to\" joins a range as a dash does, and days with their hours may be\n * set apart by a comma, a semicolon or a line. Whatever still does not read\n * as hours — \"8–5\", \"Sat by appointment\" — is left out rather than guessed at.\n */\nfunction clientBuildHours(hours: string): string {\n  const lines = hours\n    .replace(TWELVE_HOUR_TIME, (time, hour: string, minutes: string | undefined, half: string) => {\n      const h = Number(hour)\n      if (h < 1 || h > 12) return time\n      const clock = (h % 12) + (half.toLowerCase() === 'p' ? 12 : 0)\n      return `${String(clock).padStart(2, '0')}:${minutes ?? '00'}`\n    })\n    .replace(/\\s+to\\s+/gi, '-')\n    .replace(/(\\d{1,2}:\\d{2})\\s*,\\s*/g, '$1\\n')\n    .replace(/;/g, '\\n')\n  const week = weeklyHoursFromText(lines).hours\n  return week.some((day) => day.length) ? weeklyHoursToText(week) : ''\n}\n\n/**\n * The towns an intake serves, one a line, as the Details step's \"Areas you\n * serve\" holds them: \"Austin, Round Rock and Pflugerville\" is three.\n */\nfunction clientBuildServiceArea(towns: string): string {\n  return towns\n    .split(/\\r?\\n|[,;]|\\s+(?:and|&)\\s+/i)\n    .map((town) => town.trim())\n    .filter(Boolean)\n    .join('\\n')\n}\n\n/**\n * The questions' answers for a site staff are building for a client: what\n * the business does is the kind of site, and the details the intake holds\n * fill the Details step's own fields (AGL-3979, AGL-3995): the phone, the\n * email, the towns as the areas it serves and the hours, each held to that\n * detail's own rule, so one the Details step would refuse is left empty\n * there. Every other answer keeps its default, which the review shows to\n * change. The intake, a refused detail included, also reaches the job\n * through {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.\n */\nexport function aiSiteStartAnswersFromClientBuild(intake: ClientBuildIntake): AiSiteStartAnswers {\n  const details = aiSiteDetailsOf({\n    phone: intake.phone,\n    email: intake.email,\n    serviceArea: clientBuildServiceArea(intake.towns),\n    hours: clientBuildHours(intake.hours),\n  })\n  return {\n    ...AI_SITE_START_ANSWERS,\n    siteType: bounded(intake.whatTheyDo, AI_SITE_INPUT_MAX_CHARS),\n    phone: details.phone,\n    email: details.email,\n    serviceArea: details.serviceArea,\n    hours: details.hours,\n  }\n}\n\n/**\n * The per-site inputs the intake fills, which the guided start's own\n * questions leave empty: the business's name for the header and footer, and\n * the towns it serves as its place.\n *\n * The towns are the place only while no address is given. The Entity reads\n * `city` as the address's own locality wherever there is a street or a\n * postal code (`aiSiteEntity`), so once the answers carry either, `city` is\n * the city the Details step was given with that address, never the towns\n * (AGL-3995). The intake asks no address, so today that is the Details step's\n * own, typed on the review; the towns still reach the site as the areas it\n * serves.\n */\nexport function aiSiteStartClientInputs(\n  intake: ClientBuildIntake,\n  answers?: Pick<AiSiteStartAnswers, 'street' | 'postalCode' | 'city'> | null,\n): Pick<AiSiteJobInputs, 'businessName' | 'city'> {\n  const addressed = Boolean(answers?.street.trim() || answers?.postalCode.trim())\n  return {\n    businessName: bounded(intake.businessName, AI_SITE_INPUT_MAX_CHARS),\n    city: bounded(addressed ? (answers?.city ?? '') : intake.towns, AI_SITE_INPUT_MAX_CHARS),\n  }\n}\n\n/**\n * The intake as sentences added to the brief: how to reach the business and\n * when it is open, which the site should say where a visitor looks for them,\n * and the owner's own words, quoted, which the copy should sound like. Empty\n * answers say nothing.\n */\nexport function aiSiteStartClientBrief(intake: ClientBuildIntake): string {\n  const name = intake.businessName.trim()\n  const towns = intake.towns.trim()\n  const phone = intake.phone.trim()\n  const email = intake.email.trim()\n  const hours = intake.hours.trim()\n  const words = intake.ownerWords.trim().replace(/\\s+/g, ' ')\n  const sentences: string[] = []\n  if (name) sentences.push(`The business is called ${name}.`)\n  if (towns) sentences.push(`It serves ${towns}.`)\n  const contact = [phone ? `call ${phone}` : '', email ? `email ${email}` : ''].filter(Boolean)\n  if (contact.length) {\n    sentences.push(`Visitors reach it to ${contact.join(' or ')}; say so wherever the site tells them how to get in touch.`)\n  }\n  if (hours) sentences.push(`Its hours are ${hours}.`)\n  if (words) sentences.push(`In the owner's own words: \"${words}\" Write the copy so it sounds like them.`)\n  return sentences.join(' ')\n}\n\n/**\n * What the review says the client build adds beyond its own rows, so staff\n * see the intake is used without it being asked again: the business's name\n * and the owner's own words, which no row shows. The phone, email, towns and\n * hours are the review's Details rows already (AGL-3995), so the note does\n * not say them twice: \"Also from the client's details: Harbor Plumbing and\n * the owner's own words.\"\n */\nexport function aiSiteStartClientNote(intake: ClientBuildIntake): string {\n  const parts = [intake.businessName.trim(), intake.ownerWords.trim() ? \"the owner's own words\" : ''].filter(Boolean)\n  if (!parts.length) return 'Built from the client’s details.'\n  return `Also from the client’s details: ${parts.join(' and ')}.`\n}\n"],"names":["weeklyHoursFromText","weeklyHoursToText","AI_SITE_DETAIL_KEYS","AI_SITE_NO_DETAILS","aiSiteDetailProblem","aiSiteDetailsOf","aiSiteKind","aiSiteKindFor","AI_SITE_INSPIRATION_INPUT","aiSiteInspirationInput","aiSiteInspirationLimit","aiSiteInspirationRefusal","aiSiteInspirationUrl","AI_SITE_INPUT_MAX_CHARS","AI_SITE_SUBMISSIONS","aiSitePagesBand","AI_SITE_START_EXAMPLES","id","label","category","blurb","AI_SITE_START_TYPES","AI_SITE_START_ANSWERS","siteType","audience","example","kind","pages","submissions","welcomeEmail","city","brand","AI_SITE_START_EXTRA_KEYS","aiSiteStartExtraProblem","key","value","trim","length","code","message","aiSiteStartExtrasGiven","answers","filter","aiSiteStartKind","aiSiteStartExample","find","entry","aiSiteStartRefusal","options","band","freeTaste","Number","isInteger","min","max","includes","problem","aiSiteStartInspirationRefusal","aiSiteStartInspirationTyped","inspiration","map","Boolean","typed","some","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","details","businessType","starter","siteKind","businessName","AI_SITE_START_INPUT_KEYS","aiSiteStartInputsOf","inputs","kept","Object","keys","aiSiteStartAnswersFromInputs","text","Math","round","fromEntries","split","slice","bounded","trimmed","replace","cut","space","lastIndexOf","TWELVE_HOUR_TIME","clientBuildHours","hours","lines","time","hour","minutes","half","h","clock","String","padStart","week","day","clientBuildServiceArea","towns","town","aiSiteStartAnswersFromClientBuild","intake","phone","email","serviceArea","whatTheyDo","aiSiteStartClientInputs","addressed","street","postalCode","aiSiteStartClientBrief","name","words","ownerWords","contact","aiSiteStartClientNote","parts"],"mappings":"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"}

package/src/lib/model/ai-upsell-copy.js

@@ -78,8 +78,11 @@
  * The sentence that says where the feature comes from, and who can add it.
  * `feature` is what the entry is called: "Create with AI" unless it is an ask.
  */ export function aiUpsellOffer(canManageBilling, feature = AI_UPSELL_CREATE_LABEL) {
+    // Since AGL-3965 every paid plan's own credits pay for generation, so this
+    // door is reached only where it is switched off for the workspace and an
+    // Aglyn AI tier (which switches it on with its credits) is for sale.
     const addon = aiAddonName();
-    return canManageBilling ? `${feature} comes with the ${addon} add-on, which you can add to this ` + 'workspace from Billing.' : `${feature} comes with the ${addon} add-on. Ask a workspace owner or admin ` + 'to add it from Billing.';
+    return canManageBilling ? `${feature} is switched off for this workspace. It comes with an ${addon} ` + 'tier, which you can choose in Billing.' : `${feature} is switched off for this workspace. It comes with an ${addon} ` + 'tier. Ask a workspace owner or admin to choose one in Billing.';
 }
 
 //# sourceMappingURL=ai-upsell-copy.js.map

package/src/lib/model/ai-upsell-copy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-upsell-copy.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 { aiAddonName } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport type { AiBriefKind } from './ai-brief-copy'\n\n/**\n * What a \"Create with AI\" or \"Ask AI\" entry makes: the brief kinds, an\n * automation, products, a function or variable, an overlay, and an answer\n * about the figures on a page.\n */\nexport type AiUpsellKind =\n  | AiBriefKind\n  | 'workflow'\n  | 'product'\n  | 'logic'\n  | 'overlay'\n  | 'funnel'\n  | 'insight'\n\n/** What one entry's dialog says. */\nexport interface AiUpsellCopy {\n  title: string\n  does: string\n  /** The entry's own label, which the button reads and the offer names; \"Create with AI\" when absent. */\n  label?: string\n}\n\n/** The label every \"Create with AI\" entry reads. */\nexport const AI_UPSELL_CREATE_LABEL = 'Create with AI'\n\n/** What the dialog says one entry would do here. */\nexport const AI_UPSELL_COPY: Readonly<Record<AiUpsellKind, AiUpsellCopy>> = {\n  page: {\n    title: 'Create a page with AI',\n    does:\n      'Describe the page you need and AI plans it from your brief, using your theme and ' +\n      'what the site already has. You confirm the plan, and the page is built as an ' +\n      'unpublished draft.',\n  },\n  template: {\n    title: 'Create a page template with AI',\n    does:\n      'Describe what each page should show and AI plans the template, filling what ' +\n      'changes from page to page from each record. You confirm the plan, and the template ' +\n      'is built as a draft in your library.',\n  },\n  layout: {\n    title: 'Create a layout with AI',\n    does:\n      'Describe what the layout should hold and AI plans it, linking your pages and placing ' +\n      'your navigation or menu component when the site has one. You confirm the plan, and ' +\n      'the layout is built as a draft no page uses until you assign it.',\n  },\n  form: {\n    title: 'Create a form with AI',\n    does:\n      'Describe what the form is for and AI plans its fields, its marketing consent and ' +\n      'where each submission goes. You confirm the plan, and the form is built as a draft.',\n  },\n  component: {\n    title: 'Create a reusable component with AI',\n    does:\n      'Describe what the component should show and AI plans it, making what each page can ' +\n      'change into its properties. You confirm the plan, and the component is built as a ' +\n      'draft.',\n  },\n  workflow: {\n    title: 'Create an automation with AI',\n    does:\n      'Describe what should happen, and when, and AI drafts the automation from the ' +\n      'triggers and steps your plan includes. It is saved switched off for you to review.',\n  },\n  email: {\n    title: 'Create an email with AI',\n    does:\n      'Describe the email you need and AI plans a design from the email blocks, with three ' +\n      'subject lines and three preheaders to choose between. You confirm the plan, and the ' +\n      'design is built as a draft that is sent to nobody.',\n  },\n  campaign: {\n    title: 'Create a campaign with AI',\n    does:\n      'Describe what the campaign is for and AI writes its email design and a draft campaign ' +\n      'that would send it. Nothing is sent or scheduled, and the campaign is aimed at nobody ' +\n      'until you pick its lists.',\n  },\n  product: {\n    title: 'Create products with AI',\n    does:\n      'Describe what the store sells and AI proposes up to twelve products. You review them ' +\n      'before any is created, and each is created as a draft at a suggested price that is not on ' +\n      'your storefront until you review it and activate it.',\n  },\n  logic: {\n    title: 'Create a function or variable with AI',\n    does:\n      'Describe what it should work out or hold and AI drafts the function or variable. It ' +\n      'opens unsaved in the editor for you to check and save.',\n  },\n  overlay: {\n    title: 'Create an overlay with AI',\n    does:\n      'Describe the announcement bar or popup you want and AI writes its copy within the ' +\n      'overlay’s limits. It is saved switched off, for you to check and turn on.',\n  },\n  funnel: {\n    title: 'Create a funnel with AI',\n    does:\n      'Describe the journey you want to measure and AI proposes its steps from the site’s ' +\n      'real pages, forms and products. It opens in the funnel editor for you to check and save.',\n  },\n  insight: {\n    title: 'Ask AI about these numbers',\n    label: 'Ask a question',\n    does:\n      'Ask a question about the figures on this page and AI answers from them, every answer ' +\n      'traced to the figures it is built from. It reads; it changes nothing.',\n  },\n}\n\n/** The label an entry's button reads. */\nexport function aiUpsellLabel(kind: AiUpsellKind): string {\n  return AI_UPSELL_COPY[kind].label ?? AI_UPSELL_CREATE_LABEL\n}\n\n/**\n * The sentence that says where the feature comes from, and who can add it.\n * `feature` is what the entry is called: \"Create with AI\" unless it is an ask.\n */\nexport function aiUpsellOffer(canManageBilling: boolean, feature = AI_UPSELL_CREATE_LABEL): string {\n  const addon = aiAddonName()\n  return canManageBilling\n    ? `${feature} comes with the ${addon} add-on, which you can add to this ` +\n        'workspace from Billing.'\n    : `${feature} comes with the ${addon} add-on. Ask a workspace owner or admin ` +\n        'to add it from Billing.'\n}\n"],"names":["aiAddonName","AI_UPSELL_CREATE_LABEL","AI_UPSELL_COPY","page","title","does","template","layout","form","component","workflow","email","campaign","product","logic","overlay","funnel","insight","label","aiUpsellLabel","kind","aiUpsellOffer","canManageBilling","feature","addon"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,WAAW,QAAQ,2CAA0C;AAyBtE,kDAAkD,GAClD,OAAO,MAAMC,yBAAyB,iBAAgB;AAEtD,kDAAkD,GAClD,OAAO,MAAMC,iBAA+D;IAC1EC,MAAM;QACJC,OAAO;QACPC,MACE,sFACA,kFACA;IACJ;IACAC,UAAU;QACRF,OAAO;QACPC,MACE,iFACA,wFACA;IACJ;IACAE,QAAQ;QACNH,OAAO;QACPC,MACE,0FACA,wFACA;IACJ;IACAG,MAAM;QACJJ,OAAO;QACPC,MACE,sFACA;IACJ;IACAI,WAAW;QACTL,OAAO;QACPC,MACE,wFACA,uFACA;IACJ;IACAK,UAAU;QACRN,OAAO;QACPC,MACE,kFACA;IACJ;IACAM,OAAO;QACLP,OAAO;QACPC,MACE,yFACA,yFACA;IACJ;IACAO,UAAU;QACRR,OAAO;QACPC,MACE,2FACA,2FACA;IACJ;IACAQ,SAAS;QACPT,OAAO;QACPC,MACE,0FACA,+FACA;IACJ;IACAS,OAAO;QACLV,OAAO;QACPC,MACE,yFACA;IACJ;IACAU,SAAS;QACPX,OAAO;QACPC,MACE,uFACA;IACJ;IACAW,QAAQ;QACNZ,OAAO;QACPC,MACE,wFACA;IACJ;IACAY,SAAS;QACPb,OAAO;QACPc,OAAO;QACPb,MACE,0FACA;IACJ;AACF,EAAC;AAED,uCAAuC,GACvC,OAAO,SAASc,cAAcC,IAAkB;QACvClB;IAAP,QAAOA,6BAAAA,cAAc,CAACkB,KAAK,CAACF,KAAK,YAA1BhB,6BAA8BD;AACvC;AAEA;;;CAGC,GACD,OAAO,SAASoB,cAAcC,gBAAyB,EAAEC,UAAUtB,sBAAsB;IACvF,MAAMuB,QAAQxB;IACd,OAAOsB,mBACH,GAAGC,QAAQ,gBAAgB,EAAEC,MAAM,mCAAmC,CAAC,GACrE,4BACF,GAAGD,QAAQ,gBAAgB,EAAEC,MAAM,wCAAwC,CAAC,GAC1E;AACR"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-upsell-copy.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 { aiAddonName } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport type { AiBriefKind } from './ai-brief-copy'\n\n/**\n * What a \"Create with AI\" or \"Ask AI\" entry makes: the brief kinds, an\n * automation, products, a function or variable, an overlay, and an answer\n * about the figures on a page.\n */\nexport type AiUpsellKind =\n  | AiBriefKind\n  | 'workflow'\n  | 'product'\n  | 'logic'\n  | 'overlay'\n  | 'funnel'\n  | 'insight'\n\n/** What one entry's dialog says. */\nexport interface AiUpsellCopy {\n  title: string\n  does: string\n  /** The entry's own label, which the button reads and the offer names; \"Create with AI\" when absent. */\n  label?: string\n}\n\n/** The label every \"Create with AI\" entry reads. */\nexport const AI_UPSELL_CREATE_LABEL = 'Create with AI'\n\n/** What the dialog says one entry would do here. */\nexport const AI_UPSELL_COPY: Readonly<Record<AiUpsellKind, AiUpsellCopy>> = {\n  page: {\n    title: 'Create a page with AI',\n    does:\n      'Describe the page you need and AI plans it from your brief, using your theme and ' +\n      'what the site already has. You confirm the plan, and the page is built as an ' +\n      'unpublished draft.',\n  },\n  template: {\n    title: 'Create a page template with AI',\n    does:\n      'Describe what each page should show and AI plans the template, filling what ' +\n      'changes from page to page from each record. You confirm the plan, and the template ' +\n      'is built as a draft in your library.',\n  },\n  layout: {\n    title: 'Create a layout with AI',\n    does:\n      'Describe what the layout should hold and AI plans it, linking your pages and placing ' +\n      'your navigation or menu component when the site has one. You confirm the plan, and ' +\n      'the layout is built as a draft no page uses until you assign it.',\n  },\n  form: {\n    title: 'Create a form with AI',\n    does:\n      'Describe what the form is for and AI plans its fields, its marketing consent and ' +\n      'where each submission goes. You confirm the plan, and the form is built as a draft.',\n  },\n  component: {\n    title: 'Create a reusable component with AI',\n    does:\n      'Describe what the component should show and AI plans it, making what each page can ' +\n      'change into its properties. You confirm the plan, and the component is built as a ' +\n      'draft.',\n  },\n  workflow: {\n    title: 'Create an automation with AI',\n    does:\n      'Describe what should happen, and when, and AI drafts the automation from the ' +\n      'triggers and steps your plan includes. It is saved switched off for you to review.',\n  },\n  email: {\n    title: 'Create an email with AI',\n    does:\n      'Describe the email you need and AI plans a design from the email blocks, with three ' +\n      'subject lines and three preheaders to choose between. You confirm the plan, and the ' +\n      'design is built as a draft that is sent to nobody.',\n  },\n  campaign: {\n    title: 'Create a campaign with AI',\n    does:\n      'Describe what the campaign is for and AI writes its email design and a draft campaign ' +\n      'that would send it. Nothing is sent or scheduled, and the campaign is aimed at nobody ' +\n      'until you pick its lists.',\n  },\n  product: {\n    title: 'Create products with AI',\n    does:\n      'Describe what the store sells and AI proposes up to twelve products. You review them ' +\n      'before any is created, and each is created as a draft at a suggested price that is not on ' +\n      'your storefront until you review it and activate it.',\n  },\n  logic: {\n    title: 'Create a function or variable with AI',\n    does:\n      'Describe what it should work out or hold and AI drafts the function or variable. It ' +\n      'opens unsaved in the editor for you to check and save.',\n  },\n  overlay: {\n    title: 'Create an overlay with AI',\n    does:\n      'Describe the announcement bar or popup you want and AI writes its copy within the ' +\n      'overlay’s limits. It is saved switched off, for you to check and turn on.',\n  },\n  funnel: {\n    title: 'Create a funnel with AI',\n    does:\n      'Describe the journey you want to measure and AI proposes its steps from the site’s ' +\n      'real pages, forms and products. It opens in the funnel editor for you to check and save.',\n  },\n  insight: {\n    title: 'Ask AI about these numbers',\n    label: 'Ask a question',\n    does:\n      'Ask a question about the figures on this page and AI answers from them, every answer ' +\n      'traced to the figures it is built from. It reads; it changes nothing.',\n  },\n}\n\n/** The label an entry's button reads. */\nexport function aiUpsellLabel(kind: AiUpsellKind): string {\n  return AI_UPSELL_COPY[kind].label ?? AI_UPSELL_CREATE_LABEL\n}\n\n/**\n * The sentence that says where the feature comes from, and who can add it.\n * `feature` is what the entry is called: \"Create with AI\" unless it is an ask.\n */\nexport function aiUpsellOffer(canManageBilling: boolean, feature = AI_UPSELL_CREATE_LABEL): string {\n  // Since AGL-3965 every paid plan's own credits pay for generation, so this\n  // door is reached only where it is switched off for the workspace and an\n  // Aglyn AI tier (which switches it on with its credits) is for sale.\n  const addon = aiAddonName()\n  return canManageBilling\n    ? `${feature} is switched off for this workspace. It comes with an ${addon} ` +\n        'tier, which you can choose in Billing.'\n    : `${feature} is switched off for this workspace. It comes with an ${addon} ` +\n        'tier. Ask a workspace owner or admin to choose one in Billing.'\n}\n"],"names":["aiAddonName","AI_UPSELL_CREATE_LABEL","AI_UPSELL_COPY","page","title","does","template","layout","form","component","workflow","email","campaign","product","logic","overlay","funnel","insight","label","aiUpsellLabel","kind","aiUpsellOffer","canManageBilling","feature","addon"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,WAAW,QAAQ,2CAA0C;AAyBtE,kDAAkD,GAClD,OAAO,MAAMC,yBAAyB,iBAAgB;AAEtD,kDAAkD,GAClD,OAAO,MAAMC,iBAA+D;IAC1EC,MAAM;QACJC,OAAO;QACPC,MACE,sFACA,kFACA;IACJ;IACAC,UAAU;QACRF,OAAO;QACPC,MACE,iFACA,wFACA;IACJ;IACAE,QAAQ;QACNH,OAAO;QACPC,MACE,0FACA,wFACA;IACJ;IACAG,MAAM;QACJJ,OAAO;QACPC,MACE,sFACA;IACJ;IACAI,WAAW;QACTL,OAAO;QACPC,MACE,wFACA,uFACA;IACJ;IACAK,UAAU;QACRN,OAAO;QACPC,MACE,kFACA;IACJ;IACAM,OAAO;QACLP,OAAO;QACPC,MACE,yFACA,yFACA;IACJ;IACAO,UAAU;QACRR,OAAO;QACPC,MACE,2FACA,2FACA;IACJ;IACAQ,SAAS;QACPT,OAAO;QACPC,MACE,0FACA,+FACA;IACJ;IACAS,OAAO;QACLV,OAAO;QACPC,MACE,yFACA;IACJ;IACAU,SAAS;QACPX,OAAO;QACPC,MACE,uFACA;IACJ;IACAW,QAAQ;QACNZ,OAAO;QACPC,MACE,wFACA;IACJ;IACAY,SAAS;QACPb,OAAO;QACPc,OAAO;QACPb,MACE,0FACA;IACJ;AACF,EAAC;AAED,uCAAuC,GACvC,OAAO,SAASc,cAAcC,IAAkB;QACvClB;IAAP,QAAOA,6BAAAA,cAAc,CAACkB,KAAK,CAACF,KAAK,YAA1BhB,6BAA8BD;AACvC;AAEA;;;CAGC,GACD,OAAO,SAASoB,cAAcC,gBAAyB,EAAEC,UAAUtB,sBAAsB;IACvF,2EAA2E;IAC3E,yEAAyE;IACzE,qEAAqE;IACrE,MAAMuB,QAAQxB;IACd,OAAOsB,mBACH,GAAGC,QAAQ,sDAAsD,EAAEC,MAAM,CAAC,CAAC,GACzE,2CACF,GAAGD,QAAQ,sDAAsD,EAAEC,MAAM,CAAC,CAAC,GACzE;AACR"}

package/src/lib/plan-entitlements.d.ts

@@ -61,9 +61,10 @@ declare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {
          * `tier-margin-floor.spec.ts` is the model, and it pins both the rule and
          * the resulting figures.
          *
-         * The Aglyn AI add-on (AGL-2896) adds `AI_ADDON_CREDITS_PER_MONTH[plan]`
-         * to this band in `resolveOrgEntitlements` — one pool, widened, rather
-         * than a second meter.
+         * ONE POOL FOR EVERYTHING (AGL-3965): this band pays for every Aglyn AI
+         * action, generation included, on every plan. An Aglyn AI tier adds its
+         * credits (`AI_TIERS[tier].credits`) to it in `resolveOrgEntitlements`
+         * — one pool, widened, rather than a second meter.
          */
         assistCreditsPerMonth?: number;
     }

package/src/lib/plan-entitlements.js

@@ -124,18 +124,13 @@
     // plan bands at zero any more" was true of the number and false of the
     // capability.
     //
-    // It opens `aiAssist` rather than `aiGenerative` because that is the shape
-    // of every paid rung above it — the included band funds the guided
-    // assistant and generation is the add-on. Opening the generative door here
-    // instead would hand the FIRST paid rung a door Pro through Agency have to
-    // buy.
+    // Since AGL-3965 it opens `aiGenerative` too, as every paid rung does: the
+    // included band pays for generation and assist alike (one pool), and an
+    // Aglyn AI tier adds credits on top rather than opening a door.
     //
     // No cost moves: `tier-margin-floor.spec.ts` already prices this tier's
     // assist term at 100% burn of the 750 credits, 75¢/mo. A door does not
     // widen a band; it only makes spend that was already modeled reachable.
-    //
-    // The AI add-on adds `AI_ADDON_CREDITS_PER_MONTH.starter` on top and
-    // switches `aiGenerative` on as well.
     starter: 750,
     // $2.75 of provider spend, against the $8.35 the tier's other seven cost
     // terms leave out of $56. See the key's docblock for why the remainder and

package/src/lib/plan-entitlements.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plan-entitlements.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\n// Types only: the manifest generator loads this module on its own to compile\n// the plan figures, before the catalog file core reads them from exists in\n// its new shape, so nothing here may reach a core module at runtime.\nimport type { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements'\n\n/**\n * THE AI PLUGIN'S PLAN BAND (AGL-3080): how many AI credits each plan\n * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest\n * generator (`register.planEntitlements`), so `/pricing`, the plan comparison\n * and every gate read the same figure they always have; this is where it is\n * written, beside the reasoning that sized it.\n */\ndeclare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {\n  interface PluginEntitlementQuotas {\n    /**\n     * AI credits per calendar month — the band assist spends against.\n     *\n     * A CREDIT IS A UNIT OF MODEL COST, not a message. One assist action can\n     * cost two orders of magnitude more than another: a question is a few\n     * thousand tokens, while generating a screen carries the node tree, the\n     * component catalog and the theme tokens in, structured markup out, and\n     * iterates. A message allowance would price those the same, so one\n     * workspace's ten screen builds would outspend another's thousand\n     * questions and both would read as \"within allowance\".\n     *\n     * The unit is defined by `ASSIST_CREDIT_COST_USD` and the conversion\n     * lives in `assist-credits.ts`. Only that module turns credits into\n     * dollars; everything a customer sees counts credits, because the dollar\n     * figure behind them is our provider bill and not a price.\n     *\n     * ## HOW THE BAND IS SIZED, and why it is not a share of the price\n     *\n     * A credit is a dollar of provider spend at `ASSIST_CREDIT_COST_USD`, so\n     * the band IS a liability figure: the plan's whole assist give is\n     * `assistCreditsPerMonth / 1000` dollars. Credits past it are not a give\n     * — since AGL-2653 they are SOLD at `extraAssistCreditsUsdPer1k`, unless\n     * the org's `assistOverage.hardCap` asks `reserveAssistMessage` to refuse\n     * at the band instead. Sizing it as a share of the subscription price\n     * says nothing about whether the tier can afford it, because the price is\n     * also carrying storage, bandwidth, form submissions, dataset storage,\n     * API requests, contacts and email.\n     *\n     * So each band is sized against what those SEVEN other terms leave.\n     * Every paid band takes between a quarter and a third of that remainder,\n     * which keeps the tier's worst case positive and keeps the ladder's\n     * shape: the margin each tier holds at 100% of every band stays in\n     * proportion to what it held before assist was sold at all.\n     * `tier-margin-floor.spec.ts` is the model, and it pins both the rule and\n     * the resulting figures.\n     *\n     * The Aglyn AI add-on (AGL-2896) adds `AI_ADDON_CREDITS_PER_MONTH[plan]`\n     * to this band in `resolveOrgEntitlements` — one pool, widened, rather\n     * than a second meter.\n     */\n    assistCreditsPerMonth?: number\n  }\n}\n\n/**\n * AI credits an Enterprise agreement includes per month, before the contract\n * says otherwise.\n *\n * ## Never `UNLIMITED`, and the reason is not stylistic\n *\n * `UNLIMITED` is `Number.POSITIVE_INFINITY`, `JSON.stringify(Infinity)` is\n * `null`, and `Number(null)` is `0`. An unbounded assist band therefore\n * serialises to a band of ZERO through every route that does not also send\n * the explicit flag `restoreQuotaLimit` rebuilds from — which would hand the\n * only customers with a signed contract the one budget that refuses\n * everything. A finite number crosses the wire as itself.\n *\n * The band is also a real liability rather than a capacity we already own.\n * Storage and page views are infrastructure metered into the deal; assist is\n * a per-token charge from a third party, and generative building spends it in\n * units two orders of magnitude apart.\n *\n * ## Why this number\n *\n * Enterprise carries no list price, so the band cannot be sized the way every\n * self-serve tier's is — against what that tier's other cost terms leave out\n * of a known price. It is anchored to the top of the ladder instead: 116,000\n * credits is twice Agency's band, the rule every Enterprise fallback follows\n * since the 2026-09-07 pricing decision (see the `enterprise` row of\n * `PLAN_ENTITLEMENTS`). In cost that is $116 of provider spend a month, or\n * under 9% of any deal priced at or above the self-serve top. A deal below\n * that is sold as Agency, not written as an Enterprise agreement.\n *\n * ## It is a DEFAULT, and a contract raises it\n *\n * `resolveOrgEntitlements` applies a per-org\n * `entitlements.assistCreditsPerMonth` override ahead of this, so a deal that\n * buys more assist buys it on that org without moving the figure every other\n * agreement is measured against — the same mechanism the other contracted\n * bands use.\n */\nexport const ENTERPRISE_ASSIST_CREDITS_PER_MONTH = 116_000\n\n/**\n * The Free AI taste (AGL-2925): the credits a Free workspace draws on each\n * month, behind a hard wall.\n *\n * ## Why it exists\n *\n * So the AI landing pages can say \"generate your first page free\" and mean\n * it. Three hundred credits is one or two generated sections or a handful of\n * copy rewrites — enough to see what the assistant does, not enough to build\n * a site on. The band is a WALL: `PLAN_PRICING.free\n * .extraAssistCreditsUsdPer1k` stays `null`, so `assistBandRefuses` answers\n * true and the reservation refuses at 100% with no overage, no switch and no\n * invoice. Nothing about a Free workspace can produce a charge.\n *\n * ## What it costs, and why that is the number\n *\n * A credit is `ASSIST_CREDIT_COST_USD` of provider spend, so the band costs\n * at most **$0.30 per Free workspace per month** — asserted by\n * `apps/console/specs/tier-margin-floor.spec.ts`. It is the one AI band with\n * no invoice behind it, which is why the same issue closes every multiplier\n * a script could use before the flag flips:\n *\n *  - it is metered per ACCOUNT as well as per workspace, so the three free\n *    workspaces an account may hold (AGL-2265) share one 300-credit\n *    allowance rather than tripling it (`reserveAssistMessage`);\n *  - every free request is bounded per IP, per uid and per account per\n *    day (a minimum account age, `AI_FREE_MIN_ACCOUNT_AGE_HOURS`, is\n *    available and off by default — AGL-3591);\n *  - a platform-wide daily ceiling on free spend pauses the taste for\n *    everyone until the UTC day rolls, paid workspaces untouched.\n *\n * The account allowance reads THIS constant rather than the workspace's\n * resolved band, because a staff override that widens one workspace's band\n * is a decision about that workspace, not about how much one person may draw\n * across all of theirs.\n */\nexport const FREE_AI_TASTE_CREDITS_PER_MONTH = 300\n\n/** The AI credits each plan includes a month — see the key's own docblock. */\nexport const AI_CREDITS_BY_PLAN: Readonly<Record<OrgPlan, number>> = {\n  // The Free AI taste (AGL-2925): a real band, and a wall. See the constant\n  // for what it buys, what it costs and the precautions that keep one person\n  // from drawing it three times over.\n  free: FREE_AI_TASTE_CREDITS_PER_MONTH,\n  // The first paid rung of the assist ladder (AGL-3203). Starter banded at 0\n  // until 2026-09-20, which put a PAYING workspace below the Free taste's 300\n  // on the one axis a visitor compares straight down the column — the\n  // `/pricing` row read `300 / mo` for Free and `—` for Starter. A paid plan\n  // that includes less of something than the free plan is not a packaging\n  // subtlety; it is the comparison table arguing against the upgrade.\n  //\n  // 750 is deliberately small: 2.5x the taste, enough that the assistant is a\n  // thing the tier HAS rather than a thing it is shown, and $0.75 of provider\n  // spend a month at `ASSIST_CREDIT_COST_USD` against a $16 annual price — a\n  // twentieth of the $8.81 the tier's other metered bands already cost, and\n  // the widest margin on the ladder absorbs it with room left\n  // (`tier-margin-floor.spec.ts` carries the arithmetic).\n  //\n  // It is NOT a wall, unlike Free's: `PLAN_PRICING.starter\n  // .extraAssistCreditsUsdPer1k` is $3.00, so past 750 the tier meters and\n  // bills like every paid plan above it. The two fields move together by rule\n  // — a positive band with no rate beside it is usage past a bound that is\n  // silently free, which `plan-entitlements.spec.ts` forbids.\n  //\n  // `features.aiAssist` is TRUE, and AGL-3203 shipping it false was the\n  // defect AGL-3207 closes. The reasoning then was \"the band is credits, not\n  // the guided rung, exactly as on Free\" — but on Free the band IS spendable,\n  // through `aiGenerative`, which is the door the taste exists for. Starter\n  // carried neither flag, so it was the only row on the ladder sold a band\n  // with nothing to spend it through: 750 credits reachable only by buying\n  // the $9 add-on that was also the only thing that made them usable. \"No\n  // plan bands at zero any more\" was true of the number and false of the\n  // capability.\n  //\n  // It opens `aiAssist` rather than `aiGenerative` because that is the shape\n  // of every paid rung above it — the included band funds the guided\n  // assistant and generation is the add-on. Opening the generative door here\n  // instead would hand the FIRST paid rung a door Pro through Agency have to\n  // buy.\n  //\n  // No cost moves: `tier-margin-floor.spec.ts` already prices this tier's\n  // assist term at 100% burn of the 750 credits, 75¢/mo. A door does not\n  // widen a band; it only makes spend that was already modeled reachable.\n  //\n  // The AI add-on adds `AI_ADDON_CREDITS_PER_MONTH.starter` on top and\n  // switches `aiGenerative` on as well.\n  starter: 750,\n  // $2.75 of provider spend, against the $8.35 the tier's other seven cost\n  // terms leave out of $56. See the key's docblock for why the remainder and\n  // not the price is what sizes this.\n  pro: 2_750,\n  // $7.50, against the $22.69 the other seven terms leave out of $139.\n  business: 7_500,\n  // $10.00, against the $30.62 the other seven terms leave out of $249.\n  scale: 10_000,\n  // $13.00, against the $39.74 the other seven terms leave out of $399 — the\n  // thinnest remainder on the ladder, and the tier that binds the whole\n  // assist ladder's share of it.\n  advanced: 13_000,\n  // $58.00, against the $176.71 the other seven terms leave out of $1,299.\n  agency: 58_000,\n  enterprise: ENTERPRISE_ASSIST_CREDITS_PER_MONTH,\n}\n\n/** The AI plugin's plan figures, for the manifest generator. */\nexport function aiPlanEntitlements(): PluginPlanEntitlementsDeclaration {\n  return {\n    quotas: [\n      {\n        key: 'assistCreditsPerMonth',\n        label: 'AI credits / mo',\n        byPlan: AI_CREDITS_BY_PLAN,\n      },\n    ],\n  }\n}\n"],"names":["ENTERPRISE_ASSIST_CREDITS_PER_MONTH","FREE_AI_TASTE_CREDITS_PER_MONTH","AI_CREDITS_BY_PLAN","free","starter","pro","business","scale","advanced","agency","enterprise","aiPlanEntitlements","quotas","key","label","byPlan"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AAyDrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,MAAMA,sCAAsC,OAAO;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,MAAMC,kCAAkC,IAAG;AAElD,4EAA4E,GAC5E,OAAO,MAAMC,qBAAwD;IACnE,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpCC,MAAMF;IACN,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,wEAAwE;IACxE,oEAAoE;IACpE,EAAE;IACF,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,4DAA4D;IAC5D,wDAAwD;IACxD,EAAE;IACF,yDAAyD;IACzD,yEAAyE;IACzE,4EAA4E;IAC5E,yEAAyE;IACzE,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,cAAc;IACd,EAAE;IACF,2EAA2E;IAC3E,mEAAmE;IACnE,2EAA2E;IAC3E,2EAA2E;IAC3E,OAAO;IACP,EAAE;IACF,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxE,EAAE;IACF,qEAAqE;IACrE,sCAAsC;IACtCG,SAAS;IACT,yEAAyE;IACzE,2EAA2E;IAC3E,oCAAoC;IACpCC,KAAK;IACL,qEAAqE;IACrEC,UAAU;IACV,sEAAsE;IACtEC,OAAO;IACP,2EAA2E;IAC3E,sEAAsE;IACtE,+BAA+B;IAC/BC,UAAU;IACV,yEAAyE;IACzEC,QAAQ;IACRC,YAAYV;AACd,EAAC;AAED,8DAA8D,GAC9D,OAAO,SAASW;IACd,OAAO;QACLC,QAAQ;YACN;gBACEC,KAAK;gBACLC,OAAO;gBACPC,QAAQb;YACV;SACD;IACH;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/plan-entitlements.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\n// Types only: the manifest generator loads this module on its own to compile\n// the plan figures, before the catalog file core reads them from exists in\n// its new shape, so nothing here may reach a core module at runtime.\nimport type { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements'\n\n/**\n * THE AI PLUGIN'S PLAN BAND (AGL-3080): how many AI credits each plan\n * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest\n * generator (`register.planEntitlements`), so `/pricing`, the plan comparison\n * and every gate read the same figure they always have; this is where it is\n * written, beside the reasoning that sized it.\n */\ndeclare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {\n  interface PluginEntitlementQuotas {\n    /**\n     * AI credits per calendar month — the band assist spends against.\n     *\n     * A CREDIT IS A UNIT OF MODEL COST, not a message. One assist action can\n     * cost two orders of magnitude more than another: a question is a few\n     * thousand tokens, while generating a screen carries the node tree, the\n     * component catalog and the theme tokens in, structured markup out, and\n     * iterates. A message allowance would price those the same, so one\n     * workspace's ten screen builds would outspend another's thousand\n     * questions and both would read as \"within allowance\".\n     *\n     * The unit is defined by `ASSIST_CREDIT_COST_USD` and the conversion\n     * lives in `assist-credits.ts`. Only that module turns credits into\n     * dollars; everything a customer sees counts credits, because the dollar\n     * figure behind them is our provider bill and not a price.\n     *\n     * ## HOW THE BAND IS SIZED, and why it is not a share of the price\n     *\n     * A credit is a dollar of provider spend at `ASSIST_CREDIT_COST_USD`, so\n     * the band IS a liability figure: the plan's whole assist give is\n     * `assistCreditsPerMonth / 1000` dollars. Credits past it are not a give\n     * — since AGL-2653 they are SOLD at `extraAssistCreditsUsdPer1k`, unless\n     * the org's `assistOverage.hardCap` asks `reserveAssistMessage` to refuse\n     * at the band instead. Sizing it as a share of the subscription price\n     * says nothing about whether the tier can afford it, because the price is\n     * also carrying storage, bandwidth, form submissions, dataset storage,\n     * API requests, contacts and email.\n     *\n     * So each band is sized against what those SEVEN other terms leave.\n     * Every paid band takes between a quarter and a third of that remainder,\n     * which keeps the tier's worst case positive and keeps the ladder's\n     * shape: the margin each tier holds at 100% of every band stays in\n     * proportion to what it held before assist was sold at all.\n     * `tier-margin-floor.spec.ts` is the model, and it pins both the rule and\n     * the resulting figures.\n     *\n     * ONE POOL FOR EVERYTHING (AGL-3965): this band pays for every Aglyn AI\n     * action, generation included, on every plan. An Aglyn AI tier adds its\n     * credits (`AI_TIERS[tier].credits`) to it in `resolveOrgEntitlements`\n     * — one pool, widened, rather than a second meter.\n     */\n    assistCreditsPerMonth?: number\n  }\n}\n\n/**\n * AI credits an Enterprise agreement includes per month, before the contract\n * says otherwise.\n *\n * ## Never `UNLIMITED`, and the reason is not stylistic\n *\n * `UNLIMITED` is `Number.POSITIVE_INFINITY`, `JSON.stringify(Infinity)` is\n * `null`, and `Number(null)` is `0`. An unbounded assist band therefore\n * serialises to a band of ZERO through every route that does not also send\n * the explicit flag `restoreQuotaLimit` rebuilds from — which would hand the\n * only customers with a signed contract the one budget that refuses\n * everything. A finite number crosses the wire as itself.\n *\n * The band is also a real liability rather than a capacity we already own.\n * Storage and page views are infrastructure metered into the deal; assist is\n * a per-token charge from a third party, and generative building spends it in\n * units two orders of magnitude apart.\n *\n * ## Why this number\n *\n * Enterprise carries no list price, so the band cannot be sized the way every\n * self-serve tier's is — against what that tier's other cost terms leave out\n * of a known price. It is anchored to the top of the ladder instead: 116,000\n * credits is twice Agency's band, the rule every Enterprise fallback follows\n * since the 2026-09-07 pricing decision (see the `enterprise` row of\n * `PLAN_ENTITLEMENTS`). In cost that is $116 of provider spend a month, or\n * under 9% of any deal priced at or above the self-serve top. A deal below\n * that is sold as Agency, not written as an Enterprise agreement.\n *\n * ## It is a DEFAULT, and a contract raises it\n *\n * `resolveOrgEntitlements` applies a per-org\n * `entitlements.assistCreditsPerMonth` override ahead of this, so a deal that\n * buys more assist buys it on that org without moving the figure every other\n * agreement is measured against — the same mechanism the other contracted\n * bands use.\n */\nexport const ENTERPRISE_ASSIST_CREDITS_PER_MONTH = 116_000\n\n/**\n * The Free AI taste (AGL-2925): the credits a Free workspace draws on each\n * month, behind a hard wall.\n *\n * ## Why it exists\n *\n * So the AI landing pages can say \"generate your first page free\" and mean\n * it. Three hundred credits is one or two generated sections or a handful of\n * copy rewrites — enough to see what the assistant does, not enough to build\n * a site on. The band is a WALL: `PLAN_PRICING.free\n * .extraAssistCreditsUsdPer1k` stays `null`, so `assistBandRefuses` answers\n * true and the reservation refuses at 100% with no overage, no switch and no\n * invoice. Nothing about a Free workspace can produce a charge.\n *\n * ## What it costs, and why that is the number\n *\n * A credit is `ASSIST_CREDIT_COST_USD` of provider spend, so the band costs\n * at most **$0.30 per Free workspace per month** — asserted by\n * `apps/console/specs/tier-margin-floor.spec.ts`. It is the one AI band with\n * no invoice behind it, which is why the same issue closes every multiplier\n * a script could use before the flag flips:\n *\n *  - it is metered per ACCOUNT as well as per workspace, so the three free\n *    workspaces an account may hold (AGL-2265) share one 300-credit\n *    allowance rather than tripling it (`reserveAssistMessage`);\n *  - every free request is bounded per IP, per uid and per account per\n *    day (a minimum account age, `AI_FREE_MIN_ACCOUNT_AGE_HOURS`, is\n *    available and off by default — AGL-3591);\n *  - a platform-wide daily ceiling on free spend pauses the taste for\n *    everyone until the UTC day rolls, paid workspaces untouched.\n *\n * The account allowance reads THIS constant rather than the workspace's\n * resolved band, because a staff override that widens one workspace's band\n * is a decision about that workspace, not about how much one person may draw\n * across all of theirs.\n */\nexport const FREE_AI_TASTE_CREDITS_PER_MONTH = 300\n\n/** The AI credits each plan includes a month — see the key's own docblock. */\nexport const AI_CREDITS_BY_PLAN: Readonly<Record<OrgPlan, number>> = {\n  // The Free AI taste (AGL-2925): a real band, and a wall. See the constant\n  // for what it buys, what it costs and the precautions that keep one person\n  // from drawing it three times over.\n  free: FREE_AI_TASTE_CREDITS_PER_MONTH,\n  // The first paid rung of the assist ladder (AGL-3203). Starter banded at 0\n  // until 2026-09-20, which put a PAYING workspace below the Free taste's 300\n  // on the one axis a visitor compares straight down the column — the\n  // `/pricing` row read `300 / mo` for Free and `—` for Starter. A paid plan\n  // that includes less of something than the free plan is not a packaging\n  // subtlety; it is the comparison table arguing against the upgrade.\n  //\n  // 750 is deliberately small: 2.5x the taste, enough that the assistant is a\n  // thing the tier HAS rather than a thing it is shown, and $0.75 of provider\n  // spend a month at `ASSIST_CREDIT_COST_USD` against a $16 annual price — a\n  // twentieth of the $8.81 the tier's other metered bands already cost, and\n  // the widest margin on the ladder absorbs it with room left\n  // (`tier-margin-floor.spec.ts` carries the arithmetic).\n  //\n  // It is NOT a wall, unlike Free's: `PLAN_PRICING.starter\n  // .extraAssistCreditsUsdPer1k` is $3.00, so past 750 the tier meters and\n  // bills like every paid plan above it. The two fields move together by rule\n  // — a positive band with no rate beside it is usage past a bound that is\n  // silently free, which `plan-entitlements.spec.ts` forbids.\n  //\n  // `features.aiAssist` is TRUE, and AGL-3203 shipping it false was the\n  // defect AGL-3207 closes. The reasoning then was \"the band is credits, not\n  // the guided rung, exactly as on Free\" — but on Free the band IS spendable,\n  // through `aiGenerative`, which is the door the taste exists for. Starter\n  // carried neither flag, so it was the only row on the ladder sold a band\n  // with nothing to spend it through: 750 credits reachable only by buying\n  // the $9 add-on that was also the only thing that made them usable. \"No\n  // plan bands at zero any more\" was true of the number and false of the\n  // capability.\n  //\n  // Since AGL-3965 it opens `aiGenerative` too, as every paid rung does: the\n  // included band pays for generation and assist alike (one pool), and an\n  // Aglyn AI tier adds credits on top rather than opening a door.\n  //\n  // No cost moves: `tier-margin-floor.spec.ts` already prices this tier's\n  // assist term at 100% burn of the 750 credits, 75¢/mo. A door does not\n  // widen a band; it only makes spend that was already modeled reachable.\n  starter: 750,\n  // $2.75 of provider spend, against the $8.35 the tier's other seven cost\n  // terms leave out of $56. See the key's docblock for why the remainder and\n  // not the price is what sizes this.\n  pro: 2_750,\n  // $7.50, against the $22.69 the other seven terms leave out of $139.\n  business: 7_500,\n  // $10.00, against the $30.62 the other seven terms leave out of $249.\n  scale: 10_000,\n  // $13.00, against the $39.74 the other seven terms leave out of $399 — the\n  // thinnest remainder on the ladder, and the tier that binds the whole\n  // assist ladder's share of it.\n  advanced: 13_000,\n  // $58.00, against the $176.71 the other seven terms leave out of $1,299.\n  agency: 58_000,\n  enterprise: ENTERPRISE_ASSIST_CREDITS_PER_MONTH,\n}\n\n/** The AI plugin's plan figures, for the manifest generator. */\nexport function aiPlanEntitlements(): PluginPlanEntitlementsDeclaration {\n  return {\n    quotas: [\n      {\n        key: 'assistCreditsPerMonth',\n        label: 'AI credits / mo',\n        byPlan: AI_CREDITS_BY_PLAN,\n      },\n    ],\n  }\n}\n"],"names":["ENTERPRISE_ASSIST_CREDITS_PER_MONTH","FREE_AI_TASTE_CREDITS_PER_MONTH","AI_CREDITS_BY_PLAN","free","starter","pro","business","scale","advanced","agency","enterprise","aiPlanEntitlements","quotas","key","label","byPlan"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AA0DrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,MAAMA,sCAAsC,OAAO;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,MAAMC,kCAAkC,IAAG;AAElD,4EAA4E,GAC5E,OAAO,MAAMC,qBAAwD;IACnE,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpCC,MAAMF;IACN,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,wEAAwE;IACxE,oEAAoE;IACpE,EAAE;IACF,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,4DAA4D;IAC5D,wDAAwD;IACxD,EAAE;IACF,yDAAyD;IACzD,yEAAyE;IACzE,4EAA4E;IAC5E,yEAAyE;IACzE,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,cAAc;IACd,EAAE;IACF,2EAA2E;IAC3E,wEAAwE;IACxE,gEAAgE;IAChE,EAAE;IACF,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxEG,SAAS;IACT,yEAAyE;IACzE,2EAA2E;IAC3E,oCAAoC;IACpCC,KAAK;IACL,qEAAqE;IACrEC,UAAU;IACV,sEAAsE;IACtEC,OAAO;IACP,2EAA2E;IAC3E,sEAAsE;IACtE,+BAA+B;IAC/BC,UAAU;IACV,yEAAyE;IACzEC,QAAQ;IACRC,YAAYV;AACd,EAAC;AAED,8DAA8D,GAC9D,OAAO,SAASW;IACd,OAAO;QACLC,QAAQ;YACN;gBACEC,KAAK;gBACLC,OAAO;gBACPC,QAAQb;YACV;SACD;IACH;AACF"}

package/src/lib/runtime/ai-dataset-generation.d.ts

@@ -71,7 +71,14 @@ export interface GenerateAiDatasetInput extends AiDatasetPromptInput {
 }
 /** Design one dataset. It writes nothing to the site. */
 export declare function generateAiDataset(input: GenerateAiDatasetInput): Promise<AiValidatedGeneration<AiDataset>>;
-/** A designed dataset as the data plugin's `dataset` writer takes it: values by field name. */
+/**
+ * A designed dataset as the data plugin's `dataset` writer takes it: values by
+ * field name. Its words' "a" and "an" agree with what follows them in English
+ * (`aiLayoutArticles`, AGL-3988), as a page's do: the beta.270 Sugar Hollow
+ * packages said "A easygoing session" in their records and on every page
+ * that listed them.
+ */
 export declare function aiDatasetDraftContent(name: string, dataset: AiDataset, options: {
     recordPages: boolean;
+    language?: string | null;
 }): Record<string, unknown>;