@aglyn/plugins-ai 1.0.0-beta.285 → 1.0.0-beta.287

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  aiInsightDigestPeriod,\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 { aiDevEffortFor } from '../runtime/ai-dev-env'\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 last week, Monday to Sunday? 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, its address and which pages are published come only from the Site status table. Page views and visitors never show whether a site or a page is live: never say or suggest a site is not live, not launched or not published because of its traffic, and never call the pages a views table lists the published ones.',\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  // A development run's effort A/B arm (AGL-3781), else the row's.\n  const effort = aiDevEffortFor('job.insight') ?? AI_ROUTING_TABLE['job.insight'].effort\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      ...(effort ? { effort } : {}),\n      stream: false,\n      ...(signal ? { signal } : {}),\n    })\n\n  // 1. The reads.\n  // A digest reads last Monday to Sunday, whatever minute the beat runs it.\n  const readNow = digest ? aiInsightDigestPeriod(job.inputs, now).now : now\n  const base = { orgId: job.orgId, hostId, uid: digest ? null : job.createdBy, now: readNow }\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","aiInsightDigestPeriod","aiInsightOutput","aiInsightSurface","aiInsightSurfaceNeedsSite","aiHostPublishContext","aiSiteStatusTable","aiInstructionsWithSiteContext","readAiSiteContext","AI_ROUTING_TABLE","aiModelForStep","aiDevEffortFor","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","readNow","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  aiInsightDigestPeriod,\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 { aiDevEffortFor } from '../runtime/ai-dev-env'\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 type { AiTool } from '../providers/contract'\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 last week, Monday to Sunday? 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, its address and which pages are published come only from the Site status table. Page views and visitors never show whether a site or a page is live: never say or suggest a site is not live, not launched or not published because of its traffic, and never call the pages a views table lists the published ones.',\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\n/**\n * The tools BOTH calls send, in this order (AGL-4076). The provider's cached\n * prefix opens with the tools, then the system blocks, so a call that sends\n * other tools than the call before it reads none of the system block that\n * call wrote: the answer call, sent the answer tool alone after a read call\n * sent the read tool alone, read nothing on every insight. Each call names\n * the one it is for (`toolChoice`), and its user turn says so.\n */\nexport function aiInsightTools(): AiTool[] {\n  return [aiInsightReadTool(), aiInsightAnswerTool()]\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    '',\n    `Call ${AI_INSIGHT_READ_TOOL_NAME} now.`,\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 [\n    `Question: ${question}`,\n    '',\n    'Tables:',\n    '',\n    tables.map(aiInsightTableText).join('\\n\\n'),\n    '',\n    `These are all the tables there are. Call ${AI_INSIGHT_ANSWER_TOOL_NAME} now.`,\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  // A development run's effort A/B arm (AGL-3781), else the row's.\n  const effort = aiDevEffortFor('job.insight') ?? AI_ROUTING_TABLE['job.insight'].effort\n  // Both tools on both calls, so the answer call reads the prefix the read call wrote (AGL-4076).\n  const tools = aiInsightTools()\n  const ask = (messages: AiMessage[], tool: 'read' | 'answer', ceiling: number) =>\n    runAiRequest({\n      model,\n      system,\n      messages,\n      tools,\n      toolChoice: tool === 'read' ? AI_INSIGHT_READ_TOOL_NAME : AI_INSIGHT_ANSWER_TOOL_NAME,\n      maxTokens: Math.max(1, Math.min(ceiling, left())),\n      ...(AI_ROUTING_TABLE['job.insight'].thinking ? { thinking: AI_ROUTING_TABLE['job.insight'].thinking } : {}),\n      ...(effort ? { effort } : {}),\n      stream: false,\n      ...(signal ? { signal } : {}),\n    })\n\n  // 1. The reads.\n  // A digest reads last Monday to Sunday, whatever minute the beat runs it.\n  const readNow = digest ? aiInsightDigestPeriod(job.inputs, now).now : now\n  const base = { orgId: job.orgId, hostId, uid: digest ? null : job.createdBy, now: readNow }\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","aiInsightDigestPeriod","aiInsightOutput","aiInsightSurface","aiInsightSurfaceNeedsSite","aiHostPublishContext","aiSiteStatusTable","aiInstructionsWithSiteContext","readAiSiteContext","AI_ROUTING_TABLE","aiModelForStep","aiDevEffortFor","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","aiInsightTools","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","tools","ask","messages","tool","ceiling","toolChoice","max","min","thinking","stream","readNow","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.js

@@ -202,7 +202,8 @@ import { AI_SITE_NAME_TOKEN } from "./ai-layout-site-facts.js";
         const nodes = aiSettleUnrelatedScreenLinks(aiSettleMechanicalRules({
             rootId: stored.rootId,
             nodes: copy.nodes
-        }, 'layout'), 'layout', context).nodes;
+        }, 'layout', // And on the last answer, a link that goes nowhere, as the check below reads it (AGL-4076).
+        last ? context : undefined), 'layout', context).nodes;
         // The copy check can take words out of the footer: no heading or column
         // is left with nothing under it (AGL-3735), and none may remain.
         aiLayoutRepairFrameHollows(nodes);

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

