@aglyn/plugins-ai 1.0.0-beta.244 → 1.0.0-beta.247

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  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  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'>,\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    // 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}): 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      },\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 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    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":["aiLayoutDesignChoices","aiCompileLayoutFrame","AI_LAYOUT_LANGUAGE_TEXT","aiReadLayoutFrame","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","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","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","formScreenIds","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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"}
+{"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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"}

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

@@ -337,6 +337,7 @@ export function createAiJobLayoutStep(deps = {}) {
             review: aiLimitReview(allowance)
         });
         if (aiJobUsesLayoutLanguage(job)) {
+            var _job_plan;
             // ── The header and footer designed in the layout language (AGL-3660) ──
             const siteName = aiLayoutSiteName(job);
             const pages = aiLayoutNavPages(job, inventory);
@@ -368,7 +369,9 @@ export function createAiJobLayoutStep(deps = {}) {
                     extend: aiLayoutChecks(inventory, plan, job.brief),
                     design: aiLayoutDesignOf(job, '/'),
                     storeLinks: aiStoreFrameLinksOf(job.inputs)
-                }))
+                }, ((_job_plan = job.plan) == null ? void 0 : _job_plan.language) ? {
+                    language: job.plan.language
+                } : {}))
             }, signal ? {
                 signal
             } : {}));

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

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

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

