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

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

@@ -1 +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-dataset-catalog'\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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"}
+{"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 { aiHostPublishContext, aiSiteStatusTable } from '../model/ai-host-publish-context'\nimport { aiInstructionsWithSiteContext } from '../model/ai-site-context'\nimport { readAiSiteContext } from '../runtime/site-context'\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-dataset-catalog'\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, the\n * site's publish state (published or not, its address, its pages' paths), 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  '- Whether the site is published, and its address, come only from the Site status table. Page views and visitors never show whether a site is live: never say or suggest a site is not live, not launched or not published because of its traffic.',\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  // What the business is and what the owner's edits showed (AGL-3661), so an\n  // answer reads the numbers for THIS business. No contact details: an\n  // insight names nobody. No publish state either: that is the Site status\n  // table's to say, and the rules send the model there.\n  const siteContext = await readAiSiteContext(firestore, { orgId: job.orgId, hostId, host: site.host ?? null })\n  const system = [\n    ...aiInstructionsWithSiteContext(\n      AI_JOB_INSIGHT_SYSTEM,\n      siteContext ? { ...siteContext, publish: null, contact: false } : null,\n    ),\n  ]\n  const ask = (messages: AiMessage[], tool: 'read' | 'answer', ceiling: number) =>\n    runAiRequest({\n      model,\n      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  // A site's question is told whether the site is live, so traffic is never\n  // read as launch status. Appended, so the readers' refs stay as they were.\n  const tables =\n    !digest && site.host\n      ? [...read.tables, aiSiteStatusTable(aiHostPublishContext(site.host), `t${read.tables.length + 1}`)]\n      : read.tables\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","aiHostPublishContext","aiSiteStatusTable","aiInstructionsWithSiteContext","readAiSiteContext","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","siteContext","system","publish","contact","ask","messages","tool","ceiling","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-language.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @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 { AiLayoutPage, AiLayoutTargets } from '../layout-language/ai-layout-links';
+import type { AiJob } from '../model/ai-jobs.types';
+import { type AiSiteInventory } from '../model/ai-site-inventory';
+import type { AiGenerationCheck, AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiLoadEstimate } from '../runtime/ai-palette';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+/**
+ * A site's layout built in the compact layout language (AGL-3660): the layout
+ * step's pass for a guided start's and a build's layout unit. The model
+ * designs the header and the footer — their bands, the call to action, the
+ * footer's columns and every word — in one short answer through
+ * `submit_frame`, and the compiler writes the layout around what the site
+ * owes it: its name as the brand, its pages as the navigation and the phone
+ * menu, the Layout Slot, and the footer at the bottom of a short page
+ * (`ai-layout-frame.ts`).
+ */
+/**
+ * The most a frame's answer asks for: two sections of a few blocks each (the
+ * live runs of 2026-10-07 wrote 442 to 583), and the thinking before them.
+ */
+export declare const AI_JOB_LAYOUT_LANGUAGE_TOKENS: number;
+/** A language layout pass's time, on the tier the layout step is served from. */
+export declare const AI_JOB_LAYOUT_LANGUAGE_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The generation kind a frame is asked under, which the doctrine scopes. */
+export declare const AI_LAYOUT_FRAME_KIND = "layout-frame";
+/** The language, as the frame door's cached instructions. */
+export declare const AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The site's name as the brand: the name the job was given, else the token the site's own name fills. */
+export declare function aiLayoutSiteName(job: Pick<AiJob, 'inputs'>): string;
+/** The pages a frame's navigation links: the planned pages, else the site's own, in order. */
+export declare function aiLayoutNavPages(job: Pick<AiJob, 'inputs'>, inventory: AiSiteInventory | null): AiLayoutPage[];
+/** The home page the brand links: the planned home, else the site's. */
+export declare function aiLayoutHomeId(pages: readonly AiLayoutPage[], inventory: AiSiteInventory | null): string | null;
+/** The frame's user turn: the site, its brief, its pages and its form. */
+export declare function aiLayoutFramePrompt(input: {
+    job: Pick<AiJob, 'brief' | '$id'> & Partial<Pick<AiJob, 'inputs'>>;
+    siteName: string;
+    pages: readonly AiLayoutPage[];
+    targets: AiLayoutTargets;
+}): string;
+/** A validated language layout. */
+export interface AiLayoutFrameBuilt {
+    rootId: string;
+    nodes: NodesMap;
+    load: AiLoadEstimate | null;
+    /** What the last answer's gaps took out of the frame (`ai-layout-gaps.ts`). */
+    dropped: string[];
+}
+/** The check a frame answer is held to: read, compiled, stored and checked as a layout, with the layout door's own checks. */
+export declare function aiLayoutFrameCheck(input: {
+    /** The header arrangement the site's look chose (AGL-3660); the answer's otherwise. */
+    headerAlign?: 'start' | 'center';
+    siteName: string;
+    homeId: string | null;
+    pages: readonly AiLayoutPage[];
+    targets: AiLayoutTargets;
+    extend: (tree: AiValidatedTree) => AiDoctrineViolation[];
+}): AiGenerationCheck<AiLayoutFrameBuilt>;
+/** What a frame's links resolve against: the site's pages and its form, as a page's do. */
+export declare function aiLayoutFrameTargets(job: Pick<AiJob, 'brief' | 'inputs'>, inventory: AiSiteInventory | null): AiLayoutTargets;

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

@@ -0,0 +1,200 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { aiCompileLayoutFrame } from "../layout-language/ai-layout-frame.js";
+import { AI_LAYOUT_LANGUAGE_TEXT, aiReadLayoutFrame } from "../layout-language/ai-layout-language.js";
+import { aiLayoutCopyCheck } from "../layout-language/ai-layout-gaps.js";
+import { aiLayoutStoredTree } from "../layout-language/ai-layout-store.js";
+import { AI_GENERATION_MAX_ATTEMPTS } from "../runtime/ai-generation-bounds.js";
+import { aiHomeScreenIds } from "../model/ai-site-inventory.js";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { validateAiDoctrineTree } from "../runtime/ai-doctrine-validators.js";
+import { aiSiteKindDesignLines } from "../model/ai-site-kinds.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+import { aiJobBriefLine } from "./ai-job-generation.js";
+import { AI_LAYOUT_SITE_PAGES_MAX, aiLayoutIsHomeSlug, aiLayoutSitePages } from "./ai-job-layout-site-pages.js";
+import { AI_LAYOUT_FRAME_THINKING_TOKENS, aiLayoutPageTargets } from "./ai-job-page-language.js";
+import { AI_SITE_NAME_TOKEN } from "./ai-layout-site-facts.js";
+/**
+ * A site's layout built in the compact layout language (AGL-3660): the layout
+ * step's pass for a guided start's and a build's layout unit. The model
+ * designs the header and the footer — their bands, the call to action, the
+ * footer's columns and every word — in one short answer through
+ * `submit_frame`, and the compiler writes the layout around what the site
+ * owes it: its name as the brand, its pages as the navigation and the phone
+ * menu, the Layout Slot, and the footer at the bottom of a short page
+ * (`ai-layout-frame.ts`).
+ */ /**
+ * The most a frame's answer asks for: two sections of a few blocks each (the
+ * live runs of 2026-10-07 wrote 442 to 583), and the thinking before them.
+ */ export const AI_JOB_LAYOUT_LANGUAGE_TOKENS = 1200 + AI_LAYOUT_FRAME_THINKING_TOKENS;
+/** A language layout pass's time, on the tier the layout step is served from. */ export const AI_JOB_LAYOUT_LANGUAGE_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.layout'],
+    maxTokens: AI_JOB_LAYOUT_LANGUAGE_TOKENS
+});
+/** The generation kind a frame is asked under, which the doctrine scopes. */ export const AI_LAYOUT_FRAME_KIND = 'layout-frame';
+/** The language, as the frame door's cached instructions. */ export const AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS = [
+    {
+        text: [
+            AI_LAYOUT_LANGUAGE_TEXT,
+            '',
+            "Now you design a site's header and footer, each one section of the language, answered with submit_frame.",
+            "- header: the platform writes the site's name and its navigation itself. Choose its band and align (start, or center for a centered navigation), and give it at most one button: the call to action every page shows.",
+            '- footer: a section like any other, usually a row of two or three columns: a few words about the business, the details the brief gives, and a list of links (items with to). Put no contact detail, opening hours or address in it that the brief does not give, and no gap in square brackets for one.'
+        ].join('\n'),
+        cacheBreakpoint: true
+    }
+];
+/** The site's name as the brand: the name the job was given, else the token the site's own name fills. */ export function aiLayoutSiteName(job) {
+    var _job_inputs;
+    const given = (_job_inputs = job.inputs) == null ? void 0 : _job_inputs['businessName'];
+    return typeof given === 'string' && given.trim() ? given.trim() : AI_SITE_NAME_TOKEN;
+}
+/** The pages a frame's navigation links: the planned pages, else the site's own, in order. */ export function aiLayoutNavPages(job, inventory) {
+    var _ref;
+    // The header and the footer link the pages the job was told (AGL-3660),
+    // else the site's own, the home page always and first, labelled Home. The
+    // model draws neither list, so it cannot drop a page.
+    const planned = aiLayoutSitePages(job.inputs);
+    const own = ((_ref = inventory == null ? void 0 : inventory.screens) != null ? _ref : []).filter((row)=>!row.template).map((row)=>({
+            id: row.id,
+            label: row.name,
+            slug: row.slug
+        }));
+    const siteHome = planned.some((page)=>aiLayoutIsHomeSlug(page.slug)) ? [] : own.filter((page)=>aiLayoutIsHomeSlug(page.slug)).slice(0, 1);
+    const pages = [
+        ...siteHome,
+        ...planned.length ? planned : own
+    ].filter((page)=>page.label.trim());
+    const home = pages.find((page)=>aiLayoutIsHomeSlug(page.slug));
+    return [
+        ...home ? [
+            _extends({}, home, {
+                label: 'Home'
+            })
+        ] : [],
+        ...pages.filter((page)=>page !== home && !aiLayoutIsHomeSlug(page.slug))
+    ].slice(0, AI_LAYOUT_SITE_PAGES_MAX);
+}
+/** The home page the brand links: the planned home, else the site's. */ export function aiLayoutHomeId(pages, inventory) {
+    var _ref, _ref1;
+    const planned = pages.find((page)=>aiLayoutIsHomeSlug(page.slug));
+    return (_ref = (_ref1 = planned == null ? void 0 : planned.id) != null ? _ref1 : aiHomeScreenIds(inventory)[0]) != null ? _ref : null;
+}
+/** The frame's user turn: the site, its brief, its pages and its form. */ export function aiLayoutFramePrompt(input) {
+    const { job, pages, targets } = input;
+    return [
+        `Site: ${input.siteName === AI_SITE_NAME_TOKEN ? 'the business the brief describes' : `"${input.siteName}"`}`,
+        aiJobBriefLine(job),
+        ...aiSiteKindDesignLines(job.inputs),
+        pages.length ? `Its pages, which the navigation links: ${pages.map((page)=>`${page.label} (page:${page.id})`).join(', ')}.` : 'It has no pages yet.',
+        targets.forms.length || targets.formPageId ? 'A call to action that asks a visitor to get in touch goes to form.' : 'The site has no form yet.',
+        `Design seed: ${job.$id.slice(-6)}.`
+    ].join('\n');
+}
+/** The check a frame answer is held to: read, compiled, stored and checked as a layout, with the layout door's own checks. */ export function aiLayoutFrameCheck(input) {
+    let answers = 0;
+    return (answer)=>{
+        // The last answer a generation takes has its gaps taken out rather than asked about again.
+        answers += 1;
+        const last = answers >= AI_GENERATION_MAX_ATTEMPTS;
+        const frame = aiReadLayoutFrame(answer);
+        if (input.headerAlign && frame.header) frame.header.align = input.headerAlign;
+        const compiled = aiCompileLayoutFrame(frame, {
+            siteName: input.siteName,
+            homeId: input.homeId,
+            navPages: input.pages
+        }, input.targets);
+        const context = {
+            screenIds: [
+                ...new Set([
+                    ...input.targets.pages.map((page)=>page.id),
+                    ...input.pages.map((page)=>page.id),
+                    ...input.homeId ? [
+                        input.homeId
+                    ] : []
+                ])
+            ],
+            formIds: input.targets.forms.map((form)=>form.id),
+            homeScreenIds: input.targets.homeIds,
+            codeBuilt: true
+        };
+        const stored = aiLayoutStoredTree(compiled.tree, 'layout', context);
+        if (stored.ok === false) {
+            console.error('ai layout frame: a compiled layout did not store', {
+                error: stored.error
+            });
+            return {
+                value: null,
+                violations: [
+                    {
+                        rule: null,
+                        code: 'layout-compile',
+                        message: 'This layout could not be built. Try again.',
+                        detail: stored.error
+                    }
+                ]
+            };
+        }
+        // No gap and no internal reference in the words of a frame every published page shows.
+        const navPages = [
+            ...input.targets.pages,
+            ...input.pages
+        ];
+        const copy = aiLayoutCopyCheck(stored.nodes, stored.rootId, {
+            pages: navPages,
+            ids: [
+                ...navPages.map((page)=>page.id),
+                ...input.targets.forms.map((form)=>form.id)
+            ]
+        }, last);
+        const { nodes, dropped } = copy;
+        const report = validateAiDoctrineTree({
+            rootId: stored.rootId,
+            nodes
+        }, 'layout', context);
+        const violations = [
+            ...report.violations,
+            ...copy.violations,
+            ...input.extend({
+                rootId: stored.rootId,
+                nodes,
+                repairs: [],
+                sourceIds: {},
+                score: report.score,
+                load: report.load
+            })
+        ];
+        return {
+            value: violations.length ? null : {
+                rootId: stored.rootId,
+                nodes,
+                load: report.load,
+                dropped
+            },
+            violations
+        };
+    };
+}
+/** What a frame's links resolve against: the site's pages and its form, as a page's do. */ export function aiLayoutFrameTargets(job, inventory) {
+    return aiLayoutPageTargets({
+        job,
+        inventory,
+        own: []
+    });
+}
+
+//# sourceMappingURL=ai-job-layout-language.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-language.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { aiCompileLayoutFrame } from '../layout-language/ai-layout-frame'\nimport {\n  AI_LAYOUT_FRAME_TOOL,\n  AI_LAYOUT_LANGUAGE_TEXT,\n  aiReadLayoutFrame,\n} from '../layout-language/ai-layout-language'\nimport type {\n  AiLayoutPage,\n  AiLayoutTargets,\n} from '../layout-language/ai-layout-links'\nimport { aiLayoutCopyCheck } from '../layout-language/ai-layout-gaps'\nimport { aiLayoutStoredTree } from '../layout-language/ai-layout-store'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport {\n  aiHomeScreenIds,\n  type AiSiteInventory,\n} from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport type { AiGenerationCheck, AiValidatedTree } from '../runtime/ai-doctrine'\nimport {\n  validateAiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport { aiSiteKindDesignLines } from '../model/ai-site-kinds'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiJobBriefLine } from './ai-job-generation'\nimport {\n  AI_LAYOUT_SITE_PAGES_MAX,\n  aiLayoutIsHomeSlug,\n  aiLayoutSitePages,\n} from './ai-job-layout-site-pages'\nimport {\n  AI_LAYOUT_FRAME_THINKING_TOKENS,\n  aiLayoutPageTargets,\n} from './ai-job-page-language'\nimport { AI_SITE_NAME_TOKEN } from './ai-layout-site-facts'\n\n/**\n * A site's layout built in the compact layout language (AGL-3660): the layout\n * step's pass for a guided start's and a build's layout unit. The model\n * designs the header and the footer — their bands, the call to action, the\n * footer's columns and every word — in one short answer through\n * `submit_frame`, and the compiler writes the layout around what the site\n * owes it: its name as the brand, its pages as the navigation and the phone\n * menu, the Layout Slot, and the footer at the bottom of a short page\n * (`ai-layout-frame.ts`).\n */\n\n/**\n * The most a frame's answer asks for: two sections of a few blocks each (the\n * live runs of 2026-10-07 wrote 442 to 583), and the thinking before them.\n */\nexport const AI_JOB_LAYOUT_LANGUAGE_TOKENS = 1_200 + AI_LAYOUT_FRAME_THINKING_TOKENS\n\n/** A language layout pass's time, on the tier the layout step is served from. */\nexport const AI_JOB_LAYOUT_LANGUAGE_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_LANGUAGE_TOKENS,\n})\n\n/** The generation kind a frame is asked under, which the doctrine scopes. */\nexport const AI_LAYOUT_FRAME_KIND = 'layout-frame'\n\n/** The language, as the frame door's cached instructions. */\nexport const AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      AI_LAYOUT_LANGUAGE_TEXT,\n      '',\n      \"Now you design a site's header and footer, each one section of the language, answered with submit_frame.\",\n      \"- header: the platform writes the site's name and its navigation itself. Choose its band and align (start, or center for a centered navigation), and give it at most one button: the call to action every page shows.\",\n      '- footer: a section like any other, usually a row of two or three columns: a few words about the business, the details the brief gives, and a list of links (items with to). Put no contact detail, opening hours or address in it that the brief does not give, and no gap in square brackets for one.',\n    ].join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\n/** The site's name as the brand: the name the job was given, else the token the site's own name fills. */\nexport function aiLayoutSiteName(job: Pick<AiJob, 'inputs'>): string {\n  const given = job.inputs?.['businessName']\n  return typeof given === 'string' && given.trim()\n    ? given.trim()\n    : AI_SITE_NAME_TOKEN\n}\n\n/** The pages a frame's navigation links: the planned pages, else the site's own, in order. */\nexport function aiLayoutNavPages(\n  job: Pick<AiJob, 'inputs'>,\n  inventory: AiSiteInventory | null,\n): AiLayoutPage[] {\n  // The header and the footer link the pages the job was told (AGL-3660),\n  // else the site's own, the home page always and first, labelled Home. The\n  // model draws neither list, so it cannot drop a page.\n  const planned = aiLayoutSitePages(job.inputs)\n  const own = (inventory?.screens ?? [])\n    .filter((row) => !row.template)\n    .map((row) => ({ id: row.id, label: row.name, slug: row.slug }))\n  const siteHome = planned.some((page) => aiLayoutIsHomeSlug(page.slug))\n    ? []\n    : own.filter((page) => aiLayoutIsHomeSlug(page.slug)).slice(0, 1)\n  const pages = [...siteHome, ...(planned.length ? planned : own)].filter((page) => page.label.trim())\n  const home = pages.find((page) => aiLayoutIsHomeSlug(page.slug))\n  return [\n    ...(home ? [{ ...home, label: 'Home' }] : []),\n    ...pages.filter((page) => page !== home && !aiLayoutIsHomeSlug(page.slug)),\n  ].slice(0, AI_LAYOUT_SITE_PAGES_MAX)\n}\n\n/** The home page the brand links: the planned home, else the site's. */\nexport function aiLayoutHomeId(\n  pages: readonly AiLayoutPage[],\n  inventory: AiSiteInventory | null,\n): string | null {\n  const planned = pages.find((page) => aiLayoutIsHomeSlug(page.slug))\n  return planned?.id ?? aiHomeScreenIds(inventory)[0] ?? null\n}\n\n/** The frame's user turn: the site, its brief, its pages and its form. */\nexport function aiLayoutFramePrompt(input: {\n  job: Pick<AiJob, 'brief' | '$id'> & Partial<Pick<AiJob, 'inputs'>>\n  siteName: string\n  pages: readonly AiLayoutPage[]\n  targets: AiLayoutTargets\n}): string {\n  const { job, pages, targets } = input\n  return [\n    `Site: ${input.siteName === AI_SITE_NAME_TOKEN ? 'the business the brief describes' : `\"${input.siteName}\"`}`,\n    aiJobBriefLine(job),\n    ...aiSiteKindDesignLines(job.inputs),\n    pages.length\n      ? `Its pages, which the navigation links: ${pages.map((page) => `${page.label} (page:${page.id})`).join(', ')}.`\n      : 'It has no pages yet.',\n    targets.forms.length || targets.formPageId\n      ? 'A call to action that asks a visitor to get in touch goes to form.'\n      : 'The site has no form yet.',\n    `Design seed: ${job.$id.slice(-6)}.`,\n  ].join('\\n')\n}\n\n/** A validated language layout. */\nexport interface AiLayoutFrameBuilt {\n  rootId: string\n  nodes: NodesMap\n  load: AiLoadEstimate | null\n  /** What the last answer's gaps took out of the frame (`ai-layout-gaps.ts`). */\n  dropped: string[]\n}\n\n/** The check a frame answer is held to: read, compiled, stored and checked as a layout, with the layout door's own checks. */\nexport function aiLayoutFrameCheck(input: {\n  /** The header arrangement the site's look chose (AGL-3660); the answer's otherwise. */\n  headerAlign?: 'start' | 'center'\n  siteName: string\n  homeId: string | null\n  pages: readonly AiLayoutPage[]\n  targets: AiLayoutTargets\n  extend: (tree: AiValidatedTree) => AiDoctrineViolation[]\n}): AiGenerationCheck<AiLayoutFrameBuilt> {\n  let answers = 0\n  return (answer) => {\n    // The last answer a generation takes has its gaps taken out rather than asked about again.\n    answers += 1\n    const last = answers >= AI_GENERATION_MAX_ATTEMPTS\n    const frame = aiReadLayoutFrame(answer)\n    if (input.headerAlign && frame.header) frame.header.align = input.headerAlign\n    const compiled = aiCompileLayoutFrame(\n      frame,\n      { siteName: input.siteName, homeId: input.homeId, navPages: input.pages },\n      input.targets,\n    )\n    const context = {\n      screenIds: [\n        ...new Set([\n          ...input.targets.pages.map((page) => page.id),\n          ...input.pages.map((page) => page.id),\n          ...(input.homeId ? [input.homeId] : []),\n        ]),\n      ],\n      formIds: input.targets.forms.map((form) => form.id),\n      homeScreenIds: input.targets.homeIds,\n      codeBuilt: true,\n    }\n    const stored = aiLayoutStoredTree(compiled.tree, 'layout', context)\n    if (stored.ok === false) {\n      console.error('ai layout frame: a compiled layout did not store', {\n        error: stored.error,\n      })\n      return {\n        value: null,\n        violations: [\n          {\n            rule: null,\n            code: 'layout-compile',\n            message: 'This layout could not be built. Try again.',\n            detail: stored.error,\n          },\n        ],\n      }\n    }\n    // No gap and no internal reference in the words of a frame every published page shows.\n    const navPages = [...input.targets.pages, ...input.pages]\n    const copy = aiLayoutCopyCheck(\n      stored.nodes,\n      stored.rootId,\n      {\n        pages: navPages,\n        ids: [...navPages.map((page) => page.id), ...input.targets.forms.map((form) => form.id)],\n      },\n      last,\n    )\n    const { nodes, dropped } = copy\n    const report = validateAiDoctrineTree(\n      { rootId: stored.rootId, nodes },\n      'layout',\n      context,\n    )\n    const violations = [\n      ...report.violations,\n      ...copy.violations,\n      ...input.extend({\n        rootId: stored.rootId,\n        nodes,\n        repairs: [],\n        sourceIds: {},\n        score: report.score as AiValidatedTree['score'],\n        load: report.load,\n      }),\n    ]\n    return {\n      value: violations.length\n        ? null\n        : { rootId: stored.rootId, nodes, load: report.load, dropped },\n      violations,\n    }\n  }\n}\n\n/** What a frame's links resolve against: the site's pages and its form, as a page's do. */\nexport function aiLayoutFrameTargets(\n  job: Pick<AiJob, 'brief' | 'inputs'>,\n  inventory: AiSiteInventory | null,\n): AiLayoutTargets {\n  return aiLayoutPageTargets({ job, inventory, own: [] })\n}\n"],"names":["aiCompileLayoutFrame","AI_LAYOUT_LANGUAGE_TEXT","aiReadLayoutFrame","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","aiHomeScreenIds","AI_STEP_TIERS","validateAiDoctrineTree","aiSiteKindDesignLines","aiJobStepBudget","aiJobBriefLine","AI_LAYOUT_SITE_PAGES_MAX","aiLayoutIsHomeSlug","aiLayoutSitePages","AI_LAYOUT_FRAME_THINKING_TOKENS","aiLayoutPageTargets","AI_SITE_NAME_TOKEN","AI_JOB_LAYOUT_LANGUAGE_TOKENS","AI_JOB_LAYOUT_LANGUAGE_BUDGET","tier","maxTokens","AI_LAYOUT_FRAME_KIND","AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS","text","join","cacheBreakpoint","aiLayoutSiteName","job","given","inputs","trim","aiLayoutNavPages","inventory","planned","own","screens","filter","row","template","map","id","label","name","slug","siteHome","some","page","slice","pages","length","home","find","aiLayoutHomeId","aiLayoutFramePrompt","input","targets","siteName","forms","formPageId","$id","aiLayoutFrameCheck","answers","answer","last","frame","headerAlign","header","align","compiled","homeId","navPages","context","screenIds","Set","formIds","form","homeScreenIds","homeIds","codeBuilt","stored","tree","ok","console","error","value","violations","rule","code","message","detail","copy","nodes","rootId","ids","dropped","report","extend","repairs","sourceIds","score","load","aiLayoutFrameTargets"],"mappings":"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"}

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

