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

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

@@ -0,0 +1,111 @@
+/**
+ * @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 ResolvedBusinessProfile } from '@aglyn/aglyn/app-utils/business-profile';
+import type { AiSystemBlock } from '../providers/contract';
+import type { AiHostPublishContext } from './ai-host-publish-context';
+import type { AiSiteInventory } from './ai-site-inventory';
+/**
+ * What every AI job knows about the site it works on (AGL-3661), as ONE
+ * compact block: the business profile, what the site already has and whether
+ * it is live, and what the owner's edits taught it.
+ *
+ * ── Why it exists ─────────────────────────────────────────────────────────
+ *
+ * Before it, a job saw its brief, the guided start's answers and the site's
+ * name. It named a Free site "Austin Paws Grooming" that was called nothing
+ * of the kind, and nothing stopped it inventing a phone number. The block
+ * gives it the facts the owner entered and a standing rule for the ones they
+ * did not: never invent a name, a contact detail, a price or a review.
+ *
+ * ── Where it sits, and what that costs ────────────────────────────────────
+ *
+ * {@link aiSiteContextSystemBlock} marks it a `cacheBreakpoint`, placed AFTER
+ * every platform-wide cached block and before the volatile ones. The
+ * platform's prefix is still shared by every workspace; this block extends it
+ * with one cache entry per site, which every request of a job — each re-ask,
+ * each section of a page — reads at the cache rate. It changes only when the
+ * owner edits the profile, a page is published, or an edit is remembered.
+ *
+ * ── Held to a ceiling ─────────────────────────────────────────────────────
+ *
+ * {@link AI_SITE_CONTEXT_MAX_CHARS}: 400 tokens at the runtime's four
+ * characters a token. Lines are dropped from the least useful up — the site
+ * index, the profiles, then the preferences — and the closing rule is never
+ * dropped, because it is the line that stops an invented phone number.
+ */
+/** The block's ceiling: 400 tokens at four characters a token. */
+export declare const AI_SITE_CONTEXT_MAX_CHARS = 1600;
+/** Pages, forms, components and layouts listed by name in the site index, each. */
+export declare const AI_SITE_CONTEXT_INDEX_PER_KIND = 8;
+/** The rule every block closes with, whatever else it says. */
+export declare const AI_SITE_CONTEXT_RULE = "Never invent a business name, a person\u2019s name, an email address, a phone number, a street address, opening hours, prices, reviews or testimonials. Use only the facts above; where a page needs one that is missing, write around it or leave a bracketed placeholder such as [phone number] for the owner to fill.";
+export interface AiSiteContextInput {
+    /** The resolved business profile; `null` when the site has none to read. */
+    profile: ResolvedBusinessProfile | null;
+    /**
+     * The site's inventory, for a caller that does NOT already send it. A job
+     * whose prompt carries the inventory block (the plan step and the writers
+     * built on the doctrine) leaves this out: the block would only repeat it.
+     */
+    inventory?: AiSiteInventory | null;
+    /** Whether the site is live and where. */
+    publish?: AiHostPublishContext | null;
+    /** What the owner's edits taught, strongest first. */
+    preferences?: readonly string[];
+    /**
+     * Whether the block may carry contact details. An answer that must name
+     * nobody and print no address (the insight rules) leaves them out.
+     */
+    contact?: boolean;
+}
+/**
+ * The site's index (AGL-3661): what it already has, by name and id, so a job
+ * reuses before it builds. Pages say whether they are live; a form says how
+ * many fields it asks for. Pure, so a caller holding an inventory pays one
+ * render and no read.
+ */
+export declare function aiSiteInventoryIndex(inventory: AiSiteInventory | null | undefined, publish?: AiHostPublishContext | null): string[];
+/**
+ * The block as text (AGL-3661), never over {@link AI_SITE_CONTEXT_MAX_CHARS}.
+ * `''` when there is nothing to say, so a caller sends no block at all.
+ */
+export declare function aiSiteContextBlock(input: AiSiteContextInput): string;
+/**
+ * The block as the system block a door appends after its own cached blocks
+ * (AGL-3661): a `cacheBreakpoint` of its own, so the platform's prefix ahead
+ * of it is still shared and this one is cached per site. `[]` when there is
+ * nothing to say.
+ *
+ * A door already carrying the runtime's limit of breakpoints passes
+ * `cache: false`, and the block rides as a volatile block after them instead.
+ */
+export declare function aiSiteContextSystemBlock(input: AiSiteContextInput | null | undefined, options?: {
+    cache?: boolean;
+}): AiSystemBlock[];
+/**
+ * A door's own instructions with the site context after them (AGL-3661) —
+ * THE call a generator makes to give its model the site:
+ *
+ *   instructions: aiInstructionsWithSiteContext(MY_INSTRUCTIONS, context)
+ *
+ * The door's last instruction block is marked a breakpoint, so the
+ * platform-wide prefix (the doctrine and the door's rules) stays one cache
+ * entry for every workspace, and the context block after it is the per-site
+ * entry. Without a context it hands the instructions back unchanged, so a
+ * door's prompt is byte-for-byte what it was for a job that has no site.
+ */
+export declare function aiInstructionsWithSiteContext(instructions: readonly AiSystemBlock[], context: AiSiteContextInput | null | undefined): readonly AiSystemBlock[];

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

