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

package/src/lib/jobs/ai-job-layout-step.d.ts

@@ -78,6 +78,11 @@ export declare function aiJobLayoutPrompt(job: Pick<AiJob, 'brief'> & Partial<Pi
  * component is placed rather than drawn again in the header.
  */
 export declare function aiLayoutReuseCheck(inventory: AiSiteInventory | null, plan: AiJobPlan | null): (tree: AiValidatedTree) => AiDoctrineViolation[];
+/**
+ * Every check the layout door adds to the doctrine's: the reuse and region
+ * checks above, and no contact detail the brief does not give (AGL-3596).
+ */
+export declare function aiLayoutChecks(inventory: AiSiteInventory | null, plan: AiJobPlan | null, brief: string): (tree: AiValidatedTree) => AiDoctrineViolation[];
 /**
  * The regions the confirmed plan gives the layout, against the layout a COPY
  * actually produced (AGL-3024); `null` when the copy keeps the plan, or when

package/src/lib/jobs/ai-job-layout-step.js

@@ -29,6 +29,11 @@ import { aiDraftAdmissionRefusal, aiDraftAllowanceRefusal, aiSiteSubdomain, read
 import { aiBracketedFactsNote, aiCopySourceLines, aiConfirmedPlan, aiDoctrineReview, aiGenerationSpent, aiJobBriefLine, aiLimitReview, aiModelNodeIds, aiPlacedComponentIds, aiPlanCreation, aiPlanReferenceLines, aiPlanReuseViolations, aiUnspentOutcome } from "./ai-job-generation.js";
 import { aiPlanRegionViolations, aiPlannedLayoutRegions } from "./ai-job-plan-conformance.js";
 import { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from "./ai-job-layout-site-pages.js";
+import { aiLayoutInventedContactViolations, aiLayoutWithSiteName } from "./ai-layout-site-facts.js";
+import { aiLayoutWithFullHeight } from "./ai-layout-full-height.js";
+import { AI_LAYOUT_FRAME_TOOL } from "../layout-language/ai-layout-language.js";
+import { AI_JOB_LAYOUT_LANGUAGE_BUDGET, AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS, AI_LAYOUT_FRAME_KIND, aiLayoutFrameCheck, aiLayoutFramePrompt, aiLayoutFrameTargets, aiLayoutHomeId, aiLayoutNavPages, aiLayoutSiteName } from "./ai-job-layout-language.js";
+import { aiJobUsesLayoutLanguage } from "./ai-job-page-language.js";
 import { aiJobStepBudget } from "./ai-job-budget.js";
 import { registerAiJobStep } from "./ai-jobs.js";
 /**
@@ -139,6 +144,24 @@ const FOOTER_NAME = /\bfooter\b/i;
         return violations;
     };
 }
+/**
+ * Every check the layout door adds to the doctrine's: the reuse and region
+ * checks above, and no contact detail the brief does not give (AGL-3596).
+ */ export function aiLayoutChecks(inventory, plan, brief) {
+    const reuse = aiLayoutReuseCheck(inventory, plan);
+    return (tree)=>[
+            ...reuse(tree),
+            ...aiLayoutInventedContactViolations({
+                rootId: tree.rootId,
+                nodes: tree.nodes
+            }, brief).map((violation)=>{
+                var _violation_nodeIds;
+                return _extends({}, violation, {
+                    nodeIds: aiModelNodeIds((_violation_nodeIds = violation.nodeIds) != null ? _violation_nodeIds : [], tree.sourceIds)
+                });
+            })
+        ];
+}
 /**
  * The regions the confirmed plan gives the layout, against the layout a COPY
  * actually produced (AGL-3024); `null` when the copy keeps the plan, or when
@@ -310,6 +333,77 @@ export function createAiJobLayoutStep(deps = {}) {
         if (allowance) return aiUnspentOutcome(model, {
             review: aiLimitReview(allowance)
         });
+        if (aiJobUsesLayoutLanguage(job)) {
+            // ── The header and footer designed in the layout language (AGL-3660) ──
+            const siteName = aiLayoutSiteName(job);
+            const pages = aiLayoutNavPages(job, inventory);
+            const targets = aiLayoutFrameTargets(job, inventory);
+            const result = await runValidatedGeneration(AI_LAYOUT_FRAME_KIND, _extends({
+                step: 'job.layout',
+                model,
+                instructions: AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,
+                inventory,
+                messages: [
+                    {
+                        role: 'user',
+                        content: aiLayoutFramePrompt({
+                            job,
+                            siteName,
+                            pages,
+                            targets
+                        })
+                    }
+                ],
+                tool: AI_LAYOUT_FRAME_TOOL,
+                maxTokens: AI_JOB_LAYOUT_LANGUAGE_BUDGET.maxTokens(model),
+                thinking: 'off',
+                check: aiLayoutFrameCheck({
+                    siteName,
+                    homeId: aiLayoutHomeId(pages, inventory),
+                    pages,
+                    targets,
+                    extend: aiLayoutChecks(inventory, plan, job.brief)
+                })
+            }, signal ? {
+                signal
+            } : {}));
+            const spent = aiGenerationSpent(result);
+            if (result.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (result.status === 'needs_input') return _extends({}, spent, {
+                review: aiDoctrineReview(result)
+            });
+            const draft = await writeAiDraft(firestore, {
+                kind: 'layout',
+                hostId,
+                id: draftId,
+                uid: job.createdBy,
+                org,
+                name,
+                nodes: result.value.nodes,
+                aiJobId: aiOriginJobId(job),
+                now
+            });
+            if (draft.ok === false) {
+                if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`);
+                return _extends({}, spent, {
+                    review: aiLimitReview(draft.error)
+                });
+            }
+            const note = aiBracketedFactsNote({
+                tree: {
+                    rootId: result.value.rootId,
+                    nodes: result.value.nodes
+                },
+                inventory
+            });
+            return _extends({}, spent, {
+                outputs: [
+                    output(draft, result.value.load, note)
+                ]
+            });
+        }
         // The pages a site scaffold builds after this layout (AGL-3596): their
         // ids are the plan's, so the header links them by id, written by the
         // platform before the doctrine checks the tree.
@@ -332,17 +426,23 @@ export function createAiJobLayoutStep(deps = {}) {
         } : {}, AI_ROUTING_TABLE['job.layout'].effort ? {
             effort: AI_ROUTING_TABLE['job.layout'].effort
         } : {}, {
-            extend: aiLayoutReuseCheck(inventory, plan)
+            extend: aiLayoutChecks(inventory, plan, job.brief),
+            // The site's name is written as the token that reads it, and the
+            // layout fills the window so a short page keeps its footer at the
+            // bottom (AGL-3596).
+            complete: (tree)=>{
+                var _job_inputs;
+                return aiLayoutWithFullHeight(aiLayoutWithSiteName(sitePages.length ? aiLayoutWithSitePages(tree, sitePages, {
+                    homeScreenIds: aiHomeScreenIds(inventory)
+                }) : tree, typeof ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['businessName']) === 'string' ? job.inputs['businessName'] : null));
+            }
         }, sitePages.length ? {
             context: {
                 screenIds: [
                     ...inventory.screens.map((screen)=>screen.id),
                     ...sitePages.map((page)=>page.id)
                 ]
-            },
-            complete: (tree)=>aiLayoutWithSitePages(tree, sitePages, {
-                    homeScreenIds: aiHomeScreenIds(inventory)
-                })
+            }
         } : {}, signal ? {
             signal
         } : {}));

package/src/lib/jobs/ai-job-layout-step.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-step.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 { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types'\nimport { aiHomeScreenIds, type AiSiteInventory } from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  aiDoctrineTreeTool,\n  runValidatedGeneration,\n  type AiValidatedTree,\n} from '../runtime/ai-doctrine'\nimport {\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport {\n  aiBuildingPlanCreations,\n  aiJobPlanCreationsRefusal,\n  aiPlanCreationsRunMinimumMs,\n} from './ai-job-plan-creations'\nimport { aiJobDraftId, aiOriginJobId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  readAiDraftNodes,\n  writeAiDraft,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiCopySourceLines,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiJobBriefLine,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiPlacedComponentIds,\n  aiPlanCreation,\n  aiPlanReferenceLines,\n  aiPlanReuseViolations,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport { aiPlanRegionViolations, aiPlannedLayoutRegions } from './ai-job-plan-conformance'\nimport { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from './ai-job-layout-site-pages'\nimport type { AiJobStepRunner } from './ai-job-text-step'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The layout step (AGL-2909): the generation step of a `layout` job, run once\n * a member confirmed the job's plan.\n *\n * It builds ONE shared layout — a header with the site's navigation, the\n * Layout Slot each page renders in, a footer — through\n * `runValidatedGeneration('layout', …)`, so every building rule holds on the\n * tree before it is kept, and adds three checks of its own through `extend`: a\n * component the confirmed plan reuses is placed (rule 7), every region the\n * plan gives the layout is built (AGL-3024), and a navigation or menu\n * component the site already has is placed rather than drawn again (rule 1).\n *\n * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and\n * no layout nests it, so nothing on the live site changes until a member\n * assigns it. A plan that starts from a copy of a layout the site has gets\n * that copy, through the platform's duplicate module, and nothing generated —\n * so the copy is read back and held to the plan's regions the same way\n * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one\n * branch where a promise can go unmet with no model to answer for it. A\n * source that already lacks a region the plan gives the layout is not copied\n * at all: the layout is built from it (AGL-3143 §14).\n *\n * A generation step runs on the job beat, never at an inline door: it\n * registers the least time its lookup rounds, its answer and its re-ask need\n * (AGL-3035), runs without extended thinking — the plan was reasoned out and\n * confirmed before it — and asks for no more of a tighter ceiling than the\n * doctrine's default for a layout than fits that time on the model it runs.\n */\n\n/** The longest answer a layout may run to; the tree is held to the layout budget either way. */\nexport const AI_JOB_LAYOUT_MAX_TOKENS = AI_ROUTING_TABLE['job.layout'].maxTokens\n\n/**\n * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup\n * rounds, its answer and its re-ask at the routing table's ceiling on the tier\n * `job.layout` is served from, fitted to what a beat can give a step.\n */\nexport const AI_JOB_LAYOUT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_MAX_TOKENS,\n})\n\n/** The least time one layout step needs before it starts. */\nexport const AI_JOB_LAYOUT_STEP_MINIMUM_MS = AI_JOB_LAYOUT_STEP_BUDGET.minimumMs\n\n/** A layout's name when the plan names none. */\nexport const AI_JOB_LAYOUT_DEFAULT_NAME = 'Site layout'\n\n/** The layout step's own instructions, cached after the doctrine. */\nexport const AI_JOB_LAYOUT_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one shared layout for a website: the frame every page of the site renders inside. Answer with submit_layout: the whole layout as one flat node map.',\n      'A layout is a header, one Layout Slot and a footer, top to bottom. The header is an App Bar (muiAppBar) holding a Toolbar Content (muiToolbar) with the site’s name as text and its navigation. The footer is a Section (section) whose element is footer.',\n      'Navigation links the site’s own pages by id: a Page Link (muiScreenLink) whose screenId is a page id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a page id, and never link a page by its address.',\n      'When the site inventory lists a component whose name says it is navigation, a menu or a mega menu, place it in the header as an instance instead of building the navigation again. Place every component the confirmed plan reuses.',\n      'The Layout Slot (layoutSlot) is where each page renders and is the page’s main landmark: leave its component unset or main, and put nothing inside it. A layout carries no h1, because every page brings its own.',\n    ].join('\\n'),\n  },\n]\n\n/**\n * The layout job as the generation's user turn: the name, the brief, the\n * confirmed plan, and the layout a short copy would have started from\n * (`aiCopySourceLines`, AGL-3143 §14).\n */\nexport function aiJobLayoutPrompt(\n  job: Pick<AiJob, 'brief'> & Partial<Pick<AiJob, 'inputs'>>,\n  plan: AiJobPlan | null,\n  name: string,\n  source: readonly string[] = [],\n): string {\n  return [\n    `Layout name: ${name}`,\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n    // A scaffold's layout is built before its pages, whose navigation the platform writes (AGL-3596).\n    ...aiLayoutSitePagesLines(aiLayoutSitePages(job.inputs)),\n    ...source,\n  ].join('\\n')\n}\n\n/** A component name that says it is the site's navigation; a footer's links are not. */\nconst NAVIGATION_NAME = /\\b(?:nav|navigation|navbar|menu|mega ?menu)\\b/i\nconst FOOTER_NAME = /\\bfooter\\b/i\n\n/** A node that links somewhere: a Screen Link, or a Button pointed at a screen or an address. */\nfunction isLink(node: AiDoctrineNode): boolean {\n  if (node.componentId === 'muiScreenLink') return true\n  return (\n    node.componentId === 'muiButton' &&\n    (typeof node.props?.['screenId'] === 'string' || typeof node.props?.['href'] === 'string')\n  )\n}\n\n/**\n * The layout door's checks on a tree the doctrine admitted: every component\n * the confirmed plan reuses is placed, every region the confirmed plan gives\n * the layout is built (AGL-3024), and navigation the site already keeps as a\n * component is placed rather than drawn again in the header.\n */\nexport function aiLayoutReuseCheck(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const components = inventory?.components ?? []\n  const navigation = components.filter(\n    (component) => NAVIGATION_NAME.test(component.name) && !FOOTER_NAME.test(component.name),\n  )\n  return (tree) => {\n    const placed = aiPlacedComponentIds(tree)\n    const violations: AiDoctrineViolation[] = [\n      ...aiPlanReuseViolations(inventory, plan, placed, 'layout'),\n      ...aiPlanRegionViolations(plan, {\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      }),\n    ]\n    if (navigation.length && !navigation.some((component) => placed.has(component.id))) {\n      const visits = walkTree({\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      })\n      const slot = visits.findIndex(({ node }) => node.componentId === 'layoutSlot')\n      const header = slot === -1 ? visits : visits.slice(0, slot)\n      const links = header.filter(({ node }) => isLink(node)).map(({ id }) => id)\n      if (links.length >= 2) {\n        violations.push({\n          rule: 1,\n          code: 'navigation-rebuilt',\n          message: `The site already has the \"${navigation[0].name}\" component. Place it in the header instead of building the navigation again.`,\n          nodeIds: aiModelNodeIds(links, tree.sourceIds),\n        })\n      }\n    }\n    return violations\n  }\n}\n\n/**\n * The regions the confirmed plan gives the layout, against the layout a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no region to keep.\n *\n * The duplicate branch generates nothing, so it is the one place a plan's\n * promise can go unmet without a model ever answering for it. A copy that\n * cannot be read — deleted between the write and this read, or stored under a\n * root this check does not know — settles nothing, and a promise this step\n * cannot settle is reviewed by a person rather than reported as kept.\n */\nexport async function aiCopiedLayoutReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; id: string; name: string; plan: AiJobPlan | null },\n): Promise<AiJobReview | null> {\n  const planned = aiPlannedLayoutRegions(input.plan)\n  if (!planned.regions.length && !planned.unreadable.length) return null\n  const stored = await readAiDraftNodes(firestore, {\n    kind: 'layout',\n    hostId: input.hostId,\n    id: input.id,\n  })\n  const nodes = (stored?.nodes ?? {}) as unknown as Record<string, AiDoctrineNode>\n  if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the layout the plan names, and this job could not read the copy back to check it has the regions the plan gives it. Open the layout and check it before you put a page in it.`,\n      findings: [],\n    }\n  }\n  const violations = aiPlanRegionViolations(input.plan, { rootId: CANVAS_ROOT_ELEMENT_ID, nodes })\n  if (!violations.length) return null\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the layout the plan names, and a copy is all it is: ${violations[0].message}`,\n    violations,\n  })\n}\n\n/**\n * A layout job is admitted for a site of the job's own org with a shared\n * layout to spare, and confirmed only for a plan whose other creations it\n * builds (AGL-3143 §15).\n */\nexport const aiLayoutJobAdmission: AiJobAdmission = (context) =>\n  aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'layout',\n    org: context.org,\n    ownCheck: (hostId) => aiJobPlanCreationsRefusal('layout', context, hostId),\n  })\n\nexport interface AiJobLayoutStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n}\n\nexport function createAiJobLayoutStep(deps: AiJobLayoutStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a layout job names no site, and its admission refuses one')\n    const output = (draft: AiDraftRecord, load?: AiLoadEstimate | null, note?: string | null): AiJobOutput => ({\n      resource: 'layout',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n      ...(note ? { note } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.layout') ?? aiModelForStep('job.layout')\n\n    // A run cut off after its draft was written reports that draft, found by the id the job recorded.\n    const draftId = aiJobDraftId(job, 'layout')\n    const written = await readAiDraft(firestore, { kind: 'layout', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'layout')\n    const name = creation?.name || AI_JOB_LAYOUT_DEFAULT_NAME\n\n    // The plan starts from a copy of a layout the site has (rule 15): the copy\n    // is the draft, and nothing is generated. A source gone since the plan\n    // was made is built from the brief instead. A source that cannot keep the\n    // plan's regions is built FROM instead (AGL-3143 §14), as the page step\n    // builds from a short source: copying it could only end in the review\n    // below, and Try again would copy the same thing. Only a source read and\n    // found short diverts; one this step cannot read still copies, and the\n    // review after the copy answers for it.\n    const source = creation?.duplicateOf\n      ? inventory.layouts.find((layout) => layout.id === creation.duplicateOf)\n      : undefined\n    const sourceReview = source\n      ? await aiCopiedLayoutReview(firestore, { hostId, id: source.id, plan, name: source.name })\n      : null\n    const sourceShort = Boolean(sourceReview?.findings.length)\n    const sourceTree =\n      source && sourceShort ? await readAiDraftNodes(firestore, { kind: 'layout', hostId, id: source.id }) : null\n    const sourceLines =\n      source && sourceShort ? aiCopySourceLines('layout', source.name, sourceTree?.nodes ?? null) : []\n    if (creation?.duplicateOf && source && !sourceShort) {\n      const copy = await duplicate('layout', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\n      })\n      if (copy.ok) {\n        // A copy is not a build (AGL-3024). This branch generates nothing, so\n        // whatever the plan promised BEYOND the source is not in the draft\n        // unless the source already had it: a plan reading \"from a copy of the\n        // base layout, adding a sidebar\" gets the base layout, the sidebar\n        // nowhere in it, and until now reported Done. The copy's own regions\n        // answer the plan's, and a copy that cannot be read answers nothing —\n        // which is a stop for a person, never a Done.\n        const review = await aiCopiedLayoutReview(firestore, { hostId, id: copy.id, plan, name })\n        if (review) return aiUnspentOutcome(model, { review })\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'layout', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    // The pages a site scaffold builds after this layout (AGL-3596): their\n    // ids are the plan's, so the header links them by id, written by the\n    // platform before the doctrine checks the tree.\n    const sitePages = aiLayoutSitePages(job.inputs)\n    const result = await runValidatedGeneration('layout', {\n      step: 'job.layout',\n      model,\n      instructions: AI_JOB_LAYOUT_INSTRUCTIONS,\n      inventory,\n      messages: [{ role: 'user', content: aiJobLayoutPrompt(job, plan, name, sourceLines) }],\n      tool: aiDoctrineTreeTool('layout'),\n      maxTokens: AI_JOB_LAYOUT_STEP_BUDGET.maxTokens(model),\n      ...(AI_ROUTING_TABLE['job.layout'].thinking ? { thinking: AI_ROUTING_TABLE['job.layout'].thinking } : {}),\n      ...(AI_ROUTING_TABLE['job.layout'].effort ? { effort: AI_ROUTING_TABLE['job.layout'].effort } : {}),\n      extend: aiLayoutReuseCheck(inventory, plan),\n      ...(sitePages.length\n        ? {\n            context: { screenIds: [...inventory.screens.map((screen) => screen.id), ...sitePages.map((page) => page.id)] },\n            complete: (tree: unknown) =>\n              aiLayoutWithSitePages(tree, sitePages, { homeScreenIds: aiHomeScreenIds(inventory) }),\n          }\n        : {}),\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    const draft = await writeAiDraft(firestore, {\n      kind: 'layout',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: result.value.nodes,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (draft.ok === false) {\n      if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n      return { ...spent, review: aiLimitReview(draft.error) }\n    }\n    // The facts the brief did not give, which the member fills before publishing (AGL-3056).\n    const note = aiBracketedFactsNote({\n      tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n      inventory,\n    })\n    return { ...spent, outputs: [output(draft, result.value.load, note)] }\n  }\n}\n\n/** The layout step, building the components and forms its plan creates before the layout (AGL-3143 §15). */\nexport const runAiJobLayoutStep = aiBuildingPlanCreations('layout', 'job.layout', createAiJobLayoutStep())\n\n/** Registers the layout step and the check a layout job passes before it is created or resumed. */\nexport function registerAiLayoutJob(): void {\n  registerAiJobStep('layout', runAiJobLayoutStep, {\n    minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS,\n    minimumMsFor: aiPlanCreationsRunMinimumMs('layout'),\n  })\n  registerAiJobAdmission('layout', aiLayoutJobAdmission)\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","duplicateResource","aiHomeScreenIds","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","readSiteInventory","registerAiJobAdmission","aiBuildingPlanCreations","aiJobPlanCreationsRefusal","aiPlanCreationsRunMinimumMs","aiJobDraftId","aiOriginJobId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","writeAiDraft","aiBracketedFactsNote","aiCopySourceLines","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReferenceLines","aiPlanReuseViolations","aiUnspentOutcome","aiPlanRegionViolations","aiPlannedLayoutRegions","aiLayoutSitePages","aiLayoutSitePagesLines","aiLayoutWithSitePages","aiJobStepBudget","registerAiJobStep","AI_JOB_LAYOUT_MAX_TOKENS","maxTokens","AI_JOB_LAYOUT_STEP_BUDGET","tier","AI_JOB_LAYOUT_STEP_MINIMUM_MS","minimumMs","AI_JOB_LAYOUT_DEFAULT_NAME","AI_JOB_LAYOUT_INSTRUCTIONS","text","join","aiJobLayoutPrompt","job","plan","name","source","inputs","NAVIGATION_NAME","FOOTER_NAME","isLink","node","componentId","props","aiLayoutReuseCheck","inventory","components","navigation","filter","component","test","tree","placed","violations","rootId","nodes","length","some","has","id","visits","slot","findIndex","header","slice","links","map","push","rule","code","message","nodeIds","sourceIds","aiCopiedLayoutReview","firestore","input","planned","regions","unreadable","stored","kind","hostId","reason","findings","aiLayoutJobAdmission","context","orgId","org","ownCheck","createAiJobLayoutStep","deps","readInventory","duplicate","now","signal","modelFor","orgSnapshot","Error","output","draft","load","note","resource","versionId","hostSubdomain","label","model","draftId","written","outputs","Promise","all","collection","doc","get","data","creation","duplicateOf","layouts","find","layout","undefined","sourceReview","sourceShort","Boolean","sourceTree","sourceLines","copy","sourceId","uid","createdBy","attemptKey","ok","review","status","error","allowance","sitePages","result","step","instructions","messages","role","content","tool","thinking","effort","extend","screenIds","screens","screen","page","complete","homeScreenIds","spent","refused","value","aiJobId","runAiJobLayoutStep","registerAiLayoutJob","minimumMsFor"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-step.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 { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types'\nimport { aiHomeScreenIds, type AiSiteInventory } from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  aiDoctrineTreeTool,\n  runValidatedGeneration,\n  type AiValidatedTree,\n} from '../runtime/ai-doctrine'\nimport {\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport {\n  aiBuildingPlanCreations,\n  aiJobPlanCreationsRefusal,\n  aiPlanCreationsRunMinimumMs,\n} from './ai-job-plan-creations'\nimport { aiJobDraftId, aiOriginJobId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  readAiDraftNodes,\n  writeAiDraft,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiCopySourceLines,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiJobBriefLine,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiPlacedComponentIds,\n  aiPlanCreation,\n  aiPlanReferenceLines,\n  aiPlanReuseViolations,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport { aiPlanRegionViolations, aiPlannedLayoutRegions } from './ai-job-plan-conformance'\nimport { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from './ai-job-layout-site-pages'\nimport { aiLayoutInventedContactViolations, aiLayoutWithSiteName } from './ai-layout-site-facts'\nimport { aiLayoutWithFullHeight } from './ai-layout-full-height'\nimport type { AiJobStepRunner } from './ai-job-text-step'\nimport { AI_LAYOUT_FRAME_TOOL } from '../layout-language/ai-layout-language'\nimport {\n  AI_JOB_LAYOUT_LANGUAGE_BUDGET,\n  AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,\n  AI_LAYOUT_FRAME_KIND,\n  aiLayoutFrameCheck,\n  aiLayoutFramePrompt,\n  aiLayoutFrameTargets,\n  aiLayoutHomeId,\n  aiLayoutNavPages,\n  aiLayoutSiteName,\n  type AiLayoutFrameBuilt,\n} from './ai-job-layout-language'\nimport { aiJobUsesLayoutLanguage } from './ai-job-page-language'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The layout step (AGL-2909): the generation step of a `layout` job, run once\n * a member confirmed the job's plan.\n *\n * It builds ONE shared layout — a header with the site's navigation, the\n * Layout Slot each page renders in, a footer — through\n * `runValidatedGeneration('layout', …)`, so every building rule holds on the\n * tree before it is kept, and adds three checks of its own through `extend`: a\n * component the confirmed plan reuses is placed (rule 7), every region the\n * plan gives the layout is built (AGL-3024), and a navigation or menu\n * component the site already has is placed rather than drawn again (rule 1).\n *\n * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and\n * no layout nests it, so nothing on the live site changes until a member\n * assigns it. A plan that starts from a copy of a layout the site has gets\n * that copy, through the platform's duplicate module, and nothing generated —\n * so the copy is read back and held to the plan's regions the same way\n * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one\n * branch where a promise can go unmet with no model to answer for it. A\n * source that already lacks a region the plan gives the layout is not copied\n * at all: the layout is built from it (AGL-3143 §14).\n *\n * A generation step runs on the job beat, never at an inline door: it\n * registers the least time its lookup rounds, its answer and its re-ask need\n * (AGL-3035), runs without extended thinking — the plan was reasoned out and\n * confirmed before it — and asks for no more of a tighter ceiling than the\n * doctrine's default for a layout than fits that time on the model it runs.\n */\n\n/** The longest answer a layout may run to; the tree is held to the layout budget either way. */\nexport const AI_JOB_LAYOUT_MAX_TOKENS = AI_ROUTING_TABLE['job.layout'].maxTokens\n\n/**\n * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup\n * rounds, its answer and its re-ask at the routing table's ceiling on the tier\n * `job.layout` is served from, fitted to what a beat can give a step.\n */\nexport const AI_JOB_LAYOUT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_MAX_TOKENS,\n})\n\n/** The least time one layout step needs before it starts. */\nexport const AI_JOB_LAYOUT_STEP_MINIMUM_MS = AI_JOB_LAYOUT_STEP_BUDGET.minimumMs\n\n/** A layout's name when the plan names none. */\nexport const AI_JOB_LAYOUT_DEFAULT_NAME = 'Site layout'\n\n/** The layout step's own instructions, cached after the doctrine. */\nexport const AI_JOB_LAYOUT_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one shared layout for a website: the frame every page of the site renders inside. Answer with submit_layout: the whole layout as one flat node map.',\n      'A layout is a header, one Layout Slot and a footer, top to bottom. The header is an App Bar (muiAppBar) holding a Toolbar Content (muiToolbar) with the site’s name as text and its navigation. The footer is a Section (section) whose element is footer.',\n      'Navigation links the site’s own pages by id: a Page Link (muiScreenLink) whose screenId is a page id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a page id, and never link a page by its address.',\n      'When the site inventory lists a component whose name says it is navigation, a menu or a mega menu, place it in the header as an instance instead of building the navigation again. Place every component the confirmed plan reuses.',\n      'The Layout Slot (layoutSlot) is where each page renders and is the page’s main landmark: leave its component unset or main, and put nothing inside it. A layout carries no h1, because every page brings its own.',\n    ].join('\\n'),\n  },\n]\n\n/**\n * The layout job as the generation's user turn: the name, the brief, the\n * confirmed plan, and the layout a short copy would have started from\n * (`aiCopySourceLines`, AGL-3143 §14).\n */\nexport function aiJobLayoutPrompt(\n  job: Pick<AiJob, 'brief'> & Partial<Pick<AiJob, 'inputs'>>,\n  plan: AiJobPlan | null,\n  name: string,\n  source: readonly string[] = [],\n): string {\n  return [\n    `Layout name: ${name}`,\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n    // A scaffold's layout is built before its pages, whose navigation the platform writes (AGL-3596).\n    ...aiLayoutSitePagesLines(aiLayoutSitePages(job.inputs)),\n    ...source,\n  ].join('\\n')\n}\n\n/** A component name that says it is the site's navigation; a footer's links are not. */\nconst NAVIGATION_NAME = /\\b(?:nav|navigation|navbar|menu|mega ?menu)\\b/i\nconst FOOTER_NAME = /\\bfooter\\b/i\n\n/** A node that links somewhere: a Screen Link, or a Button pointed at a screen or an address. */\nfunction isLink(node: AiDoctrineNode): boolean {\n  if (node.componentId === 'muiScreenLink') return true\n  return (\n    node.componentId === 'muiButton' &&\n    (typeof node.props?.['screenId'] === 'string' || typeof node.props?.['href'] === 'string')\n  )\n}\n\n/**\n * The layout door's checks on a tree the doctrine admitted: every component\n * the confirmed plan reuses is placed, every region the confirmed plan gives\n * the layout is built (AGL-3024), and navigation the site already keeps as a\n * component is placed rather than drawn again in the header.\n */\nexport function aiLayoutReuseCheck(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const components = inventory?.components ?? []\n  const navigation = components.filter(\n    (component) => NAVIGATION_NAME.test(component.name) && !FOOTER_NAME.test(component.name),\n  )\n  return (tree) => {\n    const placed = aiPlacedComponentIds(tree)\n    const violations: AiDoctrineViolation[] = [\n      ...aiPlanReuseViolations(inventory, plan, placed, 'layout'),\n      ...aiPlanRegionViolations(plan, {\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      }),\n    ]\n    if (navigation.length && !navigation.some((component) => placed.has(component.id))) {\n      const visits = walkTree({\n        rootId: tree.rootId,\n        nodes: tree.nodes as unknown as Record<string, AiDoctrineNode>,\n      })\n      const slot = visits.findIndex(({ node }) => node.componentId === 'layoutSlot')\n      const header = slot === -1 ? visits : visits.slice(0, slot)\n      const links = header.filter(({ node }) => isLink(node)).map(({ id }) => id)\n      if (links.length >= 2) {\n        violations.push({\n          rule: 1,\n          code: 'navigation-rebuilt',\n          message: `The site already has the \"${navigation[0].name}\" component. Place it in the header instead of building the navigation again.`,\n          nodeIds: aiModelNodeIds(links, tree.sourceIds),\n        })\n      }\n    }\n    return violations\n  }\n}\n\n/**\n * Every check the layout door adds to the doctrine's: the reuse and region\n * checks above, and no contact detail the brief does not give (AGL-3596).\n */\nexport function aiLayoutChecks(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n  brief: string,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const reuse = aiLayoutReuseCheck(inventory, plan)\n  return (tree) => [\n    ...reuse(tree),\n    ...aiLayoutInventedContactViolations(\n      { rootId: tree.rootId, nodes: tree.nodes as unknown as Record<string, AiDoctrineNode> },\n      brief,\n    ).map((violation) => ({ ...violation, nodeIds: aiModelNodeIds(violation.nodeIds ?? [], tree.sourceIds) })),\n  ]\n}\n\n/**\n * The regions the confirmed plan gives the layout, against the layout a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no region to keep.\n *\n * The duplicate branch generates nothing, so it is the one place a plan's\n * promise can go unmet without a model ever answering for it. A copy that\n * cannot be read — deleted between the write and this read, or stored under a\n * root this check does not know — settles nothing, and a promise this step\n * cannot settle is reviewed by a person rather than reported as kept.\n */\nexport async function aiCopiedLayoutReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; id: string; name: string; plan: AiJobPlan | null },\n): Promise<AiJobReview | null> {\n  const planned = aiPlannedLayoutRegions(input.plan)\n  if (!planned.regions.length && !planned.unreadable.length) return null\n  const stored = await readAiDraftNodes(firestore, {\n    kind: 'layout',\n    hostId: input.hostId,\n    id: input.id,\n  })\n  const nodes = (stored?.nodes ?? {}) as unknown as Record<string, AiDoctrineNode>\n  if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the layout the plan names, and this job could not read the copy back to check it has the regions the plan gives it. Open the layout and check it before you put a page in it.`,\n      findings: [],\n    }\n  }\n  const violations = aiPlanRegionViolations(input.plan, { rootId: CANVAS_ROOT_ELEMENT_ID, nodes })\n  if (!violations.length) return null\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the layout the plan names, and a copy is all it is: ${violations[0].message}`,\n    violations,\n  })\n}\n\n/**\n * A layout job is admitted for a site of the job's own org with a shared\n * layout to spare, and confirmed only for a plan whose other creations it\n * builds (AGL-3143 §15).\n */\nexport const aiLayoutJobAdmission: AiJobAdmission = (context) =>\n  aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'layout',\n    org: context.org,\n    ownCheck: (hostId) => aiJobPlanCreationsRefusal('layout', context, hostId),\n  })\n\nexport interface AiJobLayoutStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n}\n\nexport function createAiJobLayoutStep(deps: AiJobLayoutStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a layout job names no site, and its admission refuses one')\n    const output = (draft: AiDraftRecord, load?: AiLoadEstimate | null, note?: string | null): AiJobOutput => ({\n      resource: 'layout',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n      ...(note ? { note } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.layout') ?? aiModelForStep('job.layout')\n\n    // A run cut off after its draft was written reports that draft, found by the id the job recorded.\n    const draftId = aiJobDraftId(job, 'layout')\n    const written = await readAiDraft(firestore, { kind: 'layout', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'layout')\n    const name = creation?.name || AI_JOB_LAYOUT_DEFAULT_NAME\n\n    // The plan starts from a copy of a layout the site has (rule 15): the copy\n    // is the draft, and nothing is generated. A source gone since the plan\n    // was made is built from the brief instead. A source that cannot keep the\n    // plan's regions is built FROM instead (AGL-3143 §14), as the page step\n    // builds from a short source: copying it could only end in the review\n    // below, and Try again would copy the same thing. Only a source read and\n    // found short diverts; one this step cannot read still copies, and the\n    // review after the copy answers for it.\n    const source = creation?.duplicateOf\n      ? inventory.layouts.find((layout) => layout.id === creation.duplicateOf)\n      : undefined\n    const sourceReview = source\n      ? await aiCopiedLayoutReview(firestore, { hostId, id: source.id, plan, name: source.name })\n      : null\n    const sourceShort = Boolean(sourceReview?.findings.length)\n    const sourceTree =\n      source && sourceShort ? await readAiDraftNodes(firestore, { kind: 'layout', hostId, id: source.id }) : null\n    const sourceLines =\n      source && sourceShort ? aiCopySourceLines('layout', source.name, sourceTree?.nodes ?? null) : []\n    if (creation?.duplicateOf && source && !sourceShort) {\n      const copy = await duplicate('layout', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\n      })\n      if (copy.ok) {\n        // A copy is not a build (AGL-3024). This branch generates nothing, so\n        // whatever the plan promised BEYOND the source is not in the draft\n        // unless the source already had it: a plan reading \"from a copy of the\n        // base layout, adding a sidebar\" gets the base layout, the sidebar\n        // nowhere in it, and until now reported Done. The copy's own regions\n        // answer the plan's, and a copy that cannot be read answers nothing —\n        // which is a stop for a person, never a Done.\n        const review = await aiCopiedLayoutReview(firestore, { hostId, id: copy.id, plan, name })\n        if (review) return aiUnspentOutcome(model, { review })\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'layout', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    if (aiJobUsesLayoutLanguage(job)) {\n      // ── The header and footer designed in the layout language (AGL-3660) ──\n      const siteName = aiLayoutSiteName(job)\n      const pages = aiLayoutNavPages(job, inventory)\n      const targets = aiLayoutFrameTargets(job, inventory)\n      const result = await runValidatedGeneration<AiLayoutFrameBuilt>(AI_LAYOUT_FRAME_KIND, {\n        step: 'job.layout',\n        model,\n        instructions: AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,\n        inventory,\n        messages: [{ role: 'user', content: aiLayoutFramePrompt({ job, siteName, pages, targets }) }],\n        tool: AI_LAYOUT_FRAME_TOOL,\n        maxTokens: AI_JOB_LAYOUT_LANGUAGE_BUDGET.maxTokens(model),\n        thinking: 'off',\n        check: aiLayoutFrameCheck({\n          siteName,\n          homeId: aiLayoutHomeId(pages, inventory),\n          pages,\n          targets,\n          extend: aiLayoutChecks(inventory, plan, job.brief),\n        }),\n        ...(signal ? { signal } : {}),\n      })\n      const spent = aiGenerationSpent(result)\n      if (result.status === 'refused') return { ...spent, refused: true }\n      if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n      const draft = await writeAiDraft(firestore, {\n        kind: 'layout',\n        hostId,\n        id: draftId,\n        uid: job.createdBy,\n        org,\n        name,\n        nodes: result.value.nodes,\n        aiJobId: aiOriginJobId(job),\n        now,\n      })\n      if (draft.ok === false) {\n        if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n        return { ...spent, review: aiLimitReview(draft.error) }\n      }\n      const note = aiBracketedFactsNote({\n        tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n        inventory,\n      })\n      return { ...spent, outputs: [output(draft, result.value.load, note)] }\n    }\n\n    // The pages a site scaffold builds after this layout (AGL-3596): their\n    // ids are the plan's, so the header links them by id, written by the\n    // platform before the doctrine checks the tree.\n    const sitePages = aiLayoutSitePages(job.inputs)\n    const result = await runValidatedGeneration('layout', {\n      step: 'job.layout',\n      model,\n      instructions: AI_JOB_LAYOUT_INSTRUCTIONS,\n      inventory,\n      messages: [{ role: 'user', content: aiJobLayoutPrompt(job, plan, name, sourceLines) }],\n      tool: aiDoctrineTreeTool('layout'),\n      maxTokens: AI_JOB_LAYOUT_STEP_BUDGET.maxTokens(model),\n      ...(AI_ROUTING_TABLE['job.layout'].thinking ? { thinking: AI_ROUTING_TABLE['job.layout'].thinking } : {}),\n      ...(AI_ROUTING_TABLE['job.layout'].effort ? { effort: AI_ROUTING_TABLE['job.layout'].effort } : {}),\n      extend: aiLayoutChecks(inventory, plan, job.brief),\n      // The site's name is written as the token that reads it, and the\n      // layout fills the window so a short page keeps its footer at the\n      // bottom (AGL-3596).\n      complete: (tree: unknown) =>\n        aiLayoutWithFullHeight(\n          aiLayoutWithSiteName(\n            sitePages.length ? aiLayoutWithSitePages(tree, sitePages, { homeScreenIds: aiHomeScreenIds(inventory) }) : tree,\n            typeof job.inputs?.['businessName'] === 'string' ? job.inputs['businessName'] : null,\n          ),\n        ),\n      ...(sitePages.length\n        ? { context: { screenIds: [...inventory.screens.map((screen) => screen.id), ...sitePages.map((page) => page.id)] } }\n        : {}),\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    const draft = await writeAiDraft(firestore, {\n      kind: 'layout',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: result.value.nodes,\n      aiJobId: aiOriginJobId(job),\n      now,\n    })\n    if (draft.ok === false) {\n      if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`)\n      return { ...spent, review: aiLimitReview(draft.error) }\n    }\n    // The facts the brief did not give, which the member fills before publishing (AGL-3056).\n    const note = aiBracketedFactsNote({\n      tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n      inventory,\n    })\n    return { ...spent, outputs: [output(draft, result.value.load, note)] }\n  }\n}\n\n/** The layout step, building the components and forms its plan creates before the layout (AGL-3143 §15). */\nexport const runAiJobLayoutStep = aiBuildingPlanCreations('layout', 'job.layout', createAiJobLayoutStep())\n\n/** Registers the layout step and the check a layout job passes before it is created or resumed. */\nexport function registerAiLayoutJob(): void {\n  registerAiJobStep('layout', runAiJobLayoutStep, {\n    minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS,\n    minimumMsFor: aiPlanCreationsRunMinimumMs('layout'),\n  })\n  registerAiJobAdmission('layout', aiLayoutJobAdmission)\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","duplicateResource","aiHomeScreenIds","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","readSiteInventory","registerAiJobAdmission","aiBuildingPlanCreations","aiJobPlanCreationsRefusal","aiPlanCreationsRunMinimumMs","aiJobDraftId","aiOriginJobId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","writeAiDraft","aiBracketedFactsNote","aiCopySourceLines","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReferenceLines","aiPlanReuseViolations","aiUnspentOutcome","aiPlanRegionViolations","aiPlannedLayoutRegions","aiLayoutSitePages","aiLayoutSitePagesLines","aiLayoutWithSitePages","aiLayoutInventedContactViolations","aiLayoutWithSiteName","aiLayoutWithFullHeight","AI_LAYOUT_FRAME_TOOL","AI_JOB_LAYOUT_LANGUAGE_BUDGET","AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS","AI_LAYOUT_FRAME_KIND","aiLayoutFrameCheck","aiLayoutFramePrompt","aiLayoutFrameTargets","aiLayoutHomeId","aiLayoutNavPages","aiLayoutSiteName","aiJobUsesLayoutLanguage","aiJobStepBudget","registerAiJobStep","AI_JOB_LAYOUT_MAX_TOKENS","maxTokens","AI_JOB_LAYOUT_STEP_BUDGET","tier","AI_JOB_LAYOUT_STEP_MINIMUM_MS","minimumMs","AI_JOB_LAYOUT_DEFAULT_NAME","AI_JOB_LAYOUT_INSTRUCTIONS","text","join","aiJobLayoutPrompt","job","plan","name","source","inputs","NAVIGATION_NAME","FOOTER_NAME","isLink","node","componentId","props","aiLayoutReuseCheck","inventory","components","navigation","filter","component","test","tree","placed","violations","rootId","nodes","length","some","has","id","visits","slot","findIndex","header","slice","links","map","push","rule","code","message","nodeIds","sourceIds","aiLayoutChecks","brief","reuse","violation","aiCopiedLayoutReview","firestore","input","planned","regions","unreadable","stored","kind","hostId","reason","findings","aiLayoutJobAdmission","context","orgId","org","ownCheck","createAiJobLayoutStep","deps","readInventory","duplicate","now","signal","modelFor","orgSnapshot","Error","output","draft","load","note","resource","versionId","hostSubdomain","label","model","draftId","written","outputs","Promise","all","collection","doc","get","data","creation","duplicateOf","layouts","find","layout","undefined","sourceReview","sourceShort","Boolean","sourceTree","sourceLines","copy","sourceId","uid","createdBy","attemptKey","ok","review","status","error","allowance","siteName","pages","targets","result","step","instructions","messages","role","content","tool","thinking","check","homeId","extend","spent","refused","value","aiJobId","sitePages","effort","complete","homeScreenIds","screenIds","screens","screen","page","runAiJobLayoutStep","registerAiLayoutJob","minimumMsFor"],"mappings":"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"}

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

@@ -0,0 +1,149 @@
+/**
+ * @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 { NodesMap } from '@aglyn/aglyn/types/nodes';
+import { type AiBuildPlanScreen } from '../model/ai-build-plan';
+import type { AiJob, AiJobPlan } from '../model/ai-jobs.types';
+import { type AiSiteInventory } from '../model/ai-site-inventory';
+import { type AiLayoutSection, type AiLayoutSettlement } from '../layout-language/ai-layout-language';
+import type { AiLayoutTargets } from '../layout-language/ai-layout-links';
+import { type AiGenerationCheck, type AiValidatedGeneration } from '../runtime/ai-doctrine';
+import { type AiDoctrineTreeContext } from '../runtime/ai-doctrine-validators';
+import type { AiLoadEstimate } from '../runtime/ai-palette';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+/**
+ * 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 declare 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 declare const AI_LAYOUT_FORM_PAGE_INPUT = "layoutFormPage";
+/** Whether this job builds its page or its layout in the layout language. */
+export declare function aiJobUsesLayoutLanguage(job: Pick<AiJob, 'inputs'>): boolean;
+/**
+ * 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 declare 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 declare const AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS = 1500;
+export declare const AI_JOB_PAGE_LANGUAGE_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The doctrine scope the language doors are told: values the compiler checks itself. */
+export declare const AI_LAYOUT_PAGE_KIND = "layout-page";
+/** The language, as the page door's cached instructions. */
+export declare const AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The page of a site plan that places its form: the form the plan creates, or one the site has. */
+export declare function aiLayoutFormPageOfPlan(plan: Pick<AiJobPlan, 'create' | 'screens'>, formIds?: readonly string[]): string | null;
+/** Every word the job was given, which a page's contact details are held to. */
+export declare function aiLayoutFacts(job: Pick<AiJob, 'brief' | 'inputs'>): string;
+/** What a page's links resolve against: the site's pages, built and planned, its forms and components. */
+export declare function aiLayoutPageTargets(input: {
+    job: Pick<AiJob, 'brief' | 'inputs'>;
+    inventory: AiSiteInventory | null;
+    own: ReadonlyArray<string | null | undefined>;
+}): AiLayoutTargets;
+/** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */
+export declare function aiLayoutPagePrompt(input: {
+    job: Pick<AiJob, 'brief' | 'inputs' | '$id'>;
+    plan: AiJobPlan;
+    screen: AiBuildPlanScreen;
+    targets: AiLayoutTargets;
+    reusableComponents: boolean;
+    /** The sections a re-ask still needs, by plan index; absent on the first ask. */
+    missing?: readonly number[];
+}): string;
+/** A validated language page, stored as the page keeps it. */
+export interface AiLayoutPageBuilt {
+    nodes: NodesMap;
+    load: AiLoadEstimate | null;
+    settled: AiLayoutSettlement[];
+    /** What the last answer's gaps took out of the page (`ai-layout-gaps.ts`). */
+    dropped: string[];
+}
+export interface AiLayoutPageCheckInput {
+    screen: AiBuildPlanScreen;
+    sectionIds: readonly string[];
+    targets: AiLayoutTargets;
+    context: AiDoctrineTreeContext;
+    reusableComponents: boolean;
+    /**
+     * What earlier answers gave, by plan index, shared between the page's
+     * generations: a follow-up asking only for missing sections fills the rest.
+     */
+    kept?: Array<AiLayoutSection | null>;
+    /** The plan indices this answer's sections fill, in order; absent, every section. */
+    only?: readonly number[];
+}
+/**
+ * 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 declare function aiLayoutMissingSectionsPrompt(input: {
+    base: string;
+    screen: AiBuildPlanScreen;
+    missing: readonly number[];
+}): string;
+/** The plan indices a page still lacks, after the answers so far. */
+export declare function aiLayoutMissingSections(kept: ReadonlyArray<AiLayoutSection | null>): number[];
+/** The violation a planned section the answer gave nothing usable for is named by. */
+export declare 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 declare function aiLayoutPageCheck(input: AiLayoutPageCheckInput): AiGenerationCheck<AiLayoutPageBuilt>;
+export interface AiLayoutPageRunInput {
+    job: Pick<AiJob, 'brief' | 'inputs' | '$id'>;
+    plan: AiJobPlan;
+    screen: AiBuildPlanScreen;
+    sectionIds: readonly string[];
+    targets: AiLayoutTargets;
+    context: AiDoctrineTreeContext;
+    reusableComponents: boolean;
+    inventory: AiSiteInventory | null;
+    model: string;
+    signal?: AbortSignal;
+    /** Wraps the check, for an eval that records each answer it reads. */
+    observe?: (check: AiGenerationCheck<AiLayoutPageBuilt>) => AiGenerationCheck<AiLayoutPageBuilt>;
+}
+/**
+ * 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 declare function aiRunLayoutPage(input: AiLayoutPageRunInput): Promise<AiValidatedGeneration<AiLayoutPageBuilt>>;