@aglyn/plugins-ai 1.0.0-beta.233 → 1.0.0-beta.235

package/src/lib/layout-language/ai-layout-pictures.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-pictures.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 { DEFAULT_SITE_IMAGES } from '@aglyn/aglyn/app-utils/default-site'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\n\n/**\n * THE PICTURES OF A LANGUAGE PAGE (AGL-3660).\n *\n * The compiler writes a picture slot as a frame holding an icon and an\n * `image` with alt text and no source (`ai-layout-compiler.ts`), and stays\n * pure: it never looks a photo up. This module is what runs after it, on the\n * stored page — it finds each empty slot, decides what kind of picture the\n * slot is, and fills it with a photo the site can serve from its own origin.\n *\n * Two sources fill a slot, in order:\n *\n * 1. A stock photo searched for by the slot's own description and copied into\n *    the site's media library (`jobs/ai-layout-stock-photos.ts`), when the\n *    deployment has a stock-photo key.\n * 2. Otherwise, or when the search finds nothing fitting, one of the STARTER\n *    PHOTOS every new site is born with (`DEFAULT_SITE_IMAGES`, served at\n *    `/_static/starter/` by the tenant and the console alike, credited in the\n *    CREDITS file beside them). They are the platform's own files, so a\n *    visitor's browser asks no other host for them.\n *\n * The slot keeps the alt text the model wrote whichever source fills it.\n */\n\n/** What a picture slot is for, read from where it sits and what it says. */\nexport type AiLayoutPictureRole = 'hero' | 'about' | 'gallery'\n\n/** One empty picture slot of a stored page, in document order. */\nexport interface AiLayoutPictureSlot {\n  /** The `image` node. */\n  imageId: string\n  /** The frame around it, which sets the slot's shape. */\n  frameId: string | null\n  /** The placeholder icon sharing the frame, taken out once a photo fills it. */\n  iconId: string | null\n  alt: string\n  /** The frame's shape as width over height; 1 when it names none. */\n  aspect: number\n  /** The plan index of the section it sits in, or -1. */\n  sectionIndex: number\n  role: AiLayoutPictureRole\n}\n\n/** A photo a slot is filled with. */\nexport interface AiLayoutPicturePhoto {\n  /** The site-served address: a starter path or the media library's own. */\n  src: string\n  width: number\n  height: number\n}\n\n/** Words that say a picture shows people, or a section is about them. */\nconst PEOPLE =\n  /\\b(about|team|story|owner|owners|founder|founders|staff|crew|people|person|portrait|meet|family|families|who we are|our (?:team|crew|people|story)|therapist|counsel(?:l)?or|coach|doctor|dentist|stylist|trainer|smil(?:e|es|ing)|headshot)\\b/i\n\n/** A frame's `aspectRatio` (`'16 / 9'`) as a number. */\nfunction aspectOf(value: unknown): number {\n  const match = /^\\s*(\\d+(?:\\.\\d+)?)\\s*\\/\\s*(\\d+(?:\\.\\d+)?)\\s*$/.exec(String(value ?? ''))\n  if (!match) return 1\n  const ratio = Number(match[1]) / Number(match[2])\n  return Number.isFinite(ratio) && ratio > 0 ? ratio : 1\n}\n\n/** A slot's role: the first section's picture is the hero; people make an about picture. */\nexport function aiLayoutPictureRole(input: {\n  sectionIndex: number\n  sectionName: string\n  alt: string\n}): AiLayoutPictureRole {\n  if (input.sectionIndex === 0) return 'hero'\n  if (PEOPLE.test(input.sectionName) || PEOPLE.test(input.alt)) return 'about'\n  return 'gallery'\n}\n\n/**\n * Every empty picture slot of a stored page, walked from its root in\n * document order. A slot that already has a source — one the owner placed, or\n * an earlier pass filled — is not a slot.\n */\nexport function aiLayoutPictureSlots(\n  nodes: NodesMap,\n  rootId: string,\n  sections: { ids: readonly string[]; names: readonly string[] },\n): AiLayoutPictureSlot[] {\n  const map = nodes as unknown as Record<\n    string,\n    { componentId?: string; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: string[] }\n  >\n  const slots: AiLayoutPictureSlot[] = []\n  const seen = new Set<string>()\n  const visit = (id: string, parentId: string | null, sectionIndex: number) => {\n    if (seen.has(id)) return\n    seen.add(id)\n    const node = map[id]\n    if (!node) return\n    const index = sections.ids.indexOf(id)\n    const here = index >= 0 ? index : sectionIndex\n    if (node.componentId === 'image') {\n      const src = node.props?.['src']\n      const alt = typeof node.props?.['alt'] === 'string' ? (node.props['alt'] as string).trim() : ''\n      if ((typeof src !== 'string' || !src.trim()) && alt) {\n        const frame = parentId ? map[parentId] : undefined\n        const iconId =\n          frame?.nodes?.find((child) => child !== id && map[child]?.componentId === 'icon') ?? null\n        slots.push({\n          imageId: id,\n          frameId: frame ? parentId : null,\n          iconId,\n          alt,\n          aspect: aspectOf(frame?.sx?.['aspectRatio']),\n          sectionIndex: here,\n          role: aiLayoutPictureRole({\n            sectionIndex: here,\n            sectionName: here >= 0 ? (sections.names[here] ?? '') : '',\n            alt,\n          }),\n        })\n      }\n    }\n    for (const child of node.nodes ?? []) visit(child, id, here)\n  }\n  visit(rootId, null, -1)\n  return slots\n}\n\n/** The starter photos, by name. */\nexport const AI_LAYOUT_STARTER_PHOTOS = DEFAULT_SITE_IMAGES\n\ntype StarterName = keyof typeof AI_LAYOUT_STARTER_PHOTOS\n\n/**\n * The starter photos each role draws from, best first. A hero draws from the\n * wide photos that read as a page's opening, an about picture leads with the\n * owner, and the rest are the gallery's.\n */\nconst STARTER_POOLS: Readonly<Record<AiLayoutPictureRole, readonly StarterName[]>> = {\n  hero: ['hero', 'desk', 'craft'],\n  about: ['about', 'hero'],\n  gallery: ['desk', 'plants', 'craft'],\n}\n\nconst ALL_STARTERS = Object.keys(AI_LAYOUT_STARTER_PHOTOS) as StarterName[]\n\n/** A small stable number from a seed, so the same job always picks the same photos. */\nexport function aiLayoutSeedNumber(seed: string): number {\n  let hash = 2166136261\n  for (let index = 0; index < seed.length; index += 1) {\n    hash ^= seed.charCodeAt(index)\n    hash = Math.imul(hash, 16777619)\n  }\n  return hash >>> 0\n}\n\nfunction rotate<T>(list: readonly T[], by: number): T[] {\n  if (!list.length) return []\n  const start = by % list.length\n  return [...list.slice(start), ...list.slice(0, start)]\n}\n\n/**\n * A starter photo for each slot. The hero's and the gallery's pools are\n * rotated by the seed, so sites do not all open with the same photo, while an\n * about picture always leads with the owner; no photo repeats on a page\n * while one is still unused; and a page with more slots than photos starts\n * the round again from its role's pool.\n */\nexport function aiLayoutStarterPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  seed: string,\n): AiLayoutPicturePhoto[] {\n  const turn = aiLayoutSeedNumber(seed)\n  const used = new Set<StarterName>()\n  return slots.map((slot) => {\n    // An about picture leads with the owner on every site; the others turn.\n    const pool =\n      slot.role === 'about' ? [...STARTER_POOLS.about] : rotate(STARTER_POOLS[slot.role], turn)\n    const rest = rotate(\n      ALL_STARTERS.filter((name) => !pool.includes(name)),\n      turn,\n    )\n    if (used.size >= ALL_STARTERS.length) used.clear()\n    const name = [...pool, ...rest].find((candidate) => !used.has(candidate)) ?? pool[0]\n    used.add(name)\n    const photo = AI_LAYOUT_STARTER_PHOTOS[name]\n    return { src: photo.src, width: photo.width, height: photo.height }\n  })\n}\n\n/**\n * The page with each slot filled by its photo: the `image` given its source,\n * its intrinsic size and how it loads (the hero eagerly, as the starter home\n * page loads its own), and the placeholder icon taken out of the frame. The\n * alt text is kept as the model wrote it. A slot given no photo is left as\n * the compiler wrote it.\n */\nexport function aiLayoutPlacePictures(\n  nodes: NodesMap,\n  slots: readonly AiLayoutPictureSlot[],\n  photos: ReadonlyArray<AiLayoutPicturePhoto | null>,\n): NodesMap {\n  const next = { ...(nodes as unknown as Record<string, Record<string, unknown>>) }\n  slots.forEach((slot, index) => {\n    const photo = photos[index]\n    const node = next[slot.imageId]\n    if (!photo || !node) return\n    next[slot.imageId] = {\n      ...node,\n      props: {\n        ...((node['props'] as Record<string, unknown> | undefined) ?? {}),\n        src: photo.src,\n        intrinsicWidth: photo.width,\n        intrinsicHeight: photo.height,\n        loading: slot.role === 'hero' ? 'eager' : 'lazy',\n      },\n    }\n    if (slot.iconId && slot.frameId && next[slot.frameId]) {\n      const frame = next[slot.frameId]\n      next[slot.frameId] = {\n        ...frame,\n        nodes: ((frame['nodes'] as string[] | undefined) ?? []).filter((child) => child !== slot.iconId),\n      }\n      delete next[slot.iconId]\n    }\n  })\n  return next as unknown as NodesMap\n}\n\n/**\n * A source of photos found for the slots themselves — a stock search copied\n * into the site's library — answering one photo or `null` per slot, in order.\n * It may throw; a slot it leaves unfilled takes a starter photo.\n */\nexport type AiLayoutPictureSource = (\n  slots: readonly AiLayoutPictureSlot[],\n) => Promise<ReadonlyArray<AiLayoutPicturePhoto | null>>\n\n/**\n * Fills a stored page's empty picture slots (AGL-3660): from `source` where\n * one is given and it answers, else from the starter photos. Never throws,\n * and never leaves a page worse than it came: a picture is decoration, and a\n * job never fails over one.\n */\nexport async function aiResolveLayoutPictures(\n  nodes: NodesMap,\n  input: {\n    rootId: string\n    sectionIds: readonly string[]\n    sectionNames: readonly string[]\n    /** A per-job word, so two sites do not open with the same photo. */\n    seed: string\n    source?: AiLayoutPictureSource | null\n  },\n): Promise<NodesMap> {\n  try {\n    const slots = aiLayoutPictureSlots(nodes, input.rootId, {\n      ids: input.sectionIds,\n      names: input.sectionNames,\n    })\n    if (!slots.length) return nodes\n    let found: ReadonlyArray<AiLayoutPicturePhoto | null> = []\n    if (input.source) {\n      try {\n        found = await input.source(slots)\n      } catch (error) {\n        console.warn('ai layout pictures: the stock source failed; starter photos fill the page', { error })\n        found = []\n      }\n    }\n    const starters = aiLayoutStarterPhotos(slots, input.seed)\n    return aiLayoutPlacePictures(\n      nodes,\n      slots,\n      slots.map((_slot, index) => found[index] ?? starters[index]),\n    )\n  } catch (error) {\n    console.error('ai layout pictures: the page keeps its empty picture slots', { error })\n    return nodes\n  }\n}\n"],"names":["DEFAULT_SITE_IMAGES","PEOPLE","aspectOf","value","match","exec","String","ratio","Number","isFinite","aiLayoutPictureRole","input","sectionIndex","test","sectionName","alt","aiLayoutPictureSlots","nodes","rootId","sections","map","slots","seen","Set","visit","id","parentId","node","has","add","index","ids","indexOf","here","componentId","src","props","trim","frame","undefined","iconId","find","child","push","imageId","frameId","aspect","sx","role","names","AI_LAYOUT_STARTER_PHOTOS","STARTER_POOLS","hero","about","gallery","ALL_STARTERS","Object","keys","aiLayoutSeedNumber","seed","hash","length","charCodeAt","Math","imul","rotate","list","by","start","slice","aiLayoutStarterPhotos","turn","used","slot","pool","rest","filter","name","includes","size","clear","candidate","photo","width","height","aiLayoutPlacePictures","photos","next","forEach","intrinsicWidth","intrinsicHeight","loading","aiResolveLayoutPictures","sectionIds","sectionNames","found","source","error","console","warn","starters","_slot"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-pictures.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 { DEFAULT_SITE_IMAGES } from '@aglyn/aglyn/app-utils/default-site'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\n\n/**\n * THE PICTURES OF A LANGUAGE PAGE (AGL-3660).\n *\n * The compiler writes a picture slot as a frame holding an icon and an\n * `image` with alt text and no source (`ai-layout-compiler.ts`), and stays\n * pure: it never looks a photo up. This module is what runs after it, on the\n * stored page — it finds each empty slot, decides what kind of picture the\n * slot is, and fills it with a photo the site can serve from its own origin.\n *\n * Two sources fill a slot, in order:\n *\n * 1. A stock photo searched for by the slot's own description and copied into\n *    the site's media library (`jobs/ai-layout-stock-photos.ts`), when the\n *    deployment has a stock-photo key.\n * 2. Otherwise, or when the search finds nothing fitting, one of the STARTER\n *    PHOTOS every new site is born with (`DEFAULT_SITE_IMAGES`, served at\n *    `/_static/starter/` by the tenant and the console alike, credited in the\n *    CREDITS file beside them). They are the platform's own files, so a\n *    visitor's browser asks no other host for them.\n *\n * The slot keeps the alt text the model wrote whichever source fills it.\n */\n\n/** What a picture slot is for, read from where it sits and what it says. */\nexport type AiLayoutPictureRole = 'hero' | 'about' | 'gallery'\n\n/** One empty picture slot of a stored page, in document order. */\nexport interface AiLayoutPictureSlot {\n  /** The `image` node. */\n  imageId: string\n  /** The frame around it, which sets the slot's shape. */\n  frameId: string | null\n  /** The placeholder icon sharing the frame, taken out once a photo fills it. */\n  iconId: string | null\n  alt: string\n  /** The frame's shape as width over height; 1 when it names none. */\n  aspect: number\n  /** The plan index of the section it sits in, or -1. */\n  sectionIndex: number\n  role: AiLayoutPictureRole\n}\n\n/** A photo a slot is filled with. */\nexport interface AiLayoutPicturePhoto {\n  /** The site-served address: a starter path or the media library's own. */\n  src: string\n  width: number\n  height: number\n}\n\n/** Words that say a picture shows people, or a section is about them. */\nconst PEOPLE =\n  /\\b(about|team|story|owner|owners|founder|founders|staff|crew|people|person|portrait|meet|family|families|who we are|our (?:team|crew|people|story)|therapist|counsel(?:l)?or|coach|doctor|dentist|stylist|trainer|smil(?:e|es|ing)|headshot)\\b/i\n\n/**\n * An `aspectRatio` (`'16 / 9'`) as a number, or `null` where none is named.\n * A responsive one (`{ xs: '4 / 3', md: '4 / 5' }`, as a designed page's\n * pictures carry, AGL-3660) reads at the desktop breakpoint first: one photo\n * serves every width, and the wide screen is where its shape shows most.\n */\nfunction aspectOf(value: unknown): number | null {\n  if (value && typeof value === 'object') {\n    const byBreakpoint = value as Record<string, unknown>\n    for (const breakpoint of ['md', 'lg', 'xl', 'sm', 'xs']) {\n      const ratio = aspectOf(byBreakpoint[breakpoint])\n      if (ratio !== null) return ratio\n    }\n    return null\n  }\n  const match = /^\\s*(\\d+(?:\\.\\d+)?)\\s*\\/\\s*(\\d+(?:\\.\\d+)?)\\s*$/.exec(String(value ?? ''))\n  if (!match) return null\n  const ratio = Number(match[1]) / Number(match[2])\n  return Number.isFinite(ratio) && ratio > 0 ? ratio : null\n}\n\n/** The shape a full-bleed cover's photo is searched for: it fills a wide band. */\nconst COVER_ASPECT = 16 / 9\n\n/**\n * A slot's shape (AGL-3660): the image's own `aspectRatio` (a designed\n * picture card sets it on the image), else its frame's, else — for a frame\n * laid absolutely over its whole section, a designed photo cover — a wide\n * band's. 1 where nothing says.\n */\nfunction slotAspect(image: { sx?: Record<string, unknown> } | undefined, frame: { sx?: Record<string, unknown> } | undefined): number {\n  const own = aspectOf(image?.sx?.['aspectRatio']) ?? aspectOf(frame?.sx?.['aspectRatio'])\n  if (own !== null) return own\n  const sx = frame?.sx\n  if (sx?.['position'] === 'absolute' && sx['width'] === '100%' && sx['height'] === '100%') return COVER_ASPECT\n  return 1\n}\n\n/** A slot's role: the first section's picture is the hero; people make an about picture. */\nexport function aiLayoutPictureRole(input: {\n  sectionIndex: number\n  sectionName: string\n  alt: string\n}): AiLayoutPictureRole {\n  if (input.sectionIndex === 0) return 'hero'\n  if (PEOPLE.test(input.sectionName) || PEOPLE.test(input.alt)) return 'about'\n  return 'gallery'\n}\n\n/**\n * Every empty picture slot of a stored page, walked from its root in\n * document order. A slot that already has a source — one the owner placed, or\n * an earlier pass filled — is not a slot.\n */\nexport function aiLayoutPictureSlots(\n  nodes: NodesMap,\n  rootId: string,\n  sections: { ids: readonly string[]; names: readonly string[] },\n): AiLayoutPictureSlot[] {\n  const map = nodes as unknown as Record<\n    string,\n    { componentId?: string; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: string[] }\n  >\n  const slots: AiLayoutPictureSlot[] = []\n  const seen = new Set<string>()\n  const visit = (id: string, parentId: string | null, sectionIndex: number) => {\n    if (seen.has(id)) return\n    seen.add(id)\n    const node = map[id]\n    if (!node) return\n    const index = sections.ids.indexOf(id)\n    const here = index >= 0 ? index : sectionIndex\n    if (node.componentId === 'image') {\n      const src = node.props?.['src']\n      const alt = typeof node.props?.['alt'] === 'string' ? (node.props['alt'] as string).trim() : ''\n      if ((typeof src !== 'string' || !src.trim()) && alt) {\n        const frame = parentId ? map[parentId] : undefined\n        const iconId =\n          frame?.nodes?.find((child) => child !== id && map[child]?.componentId === 'icon') ?? null\n        slots.push({\n          imageId: id,\n          frameId: frame ? parentId : null,\n          iconId,\n          alt,\n          aspect: slotAspect(node, frame),\n          sectionIndex: here,\n          role: aiLayoutPictureRole({\n            sectionIndex: here,\n            sectionName: here >= 0 ? (sections.names[here] ?? '') : '',\n            alt,\n          }),\n        })\n      }\n    }\n    for (const child of node.nodes ?? []) visit(child, id, here)\n  }\n  visit(rootId, null, -1)\n  return slots\n}\n\n/** The starter photos, by name. */\nexport const AI_LAYOUT_STARTER_PHOTOS = DEFAULT_SITE_IMAGES\n\ntype StarterName = keyof typeof AI_LAYOUT_STARTER_PHOTOS\n\n/**\n * The starter photos each role draws from, best first. A hero draws from the\n * wide photos that read as a page's opening, an about picture leads with the\n * owner, and the rest are the gallery's.\n */\nconst STARTER_POOLS: Readonly<Record<AiLayoutPictureRole, readonly StarterName[]>> = {\n  hero: ['hero', 'desk', 'craft'],\n  about: ['about', 'hero'],\n  gallery: ['desk', 'plants', 'craft'],\n}\n\nconst ALL_STARTERS = Object.keys(AI_LAYOUT_STARTER_PHOTOS) as StarterName[]\n\n/** A small stable number from a seed, so the same job always picks the same photos. */\nexport function aiLayoutSeedNumber(seed: string): number {\n  let hash = 2166136261\n  for (let index = 0; index < seed.length; index += 1) {\n    hash ^= seed.charCodeAt(index)\n    hash = Math.imul(hash, 16777619)\n  }\n  return hash >>> 0\n}\n\nfunction rotate<T>(list: readonly T[], by: number): T[] {\n  if (!list.length) return []\n  const start = by % list.length\n  return [...list.slice(start), ...list.slice(0, start)]\n}\n\n/**\n * A starter photo for each slot (AGL-3660). No photo repeats on a page while\n * an unused one remains, and every pool turns by the seed, so sites do not\n * all open with the same photo while one job always picks the same.\n *\n * The slots are served by what they are for, not where they sit: the hero\n * first, then the pictures of people (an about picture leads with the owner),\n * then the rest. The live Juniper Clay start (2026-10-08) had six slots and\n * five starters, and the owner's photo went to a stoneware card before the\n * About section that described the artist asked for it. Only a page with more\n * slots than starters repeats one: the photo placed longest ago, never the\n * one in a slot beside it.\n */\nexport function aiLayoutStarterPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  seed: string,\n): AiLayoutPicturePhoto[] {\n  const turn = aiLayoutSeedNumber(seed)\n  const order: AiLayoutPictureRole[] = ['hero', 'about', 'gallery']\n  const served = slots\n    .map((slot, index) => ({ slot, index }))\n    .sort((a, b) => order.indexOf(a.slot.role) - order.indexOf(b.slot.role) || a.index - b.index)\n  const names: Array<StarterName | undefined> = slots.map(() => undefined)\n  /** When each starter was last placed, by its turn in the serving order. */\n  const placedAt = new Map<StarterName, number>()\n  served.forEach(({ slot, index }, step) => {\n    // An about picture leads with the owner on every site; the others turn.\n    const pool = slot.role === 'about' ? [...STARTER_POOLS.about] : rotate(STARTER_POOLS[slot.role], turn)\n    const rest = rotate(\n      ALL_STARTERS.filter((name) => !pool.includes(name)),\n      turn,\n    )\n    const candidates = [...pool, ...rest]\n    const unused = candidates.find((candidate) => !placedAt.has(candidate))\n    const beside = new Set([names[index - 1], names[index + 1]].filter(Boolean))\n    const name =\n      unused ??\n      [...candidates]\n        .sort((a, b) => (placedAt.get(a) ?? -1) - (placedAt.get(b) ?? -1))\n        .find((candidate) => !beside.has(candidate)) ??\n      candidates[0]\n    names[index] = name\n    placedAt.set(name, step)\n  })\n  return names.map((name) => {\n    const photo = AI_LAYOUT_STARTER_PHOTOS[name as StarterName]\n    return { src: photo.src, width: photo.width, height: photo.height }\n  })\n}\n\n/**\n * The page with each slot filled by its photo: the `image` given its source,\n * its intrinsic size and how it loads (the hero eagerly, as the starter home\n * page loads its own), and the placeholder icon taken out of the frame. The\n * alt text is kept as the model wrote it. A slot given no photo is left as\n * the compiler wrote it.\n */\nexport function aiLayoutPlacePictures(\n  nodes: NodesMap,\n  slots: readonly AiLayoutPictureSlot[],\n  photos: ReadonlyArray<AiLayoutPicturePhoto | null>,\n): NodesMap {\n  const next = { ...(nodes as unknown as Record<string, Record<string, unknown>>) }\n  slots.forEach((slot, index) => {\n    const photo = photos[index]\n    const node = next[slot.imageId]\n    if (!photo || !node) return\n    next[slot.imageId] = {\n      ...node,\n      props: {\n        ...((node['props'] as Record<string, unknown> | undefined) ?? {}),\n        src: photo.src,\n        intrinsicWidth: photo.width,\n        intrinsicHeight: photo.height,\n        loading: slot.role === 'hero' ? 'eager' : 'lazy',\n      },\n    }\n    if (slot.iconId && slot.frameId && next[slot.frameId]) {\n      const frame = next[slot.frameId]\n      next[slot.frameId] = {\n        ...frame,\n        nodes: ((frame['nodes'] as string[] | undefined) ?? []).filter((child) => child !== slot.iconId),\n      }\n      delete next[slot.iconId]\n    }\n  })\n  return next as unknown as NodesMap\n}\n\n/**\n * A source of photos found for the slots themselves — a stock search copied\n * into the site's library — answering one photo or `null` per slot, in order.\n * It may throw; a slot it leaves unfilled takes a starter photo.\n */\nexport type AiLayoutPictureSource = (\n  slots: readonly AiLayoutPictureSlot[],\n) => Promise<ReadonlyArray<AiLayoutPicturePhoto | null>>\n\n/**\n * Fills a stored page's empty picture slots (AGL-3660): from `source` where\n * one is given and it answers, else from the starter photos. Never throws,\n * and never leaves a page worse than it came: a picture is decoration, and a\n * job never fails over one.\n */\nexport async function aiResolveLayoutPictures(\n  nodes: NodesMap,\n  input: {\n    rootId: string\n    sectionIds: readonly string[]\n    sectionNames: readonly string[]\n    /** A per-job word, so two sites do not open with the same photo. */\n    seed: string\n    source?: AiLayoutPictureSource | null\n  },\n): Promise<NodesMap> {\n  try {\n    const slots = aiLayoutPictureSlots(nodes, input.rootId, {\n      ids: input.sectionIds,\n      names: input.sectionNames,\n    })\n    if (!slots.length) return nodes\n    let found: ReadonlyArray<AiLayoutPicturePhoto | null> = []\n    if (input.source) {\n      try {\n        found = await input.source(slots)\n      } catch (error) {\n        console.warn('ai layout pictures: the stock source failed; starter photos fill the page', { error })\n        found = []\n      }\n    }\n    const starters = aiLayoutStarterPhotos(slots, input.seed)\n    return aiLayoutPlacePictures(\n      nodes,\n      slots,\n      slots.map((_slot, index) => found[index] ?? starters[index]),\n    )\n  } catch (error) {\n    console.error('ai layout pictures: the page keeps its empty picture slots', { error })\n    return nodes\n  }\n}\n"],"names":["DEFAULT_SITE_IMAGES","PEOPLE","aspectOf","value","byBreakpoint","breakpoint","ratio","match","exec","String","Number","isFinite","COVER_ASPECT","slotAspect","image","frame","own","sx","aiLayoutPictureRole","input","sectionIndex","test","sectionName","alt","aiLayoutPictureSlots","nodes","rootId","sections","map","slots","seen","Set","visit","id","parentId","node","has","add","index","ids","indexOf","here","componentId","src","props","trim","undefined","iconId","find","child","push","imageId","frameId","aspect","role","names","AI_LAYOUT_STARTER_PHOTOS","STARTER_POOLS","hero","about","gallery","ALL_STARTERS","Object","keys","aiLayoutSeedNumber","seed","hash","length","charCodeAt","Math","imul","rotate","list","by","start","slice","aiLayoutStarterPhotos","turn","order","served","slot","sort","a","b","placedAt","Map","forEach","step","unused","pool","rest","filter","name","includes","candidates","candidate","beside","Boolean","get","set","photo","width","height","aiLayoutPlacePictures","photos","next","intrinsicWidth","intrinsicHeight","loading","aiResolveLayoutPictures","sectionIds","sectionNames","found","source","error","console","warn","starters","_slot"],"mappings":"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"}

package/src/lib/model/ai-job-notice.d.ts

@@ -25,8 +25,16 @@ export declare const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resour
 export declare const AI_JOB_LINK_PARAM = "aiJob";
 /** Where a site's "Building your site" page lives, under the site (AGL-3594). */
 export declare const AI_SITE_BUILD_HREF = "/ai-jobs";
+/**
+ * What a job the meter paused says comes next (AGL-3660), on its notice and
+ * its page alike: nothing it built is lost, and it carries on from where it
+ * stopped — by Resume once there are credits, or by itself when they return.
+ */
+export declare const AI_JOB_PAUSED_NEXT_COPY: string;
+/** A paused job's heading, by what it builds. */
+export declare function aiJobPausedTitle(kind: AiJobKind): string;
 /** A change the person who started a job is told about. */
-export type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed';
+export type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed' | 'paused';
 /** The fields of a stored job a notice is written from. */
 export interface AiJobNoticeSource {
     $id: string;

package/src/lib/model/ai-job-notice.js

@@ -31,6 +31,15 @@ import { aiCustomerSafeCopy, aiJobRefundCopy } from "./ai-job-failure-copy.js";
  * (AGL-3593): the Assist panel reads it on arrival.
  */ export const AI_JOB_LINK_PARAM = 'aiJob';
 /** Where a site's "Building your site" page lives, under the site (AGL-3594). */ export const AI_SITE_BUILD_HREF = '/ai-jobs';
+/**
+ * What a job the meter paused says comes next (AGL-3660), on its notice and
+ * its page alike: nothing it built is lost, and it carries on from where it
+ * stopped — by Resume once there are credits, or by itself when they return.
+ */ export const AI_JOB_PAUSED_NEXT_COPY = 'Nothing is lost: what it built so far is saved. Once you have AI credits again — from Billing, ' + 'or when your monthly credits reset — choose Resume, or it carries on by itself within about an hour.';
+/** A paused job's heading, by what it builds. */ export function aiJobPausedTitle(kind) {
+    const noun = aiJobKindNoun(kind);
+    return noun === 'AI job' ? 'Your AI job is paused' : `Your ${noun} ${noun.endsWith('s') ? 'are' : 'is'} paused`;
+}
 /** A stopped job's sentence with what became of its credits, from the job's recorded give-back (AGL-3596). */ function withRefund(job, text, status) {
     const refund = aiJobRefundCopy({
         status,
@@ -101,6 +110,20 @@ import { aiCustomerSafeCopy, aiJobRefundCopy } from "./ai-job-failure-copy.js";
             link
         }, scope);
     }
+    if (to === 'paused') {
+        // Paused by the meter (AGL-3660): out of credits or at a cap. Nothing is
+        // lost and the job is not over, so it is a warning that names the way on.
+        return _extends({
+            type: 'content.aiJobNeedsYou',
+            level: 'warning',
+            title: aiJobPausedTitle(job.kind),
+            body: [
+                job.error,
+                AI_JOB_PAUSED_NEXT_COPY
+            ].filter(Boolean).join(' '),
+            link
+        }, scope);
+    }
     if (to === 'done') {
         var _job_items, _ref, _job_outputs;
         var _job_sitePublish;

package/src/lib/model/ai-job-notice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-notice.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 { AglynNotification } from '@aglyn/aglyn/app-utils/notifications'\nimport { aiBuildOutcomeLine, aiSitePartialCopy } from './ai-build-progress'\nimport { aiJobKindNoun } from './ai-job-activity'\nimport { aiCustomerSafeCopy, aiJobRefundCopy } from './ai-job-failure-copy'\nimport type { AiJobItemLedger, AiJobKind, AiJobOutput, AiJobReviewReason, AiJobSitePublish } from './ai-jobs.types'\n\n/** The besigner segment each versioned resource lives under. */\nexport const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resource'], string>> = {\n  screen: 'screens',\n  reusableComponent: 'components',\n  layout: 'layouts',\n  template: 'templates',\n  // An email design is a screen: it opens in the screen besigner, as the\n  // Emails page's own Edit design does.\n  emailScreen: 'screens',\n}\n\n/**\n * The query parameter a console address carries to open AI jobs on one job\n * (AGL-3593): the Assist panel reads it on arrival.\n */\nexport const AI_JOB_LINK_PARAM = 'aiJob'\n\n/** Where a site's \"Building your site\" page lives, under the site (AGL-3594). */\nexport const AI_SITE_BUILD_HREF = '/ai-jobs'\n\n/** A change the person who started a job is told about. */\nexport type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed'\n\n/** The fields of a stored job a notice is written from. */\nexport interface AiJobNoticeSource {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  review?: { reason: AiJobReviewReason; message?: string | null } | null\n  outputs?: readonly AiJobOutput[] | null\n  error?: string | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: Pick<AiJobSitePublish, 'published' | 'drafts'> | null\n  /** What the job spent, and gave back for a failure on our side (AGL-3596). */\n  creditsSpent?: number\n  refundedCredits?: number\n  /** A build's or a guided start's items (AGL-3616), so a finished one says what was not built. */\n  items?: AiJobItemLedger[] | null\n}\n\n/** A stopped job's sentence with what became of its credits, from the job's recorded give-back (AGL-3596). */\nfunction withRefund(job: AiJobNoticeSource, text: string, status: 'failed' | 'needs_review'): string {\n  const refund = aiJobRefundCopy({ status, refundedCredits: job.refundedCredits, creditsSpent: job.creditsSpent })\n  return refund ? `${text} ${refund}` : text\n}\n\nexport type AiJobNotice = Pick<\n  AglynNotification,\n  'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'\n>\n\n/**\n * Where a notice's link goes, in the stored form the console rewrites when it\n * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,\n * `/org…` for a job of the workspace's.\n *\n * A job that is done leads to what it built (AGL-3593): several pages of the\n * job's site open that site's Pages list, one versioned output opens in the\n * editor on the version the job wrote. Everything else — a plan to confirm, a\n * job that stopped, a done job with nothing of its own to open — opens AI\n * jobs on the job.\n */\nexport function aiJobNoticeLink(job: AiJobNoticeSource, to: AiJobNoticeTransition): string {\n  const base = job.hostId ? `/${job.hostId}` : '/org'\n  // A site job's every notice opens its \"Building your site\" page (AGL-3594),\n  // which leads with the next step whatever the job's state.\n  if (job.kind === 'site' && job.hostId) return `${base}${AI_SITE_BUILD_HREF}/${encodeURIComponent(job.$id)}`\n  if (to === 'done' && job.hostId) {\n    const own = (job.outputs ?? []).filter((output) => output.hostId === job.hostId)\n    const screens = own.filter((output) => output.resource === 'screen')\n    if (screens.length > 1) return `${base}/screens`\n    const versioned = own.find(\n      (output) => AI_JOB_BESIGNER_SEGMENT[output.resource] && output.versionId,\n    )\n    if (own.length === 1 && versioned) {\n      const segment = AI_JOB_BESIGNER_SEGMENT[versioned.resource]\n      return `${base}/${segment}/${versioned.id}/versions/${versioned.versionId}/besigner`\n    }\n  }\n  return `${base}?${AI_JOB_LINK_PARAM}=${encodeURIComponent(job.$id)}`\n}\n\n/**\n * The in-app notification for one change of one job (AGL-3593), for the\n * person who created it. Customer-safe throughout: a stopped job's sentence is\n * the job's own `error`, which the machine writes as a fixed sentence.\n */\nexport function aiJobNotice(job: AiJobNoticeSource, to: AiJobNoticeTransition): AiJobNotice {\n  const noun = aiJobKindNoun(job.kind)\n  const scope = { orgId: job.orgId, ...(job.hostId ? { hostId: job.hostId } : {}) }\n  const link = aiJobNoticeLink(job, to)\n  if (to === 'needs-review') {\n    if (job.review?.reason === 'plan') {\n      return {\n        type: 'content.aiJobNeedsYou',\n        level: 'warning',\n        title:\n          noun === 'AI job'\n            ? 'Your plan is ready: confirm it to build'\n            : `Your ${noun} plan is ready: confirm it to build`,\n        body: 'Nothing is built until you confirm the plan. It waits in AI jobs.',\n        link,\n        ...scope,\n      }\n    }\n    return {\n      type: 'content.aiJobNeedsYou',\n      level: 'warning',\n      title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,\n      // The doctrine's own words never reach a customer (AGL-3596).\n      body: withRefund(\n        job,\n        aiCustomerSafeCopy(job.review?.message || job.error || 'It stopped for your decision. It waits in AI jobs.', { page: job.kind === 'page' }),\n        'needs_review',\n      ),\n      link,\n      ...scope,\n    }\n  }\n  if (to === 'done') {\n    // A job that finished with part of it unbuilt (AGL-3596) says so in the\n    // words its page uses, as a warning: \"done\" alone hid a page that failed.\n    const items = job.items ?? []\n    const unbuilt = items.some((row) => row.status === 'failed' || row.status === 'skipped')\n    const level = unbuilt ? 'warning' : 'success'\n    const partial =\n      job.kind === 'site'\n        ? aiSitePartialCopy({ items, status: 'done' })\n        : unbuilt\n          ? aiBuildOutcomeLine({ items, status: 'done' })\n          : null\n    // A guided site start publishes its pages when it finishes (AGL-3596):\n    // with one live, the site is, and the build page lists any that stayed\n    // drafts with the reason for each.\n    const live = job.kind === 'site' ? (job.sitePublish?.published.length ?? 0) : 0\n    if (live > 0) {\n      const drafts = job.sitePublish?.drafts.length ?? 0\n      const stayed = drafts === 1 ? 'one that stayed a draft' : `${drafts} that stayed drafts`\n      return {\n        type: 'content.aiJobDone',\n        level,\n        title: partial ? 'Your site is live, but part of it wasn’t built' : 'Your site is live',\n        body: partial\n          ? `${partial} ${drafts > 0 ? `What was built is published, except ${stayed}.` : 'What was built is published.'}`\n          : drafts > 0\n            ? `Your pages are published, except ${stayed}. Open it to see why.`\n            : 'Your pages are published. Open it to view your site or edit your pages.',\n        link,\n        ...scope,\n      }\n    }\n    const pages = (job.outputs ?? []).filter((output) => output.resource === 'screen').length\n    const title =\n      job.kind === 'site' || pages > 1\n        ? 'Your site’s draft pages are ready'\n        : job.kind === 'page'\n          ? 'Your draft page is ready'\n          : noun === 'AI job'\n            ? 'Your AI job finished'\n            : `Your ${noun} is ready`\n    return {\n      type: 'content.aiJobDone',\n      level,\n      title,\n      body:\n        job.kind === 'insight' || job.kind === 'text'\n          ? 'Open AI jobs to read it.'\n          : [partial, 'Everything it built is an unpublished draft until you publish it.'].filter(Boolean).join(' '),\n      link,\n      ...scope,\n    }\n  }\n  return {\n    type: 'content.aiJobFailed',\n    level: 'warning',\n    title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,\n    body: withRefund(job, aiCustomerSafeCopy(job.error || 'It stopped before it finished.', { page: job.kind === 'page' }), 'failed'),\n    link,\n    ...scope,\n  }\n}\n"],"names":["aiBuildOutcomeLine","aiSitePartialCopy","aiJobKindNoun","aiCustomerSafeCopy","aiJobRefundCopy","AI_JOB_BESIGNER_SEGMENT","screen","reusableComponent","layout","template","emailScreen","AI_JOB_LINK_PARAM","AI_SITE_BUILD_HREF","withRefund","job","text","status","refund","refundedCredits","creditsSpent","aiJobNoticeLink","to","base","hostId","kind","encodeURIComponent","$id","own","outputs","filter","output","screens","resource","length","versioned","find","versionId","segment","id","aiJobNotice","noun","scope","orgId","link","review","reason","type","level","title","body","message","error","page","items","unbuilt","some","row","partial","live","sitePublish","published","drafts","stayed","pages","Boolean","join"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-notice.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 { AglynNotification } from '@aglyn/aglyn/app-utils/notifications'\nimport { aiBuildOutcomeLine, aiSitePartialCopy } from './ai-build-progress'\nimport { aiJobKindNoun } from './ai-job-activity'\nimport { aiCustomerSafeCopy, aiJobRefundCopy } from './ai-job-failure-copy'\nimport type { AiJobItemLedger, AiJobKind, AiJobOutput, AiJobReviewReason, AiJobSitePublish } from './ai-jobs.types'\n\n/** The besigner segment each versioned resource lives under. */\nexport const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resource'], string>> = {\n  screen: 'screens',\n  reusableComponent: 'components',\n  layout: 'layouts',\n  template: 'templates',\n  // An email design is a screen: it opens in the screen besigner, as the\n  // Emails page's own Edit design does.\n  emailScreen: 'screens',\n}\n\n/**\n * The query parameter a console address carries to open AI jobs on one job\n * (AGL-3593): the Assist panel reads it on arrival.\n */\nexport const AI_JOB_LINK_PARAM = 'aiJob'\n\n/** Where a site's \"Building your site\" page lives, under the site (AGL-3594). */\nexport const AI_SITE_BUILD_HREF = '/ai-jobs'\n\n/**\n * What a job the meter paused says comes next (AGL-3660), on its notice and\n * its page alike: nothing it built is lost, and it carries on from where it\n * stopped — by Resume once there are credits, or by itself when they return.\n */\nexport const AI_JOB_PAUSED_NEXT_COPY =\n  'Nothing is lost: what it built so far is saved. Once you have AI credits again — from Billing, ' +\n  'or when your monthly credits reset — choose Resume, or it carries on by itself within about an hour.'\n\n/** A paused job's heading, by what it builds. */\nexport function aiJobPausedTitle(kind: AiJobKind): string {\n  const noun = aiJobKindNoun(kind)\n  return noun === 'AI job' ? 'Your AI job is paused' : `Your ${noun} ${noun.endsWith('s') ? 'are' : 'is'} paused`\n}\n\n/** A change the person who started a job is told about. */\nexport type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed' | 'paused'\n\n/** The fields of a stored job a notice is written from. */\nexport interface AiJobNoticeSource {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  review?: { reason: AiJobReviewReason; message?: string | null } | null\n  outputs?: readonly AiJobOutput[] | null\n  error?: string | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: Pick<AiJobSitePublish, 'published' | 'drafts'> | null\n  /** What the job spent, and gave back for a failure on our side (AGL-3596). */\n  creditsSpent?: number\n  refundedCredits?: number\n  /** A build's or a guided start's items (AGL-3616), so a finished one says what was not built. */\n  items?: AiJobItemLedger[] | null\n}\n\n/** A stopped job's sentence with what became of its credits, from the job's recorded give-back (AGL-3596). */\nfunction withRefund(job: AiJobNoticeSource, text: string, status: 'failed' | 'needs_review'): string {\n  const refund = aiJobRefundCopy({ status, refundedCredits: job.refundedCredits, creditsSpent: job.creditsSpent })\n  return refund ? `${text} ${refund}` : text\n}\n\nexport type AiJobNotice = Pick<\n  AglynNotification,\n  'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'\n>\n\n/**\n * Where a notice's link goes, in the stored form the console rewrites when it\n * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,\n * `/org…` for a job of the workspace's.\n *\n * A job that is done leads to what it built (AGL-3593): several pages of the\n * job's site open that site's Pages list, one versioned output opens in the\n * editor on the version the job wrote. Everything else — a plan to confirm, a\n * job that stopped, a done job with nothing of its own to open — opens AI\n * jobs on the job.\n */\nexport function aiJobNoticeLink(job: AiJobNoticeSource, to: AiJobNoticeTransition): string {\n  const base = job.hostId ? `/${job.hostId}` : '/org'\n  // A site job's every notice opens its \"Building your site\" page (AGL-3594),\n  // which leads with the next step whatever the job's state.\n  if (job.kind === 'site' && job.hostId) return `${base}${AI_SITE_BUILD_HREF}/${encodeURIComponent(job.$id)}`\n  if (to === 'done' && job.hostId) {\n    const own = (job.outputs ?? []).filter((output) => output.hostId === job.hostId)\n    const screens = own.filter((output) => output.resource === 'screen')\n    if (screens.length > 1) return `${base}/screens`\n    const versioned = own.find(\n      (output) => AI_JOB_BESIGNER_SEGMENT[output.resource] && output.versionId,\n    )\n    if (own.length === 1 && versioned) {\n      const segment = AI_JOB_BESIGNER_SEGMENT[versioned.resource]\n      return `${base}/${segment}/${versioned.id}/versions/${versioned.versionId}/besigner`\n    }\n  }\n  return `${base}?${AI_JOB_LINK_PARAM}=${encodeURIComponent(job.$id)}`\n}\n\n/**\n * The in-app notification for one change of one job (AGL-3593), for the\n * person who created it. Customer-safe throughout: a stopped job's sentence is\n * the job's own `error`, which the machine writes as a fixed sentence.\n */\nexport function aiJobNotice(job: AiJobNoticeSource, to: AiJobNoticeTransition): AiJobNotice {\n  const noun = aiJobKindNoun(job.kind)\n  const scope = { orgId: job.orgId, ...(job.hostId ? { hostId: job.hostId } : {}) }\n  const link = aiJobNoticeLink(job, to)\n  if (to === 'needs-review') {\n    if (job.review?.reason === 'plan') {\n      return {\n        type: 'content.aiJobNeedsYou',\n        level: 'warning',\n        title:\n          noun === 'AI job'\n            ? 'Your plan is ready: confirm it to build'\n            : `Your ${noun} plan is ready: confirm it to build`,\n        body: 'Nothing is built until you confirm the plan. It waits in AI jobs.',\n        link,\n        ...scope,\n      }\n    }\n    return {\n      type: 'content.aiJobNeedsYou',\n      level: 'warning',\n      title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,\n      // The doctrine's own words never reach a customer (AGL-3596).\n      body: withRefund(\n        job,\n        aiCustomerSafeCopy(job.review?.message || job.error || 'It stopped for your decision. It waits in AI jobs.', { page: job.kind === 'page' }),\n        'needs_review',\n      ),\n      link,\n      ...scope,\n    }\n  }\n  if (to === 'paused') {\n    // Paused by the meter (AGL-3660): out of credits or at a cap. Nothing is\n    // lost and the job is not over, so it is a warning that names the way on.\n    return {\n      type: 'content.aiJobNeedsYou',\n      level: 'warning',\n      title: aiJobPausedTitle(job.kind),\n      body: [job.error, AI_JOB_PAUSED_NEXT_COPY].filter(Boolean).join(' '),\n      link,\n      ...scope,\n    }\n  }\n  if (to === 'done') {\n    // A job that finished with part of it unbuilt (AGL-3596) says so in the\n    // words its page uses, as a warning: \"done\" alone hid a page that failed.\n    const items = job.items ?? []\n    const unbuilt = items.some((row) => row.status === 'failed' || row.status === 'skipped')\n    const level = unbuilt ? 'warning' : 'success'\n    const partial =\n      job.kind === 'site'\n        ? aiSitePartialCopy({ items, status: 'done' })\n        : unbuilt\n          ? aiBuildOutcomeLine({ items, status: 'done' })\n          : null\n    // A guided site start publishes its pages when it finishes (AGL-3596):\n    // with one live, the site is, and the build page lists any that stayed\n    // drafts with the reason for each.\n    const live = job.kind === 'site' ? (job.sitePublish?.published.length ?? 0) : 0\n    if (live > 0) {\n      const drafts = job.sitePublish?.drafts.length ?? 0\n      const stayed = drafts === 1 ? 'one that stayed a draft' : `${drafts} that stayed drafts`\n      return {\n        type: 'content.aiJobDone',\n        level,\n        title: partial ? 'Your site is live, but part of it wasn’t built' : 'Your site is live',\n        body: partial\n          ? `${partial} ${drafts > 0 ? `What was built is published, except ${stayed}.` : 'What was built is published.'}`\n          : drafts > 0\n            ? `Your pages are published, except ${stayed}. Open it to see why.`\n            : 'Your pages are published. Open it to view your site or edit your pages.',\n        link,\n        ...scope,\n      }\n    }\n    const pages = (job.outputs ?? []).filter((output) => output.resource === 'screen').length\n    const title =\n      job.kind === 'site' || pages > 1\n        ? 'Your site’s draft pages are ready'\n        : job.kind === 'page'\n          ? 'Your draft page is ready'\n          : noun === 'AI job'\n            ? 'Your AI job finished'\n            : `Your ${noun} is ready`\n    return {\n      type: 'content.aiJobDone',\n      level,\n      title,\n      body:\n        job.kind === 'insight' || job.kind === 'text'\n          ? 'Open AI jobs to read it.'\n          : [partial, 'Everything it built is an unpublished draft until you publish it.'].filter(Boolean).join(' '),\n      link,\n      ...scope,\n    }\n  }\n  return {\n    type: 'content.aiJobFailed',\n    level: 'warning',\n    title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,\n    body: withRefund(job, aiCustomerSafeCopy(job.error || 'It stopped before it finished.', { page: job.kind === 'page' }), 'failed'),\n    link,\n    ...scope,\n  }\n}\n"],"names":["aiBuildOutcomeLine","aiSitePartialCopy","aiJobKindNoun","aiCustomerSafeCopy","aiJobRefundCopy","AI_JOB_BESIGNER_SEGMENT","screen","reusableComponent","layout","template","emailScreen","AI_JOB_LINK_PARAM","AI_SITE_BUILD_HREF","AI_JOB_PAUSED_NEXT_COPY","aiJobPausedTitle","kind","noun","endsWith","withRefund","job","text","status","refund","refundedCredits","creditsSpent","aiJobNoticeLink","to","base","hostId","encodeURIComponent","$id","own","outputs","filter","output","screens","resource","length","versioned","find","versionId","segment","id","aiJobNotice","scope","orgId","link","review","reason","type","level","title","body","message","error","page","Boolean","join","items","unbuilt","some","row","partial","live","sitePublish","published","drafts","stayed","pages"],"mappings":"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"}

package/src/lib/model/ai-plan-capabilities.d.ts

@@ -93,6 +93,13 @@ export interface AiPlanCapabilities {
      * calls a repeat. A plan is then not asked for a component for a section's
      * repeated items (AGL-3616); a section two pages share still is one. The
      * plan step sets it for a `build` job. Absent is `false`.
+     *
+     * It is the plan half of one rule. The page half is the tree check's
+     * `AiDoctrineTreeContext.repeatsCompiled`, which every page the layout
+     * language compiles is checked with: where the site's design draws a
+     * section's items as picture cards — larger than the compact form, and so
+     * a block rule 1 would count — those cards are the compiler's, not a block
+     * typed out twice, and rule 1 asks no component of them (AGL-3660).
      */
     repeatsCompiled?: boolean;
 }

package/src/lib/model/ai-plan-capabilities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-plan-capabilities.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 {\n  AI_BUILD_PLAN_CREATE_KINDS,\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  type AiBuildPlan,\n  type AiBuildPlanCreateKind,\n} from './ai-build-plan'\n\n/**\n * What a plan may create on one site (AGL-3030): the workspace's plan and the\n * site's counts against its limits, narrowed to what the job itself builds.\n *\n * A plan that names a creation nothing can make is a dead end the member pays\n * for twice: once for the plan, and again for the plan they describe after\n * being told to make the creation by hand — which, on a workspace whose plan\n * does not include it, they cannot. So the plan step is TOLD what may be\n * created before it answers, and the plan rules refuse a creation outside it\n * with the one re-ask every other rule gets.\n *\n * ── Where the doctrine builds inline ─────────────────────────────────────\n *\n * The building doctrine makes a repeat a reusable component and a form a\n * saved form placed by id. A workspace whose plan keeps no reusable\n * components draws a list's repeated items in one section instead\n * (AGL-3071); `reusableComponents` is the one flag every validator reads for\n * that.\n *\n * A form is never drawn inline (AGL-3596): it is a saved form, counted\n * against the site's form allowance like one a member makes. Where the site\n * has none to place and may create none, the page places no form at all.\n *\n * ── Kept out of the cached prefix ────────────────────────────────────────\n *\n * The capabilities are per workspace and per site, so they ride the plan's\n * USER turn, never a system block: the doctrine's cached prefix stays one\n * entry for the platform. The doctrine states the rule once — create only\n * what the request says may be created, and build inline where it says the\n * workspace keeps no reusable components — and the request states the facts.\n *\n * This module imports nothing at runtime beyond the plan's own model, so the\n * validators, the plan step, the doors and their specs read one vocabulary.\n * What a workspace's plan and counts come to is read by\n * `readAiPlanCapabilities` in `jobs/ai-job-drafts.ts`, beside the band\n * arithmetic the create route and the draft writer share.\n */\n\n/** One creation kind, as a job on this site may make it or not. */\nexport interface AiPlanCreation {\n  allowed: boolean\n  /** How many more the site may hold; `null` when the plan counts none. */\n  left: number | null\n  /**\n   * Why not, as a clause a sentence completes: \"this workspace's plan does\n   * not include reusable components\". `null` when allowed.\n   */\n  reason: string | null\n}\n\nexport interface AiPlanCapabilities {\n  /**\n   * Whether the workspace keeps reusable components. Where it does not, a\n   * list's repeated items are drawn in one section. Forms are not read off\n   * it: whether one may be created is `create.form` (AGL-3596).\n   */\n  reusableComponents: boolean\n  /** Every creation kind a plan may name, and whether this job may make one here. */\n  create: Readonly<Record<AiBuildPlanCreateKind, AiPlanCreation>>\n  /**\n   * Whether the workspace spends the Free taste, whose monthly credits are a\n   * wall (AGL-2925): a plan is then held to the sections the wall's worst\n   * case pays for (AGL-3070). Absent is `false`.\n   */\n  freeTaste?: boolean\n  /**\n   * A Free workspace's site scaffold (AGL-3594): the most pages its plan may\n   * build, which the plan step sets for a `site` job on the Free taste. The\n   * Free wall then holds the plan to that many pages and to the sections a\n   * SITE plan's worst case leaves room for. Absent for every other job.\n   */\n  freeSitePages?: number\n  /**\n   * Whether this job's pages are written in the compact layout language\n   * (AGL-3660), whose compiler draws a section's repeated items itself: as\n   * instances of a component the plan places there, or, with none, in their\n   * compact form, a title over its text, which is smaller than a block rule 1\n   * calls a repeat. A plan is then not asked for a component for a section's\n   * repeated items (AGL-3616); a section two pages share still is one. The\n   * plan step sets it for a `build` job. Absent is `false`.\n   */\n  repeatsCompiled?: boolean\n}\n\n/** What a job of one kind builds from its own plan, where it builds only some creations. */\nexport interface AiPlanJobScope {\n  /** The job as a refusal names it: \"a page job\". */\n  noun: string\n  /** The creation kinds the job builds itself; any other is refused before the plan is kept. */\n  creates: readonly AiBuildPlanCreateKind[]\n}\n\nconst ALLOWED: AiPlanCreation = { allowed: true, left: null, reason: null }\n\n/**\n * Capabilities that restrict nothing: what a plan is held to when no\n * workspace was read — an org-level job, an eval, a spec about something\n * else. The doctrine applies whole.\n */\nexport function aiUnrestrictedPlanCapabilities(): AiPlanCapabilities {\n  return {\n    reusableComponents: true,\n    create: Object.fromEntries(\n      AI_BUILD_PLAN_CREATE_KINDS.map((kind) => [kind, ALLOWED]),\n    ) as Record<AiBuildPlanCreateKind, AiPlanCreation>,\n  }\n}\n\n/**\n * The workspace's capabilities narrowed to what a job of one kind builds.\n * A creation the workspace itself cannot make keeps the workspace's reason,\n * which is the one a member can act on; one the job does not build says so.\n */\nexport function aiPlanCapabilitiesForJob(\n  capabilities: AiPlanCapabilities,\n  scope: AiPlanJobScope | null | undefined,\n): AiPlanCapabilities {\n  if (!scope) return capabilities\n  const create = { ...capabilities.create }\n  for (const kind of AI_BUILD_PLAN_CREATE_KINDS) {\n    if (!create[kind].allowed || scope.creates.includes(kind)) continue\n    create[kind] = { allowed: false, left: null, reason: `${scope.noun} does not build one` }\n  }\n  return { ...capabilities, create }\n}\n\n/** \"a layout\", \"an email design\": a creation kind with its article. */\nexport function aiCreationNoun(kind: AiBuildPlanCreateKind): string {\n  const noun = AI_BUILD_PLAN_CREATION_NOUNS[kind].noun\n  return `${/^[aeiou]/.test(noun) ? 'an' : 'a'} ${noun}`\n}\n\n/**\n * The sentence a request states when the workspace keeps no reusable\n * components. It says a list's repeated items go in one section (AGL-3071):\n * \"a repeated item in its own section\" reads just as well as a section for\n * each item, which is how a live About page's four practice areas came to be\n * planned as four sections of one item.\n */\nexport const AI_PLAN_INLINE_SENTENCE =\n  \"This workspace keeps no reusable components: draw a list's repeated items in one section.\"\n\n/**\n * The sentence a build's request states (AGL-3616): its pages are written in\n * the layout language, which draws a section's repeated items itself, so the\n * plan counts them in the section's `items` and needs no component for them.\n */\nexport const AI_PLAN_COMPILED_REPEATS_SENTENCE =\n  \"A section's repeated items need no component here: count them in its items and the page draws them. A section two pages share is still one component.\"\n\n/**\n * The sentence a request states when the site has no saved form and this job\n * may create none (AGL-3596): the plan places no form, rather than one drawn\n * on the page with no saved form behind it.\n */\nexport const AI_PLAN_NO_FORM_SENTENCE =\n  'This site has no saved form and may create none: plan no form, and no section that collects answers.'\n\n/**\n * What the plan step's user turn says the job may create here: one line a\n * kind, and the inline sentence where the workspace keeps no reusable\n * components. Per workspace and per site, so it is never a system block.\n */\nexport function aiPlanCapabilityLines(capabilities: AiPlanCapabilities): string[] {\n  const lines = ['What this job may create on this site:']\n  for (const kind of AI_BUILD_PLAN_CREATE_KINDS) {\n    const entry = capabilities.create[kind]\n    const noun = AI_BUILD_PLAN_CREATION_NOUNS[kind].noun\n    if (entry.allowed) {\n      lines.push(`- ${noun}: yes${entry.left === null ? '' : `, ${entry.left} more`}`)\n    } else {\n      lines.push(`- ${noun}: no, because ${entry.reason ?? 'it cannot be made here'}`)\n    }\n  }\n  if (!capabilities.reusableComponents) lines.push(AI_PLAN_INLINE_SENTENCE)\n  return lines\n}\n\n/**\n * Whether a plan on this site can place a saved form at all (AGL-3596): the\n * site has one, or the job may create one. Absent capabilities restrict\n * nothing, as everywhere else.\n */\nexport function aiPlanCanPlaceForm(\n  inventory: { forms: readonly unknown[] } | null,\n  capabilities: Pick<AiPlanCapabilities, 'create'> | null,\n): boolean {\n  if (inventory?.forms.length) return true\n  return capabilities?.create.form.allowed !== false\n}\n\n/** What to do instead of a creation the job may not make, for the re-ask and the review. */\nfunction insteadOf(kind: AiBuildPlanCreateKind, capabilities: AiPlanCapabilities): string {\n  switch (kind) {\n    case 'component':\n      return capabilities.reusableComponents\n        ? 'Place a component the site already has.'\n        : \"Draw a list's repeated items in one section instead.\"\n    case 'form':\n      return 'Place a form the site already has, or leave the form off the page.'\n    case 'layout':\n      return 'Put the page in a layout the site already has.'\n    case 'template':\n      return 'Build the page without a template.'\n    case 'theme-change':\n      return \"Use the colors the theme already has.\"\n    case 'dataset':\n      return 'Bind a dataset or collection the site already has, or keep the list short enough to write out.'\n    case 'email':\n      return 'Leave the email out of this job.'\n  }\n}\n\n/** One creation a plan names that this job may not make here. */\nexport interface AiPlanUncreatable {\n  kind: AiBuildPlanCreateKind\n  name: string\n  /** The plan path of the creation: `create[2]`. */\n  path: string\n  /** Why not, as a clause: \"this site has room for 1 more\". */\n  reason: string\n  /** One customer-safe sentence: what was refused, why, and what to do instead. */\n  message: string\n}\n\n/**\n * Why the nth creation of a kind may not be made here, as a clause; `null`\n * when it may. A kind the site may make only so many more of refuses the ones\n * past that count, not the first of them.\n */\nfunction refusedReason(capability: AiPlanCreation, nth: number): string | null {\n  const overCount = capability.allowed && capability.left !== null && nth > capability.left\n  if (capability.allowed && !overCount) return null\n  return overCount\n    ? `this site has room for ${capability.left} more`\n    : (capability.reason ?? 'it cannot be made here')\n}\n\n/** The creations a plan names that the capabilities refuse, in plan order. */\nexport function aiPlanUncreatable(\n  plan: Pick<AiBuildPlan, 'create'>,\n  capabilities: AiPlanCapabilities,\n): AiPlanUncreatable[] {\n  const refused: AiPlanUncreatable[] = []\n  const counted = new Map<AiBuildPlanCreateKind, number>()\n  plan.create.forEach((entry, index) => {\n    const nth = (counted.get(entry.kind) ?? 0) + 1\n    counted.set(entry.kind, nth)\n    const reason = refusedReason(capabilities.create[entry.kind], nth)\n    if (reason === null) return\n    refused.push({\n      kind: entry.kind,\n      name: entry.name,\n      path: `create[${index}]`,\n      reason,\n      message: `The plan creates ${aiCreationNoun(entry.kind)} named \"${entry.name}\", and ${reason}. ${insteadOf(entry.kind, capabilities)}`,\n    })\n  })\n  return refused\n}\n\n/**\n * Why the plan could not add one more creation of a kind here, and what to\n * do instead; `null` when it could (AGL-3040). Counted past the creations of\n * that kind the plan already names, as `aiPlanUncreatable` counts them, so a\n * plan told to declare a creation is never told to declare one the next\n * answer is refused for.\n */\nexport function aiPlanUncreatableKind(\n  plan: Pick<AiBuildPlan, 'create'>,\n  kind: AiBuildPlanCreateKind,\n  capabilities: AiPlanCapabilities,\n): { reason: string; instead: string } | null {\n  const planned = plan.create.filter((entry) => entry.kind === kind).length\n  const reason = refusedReason(capabilities.create[kind], planned + 1)\n  return reason === null ? null : { reason, instead: insteadOf(kind, capabilities) }\n}\n"],"names":["AI_BUILD_PLAN_CREATE_KINDS","AI_BUILD_PLAN_CREATION_NOUNS","ALLOWED","allowed","left","reason","aiUnrestrictedPlanCapabilities","reusableComponents","create","Object","fromEntries","map","kind","aiPlanCapabilitiesForJob","capabilities","scope","creates","includes","noun","aiCreationNoun","test","AI_PLAN_INLINE_SENTENCE","AI_PLAN_COMPILED_REPEATS_SENTENCE","AI_PLAN_NO_FORM_SENTENCE","aiPlanCapabilityLines","lines","entry","push","aiPlanCanPlaceForm","inventory","forms","length","form","insteadOf","refusedReason","capability","nth","overCount","aiPlanUncreatable","plan","refused","counted","Map","forEach","index","get","set","name","path","message","aiPlanUncreatableKind","planned","filter","instead"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,0BAA0B,EAC1BC,4BAA4B,QAGvB,qBAAiB;AA8FxB,MAAMC,UAA0B;IAAEC,SAAS;IAAMC,MAAM;IAAMC,QAAQ;AAAK;AAE1E;;;;CAIC,GACD,OAAO,SAASC;IACd,OAAO;QACLC,oBAAoB;QACpBC,QAAQC,OAAOC,WAAW,CACxBV,2BAA2BW,GAAG,CAAC,CAACC,OAAS;gBAACA;gBAAMV;aAAQ;IAE5D;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASW,yBACdC,YAAgC,EAChCC,KAAwC;IAExC,IAAI,CAACA,OAAO,OAAOD;IACnB,MAAMN,SAAS,aAAKM,aAAaN,MAAM;IACvC,KAAK,MAAMI,QAAQZ,2BAA4B;QAC7C,IAAI,CAACQ,MAAM,CAACI,KAAK,CAACT,OAAO,IAAIY,MAAMC,OAAO,CAACC,QAAQ,CAACL,OAAO;QAC3DJ,MAAM,CAACI,KAAK,GAAG;YAAET,SAAS;YAAOC,MAAM;YAAMC,QAAQ,GAAGU,MAAMG,IAAI,CAAC,mBAAmB,CAAC;QAAC;IAC1F;IACA,OAAO,aAAKJ;QAAcN;;AAC5B;AAEA,qEAAqE,GACrE,OAAO,SAASW,eAAeP,IAA2B;IACxD,MAAMM,OAAOjB,4BAA4B,CAACW,KAAK,CAACM,IAAI;IACpD,OAAO,GAAG,WAAWE,IAAI,CAACF,QAAQ,OAAO,IAAI,CAAC,EAAEA,MAAM;AACxD;AAEA;;;;;;CAMC,GACD,OAAO,MAAMG,0BACX,4FAA2F;AAE7F;;;;CAIC,GACD,OAAO,MAAMC,oCACX,wJAAuJ;AAEzJ;;;;CAIC,GACD,OAAO,MAAMC,2BACX,uGAAsG;AAExG;;;;CAIC,GACD,OAAO,SAASC,sBAAsBV,YAAgC;IACpE,MAAMW,QAAQ;QAAC;KAAyC;IACxD,KAAK,MAAMb,QAAQZ,2BAA4B;QAC7C,MAAM0B,QAAQZ,aAAaN,MAAM,CAACI,KAAK;QACvC,MAAMM,OAAOjB,4BAA4B,CAACW,KAAK,CAACM,IAAI;QACpD,IAAIQ,MAAMvB,OAAO,EAAE;YACjBsB,MAAME,IAAI,CAAC,CAAC,EAAE,EAAET,KAAK,KAAK,EAAEQ,MAAMtB,IAAI,KAAK,OAAO,KAAK,CAAC,EAAE,EAAEsB,MAAMtB,IAAI,CAAC,KAAK,CAAC,EAAE;QACjF,OAAO;gBACgCsB;YAArCD,MAAME,IAAI,CAAC,CAAC,EAAE,EAAET,KAAK,cAAc,GAAEQ,gBAAAA,MAAMrB,MAAM,YAAZqB,gBAAgB,0BAA0B;QACjF;IACF;IACA,IAAI,CAACZ,aAAaP,kBAAkB,EAAEkB,MAAME,IAAI,CAACN;IACjD,OAAOI;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASG,mBACdC,SAA+C,EAC/Cf,YAAuD;IAEvD,IAAIe,6BAAAA,UAAWC,KAAK,CAACC,MAAM,EAAE,OAAO;IACpC,OAAOjB,CAAAA,gCAAAA,aAAcN,MAAM,CAACwB,IAAI,CAAC7B,OAAO,MAAK;AAC/C;AAEA,0FAA0F,GAC1F,SAAS8B,UAAUrB,IAA2B,EAAEE,YAAgC;IAC9E,OAAQF;QACN,KAAK;YACH,OAAOE,aAAaP,kBAAkB,GAClC,4CACA;QACN,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;IACX;AACF;AAcA;;;;CAIC,GACD,SAAS2B,cAAcC,UAA0B,EAAEC,GAAW;QAKvDD;IAJL,MAAME,YAAYF,WAAWhC,OAAO,IAAIgC,WAAW/B,IAAI,KAAK,QAAQgC,MAAMD,WAAW/B,IAAI;IACzF,IAAI+B,WAAWhC,OAAO,IAAI,CAACkC,WAAW,OAAO;IAC7C,OAAOA,YACH,CAAC,uBAAuB,EAAEF,WAAW/B,IAAI,CAAC,KAAK,CAAC,IAC/C+B,qBAAAA,WAAW9B,MAAM,YAAjB8B,qBAAqB;AAC5B;AAEA,4EAA4E,GAC5E,OAAO,SAASG,kBACdC,IAAiC,EACjCzB,YAAgC;IAEhC,MAAM0B,UAA+B,EAAE;IACvC,MAAMC,UAAU,IAAIC;IACpBH,KAAK/B,MAAM,CAACmC,OAAO,CAAC,CAACjB,OAAOkB;YACbH;QAAb,MAAML,MAAM,EAACK,eAAAA,QAAQI,GAAG,CAACnB,MAAMd,IAAI,aAAtB6B,eAA2B,KAAK;QAC7CA,QAAQK,GAAG,CAACpB,MAAMd,IAAI,EAAEwB;QACxB,MAAM/B,SAAS6B,cAAcpB,aAAaN,MAAM,CAACkB,MAAMd,IAAI,CAAC,EAAEwB;QAC9D,IAAI/B,WAAW,MAAM;QACrBmC,QAAQb,IAAI,CAAC;YACXf,MAAMc,MAAMd,IAAI;YAChBmC,MAAMrB,MAAMqB,IAAI;YAChBC,MAAM,CAAC,OAAO,EAAEJ,MAAM,CAAC,CAAC;YACxBvC;YACA4C,SAAS,CAAC,iBAAiB,EAAE9B,eAAeO,MAAMd,IAAI,EAAE,QAAQ,EAAEc,MAAMqB,IAAI,CAAC,OAAO,EAAE1C,OAAO,EAAE,EAAE4B,UAAUP,MAAMd,IAAI,EAAEE,eAAe;QACxI;IACF;IACA,OAAO0B;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASU,sBACdX,IAAiC,EACjC3B,IAA2B,EAC3BE,YAAgC;IAEhC,MAAMqC,UAAUZ,KAAK/B,MAAM,CAAC4C,MAAM,CAAC,CAAC1B,QAAUA,MAAMd,IAAI,KAAKA,MAAMmB,MAAM;IACzE,MAAM1B,SAAS6B,cAAcpB,aAAaN,MAAM,CAACI,KAAK,EAAEuC,UAAU;IAClE,OAAO9C,WAAW,OAAO,OAAO;QAAEA;QAAQgD,SAASpB,UAAUrB,MAAME;IAAc;AACnF"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-plan-capabilities.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 {\n  AI_BUILD_PLAN_CREATE_KINDS,\n  AI_BUILD_PLAN_CREATION_NOUNS,\n  type AiBuildPlan,\n  type AiBuildPlanCreateKind,\n} from './ai-build-plan'\n\n/**\n * What a plan may create on one site (AGL-3030): the workspace's plan and the\n * site's counts against its limits, narrowed to what the job itself builds.\n *\n * A plan that names a creation nothing can make is a dead end the member pays\n * for twice: once for the plan, and again for the plan they describe after\n * being told to make the creation by hand — which, on a workspace whose plan\n * does not include it, they cannot. So the plan step is TOLD what may be\n * created before it answers, and the plan rules refuse a creation outside it\n * with the one re-ask every other rule gets.\n *\n * ── Where the doctrine builds inline ─────────────────────────────────────\n *\n * The building doctrine makes a repeat a reusable component and a form a\n * saved form placed by id. A workspace whose plan keeps no reusable\n * components draws a list's repeated items in one section instead\n * (AGL-3071); `reusableComponents` is the one flag every validator reads for\n * that.\n *\n * A form is never drawn inline (AGL-3596): it is a saved form, counted\n * against the site's form allowance like one a member makes. Where the site\n * has none to place and may create none, the page places no form at all.\n *\n * ── Kept out of the cached prefix ────────────────────────────────────────\n *\n * The capabilities are per workspace and per site, so they ride the plan's\n * USER turn, never a system block: the doctrine's cached prefix stays one\n * entry for the platform. The doctrine states the rule once — create only\n * what the request says may be created, and build inline where it says the\n * workspace keeps no reusable components — and the request states the facts.\n *\n * This module imports nothing at runtime beyond the plan's own model, so the\n * validators, the plan step, the doors and their specs read one vocabulary.\n * What a workspace's plan and counts come to is read by\n * `readAiPlanCapabilities` in `jobs/ai-job-drafts.ts`, beside the band\n * arithmetic the create route and the draft writer share.\n */\n\n/** One creation kind, as a job on this site may make it or not. */\nexport interface AiPlanCreation {\n  allowed: boolean\n  /** How many more the site may hold; `null` when the plan counts none. */\n  left: number | null\n  /**\n   * Why not, as a clause a sentence completes: \"this workspace's plan does\n   * not include reusable components\". `null` when allowed.\n   */\n  reason: string | null\n}\n\nexport interface AiPlanCapabilities {\n  /**\n   * Whether the workspace keeps reusable components. Where it does not, a\n   * list's repeated items are drawn in one section. Forms are not read off\n   * it: whether one may be created is `create.form` (AGL-3596).\n   */\n  reusableComponents: boolean\n  /** Every creation kind a plan may name, and whether this job may make one here. */\n  create: Readonly<Record<AiBuildPlanCreateKind, AiPlanCreation>>\n  /**\n   * Whether the workspace spends the Free taste, whose monthly credits are a\n   * wall (AGL-2925): a plan is then held to the sections the wall's worst\n   * case pays for (AGL-3070). Absent is `false`.\n   */\n  freeTaste?: boolean\n  /**\n   * A Free workspace's site scaffold (AGL-3594): the most pages its plan may\n   * build, which the plan step sets for a `site` job on the Free taste. The\n   * Free wall then holds the plan to that many pages and to the sections a\n   * SITE plan's worst case leaves room for. Absent for every other job.\n   */\n  freeSitePages?: number\n  /**\n   * Whether this job's pages are written in the compact layout language\n   * (AGL-3660), whose compiler draws a section's repeated items itself: as\n   * instances of a component the plan places there, or, with none, in their\n   * compact form, a title over its text, which is smaller than a block rule 1\n   * calls a repeat. A plan is then not asked for a component for a section's\n   * repeated items (AGL-3616); a section two pages share still is one. The\n   * plan step sets it for a `build` job. Absent is `false`.\n   *\n   * It is the plan half of one rule. The page half is the tree check's\n   * `AiDoctrineTreeContext.repeatsCompiled`, which every page the layout\n   * language compiles is checked with: where the site's design draws a\n   * section's items as picture cards — larger than the compact form, and so\n   * a block rule 1 would count — those cards are the compiler's, not a block\n   * typed out twice, and rule 1 asks no component of them (AGL-3660).\n   */\n  repeatsCompiled?: boolean\n}\n\n/** What a job of one kind builds from its own plan, where it builds only some creations. */\nexport interface AiPlanJobScope {\n  /** The job as a refusal names it: \"a page job\". */\n  noun: string\n  /** The creation kinds the job builds itself; any other is refused before the plan is kept. */\n  creates: readonly AiBuildPlanCreateKind[]\n}\n\nconst ALLOWED: AiPlanCreation = { allowed: true, left: null, reason: null }\n\n/**\n * Capabilities that restrict nothing: what a plan is held to when no\n * workspace was read — an org-level job, an eval, a spec about something\n * else. The doctrine applies whole.\n */\nexport function aiUnrestrictedPlanCapabilities(): AiPlanCapabilities {\n  return {\n    reusableComponents: true,\n    create: Object.fromEntries(\n      AI_BUILD_PLAN_CREATE_KINDS.map((kind) => [kind, ALLOWED]),\n    ) as Record<AiBuildPlanCreateKind, AiPlanCreation>,\n  }\n}\n\n/**\n * The workspace's capabilities narrowed to what a job of one kind builds.\n * A creation the workspace itself cannot make keeps the workspace's reason,\n * which is the one a member can act on; one the job does not build says so.\n */\nexport function aiPlanCapabilitiesForJob(\n  capabilities: AiPlanCapabilities,\n  scope: AiPlanJobScope | null | undefined,\n): AiPlanCapabilities {\n  if (!scope) return capabilities\n  const create = { ...capabilities.create }\n  for (const kind of AI_BUILD_PLAN_CREATE_KINDS) {\n    if (!create[kind].allowed || scope.creates.includes(kind)) continue\n    create[kind] = { allowed: false, left: null, reason: `${scope.noun} does not build one` }\n  }\n  return { ...capabilities, create }\n}\n\n/** \"a layout\", \"an email design\": a creation kind with its article. */\nexport function aiCreationNoun(kind: AiBuildPlanCreateKind): string {\n  const noun = AI_BUILD_PLAN_CREATION_NOUNS[kind].noun\n  return `${/^[aeiou]/.test(noun) ? 'an' : 'a'} ${noun}`\n}\n\n/**\n * The sentence a request states when the workspace keeps no reusable\n * components. It says a list's repeated items go in one section (AGL-3071):\n * \"a repeated item in its own section\" reads just as well as a section for\n * each item, which is how a live About page's four practice areas came to be\n * planned as four sections of one item.\n */\nexport const AI_PLAN_INLINE_SENTENCE =\n  \"This workspace keeps no reusable components: draw a list's repeated items in one section.\"\n\n/**\n * The sentence a build's request states (AGL-3616): its pages are written in\n * the layout language, which draws a section's repeated items itself, so the\n * plan counts them in the section's `items` and needs no component for them.\n */\nexport const AI_PLAN_COMPILED_REPEATS_SENTENCE =\n  \"A section's repeated items need no component here: count them in its items and the page draws them. A section two pages share is still one component.\"\n\n/**\n * The sentence a request states when the site has no saved form and this job\n * may create none (AGL-3596): the plan places no form, rather than one drawn\n * on the page with no saved form behind it.\n */\nexport const AI_PLAN_NO_FORM_SENTENCE =\n  'This site has no saved form and may create none: plan no form, and no section that collects answers.'\n\n/**\n * What the plan step's user turn says the job may create here: one line a\n * kind, and the inline sentence where the workspace keeps no reusable\n * components. Per workspace and per site, so it is never a system block.\n */\nexport function aiPlanCapabilityLines(capabilities: AiPlanCapabilities): string[] {\n  const lines = ['What this job may create on this site:']\n  for (const kind of AI_BUILD_PLAN_CREATE_KINDS) {\n    const entry = capabilities.create[kind]\n    const noun = AI_BUILD_PLAN_CREATION_NOUNS[kind].noun\n    if (entry.allowed) {\n      lines.push(`- ${noun}: yes${entry.left === null ? '' : `, ${entry.left} more`}`)\n    } else {\n      lines.push(`- ${noun}: no, because ${entry.reason ?? 'it cannot be made here'}`)\n    }\n  }\n  if (!capabilities.reusableComponents) lines.push(AI_PLAN_INLINE_SENTENCE)\n  return lines\n}\n\n/**\n * Whether a plan on this site can place a saved form at all (AGL-3596): the\n * site has one, or the job may create one. Absent capabilities restrict\n * nothing, as everywhere else.\n */\nexport function aiPlanCanPlaceForm(\n  inventory: { forms: readonly unknown[] } | null,\n  capabilities: Pick<AiPlanCapabilities, 'create'> | null,\n): boolean {\n  if (inventory?.forms.length) return true\n  return capabilities?.create.form.allowed !== false\n}\n\n/** What to do instead of a creation the job may not make, for the re-ask and the review. */\nfunction insteadOf(kind: AiBuildPlanCreateKind, capabilities: AiPlanCapabilities): string {\n  switch (kind) {\n    case 'component':\n      return capabilities.reusableComponents\n        ? 'Place a component the site already has.'\n        : \"Draw a list's repeated items in one section instead.\"\n    case 'form':\n      return 'Place a form the site already has, or leave the form off the page.'\n    case 'layout':\n      return 'Put the page in a layout the site already has.'\n    case 'template':\n      return 'Build the page without a template.'\n    case 'theme-change':\n      return \"Use the colors the theme already has.\"\n    case 'dataset':\n      return 'Bind a dataset or collection the site already has, or keep the list short enough to write out.'\n    case 'email':\n      return 'Leave the email out of this job.'\n  }\n}\n\n/** One creation a plan names that this job may not make here. */\nexport interface AiPlanUncreatable {\n  kind: AiBuildPlanCreateKind\n  name: string\n  /** The plan path of the creation: `create[2]`. */\n  path: string\n  /** Why not, as a clause: \"this site has room for 1 more\". */\n  reason: string\n  /** One customer-safe sentence: what was refused, why, and what to do instead. */\n  message: string\n}\n\n/**\n * Why the nth creation of a kind may not be made here, as a clause; `null`\n * when it may. A kind the site may make only so many more of refuses the ones\n * past that count, not the first of them.\n */\nfunction refusedReason(capability: AiPlanCreation, nth: number): string | null {\n  const overCount = capability.allowed && capability.left !== null && nth > capability.left\n  if (capability.allowed && !overCount) return null\n  return overCount\n    ? `this site has room for ${capability.left} more`\n    : (capability.reason ?? 'it cannot be made here')\n}\n\n/** The creations a plan names that the capabilities refuse, in plan order. */\nexport function aiPlanUncreatable(\n  plan: Pick<AiBuildPlan, 'create'>,\n  capabilities: AiPlanCapabilities,\n): AiPlanUncreatable[] {\n  const refused: AiPlanUncreatable[] = []\n  const counted = new Map<AiBuildPlanCreateKind, number>()\n  plan.create.forEach((entry, index) => {\n    const nth = (counted.get(entry.kind) ?? 0) + 1\n    counted.set(entry.kind, nth)\n    const reason = refusedReason(capabilities.create[entry.kind], nth)\n    if (reason === null) return\n    refused.push({\n      kind: entry.kind,\n      name: entry.name,\n      path: `create[${index}]`,\n      reason,\n      message: `The plan creates ${aiCreationNoun(entry.kind)} named \"${entry.name}\", and ${reason}. ${insteadOf(entry.kind, capabilities)}`,\n    })\n  })\n  return refused\n}\n\n/**\n * Why the plan could not add one more creation of a kind here, and what to\n * do instead; `null` when it could (AGL-3040). Counted past the creations of\n * that kind the plan already names, as `aiPlanUncreatable` counts them, so a\n * plan told to declare a creation is never told to declare one the next\n * answer is refused for.\n */\nexport function aiPlanUncreatableKind(\n  plan: Pick<AiBuildPlan, 'create'>,\n  kind: AiBuildPlanCreateKind,\n  capabilities: AiPlanCapabilities,\n): { reason: string; instead: string } | null {\n  const planned = plan.create.filter((entry) => entry.kind === kind).length\n  const reason = refusedReason(capabilities.create[kind], planned + 1)\n  return reason === null ? null : { reason, instead: insteadOf(kind, capabilities) }\n}\n"],"names":["AI_BUILD_PLAN_CREATE_KINDS","AI_BUILD_PLAN_CREATION_NOUNS","ALLOWED","allowed","left","reason","aiUnrestrictedPlanCapabilities","reusableComponents","create","Object","fromEntries","map","kind","aiPlanCapabilitiesForJob","capabilities","scope","creates","includes","noun","aiCreationNoun","test","AI_PLAN_INLINE_SENTENCE","AI_PLAN_COMPILED_REPEATS_SENTENCE","AI_PLAN_NO_FORM_SENTENCE","aiPlanCapabilityLines","lines","entry","push","aiPlanCanPlaceForm","inventory","forms","length","form","insteadOf","refusedReason","capability","nth","overCount","aiPlanUncreatable","plan","refused","counted","Map","forEach","index","get","set","name","path","message","aiPlanUncreatableKind","planned","filter","instead"],"mappings":"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"}