@@ -0,0 +1,222 @@
+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 { BUSINESS_TONE_LABELS } from "@aglyn/aglyn/app-utils/business-profile";
+/**
+ * What every AI job knows about the site it works on (AGL-3661), as ONE
+ * compact block: the business profile, what the site already has and whether
+ * it is live, and what the owner's edits taught it.
+ *
+ * ── Why it exists ─────────────────────────────────────────────────────────
+ *
+ * Before it, a job saw its brief, the guided start's answers and the site's
+ * name. It named a Free site "Austin Paws Grooming" that was called nothing
+ * of the kind, and nothing stopped it inventing a phone number. The block
+ * gives it the facts the owner entered and a standing rule for the ones they
+ * did not: never invent a name, a contact detail, a price or a review.
+ *
+ * ── Where it sits, and what that costs ────────────────────────────────────
+ *
+ * {@link aiSiteContextSystemBlock} marks it a `cacheBreakpoint`, placed AFTER
+ * every platform-wide cached block and before the volatile ones. The
+ * platform's prefix is still shared by every workspace; this block extends it
+ * with one cache entry per site, which every request of a job — each re-ask,
+ * each section of a page — reads at the cache rate. It changes only when the
+ * owner edits the profile, a page is published, or an edit is remembered.
+ *
+ * ── Held to a ceiling ─────────────────────────────────────────────────────
+ *
+ * {@link AI_SITE_CONTEXT_MAX_CHARS}: 400 tokens at the runtime's four
+ * characters a token. Lines are dropped from the least useful up — the site
+ * index, the profiles, then the preferences — and the closing rule is never
+ * dropped, because it is the line that stops an invented phone number.
+ */ /** The block's ceiling: 400 tokens at four characters a token. */ export const AI_SITE_CONTEXT_MAX_CHARS = 1600;
+/** Pages, forms, components and layouts listed by name in the site index, each. */ export const AI_SITE_CONTEXT_INDEX_PER_KIND = 8;
+/** The rule every block closes with, whatever else it says. */ export const AI_SITE_CONTEXT_RULE = 'Never invent a business name, a person’s name, an email address, a phone number, a street address, opening hours, prices, reviews or testimonials. Use only the facts above; where a page needs one that is missing, write around it or leave a bracketed placeholder such as [phone number] for the owner to fill.';
+const clip = (value, max)=>value.length > max ? `${value.slice(0, max - 1)}…` : value;
+/** One labelled line, or nothing for an empty value. */ const line = (label, value, max = 240)=>value && value.trim() ? `${label}: ${clip(value.trim(), max)}` : null;
+const pathOf = (slug)=>`/${slug.trim().replace(/^\/+|\/+$/g, '')}`;
+/**
+ * The site's index (AGL-3661): what it already has, by name and id, so a job
+ * reuses before it builds. Pages say whether they are live; a form says how
+ * many fields it asks for. Pure, so a caller holding an inventory pays one
+ * render and no read.
+ */ export function aiSiteInventoryIndex(inventory, publish) {
+    var _ref;
+    if (!inventory) return [];
+    const live = new Set(((_ref = publish == null ? void 0 : publish.publishedPages) != null ? _ref : []).map((path)=>pathOf(path)));
+    const cap = AI_SITE_CONTEXT_INDEX_PER_KIND;
+    const more = (total)=>total > cap ? `, and ${total - cap} more` : '';
+    const lines = [];
+    const pages = inventory.screens.filter((screen)=>!screen.template);
+    if (pages.length) {
+        const rows = pages.slice(0, cap).map((page)=>{
+            const path = pathOf(page.slug);
+            return `${page.name} ${path} (${live.has(path) ? 'live' : 'draft'})`;
+        });
+        lines.push(`Pages: ${rows.join('; ')}${more(pages.length)}`);
+    }
+    if (inventory.forms.length) {
+        const rows = inventory.forms.slice(0, cap).map((form)=>`${form.name} [${form.id}, ${form.fields.length} fields]`);
+        lines.push(`Forms: ${rows.join('; ')}${more(inventory.forms.length)}`);
+    }
+    if (inventory.components.length) {
+        const rows = inventory.components.slice(0, cap).map((component)=>`${component.name} [${component.id}]`);
+        lines.push(`Components: ${rows.join('; ')}${more(inventory.components.length)}`);
+    }
+    if (inventory.layouts.length) {
+        const rows = inventory.layouts.slice(0, cap).map((layout)=>`${layout.name} [${layout.id}]`);
+        lines.push(`Layouts: ${rows.join('; ')}${more(inventory.layouts.length)}`);
+    }
+    return lines;
+}
+/** The block's lines in priority order; each group is dropped whole when it does not fit. */ function contextGroups(input) {
+    const { profile, publish, preferences } = input;
+    const business = [];
+    if (profile) {
+        var _ref;
+        var _profile_toneNotes, _profile_name, _profile_whatYouDo, _profile_services, _profile_serviceArea, _profile_audience;
+        const toneLabel = profile.tone ? BUSINESS_TONE_LABELS[profile.tone.value] : null;
+        const toneNotes = (_ref = (_profile_toneNotes = profile.toneNotes) == null ? void 0 : _profile_toneNotes.value) != null ? _ref : '';
+        business.push(...[
+            line('Business name', (_profile_name = profile.name) == null ? void 0 : _profile_name.value, 120),
+            line('What it does', (_profile_whatYouDo = profile.whatYouDo) == null ? void 0 : _profile_whatYouDo.value),
+            line('Business type', profile.businessType, 80),
+            line('Services', (_profile_services = profile.services) == null ? void 0 : _profile_services.value.join('; ')),
+            line('Area served', (_profile_serviceArea = profile.serviceArea) == null ? void 0 : _profile_serviceArea.value, 160),
+            line('Audience', (_profile_audience = profile.audience) == null ? void 0 : _profile_audience.value, 160),
+            line('Tone of voice', [
+                toneLabel,
+                toneNotes
+            ].filter(Boolean).join(' — ') || null)
+        ].filter((entry)=>Boolean(entry)));
+    }
+    const contact = [];
+    if (profile && input.contact !== false) {
+        const parts = [
+            profile.contact.email ? `email ${profile.contact.email}` : null,
+            profile.contact.phone ? `phone ${profile.contact.phone}` : null,
+            profile.contact.address ? `address ${profile.contact.address}` : null,
+            profile.contact.hours ? `hours ${profile.contact.hours}` : null
+        ].filter(Boolean);
+        contact.push(parts.length ? `Contact details the owner entered (use exactly as written): ${clip(parts.join('; '), 400)}` : 'Contact details: none entered yet.');
+    }
+    const status = [];
+    if (publish) {
+        var _publish_liveUrl;
+        status.push(publish.published ? `Site: live at ${(_publish_liveUrl = publish.liveUrl) != null ? _publish_liveUrl : 'its address'}; live pages ${clip(publish.publishedPages.join(', '), 200)}` : `Site: not published yet${publish.liveUrl ? `; it will be at ${publish.liveUrl}` : ''}`);
+    }
+    const remembered = (preferences == null ? void 0 : preferences.length) ? [
+        `What the owner's past edits showed: ${clip(preferences.join('; '), 360)}.`
+    ] : [];
+    const profiles = profile && input.contact !== false && profile.profiles.length ? [
+        `Social profiles: ${clip(profile.profiles.join(', '), 300)}`
+    ] : [];
+    const index = aiSiteInventoryIndex(input.inventory, publish);
+    // Priority order: what the business is, how to reach it, whether it is
+    // live, what the owner taught, its profiles, then what the site holds.
+    return [
+        business,
+        contact,
+        status,
+        remembered,
+        profiles,
+        index
+    ];
+}
+/**
+ * The block as text (AGL-3661), never over {@link AI_SITE_CONTEXT_MAX_CHARS}.
+ * `''` when there is nothing to say, so a caller sends no block at all.
+ */ export function aiSiteContextBlock(input) {
+    const groups = contextGroups(input).filter((group)=>group.length);
+    if (!groups.length) return '';
+    const head = 'About this site, from its owner’s settings. Write for this business and do not contradict these facts:';
+    const render = (kept)=>[
+            head,
+            ...kept.flat(),
+            AI_SITE_CONTEXT_RULE
+        ].join('\n');
+    const kept = [
+        ...groups
+    ];
+    let text = render(kept);
+    while(text.length > AI_SITE_CONTEXT_MAX_CHARS && kept.length > 1){
+        kept.pop();
+        text = render(kept);
+    }
+    if (text.length <= AI_SITE_CONTEXT_MAX_CHARS) return text;
+    // One group still too long (a very long profile): its lines are cut, the
+    // closing rule is kept whole.
+    const room = AI_SITE_CONTEXT_MAX_CHARS - head.length - AI_SITE_CONTEXT_RULE.length - 2;
+    return [
+        head,
+        clip(kept.flat().join('\n'), Math.max(0, room)),
+        AI_SITE_CONTEXT_RULE
+    ].join('\n');
+}
+/**
+ * The block as the system block a door appends after its own cached blocks
+ * (AGL-3661): a `cacheBreakpoint` of its own, so the platform's prefix ahead
+ * of it is still shared and this one is cached per site. `[]` when there is
+ * nothing to say.
+ *
+ * A door already carrying the runtime's limit of breakpoints passes
+ * `cache: false`, and the block rides as a volatile block after them instead.
+ */ export function aiSiteContextSystemBlock(input, options = {}) {
+    const text = input ? aiSiteContextBlock(input) : '';
+    if (!text) return [];
+    return [
+        options.cache === false ? {
+            text,
+            volatile: true,
+            site: true
+        } : {
+            text,
+            cacheBreakpoint: true,
+            site: true
+        }
+    ];
+}
+/**
+ * A door's own instructions with the site context after them (AGL-3661) —
+ * THE call a generator makes to give its model the site:
+ *
+ *   instructions: aiInstructionsWithSiteContext(MY_INSTRUCTIONS, context)
+ *
+ * The door's last instruction block is marked a breakpoint, so the
+ * platform-wide prefix (the doctrine and the door's rules) stays one cache
+ * entry for every workspace, and the context block after it is the per-site
+ * entry. Without a context it hands the instructions back unchanged, so a
+ * door's prompt is byte-for-byte what it was for a job that has no site.
+ */ export function aiInstructionsWithSiteContext(instructions, context) {
+    const site = aiSiteContextSystemBlock(context);
+    if (!site.length) return instructions;
+    const blocks = [
+        ...instructions
+    ];
+    const last = blocks.length - 1;
+    if (last >= 0 && !blocks[last].volatile && !blocks.some((block)=>block.cacheBreakpoint)) {
+        blocks[last] = _extends({}, blocks[last], {
+            cacheBreakpoint: true
+        });
+    }
+    return [
+        ...blocks,
+        ...site
+    ];
+}
+
+//# sourceMappingURL=ai-site-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-context.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  BUSINESS_TONE_LABELS,\n  type ResolvedBusinessProfile,\n} from '@aglyn/aglyn/app-utils/business-profile'\nimport type { AiSystemBlock } from '../providers/contract'\nimport type { AiHostPublishContext } from './ai-host-publish-context'\nimport type { AiSiteInventory } from './ai-site-inventory'\n\n/**\n * What every AI job knows about the site it works on (AGL-3661), as ONE\n * compact block: the business profile, what the site already has and whether\n * it is live, and what the owner's edits taught it.\n *\n * ── Why it exists ─────────────────────────────────────────────────────────\n *\n * Before it, a job saw its brief, the guided start's answers and the site's\n * name. It named a Free site \"Austin Paws Grooming\" that was called nothing\n * of the kind, and nothing stopped it inventing a phone number. The block\n * gives it the facts the owner entered and a standing rule for the ones they\n * did not: never invent a name, a contact detail, a price or a review.\n *\n * ── Where it sits, and what that costs ────────────────────────────────────\n *\n * {@link aiSiteContextSystemBlock} marks it a `cacheBreakpoint`, placed AFTER\n * every platform-wide cached block and before the volatile ones. The\n * platform's prefix is still shared by every workspace; this block extends it\n * with one cache entry per site, which every request of a job — each re-ask,\n * each section of a page — reads at the cache rate. It changes only when the\n * owner edits the profile, a page is published, or an edit is remembered.\n *\n * ── Held to a ceiling ─────────────────────────────────────────────────────\n *\n * {@link AI_SITE_CONTEXT_MAX_CHARS}: 400 tokens at the runtime's four\n * characters a token. Lines are dropped from the least useful up — the site\n * index, the profiles, then the preferences — and the closing rule is never\n * dropped, because it is the line that stops an invented phone number.\n */\n\n/** The block's ceiling: 400 tokens at four characters a token. */\nexport const AI_SITE_CONTEXT_MAX_CHARS = 1_600\n\n/** Pages, forms, components and layouts listed by name in the site index, each. */\nexport const AI_SITE_CONTEXT_INDEX_PER_KIND = 8\n\n/** The rule every block closes with, whatever else it says. */\nexport const AI_SITE_CONTEXT_RULE =\n  'Never invent a business name, a person’s name, an email address, a phone number, a street address, opening hours, prices, reviews or testimonials. Use only the facts above; where a page needs one that is missing, write around it or leave a bracketed placeholder such as [phone number] for the owner to fill.'\n\nexport interface AiSiteContextInput {\n  /** The resolved business profile; `null` when the site has none to read. */\n  profile: ResolvedBusinessProfile | null\n  /**\n   * The site's inventory, for a caller that does NOT already send it. A job\n   * whose prompt carries the inventory block (the plan step and the writers\n   * built on the doctrine) leaves this out: the block would only repeat it.\n   */\n  inventory?: AiSiteInventory | null\n  /** Whether the site is live and where. */\n  publish?: AiHostPublishContext | null\n  /** What the owner's edits taught, strongest first. */\n  preferences?: readonly string[]\n  /**\n   * Whether the block may carry contact details. An answer that must name\n   * nobody and print no address (the insight rules) leaves them out.\n   */\n  contact?: boolean\n}\n\nconst clip = (value: string, max: number) => (value.length > max ? `${value.slice(0, max - 1)}…` : value)\n\n/** One labelled line, or nothing for an empty value. */\nconst line = (label: string, value: string | null | undefined, max = 240): string | null =>\n  value && value.trim() ? `${label}: ${clip(value.trim(), max)}` : null\n\nconst pathOf = (slug: string) => `/${slug.trim().replace(/^\\/+|\\/+$/g, '')}`\n\n/**\n * The site's index (AGL-3661): what it already has, by name and id, so a job\n * reuses before it builds. Pages say whether they are live; a form says how\n * many fields it asks for. Pure, so a caller holding an inventory pays one\n * render and no read.\n */\nexport function aiSiteInventoryIndex(\n  inventory: AiSiteInventory | null | undefined,\n  publish?: AiHostPublishContext | null,\n): string[] {\n  if (!inventory) return []\n  const live = new Set((publish?.publishedPages ?? []).map((path) => pathOf(path)))\n  const cap = AI_SITE_CONTEXT_INDEX_PER_KIND\n  const more = (total: number) => (total > cap ? `, and ${total - cap} more` : '')\n  const lines: string[] = []\n  const pages = inventory.screens.filter((screen) => !screen.template)\n  if (pages.length) {\n    const rows = pages.slice(0, cap).map((page) => {\n      const path = pathOf(page.slug)\n      return `${page.name} ${path} (${live.has(path) ? 'live' : 'draft'})`\n    })\n    lines.push(`Pages: ${rows.join('; ')}${more(pages.length)}`)\n  }\n  if (inventory.forms.length) {\n    const rows = inventory.forms.slice(0, cap).map((form) => `${form.name} [${form.id}, ${form.fields.length} fields]`)\n    lines.push(`Forms: ${rows.join('; ')}${more(inventory.forms.length)}`)\n  }\n  if (inventory.components.length) {\n    const rows = inventory.components.slice(0, cap).map((component) => `${component.name} [${component.id}]`)\n    lines.push(`Components: ${rows.join('; ')}${more(inventory.components.length)}`)\n  }\n  if (inventory.layouts.length) {\n    const rows = inventory.layouts.slice(0, cap).map((layout) => `${layout.name} [${layout.id}]`)\n    lines.push(`Layouts: ${rows.join('; ')}${more(inventory.layouts.length)}`)\n  }\n  return lines\n}\n\n/** The block's lines in priority order; each group is dropped whole when it does not fit. */\nfunction contextGroups(input: AiSiteContextInput): string[][] {\n  const { profile, publish, preferences } = input\n  const business: string[] = []\n  if (profile) {\n    const toneLabel = profile.tone ? BUSINESS_TONE_LABELS[profile.tone.value] : null\n    const toneNotes = profile.toneNotes?.value ?? ''\n    business.push(\n      ...[\n        line('Business name', profile.name?.value, 120),\n        line('What it does', profile.whatYouDo?.value),\n        line('Business type', profile.businessType, 80),\n        line('Services', profile.services?.value.join('; ')),\n        line('Area served', profile.serviceArea?.value, 160),\n        line('Audience', profile.audience?.value, 160),\n        line('Tone of voice', [toneLabel, toneNotes].filter(Boolean).join(' — ') || null),\n      ].filter((entry): entry is string => Boolean(entry)),\n    )\n  }\n  const contact: string[] = []\n  if (profile && input.contact !== false) {\n    const parts = [\n      profile.contact.email ? `email ${profile.contact.email}` : null,\n      profile.contact.phone ? `phone ${profile.contact.phone}` : null,\n      profile.contact.address ? `address ${profile.contact.address}` : null,\n      profile.contact.hours ? `hours ${profile.contact.hours}` : null,\n    ].filter(Boolean)\n    contact.push(\n      parts.length\n        ? `Contact details the owner entered (use exactly as written): ${clip(parts.join('; '), 400)}`\n        : 'Contact details: none entered yet.',\n    )\n  }\n  const status: string[] = []\n  if (publish) {\n    status.push(\n      publish.published\n        ? `Site: live at ${publish.liveUrl ?? 'its address'}; live pages ${clip(publish.publishedPages.join(', '), 200)}`\n        : `Site: not published yet${publish.liveUrl ? `; it will be at ${publish.liveUrl}` : ''}`,\n    )\n  }\n  const remembered = preferences?.length\n    ? [`What the owner's past edits showed: ${clip(preferences.join('; '), 360)}.`]\n    : []\n  const profiles =\n    profile && input.contact !== false && profile.profiles.length\n      ? [`Social profiles: ${clip(profile.profiles.join(', '), 300)}`]\n      : []\n  const index = aiSiteInventoryIndex(input.inventory, publish)\n  // Priority order: what the business is, how to reach it, whether it is\n  // live, what the owner taught, its profiles, then what the site holds.\n  return [business, contact, status, remembered, profiles, index]\n}\n\n/**\n * The block as text (AGL-3661), never over {@link AI_SITE_CONTEXT_MAX_CHARS}.\n * `''` when there is nothing to say, so a caller sends no block at all.\n */\nexport function aiSiteContextBlock(input: AiSiteContextInput): string {\n  const groups = contextGroups(input).filter((group) => group.length)\n  if (!groups.length) return ''\n  const head = 'About this site, from its owner’s settings. Write for this business and do not contradict these facts:'\n  const render = (kept: string[][]) => [head, ...kept.flat(), AI_SITE_CONTEXT_RULE].join('\\n')\n  const kept = [...groups]\n  let text = render(kept)\n  while (text.length > AI_SITE_CONTEXT_MAX_CHARS && kept.length > 1) {\n    kept.pop()\n    text = render(kept)\n  }\n  if (text.length <= AI_SITE_CONTEXT_MAX_CHARS) return text\n  // One group still too long (a very long profile): its lines are cut, the\n  // closing rule is kept whole.\n  const room = AI_SITE_CONTEXT_MAX_CHARS - head.length - AI_SITE_CONTEXT_RULE.length - 2\n  return [head, clip(kept.flat().join('\\n'), Math.max(0, room)), AI_SITE_CONTEXT_RULE].join('\\n')\n}\n\n/**\n * The block as the system block a door appends after its own cached blocks\n * (AGL-3661): a `cacheBreakpoint` of its own, so the platform's prefix ahead\n * of it is still shared and this one is cached per site. `[]` when there is\n * nothing to say.\n *\n * A door already carrying the runtime's limit of breakpoints passes\n * `cache: false`, and the block rides as a volatile block after them instead.\n */\nexport function aiSiteContextSystemBlock(\n  input: AiSiteContextInput | null | undefined,\n  options: { cache?: boolean } = {},\n): AiSystemBlock[] {\n  const text = input ? aiSiteContextBlock(input) : ''\n  if (!text) return []\n  return [options.cache === false ? { text, volatile: true, site: true } : { text, cacheBreakpoint: true, site: true }]\n}\n\n/**\n * A door's own instructions with the site context after them (AGL-3661) —\n * THE call a generator makes to give its model the site:\n *\n *   instructions: aiInstructionsWithSiteContext(MY_INSTRUCTIONS, context)\n *\n * The door's last instruction block is marked a breakpoint, so the\n * platform-wide prefix (the doctrine and the door's rules) stays one cache\n * entry for every workspace, and the context block after it is the per-site\n * entry. Without a context it hands the instructions back unchanged, so a\n * door's prompt is byte-for-byte what it was for a job that has no site.\n */\nexport function aiInstructionsWithSiteContext(\n  instructions: readonly AiSystemBlock[],\n  context: AiSiteContextInput | null | undefined,\n): readonly AiSystemBlock[] {\n  const site = aiSiteContextSystemBlock(context)\n  if (!site.length) return instructions\n  const blocks = [...instructions]\n  const last = blocks.length - 1\n  if (last >= 0 && !blocks[last].volatile && !blocks.some((block) => block.cacheBreakpoint)) {\n    blocks[last] = { ...blocks[last], cacheBreakpoint: true }\n  }\n  return [...blocks, ...site]\n}\n"],"names":["BUSINESS_TONE_LABELS","AI_SITE_CONTEXT_MAX_CHARS","AI_SITE_CONTEXT_INDEX_PER_KIND","AI_SITE_CONTEXT_RULE","clip","value","max","length","slice","line","label","trim","pathOf","slug","replace","aiSiteInventoryIndex","inventory","publish","live","Set","publishedPages","map","path","cap","more","total","lines","pages","screens","filter","screen","template","rows","page","name","has","push","join","forms","form","id","fields","components","component","layouts","layout","contextGroups","input","profile","preferences","business","toneLabel","tone","toneNotes","whatYouDo","businessType","services","serviceArea","audience","Boolean","entry","contact","parts","email","phone","address","hours","status","published","liveUrl","remembered","profiles","index","aiSiteContextBlock","groups","group","head","render","kept","flat","text","pop","room","Math","aiSiteContextSystemBlock","options","cache","volatile","site","cacheBreakpoint","aiInstructionsWithSiteContext","instructions","context","blocks","last","some","block"],"mappings":"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"}

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

