@aglyn/plugins-ai 1.0.0-beta.231 → 1.0.0-beta.232

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

@@ -13,7 +13,8 @@
  * 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 { AI_BUILD_PLAN_CREATION_NOUNS, aiPlanUndeclaredRefs } from "./ai-build-plan.js";
+ */ import { aiSiteKind } from "./ai-site-kinds.js";
+import { AI_BUILD_PLAN_CREATION_NOUNS, aiPlanUndeclaredRefs } from "./ai-build-plan.js";
 import { AI_JOB_CREATE_KINDS } from "./ai-job-creations.js";
 import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
 /**
@@ -82,6 +83,7 @@ import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
  * moves and this does not.
  */ export const AI_FREE_SITE_WORST_CASE_CREDITS = {
     plan: 35,
+    look: 7,
     layout: 64,
     firstSection: 44,
     laterSection: 20,
@@ -89,25 +91,25 @@ import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
 };
 /**
  * The most sections a Free site's plan fits in the Free taste at its worst,
- * across all its pages: the plan, the layouts it builds first, each page's
+ * across all its pages: the plan, the look, the layouts it builds first, each page's
  * listing and first pass, and ROOM FOR ONE RETRIED SECTION, then as many later
  * passes as the rest pays for; none when that is already past the wall. Every
  * page's first pass is counted as a cache write, which errs dear.
  */ export function aiFreeSiteSectionsWithin(creations, taste, credits = AI_FREE_SITE_WORST_CASE_CREDITS) {
     const pages = Math.max(1, Math.floor(creations.pages));
-    const before = credits.plan + creations.layouts * credits.layout + pages * (credits.listing + credits.firstSection) + credits.firstSection;
+    const before = credits.plan + credits.look + creations.layouts * credits.layout + pages * (credits.listing + credits.firstSection) + credits.firstSection;
     if (before > taste) return 0;
     return pages + Math.floor((taste - before) / credits.laterSection);
 }
 /** Sections a Free site's page is assumed to hold before its plan names them. */ export const AI_FREE_SITE_NOMINAL_SECTIONS = 3;
 /**
  * About what a Free site start of this many pages costs at its worst, in
- * credits, for the dialog that asks for one: the site plan, each page's
+ * credits, for the dialog that asks for one: the site plan, its look, each page's
  * listing and its sections at the nominal count, from the figures the wall is
  * proven with rather than the nominal credits a paid estimate counts.
  */ export function aiFreeSiteCreditEstimate(pages, credits = AI_FREE_SITE_WORST_CASE_CREDITS) {
     const count = Math.max(1, Math.floor(pages));
-    return credits.plan + count * (credits.listing + credits.firstSection) + count * (AI_FREE_SITE_NOMINAL_SECTIONS - 1) * credits.laterSection;
+    return credits.plan + credits.look + count * (credits.listing + credits.firstSection) + count * (AI_FREE_SITE_NOMINAL_SECTIONS - 1) * credits.laterSection;
 }
 /**
  * The most sections one scaffolded page may hold. The plan model allows more
@@ -194,6 +196,8 @@ import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
 }
 const ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/;
 /** A scaffold's inputs, or the sentence the door refuses them with. */ export function parseAiSiteJobInputs(inputs) {
+    var _ref;
+    var _aiSiteKind;
     const text = (key)=>{
         const value = inputs == null ? void 0 : inputs[key];
         if (value === undefined || value === null || value === '') return '';
@@ -211,6 +215,8 @@ const ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/;
     const brand = text('brand');
     const audience = text('audience');
     const starter = text('starter');
+    // A kind this deployment does not know is nobody having picked one.
+    const siteKind = (_ref = (_aiSiteKind = aiSiteKind(inputs == null ? void 0 : inputs['siteKind'])) == null ? void 0 : _aiSiteKind.id) != null ? _ref : '';
     for (const [key, value] of [
         [
             'businessName',
@@ -253,6 +259,7 @@ const ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/;
         businessType,
         audience: audience,
         starter: starter,
+        siteKind,
         pages,
         businessName: businessName,
         city: city,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-job.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  aiPlanUndeclaredRefs,\n  type AiBuildPlan,\n  type AiBuildPlanCreateKind,\n} from './ai-build-plan'\nimport { AI_JOB_CREATE_KINDS } from './ai-job-creations'\nimport { AI_PAGE_CREATE_KINDS } from './ai-page-job'\n\n/**\n * What a site scaffold is (AGL-2911): the inputs a `site` job is admitted\n * with, the plans a scaffold can build, and what one is estimated to cost\n * before it starts.\n *\n * A scaffold is the one job kind that builds a whole site rather than one\n * record: a plan of four to eight screens, the layout they render inside,\n * the contact form they place, a palette suggestion, and — where the email\n * step is loaded — a welcome email. It builds each of those through the job\n * kind that already owns it, so this module describes what a scaffold may\n * ask for and refuses the rest at confirmation, before a credit is spent,\n * naming what to make first.\n *\n * ── The estimate is the guard rail ───────────────────────────────────────\n *\n * A scaffold is tens of model calls, where every other kind is a few, so the\n * member reads what it will cost before they confirm the plan that spends\n * it. The figure is the machine's own nominal credits per step multiplied by\n * the passes the plan implies — an estimate, and said to be one wherever it\n * is shown.\n *\n * This module imports nothing at runtime, so the doors, the step, the batch\n * card and the plan proposal read one vocabulary.\n */\n\n/** How many pages a scaffold builds: enough to be a site, few enough to read. */\nexport const AI_SITE_PAGES = { min: 4, max: 8 } as const\n\n/**\n * How many pages a Free workspace's scaffold builds (AGL-3594): its home page\n * and the one page the brief most needs. A product decision, not a figure the\n * wall derives — the wall's proof (`jobs/ai-job-free-site.spec.ts`) shows a\n * plan and a build of this many pages fit the Free taste with room for one\n * retried section.\n */\nexport const AI_SITE_FREE_PAGES = { min: 1, max: 2 } as const\n\n/** The pages a scaffold builds for a workspace on the Free taste or on a paid plan. */\nexport function aiSitePagesBand(\n  freeTaste: boolean | null | undefined,\n): { readonly min: number; readonly max: number } {\n  return freeTaste ? AI_SITE_FREE_PAGES : AI_SITE_PAGES\n}\n\n/**\n * The job input a guided site start sets so its plan is confirmed for it\n * (AGL-3594); `jobs/ai-job-auto-confirm.ts` says where it is honored.\n */\nexport const AI_JOB_AUTO_CONFIRM_INPUT = 'autoConfirm'\n\n/** What a Free site start's page selector says under it (AGL-3594). */\nexport const AI_SITE_FREE_PAGES_NOTE = 'Paid plans can generate more pages.'\n\n/**\n * The plan's answer ceiling for a scaffold (AGL-3594), Free and paid. A plan\n * is an outline — each page's title, address, search listing and sections by\n * name — and the build steps write everything else, so a scaffold plans with\n * no thinking and at a ceiling sized to the outline of its largest band with\n * room to spare: about 300 tokens a page. The 13,491-token plan a Free site\n * spent 227 of its 300 credits on was its thinking, at the routing table's\n * 8,000 a call.\n */\nexport const AI_SITE_PLAN_MAX_TOKENS = { free: 2_000, paid: 4_000 } as const\n\n/** What each exchange of a Free site job comes to at its worst, in credits. */\nexport interface AiFreeSiteWorstCase {\n  /** The site plan: its answer and its one re-ask, each at its ceiling. */\n  plan: number\n  /** The one layout a Free plan includes, built first on a site with none. */\n  layout: number\n  /** A page's first section pass, which writes the cached prefix. */\n  firstSection: number\n  /** Each later section pass. */\n  laterSection: number\n  /** A page's listing. */\n  listing: number\n}\n\n/**\n * The Free site start's wall at its worst (AGL-3594): the site plan as\n * `jobs/ai-job-free-site.spec.ts` derives it from the plan request as it\n * stands, on the model a Free site plans with, every answer at its ceiling;\n * the build's exchanges are the Free page's (`AI_FREE_PAGE_WORST_CASE_CREDITS`),\n * which the same spec holds these to. The spec fails when a figure it derives\n * moves and this does not.\n */\nexport const AI_FREE_SITE_WORST_CASE_CREDITS: Readonly<AiFreeSiteWorstCase> = {\n  plan: 35,\n  layout: 64,\n  firstSection: 44,\n  laterSection: 20,\n  listing: 3,\n}\n\n/**\n * The most sections a Free site's plan fits in the Free taste at its worst,\n * across all its pages: the plan, the layouts it builds first, each page's\n * listing and first pass, and ROOM FOR ONE RETRIED SECTION, then as many later\n * passes as the rest pays for; none when that is already past the wall. Every\n * page's first pass is counted as a cache write, which errs dear.\n */\nexport function aiFreeSiteSectionsWithin(\n  creations: { layouts: number; pages: number },\n  taste: number,\n  credits: Readonly<AiFreeSiteWorstCase> = AI_FREE_SITE_WORST_CASE_CREDITS,\n): number {\n  const pages = Math.max(1, Math.floor(creations.pages))\n  const before =\n    credits.plan +\n    creations.layouts * credits.layout +\n    pages * (credits.listing + credits.firstSection) +\n    credits.firstSection\n  if (before > taste) return 0\n  return pages + Math.floor((taste - before) / credits.laterSection)\n}\n\n/** Sections a Free site's page is assumed to hold before its plan names them. */\nexport const AI_FREE_SITE_NOMINAL_SECTIONS = 3\n\n/**\n * About what a Free site start of this many pages costs at its worst, in\n * credits, for the dialog that asks for one: the site plan, each page's\n * listing and its sections at the nominal count, from the figures the wall is\n * proven with rather than the nominal credits a paid estimate counts.\n */\nexport function aiFreeSiteCreditEstimate(\n  pages: number,\n  credits: Readonly<AiFreeSiteWorstCase> = AI_FREE_SITE_WORST_CASE_CREDITS,\n): number {\n  const count = Math.max(1, Math.floor(pages))\n  return (\n    credits.plan +\n    count * (credits.listing + credits.firstSection) +\n    count * (AI_FREE_SITE_NOMINAL_SECTIONS - 1) * credits.laterSection\n  )\n}\n\n/**\n * The most sections one scaffolded page may hold. The plan model allows more\n * for a page job, which builds one page; a scaffold builds eight, and each\n * section is a pass of its own.\n */\nexport const AI_SITE_MAX_SECTIONS = 8\n\n/**\n * Sections a page is assumed to hold before a plan names them, for the\n * estimate a member reads when they ask for a scaffold. A declared\n * assumption, not a measurement: the plan's own section counts replace it\n * the moment the plan exists.\n */\nexport const AI_SITE_NOMINAL_SECTIONS = 5\n\n/**\n * The credits one pass is held against: the machine's\n * `AI_JOB_STEP_RESERVE_CREDITS`, declared here so the estimate stays a pure\n * number the console computes without the Admin SDK. `ai-site-job.spec.ts`\n * holds the two equal.\n */\nexport const AI_SITE_PASS_CREDITS = 50\n\n/** The longest a scaffold's scalar inputs may run; they are names, not copy. */\nexport const AI_SITE_INPUT_MAX_CHARS = 120\n\n/** The sites one agency batch may generate for in one request. */\nexport const AI_SITE_BATCH_MAX = 25\n\n/**\n * The sites a plan must hold before the org Sites page offers the batch at\n * all: the Agency and Advanced bands, which the plan's `hostLimit` is what\n * distinguishes.\n */\nexport const AI_SITE_BATCH_MIN_HOST_LIMIT = 25\n\nexport interface AiSiteJobInputs {\n  /** What the business is, in a few words: the brief's subject. */\n  businessType: string\n  /**\n   * Who the site is for, in a few words (AGL-2918); empty when nobody said.\n   * The plan step puts it in front of the model on a line of its own, as it\n   * does every other scalar here, so it narrows the pages a plan proposes\n   * without a prompt of its own.\n   */\n  audience: string\n  /**\n   * The starter site whose shape the person liked (AGL-2918), by its\n   * `STARTER_TEMPLATES` id; empty when they picked none.\n   *\n   * A hint carried as the id rather than the starter, because an id is what\n   * the guided start's list, this door and the plan's line all agree on\n   * without any of them loading a catalog of node maps. Unrecognized ids are\n   * admitted for the same reason an unrecognized business type is: it is a\n   * few words in a brief, not a lookup.\n   */\n  starter: string\n  /** How many pages the member asked for. */\n  pages: number\n  /** The per-site variables an agency batch varies; empty when none was given. */\n  businessName: string\n  city: string\n  brand: string\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n  /**\n   * Where the contact form's submissions go (AGL-2918); `null` where nobody\n   * said, which is every job created before the question existed and every\n   * door that does not ask it.\n   *\n   * The one setting a new site owner actually needs made, and the one thing\n   * about a contact form a model cannot know: whether a submission is a note\n   * to read or a lead to chase is a decision about how the business runs. So\n   * an answer BINDS the form step rather than hinting to it, and `null`\n   * leaves the model's own proposal standing, exactly as it stood before.\n   */\n  submissions: AiSiteSubmissions | null\n  /** The batch this job was created under (AGL-2911); `null` for a single site. */\n  batchId: string | null\n}\n\n/**\n * Where a site's contact form sends what a visitor writes.\n *\n * Two, not three. The form step's own vocabulary has a third — a mailing\n * list — which it can only answer with a note, because the stored routing has\n * no place for a list; offering it as a question would be asking somebody to\n * pick an outcome the platform then explains it cannot store.\n */\nexport const AI_SITE_SUBMISSIONS = ['inbox', 'lead'] as const\n\nexport type AiSiteSubmissions = (typeof AI_SITE_SUBMISSIONS)[number]\n\n/**\n * What each answer to \"where do submissions go\" is called, and what it means.\n *\n * Here rather than beside the guided start's own questions, because it is not\n * only the guided start that asks: the agency batch asks the same thing of a\n * whole run (AGL-2918), and two surfaces wording one decision two ways is two\n * decisions. `ai-site-job.spec.ts` holds the list to {@link AI_SITE_SUBMISSIONS}.\n */\nexport const AI_SITE_SUBMISSION_CHOICES: ReadonlyArray<{\n  id: AiSiteSubmissions\n  label: string\n  blurb: string\n}> = [\n  {\n    id: 'inbox',\n    label: 'The Inbox',\n    blurb: 'Every message is one to read and reply to.',\n  },\n  {\n    id: 'lead',\n    label: 'The Inbox, and CRM as a lead',\n    blurb: 'Every message with an email address is also somebody to follow up.',\n  },\n]\n\n/**\n * Which kind of email a scaffold's email unit is (AGL-2918), carried on the\n * derived job as `inputs.emailType`. The email step names the kind on the one\n * line it puts above the brief, and a scaffold was naming none.\n *\n * A key of the email step's own `AI_EMAIL_TYPES`, held here because neither\n * step may import the other: a scaffold delegates by job kind, and a\n * deployment that scaffolds is not necessarily one that has loaded the email\n * step. `ai-job-email-step.spec.ts` holds this key to that catalog.\n *\n * `reply` and not `welcome`. The five kinds a member picks are campaigns\n * somebody sends to an audience, and this is an answer to one person who\n * wrote in through the site; the nearest, `welcome`, is a label about signing\n * up, and a kind that misdescribes the email is worse than an absent one\n * because it is the first thing the model is told.\n */\nexport const AI_SITE_EMAIL_TYPE = 'reply'\n\n/**\n * What a site job's plan and every unit it builds are told about the\n * business's name (AGL-3596): that it is the name, used as written. Said on\n * the job's own turn, never in a cached system block, because it is one\n * site's. A model handed only what the business does named it itself —\n * \"Hillside Dog Grooming\" was built as \"Austin Paws Grooming\".\n */\nexport function aiSiteNameSentence(name: string): string {\n  return `The business is named “${name}”: the site names it exactly that way, in the header, the footer, the copy and the search listing, and never by any other name.`\n}\n\n/** Where a job's inputs say submissions go, or `null` where they do not say. */\nexport function aiSiteSubmissions(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteSubmissions | null {\n  const value = inputs?.['submissions']\n  return (AI_SITE_SUBMISSIONS as readonly unknown[]).includes(value)\n    ? (value as AiSiteSubmissions)\n    : null\n}\n\nconst ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/\n\n/** A scaffold's inputs, or the sentence the door refuses them with. */\nexport function parseAiSiteJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteJobInputs | string {\n  const text = (key: string): string | null => {\n    const value = inputs?.[key]\n    if (value === undefined || value === null || value === '') return ''\n    if (typeof value !== 'string') return null\n    const trimmed = value.trim()\n    return trimmed.length > AI_SITE_INPUT_MAX_CHARS ? null : trimmed\n  }\n  const businessType = text('businessType')\n  if (businessType === null) {\n    return `businessType must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`\n  }\n  if (!businessType) return 'Say what kind of business the site is for'\n  const businessName = text('businessName')\n  const city = text('city')\n  const brand = text('brand')\n  const audience = text('audience')\n  const starter = text('starter')\n  for (const [key, value] of [\n    ['businessName', businessName],\n    ['city', city],\n    ['brand', brand],\n    ['audience', audience],\n    ['starter', starter],\n  ] as const) {\n    if (value === null)\n      return `${key} must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`\n  }\n  const rawPages = inputs?.['pages']\n  const pages =\n    typeof rawPages === 'number' ? rawPages : Number(rawPages ?? NaN)\n  // Read here across both bands; the door holds a workspace to its own\n  // (`aiSitePagesRefusal`), since only it knows the workspace's plan.\n  if (\n    !Number.isInteger(pages) ||\n    pages < AI_SITE_FREE_PAGES.min ||\n    pages > AI_SITE_PAGES.max\n  ) {\n    return `pages must be a whole number from ${AI_SITE_FREE_PAGES.min} to ${AI_SITE_PAGES.max}`\n  }\n  // Where submissions go is admitted only as one of the two the form step\n  // can actually bind; anything else is nobody having said, and the model\n  // proposes as it always did rather than the door refusing the whole job.\n  const submissions = aiSiteSubmissions(inputs)\n  const rawBatch = inputs?.['batchId']\n  const batchId =\n    rawBatch === undefined || rawBatch === null || rawBatch === ''\n      ? null\n      : typeof rawBatch === 'string' && ID_CHARS.test(rawBatch)\n        ? rawBatch\n        : undefined\n  if (batchId === undefined) return 'batchId is not a batch id'\n  return {\n    businessType,\n    audience: audience as string,\n    starter: starter as string,\n    pages,\n    businessName: businessName as string,\n    city: city as string,\n    brand: brand as string,\n    welcomeEmail: inputs?.['welcomeEmail'] !== false,\n    submissions,\n    batchId,\n  }\n}\n\n/**\n * Why a workspace cannot ask for this many pages (AGL-3594), in a sentence a\n * member reads; `null` when it can. A Free workspace builds one or two, and a\n * paid one four to eight, as it always has. Refused rather than clamped: the\n * guided start offers only the band, so a request outside it was not made\n * there, and a job quietly building fewer pages than it was asked for is a\n * worse answer than a sentence saying why.\n */\nexport function aiSitePagesRefusal(pages: number, freeTaste: boolean | null | undefined): string | null {\n  const band = aiSitePagesBand(freeTaste)\n  if (pages >= band.min && pages <= band.max) return null\n  return freeTaste\n    ? `A Free workspace's AI site start builds ${AI_SITE_FREE_PAGES.min} or ${AI_SITE_FREE_PAGES.max} pages. ${AI_SITE_FREE_PAGES_NOTE}`\n    : `A site is planned with ${band.min} to ${band.max} pages.`\n}\n\n/**\n * What the site itself is, as a step that is NOT the scaffold reads it off a\n * job's inputs (AGL-2918).\n *\n * A scaffold delegates unit by unit under a job derived from its own — a page\n * job, a form job — and the derived job carries the scaffold's inputs. So the\n * two answers that describe the site rather than one record of it are\n * readable by every delegated step, and a step that wants them does not have\n * to know it was delegated to.\n *\n * Lenient where {@link parseAiSiteJobInputs} is strict, because it reads the\n * inputs of jobs that are not scaffolds: a page job started from the Screens\n * page has no `businessType` and no `pages`, and that is not an error here —\n * it is a site nobody described, and the answer is two empty strings.\n */\nexport interface AiSiteWords {\n  /** What kind of site it is; empty when the job's inputs do not say. */\n  about: string\n  /** Who it is for; empty when the job's inputs do not say. */\n  audience: string\n}\n\n/** Whether either half of {@link AiSiteWords} says anything. */\nexport function aiSiteWordsSaidAnything(words: AiSiteWords): boolean {\n  return Boolean(words.about || words.audience)\n}\n\n/** What a job's inputs say the site is, read defensively and trimmed to the input ceiling. */\nexport function aiSiteWords(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteWords {\n  const read = (key: string): string => {\n    const value = inputs?.[key]\n    if (typeof value !== 'string') return ''\n    return value.replace(/\\s+/g, ' ').trim().slice(0, AI_SITE_INPUT_MAX_CHARS).trim()\n  }\n  return { about: read('businessType'), audience: read('audience') }\n}\n\n/**\n * What a scaffold builds for itself: the layout its pages render inside, the\n * form they place, and the palette suggestion a member applies in the Theme\n * section. Anything else a plan asks to create is a job of its own.\n */\nexport const AI_SITE_CREATE_KINDS: readonly AiBuildPlanCreateKind[] = [\n  'layout',\n  'form',\n  'theme-change',\n]\n\n/** The creations a scaffold cannot build, in the order the plan lists them, each named once. */\nexport function aiSitePlanPrerequisites(\n  plan: AiBuildPlan,\n): Array<{ kind: AiBuildPlanCreateKind; name: string }> {\n  const seen = new Set<string>()\n  const prerequisites: Array<{ kind: AiBuildPlanCreateKind; name: string }> = []\n  const add = (kind: AiBuildPlanCreateKind, name: string) => {\n    const key = `${kind}:${name.toLowerCase()}`\n    if (seen.has(key)) return\n    seen.add(key)\n    prerequisites.push({ kind, name })\n  }\n  for (const entry of plan.create) {\n    if (!AI_SITE_CREATE_KINDS.includes(entry.kind)) add(entry.kind, entry.name)\n  }\n  // A reference the create list does not carry is refused by the plan rules\n  // before a plan is kept: rule 2 for a screen's layout, rule 7 for anything\n  // else (`plan-creation-undeclared`, AGL-3040). A plan confirmed before that\n  // rule existed can still carry one. It is named as a component: the\n  // reference carries no kind, and the refusal must say where one is made.\n  for (const { name } of aiPlanUndeclaredRefs(plan)) add('component', name)\n  return prerequisites\n}\n\n/**\n * Why a scaffold cannot build a plan of this SHAPE — the page band, a page's\n * sections, its addresses, its navigation — in a sentence a member reads;\n * `null` when the shape is one it builds. The plan step holds a plan to it\n * with a re-ask (AGL-3030), and the doors hold a confirmed plan to it again\n * through `aiSitePlanRefusal`.\n */\nexport function aiSitePlanShapeRefusal(\n  plan: AiBuildPlan,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  const { screens } = plan\n  const band = aiSitePagesBand(options.freeTaste)\n  if (screens.length < band.min || screens.length > band.max) {\n    return `This plan builds ${screens.length} ${screens.length === 1 ? 'page' : 'pages'}, and ${\n      options.freeTaste ? \"a Free workspace's site scaffold\" : 'a site scaffold'\n    } builds ${band.min} to ${band.max}. Describe the site again.`\n  }\n  const slugs = new Set<string>()\n  for (const screen of screens) {\n    if (!screen.sections.length) {\n      return `The page “${screen.title}” has no sections to build. Describe the site again.`\n    }\n    if (screen.sections.length > AI_SITE_MAX_SECTIONS) {\n      return `The page “${screen.title}” has ${screen.sections.length} sections, and a scaffolded page holds ${AI_SITE_MAX_SECTIONS}. Describe the site again.`\n    }\n    const slug = screen.slug.trim().toLowerCase()\n    if (slugs.has(slug)) {\n      return `Two pages in this plan share the address ${screen.slug}. Describe the site again.`\n    }\n    slugs.add(slug)\n  }\n  if (!screens.some((screen) => screen.nav)) {\n    return 'No page in this plan is in the site navigation. Describe the site again.'\n  }\n  return null\n}\n\n/**\n * Why a scaffold cannot build this plan, in a sentence a member reads when\n * confirming it; `null` when it can.\n */\nexport function aiSitePlanRefusal(\n  plan: AiBuildPlan,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  const shape = aiSitePlanShapeRefusal(plan, options)\n  if (shape) return shape\n  const prerequisites = aiSitePlanPrerequisites(plan)\n  if (!prerequisites.length) return null\n  const parts = prerequisites.map(\n    ({ kind, name }) =>\n      `the ${AI_BUILD_PLAN_CREATION_NOUNS[kind].noun} “${name}” ${AI_BUILD_PLAN_CREATION_NOUNS[kind].where}`,\n  )\n  const listed =\n    parts.length === 1\n      ? parts[0]\n      : `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`\n  return `This site needs what the workspace does not have yet. Create ${listed}, then describe the site again.`\n}\n\n/** What the estimate counts a plan in: whether a welcome email follows, and the creations the job builds. */\nexport interface AiPlanPassOptions {\n  welcomeEmail?: boolean\n  /** The creation kinds the job builds itself; a scaffold's when absent. */\n  creates?: readonly AiBuildPlanCreateKind[]\n}\n\n/**\n * The passes a plan implies: one per section of every screen, one more per\n * screen for its search listing and its draft, and one for each thing the\n * plan creates that the job builds. What the estimate is counted in.\n */\nexport function aiPlanPasses(plan: AiBuildPlan, options: AiPlanPassOptions = {}): number {\n  const screens = plan.screens.reduce(\n    (total, screen) => total + screen.sections.length + 1,\n    0,\n  )\n  const creates = options.creates ?? AI_SITE_CREATE_KINDS\n  const creations = plan.create.filter((entry) => creates.includes(entry.kind)).length\n  return screens + creations + (options.welcomeEmail ? 1 : 0)\n}\n\n/**\n * About what a plan costs to build, in credits. An ESTIMATE: the nominal\n * credits the machine holds per step, times the passes the plan implies.\n * What each pass actually costs is its model's tokens, recorded on the job\n * as it runs.\n */\nexport function aiPlanCreditEstimate(plan: AiBuildPlan, options: AiPlanPassOptions = {}): number {\n  return aiPlanPasses(plan, options) * AI_SITE_PASS_CREDITS\n}\n\n/**\n * About what a job of this kind costs to build from its plan (AGL-3031): a\n * page job counts the layout, forms and components it builds before its\n * page; a template, layout, component, form or email job counts its own\n * record and every creation it builds before it (AGL-3143 §15); and a\n * scaffold counts what it builds. The figure the proposal shows beside\n * Confirm, and the hold a confirmation takes.\n */\nexport function aiJobPlanCreditEstimate(kind: string, plan: AiBuildPlan): number {\n  const creates =\n    kind === 'page' ? AI_PAGE_CREATE_KINDS : AI_JOB_CREATE_KINDS[kind as keyof typeof AI_JOB_CREATE_KINDS]\n  return aiPlanCreditEstimate(plan, creates ? { creates } : {})\n}\n\n/**\n * About what a scaffold of this many pages costs, before a plan names its\n * sections: the same arithmetic on the nominal section count, plus the plan\n * step that proposes it. Shown where a member asks for a scaffold.\n */\nexport function aiSiteCreditEstimate(\n  pages: number,\n  options: { welcomeEmail?: boolean } = {},\n): number {\n  const screens = Math.max(0, Math.floor(pages))\n  const passes =\n    1 +\n    screens * (AI_SITE_NOMINAL_SECTIONS + 1) +\n    2 +\n    (options.welcomeEmail ? 1 : 0)\n  return passes * AI_SITE_PASS_CREDITS\n}\n"],"names":["AI_BUILD_PLAN_CREATION_NOUNS","aiPlanUndeclaredRefs","AI_JOB_CREATE_KINDS","AI_PAGE_CREATE_KINDS","AI_SITE_PAGES","min","max","AI_SITE_FREE_PAGES","aiSitePagesBand","freeTaste","AI_JOB_AUTO_CONFIRM_INPUT","AI_SITE_FREE_PAGES_NOTE","AI_SITE_PLAN_MAX_TOKENS","free","paid","AI_FREE_SITE_WORST_CASE_CREDITS","plan","layout","firstSection","laterSection","listing","aiFreeSiteSectionsWithin","creations","taste","credits","pages","Math","floor","before","layouts","AI_FREE_SITE_NOMINAL_SECTIONS","aiFreeSiteCreditEstimate","count","AI_SITE_MAX_SECTIONS","AI_SITE_NOMINAL_SECTIONS","AI_SITE_PASS_CREDITS","AI_SITE_INPUT_MAX_CHARS","AI_SITE_BATCH_MAX","AI_SITE_BATCH_MIN_HOST_LIMIT","AI_SITE_SUBMISSIONS","AI_SITE_SUBMISSION_CHOICES","id","label","blurb","AI_SITE_EMAIL_TYPE","aiSiteNameSentence","name","aiSiteSubmissions","inputs","value","includes","ID_CHARS","parseAiSiteJobInputs","text","key","undefined","trimmed","trim","length","businessType","businessName","city","brand","audience","starter","rawPages","Number","NaN","isInteger","submissions","rawBatch","batchId","test","welcomeEmail","aiSitePagesRefusal","band","aiSiteWordsSaidAnything","words","Boolean","about","aiSiteWords","read","replace","slice","AI_SITE_CREATE_KINDS","aiSitePlanPrerequisites","seen","Set","prerequisites","add","kind","toLowerCase","has","push","entry","create","aiSitePlanShapeRefusal","options","screens","slugs","screen","sections","title","slug","some","nav","aiSitePlanRefusal","shape","parts","map","noun","where","listed","join","aiPlanPasses","reduce","total","creates","filter","aiPlanCreditEstimate","aiJobPlanCreditEstimate","aiSiteCreditEstimate","passes"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-job.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 } from './ai-site-kinds'\nimport {\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  aiPlanUndeclaredRefs,\n  type AiBuildPlan,\n  type AiBuildPlanCreateKind,\n} from './ai-build-plan'\nimport { AI_JOB_CREATE_KINDS } from './ai-job-creations'\nimport { AI_PAGE_CREATE_KINDS } from './ai-page-job'\n\n/**\n * What a site scaffold is (AGL-2911): the inputs a `site` job is admitted\n * with, the plans a scaffold can build, and what one is estimated to cost\n * before it starts.\n *\n * A scaffold is the one job kind that builds a whole site rather than one\n * record: a plan of four to eight screens, the layout they render inside,\n * the contact form they place, a palette suggestion, and — where the email\n * step is loaded — a welcome email. It builds each of those through the job\n * kind that already owns it, so this module describes what a scaffold may\n * ask for and refuses the rest at confirmation, before a credit is spent,\n * naming what to make first.\n *\n * ── The estimate is the guard rail ───────────────────────────────────────\n *\n * A scaffold is tens of model calls, where every other kind is a few, so the\n * member reads what it will cost before they confirm the plan that spends\n * it. The figure is the machine's own nominal credits per step multiplied by\n * the passes the plan implies — an estimate, and said to be one wherever it\n * is shown.\n *\n * This module imports nothing at runtime, so the doors, the step, the batch\n * card and the plan proposal read one vocabulary.\n */\n\n/** How many pages a scaffold builds: enough to be a site, few enough to read. */\nexport const AI_SITE_PAGES = { min: 4, max: 8 } as const\n\n/**\n * How many pages a Free workspace's scaffold builds (AGL-3594): its home page\n * and the one page the brief most needs. A product decision, not a figure the\n * wall derives — the wall's proof (`jobs/ai-job-free-site.spec.ts`) shows a\n * plan and a build of this many pages fit the Free taste with room for one\n * retried section.\n */\nexport const AI_SITE_FREE_PAGES = { min: 1, max: 2 } as const\n\n/** The pages a scaffold builds for a workspace on the Free taste or on a paid plan. */\nexport function aiSitePagesBand(\n  freeTaste: boolean | null | undefined,\n): { readonly min: number; readonly max: number } {\n  return freeTaste ? AI_SITE_FREE_PAGES : AI_SITE_PAGES\n}\n\n/**\n * The job input a guided site start sets so its plan is confirmed for it\n * (AGL-3594); `jobs/ai-job-auto-confirm.ts` says where it is honored.\n */\nexport const AI_JOB_AUTO_CONFIRM_INPUT = 'autoConfirm'\n\n/** What a Free site start's page selector says under it (AGL-3594). */\nexport const AI_SITE_FREE_PAGES_NOTE = 'Paid plans can generate more pages.'\n\n/**\n * The plan's answer ceiling for a scaffold (AGL-3594), Free and paid. A plan\n * is an outline — each page's title, address, search listing and sections by\n * name — and the build steps write everything else, so a scaffold plans with\n * no thinking and at a ceiling sized to the outline of its largest band with\n * room to spare: about 300 tokens a page. The 13,491-token plan a Free site\n * spent 227 of its 300 credits on was its thinking, at the routing table's\n * 8,000 a call.\n */\nexport const AI_SITE_PLAN_MAX_TOKENS = { free: 2_000, paid: 4_000 } as const\n\n/** What each exchange of a Free site job comes to at its worst, in credits. */\nexport interface AiFreeSiteWorstCase {\n  /** The site plan: its answer and its one re-ask, each at its ceiling. */\n  plan: number\n  /** The site's look (AGL-3660): its one answer at its ceiling, on the fast tier. */\n  look: number\n  /** The one layout a Free plan includes, built first on a site with none. */\n  layout: number\n  /** A page's first section pass, which writes the cached prefix. */\n  firstSection: number\n  /** Each later section pass. */\n  laterSection: number\n  /** A page's listing. */\n  listing: number\n}\n\n/**\n * The Free site start's wall at its worst (AGL-3594): the site plan as\n * `jobs/ai-job-free-site.spec.ts` derives it from the plan request as it\n * stands, on the model a Free site plans with, every answer at its ceiling;\n * the build's exchanges are the Free page's (`AI_FREE_PAGE_WORST_CASE_CREDITS`),\n * which the same spec holds these to. The spec fails when a figure it derives\n * moves and this does not.\n */\nexport const AI_FREE_SITE_WORST_CASE_CREDITS: Readonly<AiFreeSiteWorstCase> = {\n  plan: 35,\n  look: 7,\n  layout: 64,\n  firstSection: 44,\n  laterSection: 20,\n  listing: 3,\n}\n\n/**\n * The most sections a Free site's plan fits in the Free taste at its worst,\n * across all its pages: the plan, the look, the layouts it builds first, each page's\n * listing and first pass, and ROOM FOR ONE RETRIED SECTION, then as many later\n * passes as the rest pays for; none when that is already past the wall. Every\n * page's first pass is counted as a cache write, which errs dear.\n */\nexport function aiFreeSiteSectionsWithin(\n  creations: { layouts: number; pages: number },\n  taste: number,\n  credits: Readonly<AiFreeSiteWorstCase> = AI_FREE_SITE_WORST_CASE_CREDITS,\n): number {\n  const pages = Math.max(1, Math.floor(creations.pages))\n  const before =\n    credits.plan +\n    credits.look +\n    creations.layouts * credits.layout +\n    pages * (credits.listing + credits.firstSection) +\n    credits.firstSection\n  if (before > taste) return 0\n  return pages + Math.floor((taste - before) / credits.laterSection)\n}\n\n/** Sections a Free site's page is assumed to hold before its plan names them. */\nexport const AI_FREE_SITE_NOMINAL_SECTIONS = 3\n\n/**\n * About what a Free site start of this many pages costs at its worst, in\n * credits, for the dialog that asks for one: the site plan, its look, each page's\n * listing and its sections at the nominal count, from the figures the wall is\n * proven with rather than the nominal credits a paid estimate counts.\n */\nexport function aiFreeSiteCreditEstimate(\n  pages: number,\n  credits: Readonly<AiFreeSiteWorstCase> = AI_FREE_SITE_WORST_CASE_CREDITS,\n): number {\n  const count = Math.max(1, Math.floor(pages))\n  return (\n    credits.plan +\n    credits.look +\n    count * (credits.listing + credits.firstSection) +\n    count * (AI_FREE_SITE_NOMINAL_SECTIONS - 1) * credits.laterSection\n  )\n}\n\n/**\n * The most sections one scaffolded page may hold. The plan model allows more\n * for a page job, which builds one page; a scaffold builds eight, and each\n * section is a pass of its own.\n */\nexport const AI_SITE_MAX_SECTIONS = 8\n\n/**\n * Sections a page is assumed to hold before a plan names them, for the\n * estimate a member reads when they ask for a scaffold. A declared\n * assumption, not a measurement: the plan's own section counts replace it\n * the moment the plan exists.\n */\nexport const AI_SITE_NOMINAL_SECTIONS = 5\n\n/**\n * The credits one pass is held against: the machine's\n * `AI_JOB_STEP_RESERVE_CREDITS`, declared here so the estimate stays a pure\n * number the console computes without the Admin SDK. `ai-site-job.spec.ts`\n * holds the two equal.\n */\nexport const AI_SITE_PASS_CREDITS = 50\n\n/** The longest a scaffold's scalar inputs may run; they are names, not copy. */\nexport const AI_SITE_INPUT_MAX_CHARS = 120\n\n/** The sites one agency batch may generate for in one request. */\nexport const AI_SITE_BATCH_MAX = 25\n\n/**\n * The sites a plan must hold before the org Sites page offers the batch at\n * all: the Agency and Advanced bands, which the plan's `hostLimit` is what\n * distinguishes.\n */\nexport const AI_SITE_BATCH_MIN_HOST_LIMIT = 25\n\nexport interface AiSiteJobInputs {\n  /** What the business is, in a few words: the brief's subject. */\n  businessType: string\n  /**\n   * Who the site is for, in a few words (AGL-2918); empty when nobody said.\n   * The plan step puts it in front of the model on a line of its own, as it\n   * does every other scalar here, so it narrows the pages a plan proposes\n   * without a prompt of its own.\n   */\n  audience: string\n  /**\n   * The starter site whose shape the person liked (AGL-2918), by its\n   * `STARTER_TEMPLATES` id; empty when they picked none.\n   *\n   * A hint carried as the id rather than the starter, because an id is what\n   * the guided start's list, this door and the plan's line all agree on\n   * without any of them loading a catalog of node maps. Unrecognized ids are\n   * admitted for the same reason an unrecognized business type is: it is a\n   * few words in a brief, not a lookup.\n   */\n  starter: string\n  /**\n   * The kind of site the person picked (AGL-3660), by its `AI_SITE_KINDS`\n   * id; empty when nobody picked one, and the business type suggests it.\n   * It sets the look the site is designed in and how its pages are arranged.\n   */\n  siteKind: string\n  /** How many pages the member asked for. */\n  pages: number\n  /** The per-site variables an agency batch varies; empty when none was given. */\n  businessName: string\n  city: string\n  brand: string\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n  /**\n   * Where the contact form's submissions go (AGL-2918); `null` where nobody\n   * said, which is every job created before the question existed and every\n   * door that does not ask it.\n   *\n   * The one setting a new site owner actually needs made, and the one thing\n   * about a contact form a model cannot know: whether a submission is a note\n   * to read or a lead to chase is a decision about how the business runs. So\n   * an answer BINDS the form step rather than hinting to it, and `null`\n   * leaves the model's own proposal standing, exactly as it stood before.\n   */\n  submissions: AiSiteSubmissions | null\n  /** The batch this job was created under (AGL-2911); `null` for a single site. */\n  batchId: string | null\n}\n\n/**\n * Where a site's contact form sends what a visitor writes.\n *\n * Two, not three. The form step's own vocabulary has a third — a mailing\n * list — which it can only answer with a note, because the stored routing has\n * no place for a list; offering it as a question would be asking somebody to\n * pick an outcome the platform then explains it cannot store.\n */\nexport const AI_SITE_SUBMISSIONS = ['inbox', 'lead'] as const\n\nexport type AiSiteSubmissions = (typeof AI_SITE_SUBMISSIONS)[number]\n\n/**\n * What each answer to \"where do submissions go\" is called, and what it means.\n *\n * Here rather than beside the guided start's own questions, because it is not\n * only the guided start that asks: the agency batch asks the same thing of a\n * whole run (AGL-2918), and two surfaces wording one decision two ways is two\n * decisions. `ai-site-job.spec.ts` holds the list to {@link AI_SITE_SUBMISSIONS}.\n */\nexport const AI_SITE_SUBMISSION_CHOICES: ReadonlyArray<{\n  id: AiSiteSubmissions\n  label: string\n  blurb: string\n}> = [\n  {\n    id: 'inbox',\n    label: 'The Inbox',\n    blurb: 'Every message is one to read and reply to.',\n  },\n  {\n    id: 'lead',\n    label: 'The Inbox, and CRM as a lead',\n    blurb: 'Every message with an email address is also somebody to follow up.',\n  },\n]\n\n/**\n * Which kind of email a scaffold's email unit is (AGL-2918), carried on the\n * derived job as `inputs.emailType`. The email step names the kind on the one\n * line it puts above the brief, and a scaffold was naming none.\n *\n * A key of the email step's own `AI_EMAIL_TYPES`, held here because neither\n * step may import the other: a scaffold delegates by job kind, and a\n * deployment that scaffolds is not necessarily one that has loaded the email\n * step. `ai-job-email-step.spec.ts` holds this key to that catalog.\n *\n * `reply` and not `welcome`. The five kinds a member picks are campaigns\n * somebody sends to an audience, and this is an answer to one person who\n * wrote in through the site; the nearest, `welcome`, is a label about signing\n * up, and a kind that misdescribes the email is worse than an absent one\n * because it is the first thing the model is told.\n */\nexport const AI_SITE_EMAIL_TYPE = 'reply'\n\n/**\n * What a site job's plan and every unit it builds are told about the\n * business's name (AGL-3596): that it is the name, used as written. Said on\n * the job's own turn, never in a cached system block, because it is one\n * site's. A model handed only what the business does named it itself —\n * \"Hillside Dog Grooming\" was built as \"Austin Paws Grooming\".\n */\nexport function aiSiteNameSentence(name: string): string {\n  return `The business is named “${name}”: the site names it exactly that way, in the header, the footer, the copy and the search listing, and never by any other name.`\n}\n\n/** Where a job's inputs say submissions go, or `null` where they do not say. */\nexport function aiSiteSubmissions(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteSubmissions | null {\n  const value = inputs?.['submissions']\n  return (AI_SITE_SUBMISSIONS as readonly unknown[]).includes(value)\n    ? (value as AiSiteSubmissions)\n    : null\n}\n\nconst ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/\n\n/** A scaffold's inputs, or the sentence the door refuses them with. */\nexport function parseAiSiteJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteJobInputs | string {\n  const text = (key: string): string | null => {\n    const value = inputs?.[key]\n    if (value === undefined || value === null || value === '') return ''\n    if (typeof value !== 'string') return null\n    const trimmed = value.trim()\n    return trimmed.length > AI_SITE_INPUT_MAX_CHARS ? null : trimmed\n  }\n  const businessType = text('businessType')\n  if (businessType === null) {\n    return `businessType must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`\n  }\n  if (!businessType) return 'Say what kind of business the site is for'\n  const businessName = text('businessName')\n  const city = text('city')\n  const brand = text('brand')\n  const audience = text('audience')\n  const starter = text('starter')\n  // A kind this deployment does not know is nobody having picked one.\n  const siteKind = aiSiteKind(inputs?.['siteKind'])?.id ?? ''\n  for (const [key, value] of [\n    ['businessName', businessName],\n    ['city', city],\n    ['brand', brand],\n    ['audience', audience],\n    ['starter', starter],\n  ] as const) {\n    if (value === null)\n      return `${key} must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`\n  }\n  const rawPages = inputs?.['pages']\n  const pages =\n    typeof rawPages === 'number' ? rawPages : Number(rawPages ?? NaN)\n  // Read here across both bands; the door holds a workspace to its own\n  // (`aiSitePagesRefusal`), since only it knows the workspace's plan.\n  if (\n    !Number.isInteger(pages) ||\n    pages < AI_SITE_FREE_PAGES.min ||\n    pages > AI_SITE_PAGES.max\n  ) {\n    return `pages must be a whole number from ${AI_SITE_FREE_PAGES.min} to ${AI_SITE_PAGES.max}`\n  }\n  // Where submissions go is admitted only as one of the two the form step\n  // can actually bind; anything else is nobody having said, and the model\n  // proposes as it always did rather than the door refusing the whole job.\n  const submissions = aiSiteSubmissions(inputs)\n  const rawBatch = inputs?.['batchId']\n  const batchId =\n    rawBatch === undefined || rawBatch === null || rawBatch === ''\n      ? null\n      : typeof rawBatch === 'string' && ID_CHARS.test(rawBatch)\n        ? rawBatch\n        : undefined\n  if (batchId === undefined) return 'batchId is not a batch id'\n  return {\n    businessType,\n    audience: audience as string,\n    starter: starter as string,\n    siteKind,\n    pages,\n    businessName: businessName as string,\n    city: city as string,\n    brand: brand as string,\n    welcomeEmail: inputs?.['welcomeEmail'] !== false,\n    submissions,\n    batchId,\n  }\n}\n\n/**\n * Why a workspace cannot ask for this many pages (AGL-3594), in a sentence a\n * member reads; `null` when it can. A Free workspace builds one or two, and a\n * paid one four to eight, as it always has. Refused rather than clamped: the\n * guided start offers only the band, so a request outside it was not made\n * there, and a job quietly building fewer pages than it was asked for is a\n * worse answer than a sentence saying why.\n */\nexport function aiSitePagesRefusal(pages: number, freeTaste: boolean | null | undefined): string | null {\n  const band = aiSitePagesBand(freeTaste)\n  if (pages >= band.min && pages <= band.max) return null\n  return freeTaste\n    ? `A Free workspace's AI site start builds ${AI_SITE_FREE_PAGES.min} or ${AI_SITE_FREE_PAGES.max} pages. ${AI_SITE_FREE_PAGES_NOTE}`\n    : `A site is planned with ${band.min} to ${band.max} pages.`\n}\n\n/**\n * What the site itself is, as a step that is NOT the scaffold reads it off a\n * job's inputs (AGL-2918).\n *\n * A scaffold delegates unit by unit under a job derived from its own — a page\n * job, a form job — and the derived job carries the scaffold's inputs. So the\n * two answers that describe the site rather than one record of it are\n * readable by every delegated step, and a step that wants them does not have\n * to know it was delegated to.\n *\n * Lenient where {@link parseAiSiteJobInputs} is strict, because it reads the\n * inputs of jobs that are not scaffolds: a page job started from the Screens\n * page has no `businessType` and no `pages`, and that is not an error here —\n * it is a site nobody described, and the answer is two empty strings.\n */\nexport interface AiSiteWords {\n  /** What kind of site it is; empty when the job's inputs do not say. */\n  about: string\n  /** Who it is for; empty when the job's inputs do not say. */\n  audience: string\n}\n\n/** Whether either half of {@link AiSiteWords} says anything. */\nexport function aiSiteWordsSaidAnything(words: AiSiteWords): boolean {\n  return Boolean(words.about || words.audience)\n}\n\n/** What a job's inputs say the site is, read defensively and trimmed to the input ceiling. */\nexport function aiSiteWords(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteWords {\n  const read = (key: string): string => {\n    const value = inputs?.[key]\n    if (typeof value !== 'string') return ''\n    return value.replace(/\\s+/g, ' ').trim().slice(0, AI_SITE_INPUT_MAX_CHARS).trim()\n  }\n  return { about: read('businessType'), audience: read('audience') }\n}\n\n/**\n * What a scaffold builds for itself: the layout its pages render inside, the\n * form they place, and the palette suggestion a member applies in the Theme\n * section. Anything else a plan asks to create is a job of its own.\n */\nexport const AI_SITE_CREATE_KINDS: readonly AiBuildPlanCreateKind[] = [\n  'layout',\n  'form',\n  'theme-change',\n]\n\n/** The creations a scaffold cannot build, in the order the plan lists them, each named once. */\nexport function aiSitePlanPrerequisites(\n  plan: AiBuildPlan,\n): Array<{ kind: AiBuildPlanCreateKind; name: string }> {\n  const seen = new Set<string>()\n  const prerequisites: Array<{ kind: AiBuildPlanCreateKind; name: string }> = []\n  const add = (kind: AiBuildPlanCreateKind, name: string) => {\n    const key = `${kind}:${name.toLowerCase()}`\n    if (seen.has(key)) return\n    seen.add(key)\n    prerequisites.push({ kind, name })\n  }\n  for (const entry of plan.create) {\n    if (!AI_SITE_CREATE_KINDS.includes(entry.kind)) add(entry.kind, entry.name)\n  }\n  // A reference the create list does not carry is refused by the plan rules\n  // before a plan is kept: rule 2 for a screen's layout, rule 7 for anything\n  // else (`plan-creation-undeclared`, AGL-3040). A plan confirmed before that\n  // rule existed can still carry one. It is named as a component: the\n  // reference carries no kind, and the refusal must say where one is made.\n  for (const { name } of aiPlanUndeclaredRefs(plan)) add('component', name)\n  return prerequisites\n}\n\n/**\n * Why a scaffold cannot build a plan of this SHAPE — the page band, a page's\n * sections, its addresses, its navigation — in a sentence a member reads;\n * `null` when the shape is one it builds. The plan step holds a plan to it\n * with a re-ask (AGL-3030), and the doors hold a confirmed plan to it again\n * through `aiSitePlanRefusal`.\n */\nexport function aiSitePlanShapeRefusal(\n  plan: AiBuildPlan,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  const { screens } = plan\n  const band = aiSitePagesBand(options.freeTaste)\n  if (screens.length < band.min || screens.length > band.max) {\n    return `This plan builds ${screens.length} ${screens.length === 1 ? 'page' : 'pages'}, and ${\n      options.freeTaste ? \"a Free workspace's site scaffold\" : 'a site scaffold'\n    } builds ${band.min} to ${band.max}. Describe the site again.`\n  }\n  const slugs = new Set<string>()\n  for (const screen of screens) {\n    if (!screen.sections.length) {\n      return `The page “${screen.title}” has no sections to build. Describe the site again.`\n    }\n    if (screen.sections.length > AI_SITE_MAX_SECTIONS) {\n      return `The page “${screen.title}” has ${screen.sections.length} sections, and a scaffolded page holds ${AI_SITE_MAX_SECTIONS}. Describe the site again.`\n    }\n    const slug = screen.slug.trim().toLowerCase()\n    if (slugs.has(slug)) {\n      return `Two pages in this plan share the address ${screen.slug}. Describe the site again.`\n    }\n    slugs.add(slug)\n  }\n  if (!screens.some((screen) => screen.nav)) {\n    return 'No page in this plan is in the site navigation. Describe the site again.'\n  }\n  return null\n}\n\n/**\n * Why a scaffold cannot build this plan, in a sentence a member reads when\n * confirming it; `null` when it can.\n */\nexport function aiSitePlanRefusal(\n  plan: AiBuildPlan,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  const shape = aiSitePlanShapeRefusal(plan, options)\n  if (shape) return shape\n  const prerequisites = aiSitePlanPrerequisites(plan)\n  if (!prerequisites.length) return null\n  const parts = prerequisites.map(\n    ({ kind, name }) =>\n      `the ${AI_BUILD_PLAN_CREATION_NOUNS[kind].noun} “${name}” ${AI_BUILD_PLAN_CREATION_NOUNS[kind].where}`,\n  )\n  const listed =\n    parts.length === 1\n      ? parts[0]\n      : `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`\n  return `This site needs what the workspace does not have yet. Create ${listed}, then describe the site again.`\n}\n\n/** What the estimate counts a plan in: whether a welcome email follows, and the creations the job builds. */\nexport interface AiPlanPassOptions {\n  welcomeEmail?: boolean\n  /** The creation kinds the job builds itself; a scaffold's when absent. */\n  creates?: readonly AiBuildPlanCreateKind[]\n}\n\n/**\n * The passes a plan implies: one per section of every screen, one more per\n * screen for its search listing and its draft, and one for each thing the\n * plan creates that the job builds. What the estimate is counted in.\n */\nexport function aiPlanPasses(plan: AiBuildPlan, options: AiPlanPassOptions = {}): number {\n  const screens = plan.screens.reduce(\n    (total, screen) => total + screen.sections.length + 1,\n    0,\n  )\n  const creates = options.creates ?? AI_SITE_CREATE_KINDS\n  const creations = plan.create.filter((entry) => creates.includes(entry.kind)).length\n  return screens + creations + (options.welcomeEmail ? 1 : 0)\n}\n\n/**\n * About what a plan costs to build, in credits. An ESTIMATE: the nominal\n * credits the machine holds per step, times the passes the plan implies.\n * What each pass actually costs is its model's tokens, recorded on the job\n * as it runs.\n */\nexport function aiPlanCreditEstimate(plan: AiBuildPlan, options: AiPlanPassOptions = {}): number {\n  return aiPlanPasses(plan, options) * AI_SITE_PASS_CREDITS\n}\n\n/**\n * About what a job of this kind costs to build from its plan (AGL-3031): a\n * page job counts the layout, forms and components it builds before its\n * page; a template, layout, component, form or email job counts its own\n * record and every creation it builds before it (AGL-3143 §15); and a\n * scaffold counts what it builds. The figure the proposal shows beside\n * Confirm, and the hold a confirmation takes.\n */\nexport function aiJobPlanCreditEstimate(kind: string, plan: AiBuildPlan): number {\n  const creates =\n    kind === 'page' ? AI_PAGE_CREATE_KINDS : AI_JOB_CREATE_KINDS[kind as keyof typeof AI_JOB_CREATE_KINDS]\n  return aiPlanCreditEstimate(plan, creates ? { creates } : {})\n}\n\n/**\n * About what a scaffold of this many pages costs, before a plan names its\n * sections: the same arithmetic on the nominal section count, plus the plan\n * step that proposes it. Shown where a member asks for a scaffold.\n */\nexport function aiSiteCreditEstimate(\n  pages: number,\n  options: { welcomeEmail?: boolean } = {},\n): number {\n  const screens = Math.max(0, Math.floor(pages))\n  const passes =\n    1 +\n    screens * (AI_SITE_NOMINAL_SECTIONS + 1) +\n    2 +\n    (options.welcomeEmail ? 1 : 0)\n  return passes * AI_SITE_PASS_CREDITS\n}\n"],"names":["aiSiteKind","AI_BUILD_PLAN_CREATION_NOUNS","aiPlanUndeclaredRefs","AI_JOB_CREATE_KINDS","AI_PAGE_CREATE_KINDS","AI_SITE_PAGES","min","max","AI_SITE_FREE_PAGES","aiSitePagesBand","freeTaste","AI_JOB_AUTO_CONFIRM_INPUT","AI_SITE_FREE_PAGES_NOTE","AI_SITE_PLAN_MAX_TOKENS","free","paid","AI_FREE_SITE_WORST_CASE_CREDITS","plan","look","layout","firstSection","laterSection","listing","aiFreeSiteSectionsWithin","creations","taste","credits","pages","Math","floor","before","layouts","AI_FREE_SITE_NOMINAL_SECTIONS","aiFreeSiteCreditEstimate","count","AI_SITE_MAX_SECTIONS","AI_SITE_NOMINAL_SECTIONS","AI_SITE_PASS_CREDITS","AI_SITE_INPUT_MAX_CHARS","AI_SITE_BATCH_MAX","AI_SITE_BATCH_MIN_HOST_LIMIT","AI_SITE_SUBMISSIONS","AI_SITE_SUBMISSION_CHOICES","id","label","blurb","AI_SITE_EMAIL_TYPE","aiSiteNameSentence","name","aiSiteSubmissions","inputs","value","includes","ID_CHARS","parseAiSiteJobInputs","text","key","undefined","trimmed","trim","length","businessType","businessName","city","brand","audience","starter","siteKind","rawPages","Number","NaN","isInteger","submissions","rawBatch","batchId","test","welcomeEmail","aiSitePagesRefusal","band","aiSiteWordsSaidAnything","words","Boolean","about","aiSiteWords","read","replace","slice","AI_SITE_CREATE_KINDS","aiSitePlanPrerequisites","seen","Set","prerequisites","add","kind","toLowerCase","has","push","entry","create","aiSitePlanShapeRefusal","options","screens","slugs","screen","sections","title","slug","some","nav","aiSitePlanRefusal","shape","parts","map","noun","where","listed","join","aiPlanPasses","reduce","total","creates","filter","aiPlanCreditEstimate","aiJobPlanCreditEstimate","aiSiteCreditEstimate","passes"],"mappings":"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"}

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

@@ -0,0 +1,164 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The kinds of website a guided start offers (AGL-3660), and the style
+ * direction each one sets.
+ *
+ * A kind is NOT a template. It is a direction in two halves:
+ *
+ *  - a LOOK FAMILY the code applies — how saturated the palette is, the hues
+ *    that suit the kind, the page grounds, the font pairings, the corners,
+ *    the button style, the heading scale and the density — inside which the
+ *    model picks this business's own look and a per-job seed varies it
+ *    (`ai-site-look.ts`), so two sites of one kind never share a theme;
+ *  - GUIDANCE the model reads: how the kind's pages are usually arranged
+ *    (band rhythm, image share, density) and which pages it usually has.
+ *
+ * Every page a kind suggests is one the site job builds itself out of the
+ * layout language: sections, cards, images, a form. On a paid plan the site
+ * job also writes a blog's first posts into a content collection and a
+ * store's first products as unpriced drafts (AGL-3676,
+ * `jobs/ai-job-site-content.ts`), and the pages are told their titles; on
+ * the Free taste it writes neither. No event records are created, and no
+ * guidance here promises posts, products or events, since the plan reads it
+ * on every plan (the owner adds more from the Content, Commerce and Events
+ * sections afterward).
+ *
+ * Pure data and two small readers, safe for the console to import: no
+ * theme compiler, no network.
+ */
+/** A font pairing the look may choose: a heading family over a body family. */
+export interface AiSiteFontPairing {
+    id: string;
+    /** What the pairing reads like, as the model is told. */
+    feel: string;
+    heading: {
+        family: string;
+        category: 'sans-serif' | 'serif';
+        weight: number;
+        sub: number;
+    };
+    body: {
+        family: string;
+        category: 'sans-serif' | 'serif';
+        weights: number[];
+    };
+    /** Letter spacing the headings carry, in em. */
+    tracking?: number;
+    /** Headings set in capitals: a condensed display face. */
+    caps?: boolean;
+}
+/**
+ * The pairings, every family from the Google Fonts catalog the fonts plugin
+ * serves (`google-fonts.catalog.json`) and every weight one that family
+ * has — `ai-site-look.spec.ts` holds both. The tenant loads them the way it
+ * loads the starter theme's family, so nothing here adds a font host.
+ */
+export declare const AI_SITE_FONT_PAIRINGS: readonly AiSiteFontPairing[];
+export type AiSiteFontPairingId = string;
+/**
+ * The platform's built-in themes a site's look is layered on, by the short
+ * name of the themes plugin's preset id (\`theme-presets.<name>\`), and
+ * \`starter\`: the theme a new site is born with (AGL-3497).
+ */
+export declare const AI_SITE_BASES: readonly ["starter", "material-ui", "bootstrap", "minimal", "material3", "ant-design", "fluent", "carbon", "cupertino"];
+export type AiSiteBase = (typeof AI_SITE_BASES)[number];
+/** How saturated a kind's palette runs. `neutral` is an ink-and-paper ground with one accent. */
+export type AiSiteChroma = 'neutral' | 'muted' | 'balanced' | 'vivid';
+/** The page ground the light scheme sits on. */
+export type AiSiteGround = 'white' | 'warm' | 'cool' | 'tinted';
+export declare const AI_SITE_GROUNDS: readonly AiSiteGround[];
+/** Corner rounding, cards and fields. */
+export type AiSiteCorners = 'sharp' | 'soft' | 'round' | 'pill';
+export declare const AI_SITE_CORNERS: readonly AiSiteCorners[];
+/** How buttons are drawn: on the corner radius, as pills, square, in capitals, or with quiet buttons as underlined links. */
+export type AiSiteButtons = 'rounded' | 'pill' | 'square' | 'caps' | 'link';
+/**
+ * How a site's pages alternate their bands: calm (mostly plain, one soft),
+ * alternating (plain and soft by turns), or bold (brand and dark bands for
+ * its key moments).
+ */
+export type AiSiteRhythm = 'calm' | 'alternating' | 'bold';
+export declare const AI_SITE_RHYTHMS: readonly AiSiteRhythm[];
+/** Spacing: tighter, regular or airier than the platform's unit. */
+export type AiSiteDensity = 'compact' | 'regular' | 'airy';
+/** What the code applies for a kind: the bounds a look is chosen and varied in. */
+export interface AiSiteLookFamily {
+    /** The platform's base themes that suit the kind, best first (`AI_SITE_BASES`). */
+    bases: readonly AiSiteBase[];
+    chroma: AiSiteChroma;
+    /** How the header is arranged: the brand at the start with the links after it, or both centered. */
+    headerAligns?: readonly ('start' | 'center')[];
+    /** The band rhythm its pages lean to (`AI_SITE_RHYTHMS`). */
+    rhythms?: readonly AiSiteRhythm[];
+    /** Hue ranges in degrees that suit the kind, `[from, to]`, wrapping past 360. */
+    hues: ReadonlyArray<readonly [number, number]>;
+    grounds: readonly AiSiteGround[];
+    fonts: readonly AiSiteFontPairingId[];
+    corners: readonly AiSiteCorners[];
+    buttons: AiSiteButtons;
+    /** Display and heading sizes against the platform's, 1 = as shipped. */
+    headingScale: number;
+    density: AiSiteDensity;
+}
+export interface AiSiteKind {
+    /** A persisted identifier: the guided start's answer and the job's `siteKind` input. */
+    id: string;
+    /** The card's title, in customer copy. */
+    label: string;
+    /** One line under it. */
+    blurb: string;
+    /** A word from the icon set the card shows. */
+    icon: string;
+    /** Words in "what kind of site" that suggest this kind, matched whole. */
+    keywords: readonly string[];
+    /** The starter whose shape this kind follows, where one fits (`STARTER_TEMPLATES`). */
+    starter: string;
+    look: AiSiteLookFamily;
+    /** How its pages are arranged, as every page and the header and footer are told. */
+    design: string;
+    /** The pages it usually has, as the plan is told. */
+    pages: string;
+}
+/**
+ * The kinds, in the order the guided start shows them. Drawn from the template
+ * categories the large site builders offer, merged where two would build the
+ * same site: designer and agency are one studio, law and accounting one
+ * practice, health and therapy one wellness kind.
+ */
+export declare const AI_SITE_KINDS: readonly AiSiteKind[];
+/** A kind by id, or `null`. */
+export declare function aiSiteKind(id: unknown): AiSiteKind | null;
+/** A pairing by id, or `null`. */
+export declare function aiSiteFontPairing(id: unknown): AiSiteFontPairing | null;
+/**
+ * The kind a "what kind of site" answer suggests, or `business` when nothing
+ * in it matches: the card the guided start selects until the person picks
+ * another. A longer keyword wins over a shorter one ("wedding photographer"
+ * is photography, not events), and of two as long the later one wins, since
+ * English puts the noun last ("a food blog" is a blog).
+ */
+export declare function aiSiteKindFor(siteType: string): AiSiteKind;
+/** The kind a job's inputs name, else the one its business type suggests; `null` for a job that names neither. */
+export declare function aiSiteKindOfInputs(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteKind | null;
+/** The site's own look tokens a unit is handed (AGL-3660), read defensively. */
+export declare function aiSiteStyleTokens(inputs: Readonly<Record<string, unknown>> | null | undefined): {
+    headerAlign?: 'start' | 'center';
+    rhythm?: AiSiteRhythm;
+};
+/** The style lines a page, the header and the footer are told for the job's kind and look; empty for none. */
+export declare function aiSiteKindDesignLines(inputs: Readonly<Record<string, unknown>> | null | undefined): string[];