package/src/lib/model/ai-site-build-progress.d.ts

@@ -27,7 +27,11 @@ import type { AiJobSummary } from './ai-jobs.types';
  *
  * Pure: no React, no request. The page and its spec read the same rows.
  */
-export type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped';
+/**
+ * `paused` (AGL-3660): the row a job the meter paused stopped at — not
+ * running, not failed, and carried on from by Resume.
+ */
+export type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped' | 'paused';
 export interface AiSiteBuildRow {
     id: string;
     label: string;
@@ -91,4 +95,10 @@ export interface AiJobPageCopy {
  * done site job without that record — an older job, or one that was not a
  * guided start — built drafts, and says that instead.
  */
-export declare function aiJobPageCopy(job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish' | 'items'>>, brand: string): AiJobPageCopy;
+export declare function aiJobPageCopy(job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish' | 'items' | 'outputs'>>, brand: string): AiJobPageCopy;
+/**
+ * What a job has already built, in a sentence (AGL-3660): its look, the header
+ * and footer, its form, its pages — from the item ledger where it has one,
+ * else from what it has reported as outputs. `null` when it has built nothing.
+ */
+export declare function aiJobBuiltSoFar(job: Pick<AiJobSummary, 'kind'> & Partial<Pick<AiJobSummary, 'items' | 'outputs'>>): string | null;

package/src/lib/model/ai-site-build-progress.js

@@ -16,7 +16,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { aiJobConfirmingOwnPlan, aiJobKindNoun } from "./ai-job-activity.js";
 import { aiJobRefundCopy } from "./ai-job-failure-copy.js";
-import { aiBuildItemRows, aiBuildOutcomeLine, aiSitePartialCopy } from "./ai-build-progress.js";
+import { aiBuildItemRows, aiBuildOpNoun, aiBuildOutcomeLine, aiSitePartialCopy } from "./ai-build-progress.js";
+import { AI_JOB_PAUSED_NEXT_COPY, aiJobPausedTitle } from "./ai-job-notice.js";
 export function aiSiteBuildPhase(job) {
     // A guided start's plan parked for the instant its confirmation takes is
     // the build going on (AGL-3596), never a stop.
@@ -60,8 +61,34 @@ export function aiSiteBuildPhase(job) {
  * where a failure stopped it: a layout that broke is the layout's row, never
  * the first page's.
  */ export function aiSiteBuildRows(job) {
-    var _ref, _planStep_creditsSpent, _built_get, _ref1;
-    var _job_items, _job_plan;
+    const rows = aiSiteBuildRowsOf(job);
+    return job.status === 'needs_input' ? aiPausedRows(rows) : rows;
+}
+/**
+ * A job the meter paused (AGL-3660) shows no spinner: the row it stopped at —
+ * one still marked running, else the first not yet built — reads `paused`,
+ * with no running clock and no "building now" hint, and every row after it
+ * keeps waiting.
+ */ function aiPausedRows(rows) {
+    const at = rows.findIndex((row)=>row.state === 'active' || row.state === 'paused');
+    const index = at >= 0 ? at : rows.findIndex((row)=>row.state === 'waiting');
+    return rows.map((row, position)=>{
+        if (row.state === 'active' && position !== index) return _extends({}, row, {
+            state: 'waiting',
+            hint: null,
+            startedAt: null
+        });
+        if (position !== index) return row;
+        return _extends({}, row, {
+            state: 'paused',
+            hint: null,
+            startedAt: null
+        });
+    });
+}
+function aiSiteBuildRowsOf(job) {
+    var _ref, _planStep_creditsSpent, _built_get, _ref1, _ref2;
+    var _job_items, _job_plan, _job_steps_find;
     const phase = aiSiteBuildPhase(job);
     // A build is read off its item ledger (AGL-3616): one row an item, each with
     // its own state and what became of its credits.
@@ -112,7 +139,8 @@ export function aiSiteBuildPhase(job) {
     const planStep = job.steps.find((step)=>step.name === 'plan');
     const planDone = (planStep == null ? void 0 : planStep.status) === 'done' || Boolean(job.plan);
     const stopped = phase === 'failed' || phase === 'stopped';
-    const planState = planDone ? 'done' : stopped ? 'failed' : phase === 'working' ? 'active' : 'waiting';
+    const paused = job.status === 'needs_input';
+    const planState = planDone ? 'done' : paused ? 'paused' : stopped ? 'failed' : phase === 'working' ? 'active' : 'waiting';
     const rows = [
         _extends({
             id: 'plan',
@@ -171,18 +199,27 @@ export function aiSiteBuildPhase(job) {
         return true;
     };
     const stages = [];
+    // A scaffold designs its look first on every start (AGL-3660), and writes
+    // its item ledger only with that first pass's outcome — so while the look
+    // is being designed, the job is read here, without a ledger, and the look
+    // is the stage it is on: a moving site job that has built nothing yet. A
+    // job read without its ledger that has built something and no look is one
+    // from before the look had a unit of its own, and has the stage only where
+    // it built one.
+    const moving = (phase === 'working' || paused) && job.outputs.length === 0;
     for (const row of CREATION_ROWS){
         var _job_plan1;
         const creation = (_job_plan1 = job.plan) == null ? void 0 : _job_plan1.create.find((entry)=>entry.kind === row.kind);
-        // A job read without its item ledger is one from before the look had a
-        // unit of its own (AGL-3660): its look is a stage only where it built one.
-        if (creation || row.resource === 'theme' && job.outputs.some((output)=>output.resource === 'theme')) {
-            var _ref2;
-            stages.push({
-                id: row.resource,
-                label: row.label((_ref2 = creation == null ? void 0 : creation.name) != null ? _ref2 : ''),
+        const look = row.resource === 'theme';
+        if (creation || look && job.kind !== 'build' && moving || look && job.outputs.some((output)=>output.resource === 'theme')) {
+            var _ref3;
+            stages.push(_extends({
+                id: look ? 'look' : row.resource,
+                label: row.label((_ref3 = creation == null ? void 0 : creation.name) != null ? _ref3 : ''),
                 resource: row.resource
-            });
+            }, look ? {
+                hint: AI_SITE_LOOK_HINT
+            } : {}));
         }
     }
     const pages = (_ref1 = (_job_plan = job.plan) == null ? void 0 : _job_plan.screens) != null ? _ref1 : [];
@@ -194,17 +231,23 @@ export function aiSiteBuildPhase(job) {
             sections: page.sections.map((section)=>section.name)
         });
     });
+    // The build step's start: when the first stage after the plan began.
+    const buildStartedAt = (_ref2 = (_job_steps_find = job.steps.find((step)=>step.name !== 'plan' && step.startedAt)) == null ? void 0 : _job_steps_find.startedAt) != null ? _ref2 : null;
     let reached = false;
     for (const stage of stages){
         var _stage_sections;
         const done = phase === 'done' || take(stage.resource);
         const current = !done && !reached && planDone;
         if (current) reached = true;
+        const state = done ? 'done' : current && paused ? 'paused' : current && stopped ? 'failed' : current && phase === 'working' ? 'active' : 'waiting';
         rows.push(_extends({
             id: stage.id,
             label: stage.label,
-            state: done ? 'done' : current && stopped ? 'failed' : current && phase === 'working' ? 'active' : 'waiting'
-        }, ((_stage_sections = stage.sections) == null ? void 0 : _stage_sections.length) ? {
+            state
+        }, state === 'active' && stage.hint ? {
+            hint: stage.hint,
+            startedAt: buildStartedAt
+        } : {}, ((_stage_sections = stage.sections) == null ? void 0 : _stage_sections.length) ? {
             sections: stage.sections
         } : {}));
     }
@@ -244,7 +287,7 @@ export function aiSiteBuildPhase(job) {
  * and the active one half. `null` before there is more than one row to count.
  */ export function aiSiteBuildFraction(rows) {
     if (rows.length < 2) return null;
-    const counted = rows.reduce((sum, row)=>sum + (row.state === 'active' ? 0.5 : row.state === 'waiting' ? 0 : 1), 0);
+    const counted = rows.reduce((sum, row)=>sum + (row.state === 'active' ? 0.5 : row.state === 'waiting' || row.state === 'paused' ? 0 : 1), 0);
     return Math.min(1, counted / rows.length);
 }
 /**
@@ -281,6 +324,18 @@ export function aiSiteBuildPhase(job) {
     var _ref, _ref1;
     var _job_review;
     const phase = aiSiteBuildPhase(job);
+    // Paused by the meter (AGL-3660): why, what is already built, and that it
+    // carries on — never "was not built", which read as a dead end.
+    if (job.status === 'needs_input') {
+        return {
+            heading: aiJobPausedTitle(job.kind),
+            lede: [
+                job.error,
+                aiJobBuiltSoFar(job),
+                AI_JOB_PAUSED_NEXT_COPY
+            ].filter(Boolean).join(' ')
+        };
+    }
     // A build is what the person asked for, item by item (AGL-3616).
     if (job.kind === 'build') return aiBuildPageCopy(job, brand);
     const noun = job.kind === 'site' ? 'site' : aiJobKindNoun(job.kind);
@@ -339,6 +394,40 @@ export function aiSiteBuildPhase(job) {
         lede: why != null ? why : generic ? 'Something went wrong running this job.' : `Something went wrong building your ${noun}.`
     };
 }
+const joinWords = (names)=>{
+    var _names_;
+    return names.length <= 1 ? (_names_ = names[0]) != null ? _names_ : '' : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
+};
+/**
+ * What a job has already built, in a sentence (AGL-3660): its look, the header
+ * and footer, its form, its pages — from the item ledger where it has one,
+ * else from what it has reported as outputs. `null` when it has built nothing.
+ */ export function aiJobBuiltSoFar(job) {
+    var _job_items;
+    var _job_items1;
+    const built = ((_job_items = job.items) != null ? _job_items : []).filter((row)=>row.status === 'succeeded' || row.status === 'degraded');
+    const names = [];
+    if ((_job_items1 = job.items) == null ? void 0 : _job_items1.length) {
+        for (const row of built){
+            if (row.op === 'theme') names.push('your look');
+            else if (row.op === 'layout') names.push('the header and footer');
+            else if (row.op === 'form') names.push(`the form “${row.label}”`);
+            else if (row.op === 'page') names.push(`the page “${row.label}”`);
+            else if (row.op === 'email') names.push('your welcome email');
+            else names.push(`${aiBuildOpNoun(row.op).toLowerCase()} “${row.label}”`);
+        }
+    } else {
+        var _job_outputs;
+        const outputs = (_job_outputs = job.outputs) != null ? _job_outputs : [];
+        const count = (resource)=>outputs.filter((output)=>output.resource === resource).length;
+        if (count('theme')) names.push('your look');
+        if (count('layout')) names.push('the header and footer');
+        if (count('form')) names.push(count('form') === 1 ? 'the form' : `${count('form')} forms`);
+        const pages = count('screen');
+        if (pages) names.push(pages === 1 ? '1 page' : `${pages} pages`);
+    }
+    return names.length ? `Built so far: ${joinWords(names)}.` : null;
+}
 /** A build's page heading and sentence (AGL-3616). */ function aiBuildPageCopy(job, brand) {
     var _job_items, _job_error;
     const phase = aiSiteBuildPhase(job);