@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-insight-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 type { ResolvedPluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport {\n  AI_INSIGHT_ASK_SURFACES,\n  AI_INSIGHT_DIGEST_DAYS,\n  AI_INSIGHT_DIGEST_READERS,\n  AI_INSIGHT_QUESTION_MAX_CHARS,\n  AI_INSIGHTS_COLLECTION,\n  aiInsightDays,\n  aiInsightOutput,\n  aiInsightSurface,\n  aiInsightSurfaceNeedsSite,\n  type AiInsightRecord,\n  type AiInsightSurface,\n  type AiInsightTable,\n} from '../model/ai-insight'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  AI_ACCEPTABLE_USE_BLOCK,\n  runAiRequest,\n  type AiMessage,\n  type AiResult,\n  type AiSystemBlock,\n  type AiUsage,\n} from '../runtime/ai-runtime'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport { checkAiInsightAnswer, type AiInsightCheck } from '../runtime/ai-insight-check'\nimport {\n  AI_INSIGHT_ANSWER_TOOL_NAME,\n  AI_INSIGHT_READ_TOOL_NAME,\n  aiInsightAnswerTool,\n  aiInsightReadTool,\n  parseAiInsightAnswer,\n  parseAiInsightReads,\n  type AiInsightReadRequest,\n} from '../tools/ai-insight-tool'\nimport { aiDatasetCatalog } from '../insights/ai-figure-readers'\nimport {\n  aiInsightDatasetCatalog,\n  aiInsightReaderCatalog,\n  aiInsightReaderDays,\n  aiInsightReaders,\n  aiInsightTableText,\n  readAiInsightTables,\n} from '../insights/ai-insight-readers'\nimport { assistExchangeExpiry } from '../usage/assist-usage'\nimport { registerAiJobAdmission, type AiJobAdmissionContext, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { AI_INSIGHT_READ_MAX_TOKENS, AI_JOB_INSIGHT_STEP_BUDGET, AI_JOB_INSIGHT_STEP_MINIMUM_MS } from './ai-job-insight-budget'\nimport type { AiJobStepContext, AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The `insight` step (AGL-2915): a question about a site's figures, answered\n * from tables code read, with every insight traced to the rows it cites.\n *\n * ## Two exchanges, and the model never writes a query\n *\n * 1. **The reads.** The model is shown the question and the readers this job\n *    may read — each an id, what it answers, its windows and parameters — and\n *    answers `read_figures` with a choice among them. It names nothing else: no\n *    collection, no field path, no filter. A choice that names no reader this\n *    job may read is dropped, and a job left with none reads the surface's\n *    defaults. A weekly digest makes no read call: code reads the digest's\n *    readers.\n * 2. **The answer.** Code reads the tables through the owners' readers, and the\n *    model is shown them and answers `submit_insights`. The trace\n *    (`runtime/ai-insight-check.ts`) keeps each insight whose every number is\n *    in a row it cites and leaves out the rest. An answer that is not a call,\n *    or whose every insight was left out, is asked for once more with the\n *    reasons; what the second answer keeps is the answer.\n *\n * Both calls share one allowance of output, twice the routing ceiling, which\n * is what the step's least time is planned against.\n *\n * ## What reaches the model\n *\n * The question, the names and descriptions of the readers, the tables, and\n * for a datasets question the names of the datasets the member may see with\n * their fields' names and types. A table holds counts, sums and rates labeled\n * by a page path, a referring site, a form's, a service's, a product's or a\n * campaign's name, or the values of a dataset field with at most sixty\n * different values that at least three records share. No\n * record, visitor, contact, order, booking, submission or recipient is read\n * into a prompt, and every text cell is masked of email addresses and phone\n * numbers on its way into a table.\n *\n * ## What it writes\n *\n * The answer, at `orgs/{orgId}/aiInsights/{jobId}` under the job's own\n * expiry, and an output that names it and says how many insights it holds.\n * Nothing else: no draft, no setting, no message.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\nexport const AI_INSIGHT_NO_SURFACE_COPY = 'This question does not say which page it was asked from.'\nexport const AI_INSIGHT_NO_SITE_COPY = 'Open the site whose numbers you are asking about.'\nexport const AI_INSIGHT_NO_READERS_COPY =\n  'There are no figures to answer from here yet: the features this page reports on are not on for this workspace.'\nexport const AI_INSIGHT_NO_TABLES_COPY = 'The figures could not be read. Try again in a moment.'\nexport const AI_INSIGHT_UNREADABLE_COPY = 'The AI did not answer with insights. Try asking in different words.'\n\n/** The digest's question: what a week's insights cover, in the order a person reads them. */\nexport const AI_INSIGHT_DIGEST_QUESTION =\n  'What changed on this site this week? Write the week’s insights: the change in traffic, the most viewed page, the form that turned the most views into submissions, a campaign that did better than the rest, and any day that stood out — only those the tables support.'\n\n/** The rules both calls are sent: static, byte-identical for every workspace. */\nexport const AI_INSIGHT_RULES = [\n  'You answer a workspace owner’s questions about their own figures: page views, orders, bookings, forms, campaigns, A/B tests and datasets. You never see a record, and you never write a query: code reads figures through fixed readers and gives you their tables.',\n  '',\n  `When you are given a question and a list of readers, call ${AI_INSIGHT_READ_TOOL_NAME} once with the readers whose tables answer it, most useful first, and the window each should cover. Choose only readers from the list, with their parameters' values taken from what the list and the question give you.`,\n  '',\n  `When you are given tables, call ${AI_INSIGHT_ANSWER_TOOL_NAME} once. Each table has a handle (t1, t2, …) and numbered rows. Rules for the insights:`,\n  '- Say what matters most to the question first. Leave out what the tables do not support.',\n  '- Every insight cites the table and the rows its figures come from.',\n  '- Every number you write appears in a row you cite, as the table shows it or rounded. Never add, subtract, average or otherwise compute a figure yourself. The only other numbers you may write are the length of a table’s window, a date in it, and how many rows you cite.',\n  '- Say a figure rose or fell only when a change you quote shows it.',\n  '- Name nobody, and write no email address or phone number.',\n  '- Plain sentences: no markdown, no headings, no lists.',\n  '- When the tables cannot answer part of the question, say so in gap in one sentence with no numbers; otherwise gap is null.',\n  '- Write in the language of the question.',\n].join('\\n')\n\n/** The system blocks both calls send: the rules and the platform's acceptable-use rules. */\nexport const AI_JOB_INSIGHT_SYSTEM: AiSystemBlock[] = [\n  { text: `${AI_INSIGHT_RULES}\\n\\n${AI_ACCEPTABLE_USE_BLOCK}`, cacheBreakpoint: true },\n]\n\nconst ZERO_USAGE: AiUsage = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 }\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** What the step's calls have spent so far, in the outcome's shape. */\nclass InsightSpend {\n  usage: AiUsage = { ...ZERO_USAGE }\n  estCostUsd = 0\n  stopReason: string | null = null\n\n  constructor(readonly model: string) {}\n\n  add(result: AiResult): void {\n    this.usage = {\n      inputTokens: this.usage.inputTokens + result.usage.inputTokens,\n      outputTokens: this.usage.outputTokens + result.usage.outputTokens,\n      cacheReadTokens: this.usage.cacheReadTokens + result.usage.cacheReadTokens,\n      cacheWriteTokens: this.usage.cacheWriteTokens + result.usage.cacheWriteTokens,\n    }\n    this.estCostUsd = Math.round((this.estCostUsd + result.estCostUsd) * 1_000_000) / 1_000_000\n    this.stopReason = result.stopReason\n  }\n\n  outcome(): Pick<AiJobStepOutcome, 'usage' | 'estCostUsd' | 'model' | 'stopReason' | 'effort'> {\n    return { usage: this.usage, estCostUsd: this.estCostUsd, model: this.model, stopReason: this.stopReason, effort: null }\n  }\n}\n\n/** The read call's user turn: the question, the window asked for, the readers and, for datasets, the datasets. */\nexport function aiInsightReadPrompt(input: {\n  question: string\n  days: number\n  readers: readonly ResolvedPluginFigureReader[]\n  datasets: string | null\n}): string {\n  return [\n    `Question: ${input.question}`,\n    `The window picked on the page: ${input.days} days. Use it unless the question names another window a reader lists.`,\n    'Readers you may read here:',\n    aiInsightReaderCatalog(input.readers),\n    ...(input.datasets === null ? [] : ['', 'Datasets you may read, with their fields:', input.datasets]),\n  ].join('\\n')\n}\n\n/** The answer call's user turn: the question and every table. */\nexport function aiInsightAnswerPrompt(question: string, tables: readonly AiInsightTable[]): string {\n  return [`Question: ${question}`, '', 'Tables:', '', tables.map(aiInsightTableText).join('\\n\\n')].join('\\n')\n}\n\n/** What a re-ask tells the model: why nothing it wrote could be kept. */\nexport function aiInsightReaskMessage(check: AiInsightCheck | null): string {\n  const reasons = check?.findings.length\n    ? `None of those insights could be kept: ${[...new Set(check.findings)].slice(0, 8).join('; ')}.`\n    : `That answer did not come through ${AI_INSIGHT_ANSWER_TOOL_NAME}.`\n  return `${reasons} Answer again with ${AI_INSIGHT_ANSWER_TOOL_NAME}: cite the rows each insight's figures are in, and write every number as a row you cite shows it.`\n}\n\n/** The reads a surface falls back to when the model named none it may read: the digest's own readers. */\nfunction defaultReads(readers: readonly ResolvedPluginFigureReader[], days: number): AiInsightReadRequest[] {\n  const ids = readers.map(({ reader }) => reader.id)\n  const preferred = AI_INSIGHT_DIGEST_READERS.filter((id) => ids.includes(id))\n  const chosen = preferred.length ? preferred : ids\n  return chosen.map((id) => ({\n    reader: id,\n    days: aiInsightReaderDays(readers.find(({ reader }) => reader.id === id)?.reader.windows ?? [], days),\n    params: {},\n  }))\n}\n\nasync function readHost(\n  firestore: Firestore,\n  orgId: string,\n  hostId: string | null,\n): Promise<{ host: Record<string, unknown> | null; ok: boolean }> {\n  if (!hostId) return { host: null, ok: true }\n  const snapshot = await firestore.collection('hosts').doc(hostId).get()\n  const host = snapshot.exists ? ((snapshot.data() ?? {}) as Record<string, unknown>) : null\n  return { host, ok: Boolean(host) && host?.['orgId'] === orgId }\n}\n\nexport const runAiJobInsightStep: AiJobStepRunner = async (context: AiJobStepContext) => {\n  const { job, firestore, signal, now } = context\n  const model = context.modelFor?.('job.insight') ?? aiModelForStep('job.insight')\n  const spend = new InsightSpend(model)\n  const stop = (failure: string): AiJobStepOutcome => ({ outputs: [], ...spend.outcome(), failure })\n\n  const surface = aiInsightSurface(job.inputs)\n  if (!surface) return stop(AI_INSIGHT_NO_SURFACE_COPY)\n  const hostId = job.hostId ?? null\n  if (aiInsightSurfaceNeedsSite(surface) && !hostId) return stop(AI_INSIGHT_NO_SITE_COPY)\n  // The door checks the caller belongs to the org; that the site does is\n  // checked here, before anything about it is read.\n  const site = await readHost(firestore, job.orgId, hostId)\n  if (!site.ok) return stop(AI_INSIGHT_NO_SITE_COPY)\n  const readers = await aiInsightReaders({\n    orgId: job.orgId,\n    hostId,\n    org: context.org ?? null,\n    host: site.host,\n    surface,\n  })\n  if (!readers.length) return stop(AI_INSIGHT_NO_READERS_COPY)\n\n  const digest = surface === 'digest'\n  const days = digest ? AI_INSIGHT_DIGEST_DAYS : aiInsightDays(job.inputs?.['days'])\n  const question = digest ? AI_INSIGHT_DIGEST_QUESTION : job.brief.slice(0, AI_INSIGHT_QUESTION_MAX_CHARS)\n  const maxTokens = AI_JOB_INSIGHT_STEP_BUDGET.maxTokens(model)\n  const allowance = AI_GENERATION_MAX_ATTEMPTS * maxTokens\n  const left = () => allowance - spend.usage.outputTokens\n  const ask = (messages: AiMessage[], tool: 'read' | 'answer', ceiling: number) =>\n    runAiRequest({\n      model,\n      system: AI_JOB_INSIGHT_SYSTEM,\n      messages,\n      tools: [tool === 'read' ? aiInsightReadTool() : aiInsightAnswerTool()],\n      maxTokens: Math.max(1, Math.min(ceiling, left())),\n      ...(AI_ROUTING_TABLE['job.insight'].thinking ? { thinking: AI_ROUTING_TABLE['job.insight'].thinking } : {}),\n      stream: false,\n      ...(signal ? { signal } : {}),\n    })\n\n  // 1. The reads.\n  const base = { orgId: job.orgId, hostId, uid: digest ? null : job.createdBy, now }\n  let requests: AiInsightReadRequest[]\n  if (digest) {\n    requests = defaultReads(readers, days)\n  } else {\n    const datasets =\n      surface === 'datasets'\n        ? aiInsightDatasetCatalog(await aiDatasetCatalog(firestore, { orgId: job.orgId, hostId, uid: job.createdBy }))\n        : null\n    const result = await ask(\n      [{ role: 'user', content: aiInsightReadPrompt({ question, days, readers, datasets }) }],\n      'read',\n      AI_INSIGHT_READ_MAX_TOKENS,\n    )\n    spend.add(result)\n    if (result.kind === 'refusal') return { outputs: [], ...spend.outcome(), refused: true }\n    requests = parseAiInsightReads(result.toolUse.find((use) => use.name === AI_INSIGHT_READ_TOOL_NAME)?.input)\n  }\n  const maxTables = digest ? AI_INSIGHT_DIGEST_READERS.length : undefined\n  let read = await readAiInsightTables(readers, requests, base, maxTables)\n  if (!read.tables.length && !digest) read = await readAiInsightTables(readers, defaultReads(readers, days), base)\n  if (read.refusals.length) console.warn('ai insight reads refused', { jobId: job.$id, refusals: read.refusals })\n  if (!read.tables.length) return stop(AI_INSIGHT_NO_TABLES_COPY)\n  const { tables } = read\n\n  // 2. The answer, and at most one re-ask.\n  let messages: AiMessage[] = [{ role: 'user', content: aiInsightAnswerPrompt(question, tables) }]\n  let checked: AiInsightCheck | null = null\n  for (let attempt = 0; attempt < AI_GENERATION_MAX_ATTEMPTS && left() > 0; attempt += 1) {\n    const result = await ask(messages, 'answer', maxTokens)\n    spend.add(result)\n    if (result.kind === 'refusal') return { outputs: [], ...spend.outcome(), refused: true }\n    const answer = parseAiInsightAnswer(result.toolUse.find((use) => use.name === AI_INSIGHT_ANSWER_TOOL_NAME)?.input)\n    const check = answer ? checkAiInsightAnswer(answer, tables) : null\n    if (check) checked = check\n    if (check && (check.kept.length || !answer?.insights.length)) break\n    messages = [\n      ...messages,\n      { role: 'assistant', content: `Answered with ${AI_INSIGHT_ANSWER_TOOL_NAME}.` },\n      { role: 'user', content: aiInsightReaskMessage(check) },\n    ]\n  }\n  if (!checked) return stop(AI_INSIGHT_UNREADABLE_COPY)\n\n  const record: AiInsightRecord = {\n    jobId: job.$id,\n    orgId: job.orgId,\n    hostId,\n    surface,\n    createdBy: job.createdBy,\n    question: digest ? str(job.brief) || 'Weekly insights' : question,\n    days,\n    insights: checked.kept,\n    gap: checked.gap,\n    tables,\n    left: checked.left.length,\n    week: digest ? str(job.inputs?.['week']) || null : null,\n    createdAtMs: now.getTime(),\n  }\n  if (checked.left.length) {\n    console.info('ai insight left out untraced insights', { jobId: job.$id, findings: checked.findings })\n  }\n  // Keyed by the job, so a step run again replaces its own answer.\n  await firestore\n    .collection('orgs')\n    .doc(job.orgId)\n    .collection(AI_INSIGHTS_COLLECTION)\n    .doc(job.$id)\n    .set({ ...(JSON.parse(JSON.stringify(record)) as AiInsightRecord), expiresAt: job.expiresAt ?? assistExchangeExpiry(now) })\n  return {\n    outputs: [aiInsightOutput(job, record, str(site.host?.['subdomain']) || null)],\n    ...spend.outcome(),\n  }\n}\n\n/**\n * Whether a question may be asked here: a surface a person asks from, a site\n * of the job's own org where the surface needs one, and at least one reader\n * the workspace may read. A digest is made by the weekly sweep and never at a\n * door.\n */\nexport async function aiInsightAdmissionRefusal(\n  context: AiJobAdmissionContext,\n): Promise<AiJobAdmissionRefusal | null> {\n  const surface: AiInsightSurface | null = aiInsightSurface(context.inputs)\n  if (!surface || !AI_INSIGHT_ASK_SURFACES.includes(surface)) {\n    return { status: 400, error: 'Ask about your numbers from a site’s Analytics, Data or CRM Reports page.' }\n  }\n  if (aiInsightSurfaceNeedsSite(surface) && !context.hostId) {\n    return { status: 400, error: AI_INSIGHT_NO_SITE_COPY }\n  }\n  const site = await readHost(context.firestore, context.orgId, context.hostId)\n  if (!site.ok) return { status: 404, error: 'Unknown site' }\n  const readers = await aiInsightReaders({\n    orgId: context.orgId,\n    hostId: context.hostId,\n    org: context.org,\n    host: site.host,\n    surface,\n  })\n  return readers.length ? null : { status: 403, error: AI_INSIGHT_NO_READERS_COPY }\n}\n\n/**\n * The insight kind's registrations, called by the console surface\n * (`registerAiJobKinds` in `server.ts`), never made by importing this module\n * (AGL-3025).\n */\nexport function registerAiInsightJob(): void {\n  registerAiJobStep('insight', runAiJobInsightStep, { minimumMs: AI_JOB_INSIGHT_STEP_MINIMUM_MS })\n  registerAiJobAdmission('insight', aiInsightAdmissionRefusal)\n}\n"],"names":["AI_INSIGHT_ASK_SURFACES","AI_INSIGHT_DIGEST_DAYS","AI_INSIGHT_DIGEST_READERS","AI_INSIGHT_QUESTION_MAX_CHARS","AI_INSIGHTS_COLLECTION","aiInsightDays","aiInsightOutput","aiInsightSurface","aiInsightSurfaceNeedsSite","AI_ROUTING_TABLE","aiModelForStep","AI_ACCEPTABLE_USE_BLOCK","runAiRequest","AI_GENERATION_MAX_ATTEMPTS","checkAiInsightAnswer","AI_INSIGHT_ANSWER_TOOL_NAME","AI_INSIGHT_READ_TOOL_NAME","aiInsightAnswerTool","aiInsightReadTool","parseAiInsightAnswer","parseAiInsightReads","aiDatasetCatalog","aiInsightDatasetCatalog","aiInsightReaderCatalog","aiInsightReaderDays","aiInsightReaders","aiInsightTableText","readAiInsightTables","assistExchangeExpiry","registerAiJobAdmission","AI_INSIGHT_READ_MAX_TOKENS","AI_JOB_INSIGHT_STEP_BUDGET","AI_JOB_INSIGHT_STEP_MINIMUM_MS","registerAiJobStep","AI_INSIGHT_NO_SURFACE_COPY","AI_INSIGHT_NO_SITE_COPY","AI_INSIGHT_NO_READERS_COPY","AI_INSIGHT_NO_TABLES_COPY","AI_INSIGHT_UNREADABLE_COPY","AI_INSIGHT_DIGEST_QUESTION","AI_INSIGHT_RULES","join","AI_JOB_INSIGHT_SYSTEM","text","cacheBreakpoint","ZERO_USAGE","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","str","value","trim","InsightSpend","add","result","usage","estCostUsd","Math","round","stopReason","outcome","model","effort","aiInsightReadPrompt","input","question","days","readers","datasets","aiInsightAnswerPrompt","tables","map","aiInsightReaskMessage","check","reasons","findings","length","Set","slice","defaultReads","ids","reader","id","preferred","filter","includes","chosen","find","windows","params","readHost","firestore","orgId","hostId","snapshot","host","ok","collection","doc","get","exists","data","Boolean","runAiJobInsightStep","context","job","site","signal","now","modelFor","spend","stop","failure","outputs","surface","inputs","org","digest","brief","maxTokens","allowance","left","ask","messages","tool","ceiling","system","tools","max","min","thinking","stream","base","uid","createdBy","requests","role","content","kind","refused","toolUse","use","name","maxTables","undefined","read","refusals","console","warn","jobId","$id","checked","attempt","answer","kept","insights","record","gap","week","createdAtMs","getTime","info","set","JSON","parse","stringify","expiresAt","aiInsightAdmissionRefusal","status","error","registerAiInsightJob","minimumMs"],"mappings":"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"}

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

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource';
+import type { AiJob, AiJobPlan, AiJobReview } from '../model/ai-jobs.types';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+import { type AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { readSiteInventory } from '../runtime/site-inventory';
+import { type AiJobAdmission } from './ai-job-admission';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The layout step (AGL-2909): the generation step of a `layout` job, run once
+ * a member confirmed the job's plan.
+ *
+ * It builds ONE shared layout — a header with the site's navigation, the
+ * Layout Slot each page renders in, a footer — through
+ * `runValidatedGeneration('layout', …)`, so every building rule holds on the
+ * tree before it is kept, and adds three checks of its own through `extend`: a
+ * component the confirmed plan reuses is placed (rule 7), every region the
+ * plan gives the layout is built (AGL-3024), and a navigation or menu
+ * component the site already has is placed rather than drawn again (rule 1).
+ *
+ * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and
+ * no layout nests it, so nothing on the live site changes until a member
+ * assigns it. A plan that starts from a copy of a layout the site has gets
+ * that copy, through the platform's duplicate module, and nothing generated —
+ * so the copy is read back and held to the plan's regions the same way
+ * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one
+ * branch where a promise can go unmet with no model to answer for it.
+ *
+ * A generation step runs on the job beat, never at an inline door: it
+ * registers the least time its lookup rounds, its answer and its re-ask need
+ * (AGL-3035), runs without extended thinking — the plan was reasoned out and
+ * confirmed before it — and asks for no more of a tighter ceiling than the
+ * doctrine's default for a layout than fits that time on the model it runs.
+ */
+/** The longest answer a layout may run to; the tree is held to the layout budget either way. */
+export declare const AI_JOB_LAYOUT_MAX_TOKENS: number;
+/**
+ * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup
+ * rounds, its answer and its re-ask at the routing table's ceiling on the tier
+ * `job.layout` is served from, fitted to what a beat can give a step.
+ */
+export declare const AI_JOB_LAYOUT_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one layout step needs before it starts. */
+export declare const AI_JOB_LAYOUT_STEP_MINIMUM_MS: number;
+/** A layout's name when the plan names none. */
+export declare const AI_JOB_LAYOUT_DEFAULT_NAME = "Site layout";
+/** The layout step's own instructions, cached after the doctrine. */
+export declare const AI_JOB_LAYOUT_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The layout job as the generation's user turn: the name, the brief, the confirmed plan. */
+export declare function aiJobLayoutPrompt(job: Pick<AiJob, 'brief'>, plan: AiJobPlan | null, name: string): string;
+/**
+ * The layout door's checks on a tree the doctrine admitted: every component
+ * the confirmed plan reuses is placed, every region the confirmed plan gives
+ * the layout is built (AGL-3024), and navigation the site already keeps as a
+ * component is placed rather than drawn again in the header.
+ */
+export declare function aiLayoutReuseCheck(inventory: AiSiteInventory | null, plan: AiJobPlan | null): (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
+ * the plan promised no region to keep.
+ *
+ * The duplicate branch generates nothing, so it is the one place a plan's
+ * promise can go unmet without a model ever answering for it. A copy that
+ * cannot be read — deleted between the write and this read, or stored under a
+ * root this check does not know — settles nothing, and a promise this step
+ * cannot settle is reviewed by a person rather than reported as kept.
+ */
+export declare function aiCopiedLayoutReview(firestore: FirebaseFirestore.Firestore, input: {
+    hostId: string;
+    id: string;
+    name: string;
+    plan: AiJobPlan | null;
+}): Promise<AiJobReview | null>;
+/** A layout job is admitted for a site of the job's own org with a shared layout to spare. */
+export declare const aiLayoutJobAdmission: AiJobAdmission;
+export interface AiJobLayoutStepDeps {
+    /** The inventory reader; specs hand in a fake. */
+    readInventory?: typeof readSiteInventory;
+    /** The platform's duplicate module, for a plan that starts from a copy. */
+    duplicate?: typeof duplicateResource;
+}
+export declare function createAiJobLayoutStep(deps?: AiJobLayoutStepDeps): AiJobStepRunner;
+export declare const runAiJobLayoutStep: AiJobStepRunner;
+/** Registers the layout step and the check a layout job passes before it is created or resumed. */
+export declare function registerAiLayoutJob(): void;

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

@@ -0,0 +1,340 @@
+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 { duplicateResource } from "@aglyn/tenant-data-admin/server/duplicate-resource";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
+import { aiDoctrineTreeTool, runValidatedGeneration } from "../runtime/ai-doctrine.js";
+import { walkTree } from "../runtime/ai-doctrine-validators.js";
+import { readSiteInventory } from "../runtime/site-inventory.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { aiJobDraftId } from "./ai-job-draft-ids.js";
+import { aiDraftAdmissionRefusal, aiDraftAllowanceRefusal, aiSiteSubdomain, readAiDraft, readAiDraftNodes, writeAiDraft } from "./ai-job-drafts.js";
+import { aiBracketedFactsNote, 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 { aiJobStepBudget } from "./ai-job-budget.js";
+import { registerAiJobStep } from "./ai-jobs.js";
+/**
+ * The layout step (AGL-2909): the generation step of a `layout` job, run once
+ * a member confirmed the job's plan.
+ *
+ * It builds ONE shared layout — a header with the site's navigation, the
+ * Layout Slot each page renders in, a footer — through
+ * `runValidatedGeneration('layout', …)`, so every building rule holds on the
+ * tree before it is kept, and adds three checks of its own through `extend`: a
+ * component the confirmed plan reuses is placed (rule 7), every region the
+ * plan gives the layout is built (AGL-3024), and a navigation or menu
+ * component the site already has is placed rather than drawn again (rule 1).
+ *
+ * The layout lands as a new draft (`ai-job-drafts.ts`): no screen uses it and
+ * no layout nests it, so nothing on the live site changes until a member
+ * assigns it. A plan that starts from a copy of a layout the site has gets
+ * that copy, through the platform's duplicate module, and nothing generated —
+ * so the copy is read back and held to the plan's regions the same way
+ * (`aiCopiedLayoutReview`), because a branch that generates nothing is the one
+ * branch where a promise can go unmet with no model to answer for it.
+ *
+ * A generation step runs on the job beat, never at an inline door: it
+ * registers the least time its lookup rounds, its answer and its re-ask need
+ * (AGL-3035), runs without extended thinking — the plan was reasoned out and
+ * confirmed before it — and asks for no more of a tighter ceiling than the
+ * doctrine's default for a layout than fits that time on the model it runs.
+ */ /** The longest answer a layout may run to; the tree is held to the layout budget either way. */ export const AI_JOB_LAYOUT_MAX_TOKENS = AI_ROUTING_TABLE['job.layout'].maxTokens;
+/**
+ * The layout step's time (AGL-3035, AGL-3036): its two inventory-lookup
+ * rounds, its answer and its re-ask at the routing table's ceiling on the tier
+ * `job.layout` is served from, fitted to what a beat can give a step.
+ */ export const AI_JOB_LAYOUT_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.layout'],
+    maxTokens: AI_JOB_LAYOUT_MAX_TOKENS
+});
+/** The least time one layout step needs before it starts. */ export const AI_JOB_LAYOUT_STEP_MINIMUM_MS = AI_JOB_LAYOUT_STEP_BUDGET.minimumMs;
+/** A layout's name when the plan names none. */ export const AI_JOB_LAYOUT_DEFAULT_NAME = 'Site layout';
+/** The layout step's own instructions, cached after the doctrine. */ export const AI_JOB_LAYOUT_INSTRUCTIONS = [
+    {
+        text: [
+            '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.',
+            '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.',
+            'Navigation links the site’s own screens by id: a Screen Link (muiScreenLink) whose screenId is a screen id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a screen id, and never link a screen by its address.',
+            '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.',
+            '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.'
+        ].join('\n')
+    }
+];
+/** The layout job as the generation's user turn: the name, the brief, the confirmed plan. */ export function aiJobLayoutPrompt(job, plan, name) {
+    return [
+        `Layout name: ${name}`,
+        aiJobBriefLine(job),
+        ...aiPlanReferenceLines(plan)
+    ].join('\n');
+}
+/** A component name that says it is the site's navigation; a footer's links are not. */ const NAVIGATION_NAME = /\b(?:nav|navigation|navbar|menu|mega ?menu)\b/i;
+const FOOTER_NAME = /\bfooter\b/i;
+/** A node that links somewhere: a Screen Link, or a Button pointed at a screen or an address. */ function isLink(node) {
+    var _node_props, _node_props1;
+    if (node.componentId === 'muiScreenLink') return true;
+    return node.componentId === 'muiButton' && (typeof ((_node_props = node.props) == null ? void 0 : _node_props['screenId']) === 'string' || typeof ((_node_props1 = node.props) == null ? void 0 : _node_props1['href']) === 'string');
+}
+/**
+ * The layout door's checks on a tree the doctrine admitted: every component
+ * the confirmed plan reuses is placed, every region the confirmed plan gives
+ * the layout is built (AGL-3024), and navigation the site already keeps as a
+ * component is placed rather than drawn again in the header.
+ */ export function aiLayoutReuseCheck(inventory, plan) {
+    var _ref;
+    const components = (_ref = inventory == null ? void 0 : inventory.components) != null ? _ref : [];
+    const navigation = components.filter((component)=>NAVIGATION_NAME.test(component.name) && !FOOTER_NAME.test(component.name));
+    return (tree)=>{
+        const placed = aiPlacedComponentIds(tree);
+        const violations = [
+            ...aiPlanReuseViolations(inventory, plan, placed, 'layout'),
+            ...aiPlanRegionViolations(plan, {
+                rootId: tree.rootId,
+                nodes: tree.nodes
+            })
+        ];
+        if (navigation.length && !navigation.some((component)=>placed.has(component.id))) {
+            const visits = walkTree({
+                rootId: tree.rootId,
+                nodes: tree.nodes
+            });
+            const slot = visits.findIndex(({ node })=>node.componentId === 'layoutSlot');
+            const header = slot === -1 ? visits : visits.slice(0, slot);
+            const links = header.filter(({ node })=>isLink(node)).map(({ id })=>id);
+            if (links.length >= 2) {
+                violations.push({
+                    rule: 1,
+                    code: 'navigation-rebuilt',
+                    message: `The site already has the "${navigation[0].name}" component. Place it in the header instead of building the navigation again.`,
+                    nodeIds: aiModelNodeIds(links, tree.sourceIds)
+                });
+            }
+        }
+        return violations;
+    };
+}
+/**
+ * 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
+ * the plan promised no region to keep.
+ *
+ * The duplicate branch generates nothing, so it is the one place a plan's
+ * promise can go unmet without a model ever answering for it. A copy that
+ * cannot be read — deleted between the write and this read, or stored under a
+ * root this check does not know — settles nothing, and a promise this step
+ * cannot settle is reviewed by a person rather than reported as kept.
+ */ export async function aiCopiedLayoutReview(firestore, input) {
+    var _ref;
+    const planned = aiPlannedLayoutRegions(input.plan);
+    if (!planned.regions.length && !planned.unreadable.length) return null;
+    const stored = await readAiDraftNodes(firestore, {
+        kind: 'layout',
+        hostId: input.hostId,
+        id: input.id
+    });
+    const nodes = (_ref = stored == null ? void 0 : stored.nodes) != null ? _ref : {};
+    if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {
+        return {
+            reason: 'doctrine',
+            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.`,
+            findings: []
+        };
+    }
+    const violations = aiPlanRegionViolations(input.plan, {
+        rootId: CANVAS_ROOT_ELEMENT_ID,
+        nodes
+    });
+    if (!violations.length) return null;
+    return aiDoctrineReview({
+        message: `"${input.name}" is a copy of the layout the plan names, and a copy is all it is: ${violations[0].message}`,
+        violations
+    });
+}
+/** A layout job is admitted for a site of the job's own org with a shared layout to spare. */ export const aiLayoutJobAdmission = (context)=>aiDraftAdmissionRefusal(context.firestore, {
+        orgId: context.orgId,
+        hostId: context.hostId,
+        kind: 'layout',
+        org: context.org
+    });
+export function createAiJobLayoutStep(deps = {}) {
+    var _deps_readInventory, _deps_duplicate;
+    const readInventory = (_deps_readInventory = deps.readInventory) != null ? _deps_readInventory : readSiteInventory;
+    const duplicate = (_deps_duplicate = deps.duplicate) != null ? _deps_duplicate : duplicateResource;
+    return async ({ job, now, signal, firestore, modelFor })=>{
+        var _ref, _orgSnapshot_data;
+        const hostId = job.hostId;
+        if (!hostId) throw new Error('a layout job names no site, and its admission refuses one');
+        const output = (draft, load, note)=>_extends({
+                resource: 'layout',
+                id: draft.id,
+                versionId: draft.versionId,
+                hostId,
+                hostSubdomain: draft.hostSubdomain,
+                label: draft.name
+            }, load ? {
+                load
+            } : {}, note ? {
+                note
+            } : {});
+        // The switch's answer for this job, else the routing table's (AGL-2942).
+        const model = (_ref = modelFor == null ? void 0 : modelFor('job.layout')) != null ? _ref : aiModelForStep('job.layout');
+        // A run cut off after its draft was written reports that draft, found by the id the job recorded.
+        const draftId = aiJobDraftId(job, 'layout');
+        const written = await readAiDraft(firestore, {
+            kind: 'layout',
+            hostId,
+            id: draftId
+        });
+        if (written) return aiUnspentOutcome(model, {
+            outputs: [
+                output(written)
+            ]
+        });
+        const [inventory, orgSnapshot] = await Promise.all([
+            readInventory(job.orgId, hostId, {
+                firestore
+            }),
+            firestore.collection('orgs').doc(job.orgId).get()
+        ]);
+        const org = (_orgSnapshot_data = orgSnapshot.data()) != null ? _orgSnapshot_data : null;
+        const plan = aiConfirmedPlan(job);
+        const creation = aiPlanCreation(plan, 'layout');
+        const name = (creation == null ? void 0 : creation.name) || AI_JOB_LAYOUT_DEFAULT_NAME;
+        // The plan starts from a copy of a layout the site has (rule 15): the copy
+        // is the draft, and nothing is generated. A source gone since the plan
+        // was made is built from the brief instead.
+        if ((creation == null ? void 0 : creation.duplicateOf) && inventory.layouts.some((layout)=>layout.id === creation.duplicateOf)) {
+            const copy = await duplicate('layout', {
+                orgId: job.orgId,
+                hostId,
+                sourceId: creation.duplicateOf,
+                name,
+                uid: job.createdBy,
+                org: org
+            });
+            if (copy.ok) {
+                // A copy is not a build (AGL-3024). This branch generates nothing, so
+                // whatever the plan promised BEYOND the source is not in the draft
+                // unless the source already had it: a plan reading "from a copy of the
+                // base layout, adding a sidebar" gets the base layout, the sidebar
+                // nowhere in it, and until now reported Done. The copy's own regions
+                // answer the plan's, and a copy that cannot be read answers nothing —
+                // which is a stop for a person, never a Done.
+                const review = await aiCopiedLayoutReview(firestore, {
+                    hostId,
+                    id: copy.id,
+                    plan,
+                    name
+                });
+                if (review) return aiUnspentOutcome(model, {
+                    review
+                });
+                const hostSubdomain = await aiSiteSubdomain(firestore, hostId);
+                return aiUnspentOutcome(model, {
+                    outputs: [
+                        output({
+                            id: copy.id,
+                            versionId: copy.versionId,
+                            name: copy.name,
+                            hostSubdomain
+                        })
+                    ]
+                });
+            }
+            if (copy.ok === false && copy.status === 403) {
+                return aiUnspentOutcome(model, {
+                    review: aiLimitReview(copy.error)
+                });
+            }
+        }
+        const allowance = await aiDraftAllowanceRefusal(firestore, {
+            kind: 'layout',
+            hostId,
+            org
+        });
+        if (allowance) return aiUnspentOutcome(model, {
+            review: aiLimitReview(allowance)
+        });
+        const result = await runValidatedGeneration('layout', _extends({
+            step: 'job.layout',
+            model,
+            instructions: AI_JOB_LAYOUT_INSTRUCTIONS,
+            inventory,
+            messages: [
+                {
+                    role: 'user',
+                    content: aiJobLayoutPrompt(job, plan, name)
+                }
+            ],
+            tool: aiDoctrineTreeTool('layout'),
+            maxTokens: AI_JOB_LAYOUT_STEP_BUDGET.maxTokens(model)
+        }, AI_ROUTING_TABLE['job.layout'].thinking ? {
+            thinking: AI_ROUTING_TABLE['job.layout'].thinking
+        } : {}, AI_ROUTING_TABLE['job.layout'].effort ? {
+            effort: AI_ROUTING_TABLE['job.layout'].effort
+        } : {}, {
+            extend: aiLayoutReuseCheck(inventory, plan)
+        }, 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,
+            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)
+            });
+        }
+        // The facts the brief did not give, which the member fills before publishing (AGL-3056).
+        const note = aiBracketedFactsNote({
+            tree: {
+                rootId: result.value.rootId,
+                nodes: result.value.nodes
+            },
+            inventory
+        });
+        return _extends({}, spent, {
+            outputs: [
+                output(draft, result.value.load, note)
+            ]
+        });
+    };
+}
+export const runAiJobLayoutStep = createAiJobLayoutStep();
+/** Registers the layout step and the check a layout job passes before it is created or resumed. */ export function registerAiLayoutJob() {
+    registerAiJobStep('layout', runAiJobLayoutStep, {
+        minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission('layout', aiLayoutJobAdmission);
+}
+
+//# sourceMappingURL=ai-job-layout-step.js.map

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

@@ -0,0 +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 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 { aiJobDraftId } 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  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 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.\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 screens by id: a Screen Link (muiScreenLink) whose screenId is a screen id from the site inventory, in the order the brief and the confirmed plan give, seven at most in the header. Never invent a screen id, and never link a screen 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/** The layout job as the generation's user turn: the name, the brief, the confirmed plan. */\nexport function aiJobLayoutPrompt(\n  job: Pick<AiJob, 'brief'>,\n  plan: AiJobPlan | null,\n  name: string,\n): string {\n  return [`Layout name: ${name}`, aiJobBriefLine(job), ...aiPlanReferenceLines(plan)].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/** A layout job is admitted for a site of the job's own org with a shared layout to spare. */\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  })\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.\n    if (creation?.duplicateOf && inventory.layouts.some((layout) => layout.id === creation.duplicateOf)) {\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      })\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    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) }],\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      ...(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      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\nexport const runAiJobLayoutStep = 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, { minimumMs: AI_JOB_LAYOUT_STEP_MINIMUM_MS })\n  registerAiJobAdmission('layout', aiLayoutJobAdmission)\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","duplicateResource","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","readSiteInventory","registerAiJobAdmission","aiJobDraftId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","writeAiDraft","aiBracketedFactsNote","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReferenceLines","aiPlanReuseViolations","aiUnspentOutcome","aiPlanRegionViolations","aiPlannedLayoutRegions","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","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","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","layout","copy","sourceId","uid","createdBy","ok","review","status","error","allowance","result","step","instructions","messages","role","content","tool","thinking","effort","extend","spent","refused","value","runAiJobLayoutStep","registerAiLayoutJob"],"mappings":"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"}

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

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The time a page pass needs (AGL-2907, AGL-3036), declared apart from the
+ * page step: the site scaffold builds its pages through that step, and reads
+ * the time a page needs without loading the step it hands them to.
+ */
+/** The most one section's answer may run to on any model; slower tiers get less. */
+export declare const AI_JOB_PAGE_SECTION_MAX_TOKENS = 2000;
+/**
+ * The ceiling a section's answer asks on the tier the page step is served
+ * from (AGL-2907): fifteen elements at `AI_JOB_PAGE_REAL_TOKENS_PER_ELEMENT`
+ * (AGL-3042), the size every golden section and a two-person introduction fit
+ * (`ai-job-page-evals.spec.ts`) and a Free page's credits are counted at
+ * (`ai-job-free-page.spec.ts`). A faster tier asks more in the same time, up
+ * to `AI_JOB_PAGE_SECTION_MAX_TOKENS`, and a slower one less.
+ *
+ * A Free page fits its wall at this ceiling with little to spare, so the
+ * ceiling does not move to make a section fit: a few tokens past it, the Free
+ * page that builds its layout first leaves no more of the wall than its
+ * largest pass spends, which is the room a re-asked section needs
+ * (`ai-job-free-page.spec.ts` finds the largest ceiling that holds, and
+ * `docs/AI_JOBS.md` quotes it). The sections a Free plan may ask for are
+ * counted at this ceiling too (AGL-3070). A section that runs past it is asked for
+ * smaller instead (AGL-3042), and on a workspace that keeps no reusable
+ * components a repeated item is written once, which is what lets a Free
+ * section of cards with real copy fit at all (AGL-3053).
+ */
+export declare const AI_JOB_PAGE_SECTION_TOKENS = 1050;
+/**
+ * A section pass's time (AGL-3036): its two inventory-lookup rounds, its
+ * answer and its re-ask at `AI_JOB_PAGE_SECTION_TOKENS` on the served tier,
+ * with the step's reads and writes, at the rates `ai-job-budget.ts` assumes.
+ */
+export declare const AI_JOB_PAGE_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/**
+ * The least time one section pass needs before it starts. Registered with the
+ * step, so neither the beat nor an inline door starts a pass that its budget
+ * would cut off. A spec holds it inside the beat's own budget.
+ */
+export declare const AI_JOB_PAGE_STEP_MINIMUM_MS: number;
+/** The ceiling a section's answer asks on this model: the most whose worst case fits a pass. */
+export declare function aiJobPageSectionMaxTokens(model: string): number;