@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,314 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { AI_BUILD_PLAN_CREATION_NOUNS, aiPlanUndeclaredRefs } from "./ai-build-plan.js";
+import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
+/**
+ * What a site scaffold is (AGL-2911): the inputs a `site` job is admitted
+ * with, the plans a scaffold can build, and what one is estimated to cost
+ * before it starts.
+ *
+ * A scaffold is the one job kind that builds a whole site rather than one
+ * record: a plan of four to eight screens, the layout they render inside,
+ * the contact form they place, a palette suggestion, and — where the email
+ * step is loaded — a welcome email. It builds each of those through the job
+ * kind that already owns it, so this module describes what a scaffold may
+ * ask for and refuses the rest at confirmation, before a credit is spent,
+ * naming what to make first.
+ *
+ * ── The estimate is the guard rail ───────────────────────────────────────
+ *
+ * A scaffold is tens of model calls, where every other kind is a few, so the
+ * member reads what it will cost before they confirm the plan that spends
+ * it. The figure is the machine's own nominal credits per step multiplied by
+ * the passes the plan implies — an estimate, and said to be one wherever it
+ * is shown.
+ *
+ * This module imports nothing at runtime, so the doors, the step, the batch
+ * card and the plan proposal read one vocabulary.
+ */ /** How many pages a scaffold builds: enough to be a site, few enough to read. */ export const AI_SITE_PAGES = {
+    min: 4,
+    max: 8
+};
+/**
+ * The most sections one scaffolded page may hold. The plan model allows more
+ * for a page job, which builds one page; a scaffold builds eight, and each
+ * section is a pass of its own.
+ */ export const AI_SITE_MAX_SECTIONS = 8;
+/**
+ * Sections a page is assumed to hold before a plan names them, for the
+ * estimate a member reads when they ask for a scaffold. A declared
+ * assumption, not a measurement: the plan's own section counts replace it
+ * the moment the plan exists.
+ */ export const AI_SITE_NOMINAL_SECTIONS = 5;
+/**
+ * The credits one pass is held against: the machine's
+ * `AI_JOB_STEP_RESERVE_CREDITS`, declared here so the estimate stays a pure
+ * number the console computes without the Admin SDK. `ai-site-job.spec.ts`
+ * holds the two equal.
+ */ export const AI_SITE_PASS_CREDITS = 50;
+/** The longest a scaffold's scalar inputs may run; they are names, not copy. */ export const AI_SITE_INPUT_MAX_CHARS = 120;
+/** The sites one agency batch may generate for in one request. */ export const AI_SITE_BATCH_MAX = 25;
+/**
+ * The sites a plan must hold before the org Sites page offers the batch at
+ * all: the Agency and Advanced bands, which the plan's `hostLimit` is what
+ * distinguishes.
+ */ export const AI_SITE_BATCH_MIN_HOST_LIMIT = 25;
+/**
+ * Where a site's contact form sends what a visitor writes.
+ *
+ * Two, not three. The form step's own vocabulary has a third — a mailing
+ * list — which it can only answer with a note, because the stored routing has
+ * no place for a list; offering it as a question would be asking somebody to
+ * pick an outcome the platform then explains it cannot store.
+ */ export const AI_SITE_SUBMISSIONS = [
+    'inbox',
+    'lead'
+];
+/**
+ * What each answer to "where do submissions go" is called, and what it means.
+ *
+ * Here rather than beside the guided start's own questions, because it is not
+ * only the guided start that asks: the agency batch asks the same thing of a
+ * whole run (AGL-2918), and two surfaces wording one decision two ways is two
+ * decisions. `ai-site-job.spec.ts` holds the list to {@link AI_SITE_SUBMISSIONS}.
+ */ export const AI_SITE_SUBMISSION_CHOICES = [
+    {
+        id: 'inbox',
+        label: 'The Inbox',
+        blurb: 'Every message is one to read and reply to.'
+    },
+    {
+        id: 'lead',
+        label: 'The Inbox, and CRM as a lead',
+        blurb: 'Every message with an email address is also somebody to follow up.'
+    }
+];
+/**
+ * Which kind of email a scaffold's email unit is (AGL-2918), carried on the
+ * derived job as `inputs.emailType`. The email step names the kind on the one
+ * line it puts above the brief, and a scaffold was naming none.
+ *
+ * A key of the email step's own `AI_EMAIL_TYPES`, held here because neither
+ * step may import the other: a scaffold delegates by job kind, and a
+ * deployment that scaffolds is not necessarily one that has loaded the email
+ * step. `ai-job-email-step.spec.ts` holds this key to that catalog.
+ *
+ * `reply` and not `welcome`. The five kinds a member picks are campaigns
+ * somebody sends to an audience, and this is an answer to one person who
+ * wrote in through the site; the nearest, `welcome`, is a label about signing
+ * up, and a kind that misdescribes the email is worse than an absent one
+ * because it is the first thing the model is told.
+ */ export const AI_SITE_EMAIL_TYPE = 'reply';
+/** Where a job's inputs say submissions go, or `null` where they do not say. */ export function aiSiteSubmissions(inputs) {
+    const value = inputs == null ? void 0 : inputs['submissions'];
+    return AI_SITE_SUBMISSIONS.includes(value) ? value : null;
+}
+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) {
+    const text = (key)=>{
+        const value = inputs == null ? void 0 : inputs[key];
+        if (value === undefined || value === null || value === '') return '';
+        if (typeof value !== 'string') return null;
+        const trimmed = value.trim();
+        return trimmed.length > AI_SITE_INPUT_MAX_CHARS ? null : trimmed;
+    };
+    const businessType = text('businessType');
+    if (businessType === null) {
+        return `businessType must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`;
+    }
+    if (!businessType) return 'Say what kind of business the site is for';
+    const businessName = text('businessName');
+    const city = text('city');
+    const brand = text('brand');
+    const audience = text('audience');
+    const starter = text('starter');
+    for (const [key, value] of [
+        [
+            'businessName',
+            businessName
+        ],
+        [
+            'city',
+            city
+        ],
+        [
+            'brand',
+            brand
+        ],
+        [
+            'audience',
+            audience
+        ],
+        [
+            'starter',
+            starter
+        ]
+    ]){
+        if (value === null) return `${key} must be text under ${AI_SITE_INPUT_MAX_CHARS} characters`;
+    }
+    const rawPages = inputs == null ? void 0 : inputs['pages'];
+    const pages = typeof rawPages === 'number' ? rawPages : Number(rawPages != null ? rawPages : NaN);
+    if (!Number.isInteger(pages) || pages < AI_SITE_PAGES.min || pages > AI_SITE_PAGES.max) {
+        return `pages must be a whole number from ${AI_SITE_PAGES.min} to ${AI_SITE_PAGES.max}`;
+    }
+    // Where submissions go is admitted only as one of the two the form step
+    // can actually bind; anything else is nobody having said, and the model
+    // proposes as it always did rather than the door refusing the whole job.
+    const submissions = aiSiteSubmissions(inputs);
+    const rawBatch = inputs == null ? void 0 : inputs['batchId'];
+    const batchId = rawBatch === undefined || rawBatch === null || rawBatch === '' ? null : typeof rawBatch === 'string' && ID_CHARS.test(rawBatch) ? rawBatch : undefined;
+    if (batchId === undefined) return 'batchId is not a batch id';
+    return {
+        businessType,
+        audience: audience,
+        starter: starter,
+        pages,
+        businessName: businessName,
+        city: city,
+        brand: brand,
+        welcomeEmail: (inputs == null ? void 0 : inputs['welcomeEmail']) !== false,
+        submissions,
+        batchId
+    };
+}
+/** Whether either half of {@link AiSiteWords} says anything. */ export function aiSiteWordsSaidAnything(words) {
+    return Boolean(words.about || words.audience);
+}
+/** What a job's inputs say the site is, read defensively and trimmed to the input ceiling. */ export function aiSiteWords(inputs) {
+    const read = (key)=>{
+        const value = inputs == null ? void 0 : inputs[key];
+        if (typeof value !== 'string') return '';
+        return value.replace(/\s+/g, ' ').trim().slice(0, AI_SITE_INPUT_MAX_CHARS).trim();
+    };
+    return {
+        about: read('businessType'),
+        audience: read('audience')
+    };
+}
+/**
+ * What a scaffold builds for itself: the layout its pages render inside, the
+ * form they place, and the palette suggestion a member applies in the Theme
+ * section. Anything else a plan asks to create is a job of its own.
+ */ export const AI_SITE_CREATE_KINDS = [
+    'layout',
+    'form',
+    'theme-change'
+];
+/** The creations a scaffold cannot build, in the order the plan lists them, each named once. */ export function aiSitePlanPrerequisites(plan) {
+    const seen = new Set();
+    const prerequisites = [];
+    const add = (kind, name)=>{
+        const key = `${kind}:${name.toLowerCase()}`;
+        if (seen.has(key)) return;
+        seen.add(key);
+        prerequisites.push({
+            kind,
+            name
+        });
+    };
+    for (const entry of plan.create){
+        if (!AI_SITE_CREATE_KINDS.includes(entry.kind)) add(entry.kind, entry.name);
+    }
+    // A reference the create list does not carry is refused by the plan rules
+    // before a plan is kept: rule 2 for a screen's layout, rule 7 for anything
+    // else (`plan-creation-undeclared`, AGL-3040). A plan confirmed before that
+    // rule existed can still carry one. It is named as a component: the
+    // reference carries no kind, and the refusal must say where one is made.
+    for (const { name } of aiPlanUndeclaredRefs(plan))add('component', name);
+    return prerequisites;
+}
+/**
+ * Why a scaffold cannot build a plan of this SHAPE — the page band, a page's
+ * sections, its addresses, its navigation — in a sentence a member reads;
+ * `null` when the shape is one it builds. The plan step holds a plan to it
+ * with a re-ask (AGL-3030), and the doors hold a confirmed plan to it again
+ * through `aiSitePlanRefusal`.
+ */ export function aiSitePlanShapeRefusal(plan) {
+    const { screens } = plan;
+    if (screens.length < AI_SITE_PAGES.min || screens.length > AI_SITE_PAGES.max) {
+        return `This plan builds ${screens.length} ${screens.length === 1 ? 'page' : 'pages'}, and a site scaffold builds ${AI_SITE_PAGES.min} to ${AI_SITE_PAGES.max}. Describe the site again.`;
+    }
+    const slugs = new Set();
+    for (const screen of screens){
+        if (!screen.sections.length) {
+            return `The page “${screen.title}” has no sections to build. Describe the site again.`;
+        }
+        if (screen.sections.length > AI_SITE_MAX_SECTIONS) {
+            return `The page “${screen.title}” has ${screen.sections.length} sections, and a scaffolded page holds ${AI_SITE_MAX_SECTIONS}. Describe the site again.`;
+        }
+        const slug = screen.slug.trim().toLowerCase();
+        if (slugs.has(slug)) {
+            return `Two pages in this plan share the address ${screen.slug}. Describe the site again.`;
+        }
+        slugs.add(slug);
+    }
+    if (!screens.some((screen)=>screen.nav)) {
+        return 'No page in this plan is in the site navigation. Describe the site again.';
+    }
+    return null;
+}
+/**
+ * Why a scaffold cannot build this plan, in a sentence a member reads when
+ * confirming it; `null` when it can.
+ */ export function aiSitePlanRefusal(plan) {
+    const shape = aiSitePlanShapeRefusal(plan);
+    if (shape) return shape;
+    const prerequisites = aiSitePlanPrerequisites(plan);
+    if (!prerequisites.length) return null;
+    const parts = prerequisites.map(({ kind, name })=>`the ${AI_BUILD_PLAN_CREATION_NOUNS[kind].noun} “${name}” ${AI_BUILD_PLAN_CREATION_NOUNS[kind].where}`);
+    const listed = parts.length === 1 ? parts[0] : `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;
+    return `This site needs what the workspace does not have yet. Create ${listed}, then describe the site again.`;
+}
+/**
+ * The passes a plan implies: one per section of every screen, one more per
+ * screen for its search listing and its draft, and one for each thing the
+ * plan creates that the job builds. What the estimate is counted in.
+ */ export function aiPlanPasses(plan, options = {}) {
+    var _options_creates;
+    const screens = plan.screens.reduce((total, screen)=>total + screen.sections.length + 1, 0);
+    const creates = (_options_creates = options.creates) != null ? _options_creates : AI_SITE_CREATE_KINDS;
+    const creations = plan.create.filter((entry)=>creates.includes(entry.kind)).length;
+    return screens + creations + (options.welcomeEmail ? 1 : 0);
+}
+/**
+ * About what a plan costs to build, in credits. An ESTIMATE: the nominal
+ * credits the machine holds per step, times the passes the plan implies.
+ * What each pass actually costs is its model's tokens, recorded on the job
+ * as it runs.
+ */ export function aiPlanCreditEstimate(plan, options = {}) {
+    return aiPlanPasses(plan, options) * AI_SITE_PASS_CREDITS;
+}
+/**
+ * About what a job of this kind costs to build from its plan (AGL-3031): a
+ * page job counts the layout, forms and components it builds before its
+ * page, and every other kind counts what a scaffold would. The figure the
+ * proposal shows beside Confirm, and the hold a confirmation takes.
+ */ export function aiJobPlanCreditEstimate(kind, plan) {
+    return aiPlanCreditEstimate(plan, kind === 'page' ? {
+        creates: AI_PAGE_CREATE_KINDS
+    } : {});
+}
+/**
+ * About what a scaffold of this many pages costs, before a plan names its
+ * sections: the same arithmetic on the nominal section count, plus the plan
+ * step that proposes it. Shown where a member asks for a scaffold.
+ */ export function aiSiteCreditEstimate(pages, options = {}) {
+    const screens = Math.max(0, Math.floor(pages));
+    const passes = 1 + screens * (AI_SITE_NOMINAL_SECTIONS + 1) + 2 + (options.welcomeEmail ? 1 : 0);
+    return passes * AI_SITE_PASS_CREDITS;
+}
+
+//# sourceMappingURL=ai-site-job.js.map

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

@@ -0,0 +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_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 * 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/** 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  if (\n    !Number.isInteger(pages) ||\n    pages < AI_SITE_PAGES.min ||\n    pages > AI_SITE_PAGES.max\n  ) {\n    return `pages must be a whole number from ${AI_SITE_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 * 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(plan: AiBuildPlan): string | null {\n  const { screens } = plan\n  if (\n    screens.length < AI_SITE_PAGES.min ||\n    screens.length > AI_SITE_PAGES.max\n  ) {\n    return `This plan builds ${screens.length} ${screens.length === 1 ? 'page' : 'pages'}, and a site scaffold builds ${AI_SITE_PAGES.min} to ${AI_SITE_PAGES.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(plan: AiBuildPlan): string | null {\n  const shape = aiSitePlanShapeRefusal(plan)\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, and every other kind counts what a scaffold would. The figure the\n * proposal shows beside Confirm, and the hold a confirmation takes.\n */\nexport function aiJobPlanCreditEstimate(kind: string, plan: AiBuildPlan): number {\n  return aiPlanCreditEstimate(plan, kind === 'page' ? { creates: AI_PAGE_CREATE_KINDS } : {})\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_PAGE_CREATE_KINDS","AI_SITE_PAGES","min","max","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","aiSiteSubmissions","inputs","value","includes","ID_CHARS","parseAiSiteJobInputs","text","key","undefined","trimmed","trim","length","businessType","businessName","city","brand","audience","starter","rawPages","pages","Number","NaN","isInteger","submissions","rawBatch","batchId","test","welcomeEmail","aiSiteWordsSaidAnything","words","Boolean","about","aiSiteWords","read","replace","slice","AI_SITE_CREATE_KINDS","aiSitePlanPrerequisites","plan","seen","Set","prerequisites","add","kind","name","toLowerCase","has","push","entry","create","aiSitePlanShapeRefusal","screens","slugs","screen","sections","title","slug","some","nav","aiSitePlanRefusal","shape","parts","map","noun","where","listed","join","aiPlanPasses","options","reduce","total","creates","creations","filter","aiPlanCreditEstimate","aiJobPlanCreditEstimate","aiSiteCreditEstimate","Math","floor","passes"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,4BAA4B,EAC5BC,oBAAoB,QAGf,qBAAiB;AACxB,SAASC,oBAAoB,QAAQ,mBAAe;AAEpD;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GAED,+EAA+E,GAC/E,OAAO,MAAMC,gBAAgB;IAAEC,KAAK;IAAGC,KAAK;AAAE,EAAU;AAExD;;;;CAIC,GACD,OAAO,MAAMC,uBAAuB,EAAC;AAErC;;;;;CAKC,GACD,OAAO,MAAMC,2BAA2B,EAAC;AAEzC;;;;;CAKC,GACD,OAAO,MAAMC,uBAAuB,GAAE;AAEtC,8EAA8E,GAC9E,OAAO,MAAMC,0BAA0B,IAAG;AAE1C,gEAAgE,GAChE,OAAO,MAAMC,oBAAoB,GAAE;AAEnC;;;;CAIC,GACD,OAAO,MAAMC,+BAA+B,GAAE;AA+C9C;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsB;IAAC;IAAS;CAAO,CAAS;AAI7D;;;;;;;CAOC,GACD,OAAO,MAAMC,6BAIR;IACH;QACEC,IAAI;QACJC,OAAO;QACPC,OAAO;IACT;IACA;QACEF,IAAI;QACJC,OAAO;QACPC,OAAO;IACT;CACD,CAAA;AAED;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMC,qBAAqB,QAAO;AAEzC,8EAA8E,GAC9E,OAAO,SAASC,kBACdC,MAA4D;IAE5D,MAAMC,QAAQD,0BAAAA,MAAQ,CAAC,cAAc;IACrC,OAAO,AAACP,oBAA2CS,QAAQ,CAACD,SACvDA,QACD;AACN;AAEA,MAAME,WAAW;AAEjB,qEAAqE,GACrE,OAAO,SAASC,qBACdJ,MAA4D;IAE5D,MAAMK,OAAO,CAACC;QACZ,MAAML,QAAQD,0BAAAA,MAAQ,CAACM,IAAI;QAC3B,IAAIL,UAAUM,aAAaN,UAAU,QAAQA,UAAU,IAAI,OAAO;QAClE,IAAI,OAAOA,UAAU,UAAU,OAAO;QACtC,MAAMO,UAAUP,MAAMQ,IAAI;QAC1B,OAAOD,QAAQE,MAAM,GAAGpB,0BAA0B,OAAOkB;IAC3D;IACA,MAAMG,eAAeN,KAAK;IAC1B,IAAIM,iBAAiB,MAAM;QACzB,OAAO,CAAC,gCAAgC,EAAErB,wBAAwB,WAAW,CAAC;IAChF;IACA,IAAI,CAACqB,cAAc,OAAO;IAC1B,MAAMC,eAAeP,KAAK;IAC1B,MAAMQ,OAAOR,KAAK;IAClB,MAAMS,QAAQT,KAAK;IACnB,MAAMU,WAAWV,KAAK;IACtB,MAAMW,UAAUX,KAAK;IACrB,KAAK,MAAM,CAACC,KAAKL,MAAM,IAAI;QACzB;YAAC;YAAgBW;SAAa;QAC9B;YAAC;YAAQC;SAAK;QACd;YAAC;YAASC;SAAM;QAChB;YAAC;YAAYC;SAAS;QACtB;YAAC;YAAWC;SAAQ;KACrB,CAAW;QACV,IAAIf,UAAU,MACZ,OAAO,GAAGK,IAAI,oBAAoB,EAAEhB,wBAAwB,WAAW,CAAC;IAC5E;IACA,MAAM2B,WAAWjB,0BAAAA,MAAQ,CAAC,QAAQ;IAClC,MAAMkB,QACJ,OAAOD,aAAa,WAAWA,WAAWE,OAAOF,mBAAAA,WAAYG;IAC/D,IACE,CAACD,OAAOE,SAAS,CAACH,UAClBA,QAAQlC,cAAcC,GAAG,IACzBiC,QAAQlC,cAAcE,GAAG,EACzB;QACA,OAAO,CAAC,kCAAkC,EAAEF,cAAcC,GAAG,CAAC,IAAI,EAAED,cAAcE,GAAG,EAAE;IACzF;IACA,wEAAwE;IACxE,wEAAwE;IACxE,yEAAyE;IACzE,MAAMoC,cAAcvB,kBAAkBC;IACtC,MAAMuB,WAAWvB,0BAAAA,MAAQ,CAAC,UAAU;IACpC,MAAMwB,UACJD,aAAahB,aAAagB,aAAa,QAAQA,aAAa,KACxD,OACA,OAAOA,aAAa,YAAYpB,SAASsB,IAAI,CAACF,YAC5CA,WACAhB;IACR,IAAIiB,YAAYjB,WAAW,OAAO;IAClC,OAAO;QACLI;QACAI,UAAUA;QACVC,SAASA;QACTE;QACAN,cAAcA;QACdC,MAAMA;QACNC,OAAOA;QACPY,cAAc1B,CAAAA,0BAAAA,MAAQ,CAAC,eAAe,MAAK;QAC3CsB;QACAE;IACF;AACF;AAwBA,8DAA8D,GAC9D,OAAO,SAASG,wBAAwBC,KAAkB;IACxD,OAAOC,QAAQD,MAAME,KAAK,IAAIF,MAAMb,QAAQ;AAC9C;AAEA,4FAA4F,GAC5F,OAAO,SAASgB,YACd/B,MAA4D;IAE5D,MAAMgC,OAAO,CAAC1B;QACZ,MAAML,QAAQD,0BAAAA,MAAQ,CAACM,IAAI;QAC3B,IAAI,OAAOL,UAAU,UAAU,OAAO;QACtC,OAAOA,MAAMgC,OAAO,CAAC,QAAQ,KAAKxB,IAAI,GAAGyB,KAAK,CAAC,GAAG5C,yBAAyBmB,IAAI;IACjF;IACA,OAAO;QAAEqB,OAAOE,KAAK;QAAiBjB,UAAUiB,KAAK;IAAY;AACnE;AAEA;;;;CAIC,GACD,OAAO,MAAMG,uBAAyD;IACpE;IACA;IACA;CACD,CAAA;AAED,8FAA8F,GAC9F,OAAO,SAASC,wBACdC,IAAiB;IAEjB,MAAMC,OAAO,IAAIC;IACjB,MAAMC,gBAAsE,EAAE;IAC9E,MAAMC,MAAM,CAACC,MAA6BC;QACxC,MAAMrC,MAAM,GAAGoC,KAAK,CAAC,EAAEC,KAAKC,WAAW,IAAI;QAC3C,IAAIN,KAAKO,GAAG,CAACvC,MAAM;QACnBgC,KAAKG,GAAG,CAACnC;QACTkC,cAAcM,IAAI,CAAC;YAAEJ;YAAMC;QAAK;IAClC;IACA,KAAK,MAAMI,SAASV,KAAKW,MAAM,CAAE;QAC/B,IAAI,CAACb,qBAAqBjC,QAAQ,CAAC6C,MAAML,IAAI,GAAGD,IAAIM,MAAML,IAAI,EAAEK,MAAMJ,IAAI;IAC5E;IACA,0EAA0E;IAC1E,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,yEAAyE;IACzE,KAAK,MAAM,EAAEA,IAAI,EAAE,IAAI7D,qBAAqBuD,MAAOI,IAAI,aAAaE;IACpE,OAAOH;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASS,uBAAuBZ,IAAiB;IACtD,MAAM,EAAEa,OAAO,EAAE,GAAGb;IACpB,IACEa,QAAQxC,MAAM,GAAG1B,cAAcC,GAAG,IAClCiE,QAAQxC,MAAM,GAAG1B,cAAcE,GAAG,EAClC;QACA,OAAO,CAAC,iBAAiB,EAAEgE,QAAQxC,MAAM,CAAC,CAAC,EAAEwC,QAAQxC,MAAM,KAAK,IAAI,SAAS,QAAQ,6BAA6B,EAAE1B,cAAcC,GAAG,CAAC,IAAI,EAAED,cAAcE,GAAG,CAAC,0BAA0B,CAAC;IAC3L;IACA,MAAMiE,QAAQ,IAAIZ;IAClB,KAAK,MAAMa,UAAUF,QAAS;QAC5B,IAAI,CAACE,OAAOC,QAAQ,CAAC3C,MAAM,EAAE;YAC3B,OAAO,CAAC,UAAU,EAAE0C,OAAOE,KAAK,CAAC,oDAAoD,CAAC;QACxF;QACA,IAAIF,OAAOC,QAAQ,CAAC3C,MAAM,GAAGvB,sBAAsB;YACjD,OAAO,CAAC,UAAU,EAAEiE,OAAOE,KAAK,CAAC,MAAM,EAAEF,OAAOC,QAAQ,CAAC3C,MAAM,CAAC,uCAAuC,EAAEvB,qBAAqB,0BAA0B,CAAC;QAC3J;QACA,MAAMoE,OAAOH,OAAOG,IAAI,CAAC9C,IAAI,GAAGmC,WAAW;QAC3C,IAAIO,MAAMN,GAAG,CAACU,OAAO;YACnB,OAAO,CAAC,yCAAyC,EAAEH,OAAOG,IAAI,CAAC,0BAA0B,CAAC;QAC5F;QACAJ,MAAMV,GAAG,CAACc;IACZ;IACA,IAAI,CAACL,QAAQM,IAAI,CAAC,CAACJ,SAAWA,OAAOK,GAAG,GAAG;QACzC,OAAO;IACT;IACA,OAAO;AACT;AAEA;;;CAGC,GACD,OAAO,SAASC,kBAAkBrB,IAAiB;IACjD,MAAMsB,QAAQV,uBAAuBZ;IACrC,IAAIsB,OAAO,OAAOA;IAClB,MAAMnB,gBAAgBJ,wBAAwBC;IAC9C,IAAI,CAACG,cAAc9B,MAAM,EAAE,OAAO;IAClC,MAAMkD,QAAQpB,cAAcqB,GAAG,CAC7B,CAAC,EAAEnB,IAAI,EAAEC,IAAI,EAAE,GACb,CAAC,IAAI,EAAE9D,4BAA4B,CAAC6D,KAAK,CAACoB,IAAI,CAAC,EAAE,EAAEnB,KAAK,EAAE,EAAE9D,4BAA4B,CAAC6D,KAAK,CAACqB,KAAK,EAAE;IAE1G,MAAMC,SACJJ,MAAMlD,MAAM,KAAK,IACbkD,KAAK,CAAC,EAAE,GACR,GAAGA,MAAM1B,KAAK,CAAC,GAAG,CAAC,GAAG+B,IAAI,CAAC,MAAM,KAAK,EAAEL,KAAK,CAACA,MAAMlD,MAAM,GAAG,EAAE,EAAE;IACvE,OAAO,CAAC,6DAA6D,EAAEsD,OAAO,+BAA+B,CAAC;AAChH;AASA;;;;CAIC,GACD,OAAO,SAASE,aAAa7B,IAAiB,EAAE8B,UAA6B,CAAC,CAAC;QAK7DA;IAJhB,MAAMjB,UAAUb,KAAKa,OAAO,CAACkB,MAAM,CACjC,CAACC,OAAOjB,SAAWiB,QAAQjB,OAAOC,QAAQ,CAAC3C,MAAM,GAAG,GACpD;IAEF,MAAM4D,WAAUH,mBAAAA,QAAQG,OAAO,YAAfH,mBAAmBhC;IACnC,MAAMoC,YAAYlC,KAAKW,MAAM,CAACwB,MAAM,CAAC,CAACzB,QAAUuB,QAAQpE,QAAQ,CAAC6C,MAAML,IAAI,GAAGhC,MAAM;IACpF,OAAOwC,UAAUqB,YAAaJ,CAAAA,QAAQzC,YAAY,GAAG,IAAI,CAAA;AAC3D;AAEA;;;;;CAKC,GACD,OAAO,SAAS+C,qBAAqBpC,IAAiB,EAAE8B,UAA6B,CAAC,CAAC;IACrF,OAAOD,aAAa7B,MAAM8B,WAAW9E;AACvC;AAEA;;;;;CAKC,GACD,OAAO,SAASqF,wBAAwBhC,IAAY,EAAEL,IAAiB;IACrE,OAAOoC,qBAAqBpC,MAAMK,SAAS,SAAS;QAAE4B,SAASvF;IAAqB,IAAI,CAAC;AAC3F;AAEA;;;;CAIC,GACD,OAAO,SAAS4F,qBACdzD,KAAa,EACbiD,UAAsC,CAAC,CAAC;IAExC,MAAMjB,UAAU0B,KAAK1F,GAAG,CAAC,GAAG0F,KAAKC,KAAK,CAAC3D;IACvC,MAAM4D,SACJ,IACA5B,UAAW9D,CAAAA,2BAA2B,CAAA,IACtC,IACC+E,CAAAA,QAAQzC,YAAY,GAAG,IAAI,CAAA;IAC9B,OAAOoD,SAASzF;AAClB"}

package/src/lib/model/ai-site-start-seo.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiJobOutput } from './ai-jobs.types';
+import { type AiSiteWords } from './ai-site-job';
+/**
+ * The site's own search listing, from the answers (AGL-2918).
+ *
+ * A site has two SEO title-and-description pairs. A page's is the page's, and
+ * the scaffold's page step writes one for each page it builds. The SITE's is
+ * the fallback every page with none of its own publishes, and it is the one
+ * nothing was filling: a newly created site carries whatever its creation
+ * seeded, which is its subdomain or its display name, and a scaffolded site
+ * would publish pages listed under that.
+ *
+ * ── Derived, not generated ───────────────────────────────────────────────
+ *
+ * The two values here are arithmetic on what the person typed, not a model's
+ * writing, and that is deliberate on three counts. The answers are already
+ * the sentence the fallback wants — "what kind of site" IS what the site is,
+ * and "who it is for" IS who it is for. It costs nothing, on a job that is
+ * already tens of model calls. And it is available on the scaffold's first
+ * pass, so the proposal is waiting while the pages are still building rather
+ * than arriving after them.
+ *
+ * ── A proposal, never a write ────────────────────────────────────────────
+ *
+ * Nothing here writes the site's settings. The values travel as a job output
+ * and land in the site SEO form as unsaved edits through the `hostSeo` zone's
+ * own `proposeDraft`; the form's Update is what stores them, and a person who
+ * never opens that form is left with exactly what they had.
+ *
+ * Pure: strings in, strings out, no Firestore and no React.
+ */
+/**
+ * The site SEO form's field names, which are what a proposal is keyed by.
+ *
+ * The same two strings the host settings SEO section names its Title and
+ * Description inputs. They are stated here rather than imported because the
+ * form is the console's and this is a plugin: the zone's `proposeDraft`
+ * ignores a key the form does not edit, so a name that drifted would stage
+ * nothing rather than stage something wrong.
+ */
+export declare const AI_SITE_SEO_FORM_FIELDS: {
+    readonly title: "seo.title";
+    readonly description: "seo.description";
+};
+export type AiSiteSeoFormField = (typeof AI_SITE_SEO_FORM_FIELDS)[keyof typeof AI_SITE_SEO_FORM_FIELDS];
+/**
+ * What each value is held to: the lengths the SEO editors guide a listing to,
+ * which are the same two the host settings form counts down from.
+ */
+export declare const AI_SITE_SEO_LIMITS: Readonly<Record<"title" | "description", number>>;
+/** The kind an `seo` output carries when it is a guided start's site listing. */
+export declare const AI_SITE_SEO_PROPOSAL_KIND = "site-listing";
+/** The id the scaffold reports its one site listing under. */
+export declare const AI_SITE_SEO_OUTPUT_ID = "site:listing";
+export interface AiSiteSeoProposal {
+    kind: typeof AI_SITE_SEO_PROPOSAL_KIND;
+    /** Values for the site SEO form, by field name. */
+    values: Record<AiSiteSeoFormField, string>;
+    /** Customer-safe lines about where the words came from. */
+    notes: string[];
+}
+/** What the proposal says about itself wherever it is shown. */
+export declare const AI_SITE_SEO_NOTE = "Written from what you said the site is and who it is for, not from its pages \u2014 read it before you save it.";
+/**
+ * What the listing is built from: either answer may be missing, because the
+ * guided start requires only the first of them.
+ */
+export interface AiSiteSeoInput extends Partial<AiSiteWords> {
+    /** The site's own name where the job carries one; empty for a site named on its pages. */
+    siteName?: string;
+}
+/**
+ * The site's fallback listing from the answers, or `null` when the answers
+ * describe no site at all — a job with no `businessType` has nothing to
+ * propose, and an empty proposal is worse than none.
+ */
+export declare function aiSiteSeoProposal(input: AiSiteSeoInput): AiSiteSeoProposal | null;
+/** The proposal a job's inputs imply, for the step that reports it. */
+export declare function aiSiteSeoProposalForInputs(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteSeoProposal | null;
+/**
+ * The site listing a job's outputs carry, or `null` when they carry none.
+ *
+ * Read defensively: an output is whatever a past release wrote, so a proposal
+ * whose values are not two strings is treated as no proposal rather than
+ * staged into somebody's live SEO form.
+ */
+export declare function aiSiteSeoProposalOf(outputs: readonly Pick<AiJobOutput, 'resource' | 'proposal'>[] | null | undefined): AiSiteSeoProposal | null;

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

@@ -0,0 +1,154 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { SCREEN_SEO_TEXT_GUIDANCE } from "@aglyn/aglyn/app-utils/screen-seo-fields";
+import { aiSiteWords } from "./ai-site-job.js";
+/**
+ * The site's own search listing, from the answers (AGL-2918).
+ *
+ * A site has two SEO title-and-description pairs. A page's is the page's, and
+ * the scaffold's page step writes one for each page it builds. The SITE's is
+ * the fallback every page with none of its own publishes, and it is the one
+ * nothing was filling: a newly created site carries whatever its creation
+ * seeded, which is its subdomain or its display name, and a scaffolded site
+ * would publish pages listed under that.
+ *
+ * ── Derived, not generated ───────────────────────────────────────────────
+ *
+ * The two values here are arithmetic on what the person typed, not a model's
+ * writing, and that is deliberate on three counts. The answers are already
+ * the sentence the fallback wants — "what kind of site" IS what the site is,
+ * and "who it is for" IS who it is for. It costs nothing, on a job that is
+ * already tens of model calls. And it is available on the scaffold's first
+ * pass, so the proposal is waiting while the pages are still building rather
+ * than arriving after them.
+ *
+ * ── A proposal, never a write ────────────────────────────────────────────
+ *
+ * Nothing here writes the site's settings. The values travel as a job output
+ * and land in the site SEO form as unsaved edits through the `hostSeo` zone's
+ * own `proposeDraft`; the form's Update is what stores them, and a person who
+ * never opens that form is left with exactly what they had.
+ *
+ * Pure: strings in, strings out, no Firestore and no React.
+ */ /**
+ * The site SEO form's field names, which are what a proposal is keyed by.
+ *
+ * The same two strings the host settings SEO section names its Title and
+ * Description inputs. They are stated here rather than imported because the
+ * form is the console's and this is a plugin: the zone's `proposeDraft`
+ * ignores a key the form does not edit, so a name that drifted would stage
+ * nothing rather than stage something wrong.
+ */ export const AI_SITE_SEO_FORM_FIELDS = {
+    title: 'seo.title',
+    description: 'seo.description'
+};
+/**
+ * What each value is held to: the lengths the SEO editors guide a listing to,
+ * which are the same two the host settings form counts down from.
+ */ export const AI_SITE_SEO_LIMITS = SCREEN_SEO_TEXT_GUIDANCE;
+/** The kind an `seo` output carries when it is a guided start's site listing. */ export const AI_SITE_SEO_PROPOSAL_KIND = 'site-listing';
+/** The id the scaffold reports its one site listing under. */ export const AI_SITE_SEO_OUTPUT_ID = 'site:listing';
+/** What the proposal says about itself wherever it is shown. */ export const AI_SITE_SEO_NOTE = 'Written from what you said the site is and who it is for, not from its pages — read it before you save it.';
+/** Held to a length, cut at a word rather than mid-word. */ function clip(value, max) {
+    const text = value.replace(/\s+/g, ' ').trim();
+    if (text.length <= max) return text;
+    const cut = text.slice(0, max + 1);
+    const space = cut.lastIndexOf(' ');
+    return (space > max / 2 ? cut.slice(0, space) : text.slice(0, max)).trim();
+}
+/**
+ * The leading article dropped and the first letter raised: "a neighborhood
+ * dog groomer" is how a person answers the question and is not how a title
+ * starts. Anything the person already capitalized is left alone, so a name
+ * typed as the site type survives.
+ */ function asSubject(about) {
+    // `\b` rather than `\s+`, so an answer that is ONLY an article leaves
+    // nothing behind and the caller proposes nothing: a one-letter title is a
+    // worse thing to stage into a required field than no proposal at all.
+    const text = about.replace(/\s+/g, ' ').trim().replace(/^(?:an?|the)\b\s*/i, '');
+    if (!text) return '';
+    return text[0].toUpperCase() + text.slice(1);
+}
+/** A sentence closed with one period, and never two. */ function sentence(text) {
+    const trimmed = text.trim();
+    return /[.!?]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+/**
+ * The site's fallback listing from the answers, or `null` when the answers
+ * describe no site at all — a job with no `businessType` has nothing to
+ * propose, and an empty proposal is worse than none.
+ */ export function aiSiteSeoProposal(input) {
+    var _input_about, _input_siteName, _input_audience;
+    var _input_about1;
+    const subject = asSubject((_input_about = input.about) != null ? _input_about : '');
+    if (!subject) return null;
+    const name = ((_input_siteName = input.siteName) != null ? _input_siteName : '').replace(/\s+/g, ' ').trim();
+    const audience = ((_input_audience = input.audience) != null ? _input_audience : '').replace(/\s+/g, ' ').trim();
+    const title = clip(name ? `${name} — ${subject}` : subject, AI_SITE_SEO_LIMITS.title);
+    const described = name ? `${name} is ${(_input_about1 = input.about) == null ? void 0 : _input_about1.trim()}` : subject;
+    const description = clip(sentence(audience ? `${described}, for ${audience}` : described), AI_SITE_SEO_LIMITS.description);
+    return {
+        kind: AI_SITE_SEO_PROPOSAL_KIND,
+        values: {
+            [AI_SITE_SEO_FORM_FIELDS.title]: title,
+            [AI_SITE_SEO_FORM_FIELDS.description]: description
+        },
+        notes: [
+            AI_SITE_SEO_NOTE
+        ]
+    };
+}
+/** The proposal a job's inputs imply, for the step that reports it. */ export function aiSiteSeoProposalForInputs(inputs) {
+    const words = aiSiteWords(inputs);
+    const businessName = inputs == null ? void 0 : inputs['businessName'];
+    return aiSiteSeoProposal(_extends({}, words, typeof businessName === 'string' ? {
+        siteName: businessName
+    } : {}));
+}
+/** Whether a value is a record the reader may look inside. */ function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * The site listing a job's outputs carry, or `null` when they carry none.
+ *
+ * Read defensively: an output is whatever a past release wrote, so a proposal
+ * whose values are not two strings is treated as no proposal rather than
+ * staged into somebody's live SEO form.
+ */ export function aiSiteSeoProposalOf(outputs) {
+    for (const output of outputs != null ? outputs : []){
+        if (output.resource !== 'seo') continue;
+        const proposal = output.proposal;
+        if (!isRecord(proposal) || proposal['kind'] !== AI_SITE_SEO_PROPOSAL_KIND) continue;
+        const values = isRecord(proposal['values']) ? proposal['values'] : {};
+        const title = values[AI_SITE_SEO_FORM_FIELDS.title];
+        const description = values[AI_SITE_SEO_FORM_FIELDS.description];
+        if (typeof title !== 'string' || typeof description !== 'string') continue;
+        if (!title.trim() || !description.trim()) continue;
+        const notes = Array.isArray(proposal['notes']) ? proposal['notes'].filter((note)=>typeof note === 'string') : [];
+        return {
+            kind: AI_SITE_SEO_PROPOSAL_KIND,
+            values: {
+                [AI_SITE_SEO_FORM_FIELDS.title]: title,
+                [AI_SITE_SEO_FORM_FIELDS.description]: description
+            },
+            notes
+        };
+    }
+    return null;
+}
+
+//# sourceMappingURL=ai-site-start-seo.js.map