@@ -0,0 +1,239 @@
+/**
+ * @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 { PluginAiCapabilityArgsSchema } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
+import { getLockdownVerdict } from '@aglyn/tenant-data-admin/server/lockdown';
+import { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations';
+import { type Firestore } from 'firebase-admin/firestore';
+import { type AiJobAdmission } from './ai-job-admission';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The `media` step (AGL-3752): organizing files already in a site's own media
+ * library — the folder each is filed in, its tags, its alt text and its name —
+ * as a first-class build operation, so "put the kiln photos in a Studio
+ * folder", "tag these portfolio" or "write the missing alt text" is one item
+ * on Assist's plan card.
+ *
+ * NO MODEL. The planner wrote the values as the item's arguments; this holds
+ * each to the rule the media library's own controls hold it to and writes it,
+ * so it costs no credits.
+ *
+ * ── Only the library's own fields ────────────────────────────────────────
+ *
+ * Exactly what the Details drawer and the grid's bulk actions write on a
+ * file's document: `fileName` (200), `alt` (`MEDIA_ALT_MAX_LENGTH`), `tags`
+ * (`normalizeMediaTags`: lower case, 20 of 40 characters), and `folderId`
+ * with the legacy `folder` name beside it, with the library's filter and
+ * search keys re-derived from the document as the write leaves it
+ * (`mediaFilterKeys`). A new folder is the New folder button's: a
+ * `mediaFolders` document made by `newMediaFolderDoc`, its name held by
+ * `normalizeFolderName`, unique among its siblings without case, at most
+ * `MEDIA_FOLDER_MAX_DEPTH` deep. Filing a file writes its folder as the
+ * drawer's save does; the stored object takes the folder's path the next time
+ * that folder is moved or renamed, as after a drawer save. Its address never
+ * changes, so no page that uses it breaks.
+ *
+ * NEVER: uploading, copying, replacing or deleting a file, its bytes or the
+ * details inside them, its sharing or privacy, renaming or deleting a folder,
+ * or anything in the organization's shared library (every site of the
+ * workspace uses it). Those are not arguments.
+ *
+ * ── Alt text ─────────────────────────────────────────────────────────────
+ *
+ * Alt text describes ONE image: `alt` is for one image the request says what
+ * it shows. `altFromDetails` writes a missing alt from what the library
+ * already holds about the image — its description, or the caption, headline
+ * or title inside the file — and names the images that hold none. Never the
+ * file name, which read aloud is worse than silence (`inheritedMediaAlt`).
+ * The library's alt is what a placement takes when the image is placed;
+ * placements made before keep their own.
+ *
+ * ── Who may ──────────────────────────────────────────────────────────────
+ *
+ * The rules' own for a site library (`canWriteHostContent`,
+ * `hostWritesFrozen`): a member with the admin, editor or author role, while
+ * no lockdown freezes the site, its org or the platform. Asked at the door,
+ * before the write, and the role again inside the transaction that writes.
+ *
+ * ── Idempotent ───────────────────────────────────────────────────────────
+ *
+ * One transaction reads the files and folders as they are stored and writes
+ * only what differs; a folder of the asked name is found before one is made.
+ * A pass asked again writes nothing.
+ */
+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.";
+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. */
+export declare const AI_MEDIA_WHERE = "the site\u2019s Media library";
+/** The output's fixed id: one site's library, whatever changed. */
+export declare const AI_MEDIA_OUTPUT_ID = "library";
+/** The library's own limits, each from the control that edits the field. */
+export declare const AI_MEDIA_LIMITS: {
+    /** Files one item may name or select. */
+    readonly files: 20;
+    /** The Details drawer's file name. */
+    readonly fileName: 200;
+    readonly alt: 300;
+    readonly tags: 20;
+    readonly tag: 40;
+    /** A folder path: five names of 60 and their separators. */
+    readonly folder: number;
+};
+/** The item's arguments, as the planner fills them in. */
+export declare const AI_MEDIA_ARGS_SCHEMA: PluginAiCapabilityArgsSchema;
+/** What an item asks, each value read and held to the library's rule. */
+export interface AiMediaRequest {
+    files: string[];
+    missingAlt: boolean;
+    /** The folder path's names, root first. */
+    folder?: string[];
+    addTags: string[];
+    removeTags: string[];
+    rename?: string;
+    alt?: string;
+    altFromDetails: boolean;
+}
+export interface AiMediaRead {
+    request: AiMediaRequest;
+    problems: string[];
+}
+/** A folder path's names, root first, or a sentence saying why it cannot be one. */
+export declare function aiMediaFolderPathOf(value: string): string[] | {
+    error: string;
+};
+/** Why this alt text describes nothing, or `null`. */
+export declare function aiMediaAltProblem(alt: string, fileName: string): string | null;
+/** The item's arguments read: what may be written, and a sentence for each that may not. */
+export declare function aiMediaRequestOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiMediaRead;
+/** Whether a read request names files and a change to make to them. */
+export declare function aiMediaRequestEmpty(request: AiMediaRequest): boolean;
+/** A site library row, as the op reads it. */
+export interface AiMediaRow {
+    id: string;
+    /** The document as stored, which the filter keys are derived from. */
+    data: Record<string, unknown>;
+}
+/** A media folder, as the op reads it. */
+export interface AiMediaFolderRow {
+    id: string;
+    name: string;
+    parentId: string | null;
+}
+/**
+ * The file a name or id names among the rows read from the site's library:
+ * never a deleted one. Its id wins over a file name; two files of one name
+ * are refused in words.
+ */
+export declare function aiMediaFileOf(source: string, rows: readonly AiMediaRow[]): AiMediaRow | {
+    error: string;
+};
+/**
+ * Alt text written from what the library already holds about an image: its
+ * own description, else the caption, headline or title read from inside the
+ * file (only while that record still describes the file's bytes). `null`
+ * when it holds none that says what the image shows.
+ */
+export declare function aiMediaAltFromDetails(row: AiMediaRow): string | null;
+/** A folder to make: its name, and its parent's id or its index among those made before it. */
+export interface AiMediaFolderCreate {
+    name: string;
+    parent: {
+        id: string | null;
+    } | {
+        made: number;
+    };
+}
+/**
+ * Where a folder path lands: the existing folders it walks, matched without
+ * case among siblings as the library's sibling rule matches them, and the
+ * folders left to make below the last one found.
+ */
+export declare function aiMediaFolderPlan(path: readonly string[], folders: readonly AiMediaFolderRow[]): {
+    existingId: string | null;
+    create: AiMediaFolderCreate[];
+};
+/** One file's change: the fields to write and the sentences that say it. */
+export interface AiMediaFileChange {
+    update: Record<string, unknown>;
+    said: string[];
+    notDone: string[];
+}
+/**
+ * What the request changes on one file, compared with what is stored: only
+ * the fields that differ, with the filter keys re-derived from the document
+ * as the change leaves it, exactly as the Details drawer derives them.
+ */
+export declare function aiMediaFileChange(row: AiMediaRow, request: AiMediaRequest, folder: {
+    id: string;
+    name: string;
+} | null): AiMediaFileChange;
+export type AiMediaWrite = {
+    ok: true;
+    done: string[];
+    notDone: string[];
+    changedFiles: number;
+    madeFolders: string[];
+    altChanged: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The library change, written in one transaction that reads the site, its
+ * folders and the named files as they are stored NOW: the member still holds
+ * a write role, a folder of the asked name is used before one is made, and
+ * only fields that differ are written.
+ */
+export declare function writeAiMediaChanges(firestore: Firestore, input: {
+    hostId: string;
+    uid: string;
+    request: AiMediaRequest;
+    now: Date;
+}): Promise<AiMediaWrite>;
+/** Why this member may not organize this site's library now, or `null`. */
+export declare function aiMediaAccessRefusal(input: {
+    host: FirebaseFirestore.DocumentSnapshot;
+    uid: string;
+    org: object | null;
+}, deps?: {
+    lockdown?: typeof getLockdownVerdict;
+}): Promise<string | null>;
+/** The output's note: what changed, that it is live, and what was not done. */
+export declare function aiMediaOutputNote(done: readonly string[], notDone: readonly string[], altChanged: boolean): string;
+export interface AiJobMediaStepDeps {
+    write?: typeof writeAiMediaChanges;
+    lockdown?: typeof getLockdownVerdict;
+}
+export declare function createAiJobMediaStep(deps?: AiJobMediaStepDeps): AiJobStepRunner;
+export declare const runAiJobMediaStep: AiJobStepRunner;
+export interface AiMediaJobAdmissionDeps {
+    ownerOf?: typeof resolveOrgIdForHost;
+    lockdown?: typeof getLockdownVerdict;
+}
+/**
+ * A library change is admitted on a site of the job's own org, for a member
+ * who may write its library now, where the request names files and a change
+ * this can make. Refused in those words before anything is written.
+ */
+export declare function createAiMediaJobAdmission(deps?: AiMediaJobAdmissionDeps): AiJobAdmission;
+export declare const aiMediaJobAdmission: AiJobAdmission;
+/** Registers the media library step and its door (AGL-3752). */
+export declare function registerAiMediaJob(): void;