@@ -1 +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 { aiLayoutDesignChoices, type AiLayoutDesign } from '../layout-language/ai-layout-design'\nimport { aiCompileLayoutFrame } from '../layout-language/ai-layout-frame'\nimport {\n  aiLayoutFrameHollows,\n  aiLayoutFrameHollowsSaid,\n  aiLayoutFrameIsHollow,\n  aiLayoutRepairFrameHollows,\n} from '../layout-language/ai-layout-frame-hollows'\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, AiJobPlan } from '../model/ai-jobs.types'\nimport { aiLayoutSpeaksOtherThanEnglish } from '../layout-language/ai-layout-labels'\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  aiSettleMechanicalRules,\n  aiSettleUnrelatedScreenLinks,\n  validateAiDoctrineTree,\n  type AiDoctrineNode,\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 { AiStoreFrameLinks } from '../model/ai-site-store-pages'\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'> & { plan?: Pick<AiJobPlan, 'language'> | null },\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. A site in another\n  // language keeps its home page's own title: a Spanish start's \"Inicio\" was\n  // linked as \"Home\" (AGL-3760).\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 ? [aiLayoutSpeaksOtherThanEnglish(job.plan?.language) ? 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    // A storefront's header (AGL-3676): its cart, and an announcement line.\n    ...(aiLayoutShopPageId(targets)\n      ? [\n          \"This is an online store: give the header no button, since the platform puts the cart beside the navigation. Give the header one note instead: a short announcement for the bar above it, under 60 characters, about the shop from the brief (a promise it makes, such as its shipping, or what is new); never invent an offer, a discount, a price or a shipping threshold the brief does not give.\",\n        ]\n      : []),\n    `Design seed: ${job.$id.slice(-6)}.`,\n  ].join('\\n')\n}\n\n/** A store's Shop page, by its id: the page its catalog's whole list is placed on (AGL-3676). */\nexport function aiLayoutShopPageId(targets: Pick<AiLayoutTargets, 'listings'>): string | null {\n  const products = (targets.listings ?? []).find((listing) => listing.kind === 'products')\n  return products?.placements.find((placement) => placement.role === 'index')?.screenId ?? null\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  /** The site's design (`aiLayoutDesignOf`), whose pages' closing band the footer sits under. */\n  design?: AiLayoutDesign | null\n  /** A store's own pages, which the header and footer link by path (AGL-3676). */\n  storeLinks?: AiStoreFrameLinks | null\n  /** The site's language, which the frame's own words are written in (AGL-3760). */\n  language?: string\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      {\n        siteName: input.siteName,\n        homeId: input.homeId,\n        navPages: input.pages,\n        closesDark: input.design ? aiLayoutDesignChoices(input.design).coverClose : false,\n        // A site that sells carries its cart in the header (AGL-3676).\n        cart: (input.targets.listings ?? []).some((listing) => listing.kind === 'products' && listing.cart !== false),\n        // And a store's header is a storefront's: no button repeating its navigation, an announcement bar (AGL-3676).\n        shopId: aiLayoutShopPageId(input.targets),\n        // And its account and policies, written after it (AGL-3676).\n        storeLinks: input.storeLinks ?? null,\n        ...(input.language ? { language: input.language } : {}),\n      },\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      // A link home under the home page's own title says home, in any language (AGL-3760).\n      homeLabels: [\n        ...input.pages.filter((page) => aiLayoutIsHomeSlug(page.slug)),\n        ...input.targets.pages.filter((page) => input.targets.homeIds.includes(page.id)),\n      ].map((page) => page.label),\n      // A footer's \"Get in touch\" goes to the form, wherever it is placed (AGL-3729).\n      ...(input.targets.formPageId ? { formScreenIds: [input.targets.formPageId] } : {}),\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 { dropped } = copy\n    // An attribute a rule has one answer for is settled, not asked of the model again (AGL-3660).\n    const nodes = aiSettleUnrelatedScreenLinks(\n      aiSettleMechanicalRules(\n        { rootId: stored.rootId, nodes: copy.nodes as unknown as Record<string, AiDoctrineNode> },\n        'layout',\n      ),\n      'layout',\n      context,\n    ).nodes as unknown as typeof copy.nodes\n    // The copy check can take words out of the footer: no heading or column\n    // is left with nothing under it (AGL-3735), and none may remain.\n    aiLayoutRepairFrameHollows(nodes as unknown as Record<string, unknown>)\n    const hollow = aiLayoutFrameHollows(nodes as unknown as Record<string, unknown>)\n    const report = validateAiDoctrineTree(\n      { rootId: stored.rootId, nodes },\n      'layout',\n      context,\n    )\n    const violations = [\n      ...report.violations,\n      ...(aiLayoutFrameIsHollow(hollow)\n        ? [\n            {\n              rule: null,\n              code: 'layout-frame-hollow',\n              message: 'Every footer heading needs something under it, and every footer column more than a heading.',\n              detail: aiLayoutFrameHollowsSaid(hollow).join('; '),\n            },\n          ]\n        : []),\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":["aiLayoutDesignChoices","aiCompileLayoutFrame","aiLayoutFrameHollows","aiLayoutFrameHollowsSaid","aiLayoutFrameIsHollow","aiLayoutRepairFrameHollows","AI_LAYOUT_LANGUAGE_TEXT","aiReadLayoutFrame","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","aiLayoutSpeaksOtherThanEnglish","aiHomeScreenIds","AI_STEP_TIERS","aiSettleMechanicalRules","aiSettleUnrelatedScreenLinks","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","plan","language","aiLayoutHomeId","aiLayoutFramePrompt","input","targets","siteName","forms","formPageId","aiLayoutShopPageId","$id","products","listings","listing","kind","placements","placement","role","screenId","aiLayoutFrameCheck","answers","answer","last","frame","headerAlign","header","align","compiled","homeId","navPages","closesDark","design","coverClose","cart","shopId","storeLinks","context","screenIds","Set","formIds","form","homeScreenIds","homeIds","homeLabels","includes","formScreenIds","codeBuilt","stored","tree","ok","console","error","value","violations","rule","code","message","detail","copy","nodes","rootId","ids","dropped","hollow","report","extend","repairs","sourceIds","score","load","aiLayoutFrameTargets"],"mappings":"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"}
+{"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 { aiLayoutDesignChoices, type AiLayoutDesign } from '../layout-language/ai-layout-design'\nimport { aiCompileLayoutFrame } from '../layout-language/ai-layout-frame'\nimport {\n  aiLayoutFrameHollows,\n  aiLayoutFrameHollowsSaid,\n  aiLayoutFrameIsHollow,\n  aiLayoutRepairFrameHollows,\n} from '../layout-language/ai-layout-frame-hollows'\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, AiJobPlan } from '../model/ai-jobs.types'\nimport { aiLayoutSpeaksOtherThanEnglish } from '../layout-language/ai-layout-labels'\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  aiSettleMechanicalRules,\n  aiSettleUnrelatedScreenLinks,\n  validateAiDoctrineTree,\n  type AiDoctrineNode,\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 { AiStoreFrameLinks } from '../model/ai-site-store-pages'\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'> & { plan?: Pick<AiJobPlan, 'language'> | null },\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. A site in another\n  // language keeps its home page's own title: a Spanish start's \"Inicio\" was\n  // linked as \"Home\" (AGL-3760).\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 ? [aiLayoutSpeaksOtherThanEnglish(job.plan?.language) ? 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    // A storefront's header (AGL-3676): its cart, and an announcement line.\n    ...(aiLayoutShopPageId(targets)\n      ? [\n          \"This is an online store: give the header no button, since the platform puts the cart beside the navigation. Give the header one note instead: a short announcement for the bar above it, under 60 characters, about the shop from the brief (a promise it makes, such as its shipping, or what is new); never invent an offer, a discount, a price or a shipping threshold the brief does not give.\",\n        ]\n      : []),\n    `Design seed: ${job.$id.slice(-6)}.`,\n  ].join('\\n')\n}\n\n/** A store's Shop page, by its id: the page its catalog's whole list is placed on (AGL-3676). */\nexport function aiLayoutShopPageId(targets: Pick<AiLayoutTargets, 'listings'>): string | null {\n  const products = (targets.listings ?? []).find((listing) => listing.kind === 'products')\n  return products?.placements.find((placement) => placement.role === 'index')?.screenId ?? null\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  /** The site's design (`aiLayoutDesignOf`), whose pages' closing band the footer sits under. */\n  design?: AiLayoutDesign | null\n  /** A store's own pages, which the header and footer link by path (AGL-3676). */\n  storeLinks?: AiStoreFrameLinks | null\n  /** The site's language, which the frame's own words are written in (AGL-3760). */\n  language?: string\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      {\n        siteName: input.siteName,\n        homeId: input.homeId,\n        navPages: input.pages,\n        closesDark: input.design ? aiLayoutDesignChoices(input.design).coverClose : false,\n        // A site that sells carries its cart in the header (AGL-3676).\n        cart: (input.targets.listings ?? []).some((listing) => listing.kind === 'products' && listing.cart !== false),\n        // And a store's header is a storefront's: no button repeating its navigation, an announcement bar (AGL-3676).\n        shopId: aiLayoutShopPageId(input.targets),\n        // And its account and policies, written after it (AGL-3676).\n        storeLinks: input.storeLinks ?? null,\n        ...(input.language ? { language: input.language } : {}),\n      },\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      // A link home under the home page's own title says home, in any language (AGL-3760).\n      homeLabels: [\n        ...input.pages.filter((page) => aiLayoutIsHomeSlug(page.slug)),\n        ...input.targets.pages.filter((page) => input.targets.homeIds.includes(page.id)),\n      ].map((page) => page.label),\n      // A footer's \"Get in touch\" goes to the form, wherever it is placed (AGL-3729).\n      ...(input.targets.formPageId ? { formScreenIds: [input.targets.formPageId] } : {}),\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 { dropped } = copy\n    // An attribute a rule has one answer for is settled, not asked of the model again (AGL-3660).\n    const nodes = aiSettleUnrelatedScreenLinks(\n      aiSettleMechanicalRules(\n        { rootId: stored.rootId, nodes: copy.nodes as unknown as Record<string, AiDoctrineNode> },\n        'layout',\n        // And on the last answer, a link that goes nowhere, as the check below reads it (AGL-4076).\n        last ? context : undefined,\n      ),\n      'layout',\n      context,\n    ).nodes as unknown as typeof copy.nodes\n    // The copy check can take words out of the footer: no heading or column\n    // is left with nothing under it (AGL-3735), and none may remain.\n    aiLayoutRepairFrameHollows(nodes as unknown as Record<string, unknown>)\n    const hollow = aiLayoutFrameHollows(nodes as unknown as Record<string, unknown>)\n    const report = validateAiDoctrineTree(\n      { rootId: stored.rootId, nodes },\n      'layout',\n      context,\n    )\n    const violations = [\n      ...report.violations,\n      ...(aiLayoutFrameIsHollow(hollow)\n        ? [\n            {\n              rule: null,\n              code: 'layout-frame-hollow',\n              message: 'Every footer heading needs something under it, and every footer column more than a heading.',\n              detail: aiLayoutFrameHollowsSaid(hollow).join('; '),\n            },\n          ]\n        : []),\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":["aiLayoutDesignChoices","aiCompileLayoutFrame","aiLayoutFrameHollows","aiLayoutFrameHollowsSaid","aiLayoutFrameIsHollow","aiLayoutRepairFrameHollows","AI_LAYOUT_LANGUAGE_TEXT","aiReadLayoutFrame","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","aiLayoutSpeaksOtherThanEnglish","aiHomeScreenIds","AI_STEP_TIERS","aiSettleMechanicalRules","aiSettleUnrelatedScreenLinks","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","plan","language","aiLayoutHomeId","aiLayoutFramePrompt","input","targets","siteName","forms","formPageId","aiLayoutShopPageId","$id","products","listings","listing","kind","placements","placement","role","screenId","aiLayoutFrameCheck","answers","answer","last","frame","headerAlign","header","align","compiled","homeId","navPages","closesDark","design","coverClose","cart","shopId","storeLinks","context","screenIds","Set","formIds","form","homeScreenIds","homeIds","homeLabels","includes","formScreenIds","codeBuilt","stored","tree","ok","console","error","value","violations","rule","code","message","detail","copy","nodes","rootId","ids","dropped","undefined","hollow","report","extend","repairs","sourceIds","score","load","aiLayoutFrameTargets"],"mappings":"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"}

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

@@ -78,7 +78,8 @@ export declare const AI_MEDIA_KIND: "media";
 /** ASSUMED: the site, the org, up to 20 file lookups and one transaction. No model. */
 export declare const AI_JOB_MEDIA_STEP_MINIMUM_MS = 8000;
 export declare const AI_MEDIA_NO_SITE_COPY = "Open the site whose media library should change.";
-export declare const AI_MEDIA_ROLE_COPY = "Organizing the media library needs the admin, editor or author role on this site.";
+/** Names "Edit site content" (`site.edit`, AGL-4047), never a role. */
+export declare const AI_MEDIA_ROLE_COPY: string;
 export declare const AI_MEDIA_LOCKED_COPY = "This site is not accepting changes right now.";
 export declare const AI_MEDIA_NOTHING_COPY = "The request named no file in the media library and no change this could make to it.";
 /** Where a person finds what the op changed. */

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

@@ -15,11 +15,12 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { createResourceUid } from "@aglyn/aglyn/app-utils/create-resource-uid";
+import { holdsSiteKey } from "@aglyn/aglyn/app-utils/host-permissions";
+import { orgPermissionLabel } from "@aglyn/aglyn/app-utils/org-permissions";
 import { MEDIA_ALT_MAX_LENGTH } from "@aglyn/aglyn/app-utils/media-alt";
 import { embeddedMetadataIsCurrent } from "@aglyn/aglyn/app-utils/media-embedded-fields";
 import { MEDIA_FOLDER_MAX_DEPTH, MEDIA_FOLDER_NAME_MAX_LENGTH, newMediaFolderDoc, normalizeFolderName } from "@aglyn/aglyn/app-utils/media-folders";
 import { MEDIA_TAG_MAX_COUNT, MEDIA_TAG_MAX_LENGTH, mediaFilterKeys, mediaNameWords, normalizeMediaTags } from "@aglyn/aglyn/app-utils/media-metadata";
-import { hostRoleCanWrite } from "@aglyn/aglyn/app-utils/organizations";
 import { getLockdownVerdict } from "@aglyn/tenant-data-admin/server/lockdown";
 import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
 import { FieldValue } from "firebase-admin/firestore";
@@ -83,7 +84,7 @@ import { registerAiJobStep } from "./ai-jobs.js";
  */ export const AI_MEDIA_KIND = 'media';
 /** ASSUMED: the site, the org, up to 20 file lookups and one transaction. No model. */ export const AI_JOB_MEDIA_STEP_MINIMUM_MS = 8000;
 export const AI_MEDIA_NO_SITE_COPY = 'Open the site whose media library should change.';
-export const AI_MEDIA_ROLE_COPY = 'Organizing the media library needs the admin, editor or author role on this site.';
+/** Names "Edit site content" (`site.edit`, AGL-4047), never a role. */ export const AI_MEDIA_ROLE_COPY = `Organizing the media library needs the "${orgPermissionLabel('site.edit')}" permission on this site — ask an organization admin.`;
 export const AI_MEDIA_LOCKED_COPY = 'This site is not accepting changes right now.';
 export const AI_MEDIA_NOTHING_COPY = 'The request named no file in the media library and no change this could make to it.';
 /** Where a person finds what the op changed. */ export const AI_MEDIA_WHERE = 'the site’s Media library';
@@ -373,15 +374,13 @@ const ID_SHAPE = /^[A-Za-z0-9_-]{1,128}$/;
     const foldersRef = hostRef.collection('mediaFolders');
     const { request } = input;
     return firestore.runTransaction(async (tx)=>{
-        var _host_get;
         // Every read first: a transaction writes nothing until its reads are done.
         const host = await tx.get(hostRef);
         if (!host.exists) return {
             ok: false,
             error: 'Unknown site'
         };
-        const roles = (_host_get = host.get('memberRoles')) != null ? _host_get : {};
-        if (!hostRoleCanWrite(roles[input.uid])) return {
+        if (!holdsSiteKey(host, input.uid, 'site.edit')) return {
             ok: false,
             error: AI_MEDIA_ROLE_COPY
         };
@@ -482,10 +481,9 @@ const ID_SHAPE = /^[A-Za-z0-9_-]{1,128}$/;
 }
 // ── The step ──────────────────────────────────────────────────────────────
 /** Why this member may not organize this site's library now, or `null`. */ export async function aiMediaAccessRefusal(input, deps = {}) {
-    var _input_host_get, _deps_lockdown;
+    var _deps_lockdown;
     if (!input.host.exists) return 'Unknown site';
-    const roles = (_input_host_get = input.host.get('memberRoles')) != null ? _input_host_get : {};
-    if (!hostRoleCanWrite(roles[input.uid])) return AI_MEDIA_ROLE_COPY;
+    if (!holdsSiteKey(input.host, input.uid, 'site.edit')) return AI_MEDIA_ROLE_COPY;
     const locked = await ((_deps_lockdown = deps.lockdown) != null ? _deps_lockdown : getLockdownVerdict)({
         staff: false,
         uid: input.uid,