@@ -84,6 +84,8 @@ export declare const AI_SITE_PLAN_MAX_TOKENS: {
 export interface AiFreeSiteWorstCase {
     /** The site plan: its answer and its one re-ask, each at its ceiling. */
     plan: number;
+    /** The site's look (AGL-3660): its one answer at its ceiling, on the fast tier. */
+    look: number;
     /** The one layout a Free plan includes, built first on a site with none. */
     layout: number;
     /** A page's first section pass, which writes the cached prefix. */
@@ -104,7 +106,7 @@ export interface AiFreeSiteWorstCase {
 export declare const AI_FREE_SITE_WORST_CASE_CREDITS: Readonly<AiFreeSiteWorstCase>;
 /**
  * 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.
@@ -117,7 +119,7 @@ export declare function aiFreeSiteSectionsWithin(creations: {
 export declare 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.
  */
@@ -173,6 +175,12 @@ export interface AiSiteJobInputs {
      * few words in a brief, not a lookup.
      */
     starter: string;
+    /**
+     * The kind of site the person picked (AGL-3660), by its `AI_SITE_KINDS`
+     * id; empty when nobody picked one, and the business type suggests it.
+     * It sets the look the site is designed in and how its pages are arranged.
+     */
+    siteKind: string;
     /** How many pages the member asked for. */
     pages: number;
     /** The per-site variables an agency batch varies; empty when none was given. */
@@ -236,6 +244,14 @@ export declare const AI_SITE_SUBMISSION_CHOICES: ReadonlyArray<{
  * because it is the first thing the model is told.
  */
 export declare const AI_SITE_EMAIL_TYPE = "reply";
+/**
+ * What a site job's plan and every unit it builds are told about the
+ * business's name (AGL-3596): that it is the name, used as written. Said on
+ * the job's own turn, never in a cached system block, because it is one
+ * site's. A model handed only what the business does named it itself —
+ * "Hillside Dog Grooming" was built as "Austin Paws Grooming".
+ */
+export declare function aiSiteNameSentence(name: string): string;
 /** Where a job's inputs say submissions go, or `null` where they do not say. */
 export declare function aiSiteSubmissions(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteSubmissions | null;
 /** A scaffold's inputs, or the sentence the door refuses them with. */

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
@@ -179,12 +181,23 @@ import { AI_PAGE_CREATE_KINDS } from "./ai-page-job.js";
  * 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';
+/**
+ * What a site job's plan and every unit it builds are told about the
+ * business's name (AGL-3596): that it is the name, used as written. Said on
+ * the job's own turn, never in a cached system block, because it is one
+ * site's. A model handed only what the business does named it itself —
+ * "Hillside Dog Grooming" was built as "Austin Paws Grooming".
+ */ export function aiSiteNameSentence(name) {
+    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.`;
+}
 /** 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) {
+    var _ref;
+    var _aiSiteKind;
     const text = (key)=>{
         const value = inputs == null ? void 0 : inputs[key];
         if (value === undefined || value === null || value === '') return '';
@@ -202,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',
@@ -244,6 +259,7 @@ const ID_CHARS = /^[A-Za-z0-9_-]{1,64}$/;
         businessType,
         audience: audience,
         starter: starter,
+        siteKind,
         pages,
         businessName: businessName,
         city: city,