@@ -45,8 +45,19 @@ export interface AiLayoutSitePage {
     label: string;
     slug: string;
 }
-/** The pages a scaffold's plan puts in the navigation, in plan order: ids minted, entries asked for, no record templates. */
-export declare function aiLayoutSitePagesOfPlan(screens: readonly AiBuildPlanScreen[]): AiLayoutSitePage[];
+/** Whether a slug is the site's root, the home page. */
+export declare function aiLayoutIsHomeSlug(slug: string): boolean;
+/**
+ * The pages a plan puts in the navigation, record templates aside, the home
+ * page first whatever its `nav` flag says (AGL-3660): a guided start's plan
+ * marked its Home `nav: false`, and the header linked only Contact. Every
+ * other page keeps its `nav` flag, except in a guided start (`guided`), whose
+ * pages are the ones the person asked for: each is linked, but a
+ * confirmation page — a thank-you, a "submitted" — stays out.
+ */
+export declare function aiLayoutSitePagesOfPlan(screens: readonly AiBuildPlanScreen[], options?: {
+    guided?: boolean;
+}): AiLayoutSitePage[];
 /** The planned pages a layout unit's inputs carry; none for any other layout. */
 export declare function aiLayoutSitePages(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutSitePage[];
 /**

package/src/lib/jobs/ai-job-layout-site-pages.js

@@ -36,12 +36,28 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * adds only the entries a header does not already carry, adds nothing twice.
  */ /** The unit input a site layout's planned pages travel under. */ export const AI_LAYOUT_SITE_PAGES_INPUT = 'sitePages';
 /** The most pages the header links, as the layout instructions cap it. */ export const AI_LAYOUT_SITE_PAGES_MAX = 7;
-/** The pages a scaffold's plan puts in the navigation, in plan order: ids minted, entries asked for, no record templates. */ export function aiLayoutSitePagesOfPlan(screens) {
-    return screens.filter((screen)=>screen.nav && !screen.record && typeof screen.id === 'string' && screen.id).slice(0, AI_LAYOUT_SITE_PAGES_MAX).map((screen)=>({
+/** Whether a slug is the site's root, the home page. */ export function aiLayoutIsHomeSlug(slug) {
+    return slug.replace(/^\/+|\/+$/g, '') === '';
+}
+/** A page that confirms what a visitor just did, which no navigation links. */ const CONFIRMATION = /thank|confirm|success|submitted/i;
+/**
+ * The pages a plan puts in the navigation, record templates aside, the home
+ * page first whatever its `nav` flag says (AGL-3660): a guided start's plan
+ * marked its Home `nav: false`, and the header linked only Contact. Every
+ * other page keeps its `nav` flag, except in a guided start (`guided`), whose
+ * pages are the ones the person asked for: each is linked, but a
+ * confirmation page — a thank-you, a "submitted" — stays out.
+ */ export function aiLayoutSitePagesOfPlan(screens, options = {}) {
+    const linked = (screen)=>aiLayoutIsHomeSlug(screen.slug) || (options.guided ? !CONFIRMATION.test(`${screen.slug} ${screen.title}`) : !!screen.nav);
+    const pages = screens.filter((screen)=>!screen.record && typeof screen.id === 'string' && screen.id && linked(screen)).map((screen)=>({
             id: screen.id,
             label: screen.title.trim(),
             slug: screen.slug
         })).filter((page)=>page.label);
+    return [
+        ...pages.filter((page)=>aiLayoutIsHomeSlug(page.slug)),
+        ...pages.filter((page)=>!aiLayoutIsHomeSlug(page.slug))
+    ].slice(0, AI_LAYOUT_SITE_PAGES_MAX);
 }
 /** The planned pages a layout unit's inputs carry; none for any other layout. */ export function aiLayoutSitePages(inputs) {
     const raw = inputs == null ? void 0 : inputs[AI_LAYOUT_SITE_PAGES_INPUT];