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

package/src/lib/jobs/ai-job-page-language.js

@@ -0,0 +1,355 @@
+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 { CANVAS_ROOT_ELEMENT_ID } from "@aglyn/aglyn/foundation/constants/canvas";
+import { isAiPlanNewRef } from "../model/ai-build-plan.js";
+import { aiHomeScreenIds } from "../model/ai-site-inventory.js";
+import { aiCompileLayoutPage } from "../layout-language/ai-layout-compiler.js";
+import { AI_LAYOUT_LANGUAGE_TEXT, AI_LAYOUT_PAGE_TOOL, aiReadLayoutPage } from "../layout-language/ai-layout-language.js";
+import { aiLayoutCopyCheck } from "../layout-language/ai-layout-gaps.js";
+import { aiLayoutStoredTree } from "../layout-language/ai-layout-store.js";
+import { AI_GENERATION_MAX_ATTEMPTS } from "../runtime/ai-generation-bounds.js";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { runValidatedGeneration } from "../runtime/ai-doctrine.js";
+import { validateAiDoctrineTree } from "../runtime/ai-doctrine-validators.js";
+import { aiGenerationWorstCaseOnTierMs, aiJobStepBudget } from "./ai-job-budget.js";
+import { aiJobBriefLine, aiPlanReferenceLines } from "./ai-job-generation.js";
+import { aiLayoutSitePages } from "./ai-job-layout-site-pages.js";
+import { aiLayoutInventedContactViolations } from "./ai-layout-site-facts.js";
+/**
+ * A page built in the compact layout language (AGL-3660): the page step's
+ * pass for a site's page units — a guided start's and a build's — in place of
+ * the raw-tree section passes.
+ *
+ * ONE answer a page: every planned section, in the language, through
+ * `submit_page`. The compiler writes the tree, the palette validator stores
+ * it as it stores any generated tree, and the doctrine checks the whole page.
+ * A section the answer left out or left empty is the one thing a re-ask asks
+ * for: the sections that read are kept, and the second answer fills only
+ * what is still missing. Then the page step's last pass runs as it always
+ * has — the whole page held to the doctrine again, its listing written, the
+ * draft reported — so the item ledger, the credits and Try again work exactly
+ * as they did.
+ */ /** The unit input that says a page or a layout is built in the layout language. */ export const AI_LAYOUT_LANGUAGE_INPUT = 'layoutLanguage';
+/** The unit input naming the page of the site that places its form, where it is another page. */ export const AI_LAYOUT_FORM_PAGE_INPUT = 'layoutFormPage';
+/** Whether this job builds its page or its layout in the layout language. */ export function aiJobUsesLayoutLanguage(job) {
+    var _job_inputs;
+    return ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs[AI_LAYOUT_LANGUAGE_INPUT]) === true;
+}
+/**
+ * The most one page's answer asks for. A section in the language is about
+ * 120 to 250 tokens with its copy, so the largest page a plan admits — eight
+ * sections — fits with room; the compiler, not the ceiling, keeps a page small.
+ */ export const AI_JOB_PAGE_LANGUAGE_TOKENS = 3000;
+/**
+ * The time a language page pass needs: its lookup rounds, its answer and its
+ * re-ask at `AI_JOB_PAGE_LANGUAGE_TOKENS` on the tier the page step is served
+ * from, with the step's reads and writes.
+ */ /** The most the follow-up asking only for the sections an answer left out may run to. */ export const AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS = 1500;
+export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.page'],
+    maxTokens: AI_JOB_PAGE_LANGUAGE_TOKENS,
+    // The follow-up for sections an answer left out is one more generation.
+    ownReadsMs: aiGenerationWorstCaseOnTierMs({
+        tier: AI_STEP_TIERS['job.page'],
+        maxTokens: AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS
+    })
+});
+/** The doctrine scope the language doors are told: values the compiler checks itself. */ export const AI_LAYOUT_PAGE_KIND = 'layout-page';
+/** The language, as the page door's cached instructions. */ export const AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS = [
+    {
+        text: [
+            AI_LAYOUT_LANGUAGE_TEXT,
+            '',
+            'Answer with submit_page: the whole page, one entry in sections for each planned section, in order.'
+        ].join('\n'),
+        cacheBreakpoint: true
+    }
+];
+/** The page of a site plan that places its form: the form the plan creates, or one the site has. */ export function aiLayoutFormPageOfPlan(plan, formIds = []) {
+    const created = new Set(plan.create.filter((entry)=>entry.kind === 'form').map((entry)=>`new:${entry.name}`.toLowerCase()));
+    const forms = new Set(formIds);
+    const screen = plan.screens.find((entry)=>entry.sections.some((section)=>section.uses.some((ref)=>isAiPlanNewRef(ref) ? created.has(ref.toLowerCase()) : forms.has(ref))));
+    return typeof (screen == null ? void 0 : screen.id) === 'string' ? screen.id : null;
+}
+/** Every word the job was given, which a page's contact details are held to. */ export function aiLayoutFacts(job) {
+    var _job_inputs;
+    const values = Object.values((_job_inputs = job.inputs) != null ? _job_inputs : {}).filter((value)=>typeof value === 'string');
+    return [
+        job.brief,
+        ...values
+    ].join('\n');
+}
+/** What a page's links resolve against: the site's pages, built and planned, its forms and components. */ export function aiLayoutPageTargets(input) {
+    var _ref, _own_, _ref1, _ref2;
+    var _job_inputs;
+    const { job, inventory } = input;
+    const own = input.own.filter((id)=>!!id);
+    const planned = aiLayoutSitePages(job.inputs);
+    const pages = [
+        ...planned,
+        ...((_ref = inventory == null ? void 0 : inventory.screens) != null ? _ref : []).filter((row)=>!row.template && !planned.some((page)=>page.id === row.id)).map((row)=>({
+                id: row.id,
+                label: row.name,
+                slug: row.slug
+            }))
+    ];
+    const formPage = (_job_inputs = job.inputs) == null ? void 0 : _job_inputs[AI_LAYOUT_FORM_PAGE_INPUT];
+    return {
+        pageId: (_own_ = own[0]) != null ? _own_ : null,
+        pages: pages.filter((page)=>!own.includes(page.id)),
+        homeIds: aiHomeScreenIds(inventory),
+        forms: ((_ref1 = inventory == null ? void 0 : inventory.forms) != null ? _ref1 : []).map((form)=>({
+                id: form.id,
+                name: form.name
+            })),
+        formPageId: typeof formPage === 'string' && !own.includes(formPage) ? formPage : null,
+        components: ((_ref2 = inventory == null ? void 0 : inventory.components) != null ? _ref2 : []).map((component)=>({
+                id: component.id,
+                name: component.name,
+                props: component.props
+            })),
+        facts: aiLayoutFacts(job)
+    };
+}
+/** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */ export function aiLayoutPagePrompt(input) {
+    const { job, plan, screen, targets } = input;
+    const sections = screen.sections.map((section, index)=>{
+        const places = section.uses.length ? `; places ${section.uses.join(', ')}` : '';
+        const items = section.items ? `; shows ${section.items} items` : '';
+        return `${index + 1}. "${section.name}"${places}${items}`;
+    });
+    const pages = targets.pages.map((page)=>`${page.label} (page:${page.id})`);
+    const components = targets.components.map((component)=>`${component.name} (${component.id}; props ${Object.keys(component.props).join(', ') || 'none'})`);
+    return [
+        `Page: "${screen.title}" at ${screen.slug}`,
+        aiJobBriefLine(job),
+        ...aiPlanReferenceLines(plan),
+        `Sections to design, in order:`,
+        ...sections,
+        pages.length ? `Other pages of this site: ${pages.join(', ')}.` : 'This site has no other page to link.',
+        targets.forms.length ? `The site's form: ${targets.forms.map((form)=>`${form.name} (${form.id})`).join(', ')}.` : 'The site has no saved form: place none.',
+        ...components.length ? [
+            `Components this page may place: ${components.join('; ')}.`
+        ] : [],
+        input.reusableComponents ? 'Where a section repeats an item, place the component its plan line names with cards whose to is that component.' : 'This site keeps no reusable components: draw repeated items as cards, steps, stats or a list.',
+        // A per-job word, so two identical briefs are designed apart.
+        `Design seed: ${job.$id.slice(-6)}.`
+    ].join('\n');
+}
+/**
+ * The follow-up turn for the sections a page's answer left out (AGL-3660):
+ * the page as before, told which sections it already has, and asked for only
+ * the missing ones, in order — the one part of a page asked for again.
+ */ export function aiLayoutMissingSectionsPrompt(input) {
+    const names = input.missing.map((index)=>`${index + 1}. "${input.screen.sections[index].name}"`);
+    return [
+        input.base,
+        '',
+        `The other sections of this page are already designed. Design ONLY these, in this order, one entry in sections each: ${names.join('; ')}. Give each at least one block.`
+    ].join('\n');
+}
+/** The plan indices a page still lacks, after the answers so far. */ export function aiLayoutMissingSections(kept) {
+    return kept.flatMap((section, index)=>section ? [] : [
+            index
+        ]);
+}
+/** The violation a planned section the answer gave nothing usable for is named by. */ export const AI_LAYOUT_SECTION_MISSING_CODE = 'layout-section-missing';
+/**
+ * The check a language page answer is held to: each planned section read,
+ * the page compiled, stored and checked whole. Sections that read are kept
+ * across the re-ask, so the second answer is asked only for what was missing,
+ * and a section it sends again that already read is not taken twice.
+ */ export function aiLayoutPageCheck(input) {
+    var _input_kept, _input_only;
+    const kept = (_input_kept = input.kept) != null ? _input_kept : input.screen.sections.map(()=>null);
+    const fills = (_input_only = input.only) != null ? _input_only : input.screen.sections.map((_, index)=>index);
+    let answers = 0;
+    return (answer)=>{
+        // The last answer a generation takes has its gaps taken out rather than asked about again.
+        answers += 1;
+        const last = answers >= AI_GENERATION_MAX_ATTEMPTS;
+        const reading = aiReadLayoutPage(answer, fills.length);
+        reading.sections.forEach((section, position)=>{
+            // A section the answer gives is taken as given; one it leaves out keeps
+            // what an earlier answer gave, so a re-ask may send only what was missing.
+            if (section) kept[fills[position]] = section;
+        });
+        const missing = kept.flatMap((section, index)=>section ? [] : [
+                index
+            ]);
+        if (missing.length) {
+            const names = missing.map((index)=>`${index + 1} ("${input.screen.sections[index].name}")`);
+            return {
+                value: null,
+                violations: [
+                    {
+                        rule: null,
+                        code: AI_LAYOUT_SECTION_MISSING_CODE,
+                        message: `The page left out section ${names.join(', ')}.`,
+                        detail: `Answer again with every section in order; the sections you already designed are kept, so only ${names.join(', ')} ${missing.length === 1 ? 'needs' : 'need'} its design. Give each at least one block.`
+                    }
+                ]
+            };
+        }
+        const compiled = aiCompileLayoutPage(kept, {
+            title: input.screen.title,
+            sections: input.screen.sections
+        }, input.targets, {
+            reusableComponents: input.reusableComponents,
+            sectionIds: input.sectionIds
+        });
+        const stored = aiLayoutStoredTree(compiled.tree, 'screen', input.context, input.sectionIds);
+        if (stored.ok === false) {
+            // The compiler writes only palette trees, which the property spec holds;
+            // a refusal here is the platform's, and is reported as one.
+            console.error('ai layout page: a compiled page did not store', {
+                error: stored.error
+            });
+            return {
+                value: null,
+                violations: [
+                    {
+                        rule: null,
+                        code: 'layout-compile',
+                        message: 'This page could not be built. Try again.',
+                        detail: stored.error
+                    }
+                ]
+            };
+        }
+        // No gap and no internal reference in the words of a page that is published as built.
+        const copy = aiLayoutCopyCheck(stored.nodes, CANVAS_ROOT_ELEMENT_ID, {
+            pages: input.targets.pages,
+            ids: [
+                ...input.targets.pages.map((page)=>page.id),
+                ...input.targets.forms.map((form)=>form.id),
+                ...input.targets.components.map((component)=>component.id),
+                ...input.sectionIds,
+                ...input.targets.pageId ? [
+                    input.targets.pageId
+                ] : []
+            ]
+        }, last);
+        const { nodes, dropped } = copy;
+        const report = validateAiDoctrineTree({
+            rootId: CANVAS_ROOT_ELEMENT_ID,
+            nodes
+        }, 'page', _extends({}, input.context, {
+            scrollTargetIds: input.sectionIds
+        }));
+        // A street address or opening hours the job was never given is invented
+        // (rule 14, AGL-3596), the same check a layout is held to; a phone number
+        // or an email the compiler already writes as its gap.
+        const violations = [
+            ...report.violations,
+            ...copy.violations,
+            ...aiLayoutInventedContactViolations({
+                rootId: CANVAS_ROOT_ELEMENT_ID,
+                nodes: nodes
+            }, input.targets.facts)
+        ];
+        return {
+            value: violations.length ? null : {
+                nodes,
+                load: report.load,
+                settled: [
+                    ...reading.settled,
+                    ...compiled.settled
+                ],
+                dropped
+            },
+            violations
+        };
+    };
+}
+/** Two generations' spend as one: every call is billed. */ function spentTogether(first, second) {
+    const usage = {
+        inputTokens: first.usage.inputTokens + second.usage.inputTokens,
+        outputTokens: first.usage.outputTokens + second.usage.outputTokens,
+        cacheReadTokens: first.usage.cacheReadTokens + second.usage.cacheReadTokens,
+        cacheWriteTokens: first.usage.cacheWriteTokens + second.usage.cacheWriteTokens
+    };
+    return {
+        attempts: first.attempts + second.attempts,
+        usage,
+        estCostUsd: Math.round((first.estCostUsd + second.estCostUsd) * 1000000) / 1000000,
+        model: second.model,
+        stopReason: second.stopReason,
+        effort: second.effort
+    };
+}
+/**
+ * A whole page in the layout language: one answer for every section, and,
+ * where that answer and its re-ask still left a section out, one follow-up
+ * asking for only those (AGL-3660). The sections that read are kept between
+ * them, so the page is compiled whole once every section is designed.
+ */ export async function aiRunLayoutPage(input) {
+    var _input_observe;
+    const kept = input.screen.sections.map(()=>null);
+    const observe = (_input_observe = input.observe) != null ? _input_observe : (check)=>check;
+    const base = aiLayoutPagePrompt({
+        job: input.job,
+        plan: input.plan,
+        screen: input.screen,
+        targets: input.targets,
+        reusableComponents: input.reusableComponents
+    });
+    const ask = (content, maxTokens, only)=>runValidatedGeneration(AI_LAYOUT_PAGE_KIND, _extends({
+            step: 'job.page',
+            model: input.model,
+            instructions: AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS,
+            inventory: input.inventory,
+            messages: [
+                {
+                    role: 'user',
+                    content
+                }
+            ],
+            tool: AI_LAYOUT_PAGE_TOOL,
+            maxTokens,
+            cutOff: {
+                noun: 'page',
+                smaller: 'Write shorter copy, and fewer items in each group.'
+            },
+            thinking: 'off',
+            check: observe(aiLayoutPageCheck(_extends({
+                screen: input.screen,
+                sectionIds: input.sectionIds,
+                targets: input.targets,
+                context: input.context,
+                reusableComponents: input.reusableComponents,
+                kept
+            }, only ? {
+                only
+            } : {})))
+        }, input.signal ? {
+            signal: input.signal
+        } : {}));
+    const first = await ask(base, AI_JOB_PAGE_LANGUAGE_BUDGET.maxTokens(input.model));
+    const missing = aiLayoutMissingSections(kept);
+    if (first.status !== 'needs_input' || !missing.length || !first.violations.every((violation)=>violation.code === AI_LAYOUT_SECTION_MISSING_CODE)) {
+        return first;
+    }
+    const second = await ask(aiLayoutMissingSectionsPrompt({
+        base,
+        screen: input.screen,
+        missing
+    }), Math.min(AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS, AI_JOB_PAGE_LANGUAGE_BUDGET.maxTokens(input.model)), missing);
+    return _extends({}, second, spentTogether(first, second));
+}
+
+//# sourceMappingURL=ai-job-page-language.js.map

package/src/lib/jobs/ai-job-page-language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-page-language.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 { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { isAiPlanNewRef, type AiBuildPlanScreen } from '../model/ai-build-plan'\nimport type { AiJob, AiJobPlan } from '../model/ai-jobs.types'\nimport {\n  aiHomeScreenIds,\n  type AiSiteInventory,\n} from '../model/ai-site-inventory'\nimport { aiCompileLayoutPage } from '../layout-language/ai-layout-compiler'\nimport {\n  AI_LAYOUT_LANGUAGE_TEXT,\n  AI_LAYOUT_PAGE_TOOL,\n  aiReadLayoutPage,\n  type AiLayoutSection,\n  type AiLayoutSettlement,\n} from '../layout-language/ai-layout-language'\nimport type {\n  AiLayoutPage,\n  AiLayoutTargets,\n} from '../layout-language/ai-layout-links'\nimport { aiLayoutCopyCheck } from '../layout-language/ai-layout-gaps'\nimport { aiLayoutStoredTree } from '../layout-language/ai-layout-store'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport {\n  runValidatedGeneration,\n  type AiGenerationCheck,\n  type AiGenerationSpend,\n  type AiValidatedGeneration,\n} from '../runtime/ai-doctrine'\nimport type { AiUsage } from '../providers/contract'\nimport {\n  validateAiDoctrineTree,\n  type AiDoctrineNode,\n  type AiDoctrineTreeContext,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { aiGenerationWorstCaseOnTierMs, aiJobStepBudget } from './ai-job-budget'\nimport { aiJobBriefLine, aiPlanReferenceLines } from './ai-job-generation'\nimport { aiLayoutSitePages } from './ai-job-layout-site-pages'\nimport { aiLayoutInventedContactViolations } from './ai-layout-site-facts'\n\n/**\n * A page built in the compact layout language (AGL-3660): the page step's\n * pass for a site's page units — a guided start's and a build's — in place of\n * the raw-tree section passes.\n *\n * ONE answer a page: every planned section, in the language, through\n * `submit_page`. The compiler writes the tree, the palette validator stores\n * it as it stores any generated tree, and the doctrine checks the whole page.\n * A section the answer left out or left empty is the one thing a re-ask asks\n * for: the sections that read are kept, and the second answer fills only\n * what is still missing. Then the page step's last pass runs as it always\n * has — the whole page held to the doctrine again, its listing written, the\n * draft reported — so the item ledger, the credits and Try again work exactly\n * as they did.\n */\n\n/** The unit input that says a page or a layout is built in the layout language. */\nexport const AI_LAYOUT_LANGUAGE_INPUT = 'layoutLanguage'\n\n/** The unit input naming the page of the site that places its form, where it is another page. */\nexport const AI_LAYOUT_FORM_PAGE_INPUT = 'layoutFormPage'\n\n/** Whether this job builds its page or its layout in the layout language. */\nexport function aiJobUsesLayoutLanguage(job: Pick<AiJob, 'inputs'>): boolean {\n  return job.inputs?.[AI_LAYOUT_LANGUAGE_INPUT] === true\n}\n\n/**\n * The most one page's answer asks for. A section in the language is about\n * 120 to 250 tokens with its copy, so the largest page a plan admits — eight\n * sections — fits with room; the compiler, not the ceiling, keeps a page small.\n */\nexport const AI_JOB_PAGE_LANGUAGE_TOKENS = 3_000\n\n/**\n * The time a language page pass needs: its lookup rounds, its answer and its\n * re-ask at `AI_JOB_PAGE_LANGUAGE_TOKENS` on the tier the page step is served\n * from, with the step's reads and writes.\n */\n/** The most the follow-up asking only for the sections an answer left out may run to. */\nexport const AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS = 1_500\n\nexport const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.page'],\n  maxTokens: AI_JOB_PAGE_LANGUAGE_TOKENS,\n  // The follow-up for sections an answer left out is one more generation.\n  ownReadsMs: aiGenerationWorstCaseOnTierMs({\n    tier: AI_STEP_TIERS['job.page'],\n    maxTokens: AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS,\n  }),\n})\n\n/** The doctrine scope the language doors are told: values the compiler checks itself. */\nexport const AI_LAYOUT_PAGE_KIND = 'layout-page'\n\n/** The language, as the page door's cached instructions. */\nexport const AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      AI_LAYOUT_LANGUAGE_TEXT,\n      '',\n      'Answer with submit_page: the whole page, one entry in sections for each planned section, in order.',\n    ].join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\n/** The page of a site plan that places its form: the form the plan creates, or one the site has. */\nexport function aiLayoutFormPageOfPlan(\n  plan: Pick<AiJobPlan, 'create' | 'screens'>,\n  formIds: readonly string[] = [],\n): string | null {\n  const created = new Set(\n    plan.create\n      .filter((entry) => entry.kind === 'form')\n      .map((entry) => `new:${entry.name}`.toLowerCase()),\n  )\n  const forms = new Set(formIds)\n  const screen = plan.screens.find((entry) =>\n    entry.sections.some((section) =>\n      section.uses.some((ref) =>\n        isAiPlanNewRef(ref) ? created.has(ref.toLowerCase()) : forms.has(ref),\n      ),\n    ),\n  )\n  return typeof screen?.id === 'string' ? screen.id : null\n}\n\n/** Every word the job was given, which a page's contact details are held to. */\nexport function aiLayoutFacts(job: Pick<AiJob, 'brief' | 'inputs'>): string {\n  const values = Object.values(job.inputs ?? {}).filter(\n    (value): value is string => typeof value === 'string',\n  )\n  return [job.brief, ...values].join('\\n')\n}\n\n/** What a page's links resolve against: the site's pages, built and planned, its forms and components. */\nexport function aiLayoutPageTargets(input: {\n  job: Pick<AiJob, 'brief' | 'inputs'>\n  inventory: AiSiteInventory | null\n  own: ReadonlyArray<string | null | undefined>\n}): AiLayoutTargets {\n  const { job, inventory } = input\n  const own = input.own.filter((id): id is string => !!id)\n  const planned = aiLayoutSitePages(job.inputs)\n  const pages: AiLayoutPage[] = [\n    ...planned,\n    ...(inventory?.screens ?? [])\n      .filter(\n        (row) => !row.template && !planned.some((page) => page.id === row.id),\n      )\n      .map((row) => ({ id: row.id, label: row.name, slug: row.slug })),\n  ]\n  const formPage = job.inputs?.[AI_LAYOUT_FORM_PAGE_INPUT]\n  return {\n    pageId: own[0] ?? null,\n    pages: pages.filter((page) => !own.includes(page.id)),\n    homeIds: aiHomeScreenIds(inventory),\n    forms: (inventory?.forms ?? []).map((form) => ({\n      id: form.id,\n      name: form.name,\n    })),\n    formPageId:\n      typeof formPage === 'string' && !own.includes(formPage) ? formPage : null,\n    components: (inventory?.components ?? []).map((component) => ({\n      id: component.id,\n      name: component.name,\n      props: component.props,\n    })),\n    facts: aiLayoutFacts(job),\n  }\n}\n\n/** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */\nexport function aiLayoutPagePrompt(input: {\n  job: Pick<AiJob, 'brief' | 'inputs' | '$id'>\n  plan: AiJobPlan\n  screen: AiBuildPlanScreen\n  targets: AiLayoutTargets\n  reusableComponents: boolean\n  /** The sections a re-ask still needs, by plan index; absent on the first ask. */\n  missing?: readonly number[]\n}): string {\n  const { job, plan, screen, targets } = input\n  const sections = screen.sections.map((section, index) => {\n    const places = section.uses.length\n      ? `; places ${section.uses.join(', ')}`\n      : ''\n    const items = section.items ? `; shows ${section.items} items` : ''\n    return `${index + 1}. \"${section.name}\"${places}${items}`\n  })\n  const pages = targets.pages.map((page) => `${page.label} (page:${page.id})`)\n  const components = targets.components.map(\n    (component) =>\n      `${component.name} (${component.id}; props ${Object.keys(component.props).join(', ') || 'none'})`,\n  )\n  return [\n    `Page: \"${screen.title}\" at ${screen.slug}`,\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n    `Sections to design, in order:`,\n    ...sections,\n    pages.length\n      ? `Other pages of this site: ${pages.join(', ')}.`\n      : 'This site has no other page to link.',\n    targets.forms.length\n      ? `The site's form: ${targets.forms.map((form) => `${form.name} (${form.id})`).join(', ')}.`\n      : 'The site has no saved form: place none.',\n    ...(components.length\n      ? [`Components this page may place: ${components.join('; ')}.`]\n      : []),\n    input.reusableComponents\n      ? 'Where a section repeats an item, place the component its plan line names with cards whose to is that component.'\n      : 'This site keeps no reusable components: draw repeated items as cards, steps, stats or a list.',\n    // A per-job word, so two identical briefs are designed apart.\n    `Design seed: ${job.$id.slice(-6)}.`,\n  ].join('\\n')\n}\n\n/** A validated language page, stored as the page keeps it. */\nexport interface AiLayoutPageBuilt {\n  nodes: NodesMap\n  load: AiLoadEstimate | null\n  settled: AiLayoutSettlement[]\n  /** What the last answer's gaps took out of the page (`ai-layout-gaps.ts`). */\n  dropped: string[]\n}\n\nexport interface AiLayoutPageCheckInput {\n  screen: AiBuildPlanScreen\n  sectionIds: readonly string[]\n  targets: AiLayoutTargets\n  context: AiDoctrineTreeContext\n  reusableComponents: boolean\n  /**\n   * What earlier answers gave, by plan index, shared between the page's\n   * generations: a follow-up asking only for missing sections fills the rest.\n   */\n  kept?: Array<AiLayoutSection | null>\n  /** The plan indices this answer's sections fill, in order; absent, every section. */\n  only?: readonly number[]\n}\n\n/**\n * The follow-up turn for the sections a page's answer left out (AGL-3660):\n * the page as before, told which sections it already has, and asked for only\n * the missing ones, in order — the one part of a page asked for again.\n */\nexport function aiLayoutMissingSectionsPrompt(input: {\n  base: string\n  screen: AiBuildPlanScreen\n  missing: readonly number[]\n}): string {\n  const names = input.missing.map((index) => `${index + 1}. \"${input.screen.sections[index].name}\"`)\n  return [\n    input.base,\n    '',\n    `The other sections of this page are already designed. Design ONLY these, in this order, one entry in sections each: ${names.join('; ')}. Give each at least one block.`,\n  ].join('\\n')\n}\n\n/** The plan indices a page still lacks, after the answers so far. */\nexport function aiLayoutMissingSections(kept: ReadonlyArray<AiLayoutSection | null>): number[] {\n  return kept.flatMap((section, index) => (section ? [] : [index]))\n}\n\n/** The violation a planned section the answer gave nothing usable for is named by. */\nexport const AI_LAYOUT_SECTION_MISSING_CODE = 'layout-section-missing'\n\n/**\n * The check a language page answer is held to: each planned section read,\n * the page compiled, stored and checked whole. Sections that read are kept\n * across the re-ask, so the second answer is asked only for what was missing,\n * and a section it sends again that already read is not taken twice.\n */\nexport function aiLayoutPageCheck(\n  input: AiLayoutPageCheckInput,\n): AiGenerationCheck<AiLayoutPageBuilt> {\n  const kept: Array<AiLayoutSection | null> = input.kept ?? input.screen.sections.map(() => null)\n  const fills = input.only ?? input.screen.sections.map((_, index) => index)\n  let answers = 0\n  return (answer) => {\n    // The last answer a generation takes has its gaps taken out rather than asked about again.\n    answers += 1\n    const last = answers >= AI_GENERATION_MAX_ATTEMPTS\n    const reading = aiReadLayoutPage(answer, fills.length)\n    reading.sections.forEach((section, position) => {\n      // A section the answer gives is taken as given; one it leaves out keeps\n      // what an earlier answer gave, so a re-ask may send only what was missing.\n      if (section) kept[fills[position]] = section\n    })\n    const missing = kept.flatMap((section, index) => (section ? [] : [index]))\n    if (missing.length) {\n      const names = missing.map(\n        (index) => `${index + 1} (\"${input.screen.sections[index].name}\")`,\n      )\n      return {\n        value: null,\n        violations: [\n          {\n            rule: null,\n            code: AI_LAYOUT_SECTION_MISSING_CODE,\n            message: `The page left out section ${names.join(', ')}.`,\n            detail: `Answer again with every section in order; the sections you already designed are kept, so only ${names.join(', ')} ${missing.length === 1 ? 'needs' : 'need'} its design. Give each at least one block.`,\n          },\n        ],\n      }\n    }\n    const compiled = aiCompileLayoutPage(\n      kept as AiLayoutSection[],\n      { title: input.screen.title, sections: input.screen.sections },\n      input.targets,\n      {\n        reusableComponents: input.reusableComponents,\n        sectionIds: input.sectionIds,\n      },\n    )\n    const stored = aiLayoutStoredTree(\n      compiled.tree,\n      'screen',\n      input.context,\n      input.sectionIds,\n    )\n    if (stored.ok === false) {\n      // The compiler writes only palette trees, which the property spec holds;\n      // a refusal here is the platform's, and is reported as one.\n      console.error('ai layout page: a compiled page did not store', {\n        error: stored.error,\n      })\n      return {\n        value: null,\n        violations: [\n          {\n            rule: null,\n            code: 'layout-compile',\n            message: 'This page could not be built. Try again.',\n            detail: stored.error,\n          },\n        ],\n      }\n    }\n    // No gap and no internal reference in the words of a page that is published as built.\n    const copy = aiLayoutCopyCheck(\n      stored.nodes,\n      CANVAS_ROOT_ELEMENT_ID,\n      {\n        pages: input.targets.pages,\n        ids: [\n          ...input.targets.pages.map((page) => page.id),\n          ...input.targets.forms.map((form) => form.id),\n          ...input.targets.components.map((component) => component.id),\n          ...input.sectionIds,\n          ...(input.targets.pageId ? [input.targets.pageId] : []),\n        ],\n      },\n      last,\n    )\n    const { nodes, dropped } = copy\n    const report = validateAiDoctrineTree(\n      { rootId: CANVAS_ROOT_ELEMENT_ID, nodes },\n      'page',\n      {\n        ...input.context,\n        scrollTargetIds: input.sectionIds,\n      },\n    )\n    // A street address or opening hours the job was never given is invented\n    // (rule 14, AGL-3596), the same check a layout is held to; a phone number\n    // or an email the compiler already writes as its gap.\n    const violations: AiDoctrineViolation[] = [\n      ...report.violations,\n      ...copy.violations,\n      ...aiLayoutInventedContactViolations(\n        { rootId: CANVAS_ROOT_ELEMENT_ID, nodes: nodes as unknown as Record<string, AiDoctrineNode> },\n        input.targets.facts,\n      ),\n    ]\n    return {\n      value: violations.length\n        ? null\n        : {\n            nodes,\n            load: report.load,\n            settled: [...reading.settled, ...compiled.settled],\n            dropped,\n          },\n      violations,\n    }\n  }\n}\n\nexport interface AiLayoutPageRunInput {\n  job: Pick<AiJob, 'brief' | 'inputs' | '$id'>\n  plan: AiJobPlan\n  screen: AiBuildPlanScreen\n  sectionIds: readonly string[]\n  targets: AiLayoutTargets\n  context: AiDoctrineTreeContext\n  reusableComponents: boolean\n  inventory: AiSiteInventory | null\n  model: string\n  signal?: AbortSignal\n  /** Wraps the check, for an eval that records each answer it reads. */\n  observe?: (check: AiGenerationCheck<AiLayoutPageBuilt>) => AiGenerationCheck<AiLayoutPageBuilt>\n}\n\n/** Two generations' spend as one: every call is billed. */\nfunction spentTogether(first: AiGenerationSpend, second: AiGenerationSpend): AiGenerationSpend {\n  const usage: AiUsage = {\n    inputTokens: first.usage.inputTokens + second.usage.inputTokens,\n    outputTokens: first.usage.outputTokens + second.usage.outputTokens,\n    cacheReadTokens: first.usage.cacheReadTokens + second.usage.cacheReadTokens,\n    cacheWriteTokens: first.usage.cacheWriteTokens + second.usage.cacheWriteTokens,\n  }\n  return {\n    attempts: first.attempts + second.attempts,\n    usage,\n    estCostUsd: Math.round((first.estCostUsd + second.estCostUsd) * 1_000_000) / 1_000_000,\n    model: second.model,\n    stopReason: second.stopReason,\n    effort: second.effort,\n  }\n}\n\n/**\n * A whole page in the layout language: one answer for every section, and,\n * where that answer and its re-ask still left a section out, one follow-up\n * asking for only those (AGL-3660). The sections that read are kept between\n * them, so the page is compiled whole once every section is designed.\n */\nexport async function aiRunLayoutPage(input: AiLayoutPageRunInput): Promise<AiValidatedGeneration<AiLayoutPageBuilt>> {\n  const kept: Array<AiLayoutSection | null> = input.screen.sections.map(() => null)\n  const observe = input.observe ?? ((check) => check)\n  const base = aiLayoutPagePrompt({\n    job: input.job,\n    plan: input.plan,\n    screen: input.screen,\n    targets: input.targets,\n    reusableComponents: input.reusableComponents,\n  })\n  const ask = (content: string, maxTokens: number, only?: readonly number[]) =>\n    runValidatedGeneration<AiLayoutPageBuilt>(AI_LAYOUT_PAGE_KIND, {\n      step: 'job.page',\n      model: input.model,\n      instructions: AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS,\n      inventory: input.inventory,\n      messages: [{ role: 'user', content }],\n      tool: AI_LAYOUT_PAGE_TOOL,\n      maxTokens,\n      cutOff: { noun: 'page', smaller: 'Write shorter copy, and fewer items in each group.' },\n      thinking: 'off',\n      check: observe(\n        aiLayoutPageCheck({\n          screen: input.screen,\n          sectionIds: input.sectionIds,\n          targets: input.targets,\n          context: input.context,\n          reusableComponents: input.reusableComponents,\n          kept,\n          ...(only ? { only } : {}),\n        }),\n      ),\n      ...(input.signal ? { signal: input.signal } : {}),\n    })\n  const first = await ask(base, AI_JOB_PAGE_LANGUAGE_BUDGET.maxTokens(input.model))\n  const missing = aiLayoutMissingSections(kept)\n  if (\n    first.status !== 'needs_input' ||\n    !missing.length ||\n    !first.violations.every((violation) => violation.code === AI_LAYOUT_SECTION_MISSING_CODE)\n  ) {\n    return first\n  }\n  const second = await ask(\n    aiLayoutMissingSectionsPrompt({ base, screen: input.screen, missing }),\n    Math.min(AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS, AI_JOB_PAGE_LANGUAGE_BUDGET.maxTokens(input.model)),\n    missing,\n  )\n  return { ...second, ...spentTogether(first, second) }\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","isAiPlanNewRef","aiHomeScreenIds","aiCompileLayoutPage","AI_LAYOUT_LANGUAGE_TEXT","AI_LAYOUT_PAGE_TOOL","aiReadLayoutPage","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","AI_STEP_TIERS","runValidatedGeneration","validateAiDoctrineTree","aiGenerationWorstCaseOnTierMs","aiJobStepBudget","aiJobBriefLine","aiPlanReferenceLines","aiLayoutSitePages","aiLayoutInventedContactViolations","AI_LAYOUT_LANGUAGE_INPUT","AI_LAYOUT_FORM_PAGE_INPUT","aiJobUsesLayoutLanguage","job","inputs","AI_JOB_PAGE_LANGUAGE_TOKENS","AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS","AI_JOB_PAGE_LANGUAGE_BUDGET","tier","maxTokens","ownReadsMs","AI_LAYOUT_PAGE_KIND","AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS","text","join","cacheBreakpoint","aiLayoutFormPageOfPlan","plan","formIds","created","Set","create","filter","entry","kind","map","name","toLowerCase","forms","screen","screens","find","sections","some","section","uses","ref","has","id","aiLayoutFacts","values","Object","value","brief","aiLayoutPageTargets","input","own","inventory","planned","pages","row","template","page","label","slug","formPage","pageId","includes","homeIds","form","formPageId","components","component","props","facts","aiLayoutPagePrompt","targets","index","places","length","items","keys","title","reusableComponents","$id","slice","aiLayoutMissingSectionsPrompt","names","missing","base","aiLayoutMissingSections","kept","flatMap","AI_LAYOUT_SECTION_MISSING_CODE","aiLayoutPageCheck","fills","only","_","answers","answer","last","reading","forEach","position","violations","rule","code","message","detail","compiled","sectionIds","stored","tree","context","ok","console","error","copy","nodes","ids","dropped","report","rootId","scrollTargetIds","load","settled","spentTogether","first","second","usage","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","attempts","estCostUsd","Math","round","model","stopReason","effort","aiRunLayoutPage","observe","check","ask","content","step","instructions","messages","role","tool","cutOff","noun","smaller","thinking","signal","status","every","violation","min"],"mappings":"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"}

package/src/lib/jobs/ai-job-page-sections.d.ts

@@ -103,7 +103,34 @@ export interface AiPageSectionPromptInput {
     reusableComponents?: boolean;
     /** The dataset this page is the record template of; absent for a page that is one page. */
     record?: AiPageRecordTemplate | null;
+    /**
+     * The site's other pages a link may go to by id (AGL-3596): a guided
+     * start's pages are minted on its plan before any is built, so the Home
+     * page is built before the Contact page its buttons go to exists.
+     */
+    linkablePages?: readonly AiLinkablePage[];
 }
+/** A page of the site a section may link by its id, built or still to come. */
+export interface AiLinkablePage {
+    id: string;
+    label: string;
+    slug: string;
+}
+/**
+ * The pages a section may link by id beyond the ones the site has built, and
+ * the one page a link that names no destination can only mean (AGL-3596).
+ * `planned` are a guided start's pages, minted on its plan (the input the
+ * layout reads them from); `own` are this page's ids, which neither counts.
+ * The link target is the site's one page that is neither its home nor this
+ * page, where it has exactly one, built or planned: a two-page guided start's
+ * Contact page, which its Home hero's "Book an appointment" goes to.
+ */
+export declare function aiPageLinkablePages(inventory: AiSiteInventory | null, planned: readonly AiLinkablePage[], own: ReadonlyArray<string | null | undefined>): {
+    linkablePages: AiLinkablePage[];
+    linkTarget: string | null;
+};
+/** The line a section request names the site's other pages in. */
+export declare function aiPageSectionLinkablePagesLine(pages: readonly AiLinkablePage[]): string | null;
 /** What a section request says where the workspace keeps no reusable components. */
 export declare const AI_PAGE_SECTION_INLINE_LINE = "This site keeps no reusable components: write a repeated item once.";
 /**
@@ -207,6 +234,8 @@ export declare function aiPageCheckContext(inventory: AiSiteInventory | null, op
     embeds?: AiDoctrineTreeContext['plannedEmbeds'];
     /** A record template's tokens, which its links and images may name (AGL-3475). */
     recordTokens?: readonly string[];
+    /** The site's pages still to be built that a link may go to by id (AGL-3596). */
+    linkablePages?: readonly AiLinkablePage[];
 }): AiDoctrineTreeContext;
 export interface AiPageSectionCheckInput {
     /** The page as stored so far; an empty page on the first pass. */
@@ -221,11 +250,18 @@ export interface AiPageSectionCheckInput {
      */
     section: Pick<AiBuildPlanSection, 'name' | 'uses' | 'items'>;
     inventory: AiSiteInventory | null;
+    /**
+     * The one page a link that goes nowhere can only mean, where the site has
+     * exactly one page besides its home and this one (AGL-3596): a guided
+     * start's Contact page. Absent or `null`, such a link is re-asked.
+     */
+    linkTarget?: string | null;
 }
 /**
  * The check a section's answer is held to: a repeated item written once drawn
  * into its copies (AGL-3053), then the palette validator on the section, with
- * any line it cut at its ceiling refused (AGL-3076), the doctrine's page check
+ * any line it cut at its ceiling refused (AGL-3076), a Grid container's items
+ * sized where rule 12 has one answer (AGL-3596), the doctrine's page check
  * on the page with the section added, and the plan line — every component it
  * names placed as an instance, every form bound by its id (rule 7), and as
  * many items as it promised (AGL-3024). Violations